sandbox

type EnvMode string

type ExecRequest struct {
	Command string            `json:"command"`            // 要执行的命令
	Args    []string          `json:"args,omitempty"`     // 命令参数
	Timeout time.Duration     `json:"timeout,omitempty"`  // 超时，0 用默认值
	Env     map[string]string `json:"env,omitempty"`      // 额外环境变量
	Files   []InputFile       `json:"files,omitempty"`    // 执行前在工作目录创建的文件
	WorkDir string            `json:"work_dir,omitempty"` // 指定工作目录（空 = 临时目录）
}

type ExecResult struct {
	Stdout    string        `json:"stdout"`
	Stderr    string        `json:"stderr"`
	ExitCode  int           `json:"exit_code"`
	Duration  time.Duration `json:"duration"`
	TimedOut  bool          `json:"timed_out,omitempty"`
	Truncated bool          `json:"truncated,omitempty"`
}

type InputFile struct {
	Path    string `json:"path"`    // 相对于工作目录的路径
	Content string `json:"content"` // 文件内容
}

type LangDef struct {
	Command   string
	Args      []string
	Ext       string
	InitFiles map[string]string
}

type ProcessConfig struct {
	DefaultTimeout time.Duration     // 默认超时（默认 30s）
	MaxOutputBytes int               // 最大输出字节数（默认 1MB）
	PreloadEnv     map[string]string // 每次执行都注入的环境变量
	EnvMode        EnvMode           // 环境变量过滤模式（默认 EnvModeBlacklist）
	EnvAllowList   []string          // 白名单模式下的允许变量名列表
	EnvBlockList   []string          // 黑名单模式下的额外拦截变量名前缀
}

type ProcessSandbox struct {
	// contains filtered or unexported fields
}

type Sandbox interface {
	Execute(ctx context.Context, req ExecRequest) (*ExecResult, error)
	Close() error
}