openrouter

type Config struct {
	// APIKey 是 OpenRouter API 密钥(从 openrouter.ai 获取).
	APIKey string

	// BaseURL 覆盖默认的 OpenRouter API 地址(默认 https://openrouter.ai).
	// 用于自部署 OpenRouter 兼容代理,企业内网中转,单元测试 mock server.
	//
	// 升华改进(ELEVATED): 早期方案只能写死走 openrouter.ai--
	// 私有化场景(合规要求出口流量必须过自家代理)和单元测试均无法注入.
	// 与 ollama/lmstudio/anthropic 等其他 provider 的 BaseURL 字段保持一致.
	// 替代方案:<不暴露 BaseURL,私有部署用 HTTP_PROXY 环境变量> - 否决:
	// 环境变量是进程级,无法在同一进程内同时使用多个 openrouter 实例(CLI/SDK 多场景).
	BaseURL string

	// SiteURL 用于 OpenRouter 排行榜统计(HTTP-Referer header).
	// 建议填写你的应用 URL,如 "https://yourapp.com".
	SiteURL string

	// AppName 用于 OpenRouter 排行榜展示(X-Title header).
	AppName string

	// DefaultThinking 为所有请求启用思考模式(reasoning.enabled=true).
	// 适用于需要推理能力但不关心底层模型是否原生支持思考的场景.
	DefaultThinking bool

	// DefaultThinkingTokens 设置默认思考预算(仅当 DefaultThinking=true 时有效).
	// 0 = 使用 OpenRouter 默认值.
	DefaultThinkingTokens int

	// EnableCaching 为系统消息添加 cache_control: ephemeral 标记.
	// 用于 OpenRouter → Anthropic 路径的 prompt caching(OpenRouter 透传 cache_control 给 Anthropic).
	// 注意:仅对 Anthropic 系列模型(如 anthropic/claude-sonnet-4.6)有效.
	// 系统提示 token 数需满足 Anthropic 最低阈值(Sonnet ≥1024,Haiku ≥2048),否则不会建立缓存.
	EnableCaching bool

	// HTTPClient 注入自定义 HTTP 客户端.
	// nil = 使用默认 http.Client (带 Timeout 字段配置的 ResponseHeaderTimeout).
	// 非 nil 时 consumer 完全接管超时责任, 下面的 Timeout 字段被忽略.
	HTTPClient *http.Client

	// Timeout 限制"从请求发出到收到响应首字节"的时间.
	//
	// 通过 http.Transport.ResponseHeaderTimeout 实现, **不影响** SSE 流式 body 读取.
	// 精妙之处(CLEVER): 不要误用 http.Client.Timeout - 会砍死 SSE 流.
	// 0 = 使用 defaultTimeout (60s).HTTPClient 非 nil 时忽略此字段.
	//
	// OpenRouter 特殊情况: 聚合网关会根据底层 provider 在请求间切换,
	// 某些冷启动的底层 (DeepSeek / Qwen) 响应首字节可能稍慢, 必要时调到 90-120s.
	Timeout time.Duration
}

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