@xixka/dsh-hub 0.4.3 → 0.4.5

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.
Files changed (72) hide show
  1. package/README.md +4 -5
  2. package/lib/aggregate-adapter.d.ts.map +1 -1
  3. package/lib/aggregate-adapter.js +7 -0
  4. package/lib/aggregate-adapter.js.map +1 -1
  5. package/lib/aggregate-expiry.d.ts +20 -0
  6. package/lib/aggregate-expiry.d.ts.map +1 -1
  7. package/lib/aggregate-expiry.js +34 -0
  8. package/lib/aggregate-expiry.js.map +1 -1
  9. package/lib/atomcode-adapter.d.ts +112 -0
  10. package/lib/atomcode-adapter.d.ts.map +1 -0
  11. package/lib/atomcode-adapter.js +309 -0
  12. package/lib/atomcode-adapter.js.map +1 -0
  13. package/lib/atomcode-auth.d.ts +86 -0
  14. package/lib/atomcode-auth.d.ts.map +1 -0
  15. package/lib/atomcode-auth.js +235 -0
  16. package/lib/atomcode-auth.js.map +1 -0
  17. package/lib/atomcode-credits.d.ts +83 -0
  18. package/lib/atomcode-credits.d.ts.map +1 -0
  19. package/lib/atomcode-credits.js +290 -0
  20. package/lib/atomcode-credits.js.map +1 -0
  21. package/lib/atomcode-oauth.d.ts +101 -0
  22. package/lib/atomcode-oauth.d.ts.map +1 -0
  23. package/lib/atomcode-oauth.js +283 -0
  24. package/lib/atomcode-oauth.js.map +1 -0
  25. package/lib/atomcode-product.d.ts +130 -0
  26. package/lib/atomcode-product.d.ts.map +1 -0
  27. package/lib/atomcode-product.js +215 -0
  28. package/lib/atomcode-product.js.map +1 -0
  29. package/lib/atomcode.d.ts +108 -0
  30. package/lib/atomcode.d.ts.map +1 -0
  31. package/lib/atomcode.js +205 -0
  32. package/lib/atomcode.js.map +1 -0
  33. package/lib/client/jet-hub.js +47 -57
  34. package/lib/index.d.ts.map +1 -1
  35. package/lib/index.js +183 -0
  36. package/lib/index.js.map +1 -1
  37. package/lib/jet-hub-rpc.d.ts +10 -0
  38. package/lib/jet-hub-rpc.d.ts.map +1 -1
  39. package/lib/jet-hub-rpc.js +74 -0
  40. package/lib/jet-hub-rpc.js.map +1 -1
  41. package/lib/jet-hub-store.d.ts.map +1 -1
  42. package/lib/jet-hub-store.js +4 -0
  43. package/lib/jet-hub-store.js.map +1 -1
  44. package/lib/loomy-adapter.d.ts.map +1 -1
  45. package/lib/loomy-adapter.js +53 -3
  46. package/lib/loomy-adapter.js.map +1 -1
  47. package/lib/magicrew-adapter.d.ts.map +1 -1
  48. package/lib/magicrew-adapter.js +37 -2
  49. package/lib/magicrew-adapter.js.map +1 -1
  50. package/lib/magicrew-catalog.d.ts.map +1 -1
  51. package/lib/magicrew-catalog.js +12 -1
  52. package/lib/magicrew-catalog.js.map +1 -1
  53. package/lib/marvis-auth.d.ts.map +1 -1
  54. package/lib/marvis-auth.js +28 -3
  55. package/lib/marvis-auth.js.map +1 -1
  56. package/lib/openai-compat.d.ts.map +1 -1
  57. package/lib/openai-compat.js +18 -1
  58. package/lib/openai-compat.js.map +1 -1
  59. package/lib/provider-credits.d.ts.map +1 -1
  60. package/lib/provider-credits.js +33 -0
  61. package/lib/provider-credits.js.map +1 -1
  62. package/lib/provider-expiry.d.ts.map +1 -1
  63. package/lib/provider-expiry.js +13 -0
  64. package/lib/provider-expiry.js.map +1 -1
  65. package/lib/provider-registry.d.ts.map +1 -1
  66. package/lib/provider-registry.js +41 -0
  67. package/lib/provider-registry.js.map +1 -1
  68. package/lib/raccoon-adapter.d.ts +36 -71
  69. package/lib/raccoon-adapter.d.ts.map +1 -1
  70. package/lib/raccoon-adapter.js +21 -265
  71. package/lib/raccoon-adapter.js.map +1 -1
  72. package/package.json +9 -9
