sandbox

type ExecRequest struct {
	Language string            `json:"language"`          // python, node, go, shell
	Code     string            `json:"code"`              // 代码或命令
	Timeout  time.Duration     `json:"timeout,omitempty"` // 超时，0 用默认值
	Env      map[string]string `json:"env,omitempty"`     // 额外环境变量
	Files    []InputFile       `json:"files,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 LangConfig struct {
	Command   string            `json:"command"`              // 可执行命令（如 python3、node）
	Args      []string          `json:"args,omitempty"`       // 前置参数（如 ["run"] for go run）
	Ext       string            `json:"ext,omitempty"`        // 代码文件扩展名（空 = shell 模式）
	InitFiles map[string]string `json:"init_files,omitempty"` // 预创建文件（如 go.mod）
}

type ProcessConfig struct {
	DefaultTimeout time.Duration         // 默认超时（默认 30s）
	MaxOutputBytes int                   // 最大输出字节数（默认 1MB）
	AllowedLangs   map[string]LangConfig // 语言配置（nil = 使用默认值）
	PreloadEnv     map[string]string     // 新增：每次执行都注入的环境变量
}

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

type Sandbox interface {
	// Execute 执行代码/命令
	Execute(ctx context.Context, req ExecRequest) (*ExecResult, error)
	// CheckLang 检查语言是否可用
	CheckLang(lang string) error
	// ListLangs 列出可用语言
	ListLangs() []string
	// Close 关闭沙箱
	Close() error
}