@acosmi/sdk-ts 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +247 -0
- package/dist/browser/index.js +3950 -0
- package/dist/browser/index.js.map +1 -0
- package/dist/index.js +3950 -0
- package/dist/index.js.map +1 -0
- package/dist/node/adapters/anthropic.cjs +257 -0
- package/dist/node/adapters/anthropic.cjs.map +1 -0
- package/dist/node/adapters/anthropic.d.cts +39 -0
- package/dist/node/adapters/anthropic.d.ts +39 -0
- package/dist/node/adapters/anthropic.js +254 -0
- package/dist/node/adapters/anthropic.js.map +1 -0
- package/dist/node/adapters/openai.cjs +472 -0
- package/dist/node/adapters/openai.cjs.map +1 -0
- package/dist/node/adapters/openai.d.cts +64 -0
- package/dist/node/adapters/openai.d.ts +64 -0
- package/dist/node/adapters/openai.js +465 -0
- package/dist/node/adapters/openai.js.map +1 -0
- package/dist/node/index-C3Z_84Bv.d.cts +992 -0
- package/dist/node/index-C3Z_84Bv.d.ts +992 -0
- package/dist/node/index-nvLKgCm9.d.cts +147 -0
- package/dist/node/index-nvLKgCm9.d.ts +147 -0
- package/dist/node/index.cjs +4024 -0
- package/dist/node/index.cjs.map +1 -0
- package/dist/node/index.d.cts +791 -0
- package/dist/node/index.d.ts +791 -0
- package/dist/node/index.js +3950 -0
- package/dist/node/index.js.map +1 -0
- package/dist/node/sanitize/index.cjs +248 -0
- package/dist/node/sanitize/index.cjs.map +1 -0
- package/dist/node/sanitize/index.d.cts +1 -0
- package/dist/node/sanitize/index.d.ts +1 -0
- package/dist/node/sanitize/index.js +217 -0
- package/dist/node/sanitize/index.js.map +1 -0
- package/package.json +84 -0
|
@@ -0,0 +1,254 @@
|
|
|
1
|
+
// src/types.ts
|
|
2
|
+
var ThinkingOff = "off";
|
|
3
|
+
var ThinkingMax = "max";
|
|
4
|
+
var ThinkingHighMinMaxTokens = 32e3;
|
|
5
|
+
var ThinkingMaxFallbackMaxTokens = 128e3;
|
|
6
|
+
var BusinessError = class extends Error {
|
|
7
|
+
code;
|
|
8
|
+
constructor(code, message) {
|
|
9
|
+
super(`API error (code=${code}): ${message}`);
|
|
10
|
+
this.name = "BusinessError";
|
|
11
|
+
this.code = code;
|
|
12
|
+
}
|
|
13
|
+
};
|
|
14
|
+
|
|
15
|
+
// src/betas.ts
|
|
16
|
+
var betaInterleavedThinking = "interleaved-thinking-2025-05-14";
|
|
17
|
+
var betaContext1M = "context-1m-2025-08-07";
|
|
18
|
+
var betaContextManagement = "context-management-2025-06-27";
|
|
19
|
+
var betaStructuredOutputs = "structured-outputs-2025-11-13";
|
|
20
|
+
var betaAdvancedToolUse = "advanced-tool-use-2025-11-20";
|
|
21
|
+
var betaEffort = "effort-2025-11-24";
|
|
22
|
+
var betaPromptCachingScope = "prompt-caching-scope-2026-01-05";
|
|
23
|
+
var betaFastMode = "fast-mode-2026-02-01";
|
|
24
|
+
var betaRedactThinking = "redact-thinking-2026-02-12";
|
|
25
|
+
var betaTokenEfficientTools = "token-efficient-tools-2025-02-19";
|
|
26
|
+
function buildBetas(caps, req) {
|
|
27
|
+
const betas = [];
|
|
28
|
+
if (caps.supports_isp) {
|
|
29
|
+
betas.push(betaInterleavedThinking);
|
|
30
|
+
betas.push(betaContextManagement);
|
|
31
|
+
}
|
|
32
|
+
if (caps.supports_redact_thinking && req.thinking && req.thinking.display === "summary") {
|
|
33
|
+
betas.push(betaRedactThinking);
|
|
34
|
+
}
|
|
35
|
+
if (caps.supports_1m_context) {
|
|
36
|
+
betas.push(betaContext1M);
|
|
37
|
+
}
|
|
38
|
+
const hasStructuredOutput = caps.supports_structured_output && req.outputConfig != null;
|
|
39
|
+
if (hasStructuredOutput) {
|
|
40
|
+
betas.push(betaStructuredOutputs);
|
|
41
|
+
} else if (caps.supports_token_efficient) {
|
|
42
|
+
betas.push(betaTokenEfficientTools);
|
|
43
|
+
}
|
|
44
|
+
if (caps.supports_tool_search) {
|
|
45
|
+
betas.push(betaAdvancedToolUse);
|
|
46
|
+
}
|
|
47
|
+
const needsEffort = req.effort != null || req.thinking != null && req.thinking.level && req.thinking.level !== ThinkingOff;
|
|
48
|
+
if (caps.supports_effort && needsEffort) {
|
|
49
|
+
betas.push(betaEffort);
|
|
50
|
+
}
|
|
51
|
+
if (caps.supports_fast_mode && req.speed === "fast") {
|
|
52
|
+
betas.push(betaFastMode);
|
|
53
|
+
}
|
|
54
|
+
if (caps.supports_prompt_cache) {
|
|
55
|
+
betas.push(betaPromptCachingScope);
|
|
56
|
+
}
|
|
57
|
+
return uniqueMerge(betas, req.betas ?? []);
|
|
58
|
+
}
|
|
59
|
+
function uniqueMerge(base, extra) {
|
|
60
|
+
if (extra.length === 0) return base;
|
|
61
|
+
const seen = new Set(base);
|
|
62
|
+
for (const s of extra) {
|
|
63
|
+
if (!seen.has(s)) {
|
|
64
|
+
base.push(s);
|
|
65
|
+
seen.add(s);
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
return base;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
// src/adapters/index.ts
|
|
72
|
+
({
|
|
73
|
+
anthropic: new AnthropicAdapter(),
|
|
74
|
+
/** Acosmi 自有模型走 Anthropic 格式 */
|
|
75
|
+
acosmi: new AnthropicAdapter()
|
|
76
|
+
});
|
|
77
|
+
|
|
78
|
+
// src/adapters/anthropic.ts
|
|
79
|
+
var AnthropicAdapter = class {
|
|
80
|
+
format() {
|
|
81
|
+
return 0 /* Anthropic */;
|
|
82
|
+
}
|
|
83
|
+
endpointSuffix() {
|
|
84
|
+
return "/anthropic";
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* 构建 Anthropic 格式请求体
|
|
88
|
+
* 逻辑等同于原 buildChatRequest, 包含完整的 betas/tools/serverTools/extraBody 处理
|
|
89
|
+
*/
|
|
90
|
+
buildRequestBody(caps, req) {
|
|
91
|
+
const body = {};
|
|
92
|
+
if (req.rawMessages != null) {
|
|
93
|
+
body["messages"] = req.rawMessages;
|
|
94
|
+
} else if ((req.messages?.length ?? 0) > 0) {
|
|
95
|
+
body["messages"] = req.messages;
|
|
96
|
+
}
|
|
97
|
+
body["stream"] = req.stream === true;
|
|
98
|
+
if (req.max_tokens && req.max_tokens > 0) {
|
|
99
|
+
body["max_tokens"] = req.max_tokens;
|
|
100
|
+
}
|
|
101
|
+
if (req.system != null) {
|
|
102
|
+
body["system"] = req.system;
|
|
103
|
+
}
|
|
104
|
+
if (req.temperature != null) {
|
|
105
|
+
body["temperature"] = req.temperature;
|
|
106
|
+
}
|
|
107
|
+
if (req.thinking && req.thinking.level && req.thinking.level !== "") {
|
|
108
|
+
resolveThinkingLevel(body, req, caps);
|
|
109
|
+
} else {
|
|
110
|
+
if (req.thinking) {
|
|
111
|
+
body["thinking"] = req.thinking;
|
|
112
|
+
}
|
|
113
|
+
if (req.effort) {
|
|
114
|
+
body["effort"] = req.effort;
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
if (req.metadata) {
|
|
118
|
+
body["metadata"] = req.metadata;
|
|
119
|
+
}
|
|
120
|
+
const allTools = [];
|
|
121
|
+
if (req.tools != null) {
|
|
122
|
+
try {
|
|
123
|
+
const parsed = JSON.parse(JSON.stringify(req.tools));
|
|
124
|
+
if (Array.isArray(parsed)) {
|
|
125
|
+
for (const t of parsed) allTools.push(t);
|
|
126
|
+
}
|
|
127
|
+
} catch {
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
for (const st of req.serverTools ?? []) {
|
|
131
|
+
const schema = {
|
|
132
|
+
type: st.type,
|
|
133
|
+
name: st.name
|
|
134
|
+
};
|
|
135
|
+
if (st.config) {
|
|
136
|
+
for (const [k, v] of Object.entries(st.config)) {
|
|
137
|
+
schema[k] = v;
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
allTools.push(schema);
|
|
141
|
+
}
|
|
142
|
+
if (allTools.length > 0) {
|
|
143
|
+
body["tools"] = allTools;
|
|
144
|
+
}
|
|
145
|
+
if (req.speed && req.speed !== "") {
|
|
146
|
+
body["speed"] = req.speed;
|
|
147
|
+
}
|
|
148
|
+
if (req.outputConfig) {
|
|
149
|
+
body["output_config"] = req.outputConfig;
|
|
150
|
+
}
|
|
151
|
+
const betas = buildBetas(caps, req);
|
|
152
|
+
if (betas.length > 0) {
|
|
153
|
+
body["betas"] = betas;
|
|
154
|
+
}
|
|
155
|
+
if (req.extraBody) {
|
|
156
|
+
for (const [k, v] of Object.entries(req.extraBody)) {
|
|
157
|
+
body[k] = v;
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
return body;
|
|
161
|
+
}
|
|
162
|
+
/**
|
|
163
|
+
* 解析 Anthropic 格式同步响应
|
|
164
|
+
* 兼容 APIResponse 包装 {"code":0,"data":{...}} 和裸 Anthropic JSON 两种格式
|
|
165
|
+
*/
|
|
166
|
+
parseResponse(bodyInput) {
|
|
167
|
+
const bodyStr = typeof bodyInput === "string" ? bodyInput : new TextDecoder().decode(bodyInput);
|
|
168
|
+
let raw = bodyStr;
|
|
169
|
+
try {
|
|
170
|
+
const wrapper = JSON.parse(bodyStr);
|
|
171
|
+
if (wrapper.data != null && wrapper.data !== null) {
|
|
172
|
+
if ((wrapper.code ?? 0) !== 0) {
|
|
173
|
+
throw new BusinessError(wrapper.code ?? 0, wrapper.message ?? "");
|
|
174
|
+
}
|
|
175
|
+
raw = JSON.stringify(wrapper.data);
|
|
176
|
+
}
|
|
177
|
+
} catch (e) {
|
|
178
|
+
if (e instanceof BusinessError) throw e;
|
|
179
|
+
}
|
|
180
|
+
let resp;
|
|
181
|
+
try {
|
|
182
|
+
resp = JSON.parse(raw);
|
|
183
|
+
} catch (e) {
|
|
184
|
+
throw new Error(
|
|
185
|
+
`decode anthropic response: ${e instanceof Error ? e.message : String(e)}`
|
|
186
|
+
);
|
|
187
|
+
}
|
|
188
|
+
resp.tokenRemaining = -1;
|
|
189
|
+
resp.callRemaining = -1;
|
|
190
|
+
resp.modelTokenRemaining = -1;
|
|
191
|
+
resp.modelTokenRemainingETU = -1;
|
|
192
|
+
return resp;
|
|
193
|
+
}
|
|
194
|
+
/**
|
|
195
|
+
* 解析 Anthropic SSE 行
|
|
196
|
+
*
|
|
197
|
+
* Anthropic 原生协议无 [DONE] (message_stop 后上游关闭连接),
|
|
198
|
+
* 但 Nexus Gateway 的 ChatStream 路径会追加 [DONE] 哨兵, 此处一并处理。
|
|
199
|
+
*/
|
|
200
|
+
parseStreamLine(eventType, data) {
|
|
201
|
+
if (data === "[DONE]") {
|
|
202
|
+
return { event: { event: "", data: "" }, done: true };
|
|
203
|
+
}
|
|
204
|
+
return { event: { event: eventType, data }, done: false };
|
|
205
|
+
}
|
|
206
|
+
};
|
|
207
|
+
function resolveThinkingLevel(body, req, caps) {
|
|
208
|
+
const level = req.thinking?.level ?? "";
|
|
209
|
+
if (level === ThinkingOff) {
|
|
210
|
+
body["thinking"] = { type: "disabled" };
|
|
211
|
+
return;
|
|
212
|
+
}
|
|
213
|
+
if (!caps.supports_adaptive_thinking && !caps.supports_thinking) {
|
|
214
|
+
return;
|
|
215
|
+
}
|
|
216
|
+
let maxTokens = req.max_tokens ?? 0;
|
|
217
|
+
if (maxTokens <= 0) {
|
|
218
|
+
maxTokens = ThinkingHighMinMaxTokens;
|
|
219
|
+
}
|
|
220
|
+
if (level === ThinkingMax) {
|
|
221
|
+
let modelMax = caps.max_output_tokens;
|
|
222
|
+
if (modelMax <= 0) modelMax = ThinkingMaxFallbackMaxTokens;
|
|
223
|
+
if (maxTokens < modelMax) maxTokens = modelMax;
|
|
224
|
+
} else {
|
|
225
|
+
if (maxTokens < ThinkingHighMinMaxTokens) maxTokens = ThinkingHighMinMaxTokens;
|
|
226
|
+
}
|
|
227
|
+
body["max_tokens"] = maxTokens;
|
|
228
|
+
if (caps.supports_adaptive_thinking) {
|
|
229
|
+
const thinking = { type: "adaptive" };
|
|
230
|
+
if (req.thinking?.display) thinking["display"] = req.thinking.display;
|
|
231
|
+
body["thinking"] = thinking;
|
|
232
|
+
} else if (caps.supports_thinking) {
|
|
233
|
+
let budget = maxTokens - 1;
|
|
234
|
+
if (budget < 1024) budget = 1024;
|
|
235
|
+
const thinking = {
|
|
236
|
+
type: "enabled",
|
|
237
|
+
budget_tokens: budget
|
|
238
|
+
};
|
|
239
|
+
if (req.thinking?.display) thinking["display"] = req.thinking.display;
|
|
240
|
+
body["thinking"] = thinking;
|
|
241
|
+
}
|
|
242
|
+
if (caps.supports_effort) {
|
|
243
|
+
let effortLevel = "high";
|
|
244
|
+
if (level === ThinkingMax && caps.supports_max_effort) {
|
|
245
|
+
effortLevel = "max";
|
|
246
|
+
}
|
|
247
|
+
body["effort"] = { level: effortLevel };
|
|
248
|
+
}
|
|
249
|
+
delete body["temperature"];
|
|
250
|
+
}
|
|
251
|
+
|
|
252
|
+
export { AnthropicAdapter, resolveThinkingLevel };
|
|
253
|
+
//# sourceMappingURL=anthropic.js.map
|
|
254
|
+
//# sourceMappingURL=anthropic.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../../src/types.ts","../../../src/betas.ts","../../../src/adapters/index.ts","../../../src/adapters/anthropic.ts"],"names":[],"mappings":"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","file":"anthropic.js","sourcesContent":["// types.ts — 端口自 acosmi-sdk-go/types.go (v0.19.0, 1275 行)\n//\n// 命名约定:\n// - 字段名 = Go json tag 字面量 (wire format), 不做 camelCase 重映射\n// - mix 风格 (modelId / max_tokens / supports_thinking) 是历史 wire 设计的真实样貌\n// - 这样 JSON.parse / JSON.stringify 可直接来回, 与 Go 侧 0 偏差\n//\n// int64 字段用 number — JS number 安全上限 2^53, Acosmi 业务量级远低于此。\n// time.Time 字段用 ISO 8601 string 形态, 与 Go json wire 一致。\n// json.RawMessage 用 unknown (caller 自行 typed)。\n// json.Number 用 string (避免精度丢失)。\n\n// =============================================================================\n// OAuth\n// =============================================================================\n\n/** OAuth Authorization Server 元数据 (RFC 8414) */\nexport interface ServerMetadata {\n issuer: string;\n authorization_endpoint: string;\n token_endpoint: string;\n revocation_endpoint: string;\n registration_endpoint: string;\n scopes_supported: string[];\n}\n\n/** OAuth token 响应 */\nexport interface TokenResponse {\n access_token: string;\n token_type: string;\n expires_in: number;\n refresh_token?: string;\n scope?: string;\n}\n\n/** 持久化 token 对 */\nexport interface TokenSet {\n access_token: string;\n refresh_token: string;\n /** ISO 8601 格式 */\n expires_at: string;\n scope: string;\n client_id: string;\n server_url: string;\n}\n\n/** token 是否已过期 (提前 30 秒视为过期) */\nexport function tokenSetIsExpired(t: TokenSet): boolean {\n const expiresAt = new Date(t.expires_at).getTime();\n return Date.now() > expiresAt - 30_000;\n}\n\n/** 动态注册响应 */\nexport interface ClientRegistration {\n client_id: string;\n client_secret?: string;\n}\n\n// =============================================================================\n// Managed Models\n// =============================================================================\n\n/** 模型能力矩阵 — 下游通过此结构决定 UI 功能开关和 Beta Header 注入 */\nexport interface ModelCapabilities {\n // 思考能力\n supports_thinking: boolean;\n supports_adaptive_thinking: boolean;\n /** 交错思考 (Interleaved Thinking) */\n supports_isp: boolean;\n\n // 工具与搜索\n supports_web_search: boolean;\n supports_tool_search: boolean;\n supports_structured_output: boolean;\n\n // 推理控制\n supports_effort: boolean;\n /** 模型是否支持 thinking_level=\"max\" 强度档 (深度思考) */\n supports_max_effort: boolean;\n /** Opus 4.6 独有 (Speed=\"fast\") */\n supports_fast_mode: boolean;\n /** Auto 模式 (模型自主选择工具/搜索策略) */\n supports_auto_mode: boolean;\n\n // 上下文与缓存\n supports_1m_context: boolean;\n supports_prompt_cache: boolean;\n /** 通过 context-management beta 控制 */\n supports_cache_editing: boolean;\n\n // 输出控制\n /** Claude 4 内置 */\n supports_token_efficient: boolean;\n supports_redact_thinking: boolean;\n\n // Token 上限 (冗余但便于查询)\n max_input_tokens: number;\n max_output_tokens: number;\n}\n\n/** BucketClass 字面量常量 — V30 二轮审计 D-P1-3 修复 */\nexport const BucketClassCommercial = 'COMMERCIAL';\nexport const BucketClassGeneric = 'GENERIC';\n\n/**\n * 用户在某 modelId 上的桶余额聚合视图 (V30 entitlement-listing).\n *\n * 多桶聚合规则 (上游 nexus-v4 计算后下发, 全部单位为 ETU):\n * - quotaEtu / usedEtu / remainingEtu: 该 modelId 下用户全部 active 桶求和\n * - sharedPoolEtu: 求和量中\"来自通配桶\"的部分 (跨模型可消耗)\n * - bucketClass / expiresAt: 取最高优先级桶\n * - expired: 全部桶都过期才置 true\n */\nexport interface BucketInfo {\n quotaEtu: number;\n usedEtu: number;\n remainingEtu: number;\n sharedPoolEtu?: number;\n expiresAt?: string;\n bucketClass: string;\n expired?: boolean;\n /** v0.19+ — GENERIC alive 桶 tokenRemaining 求和 (\"免费余额\", 真实可消费) */\n freeRemainingEtu: number;\n /** v0.19+ — COMMERCIAL alive 桶 tokenRemaining 求和 (\"付费余额\") */\n paidRemainingEtu: number;\n}\n\n/** 大小写不敏感判定 — 与 buildBucketView (managed_model.go) EqualFold 语义对齐 */\nexport function bucketInfoIsCommercial(b: BucketInfo | null | undefined): boolean {\n if (!b) return false;\n return b.bucketClass.toLowerCase() === BucketClassCommercial.toLowerCase();\n}\n\n/** 托管模型 */\nexport interface ManagedModel {\n id: string;\n name: string;\n provider: string;\n modelId: string;\n maxTokens: number;\n isEnabled: boolean;\n pricePerMTok?: number;\n isDefault?: boolean;\n contextWindow?: number;\n capabilities: ModelCapabilities;\n\n /**\n * 上游 gateway 为此模型启用的请求格式列表\n * 取值: \"anthropic\" | \"openai\"\n * 空值表示上游未声明, SDK 回落 provider 硬编码分支 (向后兼容)\n */\n supported_formats?: string[];\n\n /**\n * 上游建议客户端优先使用的格式\n * 取值: \"anthropic\" | \"openai\"; 空值等价于 supported_formats[0]\n */\n preferred_format?: string;\n\n /**\n * 当前用户在此模型上的桶余额聚合 (V0.18 V30 entitlement-listing).\n *\n * 仅当调用方为非 admin 用户 (web user / desktop OAuth) 时上游才会返回此字段:\n * - admin / X-Internal-Bypass 调用 → 缺失\n * - 普通用户 → 非空, 含 quota/used/remaining 求和\n */\n bucketInfo?: BucketInfo;\n}\n\n// =============================================================================\n// QuotaSummary — v0.19+ 账户级权益总览 (免费/付费切分)\n// =============================================================================\n\n/** 单桶视图 — QuotaSummary.freeBuckets/paidBuckets 元素 */\nexport interface BucketRow {\n bucketId: string;\n /** 精确桶为具体 modelId, 通配桶为 \"*\" */\n modelId: string;\n /** COMMERCIAL | GENERIC */\n bucketClass: string;\n tokenQuota: number;\n tokenUsed: number;\n tokenRemaining: number;\n /** 永久桶为 undefined */\n expiresAt?: string;\n expired?: boolean;\n}\n\nexport function bucketRowIsCommercial(r: BucketRow | null | undefined): boolean {\n if (!r) return false;\n return r.bucketClass.toLowerCase() === BucketClassCommercial.toLowerCase();\n}\n\n/**\n * GET /api/v4/entitlements/quota-summary 返回体, 调用 client.getQuotaSummary 获取.\n *\n * 设计目的: 个人中心钱包栏一次性展示\"我还有多少免费 + 多少付费\"+ 各自最近到期时间.\n */\nexport interface QuotaSummary {\n /** GENERIC (免费/赠送) alive 桶 tokenRemaining 求和 */\n freeTotalEtu: number;\n /** COMMERCIAL (付费购买) alive 桶 tokenRemaining 求和 */\n paidTotalEtu: number;\n /** GENERIC 桶详情 (含过期, UI 列流水); 空时为空数组 */\n freeBuckets: BucketRow[];\n /** COMMERCIAL 桶详情 (含过期); 空时为空数组 */\n paidBuckets: BucketRow[];\n /** GENERIC alive 桶中最早到期; 永久桶/无 alive 时缺失 */\n nextFreeExpiresAt?: string;\n /** COMMERCIAL alive 桶中最早到期; 同上 */\n nextPaidExpiresAt?: string;\n}\n\n// =============================================================================\n// Chat\n// =============================================================================\n\n/** 聊天消息 (简单文本格式, CrabClaw 使用) */\nexport interface ChatMessage {\n role: string;\n content: string;\n}\n\n/** Anthropic 响应内容块 */\nexport interface ChatContentBlock {\n type: string;\n text?: string;\n citations?: unknown;\n thinking?: string;\n signature?: string;\n data?: string;\n id?: string;\n name?: string;\n /** json.RawMessage in Go */\n input?: unknown;\n server_name?: string;\n caller?: unknown;\n tool_use_id?: string;\n content?: unknown;\n is_error?: boolean;\n}\n\n/** Anthropic 格式 token 用量 */\nexport interface ChatUsage {\n input_tokens: number;\n output_tokens: number;\n cache_creation_input_tokens?: number;\n cache_read_input_tokens?: number;\n}\n\n// ---------- Thinking ----------\n\n/** 三档思考级别 (v0.9.0) */\nexport const ThinkingOff = 'off';\nexport const ThinkingHigh = 'high';\nexport const ThinkingMax = 'max';\n\n/** 标准思考最低 maxTokens — CrabCode 默认 MAX_OUTPUT_TOKENS_DEFAULT = 32_000 */\nexport const ThinkingHighMinMaxTokens = 32_000;\n/** 深度思考回退 maxTokens — Opus 4.6 上限 128K */\nexport const ThinkingMaxFallbackMaxTokens = 128_000;\n\n/** 控制模型思考行为 */\nexport interface ThinkingConfig {\n /** \"enabled\" | \"disabled\" | \"adaptive\" */\n type: string;\n /** 仅 type=\"enabled\" 时 (旧模型回退) */\n budget_tokens?: number;\n /** 思考级别 (v0.9.0): \"off\" | \"high\" | \"max\" */\n level?: string;\n /** \"none\" | \"summary\" | \"\" (默认空=完整) */\n display?: string;\n}\n\n/** 根据三档 level 创建配置 */\nexport function newThinkingConfig(level: string): ThinkingConfig {\n if (level === '' || level === ThinkingOff) {\n return { type: 'disabled' };\n }\n return { type: 'adaptive', level };\n}\n\n/** 服务端工具定义 — SDK 将工具 schema 合入 API 请求的 tools 数组 */\nexport interface ServerTool {\n type: string;\n name: string;\n config?: Record<string, unknown>;\n}\n\n/** Server Tool 类型常量 */\nexport const ServerToolTypeWebSearch = 'web_search_20250305';\n\n/** 地理位置 */\nexport interface GeoLoc {\n /** ISO 3166-1 alpha-2 */\n country: string;\n city?: string;\n}\n\n/** ServerTool.config 结构 (type=web_search_20250305) */\nexport interface WebSearchConfig {\n /** 每请求最大搜索次数, 默认 8 */\n max_uses?: number;\n /** 域名白名单 (与 blocked_domains 互斥) */\n allowed_domains?: string[];\n /** 域名黑名单 (与 allowed_domains 互斥) */\n blocked_domains?: string[];\n user_location?: GeoLoc;\n}\n\n/** 控制推理努力级别 */\nexport interface EffortConfig {\n /** \"low\" | \"medium\" | \"high\" | \"max\" */\n level: string;\n}\n\n/** 控制输出格式 (结构化输出) */\nexport interface OutputConfig {\n /** \"json_schema\" | \"\" */\n format?: string;\n schema?: unknown;\n}\n\n/**\n * 创建搜索 Server Tool 的便捷方法\n * allowed_domains 与 blocked_domains 互斥, 同时传入抛 Error\n */\nexport function newWebSearchTool(cfg?: WebSearchConfig | null): ServerTool {\n const st: ServerTool = {\n type: ServerToolTypeWebSearch,\n name: 'web_search',\n };\n if (cfg) {\n if ((cfg.allowed_domains?.length ?? 0) > 0 && (cfg.blocked_domains?.length ?? 0) > 0) {\n throw new Error('web search: allowed_domains and blocked_domains are mutually exclusive');\n }\n const m: Record<string, unknown> = {};\n if (cfg.max_uses && cfg.max_uses > 0) m['max_uses'] = cfg.max_uses;\n if (cfg.allowed_domains?.length) m['allowed_domains'] = cfg.allowed_domains;\n if (cfg.blocked_domains?.length) m['blocked_domains'] = cfg.blocked_domains;\n if (cfg.user_location) m['user_location'] = cfg.user_location;\n if (Object.keys(m).length > 0) st.config = m;\n }\n return st;\n}\n\n/**\n * 聊天请求\n *\n * 基础字段供 CrabClaw 使用, 扩展字段供 CrabCode 使用。\n * 所有新增字段零值不改变行为 (向后兼容)。\n *\n * 注意:扩展字段(rawMessages/system/tools/...)不会被原样 JSON.stringify,\n * 而由 buildRequestBody (adapter) 选择性序列化到请求体。\n */\nexport interface ChatRequest {\n // ── 基础字段 (CrabClaw 兼容) ──\n messages?: ChatMessage[];\n stream?: boolean;\n max_tokens?: number;\n\n // ── 完整请求控制 (CrabCode 扩展) ── 不直接 JSON 序列化, 由 buildRequestBody 处理\n /** 复杂消息体 (含 content blocks / 多模态), 非 nil 时优先于 messages */\n rawMessages?: unknown;\n /** string 或 ContentBlock[] */\n system?: unknown;\n /** 标准工具定义 (Tool[]) */\n tools?: unknown;\n temperature?: number;\n thinking?: ThinkingConfig;\n metadata?: Record<string, string>;\n /** 显式 beta (SDK 自动合并) */\n betas?: string[];\n /** 服务端工具 (buildRequestBody 合入 tools 数组) */\n serverTools?: ServerTool[];\n /** \"\" | \"fast\" (Fast Mode) */\n speed?: string;\n effort?: EffortConfig;\n outputConfig?: OutputConfig;\n /** 任意扩展字段 (buildRequestBody 合入请求体) */\n extraBody?: Record<string, unknown>;\n\n /**\n * v0.13.0: OpenAI wire format 原生字段。AnthropicAdapter 忽略,\n * OpenAIAdapter 按 OpenAI 规范序列化。\n *\n * 对应 OpenAI `parallel_tool_calls` 顶层字段, undefined = 不设置 (沿用上游默认 true)。\n */\n parallelToolCalls?: boolean;\n}\n\n// ---------- Web Search Sources ----------\n\n/** 联网搜索结果来源 (与后端 adk/stream_helpers.go SourceItem 对齐) */\nexport interface WebSearchSource {\n title: string;\n url: string;\n snippet?: string;\n}\n\n/** 搜索来源事件 (从 SSE \"sources\" 事件解析) */\nexport interface SourcesEvent {\n sources: WebSearchSource[];\n session_id?: string;\n}\n\n/**\n * 从 StreamEvent 中解析搜索来源\n * 返回 null 表示该事件不是 sources 类型\n */\nexport function parseSourcesEvent(ev: StreamEvent): SourcesEvent | null {\n let wrapper: { type?: string; sources?: WebSearchSource[]; session_id?: string };\n try {\n wrapper = JSON.parse(ev.data);\n } catch {\n return null;\n }\n if (wrapper.type !== 'sources' && ev.event !== 'sources') {\n return null;\n }\n if (!wrapper.sources || wrapper.sources.length === 0) {\n return null;\n }\n return { sources: wrapper.sources, session_id: wrapper.session_id };\n}\n\n// =============================================================================\n// OpenAI 兼容响应类型 (非 Anthropic 厂商)\n// =============================================================================\n\nexport interface OpenAIChatResponse {\n id: string;\n /** \"chat.completion\" */\n object: string;\n model: string;\n choices: OpenAIChatChoice[];\n usage: OpenAIUsage;\n}\n\nexport interface OpenAIChatChoice {\n index: number;\n message: OpenAIChatMessage;\n /** \"stop\", \"tool_calls\", \"length\" */\n finish_reason: string;\n}\n\nexport interface OpenAIChatMessage {\n role: string;\n content: string;\n tool_calls?: OpenAIToolCall[];\n /** GLM/DeepSeek thinking */\n reasoning_content?: string;\n}\n\nexport interface OpenAIToolCall {\n id: string;\n /** \"function\" */\n type: string;\n function: OpenAIFunctionCall;\n}\n\nexport interface OpenAIFunctionCall {\n name: string;\n arguments: string;\n}\n\nexport interface OpenAIUsage {\n prompt_tokens: number;\n completion_tokens: number;\n total_tokens: number;\n}\n\n/** OpenAI SSE delta 格式 */\nexport interface OpenAIStreamChunk {\n id: string;\n /** \"chat.completion.chunk\" */\n object: string;\n choices: OpenAIStreamChoice[];\n usage?: OpenAIUsage;\n}\n\nexport interface OpenAIStreamChoice {\n index: number;\n delta: OpenAIStreamDelta;\n finish_reason: string | null;\n}\n\nexport interface OpenAIStreamDelta {\n role?: string;\n content?: string;\n reasoning_content?: string;\n tool_calls?: OpenAIStreamToolCall[];\n}\n\nexport interface OpenAIStreamToolCall {\n index: number;\n id?: string;\n type?: string;\n function: OpenAIFunctionCall;\n}\n\n// =============================================================================\n// ChatResponse / AnthropicResponse\n// =============================================================================\n\n/**\n * 同步聊天响应 (Anthropic format, v0.4.1)\n *\n * tokenRemaining / callRemaining / modelTokenRemaining* 不在 wire JSON 中, 由 client 从 Header 填充。\n * 哨兵 -1 表示服务端未返回。\n */\nexport interface ChatResponse {\n id: string;\n type: string;\n model: string;\n role: string;\n content: ChatContentBlock[];\n stop_reason: string;\n usage: ChatUsage;\n /** -1 表示服务端未返回 */\n tokenRemaining: number;\n callRemaining: number;\n modelTokenRemaining: number;\n modelTokenRemainingETU: number;\n}\n\n/**\n * Anthropic 内容块\n * 覆盖: text / thinking / redacted_thinking / tool_use / tool_result /\n * server_tool_use / mcp_tool_use / mcp_tool_result\n */\nexport interface AnthropicContentBlock {\n type: string;\n text?: string;\n /** tool_use / server_tool_use / mcp_tool_use block ID */\n id?: string;\n /** tool_use function name */\n name?: string;\n /** tool_use arguments (json.RawMessage) */\n input?: unknown;\n /** thinking block content */\n thinking?: string;\n\n /** text — web_search 搜索引用 */\n citations?: unknown;\n /** thinking — Anthropic 签名 (后续请求必须回传) */\n signature?: string;\n /** redacted_thinking — base64 编码的被审查思考内容 */\n data?: string;\n /** server_tool_use / mcp_tool_use / mcp_tool_result — 服务端工具来源 */\n server_name?: string;\n /** mcp_tool_use — MCP 调用者上下文 */\n caller?: unknown;\n /** tool_result / mcp_tool_result — 工具执行结果 */\n tool_use_id?: string;\n content?: unknown;\n is_error?: boolean;\n}\n\n/** Anthropic token 用量 */\nexport interface AnthropicUsage {\n input_tokens: number;\n output_tokens: number;\n cache_creation_input_tokens?: number;\n cache_read_input_tokens?: number;\n}\n\n/**\n * Anthropic 原生格式同步响应\n * POST /managed-models/:id/anthropic 返回此格式 (无 response.Success 包装)\n */\nexport interface AnthropicResponse {\n id: string;\n /** \"message\" */\n type: string;\n /** \"assistant\" */\n role: string;\n content: AnthropicContentBlock[];\n model: string;\n stop_reason: string;\n stop_sequence?: string | null;\n usage: AnthropicUsage;\n}\n\n/** 提取所有 text 类型内容块的文本,拼接返回 */\nexport function anthropicResponseTextContent(r: AnthropicResponse): string {\n const parts: string[] = [];\n for (const b of r.content) {\n if (b.type === 'text' && b.text) parts.push(b.text);\n }\n return parts.join('');\n}\n\n/** 提取所有 thinking 类型内容块的文本,拼接返回 */\nexport function anthropicResponseThinkingContent(r: AnthropicResponse): string {\n const parts: string[] = [];\n for (const b of r.content) {\n if (b.type === 'thinking' && b.thinking) parts.push(b.thinking);\n }\n return parts.join('');\n}\n\n/** 返回所有 tool_use 类型的内容块 */\nexport function anthropicResponseToolUseBlocks(r: AnthropicResponse): AnthropicContentBlock[] {\n return r.content.filter((b) => b.type === 'tool_use');\n}\n\n// =============================================================================\n// SSE Stream\n// =============================================================================\n\n/**\n * SSE 流式事件\n *\n * v0.11.0 新增 blockIndex/blockType/ephemeral 三字段 (in-band content block 元数据)。\n * 零值等价 v0.10.0 行为, 未识别的事件三字段全部零值。\n */\nexport interface StreamEvent {\n event: string;\n data: string;\n /** 对齐 Anthropic content_block_start/delta/stop 的 index 字段 */\n blockIndex?: number;\n /** 由 content_block_start 解析得到, delta/stop 从 index→type 映射查出 */\n blockType?: string;\n /** 网关标记此 block 下一轮不应回传 */\n ephemeral?: boolean;\n}\n\n/**\n * 流式结算事件 (从 settled SSE 事件解析)\n * 包含本次请求的 token 消耗及结算后的剩余余额\n */\nexport interface StreamSettlement {\n requestId: string;\n consumeStatus: string;\n inputTokens: number;\n outputTokens: number;\n totalTokens: number;\n /** 结算后剩余 token (-1 表示服务端未返回) */\n tokenRemaining: number;\n /** 结算后剩余调用次数 (-1 表示服务端未返回) */\n callRemaining: number;\n}\n\n/** 从 settled 类型的 StreamEvent 中解析结算信息. 不是 settled 类型则返回 null. */\nexport function parseSettlement(ev: StreamEvent): StreamSettlement | null {\n if (ev.event !== 'settled' && ev.event !== 'pending_settle') {\n return null;\n }\n let s: Partial<StreamSettlement>;\n try {\n s = JSON.parse(ev.data);\n } catch {\n return null;\n }\n return {\n requestId: s.requestId ?? '',\n consumeStatus: s.consumeStatus ?? '',\n inputTokens: s.inputTokens ?? 0,\n outputTokens: s.outputTokens ?? 0,\n totalTokens: s.totalTokens ?? 0,\n tokenRemaining: s.tokenRemaining ?? -1,\n callRemaining: s.callRemaining ?? -1,\n };\n}\n\n// =============================================================================\n// Entitlements\n// =============================================================================\n\n/** 权益余额 (聚合) */\nexport interface EntitlementBalance {\n totalTokenQuota: number;\n totalTokenUsed: number;\n totalTokenRemaining: number;\n totalCallQuota: number;\n totalCallUsed: number;\n totalCallRemaining: number;\n activeEntitlements: number;\n}\n\n/** 单条权益明细 */\nexport interface EntitlementItem {\n id: string;\n type: string;\n status: string;\n tokenQuota: number;\n tokenUsed: number;\n tokenRemaining: number;\n callQuota: number;\n callUsed: number;\n callRemaining: number;\n expiresAt?: string;\n sourceId?: string;\n sourceType?: string;\n remark?: string;\n createdAt: string;\n}\n\n/** 详细余额 (含每条权益明细) */\nexport interface BalanceDetail {\n totalTokenQuota: number;\n totalTokenUsed: number;\n totalTokenRemaining: number;\n totalCallQuota: number;\n totalCallUsed: number;\n totalCallRemaining: number;\n activeEntitlements: number;\n entitlements: EntitlementItem[];\n}\n\n/** 核销记录 */\nexport interface ConsumeRecord {\n id: string;\n entitlementId: string;\n requestId: string;\n modelId?: string;\n tokensConsumed: number;\n status: string;\n createdAt: string;\n}\n\n/** 核销记录分页响应 */\nexport interface ConsumeRecordPage {\n records: ConsumeRecord[];\n total: number;\n page: number;\n pageSize: number;\n}\n\n// =============================================================================\n// V29 Per-Model Bucket\n// =============================================================================\n\n/**\n * 单桶视图 (用户多桶 hero / 模型切换提示用)\n *\n * 字段名仍叫 ETU 但 T3 死代码清除后 = raw token (V29 系数管理已退役)。\n */\nexport interface ModelBucket {\n bucketId: string;\n entitlementId: string;\n /** \"*\" = 通配 */\n modelId: string;\n /** COMMERCIAL / GENERIC */\n bucketClass: string;\n tokenQuota: number;\n tokenUsed: number;\n tokenRemaining: number;\n callQuota: number;\n callUsed: number;\n callRemaining: number;\n allowedModelsJson?: string;\n}\n\n/** GetByModel 响应; primaryBucket 在 bucketId 为空时表示无可用桶。 */\nexport interface ModelByQuotaResponse {\n modelId: string;\n /** 折算后剩余 (调度判定用) */\n etuRemaining: number;\n /** 反系数估算的原始 token (UI 展示用) */\n rawTokenRemaining: number;\n hasQuota: boolean;\n primaryBucket?: ModelBucket;\n}\n\n/** 单条模型系数 (SDK TTL 8s 缓存源) */\nexport interface ModelCoefficient {\n modelId: string;\n tenantId: string;\n inputCoef: number;\n outputCoef: number;\n cacheReadCoef: number;\n cacheCreationCoef: number;\n version: number;\n effectiveAt: string;\n}\n\n// =============================================================================\n// Token Packages (商城)\n// =============================================================================\n\n/** 流量包商品。price 用 string (Go json.Number) 避免浮点精度丢失。 */\nexport interface TokenPackage {\n id: string;\n name: string;\n description?: string;\n tokenQuota: number;\n callQuota?: number;\n price: string;\n validDays: number;\n isEnabled: boolean;\n sortOrder?: number;\n}\n\n/** 订单。amount 用 string (Go json.Number) 避免精度丢失。 */\nexport interface Order {\n id: string;\n packageId: string;\n packageName?: string;\n amount: string;\n status: string;\n payUrl?: string;\n createdAt: string;\n}\n\n/** 订单状态 */\nexport interface OrderStatus {\n orderId: string;\n status: string;\n}\n\n/** 下单请求 */\nexport interface PayPayload {\n payMethod?: string;\n}\n\n// =============================================================================\n// Wallet (钱包)\n// =============================================================================\n\n/** 钱包统计。金额使用 string (Go json.Number) 避免浮点精度丢失 (金融安全) */\nexport interface WalletStats {\n balance: string;\n monthlyConsumption: string;\n monthlyRecharge: string;\n transactionCount: number;\n}\n\n/** 交易记录 */\nexport interface Transaction {\n id: string;\n type: string;\n amount: string;\n remark?: string;\n createdAt: string;\n}\n\n// =============================================================================\n// Skill Store\n// =============================================================================\n\nexport interface SkillStoreItem {\n id: string;\n pluginId: string;\n key: string;\n name: string;\n description: string;\n icon: string;\n category: string;\n inputSchema: string;\n outputSchema: string;\n timeout: number;\n retryCount: number;\n retryDelay: number;\n version: string;\n totalCalls: number;\n avgDurationMs: number;\n successRate: number;\n isEnabled: boolean;\n securityLevel: string;\n securityScore: number;\n scope: string;\n status: string;\n downloadCount: number;\n readme: string;\n tags: string[];\n author: string;\n publisherId: string;\n isPublished: boolean;\n pluginName: string;\n pluginIcon: string;\n updatedAt: string;\n visibility?: string;\n certificationStatus?: string;\n source?: string;\n}\n\n/** 技能商店搜索参数 (非 wire 类型, 用于 client 方法参数) */\nexport interface SkillStoreQuery {\n category?: string;\n keyword?: string;\n tag?: string;\n}\n\n/** 技能统计概览 */\nexport interface SkillSummary {\n installed: number;\n created: number;\n total: number;\n storeAvailable: number;\n}\n\n/** 技能商店分页浏览响应 */\nexport interface SkillBrowseResponse {\n items: SkillStoreItem[];\n total: number;\n page: number;\n pageSize: number;\n}\n\n/**\n * 技能商店列表项(轻量,仅含浏览所需字段)\n * 配合服务端 fields=minimal 参数使用,响应体积缩减 90%+\n */\nexport interface SkillStoreListItem {\n id: string;\n key: string;\n name: string;\n description: string;\n icon: string;\n category: string;\n version: string;\n author: string;\n downloadCount: number;\n tags: string[];\n certificationStatus?: string;\n visibility?: string;\n source?: string;\n updatedAt: string;\n}\n\n/** 技能商店轻量浏览响应 */\nexport interface SkillBrowseListResponse {\n items: SkillStoreListItem[];\n total: number;\n page: number;\n pageSize: number;\n}\n\n/** 技能认证状态响应 */\nexport interface CertificationStatus {\n skillId: string;\n certificationStatus: string;\n certifiedAt?: number;\n securityLevel?: string;\n securityScore: number;\n report?: unknown;\n}\n\n// =============================================================================\n// Skill Generator\n// =============================================================================\n\nexport interface GenerateSkillRequest {\n purpose: string;\n examples?: string[];\n inputHints?: string;\n outputHints?: string;\n category?: string;\n language?: string;\n}\n\nexport interface GenerateSkillResult {\n skillName: string;\n skillKey: string;\n description: string;\n skillMd: string;\n inputSchema: string;\n outputSchema: string;\n testCases: string[];\n readme: string;\n category: string;\n tags: string[];\n timeout: number;\n}\n\nexport interface OptimizeSkillRequest {\n skillName: string;\n description?: string;\n inputSchema?: string;\n outputSchema?: string;\n readme?: string;\n aspects?: string[];\n}\n\nexport interface OptimizeSkillResult {\n optimizedSkill: GenerateSkillResult;\n changes: string[];\n score: number;\n}\n\n// =============================================================================\n// Unified Tools\n// =============================================================================\n\nexport interface ToolView {\n id: string;\n key: string;\n name: string;\n description: string;\n icon: string;\n category: string;\n inputSchema: string;\n outputSchema: string;\n timeout: number;\n isEnabled: boolean;\n provider?: ToolProvider;\n}\n\nexport interface ToolProvider {\n id: string;\n name: string;\n icon: string;\n sourceType: string;\n mcpEndpoint?: string;\n isEnabled: boolean;\n}\n\nexport interface ToolListResponse {\n skills: ToolView[];\n total: number;\n}\n\n// =============================================================================\n// Errors (类型化)\n// =============================================================================\n\n/** 下载限流错误 (429) */\nexport class RateLimitError extends Error {\n retryAfter: string;\n raw: string;\n\n constructor(message: string, retryAfter: string, raw: string) {\n super(message);\n this.name = 'RateLimitError';\n this.retryAfter = retryAfter;\n this.raw = raw;\n }\n}\n\n/**\n * API 业务层错误 (HTTP 200 但 code != 0)\n * tk-dist 代理透传 yudao 响应, HTTP 状态码为 200, 业务错误在 JSON code 字段\n */\nexport class BusinessError extends Error {\n code: number;\n\n constructor(code: number, message: string) {\n super(`API error (code=${code}): ${message}`);\n this.name = 'BusinessError';\n this.code = code;\n }\n}\n\n/**\n * 订单到达非成功终态 (FAILED/CANCELLED/CLOSED/EXPIRED/REFUNDED)\n * waitForPayment 在订单终态为非成功时抛此错误\n */\nexport class OrderTerminalError extends Error {\n orderId: string;\n status: string;\n\n constructor(orderId: string, status: string) {\n super(`order ${orderId} terminated: ${status}`);\n this.name = 'OrderTerminalError';\n this.orderId = orderId;\n this.status = status;\n }\n}\n\n/**\n * 模型缓存未命中且 listModels 刷新后仍未找到。\n *\n * 历史上 getCachedModel miss 时硬返 ManagedModel{provider:\"anthropic\"} 占位,\n * 导致未预热场景下的 chat 请求按 AnthropicAdapter 编码, 被发到错误端点。\n * v0.13.x 改为 miss → listModels 自动刷新一次; 仍 miss → 抛此错误。\n */\nexport class ModelNotFoundError extends Error {\n modelId: string;\n\n constructor(modelId: string) {\n super(`managed model \"${modelId}\" not found (list models to refresh cache, or verify model id)`);\n this.name = 'ModelNotFoundError';\n this.modelId = modelId;\n }\n}\n\n/**\n * 结构化 HTTP 非 2xx 错误.\n *\n * 用 instanceof 提取:\n * try { ... } catch (e) {\n * if (e instanceof HTTPError && e.statusCode === 429) { ... }\n * }\n */\nexport class HTTPError extends Error {\n statusCode: number;\n /** anthropic.error.type / openai.error.type, 缺失为空 */\n type: string;\n /** Retry-After 头解析的秒数, 0 表示未提供或解析失败 */\n retryAfter: number;\n /** 原始响应体 (截断到 maxErrorBodySize) */\n body: string;\n\n constructor(statusCode: number, opts: { type?: string; message?: string; retryAfter?: number; body?: string } = {}) {\n let msg: string;\n if (opts.type) {\n msg = `HTTP ${statusCode}: [${opts.type}] ${opts.message ?? ''}`;\n } else if (opts.message) {\n msg = `HTTP ${statusCode}: ${opts.message}`;\n } else if (opts.body) {\n msg = `HTTP ${statusCode}: ${opts.body}`;\n } else {\n msg = `HTTP ${statusCode}`;\n }\n super(msg);\n this.name = 'HTTPError';\n this.statusCode = statusCode;\n this.type = opts.type ?? '';\n this.retryAfter = opts.retryAfter ?? 0;\n this.body = opts.body ?? '';\n }\n}\n\n/**\n * 结构化网络层错误 (传输失败, 区别于上游业务错误).\n *\n * 包装 fetch 抛出的错误 — 含 timeout / EOF / connection refused / DNS 失败等.\n * retry policy: isTimeout / isEOF 任一为 true → 默认可重试.\n */\nexport class NetworkError extends Error {\n /** 操作描述, e.g. \"POST /v1/messages\" */\n op: string;\n /** 请求 URL (脱敏后) */\n url: string;\n override cause?: unknown;\n timeout: boolean;\n eof: boolean;\n\n constructor(op: string, url: string, cause: unknown, opts: { timeout?: boolean; eof?: boolean } = {}) {\n const causeMsg = cause instanceof Error ? cause.message : cause != null ? String(cause) : 'network error';\n super(`${op} ${url}: ${causeMsg}`);\n this.name = 'NetworkError';\n this.op = op;\n this.url = url;\n this.cause = cause;\n this.timeout = opts.timeout ?? false;\n this.eof = opts.eof ?? false;\n }\n\n isTimeout(): boolean {\n return this.timeout;\n }\n\n isEOF(): boolean {\n return this.eof;\n }\n}\n\n/**\n * 流式失败事件的结构化表示。\n *\n * 由 gateway 的 `managed_model_stream_failed` 事件解析得到。客户端可通过\n * instanceof 提取并按 code/retryable 决策。\n */\nexport class StreamError extends Error {\n /** 例: \"empty_response\" / \"rate_limit\" / \"overloaded\" / \"\" */\n code: string;\n /** 例: \"provider\" / \"settlement\" */\n stage: string;\n /** 用户友好提示 (中文); 历史字段, 与 rawError 区分 */\n userMessage: string;\n /** gateway 原始 error 字符串 */\n rawError: string;\n /** 客户端是否值得重试 */\n retryable: boolean;\n\n constructor(opts: { code?: string; stage?: string; message?: string; rawError?: string; retryable?: boolean } = {}) {\n const code = opts.code ?? '';\n const stage = opts.stage ?? '';\n const userMessage = opts.message ?? '';\n const rawError = opts.rawError ?? '';\n const retryable = opts.retryable ?? false;\n\n const body = rawError !== '' ? rawError : userMessage;\n const msg = stage !== '' ? `stream failed: ${stage}: ${body}` : `stream failed: ${body}`;\n super(msg);\n this.name = 'StreamError';\n this.code = code;\n this.stage = stage;\n this.userMessage = userMessage;\n this.rawError = rawError;\n this.retryable = retryable;\n }\n}\n\n// =============================================================================\n// API Response Wrapper\n// =============================================================================\n\n/** nexus-v4 标准响应。兼容 yudao 格式 (msg) 和 nexus-v4 格式 (message) */\nexport interface APIResponse<T> {\n code: number;\n message?: string;\n msg?: string;\n data: T;\n}\n\n/** 优先返回 message, 降级到 msg (兼容 yudao 透传) */\nexport function apiResponseGetMessage<T>(r: APIResponse<T>): string {\n return r.message ?? r.msg ?? '';\n}\n\n/** 检查业务层错误码 — code != 0 时抛 BusinessError */\nexport function apiResponseBusinessError<T>(r: APIResponse<T>): BusinessError | null {\n if (r.code !== 0) {\n return new BusinessError(r.code, apiResponseGetMessage(r));\n }\n return null;\n}\n\n/** yudao 分页响应格式 (tk-dist 代理透传) */\nexport interface YudaoPageResult<T> {\n list: T[];\n total: number;\n}\n\n// =============================================================================\n// Notifications\n// =============================================================================\n\n/** 单条通知 */\nexport interface Notification {\n id: string;\n title: string;\n content: string;\n /** system | billing | security | task | commission | entitlement */\n type: string;\n isRead: boolean;\n createdAt: string;\n}\n\n/** 分页通知列表 */\nexport interface NotificationList {\n list: Notification[];\n unreadCount: number;\n total: number;\n page: number;\n pageSize: number;\n}\n\n/** 未读通知计数 */\nexport interface NotificationUnreadCount {\n unreadCount: number;\n}\n\n/** 通知偏好 (按类型+渠道) */\nexport interface NotificationPreference {\n typeCode: string;\n channelInApp: boolean;\n channelEmail: boolean;\n channelSms: boolean;\n channelPush: boolean;\n}\n\n/** 推送设备注册 */\nexport interface DeviceRegistration {\n /** android | ios | harmony */\n platform: string;\n token: string;\n appVersion: string;\n}\n\n// =============================================================================\n// WebSocket 类型 (forward-declared 这里, 实现在 ws.ts)\n// =============================================================================\n\n/** 服务端推送事件 */\nexport interface WSEvent {\n type: string;\n topic?: string;\n /** json.RawMessage in Go */\n data?: unknown;\n connId?: string;\n timestamp?: string;\n message?: string;\n}\n\n/**\n * 从 WSEvent 中解析通知\n * 返回 null 表示该事件不是系统通知\n */\nexport function parseNotificationEvent(ev: WSEvent): Notification | null {\n if (ev.type !== 'event' || ev.topic !== 'system') {\n return null;\n }\n if (ev.data == null) return null;\n let n: Notification;\n try {\n // ev.data 在 wire 上是 raw JSON, 但 JSON.parse 接收 string;\n // 接收方反序列化时可能已经是对象。两种形态都接住:\n if (typeof ev.data === 'string') {\n n = JSON.parse(ev.data);\n } else {\n n = ev.data as Notification;\n }\n } catch {\n return null;\n }\n if (!n.id) return null;\n return n;\n}\n","// betas.ts — 端口自 acosmi-sdk-go/betas.go\n//\n// Beta Header 常量 — 经联网验证的真实 Anthropic API beta 值。\n// 虚构/错误日期的 header 已剔除。\n\nimport type { ChatRequest, ModelCapabilities } from './types';\nimport { ThinkingOff } from './types';\n\n/** ISP: 交错思考 */\nconst betaInterleavedThinking = 'interleaved-thinking-2025-05-14';\n/** 1M 上下文 (retiring 2026-04-30) */\nconst betaContext1M = 'context-1m-2025-08-07';\n/** 上下文编辑 */\nconst betaContextManagement = 'context-management-2025-06-27';\n/** 结构化输出 */\nconst betaStructuredOutputs = 'structured-outputs-2025-11-13';\n/** Tool Search */\nconst betaAdvancedToolUse = 'advanced-tool-use-2025-11-20';\n/** Effort 控制 (Opus 4.5 需要, 4.6 stable) */\nconst betaEffort = 'effort-2025-11-24';\n/** 缓存作用域隔离 */\nconst betaPromptCachingScope = 'prompt-caching-scope-2026-01-05';\n/** 快速推理 (Opus 4.6) */\nconst betaFastMode = 'fast-mode-2026-02-01';\n/** 思考脱敏 */\nconst betaRedactThinking = 'redact-thinking-2026-02-12';\n/** 高效工具 (Claude 3.7, Claude 4 内置) */\nconst betaTokenEfficientTools = 'token-efficient-tools-2025-02-19';\n\n/** 根据模型能力和请求参数自动组装 beta header 列表 */\nexport function buildBetas(caps: ModelCapabilities, req: ChatRequest): string[] {\n const betas: string[] = [];\n\n // ── 思考相关 ──\n if (caps.supports_isp) {\n betas.push(betaInterleavedThinking);\n betas.push(betaContextManagement);\n }\n if (caps.supports_redact_thinking && req.thinking && req.thinking.display === 'summary') {\n betas.push(betaRedactThinking);\n }\n\n // ── 上下文 ──\n if (caps.supports_1m_context) {\n betas.push(betaContext1M);\n }\n\n // ── 输出控制 (互斥: structured-outputs ⊕ token-efficient-tools) ──\n const hasStructuredOutput = caps.supports_structured_output && req.outputConfig != null;\n if (hasStructuredOutput) {\n betas.push(betaStructuredOutputs);\n } else if (caps.supports_token_efficient) {\n betas.push(betaTokenEfficientTools);\n }\n\n // ── Tool Search ──\n if (caps.supports_tool_search) {\n betas.push(betaAdvancedToolUse);\n }\n\n // ── 推理控制 ──\n // Level 模式下 resolveThinkingLevel 直接写 body[\"effort\"],req.effort 仍为 undefined,\n // 所以需额外判断 Level 是否激活了 effort\n const needsEffort =\n req.effort != null ||\n (req.thinking != null && req.thinking.level && req.thinking.level !== ThinkingOff);\n if (caps.supports_effort && needsEffort) {\n betas.push(betaEffort);\n }\n if (caps.supports_fast_mode && req.speed === 'fast') {\n betas.push(betaFastMode);\n }\n\n // ── 缓存 ──\n if (caps.supports_prompt_cache) {\n betas.push(betaPromptCachingScope);\n }\n\n // ── 合并客户端显式传入 (去重) ──\n return uniqueMerge(betas, req.betas ?? []);\n}\n\n/** 合并两个字符串数组并去重, 保留顺序 */\nexport function uniqueMerge(base: string[], extra: string[]): string[] {\n if (extra.length === 0) return base;\n const seen = new Set<string>(base);\n for (const s of extra) {\n if (!seen.has(s)) {\n base.push(s);\n seen.add(s);\n }\n }\n return base;\n}\n","// adapters/index.ts — 端口自 acosmi-sdk-go/adapter.go (v0.19.0)\n//\n// SDK 层按上游托管模型元数据选路:\n// preferred_format == \"anthropic\" → AnthropicAdapter → POST /managed-models/:id/anthropic\n// preferred_format == \"openai\" → OpenAIAdapter → POST /managed-models/:id/chat\n//\n// 旧上游若未返回 preferred_format / supported_formats, SDK 才回落到 provider 名称:\n// provider == \"anthropic\" / \"acosmi\" → AnthropicAdapter\n// 其他 provider → OpenAIAdapter\n//\n// SDK 只负责: 格式路由 + 请求结构转换 + 响应结构转换\n// 厂商特定协议差异 (endpoint/auth/region/字段裁剪) 由 Nexus Gateway Profile 处理\n//\n// ============================================================================\n// 红线 (双产品消费): AnthropicAdapter + OpenAIAdapter 等地位, 不可合并/降级\n// ============================================================================\n\nimport type { ManagedModel, ChatRequest, ChatResponse, StreamEvent, ModelCapabilities } from '../types';\n\n/** 标识请求格式 */\nexport enum ProviderFormat {\n /** Anthropic 原生格式 */\n Anthropic = 0,\n /** OpenAI 兼容格式 */\n OpenAI = 1,\n}\n\n/** 将 ChatRequest 转换为特定格式的 adapter 接口 */\nexport interface ProviderAdapter {\n /** 此 adapter 使用的请求格式 */\n format(): ProviderFormat;\n\n /**\n * API 路径后缀\n * Anthropic: \"/anthropic\", OpenAI: \"/chat\"\n */\n endpointSuffix(): string;\n\n /**\n * 将 ChatRequest 转换为 HTTP body (object → JSON.stringify)\n * caps 用于条件化字段注入 (如 betas)\n */\n buildRequestBody(caps: ModelCapabilities, req: ChatRequest): Record<string, unknown>;\n\n /** 解析同步响应 body 为 ChatResponse */\n parseResponse(body: Uint8Array | string): ChatResponse;\n\n /**\n * 解析一行 SSE data 为 StreamEvent\n * 返回 { event, done }; done=true 表示流结束 ([DONE] 或 message_stop)\n */\n parseStreamLine(eventType: string, data: string): { event: StreamEvent; done: boolean };\n}\n\n// 实现 import 在文件末尾, 避免循环依赖(adapter impl 也需引用 ProviderFormat)\nimport { AnthropicAdapter } from './anthropic';\nimport { OpenAIAdapter } from './openai';\n\n/** 按 provider 名称映射 adapter */\nconst adapterRegistry: Record<string, ProviderAdapter> = {\n anthropic: new AnthropicAdapter(),\n /** Acosmi 自有模型走 Anthropic 格式 */\n acosmi: new AnthropicAdapter(),\n};\n\n/** 非 Anthropic 厂商的默认 adapter */\nconst defaultOpenAIAdapter: ProviderAdapter = new OpenAIAdapter();\n\n/**\n * 根据 provider 返回对应的 adapter (v0.5.0 遗留 API, 向后兼容)\n * 新代码应使用 getAdapterForModel\n */\nexport function getAdapter(provider: string): ProviderAdapter {\n const a = adapterRegistry[provider.toLowerCase()];\n if (a) return a;\n return defaultOpenAIAdapter;\n}\n\n/**\n * 按 ManagedModel 的 preferred_format / supported_formats 选择 adapter\n *\n * 决策顺序:\n * 1. preferred_format 非空 → 按其值返回 (anthropic | openai)\n * 2. supported_formats 含 \"anthropic\" → AnthropicAdapter\n * 3. supported_formats 含 \"openai\" → OpenAIAdapter\n * 4. 两字段均空 (旧上游) → 回落 provider 名硬编码 (原 getAdapter 行为)\n *\n * 这使得 dashscope / zhipu / deepseek 等 provider 的模型如果上游启用了\n * Anthropic 兼容端点, 也能走 /anthropic 路径, 不再被 provider 字符串硬编码到 /chat\n * 导致 tool_reference 400.\n */\nexport function getAdapterForModel(m: ManagedModel): ProviderAdapter {\n const pref = (m.preferred_format ?? '').trim().toLowerCase();\n switch (pref) {\n case 'anthropic':\n return new AnthropicAdapter();\n case 'openai':\n return new OpenAIAdapter();\n }\n\n let hasAnthropic = false;\n let hasOpenAI = false;\n for (const f of m.supported_formats ?? []) {\n switch (f.trim().toLowerCase()) {\n case 'anthropic':\n hasAnthropic = true;\n break;\n case 'openai':\n hasOpenAI = true;\n break;\n }\n }\n if (hasAnthropic) return new AnthropicAdapter();\n if (hasOpenAI) return new OpenAIAdapter();\n\n // 旧上游未填字段: 回落到 provider 名硬编码 (向后兼容)\n return getAdapter((m.provider ?? '').toLowerCase());\n}\n\nexport { AnthropicAdapter, OpenAIAdapter };\n","// adapters/anthropic.ts — 端口自 acosmi-sdk-go/adapter_anthropic.go (228 行)\n//\n// Anthropic 原生格式 adapter\n// 重构自 buildChatRequest 现有逻辑,功能完全等同。\n// 包含 buildBetas() 调用、serverTools 合入、extraBody 透传。\n\nimport {\n type ChatRequest,\n type ChatResponse,\n type ModelCapabilities,\n type StreamEvent,\n BusinessError,\n ThinkingHighMinMaxTokens,\n ThinkingMax,\n ThinkingMaxFallbackMaxTokens,\n ThinkingOff,\n} from '../types';\nimport { buildBetas } from '../betas';\nimport { ProviderFormat, type ProviderAdapter } from './index';\n\n/** 实现 ProviderAdapter, 用于 Anthropic 原生模型 */\nexport class AnthropicAdapter implements ProviderAdapter {\n format(): ProviderFormat {\n return ProviderFormat.Anthropic;\n }\n\n endpointSuffix(): string {\n return '/anthropic';\n }\n\n /**\n * 构建 Anthropic 格式请求体\n * 逻辑等同于原 buildChatRequest, 包含完整的 betas/tools/serverTools/extraBody 处理\n */\n buildRequestBody(caps: ModelCapabilities, req: ChatRequest): Record<string, unknown> {\n const body: Record<string, unknown> = {};\n\n // 消息: rawMessages 优先于 messages\n if (req.rawMessages != null) {\n body['messages'] = req.rawMessages;\n } else if ((req.messages?.length ?? 0) > 0) {\n body['messages'] = req.messages;\n }\n\n body['stream'] = req.stream === true;\n\n if (req.max_tokens && req.max_tokens > 0) {\n body['max_tokens'] = req.max_tokens;\n }\n if (req.system != null) {\n body['system'] = req.system;\n }\n if (req.temperature != null) {\n body['temperature'] = req.temperature;\n }\n\n // ── Thinking + Effort 组装 ──\n if (req.thinking && req.thinking.level && req.thinking.level !== '') {\n // Level 模式: SDK 接管 thinking + effort + maxTokens\n resolveThinkingLevel(body, req, caps);\n } else {\n // 兼容模式: 调用方自己拼 (保持 v0.8.0 行为)\n if (req.thinking) {\n body['thinking'] = req.thinking;\n }\n if (req.effort) {\n body['effort'] = req.effort;\n }\n }\n\n if (req.metadata) {\n body['metadata'] = req.metadata;\n }\n\n // ── 合入 tools + serverTools ──\n const allTools: unknown[] = [];\n if (req.tools != null) {\n // tools 透传 — 在 Go 侧通过 json.Marshal+Unmarshal 实现深拷贝, TS 中我们直接拼接\n try {\n const parsed = JSON.parse(JSON.stringify(req.tools));\n if (Array.isArray(parsed)) {\n for (const t of parsed) allTools.push(t);\n }\n } catch {\n // ignore — 与 Go 侧 silent ignore 行为一致\n }\n }\n for (const st of req.serverTools ?? []) {\n const schema: Record<string, unknown> = {\n type: st.type,\n name: st.name,\n };\n if (st.config) {\n for (const [k, v] of Object.entries(st.config)) {\n schema[k] = v;\n }\n }\n allTools.push(schema);\n }\n if (allTools.length > 0) {\n body['tools'] = allTools;\n }\n\n // ── 推理控制 (非 Level 模式时的透传) ──\n if (req.speed && req.speed !== '') {\n body['speed'] = req.speed;\n }\n if (req.outputConfig) {\n body['output_config'] = req.outputConfig;\n }\n\n // ── Beta 自动组装 ──\n const betas = buildBetas(caps, req);\n if (betas.length > 0) {\n body['betas'] = betas;\n }\n\n // ── 透传 extraBody ──\n // 注意: extraBody 在 resolveThinkingLevel 之后执行,\n // Level 模式下 thinking / effort / max_tokens / temperature 已由 SDK 管理,\n // extraBody 中不应包含这些 key, 否则会覆盖 SDK 计算结果\n if (req.extraBody) {\n for (const [k, v] of Object.entries(req.extraBody)) {\n body[k] = v;\n }\n }\n\n return body;\n }\n\n /**\n * 解析 Anthropic 格式同步响应\n * 兼容 APIResponse 包装 {\"code\":0,\"data\":{...}} 和裸 Anthropic JSON 两种格式\n */\n parseResponse(bodyInput: Uint8Array | string): ChatResponse {\n const bodyStr = typeof bodyInput === 'string' ? bodyInput : new TextDecoder().decode(bodyInput);\n\n // 尝试 APIResponse 包装\n let raw = bodyStr;\n try {\n const wrapper = JSON.parse(bodyStr) as { code?: number; message?: string; data?: unknown };\n if (wrapper.data != null && wrapper.data !== null) {\n if ((wrapper.code ?? 0) !== 0) {\n throw new BusinessError(wrapper.code ?? 0, wrapper.message ?? '');\n }\n raw = JSON.stringify(wrapper.data);\n }\n } catch (e) {\n if (e instanceof BusinessError) throw e;\n // 非 JSON 或无 wrapper 格式 — 用原始 bodyStr\n }\n\n let resp: ChatResponse;\n try {\n resp = JSON.parse(raw) as ChatResponse;\n } catch (e) {\n throw new Error(\n `decode anthropic response: ${e instanceof Error ? e.message : String(e)}`,\n );\n }\n resp.tokenRemaining = -1;\n resp.callRemaining = -1;\n resp.modelTokenRemaining = -1;\n resp.modelTokenRemainingETU = -1;\n return resp;\n }\n\n /**\n * 解析 Anthropic SSE 行\n *\n * Anthropic 原生协议无 [DONE] (message_stop 后上游关闭连接),\n * 但 Nexus Gateway 的 ChatStream 路径会追加 [DONE] 哨兵, 此处一并处理。\n */\n parseStreamLine(eventType: string, data: string): { event: StreamEvent; done: boolean } {\n if (data === '[DONE]') {\n return { event: { event: '', data: '' }, done: true };\n }\n return { event: { event: eventType, data }, done: false };\n }\n}\n\n/**\n * 根据 ThinkingConfig.level 自动组装请求参数\n *\n * off → thinking=disabled, 不设 effort, 不动 maxTokens\n * high → thinking=adaptive, effort=high, maxTokens 至少 32K\n * max → thinking=adaptive, effort=max, maxTokens 拉到模型上限\n *\n * 旧模型不支持 adaptive 时, 回退到 enabled + budget_tokens = maxTokens - 1\n */\nexport function resolveThinkingLevel(\n body: Record<string, unknown>,\n req: ChatRequest,\n caps: ModelCapabilities,\n): void {\n const level = req.thinking?.level ?? '';\n\n // ── off ──\n if (level === ThinkingOff) {\n body['thinking'] = { type: 'disabled' };\n return;\n }\n\n // ── 模型不支持任何形式的 thinking → 不动 maxTokens, 直接返回 ──\n if (!caps.supports_adaptive_thinking && !caps.supports_thinking) {\n return;\n }\n\n // ── 确定 maxTokens ──\n let maxTokens = req.max_tokens ?? 0;\n if (maxTokens <= 0) {\n maxTokens = ThinkingHighMinMaxTokens;\n }\n\n if (level === ThinkingMax) {\n let modelMax = caps.max_output_tokens;\n if (modelMax <= 0) modelMax = ThinkingMaxFallbackMaxTokens;\n if (maxTokens < modelMax) maxTokens = modelMax;\n } else {\n if (maxTokens < ThinkingHighMinMaxTokens) maxTokens = ThinkingHighMinMaxTokens;\n }\n body['max_tokens'] = maxTokens;\n\n // ── thinking ──\n // adaptive 优先 (Claude 4.x); 旧模型回退 enabled + full budget\n if (caps.supports_adaptive_thinking) {\n const thinking: Record<string, unknown> = { type: 'adaptive' };\n if (req.thinking?.display) thinking['display'] = req.thinking.display;\n body['thinking'] = thinking;\n } else if (caps.supports_thinking) {\n let budget = maxTokens - 1;\n if (budget < 1024) budget = 1024;\n const thinking: Record<string, unknown> = {\n type: 'enabled',\n budget_tokens: budget,\n };\n if (req.thinking?.display) thinking['display'] = req.thinking.display;\n body['thinking'] = thinking;\n }\n\n // ── effort ──\n // 仅支持 effort 的模型发送此参数\n if (caps.supports_effort) {\n let effortLevel = 'high';\n if (level === ThinkingMax && caps.supports_max_effort) {\n effortLevel = 'max';\n }\n body['effort'] = { level: effortLevel };\n }\n\n // ── API 约束: thinking 与 temperature 互斥 ──\n delete body['temperature'];\n}\n"]}
|