client

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

type ModelProviderConfig struct {
	// ModelID 是模型标识（配置表的 key），与 API 模型名分离。
	ModelID string `json:"model_id"`
	BaseURL string `json:"base_url"`
	APIKey  string `json:"api_key"`

	// Provider 是模型厂商类型（openai / anthropic / deepseek / gemini …）。
	Provider string `json:"provider"`
	// APIModel 是发给厂商的真实模型名；为空时回退 ModelID。
	APIModel string `json:"api_model"`
	// Name 是模型展示名；为空时回退 ModelID。
	Name string `json:"name"`

	// ContextWindow 模型上下文窗口（token）；0 表示未知。
	ContextWindow int64 `json:"context_window"`
	// DefaultMaxTokens 模型默认最大输出 token；0 表示未知。
	DefaultMaxTokens int64 `json:"default_max_tokens"`
	// CanReason 表示模型支持推理 / 思考过程。
	CanReason bool `json:"can_reason"`
	// SupportsAttachments 表示模型支持图片等附件。
	SupportsAttachments bool `json:"supports_attachments"`

	// CostPer1MIn / CostPer1MOut 每百万输入 / 输出 token 价格（美元）。
	CostPer1MIn  float64 `json:"cost_per_1m_in"`
	CostPer1MOut float64 `json:"cost_per_1m_out"`
	// CostPer1MInCached / CostPer1MOutCached 命中缓存的输入 / 输出价格。
	CostPer1MInCached  float64 `json:"cost_per_1m_in_cached"`
	CostPer1MOutCached float64 `json:"cost_per_1m_out_cached"`

	// ReasoningEffort 推理强度（openai 系 low / medium / high），空表示不指定。
	ReasoningEffort string `json:"reasoning_effort"`

	Extra map[string]string `json:"extra"`
}

type Options struct {
	WorkingDir string            `json:"working_dir"`
	Extra      map[string]string `json:"extra"`

	// ProviderSource 是模型提供商配置表的来源（可为 nil）。
	//
	// Provider 在每次调用时通过 ResolveProvider 按模型名从这里实时查询；
	// 由调用方（通常是 container 层）按当前生效的配置生成快照，
	// 使可视化配置页保存的 agent 段无需重启即可在下一次请求生效。
	ProviderSource func() map[string]ModelProviderConfig `json:"-"`

	// Tools 是本次调用可用的工具注册表。
	//
	// Provider 据此向模型暴露工具定义（tool.List()），并通过 ToolRunner /
	// tool.Executor 执行模型发起的工具调用。为 nil 表示本次调用不启用工具。
	//
	// 内置 / coder 工具的进程级静态依赖（分析节点执行器、脚本与报告浏览器、技能解析等）
	// 在 container 构建注册表时通过构造注入完成（见 builtin.Deps / coder.Deps），
	// Options 不再承载这些服务对象，Provider 也无需逐项注入工具 ctx。
	Tools *tool.Registry `json:"-"`

	// Sessions / Messages 是会话与消息的持久化服务（可为 nil）。
	//
	// custom Provider 用它们为子 Agent 创建子会话（ParentSessionID = 父会话）并写入
	// 子 Agent 的 reasoning / tool_call / tool_result / 最终回答；任一为 nil 时子 Agent
	// 不落库，只把最终结果回填给父 Agent（旧行为）。
	Sessions SessionService `json:"-"`
	Messages MessageService `json:"-"`
}

type Provider interface {
	// Name 返回 Provider 唯一标识（小写，如 claude_code / codex / copilot / custom）。
	Name() string
	// New 基于 Options 构建 Agent 实例。
	New(opts Options) (Agent, error)
}

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