sdk

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

type Event struct {
	Type      EventType
	SessionID string
	Message   *MessageSnapshot
	Delta     string
	Error     error
	Progress  string
}

type EventType string

type HostTool struct {
	Name        string
	Description string
	Parameters  map[string]any
	Required    []string
	Handler     func(ctx context.Context, call HostToolCall) (HostToolResult, error)

	// Permission 可选：声明该宿主工具的授权动作。为空则不触发权限门禁。
	Permission *HostToolPermission
}

type HostToolCall struct {
	ID    string // 工具调用 ID
	Name  string // 工具名
	Input string // 模型生成的参数（JSON）
}

type HostToolPermission struct {
	Action      string // execute / write / read / fetch / delete ...
	PathFrom    string // 可选：从入参 JSON 中取文件路径的字段名（如 "file_path"）
	Description string // 可选：权限描述；为空时回退为 "Run tool: <name>"
}

type HostToolResult struct {
	Content  string // 回传给模型的文本
	IsError  bool   // 是否为失败结果（模型据此纠正行为）
	Metadata any    // 可选的结构化元信息
}

type InputMessage struct {
	Role    Role
	Content string
}

type MessageSnapshot struct {
	ID           string
	SessionID    string
	Role         Role
	Text         string
	Thinking     string
	ToolCalls    []ToolCall
	ToolResults  []ToolResult
	FinishReason string
	Finished     bool
	Model        string
	CreatedAt    int64
	UpdatedAt    int64
}

type Options struct {
	WorkingDir string
	Debug      bool

	// Provider 是厂商类型，决定走哪条 SDK 客户端（openai / anthropic / gemini / deepseek …）。
	Provider string
	// BaseURL 是厂商 API 基地址（OpenAI 兼容协议生效），为空则用内置默认地址。
	BaseURL string
	// APIKey 是本次请求使用的凭据。
	APIKey string
	// APIModel 是发给厂商的真实模型名；为空时回退为 ModelID。
	APIModel string
	// ModelID 是模型标识：类库内部用它作为模型 key 与日志/回显。
	ModelID string
	// Name 是模型展示名；为空时回退 ModelID。
	Name string

	// ContextWindow 模型上下文窗口（token 数）；0 表示未知。
	ContextWindow int64
	// DefaultMaxTokens 模型默认最大输出 token；0 表示未知。
	DefaultMaxTokens int64
	// MaxTokens 本次请求的最大输出 token，覆盖 DefaultMaxTokens。
	MaxTokens int64
	// CanReason 表示模型支持推理 / 思考过程（决定是否下发 reasoning effort）。
	CanReason bool
	// SupportsAttachments 表示模型支持图片等附件。
	SupportsAttachments bool
	// ReasoningEffort 推理强度（openai 系 low / medium / high）。
	ReasoningEffort string

	// CostPer1MIn / CostPer1MOut 每百万输入 / 输出 token 价格（美元）。
	// 仅用于会话费用统计（Session.Cost 与 TUI 展示），不参与请求。
	CostPer1MIn  float64
	CostPer1MOut float64
	// CostPer1MInCached / CostPer1MOutCached 命中缓存的输入 / 输出价格。
	CostPer1MInCached  float64
	CostPer1MOutCached float64

	AutoApprove bool

	// PermissionHandler 可选：注入后，工具权限请求逐次委托给宿主决策。
	PermissionHandler PermissionHandler

	// Tools 可选：宿主注入的自定义工具，追加到 opencode 内置工具之后，与内置工具
	// 共用同一套 tool-call 循环（模型可调用，opencode 负责回填结果）。
	Tools []HostTool
}

type PermissionDecision int

type PermissionHandler func(ctx context.Context, req PermissionRequest) PermissionDecision

type PermissionRequest struct {
	SessionID   string
	ToolName    string
	Action      string // execute / write / read / fetch ...
	Path        string
	Description string
	Params      any
}

type Role string

type RunRequest struct {
	SessionID    string
	SessionTitle string
	Prompt       string
	AutoApprove  bool

	// System 可选：宿主系统提示词，作为真正的 system 消息注入到模型，
	// 不进入对话历史，因此不会被反复追加为 user 内容。
	System string
	// History 可选：结构化历史对话（按时间顺序），不含本轮 Prompt，也不含 System。
	// opencode 会把它作为已有会话消息加载，再追加本轮 Prompt。
	History []InputMessage
}

type RunResult struct {
	SessionID string
	Message   MessageSnapshot
}

type Session struct {
	ID               string
	ParentSessionID  string
	Title            string
	PromptTokens     int64
	CompletionTokens int64
	SummaryMessageID string
	Cost             float64
	CreatedAt        int64
	UpdatedAt        int64
}

type StreamHandler func(event Event)

type ToolCall struct {
	ID       string
	Name     string
	Input    string
	Type     string
	Finished bool
}

type ToolResult struct {
	ToolCallID string
	Name       string
	Content    string
	Metadata   string
	IsError    bool
}