@@ -0,0 +1,215 @@
1
+ /**
2
+ * AtomGit CodingPlan(`atomcode`)产品常量、静态目录与错误分类。
3
+ *
4
+ * ## 取证链与日期(全部结论带来源;与官方文档冲突以客户端源码为准)
5
+ *
6
+ * | 事实 | 来源 | 日期 |
7
+ * |---|---|---|
8
+ * | OAuth broker = `https://acs.atomgit.com`(`/auth/login?provider=atomgit` → `{login_url, state}`;`/auth/check?state=` → `{valid}`;`/auth/token?state=` → `{access_token, refresh_token, token_type, expires_in, user:{id,username,…}}`;`POST /oauth/refresh {refresh_token}` → 同 token 形状) | 客户端 `crates/atomcode-auth/src/oauth.rs`(`platform_login_url` 等 5 个 URL 函数 + `PlatformTokenResponse` + `refresh_access_token_unlocked`) | 2026-11-12 |
9
+ * | CodingPlan REST = `https://api.gitcode.com/api/v5`(`POST /coding-plan/claim-v2 {plan_type}` → `{success, duplicate, message, plan_name}`;`GET /coding-plan/status-v2` → `{codingplan_free, current_usage, window_quota_exhausted, rate_limit_windows[]}`;`GET /coding-plan/models-v2?plan_type=` → `ModelEntry[]`) | 客户端 `crates/atomcode-codingplan/src/client.rs` + `types.rs` | 2026-11-12 |
10
+ * | LLM 网关 = `https://llm-api.atomgit.com/v1`(OpenAI 兼容 `/chat/completions`),签名网关判定还认 `pre-llm-api-cce.atomgit.com` / `api-ai.gitcode.com` | 客户端 `crates/atomcode-config/src/endpoints.rs`(`HOSTED_CODINGPLAN_LLM_BASE_URL`)+ `atomcode-auth/src/gateway_crypto.rs`(`is_atomgit_gateway`) | 2026-11-12 |
11
+ * | 网关请求需 `atomcode-signing-v1` 签名(`X-AtomCode-Sig/Ts/Nonce/Alg/Ver` 五头)。算法:HKDF-SHA256(salt = `user_id‖0x01‖LE64(unix/3600)‖sha256(token)‖sha256(version)`,info = `"atomcode-signing-v1"`,输出 32B)派生签名密钥;HMAC-SHA256 over `v1\n{METHOD}\n{path}\n{ts}\n{nonce_hex}\n{sha256(body)hex}`;主密钥 32B hex `e97250f0…7123` | Atom2Api(MIT)`proxy.go::signAtomGitRequest`(注释注明算法独立文档化自 MIT 的 atomgit-opencode-bridge) | 2026-11-12 |
12
+ * | **官方公开客户端没有签名实现**:签名 crate 是私有 overlay,公开仓只有 `UnavailableSigner`(`ALGORITHM_VERSION == 0`),`open_stream` 对 `sign()` 失败**硬失败不降级** ⇒ 无签名请求过不了网关 | 客户端 `crates/atomcode-auth/src/gateway_crypto.rs` + `crates/atomcode-capabilities/src/provider/openai_compat.rs`(`open_stream_attempts`) | 2026-11-12 |
13
+ * | 档位三档(Lite 30 天免费限量 / Pro 体验 7 天每日 10:00 限量 / Pro 30 天活动仓库合 PR,Pro+ 多 GLM-5.2),额度按 **5h 滚动窗口**计量;`rate_limit_windows[]` 实测含 `window_size_seconds: 18000`(5h)与 30d(720h,`show_enable: 0` 不展示) | 官方文档 atomcode.atomgit.com/docs/zh/login.html「CodingPlan 权益体系」 + 客户端 `types.rs` 的 `status_parses_rate_limit_windows_field` 测试 | 2026-11-12 |
14
+ * | 模型清单(Lite:`deepseek-v4-flash`、`Qwen/Qwen3-VL-8B-Instruct` 图文;Pro+ 加 `GLM-5.2`;目录 `display_model_name` 是形如 `org/model` 的真实名,`type: openai`,`context_window` 客户端会下限 128k、上限保留) | 官方文档登录页模型列 + 客户端 `setup.rs`(`MIN_CONTEXT_WINDOW = 128_000`,`build_codingplan_provider` 测试:64k 抬到 128k、200k 原样保留) | 2026-11-12 |
15
+ * | 兑换前必须先刷新 token(claim 内部先 `oauth.Refresh`);claim 级联 Max→Pro→Lite、`duplicate` 视为成功停止级联 | 客户端 `setup.rs::step_claim`(`PlanType::CASCADE_ORDER`)+ Atom2Api `oauth.go::Refresh`(`expires_in` 剩余 < 5 分钟才刷) | 2026-11-12 |
16
+ *
17
+ * ## 为什么模型目录有远端端点但仍带静态兜底
18
+ *
19
+ * `/coding-plan/models-v2` 是真实远端目录(按 plan_type 下发、`plan_available`
20
+ * 标记档位覆盖);但**未登录 / 凭据失效时不可用**(401)⇒ 与 qoder / accio 同形,
21
+ * 兜底表只服务「远端不可读」场景。⚠️ 兜底表条目的 `contextWindow` 取自
22
+ * 客户端 `MIN_CONTEXT_WINDOW` 下限与官方页(未实测逐模型上界,128k 是**保守下限**
23
+ * 不是实测值);`maxTokens` 上游 `models-v2` 不下发 ⇒ 与 marvis 同向刻意不声明。
24
+ *
25
+ * @module atomcode-product
26
+ */
27
+ /** AtomGit OAuth broker 基址(登录 / check / token / refresh 同 host)。 */
28
+ export const ATOMCODE_PLATFORM_BASE = 'https://acs.atomgit.com';
29
+ /** CodingPlan REST API 基址。 */
30
+ export const ATOMCODE_CODINGPLAN_BASE = 'https://api.gitcode.com/api/v5';
31
+ /** LLM 网关基址(OpenAI 兼容,含 /v1)。 */
32
+ export const ATOMCODE_LLM_BASE = 'https://llm-api.atomgit.com/v1';
33
+ /** provider id(与 `provider-registry.ts` 里 atomcode 条目的 id 逐字一致)。 */
34
+ export const ATOMCODE_PROVIDER_ID = 'atomcode';
35
+ /** 官方客户端 UA(`atomcode/` + 版本,客户端 `ATOMCODE_USER_AGENT` 常量同形)。 */
36
+ export const ATOMCODE_USER_AGENT = 'atomcode/5.2.7';
37
+ /** 单次 HTTP 请求超时(毫秒)。 */
38
+ export const ATOMCODE_HTTP_TIMEOUT_MS = 30_000;
39
+ /** 登录轮询间隔(毫秒;客户端 `spawn_poller(Duration::from_secs(2))` 同值)。 */
40
+ export const ATOMCODE_POLL_INTERVAL_MS = 2_000;
41
+ /** 登录会话有效期(毫秒;客户端 pending OAuth 10 分钟)。 */
42
+ export const ATOMCODE_LOGIN_EXPIRES_MS = 10 * 60_000;
43
+ /**
44
+ * 静态兜底目录(3 条)。
45
+ *
46
+ * ⚠️ 客户端把 `context_window` 抬到 ≥128k(`MIN_CONTEXT_WINDOW`)⇒ 这里同样
47
+ * 只声明 128k 下限值;`maxTokens` 上游不下发 ⇒ 刻意不声明(marvis 同向:
48
+ * 出站预算由宿主 `GenerateOptions.maxTokens` 决定,目录不硬编)。
49
+ */
50
+ export const ATOMCODE_FALLBACK_MODELS = [
51
+ {
52
+ id: 'deepseek-v4-flash',
53
+ name: 'DeepSeek V4 Flash',
54
+ contextWindow: 128_000,
55
+ supportsImage: false,
56
+ proOnly: false,
57
+ },
58
+ {
59
+ id: 'Qwen/Qwen3-VL-8B-Instruct',
60
+ name: 'Qwen3-VL-8B',
61
+ contextWindow: 128_000,
62
+ supportsImage: true,
63
+ proOnly: false,
64
+ },
65
+ {
66
+ id: 'GLM-5.2',
67
+ name: 'GLM-5.2',
68
+ contextWindow: 128_000,
69
+ supportsImage: false,
70
+ proOnly: true,
71
+ },
72
+ ];
73
+ export function findAtomcodeFallback(modelId) {
74
+ return ATOMCODE_FALLBACK_MODELS.find((m) => m.id === modelId);
75
+ }
76
+ export const ATOMCODE = {
77
+ id: 'atomcode',
78
+ displayName: 'AtomCode (AtomGit)',
79
+ baseUrl: ATOMCODE_LLM_BASE,
80
+ chatPath: '/chat/completions',
81
+ chatHeaderTimeoutMs: 60_000,
82
+ chunkTimeoutMs: 120_000,
83
+ catalogTimeoutMs: 15_000,
84
+ balanceTimeoutMs: 15_000,
85
+ defaultCredentialRef: 'ATOMCODE_ACCOUNT_DEFAULT',
86
+ };
87
+ /** 从错误体里抽出人可读片段(禁把整坨 JSON 抛给用户)。 */
88
+ function readableDetail(body) {
89
+ const text = body.trim();
90
+ if (text === '')
91
+ return '(上游未返回错误详情)';
92
+ try {
93
+ const data = JSON.parse(text);
94
+ const nested = typeof data.error === 'object' && data.error !== null
95
+ ? data.error.message
96
+ : data.error;
97
+ const parts = [data.message, data.msg, nested].filter((v) => typeof v === 'string' && v.length > 0);
98
+ if (parts.length > 0)
99
+ return parts.join(' ');
100
+ }
101
+ catch {
102
+ // 非 JSON:直接截断原文
103
+ }
104
+ return text.length > 500 ? `${text.slice(0, 500)}…` : text;
105
+ }
106
+ /**
107
+ * 把一次失败的 HTTP 响应归类为语义化错误。
108
+ *
109
+ * ## ⚠️ 顺序即优先级(判据来源见注释)
110
+ *
111
+ * 1. **上下文超限**(报文关键词)——必须最先,否则会被 quota 抢走
112
+ * (marvis / trae 同型事故:用户只是消息太长,账号却被封一整天)。
113
+ * 2. **HTTP 401/403 ⇒ auth**(CodingPlan REST 客户端对这两态抛 `AuthExpired`;
114
+ * 官方报文形态 `authentication failed (NNN) — run atomcode login again`)。
115
+ * 3. 429 / 限流文案 ⇒ rate_limit(`retry-after` 原样保留)。
116
+ * ⚠️ **额度窗口文案不抢判**:5h 窗口烧光的报文(`window_quota_exhausted` /
117
+ * usage_percent 类)也走「额度用尽」语义,但落在 quota 档(见 ④)。
118
+ * 4. 402 / 额度文案(含 `quota_exhausted` / `全平台日限额已满` —— 后者是
119
+ * claim-v2 429 报文的实测 message,取自客户端 `format_api_error` 测试)⇒ quota。
120
+ * 5. HTTP 404 ⇒ model_unavailable(v2 端点对未知模型 / 未知路径都回 404;
121
+ * 客户端 `format_api_error` 的 Spring 形态测试可证)。
122
+ * 6. 400 / 422 ⇒ invalid_request。
123
+ * 7. status 0 / 传输层文案 ⇒ transport。
124
+ * 8. 其余(≥500)⇒ server。
125
+ */
126
+ export function classifyAtomcodeError(status, body, headers) {
127
+ const retryAfterMs = retryAfterMsFrom(headers);
128
+ const detail = readableDetail(body);
129
+ const lower = body.toLowerCase();
130
+ // ① 上下文超限(先于一切)
131
+ if (lower.includes('context length')
132
+ || lower.includes('context window')
133
+ || (lower.includes('context') && lower.includes('limit'))
134
+ || lower.includes('context_length_exceeded')
135
+ || lower.includes('reduce the length')
136
+ || lower.includes('too many tokens')
137
+ || lower.includes('input tokens exceed')) {
138
+ return { kind: 'context_window', detail };
139
+ }
140
+ // ② 认证
141
+ if (status === 401 || status === 403)
142
+ return { kind: 'auth', detail };
143
+ // ③ 限流
144
+ if (status === 429
145
+ || lower.includes('too many requests')
146
+ || lower.includes('rate limit')
147
+ || lower.includes('throttl')) {
148
+ return { kind: 'rate_limit', ...(retryAfterMs === undefined ? {} : { retryAfterMs }), detail };
149
+ }
150
+ // ④ 额度(含窗口烧光 / 日限额文案)
151
+ if (status === 402
152
+ || lower.includes('insufficient')
153
+ || lower.includes('quota')
154
+ || lower.includes('exhausted')
155
+ || lower.includes('余额')
156
+ || lower.includes('限额')) {
157
+ return { kind: 'quota', ...(retryAfterMs === undefined ? {} : { retryAfterMs }), detail };
158
+ }
159
+ // ⑤ 模型侧不可用
160
+ if (status === 404)
161
+ return { kind: 'model_unavailable', detail };
162
+ // ⑥ 请求非法
163
+ if (status === 400 || status === 422)
164
+ return { kind: 'invalid_request', detail };
165
+ // ⑦ 传输层
166
+ if (status === 0
167
+ || lower.includes('fetch failed')
168
+ || lower.includes('terminated')
169
+ || lower.includes('econnreset')
170
+ || lower.includes('socket hang up')
171
+ || lower.includes('getaddrinfo')
172
+ || lower.includes('econnrefused')) {
173
+ return { kind: 'transport', detail };
174
+ }
175
+ // ⑧ 服务端
176
+ return { kind: 'server', detail };
177
+ }
178
+ /** 从响应头读 `retry-after`(秒 → 毫秒;非法 / 缺失 ⇒ undefined)。 */
179
+ function retryAfterMsFrom(headers) {
180
+ const raw = headers?.['retry-after'];
181
+ if (typeof raw !== 'string' || raw.trim() === '')
182
+ return undefined;
183
+ const seconds = Number(raw.trim());
184
+ if (!Number.isFinite(seconds) || seconds < 0)
185
+ return undefined;
186
+ return Math.round(seconds * 1_000);
187
+ }
188
+ /**
189
+ * 语义分类 → 宿主 `LlmError.code`。
190
+ *
191
+ * ⚠️ 额度/限流/认证必须用**字面量**:harness 的 `QUOTA_EXCEEDED_CODE`
192
+ * 字面值是 `'QUOTA'`,客户端会据此把 message 换成固定文案
193
+ * ⇒ 用错字面量会让「额度用尽」被渲染成别的错误(Issue IKJVCW)。
194
+ */
195
+ export function atomcodeErrorKindCode(kind) {
196
+ switch (kind) {
197
+ case 'auth':
198
+ return 'AUTH';
199
+ case 'rate_limit':
200
+ return 'RATE_LIMIT';
201
+ case 'quota':
202
+ return 'QUOTA_EXCEEDED';
203
+ case 'context_window':
204
+ return 'CONTEXT_WINDOW_EXCEEDED';
205
+ case 'invalid_request':
206
+ case 'model_unavailable':
207
+ // 确定性失败:重试 5 次只会拿到同一个 400/404。
208
+ return 'BAD_REQUEST';
209
+ case 'transport':
210
+ return 'TRANSPORT';
211
+ case 'server':
212
+ return 'SERVER';
213
+ }
214
+ }
215
+ //# sourceMappingURL=atomcode-product.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"atomcode-product.js","sourceRoot":"","sources":["../src/atomcode-product.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,108 @@
1
+ /**
2
+ * AtomGit CodingPlan 的凭据形态、网关签名与请求头原语。
3
+ *
4
+ * ## 取证来源(2026-11-12;借事实不搬表达式,常数按本仓口径重定值)
5
+ *
6
+ * - **签名算法** `atomcode-signing-v1`:Atom2Api(MIT)`proxy.go::signAtomGitRequest`
7
+ * 的**事实描述**(HKDF-SHA256 extract+expand、salt 组成、canonical 串形状、
8
+ * 五个响应头名),实现按本仓 TypeScript 口径重写;主密钥 32B hex
9
+ * `e97250f05303162c8ecd68c688b2f55c1d81e508d243d88466472e7f54637123`
10
+ * (同文件注明算法独立文档化自 MIT 的 atomgit-opencode-bridge)。
11
+ * - **签名是硬要求**:官方 Rust 客户端 `gateway_crypto.rs` 的公开源里签名 crate
12
+ * 是私有 overlay(`ALGORITHM_VERSION == 0` ⇒ `UnavailableSigner`),而
13
+ * `openai_compat.rs::open_stream_attempts` 对 `sign()` 失败**硬失败不降级**
14
+ * ⇒ 无签名请求不可能过 `llm-api.atomgit.com` 网关。
15
+ * - **UA**:官方 `atomcode/` + `CARGO_PKG_VERSION`(`atomcode-auth/src/lib.rs:25`);
16
+ * 客户端登录 / CodingPlan REST / 网关请求都带它。⚠️ 版本只进签名载荷的
17
+ * `sha256(version)`,与 `X-AtomCode-Ver` 必须是**同一串**(A/B 实测口径
18
+ * 来自 Atom2Api `applySignature`:`version` 取 UA 去掉 `atomcode/` 前缀)。
19
+ * - **OAuth**:`{access_token, refresh_token, token_type, expires_in, user:{id,…}}`
20
+ * (客户端 `PlatformTokenResponse`)。`expires_in` 是**秒**(登录腿);
21
+ * refresh 腿 `expires_in` 可能缺省(客户端 `or(auth.expires_in)` 沿用旧值)。
22
+ *
23
+ * @module atomcode
24
+ */
25
+ /** 已落盘的 AtomCode(AtomGit CodingPlan)凭据。 */
26
+ export interface AtomcodeCredential {
27
+ access_token: string;
28
+ refresh_token: string;
29
+ /** AtomGit 用户 id(签名 salt 的组成部分;`/auth/token` 的 `user.id`)。 */
30
+ user_id: string;
31
+ /** 展示昵称(`user.username`,尽力而为)。 */
32
+ nickname?: string;
33
+ /**
34
+ * access_token 的绝对过期时刻(**毫秒**时间戳)。
35
+ *
36
+ * ⚠️ 登录腿上游给的是 `expires_in` **秒**,归一化只在 `atomcode-auth.ts`
37
+ * 的兑换/续期返回处做**一次**(accio 秒/毫秒混淆事故的同款防线)。
38
+ */
39
+ expires_at?: number;
40
+ }
41
+ /** 解析已落盘凭据;缺 `access_token` / `user_id` 视为无效(签名需要两者)。 */
42
+ export declare function parseAtomcodeCredential(raw: string | undefined | null): AtomcodeCredential | undefined;
43
+ /** 凭据绝对过期时刻(毫秒);缺省 ⇒ undefined(「未知」,不是「已过期」)。 */
44
+ export declare function atomcodeCredentialExpiresAtMs(credential: AtomcodeCredential | undefined): number | undefined;
45
+ /** 是否已过期(缺过期时刻恒 false —— 不知道 ≠ 死号)。 */
46
+ export declare function isAtomcodeExpired(credential: AtomcodeCredential | undefined): boolean;
47
+ /** 网关签名产物(五个 `X-AtomCode-*` 头)。 */
48
+ export interface AtomcodeSignatureHeaders {
49
+ 'X-AtomCode-Sig': string;
50
+ 'X-AtomCode-Ts': string;
51
+ 'X-AtomCode-Nonce': string;
52
+ 'X-AtomCode-Alg': string;
53
+ 'X-AtomCode-Ver': string;
54
+ }
55
+ /**
56
+ * 计算 LLM 网关请求的 `atomcode-signing-v1` 签名头。
57
+ *
58
+ * ## 步骤(与 Atom2Api 事实描述逐条对应,代码为本仓实现)
59
+ *
60
+ * 1. **派生签名密钥**(HKDF-SHA256,输出 32 字节):
61
+ * - salt = `user_id ‖ 0x01 ‖ LE64(unix_timestamp / 3600) ‖ sha256(oauth_token) ‖ sha256(client_version)`;
62
+ * - ikm = 主密钥(32 字节);
63
+ * - info = `"atomcode-signing-v1"`(+ 单字节 0x01 的 expand 计数在 Node 原语内)。
64
+ * 2. **canonical 串**:`v1\n{METHOD}\n{path}\n{unix_ts}\n{nonce_hex}\n{sha256(body)hex}`,
65
+ * 以 `\n` 连接;HMAC-SHA256(密钥 = 第 1 步产物)即签名。
66
+ * 3. **五个响应头**:`X-AtomCode-Sig: v1:<hex>` / `X-AtomCode-Ts` /
67
+ * `X-AtomCode-Nonce` / `X-AtomCode-Alg: 1` / `X-AtomCode-Ver`。
68
+ *
69
+ * ## ⚠️ 输入纪律
70
+ *
71
+ * - `path` 必须是**不含 host、不含 query** 的路径(canonical 只认它;
72
+ * 客户端 `canonical_chat_completions_path` 的产物即 `/v1/chat/completions`)。
73
+ * - `body` 必须是**实际发送的原始字节**(body hash 覆盖整个请求体)。
74
+ * - `clientVersion` 与 `X-AtomCode-Ver` 必须同串(进 salt 的 hash)。
75
+ * - 时间戳单位是**秒**(salt 的小时桶与 canonical 都用它)。
76
+ *
77
+ * @param params.method HTTP 方法(canonical 内转大写)。
78
+ * @param params.path 请求路径(如 `/v1/chat/completions`)。
79
+ * @param params.body 请求体原始字节。
80
+ * @param params.oauthToken 登录 access_token。
81
+ * @param params.userId AtomGit 用户 id(凭据 `user_id`)。
82
+ * @param params.nowMs 当前毫秒时间戳(可注入;生产默认 `Date.now()`)。
83
+ */
84
+ export declare function atomcodeGatewaySignature(params: {
85
+ method: string;
86
+ path: string;
87
+ body: Uint8Array | string;
88
+ oauthToken: string;
89
+ userId: string;
90
+ clientVersion?: string;
91
+ nowMs?: number;
92
+ }): AtomcodeSignatureHeaders;
93
+ /** LLM 网关是否需要签名(客户端 `is_atomgit_gateway` 的 host 白名单同源)。 */
94
+ export declare function isAtomcodeSigningGateway(baseUrl: string): boolean;
95
+ /** 推理请求头(Bearer + 官方 UA + 签名五头)。 */
96
+ export declare function atomcodeChatHeaders(params: {
97
+ credential: AtomcodeCredential;
98
+ path: string;
99
+ body: string;
100
+ accept?: string;
101
+ nowMs?: number;
102
+ }): Record<string, string>;
103
+ /** CodingPlan REST / OAuth broker 的通用请求头(Bearer 可选、无签名)。 */
104
+ export declare function atomcodeRestHeaders(params: {
105
+ accessToken?: string;
106
+ json?: boolean;
107
+ }): Record<string, string>;
108
+ //# sourceMappingURL=atomcode.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"atomcode.d.ts","sourceRoot":"","sources":["../src/atomcode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAA;IACf,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,yDAAyD;AACzD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,kBAAkB,GAAG,SAAS,CA2BtG;AAED,iDAAiD;AACjD,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,kBAAkB,GAAG,SAAS,GACzC,MAAM,GAAG,SAAS,CAGpB;AAED,uCAAuC;AACvC,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,kBAAkB,GAAG,SAAS,GAAG,OAAO,CAGrF;AAED,mCAAmC;AACnC,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;IACvB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,gBAAgB,EAAE,MAAM,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAmBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,UAAU,GAAG,MAAM,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GAAG,wBAAwB,CAqD3B;AAED,2DAA2D;AAC3D,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAUjE;AAED,oCAAoC;AACpC,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,UAAU,EAAE,kBAAkB,CAAA;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBzB;AAED,4DAA4D;AAC5D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASzB"}
@@ -0,0 +1,205 @@
1
+ /**
2
+ * AtomGit CodingPlan 的凭据形态、网关签名与请求头原语。
3
+ *
4
+ * ## 取证来源(2026-11-12;借事实不搬表达式,常数按本仓口径重定值)
5
+ *
6
+ * - **签名算法** `atomcode-signing-v1`:Atom2Api(MIT)`proxy.go::signAtomGitRequest`
7
+ * 的**事实描述**(HKDF-SHA256 extract+expand、salt 组成、canonical 串形状、
8
+ * 五个响应头名),实现按本仓 TypeScript 口径重写;主密钥 32B hex
9
+ * `e97250f05303162c8ecd68c688b2f55c1d81e508d243d88466472e7f54637123`
10
+ * (同文件注明算法独立文档化自 MIT 的 atomgit-opencode-bridge)。
11
+ * - **签名是硬要求**:官方 Rust 客户端 `gateway_crypto.rs` 的公开源里签名 crate
12
+ * 是私有 overlay(`ALGORITHM_VERSION == 0` ⇒ `UnavailableSigner`),而
13
+ * `openai_compat.rs::open_stream_attempts` 对 `sign()` 失败**硬失败不降级**
14
+ * ⇒ 无签名请求不可能过 `llm-api.atomgit.com` 网关。
15
+ * - **UA**:官方 `atomcode/` + `CARGO_PKG_VERSION`(`atomcode-auth/src/lib.rs:25`);
16
+ * 客户端登录 / CodingPlan REST / 网关请求都带它。⚠️ 版本只进签名载荷的
17
+ * `sha256(version)`,与 `X-AtomCode-Ver` 必须是**同一串**(A/B 实测口径
18
+ * 来自 Atom2Api `applySignature`:`version` 取 UA 去掉 `atomcode/` 前缀)。
19
+ * - **OAuth**:`{access_token, refresh_token, token_type, expires_in, user:{id,…}}`
20
+ * (客户端 `PlatformTokenResponse`)。`expires_in` 是**秒**(登录腿);
21
+ * refresh 腿 `expires_in` 可能缺省(客户端 `or(auth.expires_in)` 沿用旧值)。
22
+ *
23
+ * @module atomcode
24
+ */
25
+ import { createHash, createHmac, hkdfSync, randomBytes } from 'node:crypto';
26
+ import { ATOMCODE_USER_AGENT } from './atomcode-product.js';
27
+ /** 解析已落盘凭据;缺 `access_token` / `user_id` 视为无效(签名需要两者)。 */
28
+ export function parseAtomcodeCredential(raw) {
29
+ if (typeof raw !== 'string' || raw.trim() === '')
30
+ return undefined;
31
+ let parsed;
32
+ try {
33
+ parsed = JSON.parse(raw);
34
+ }
35
+ catch {
36
+ return undefined;
37
+ }
38
+ if (parsed === null || typeof parsed !== 'object')
39
+ return undefined;
40
+ const record = parsed;
41
+ const accessToken = record['access_token'];
42
+ const userId = record['user_id'];
43
+ if (typeof accessToken !== 'string' || accessToken.length === 0)
44
+ return undefined;
45
+ if (typeof userId !== 'string' || userId.length === 0)
46
+ return undefined;
47
+ const refreshToken = record['refresh_token'];
48
+ if (typeof refreshToken !== 'string' || refreshToken.length === 0)
49
+ return undefined;
50
+ const expiresAt = record['expires_at'];
51
+ const nickname = record['nickname'];
52
+ return {
53
+ access_token: accessToken,
54
+ refresh_token: refreshToken,
55
+ user_id: userId,
56
+ ...(typeof nickname === 'string' && nickname.length > 0 ? { nickname } : {}),
57
+ ...(typeof expiresAt === 'number' && Number.isFinite(expiresAt) && expiresAt > 0
58
+ ? { expires_at: expiresAt }
59
+ : {}),
60
+ };
61
+ }
62
+ /** 凭据绝对过期时刻(毫秒);缺省 ⇒ undefined(「未知」,不是「已过期」)。 */
63
+ export function atomcodeCredentialExpiresAtMs(credential) {
64
+ const value = credential?.expires_at;
65
+ return typeof value === 'number' && Number.isFinite(value) && value > 0 ? value : undefined;
66
+ }
67
+ /** 是否已过期(缺过期时刻恒 false —— 不知道 ≠ 死号)。 */
68
+ export function isAtomcodeExpired(credential) {
69
+ const expiresAt = atomcodeCredentialExpiresAtMs(credential);
70
+ return expiresAt !== undefined && expiresAt <= Date.now();
71
+ }
72
+ /**
73
+ * `atomcode-signing-v1` 主密钥(32 字节 hex)。
74
+ *
75
+ * ⚠️ 来源:Atom2Api(MIT)`proxy.go` 的默认值——那是**公开复刻社区**里
76
+ * 与官方客户端行为对齐的实现;本仓只借事实,常数随算法一起登记。
77
+ */
78
+ const ATOMCODE_SIGNING_MASTER_KEY_HEX = 'e97250f05303162c8ecd68c688b2f55c1d81e508d243d88466472e7f54637123';
79
+ /** HKDF 的 info 串(算法代际标识;换代时客户端会换 `ALGORITHM_VERSION`)。 */
80
+ const ATOMCODE_SIGNING_INFO = 'atomcode-signing-v1';
81
+ /** 随机 16 字节 nonce 的 hex 形态(签名载荷与 `X-AtomCode-Nonce` 共用)。 */
82
+ function newAtomcodeNonceHex() {
83
+ return randomBytes(16).toString('hex');
84
+ }
85
+ /**
86
+ * 计算 LLM 网关请求的 `atomcode-signing-v1` 签名头。
87
+ *
88
+ * ## 步骤(与 Atom2Api 事实描述逐条对应,代码为本仓实现)
89
+ *
90
+ * 1. **派生签名密钥**(HKDF-SHA256,输出 32 字节):
91
+ * - salt = `user_id ‖ 0x01 ‖ LE64(unix_timestamp / 3600) ‖ sha256(oauth_token) ‖ sha256(client_version)`;
92
+ * - ikm = 主密钥(32 字节);
93
+ * - info = `"atomcode-signing-v1"`(+ 单字节 0x01 的 expand 计数在 Node 原语内)。
94
+ * 2. **canonical 串**:`v1\n{METHOD}\n{path}\n{unix_ts}\n{nonce_hex}\n{sha256(body)hex}`,
95
+ * 以 `\n` 连接;HMAC-SHA256(密钥 = 第 1 步产物)即签名。
96
+ * 3. **五个响应头**:`X-AtomCode-Sig: v1:<hex>` / `X-AtomCode-Ts` /
97
+ * `X-AtomCode-Nonce` / `X-AtomCode-Alg: 1` / `X-AtomCode-Ver`。
98
+ *
99
+ * ## ⚠️ 输入纪律
100
+ *
101
+ * - `path` 必须是**不含 host、不含 query** 的路径(canonical 只认它;
102
+ * 客户端 `canonical_chat_completions_path` 的产物即 `/v1/chat/completions`)。
103
+ * - `body` 必须是**实际发送的原始字节**(body hash 覆盖整个请求体)。
104
+ * - `clientVersion` 与 `X-AtomCode-Ver` 必须同串(进 salt 的 hash)。
105
+ * - 时间戳单位是**秒**(salt 的小时桶与 canonical 都用它)。
106
+ *
107
+ * @param params.method HTTP 方法(canonical 内转大写)。
108
+ * @param params.path 请求路径(如 `/v1/chat/completions`)。
109
+ * @param params.body 请求体原始字节。
110
+ * @param params.oauthToken 登录 access_token。
111
+ * @param params.userId AtomGit 用户 id(凭据 `user_id`)。
112
+ * @param params.nowMs 当前毫秒时间戳(可注入;生产默认 `Date.now()`)。
113
+ */
114
+ export function atomcodeGatewaySignature(params) {
115
+ const { method, path, oauthToken, userId } = params;
116
+ if (oauthToken.length === 0 || userId.length === 0) {
117
+ throw new Error('atomcode: 网关签名需要 OAuth token 与 user id(凭据不完整)');
118
+ }
119
+ const clientVersion = (params.clientVersion ?? ATOMCODE_USER_AGENT.slice('atomcode/'.length)).trim();
120
+ if (clientVersion === '') {
121
+ throw new Error('atomcode: 网关签名需要客户端版本号(形如 5.2.7)');
122
+ }
123
+ const nowMs = params.nowMs ?? Date.now();
124
+ const timestamp = Math.floor(nowMs / 1_000);
125
+ const nonceHex = newAtomcodeNonceHex();
126
+ // salt = user_id ‖ 0x01 ‖ LE64(ts/3600) ‖ sha256(token) ‖ sha256(version)
127
+ const salt = Buffer.concat([
128
+ Buffer.from(userId, 'utf8'),
129
+ Buffer.from([0x01]),
130
+ (() => {
131
+ const bucket = Buffer.alloc(8);
132
+ bucket.writeBigUInt64LE(BigInt(Math.floor(timestamp / 3_600)));
133
+ return bucket;
134
+ })(),
135
+ createHash('sha256').update(oauthToken, 'utf8').digest(),
136
+ createHash('sha256').update(clientVersion, 'utf8').digest(),
137
+ ]);
138
+ const masterKey = Buffer.from(ATOMCODE_SIGNING_MASTER_KEY_HEX, 'hex');
139
+ if (masterKey.length !== 32) {
140
+ throw new Error('atomcode: 签名主密钥必须是 32 字节 hex');
141
+ }
142
+ // HKDF-SHA256 extract + expand:Node 原生 `hkdfSync` 一次完成(输出 32B)。
143
+ const signingKey = Buffer.from(hkdfSync('sha256', masterKey, salt, Buffer.from(ATOMCODE_SIGNING_INFO, 'utf8'), 32));
144
+ const bodyBytes = typeof params.body === 'string' ? Buffer.from(params.body, 'utf8') : Buffer.from(params.body);
145
+ const bodyHashHex = createHash('sha256').update(bodyBytes).digest('hex');
146
+ const canonical = [
147
+ 'v1',
148
+ method.toUpperCase(),
149
+ path,
150
+ String(timestamp),
151
+ nonceHex,
152
+ bodyHashHex,
153
+ ].join('\n');
154
+ const signature = createHmac('sha256', signingKey).update(canonical, 'utf8').digest('hex');
155
+ return {
156
+ 'X-AtomCode-Sig': `v1:${signature}`,
157
+ 'X-AtomCode-Ts': String(timestamp),
158
+ 'X-AtomCode-Nonce': nonceHex,
159
+ 'X-AtomCode-Alg': '1',
160
+ 'X-AtomCode-Ver': clientVersion,
161
+ };
162
+ }
163
+ /** LLM 网关是否需要签名(客户端 `is_atomgit_gateway` 的 host 白名单同源)。 */
164
+ export function isAtomcodeSigningGateway(baseUrl) {
165
+ let host;
166
+ try {
167
+ host = new URL(baseUrl).hostname.toLowerCase();
168
+ }
169
+ catch {
170
+ return false;
171
+ }
172
+ return host === 'llm-api.atomgit.com'
173
+ || host === 'pre-llm-api-cce.atomgit.com'
174
+ || host === 'api-ai.gitcode.com';
175
+ }
176
+ /** 推理请求头(Bearer + 官方 UA + 签名五头)。 */
177
+ export function atomcodeChatHeaders(params) {
178
+ const signature = atomcodeGatewaySignature({
179
+ method: 'POST',
180
+ path: params.path,
181
+ body: params.body,
182
+ oauthToken: params.credential.access_token,
183
+ userId: params.credential.user_id,
184
+ ...params.nowMs === undefined ? {} : { nowMs: params.nowMs },
185
+ });
186
+ return {
187
+ Authorization: `Bearer ${params.credential.access_token}`,
188
+ 'Content-Type': 'application/json',
189
+ Accept: params.accept ?? 'application/json',
190
+ 'User-Agent': ATOMCODE_USER_AGENT,
191
+ ...signature,
192
+ };
193
+ }
194
+ /** CodingPlan REST / OAuth broker 的通用请求头(Bearer 可选、无签名)。 */
195
+ export function atomcodeRestHeaders(params) {
196
+ return {
197
+ Accept: 'application/json',
198
+ 'User-Agent': ATOMCODE_USER_AGENT,
199
+ ...(params.json === true ? { 'Content-Type': 'application/json' } : {}),
200
+ ...(params.accessToken !== undefined && params.accessToken.length > 0
201
+ ? { Authorization: `Bearer ${params.accessToken}` }
202
+ : {}),
203
+ };
204
+ }
205
+ //# sourceMappingURL=atomcode.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"atomcode.js","sourceRoot":"","sources":["../src/atomcode.ts"],"names":[],"mappings":"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"}