@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.
- package/README.md +4 -5
- package/lib/aggregate-adapter.d.ts.map +1 -1
- package/lib/aggregate-adapter.js +7 -0
- package/lib/aggregate-adapter.js.map +1 -1
- package/lib/aggregate-expiry.d.ts +20 -0
- package/lib/aggregate-expiry.d.ts.map +1 -1
- package/lib/aggregate-expiry.js +34 -0
- package/lib/aggregate-expiry.js.map +1 -1
- package/lib/atomcode-adapter.d.ts +112 -0
- package/lib/atomcode-adapter.d.ts.map +1 -0
- package/lib/atomcode-adapter.js +309 -0
- package/lib/atomcode-adapter.js.map +1 -0
- package/lib/atomcode-auth.d.ts +86 -0
- package/lib/atomcode-auth.d.ts.map +1 -0
- package/lib/atomcode-auth.js +235 -0
- package/lib/atomcode-auth.js.map +1 -0
- package/lib/atomcode-credits.d.ts +83 -0
- package/lib/atomcode-credits.d.ts.map +1 -0
- package/lib/atomcode-credits.js +290 -0
- package/lib/atomcode-credits.js.map +1 -0
- package/lib/atomcode-oauth.d.ts +101 -0
- package/lib/atomcode-oauth.d.ts.map +1 -0
- package/lib/atomcode-oauth.js +283 -0
- package/lib/atomcode-oauth.js.map +1 -0
- package/lib/atomcode-product.d.ts +130 -0
- package/lib/atomcode-product.d.ts.map +1 -0
- package/lib/atomcode-product.js +215 -0
- package/lib/atomcode-product.js.map +1 -0
- package/lib/atomcode.d.ts +108 -0
- package/lib/atomcode.d.ts.map +1 -0
- package/lib/atomcode.js +205 -0
- package/lib/atomcode.js.map +1 -0
- package/lib/client/jet-hub.js +47 -57
- package/lib/index.d.ts.map +1 -1
- package/lib/index.js +183 -0
- package/lib/index.js.map +1 -1
- package/lib/jet-hub-rpc.d.ts +10 -0
- package/lib/jet-hub-rpc.d.ts.map +1 -1
- package/lib/jet-hub-rpc.js +74 -0
- package/lib/jet-hub-rpc.js.map +1 -1
- package/lib/jet-hub-store.d.ts.map +1 -1
- package/lib/jet-hub-store.js +4 -0
- package/lib/jet-hub-store.js.map +1 -1
- package/lib/loomy-adapter.d.ts.map +1 -1
- package/lib/loomy-adapter.js +53 -3
- package/lib/loomy-adapter.js.map +1 -1
- package/lib/magicrew-adapter.d.ts.map +1 -1
- package/lib/magicrew-adapter.js +37 -2
- package/lib/magicrew-adapter.js.map +1 -1
- package/lib/magicrew-catalog.d.ts.map +1 -1
- package/lib/magicrew-catalog.js +12 -1
- package/lib/magicrew-catalog.js.map +1 -1
- package/lib/marvis-auth.d.ts.map +1 -1
- package/lib/marvis-auth.js +28 -3
- package/lib/marvis-auth.js.map +1 -1
- package/lib/openai-compat.d.ts.map +1 -1
- package/lib/openai-compat.js +18 -1
- package/lib/openai-compat.js.map +1 -1
- package/lib/provider-credits.d.ts.map +1 -1
- package/lib/provider-credits.js +33 -0
- package/lib/provider-credits.js.map +1 -1
- package/lib/provider-expiry.d.ts.map +1 -1
- package/lib/provider-expiry.js +13 -0
- package/lib/provider-expiry.js.map +1 -1
- package/lib/provider-registry.d.ts.map +1 -1
- package/lib/provider-registry.js +41 -0
- package/lib/provider-registry.js.map +1 -1
- package/lib/raccoon-adapter.d.ts +36 -71
- package/lib/raccoon-adapter.d.ts.map +1 -1
- package/lib/raccoon-adapter.js +21 -265
- package/lib/raccoon-adapter.js.map +1 -1
- package/package.json +9 -9
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AtomGit OAuth broker 的两步式登录与 token 续期。
|
|
3
|
+
*
|
|
4
|
+
* ## 协议(2026-11-12 取证;客户端 `crates/atomcode-auth/src/oauth.rs` +
|
|
5
|
+
* Atom2Api `oauth.go` 双源一致)
|
|
6
|
+
*
|
|
7
|
+
* ```
|
|
8
|
+
* 1) GET {platform}/auth/login?provider=atomgit
|
|
9
|
+
* → 200 { login_url, state } ← login_url 是 AtomGit 授权页
|
|
10
|
+
* (客户端 strip_force_login:剥掉 `force_login=true` 让已登录用户免重复授权)
|
|
11
|
+
* 2) GET {platform}/auth/check?state=<state>
|
|
12
|
+
* → 200 { valid: boolean } ← 轮询这步,valid=false = 还没授权完
|
|
13
|
+
* 3) GET {platform}/auth/token?state=<state>
|
|
14
|
+
* → 200 { access_token, refresh_token, token_type, expires_in, user:{id, username, …} }
|
|
15
|
+
* (expires_in 单位**秒**;user.id 是**签名 salt 的一部分**,必存)
|
|
16
|
+
* R) POST {platform}/oauth/refresh { refresh_token }
|
|
17
|
+
* → 200 { access_token, refresh_token?, token_type?, expires_in?, user? }
|
|
18
|
+
* (refresh_token 可能轮换——客户端 `or(auth.refresh_token)` 缺省沿用旧值;
|
|
19
|
+
* expires_in 缺省沿用旧值)
|
|
20
|
+
* ```
|
|
21
|
+
*
|
|
22
|
+
* ## 与仓库两步式登录契约的对齐
|
|
23
|
+
*
|
|
24
|
+
* {@link startAtomcodeLoginFlow} 先拿 `login_url` **立即返回**(客户端两步式
|
|
25
|
+
* 契约:`window.open` 只在用户手势窗口内有效),后台轮询 `/auth/check` →
|
|
26
|
+
* `/auth/token` → 兑换落盘;调用方(jet-hub-rpc)只管占位条目与回填。
|
|
27
|
+
* 失败一律抛错,由调用方统一走 `failLogin` 三态契约收尾。
|
|
28
|
+
*
|
|
29
|
+
* @module atomcode-oauth
|
|
30
|
+
*/
|
|
31
|
+
import { ATOMCODE_PROVIDER_ID } from './atomcode-product.js';
|
|
32
|
+
import { type AtomcodeCredential } from './atomcode.js';
|
|
33
|
+
/** 登录流程落定后的结果。 */
|
|
34
|
+
export interface AtomcodeLoginOutcome {
|
|
35
|
+
credential: AtomcodeCredential;
|
|
36
|
+
/** access_token 的绝对过期时刻(毫秒;上游没给有效期时 undefined)。 */
|
|
37
|
+
expiresAt?: number;
|
|
38
|
+
/** 展示昵称(`user.username`,尽力而为)。 */
|
|
39
|
+
nickname?: string;
|
|
40
|
+
}
|
|
41
|
+
/** 已启动但尚未完成的登录流程(两步式登录用)。 */
|
|
42
|
+
export interface StartedAtomcodeLoginFlow {
|
|
43
|
+
/** 展示给用户的 AtomGit 授权页 URL。 */
|
|
44
|
+
loginUrl: string;
|
|
45
|
+
/** 用户完成授权(或超时/失败)后落定的结果。 */
|
|
46
|
+
result: Promise<AtomcodeLoginOutcome>;
|
|
47
|
+
/** 取消登录(中止轮询);幂等。 */
|
|
48
|
+
close: () => Promise<void>;
|
|
49
|
+
}
|
|
50
|
+
/** 登录流程选项。 */
|
|
51
|
+
export interface AtomcodeLoginFlowOptions {
|
|
52
|
+
/** 凭据落盘的完整 ref(调用方用 `credentialRef(refName)` 算好传入)。 */
|
|
53
|
+
ref: string;
|
|
54
|
+
/** 凭据写入出口(宿主 `ctx.credentials` 的形状子集)。 */
|
|
55
|
+
credentials: {
|
|
56
|
+
set(ref: string, value: string): Promise<void>;
|
|
57
|
+
};
|
|
58
|
+
/** 使用的 fetch 实现;默认为全局 fetch(测试注入替身)。 */
|
|
59
|
+
fetcher?: typeof fetch;
|
|
60
|
+
/** 外部取消信号。 */
|
|
61
|
+
signal?: AbortSignal;
|
|
62
|
+
}
|
|
63
|
+
/** 剥掉 broker 下发的 `force_login`(客户端 `strip_force_login` 同语义:已登录用户免重复授权)。 */
|
|
64
|
+
export declare function stripAtomcodeForceLogin(raw: string): string;
|
|
65
|
+
/** 第 1 步:请求登录会话(拿 login_url + state)。 */
|
|
66
|
+
export declare function requestAtomcodeLoginSession(options?: Pick<AtomcodeLoginFlowOptions, 'fetcher' | 'signal'>): Promise<{
|
|
67
|
+
loginUrl: string;
|
|
68
|
+
state: string;
|
|
69
|
+
}>;
|
|
70
|
+
/** 第 2 步:单次 `/auth/check` 轮询(false = 尚未授权完)。 */
|
|
71
|
+
export declare function checkAtomcodeAuthorization(state: string, options?: Pick<AtomcodeLoginFlowOptions, 'fetcher' | 'signal'>): Promise<boolean>;
|
|
72
|
+
/** 第 3 步:用 state 换 token(`user.id` 是签名必需,缺了直接判失败)。 */
|
|
73
|
+
export declare function exchangeAtomcodeToken(state: string, options?: Pick<AtomcodeLoginFlowOptions, 'fetcher' | 'signal'>): Promise<{
|
|
74
|
+
credential: AtomcodeCredential;
|
|
75
|
+
expiresAt?: number;
|
|
76
|
+
nickname?: string;
|
|
77
|
+
}>;
|
|
78
|
+
/**
|
|
79
|
+
* 续期 access_token(`POST /oauth/refresh`)。
|
|
80
|
+
*
|
|
81
|
+
* ⚠️ refresh_token **可能轮换**:响应带新值就用新值,缺省沿用旧值
|
|
82
|
+
* (客户端同语义)⇒ 调用方必须把**返回的整份凭据**落盘。
|
|
83
|
+
* ⚠️ `expires_in` 缺省沿用旧有效期(客户端 `or(auth.expires_in)`)。
|
|
84
|
+
*/
|
|
85
|
+
export declare function refreshAtomcodeAccessToken(refreshToken: string, options?: {
|
|
86
|
+
fetcher?: typeof fetch;
|
|
87
|
+
signal?: AbortSignal;
|
|
88
|
+
previousExpiresAt?: number;
|
|
89
|
+
}): Promise<{
|
|
90
|
+
credential: AtomcodeCredential;
|
|
91
|
+
expiresAt?: number;
|
|
92
|
+
}>;
|
|
93
|
+
/**
|
|
94
|
+
* 启动登录流程并**立即返回**登录 URL(不打开浏览器、不等用户)。
|
|
95
|
+
*
|
|
96
|
+
* 后台轮询 `/auth/check`(间隔 {@link ATOMCODE_POLL_INTERVAL_MS},客户端同值),
|
|
97
|
+
* `valid=true` 后 `/auth/token` 兑换并落盘;总时长 {@link ATOMCODE_LOGIN_EXPIRES_MS}。
|
|
98
|
+
*/
|
|
99
|
+
export declare function startAtomcodeLoginFlow(options: AtomcodeLoginFlowOptions): Promise<StartedAtomcodeLoginFlow>;
|
|
100
|
+
export { ATOMCODE_PROVIDER_ID };
|
|
101
|
+
//# sourceMappingURL=atomcode-oauth.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"atomcode-oauth.d.ts","sourceRoot":"","sources":["../src/atomcode-oauth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAKL,oBAAoB,EACrB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAuB,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAiB5E,kBAAkB;AAClB,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,kBAAkB,CAAA;IAC9B,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,6BAA6B;AAC7B,MAAM,WAAW,wBAAwB;IACvC,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAA;IACrC,qBAAqB;IACrB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AAED,cAAc;AACd,MAAM,WAAW,wBAAwB;IACvC,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAA;IACX,0CAA0C;IAC1C,WAAW,EAAE;QAAE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAA;IAC/D,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;IACtB,cAAc;IACd,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAyCD,2EAA2E;AAC3E,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS3D;AAED,yCAAyC;AACzC,wBAAsB,2BAA2B,CAC/C,OAAO,GAAE,IAAI,CAAC,wBAAwB,EAAE,SAAS,GAAG,QAAQ,CAAM,GACjE,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAoB9C;AAED,gDAAgD;AAChD,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,IAAI,CAAC,wBAAwB,EAAE,SAAS,GAAG,QAAQ,CAAM,GACjE,OAAO,CAAC,OAAO,CAAC,CAelB;AAED,sDAAsD;AACtD,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,IAAI,CAAC,wBAAwB,EAAE,SAAS,GAAG,QAAQ,CAAM,GACjE,OAAO,CAAC;IAAE,UAAU,EAAE,kBAAkB,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA+CpF;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAO,GACzF,OAAO,CAAC;IAAE,UAAU,EAAE,kBAAkB,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAmDjE;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,wBAAwB,CAAC,CA8CnC;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAA"}
|
|
@@ -0,0 +1,283 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AtomGit OAuth broker 的两步式登录与 token 续期。
|
|
3
|
+
*
|
|
4
|
+
* ## 协议(2026-11-12 取证;客户端 `crates/atomcode-auth/src/oauth.rs` +
|
|
5
|
+
* Atom2Api `oauth.go` 双源一致)
|
|
6
|
+
*
|
|
7
|
+
* ```
|
|
8
|
+
* 1) GET {platform}/auth/login?provider=atomgit
|
|
9
|
+
* → 200 { login_url, state } ← login_url 是 AtomGit 授权页
|
|
10
|
+
* (客户端 strip_force_login:剥掉 `force_login=true` 让已登录用户免重复授权)
|
|
11
|
+
* 2) GET {platform}/auth/check?state=<state>
|
|
12
|
+
* → 200 { valid: boolean } ← 轮询这步,valid=false = 还没授权完
|
|
13
|
+
* 3) GET {platform}/auth/token?state=<state>
|
|
14
|
+
* → 200 { access_token, refresh_token, token_type, expires_in, user:{id, username, …} }
|
|
15
|
+
* (expires_in 单位**秒**;user.id 是**签名 salt 的一部分**,必存)
|
|
16
|
+
* R) POST {platform}/oauth/refresh { refresh_token }
|
|
17
|
+
* → 200 { access_token, refresh_token?, token_type?, expires_in?, user? }
|
|
18
|
+
* (refresh_token 可能轮换——客户端 `or(auth.refresh_token)` 缺省沿用旧值;
|
|
19
|
+
* expires_in 缺省沿用旧值)
|
|
20
|
+
* ```
|
|
21
|
+
*
|
|
22
|
+
* ## 与仓库两步式登录契约的对齐
|
|
23
|
+
*
|
|
24
|
+
* {@link startAtomcodeLoginFlow} 先拿 `login_url` **立即返回**(客户端两步式
|
|
25
|
+
* 契约:`window.open` 只在用户手势窗口内有效),后台轮询 `/auth/check` →
|
|
26
|
+
* `/auth/token` → 兑换落盘;调用方(jet-hub-rpc)只管占位条目与回填。
|
|
27
|
+
* 失败一律抛错,由调用方统一走 `failLogin` 三态契约收尾。
|
|
28
|
+
*
|
|
29
|
+
* @module atomcode-oauth
|
|
30
|
+
*/
|
|
31
|
+
import { ATOMCODE_HTTP_TIMEOUT_MS, ATOMCODE_LOGIN_EXPIRES_MS, ATOMCODE_PLATFORM_BASE, ATOMCODE_POLL_INTERVAL_MS, ATOMCODE_PROVIDER_ID, } from './atomcode-product.js';
|
|
32
|
+
import { atomcodeRestHeaders } from './atomcode.js';
|
|
33
|
+
/** 本模块自身抛出的确定性错误前缀(用于与网络错误区分,同 codely 做法)。 */
|
|
34
|
+
const SERVER_ERROR_PREFIX = '登录服务返回异常';
|
|
35
|
+
function isAborted(signal) {
|
|
36
|
+
return signal?.aborted === true;
|
|
37
|
+
}
|
|
38
|
+
function sleep(ms, signal) {
|
|
39
|
+
return new Promise((resolve, reject) => {
|
|
40
|
+
if (signal?.aborted === true) {
|
|
41
|
+
reject(new Error('登录已取消'));
|
|
42
|
+
return;
|
|
43
|
+
}
|
|
44
|
+
const onAbort = () => {
|
|
45
|
+
clearTimeout(timer);
|
|
46
|
+
reject(new Error('登录已取消'));
|
|
47
|
+
};
|
|
48
|
+
const timer = setTimeout(() => {
|
|
49
|
+
signal?.removeEventListener('abort', onAbort);
|
|
50
|
+
resolve();
|
|
51
|
+
}, ms);
|
|
52
|
+
signal?.addEventListener('abort', onAbort, { once: true });
|
|
53
|
+
});
|
|
54
|
+
}
|
|
55
|
+
/** 读错误响应里最有信息量的那句话。 */
|
|
56
|
+
async function errorMessageOf(response, fallback) {
|
|
57
|
+
try {
|
|
58
|
+
const payload = await response.json().catch(() => ({}));
|
|
59
|
+
for (const key of ['message', 'error_description', 'error']) {
|
|
60
|
+
const value = payload[key];
|
|
61
|
+
if (typeof value === 'string' && value.length > 0)
|
|
62
|
+
return value;
|
|
63
|
+
}
|
|
64
|
+
return fallback;
|
|
65
|
+
}
|
|
66
|
+
catch {
|
|
67
|
+
return fallback;
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
/** 剥掉 broker 下发的 `force_login`(客户端 `strip_force_login` 同语义:已登录用户免重复授权)。 */
|
|
71
|
+
export function stripAtomcodeForceLogin(raw) {
|
|
72
|
+
let url;
|
|
73
|
+
try {
|
|
74
|
+
url = new URL(raw);
|
|
75
|
+
}
|
|
76
|
+
catch {
|
|
77
|
+
return raw.replace('&force_login=true', '');
|
|
78
|
+
}
|
|
79
|
+
url.searchParams.delete('force_login');
|
|
80
|
+
return url.toString();
|
|
81
|
+
}
|
|
82
|
+
/** 第 1 步:请求登录会话(拿 login_url + state)。 */
|
|
83
|
+
export async function requestAtomcodeLoginSession(options = {}) {
|
|
84
|
+
const fetcher = options.fetcher ?? fetch;
|
|
85
|
+
const url = new URL('/auth/login', ATOMCODE_PLATFORM_BASE);
|
|
86
|
+
url.searchParams.set('provider', 'atomgit');
|
|
87
|
+
const response = await fetcher(url, {
|
|
88
|
+
method: 'GET',
|
|
89
|
+
headers: atomcodeRestHeaders({}),
|
|
90
|
+
signal: options.signal ?? AbortSignal.timeout(ATOMCODE_HTTP_TIMEOUT_MS),
|
|
91
|
+
});
|
|
92
|
+
const payload = await response.json().catch(() => ({}));
|
|
93
|
+
if (!response.ok) {
|
|
94
|
+
const detail = await errorMessageOf(response, '');
|
|
95
|
+
throw new Error(`${SERVER_ERROR_PREFIX}:登录会话请求失败(HTTP ${response.status})${detail}`);
|
|
96
|
+
}
|
|
97
|
+
const loginUrl = typeof payload.login_url === 'string' ? payload.login_url : '';
|
|
98
|
+
const state = typeof payload.state === 'string' ? payload.state : '';
|
|
99
|
+
if (state.length === 0 || loginUrl.length === 0) {
|
|
100
|
+
throw new Error(`${SERVER_ERROR_PREFIX}:登录会话响应缺少必要字段`);
|
|
101
|
+
}
|
|
102
|
+
return { loginUrl: stripAtomcodeForceLogin(loginUrl), state };
|
|
103
|
+
}
|
|
104
|
+
/** 第 2 步:单次 `/auth/check` 轮询(false = 尚未授权完)。 */
|
|
105
|
+
export async function checkAtomcodeAuthorization(state, options = {}) {
|
|
106
|
+
const fetcher = options.fetcher ?? fetch;
|
|
107
|
+
const url = new URL('/auth/check', ATOMCODE_PLATFORM_BASE);
|
|
108
|
+
url.searchParams.set('state', state);
|
|
109
|
+
const response = await fetcher(url, {
|
|
110
|
+
method: 'GET',
|
|
111
|
+
headers: atomcodeRestHeaders({}),
|
|
112
|
+
signal: options.signal ?? AbortSignal.timeout(ATOMCODE_HTTP_TIMEOUT_MS),
|
|
113
|
+
});
|
|
114
|
+
if (!response.ok) {
|
|
115
|
+
// 客户端 `interpret_check`:非 2xx 一律按「还没授权完」处理,不中断轮询。
|
|
116
|
+
return false;
|
|
117
|
+
}
|
|
118
|
+
const payload = await response.json().catch(() => ({}));
|
|
119
|
+
return payload.valid === true;
|
|
120
|
+
}
|
|
121
|
+
/** 第 3 步:用 state 换 token(`user.id` 是签名必需,缺了直接判失败)。 */
|
|
122
|
+
export async function exchangeAtomcodeToken(state, options = {}) {
|
|
123
|
+
const fetcher = options.fetcher ?? fetch;
|
|
124
|
+
const url = new URL('/auth/token', ATOMCODE_PLATFORM_BASE);
|
|
125
|
+
url.searchParams.set('state', state);
|
|
126
|
+
const response = await fetcher(url, {
|
|
127
|
+
method: 'GET',
|
|
128
|
+
headers: atomcodeRestHeaders({}),
|
|
129
|
+
signal: options.signal ?? AbortSignal.timeout(ATOMCODE_HTTP_TIMEOUT_MS),
|
|
130
|
+
});
|
|
131
|
+
const payload = await response.json().catch(() => ({}));
|
|
132
|
+
if (!response.ok) {
|
|
133
|
+
const detail = await errorMessageOf(response, '');
|
|
134
|
+
throw new Error(`${SERVER_ERROR_PREFIX}:令牌交换失败(HTTP ${response.status})${detail}`);
|
|
135
|
+
}
|
|
136
|
+
const accessToken = typeof payload.access_token === 'string' ? payload.access_token : '';
|
|
137
|
+
const userId = typeof payload.user?.id === 'string' ? payload.user.id : '';
|
|
138
|
+
if (accessToken.length === 0 || userId.length === 0) {
|
|
139
|
+
// ⚠️ 客户端同样把「缺 access_token 或缺 user.id」判为不完整凭据:
|
|
140
|
+
// 签名 salt 需要用户 id,缺它连第一发推理都发不出去。
|
|
141
|
+
throw new Error(`${SERVER_ERROR_PREFIX}:令牌响应缺少 access_token 或 user.id`);
|
|
142
|
+
}
|
|
143
|
+
const refreshToken = typeof payload.refresh_token === 'string' ? payload.refresh_token : '';
|
|
144
|
+
if (refreshToken.length === 0) {
|
|
145
|
+
throw new Error(`${SERVER_ERROR_PREFIX}:令牌响应缺少 refresh_token(无法续期)`);
|
|
146
|
+
}
|
|
147
|
+
// ⚠️ `expires_in` 单位是**秒**(客户端 `created_at + expires_in` 秒级加法)。
|
|
148
|
+
// 只在这里归一化一次;非正数 / 非数字 ⇒ 缺省(绝不编造)。
|
|
149
|
+
const rawExpiresIn = payload.expires_in;
|
|
150
|
+
const parsedExpiresIn = typeof rawExpiresIn === 'number'
|
|
151
|
+
? rawExpiresIn
|
|
152
|
+
: typeof rawExpiresIn === 'string' && rawExpiresIn.trim() !== ''
|
|
153
|
+
? Number(rawExpiresIn.trim())
|
|
154
|
+
: Number.NaN;
|
|
155
|
+
const expiresAt = Number.isFinite(parsedExpiresIn) && parsedExpiresIn > 0
|
|
156
|
+
? Date.now() + Math.floor(parsedExpiresIn) * 1_000
|
|
157
|
+
: undefined;
|
|
158
|
+
const nickname = typeof payload.user?.username === 'string' && payload.user.username.length > 0
|
|
159
|
+
? payload.user.username
|
|
160
|
+
: undefined;
|
|
161
|
+
const credential = {
|
|
162
|
+
access_token: accessToken,
|
|
163
|
+
refresh_token: refreshToken,
|
|
164
|
+
user_id: userId,
|
|
165
|
+
...(nickname === undefined ? {} : { nickname }),
|
|
166
|
+
...(expiresAt === undefined ? {} : { expires_at: expiresAt }),
|
|
167
|
+
};
|
|
168
|
+
return { credential, ...(expiresAt === undefined ? {} : { expiresAt }), ...(nickname === undefined ? {} : { nickname }) };
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* 续期 access_token(`POST /oauth/refresh`)。
|
|
172
|
+
*
|
|
173
|
+
* ⚠️ refresh_token **可能轮换**:响应带新值就用新值,缺省沿用旧值
|
|
174
|
+
* (客户端同语义)⇒ 调用方必须把**返回的整份凭据**落盘。
|
|
175
|
+
* ⚠️ `expires_in` 缺省沿用旧有效期(客户端 `or(auth.expires_in)`)。
|
|
176
|
+
*/
|
|
177
|
+
export async function refreshAtomcodeAccessToken(refreshToken, options = {}) {
|
|
178
|
+
const fetcher = options.fetcher ?? fetch;
|
|
179
|
+
const response = await fetcher(new URL('/oauth/refresh', ATOMCODE_PLATFORM_BASE), {
|
|
180
|
+
method: 'POST',
|
|
181
|
+
headers: atomcodeRestHeaders({ json: true }),
|
|
182
|
+
body: JSON.stringify({ refresh_token: refreshToken }),
|
|
183
|
+
signal: options.signal ?? AbortSignal.timeout(ATOMCODE_HTTP_TIMEOUT_MS),
|
|
184
|
+
});
|
|
185
|
+
if (response.status === 400 || response.status === 401 || response.status === 403) {
|
|
186
|
+
// Atom2Api 把这三态判成「refresh_token 已死」⇒ 终态,只能重新登录。
|
|
187
|
+
const error = new Error(`atomcode: refresh_token 已失效(HTTP ${response.status}),请重新登录`);
|
|
188
|
+
error.name = 'RefreshTokenExpiredError';
|
|
189
|
+
throw error;
|
|
190
|
+
}
|
|
191
|
+
const payload = await response.json().catch(() => ({}));
|
|
192
|
+
if (!response.ok) {
|
|
193
|
+
throw new Error(`atomcode: 续期失败(HTTP ${response.status})`);
|
|
194
|
+
}
|
|
195
|
+
const accessToken = typeof payload.access_token === 'string' ? payload.access_token : '';
|
|
196
|
+
if (accessToken.length === 0) {
|
|
197
|
+
throw new Error('atomcode: 续期响应缺少 access_token');
|
|
198
|
+
}
|
|
199
|
+
const userId = typeof payload.user?.id === 'string' && payload.user.id.length > 0
|
|
200
|
+
? payload.user.id
|
|
201
|
+
: undefined;
|
|
202
|
+
if (userId === undefined) {
|
|
203
|
+
throw new Error('atomcode: 续期响应缺少 user.id(签名需要)');
|
|
204
|
+
}
|
|
205
|
+
const rawExpiresIn = payload.expires_in;
|
|
206
|
+
const parsedExpiresIn = typeof rawExpiresIn === 'number'
|
|
207
|
+
? rawExpiresIn
|
|
208
|
+
: typeof rawExpiresIn === 'string' && rawExpiresIn.trim() !== ''
|
|
209
|
+
? Number(rawExpiresIn.trim())
|
|
210
|
+
: Number.NaN;
|
|
211
|
+
const expiresAt = Number.isFinite(parsedExpiresIn) && parsedExpiresIn > 0
|
|
212
|
+
? Date.now() + Math.floor(parsedExpiresIn) * 1_000
|
|
213
|
+
: options.previousExpiresAt;
|
|
214
|
+
const nickname = typeof payload.user?.username === 'string' && payload.user.username.length > 0
|
|
215
|
+
? payload.user.username
|
|
216
|
+
: undefined;
|
|
217
|
+
const nextRefresh = typeof payload.refresh_token === 'string' && payload.refresh_token.length > 0
|
|
218
|
+
? payload.refresh_token
|
|
219
|
+
: refreshToken;
|
|
220
|
+
const credential = {
|
|
221
|
+
access_token: accessToken,
|
|
222
|
+
refresh_token: nextRefresh,
|
|
223
|
+
user_id: userId,
|
|
224
|
+
...(nickname === undefined ? {} : { nickname }),
|
|
225
|
+
...(expiresAt === undefined ? {} : { expires_at: expiresAt }),
|
|
226
|
+
};
|
|
227
|
+
return { credential, ...(expiresAt === undefined ? {} : { expiresAt }) };
|
|
228
|
+
}
|
|
229
|
+
/**
|
|
230
|
+
* 启动登录流程并**立即返回**登录 URL(不打开浏览器、不等用户)。
|
|
231
|
+
*
|
|
232
|
+
* 后台轮询 `/auth/check`(间隔 {@link ATOMCODE_POLL_INTERVAL_MS},客户端同值),
|
|
233
|
+
* `valid=true` 后 `/auth/token` 兑换并落盘;总时长 {@link ATOMCODE_LOGIN_EXPIRES_MS}。
|
|
234
|
+
*/
|
|
235
|
+
export async function startAtomcodeLoginFlow(options) {
|
|
236
|
+
const controller = new AbortController();
|
|
237
|
+
const signal = options.signal === undefined
|
|
238
|
+
? controller.signal
|
|
239
|
+
: AbortSignal.any([controller.signal, options.signal]);
|
|
240
|
+
const session = await requestAtomcodeLoginSession({
|
|
241
|
+
...options.fetcher === undefined ? {} : { fetcher: options.fetcher },
|
|
242
|
+
signal,
|
|
243
|
+
});
|
|
244
|
+
const result = (async () => {
|
|
245
|
+
const deadline = Date.now() + ATOMCODE_LOGIN_EXPIRES_MS;
|
|
246
|
+
let authorized = false;
|
|
247
|
+
while (Date.now() <= deadline) {
|
|
248
|
+
if (isAborted(signal))
|
|
249
|
+
throw new Error('登录已取消');
|
|
250
|
+
authorized = await checkAtomcodeAuthorization(session.state, {
|
|
251
|
+
...options.fetcher === undefined ? {} : { fetcher: options.fetcher },
|
|
252
|
+
signal,
|
|
253
|
+
});
|
|
254
|
+
if (authorized)
|
|
255
|
+
break;
|
|
256
|
+
await sleep(ATOMCODE_POLL_INTERVAL_MS, signal);
|
|
257
|
+
}
|
|
258
|
+
if (!authorized)
|
|
259
|
+
throw new Error('登录等待已超时,请重新发起登录');
|
|
260
|
+
const exchanged = await exchangeAtomcodeToken(session.state, {
|
|
261
|
+
...options.fetcher === undefined ? {} : { fetcher: options.fetcher },
|
|
262
|
+
signal,
|
|
263
|
+
});
|
|
264
|
+
await options.credentials.set(options.ref, JSON.stringify(exchanged.credential));
|
|
265
|
+
return {
|
|
266
|
+
credential: exchanged.credential,
|
|
267
|
+
...(exchanged.expiresAt === undefined ? {} : { expiresAt: exchanged.expiresAt }),
|
|
268
|
+
...(exchanged.nickname === undefined ? {} : { nickname: exchanged.nickname }),
|
|
269
|
+
};
|
|
270
|
+
})();
|
|
271
|
+
// 先挂空处理器避免 Node 报「未处理的拒绝」(与 cline 同款)。
|
|
272
|
+
result.catch(() => { });
|
|
273
|
+
let closed = false;
|
|
274
|
+
const close = async () => {
|
|
275
|
+
if (closed)
|
|
276
|
+
return;
|
|
277
|
+
closed = true;
|
|
278
|
+
controller.abort();
|
|
279
|
+
};
|
|
280
|
+
return { loginUrl: session.loginUrl, result, close };
|
|
281
|
+
}
|
|
282
|
+
export { ATOMCODE_PROVIDER_ID };
|
|
283
|
+
//# sourceMappingURL=atomcode-oauth.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"atomcode-oauth.js","sourceRoot":"","sources":["../src/atomcode-oauth.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,130 @@
|
|
|
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 declare const ATOMCODE_PLATFORM_BASE = "https://acs.atomgit.com";
|
|
29
|
+
/** CodingPlan REST API 基址。 */
|
|
30
|
+
export declare const ATOMCODE_CODINGPLAN_BASE = "https://api.gitcode.com/api/v5";
|
|
31
|
+
/** LLM 网关基址(OpenAI 兼容,含 /v1)。 */
|
|
32
|
+
export declare const ATOMCODE_LLM_BASE = "https://llm-api.atomgit.com/v1";
|
|
33
|
+
/** provider id(与 `provider-registry.ts` 里 atomcode 条目的 id 逐字一致)。 */
|
|
34
|
+
export declare const ATOMCODE_PROVIDER_ID = "atomcode";
|
|
35
|
+
/** 官方客户端 UA(`atomcode/` + 版本,客户端 `ATOMCODE_USER_AGENT` 常量同形)。 */
|
|
36
|
+
export declare const ATOMCODE_USER_AGENT = "atomcode/5.2.7";
|
|
37
|
+
/** 单次 HTTP 请求超时(毫秒)。 */
|
|
38
|
+
export declare const ATOMCODE_HTTP_TIMEOUT_MS = 30000;
|
|
39
|
+
/** 登录轮询间隔(毫秒;客户端 `spawn_poller(Duration::from_secs(2))` 同值)。 */
|
|
40
|
+
export declare const ATOMCODE_POLL_INTERVAL_MS = 2000;
|
|
41
|
+
/** 登录会话有效期(毫秒;客户端 pending OAuth 10 分钟)。 */
|
|
42
|
+
export declare const ATOMCODE_LOGIN_EXPIRES_MS: number;
|
|
43
|
+
/** 兜底目录中的一个条目。 */
|
|
44
|
+
export interface AtomcodeFallbackModel {
|
|
45
|
+
/** 模型 id(`models-v2` 的 `display_model_name` 原样,OpenAI `model` 字段直接用它)。 */
|
|
46
|
+
readonly id: string;
|
|
47
|
+
/** 目录展示名。 */
|
|
48
|
+
readonly name: string;
|
|
49
|
+
/**
|
|
50
|
+
* 上下文窗口(tokens)。
|
|
51
|
+
*
|
|
52
|
+
* ⚠️ 128k 是客户端 `MIN_CONTEXT_WINDOW` 的**下限兜底**,不是逐模型实测上界;
|
|
53
|
+
* 远端目录可用时以远端 `context_window` 为准(客户端同样「下限抬、上限保留」)。
|
|
54
|
+
*/
|
|
55
|
+
readonly contextWindow: number;
|
|
56
|
+
/** 是否收图(`Qwen/Qwen3-VL-8B-Instruct` 是官方文档明示的 VL 模型)。 */
|
|
57
|
+
readonly supportsImage: boolean;
|
|
58
|
+
/** 该模型需要 Pro 及以上档位(Lite 用户调用会 403)。 */
|
|
59
|
+
readonly proOnly: boolean;
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* 静态兜底目录(3 条)。
|
|
63
|
+
*
|
|
64
|
+
* ⚠️ 客户端把 `context_window` 抬到 ≥128k(`MIN_CONTEXT_WINDOW`)⇒ 这里同样
|
|
65
|
+
* 只声明 128k 下限值;`maxTokens` 上游不下发 ⇒ 刻意不声明(marvis 同向:
|
|
66
|
+
* 出站预算由宿主 `GenerateOptions.maxTokens` 决定,目录不硬编)。
|
|
67
|
+
*/
|
|
68
|
+
export declare const ATOMCODE_FALLBACK_MODELS: readonly AtomcodeFallbackModel[];
|
|
69
|
+
export declare function findAtomcodeFallback(modelId: string): AtomcodeFallbackModel | undefined;
|
|
70
|
+
/** 产品常量。 */
|
|
71
|
+
export interface AtomcodeProduct {
|
|
72
|
+
/** provider id(必须纯小写字母,`provider-registry.spec.ts` 逐条断言)。 */
|
|
73
|
+
readonly id: 'atomcode';
|
|
74
|
+
/** 左栏展示名(必须与客户端 `PROVIDERS` 里 `atomcode` 的 `label` 逐字一致)。 */
|
|
75
|
+
readonly displayName: string;
|
|
76
|
+
/** OpenAI 兼容网关基址(含 `/v1`,不带尾斜杠)。 */
|
|
77
|
+
readonly baseUrl: string;
|
|
78
|
+
/** 对话端点路径(签名 canonical 用的就是它)。 */
|
|
79
|
+
readonly chatPath: string;
|
|
80
|
+
/** 等首个 token 的空闲超时(毫秒)。 */
|
|
81
|
+
readonly chatHeaderTimeoutMs: number;
|
|
82
|
+
/** 两次 chunk 之间的空闲超时(毫秒)。 */
|
|
83
|
+
readonly chunkTimeoutMs: number;
|
|
84
|
+
/** 兜底目录的超时(毫秒)。 */
|
|
85
|
+
readonly catalogTimeoutMs: number;
|
|
86
|
+
/** 余额请求超时(毫秒)。 */
|
|
87
|
+
readonly balanceTimeoutMs: number;
|
|
88
|
+
/** 默认凭据引用前缀。 */
|
|
89
|
+
readonly defaultCredentialRef: string;
|
|
90
|
+
}
|
|
91
|
+
export declare const ATOMCODE: AtomcodeProduct;
|
|
92
|
+
/** 错误分类(**语义**,不是 LlmError 码)。 */
|
|
93
|
+
export type AtomcodeErrorKind = 'rate_limit' | 'quota' | 'auth' | 'server' | 'transport' | 'invalid_request' | 'context_window' | 'model_unavailable';
|
|
94
|
+
export interface AtomcodeErrorInfo {
|
|
95
|
+
kind: AtomcodeErrorKind;
|
|
96
|
+
/** 服务端要求的等待时长(毫秒);仅限流类产出。 */
|
|
97
|
+
retryAfterMs?: number;
|
|
98
|
+
/** 面向用户的可读描述(禁止裸 JSON)。 */
|
|
99
|
+
detail: string;
|
|
100
|
+
}
|
|
101
|
+
/**
|
|
102
|
+
* 把一次失败的 HTTP 响应归类为语义化错误。
|
|
103
|
+
*
|
|
104
|
+
* ## ⚠️ 顺序即优先级(判据来源见注释)
|
|
105
|
+
*
|
|
106
|
+
* 1. **上下文超限**(报文关键词)——必须最先,否则会被 quota 抢走
|
|
107
|
+
* (marvis / trae 同型事故:用户只是消息太长,账号却被封一整天)。
|
|
108
|
+
* 2. **HTTP 401/403 ⇒ auth**(CodingPlan REST 客户端对这两态抛 `AuthExpired`;
|
|
109
|
+
* 官方报文形态 `authentication failed (NNN) — run atomcode login again`)。
|
|
110
|
+
* 3. 429 / 限流文案 ⇒ rate_limit(`retry-after` 原样保留)。
|
|
111
|
+
* ⚠️ **额度窗口文案不抢判**:5h 窗口烧光的报文(`window_quota_exhausted` /
|
|
112
|
+
* usage_percent 类)也走「额度用尽」语义,但落在 quota 档(见 ④)。
|
|
113
|
+
* 4. 402 / 额度文案(含 `quota_exhausted` / `全平台日限额已满` —— 后者是
|
|
114
|
+
* claim-v2 429 报文的实测 message,取自客户端 `format_api_error` 测试)⇒ quota。
|
|
115
|
+
* 5. HTTP 404 ⇒ model_unavailable(v2 端点对未知模型 / 未知路径都回 404;
|
|
116
|
+
* 客户端 `format_api_error` 的 Spring 形态测试可证)。
|
|
117
|
+
* 6. 400 / 422 ⇒ invalid_request。
|
|
118
|
+
* 7. status 0 / 传输层文案 ⇒ transport。
|
|
119
|
+
* 8. 其余(≥500)⇒ server。
|
|
120
|
+
*/
|
|
121
|
+
export declare function classifyAtomcodeError(status: number, body: string, headers?: Readonly<Record<string, string>>): AtomcodeErrorInfo;
|
|
122
|
+
/**
|
|
123
|
+
* 语义分类 → 宿主 `LlmError.code`。
|
|
124
|
+
*
|
|
125
|
+
* ⚠️ 额度/限流/认证必须用**字面量**:harness 的 `QUOTA_EXCEEDED_CODE`
|
|
126
|
+
* 字面值是 `'QUOTA'`,客户端会据此把 message 换成固定文案
|
|
127
|
+
* ⇒ 用错字面量会让「额度用尽」被渲染成别的错误(Issue IKJVCW)。
|
|
128
|
+
*/
|
|
129
|
+
export declare function atomcodeErrorKindCode(kind: AtomcodeErrorKind): string;
|
|
130
|
+
//# sourceMappingURL=atomcode-product.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"atomcode-product.d.ts","sourceRoot":"","sources":["../src/atomcode-product.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,oEAAoE;AACpE,eAAO,MAAM,sBAAsB,4BAA4B,CAAA;AAC/D,8BAA8B;AAC9B,eAAO,MAAM,wBAAwB,mCAAmC,CAAA;AACxE,iCAAiC;AACjC,eAAO,MAAM,iBAAiB,mCAAmC,CAAA;AAEjE,oEAAoE;AACpE,eAAO,MAAM,oBAAoB,aAAa,CAAA;AAE9C,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,mBAAmB,CAAA;AAEnD,wBAAwB;AACxB,eAAO,MAAM,wBAAwB,QAAS,CAAA;AAE9C,gEAAgE;AAChE,eAAO,MAAM,yBAAyB,OAAQ,CAAA;AAE9C,2CAA2C;AAC3C,eAAO,MAAM,yBAAyB,QAAc,CAAA;AAEpD,kBAAkB;AAClB,MAAM,WAAW,qBAAqB;IACpC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,aAAa;IACb,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,wDAAwD;IACxD,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,qBAAqB,EAsBpE,CAAA;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAEvF;AAED,YAAY;AACZ,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAA;IACvB,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,4BAA4B;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,mBAAmB;IACnB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,kBAAkB;IAClB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,gBAAgB;IAChB,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;CACtC;AAED,eAAO,MAAM,QAAQ,EAAE,eAUtB,CAAA;AAED,kCAAkC;AAClC,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,OAAO,GACP,MAAM,GACN,QAAQ,GACR,WAAW,GACX,iBAAiB,GACjB,gBAAgB,GAChB,mBAAmB,CAAA;AAEvB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,iBAAiB,CAAA;IACvB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAA;CACf;AAsBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACzC,iBAAiB,CAgEnB;AAWD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAmBrE"}
|