engines

type ApprovalDecision struct {
	RequestID string
	Action    string // "approve" | "deny" | "always"
	Reason    string
}

type ApprovalHandler interface {
	// RequestApproval 提交审批请求并阻塞直到做出决策。
	// 返回决策，如果请求被取消/超时则返回错误。
	RequestApproval(ctx context.Context, req *ApprovalRequest) (*ApprovalDecision, error)
}

type ApprovalRequest struct {
	RequestID   string
	ToolCallID  string
	ToolName    string
	Arguments   map[string]any
	Description string
	Engine      string // "claude" | "codex"
}

type ApprovalResponder interface {
	WriteDecision(requestID string, action string) error
}

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

type CLIToolSpec struct {
	Name         string
	DisplayName  string
	Binary       string
	InstallCmd   string
	DetectCmd    string
	VersionRegex string
	Default      bool
}

type CLIToolStatus struct {
	Name        string `json:"name"`
	DisplayName string `json:"display_name"`
	Binary      string `json:"binary"`
	Installed   bool   `json:"installed"`
	Version     string `json:"version,omitempty"`
	Path        string `json:"path,omitempty"`
	InstallCmd  string `json:"install_cmd"`
	Default     bool   `json:"is_default"`
}

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

type Engine interface {
	Prepare(ctx context.Context, req PrepareRequest) error
	GetSkillDir() string
	Run(ctx context.Context, req RunRequest) (*RunHandle, error)
}

type MCPServerConfig struct {
	Name        string
	URL         string            // HTTP 传输
	BearerToken string            // HTTP 传输：bearer token
	Command     string            // Stdio 传输：可执行文件路径
	Args        []string          // Stdio 传输：命令参数
	Env         map[string]string // Stdio 传输：进程额外环境变量
}

type ModelConfig struct {
	Provider string
	Model    string
	APIKey   string
	BaseURL  string
}

type PendingApproval struct {
	Request   *ApprovalRequest
	Responder ApprovalResponder
	ResultCh  chan *ApprovalDecision
	CreatedAt time.Time
}

type PermissionMode string

type PrepareRequest struct {
	WorkDir string
}

type Process interface {
	PID() int
	Stop() error
}

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

type RunHandle struct {
	Process   Process
	Events    <-chan events.Event
	Responder ApprovalResponder // 引擎特定的审批响应写入器
}

type RunRequest struct {
	ExecutionID     string
	SessionID       string
	Resume          bool
	WorkDir         string
	TaskDir         string // task 目录（跨 turn 持久化），引擎可在此写入配置文件
	SystemPrompt    string
	Prompt          string
	Model           ModelConfig
	ExtraEnv        []string
	PermissionMode  PermissionMode    // 控制审批行为
	ApprovalHandler ApprovalHandler   // 可选：由运行时注入，用于 on-request/auto 模式
	MCPServers      []MCPServerConfig // MCP 服务配置，用于引擎启动时注入
}