@xixka/dsh-hub 0.2.1-rc.2 → 0.2.1-rc.21
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 +0 -0
- package/README.md +96 -848
- package/cordis.patch.yml +0 -0
- package/lib/accio-adapter.d.ts.map +1 -1
- package/lib/accio-adapter.js +3 -1
- package/lib/accio-adapter.js.map +1 -1
- package/lib/accio-auth.d.ts.map +1 -1
- package/lib/accio-auth.js +1 -0
- package/lib/accio-auth.js.map +1 -1
- package/lib/account-pool.d.ts +69 -1
- package/lib/account-pool.d.ts.map +1 -1
- package/lib/account-pool.js +130 -0
- package/lib/account-pool.js.map +1 -1
- package/lib/aggregate-adapter.d.ts.map +1 -1
- package/lib/aggregate-adapter.js +0 -5
- package/lib/aggregate-adapter.js.map +1 -1
- package/lib/astudio-adapter.d.ts.map +1 -1
- package/lib/astudio-adapter.js +3 -1
- package/lib/astudio-adapter.js.map +1 -1
- package/lib/buddy-adapter.d.ts.map +1 -1
- package/lib/buddy-adapter.js +3 -1
- package/lib/buddy-adapter.js.map +1 -1
- package/lib/buddy-auth.d.ts.map +1 -1
- package/lib/buddy-auth.js +1 -0
- package/lib/buddy-auth.js.map +1 -1
- package/lib/client/jet-hub.js +2193 -1648
- package/lib/cline-auth.d.ts.map +1 -1
- package/lib/cline-auth.js +1 -0
- package/lib/cline-auth.js.map +1 -1
- package/lib/codely-adapter.d.ts.map +1 -1
- package/lib/codely-adapter.js +5 -2
- package/lib/codely-adapter.js.map +1 -1
- package/lib/expiry-sync.d.ts +9 -0
- package/lib/expiry-sync.d.ts.map +1 -1
- package/lib/expiry-sync.js +63 -1
- package/lib/expiry-sync.js.map +1 -1
- package/lib/gemini-auth.d.ts.map +1 -1
- package/lib/gemini-auth.js +2 -0
- package/lib/gemini-auth.js.map +1 -1
- package/lib/index.d.ts.map +1 -1
- package/lib/index.js +11 -138
- package/lib/index.js.map +1 -1
- package/lib/jet-hub-rpc.d.ts +23 -20
- package/lib/jet-hub-rpc.d.ts.map +1 -1
- package/lib/jet-hub-rpc.js +266 -258
- package/lib/jet-hub-rpc.js.map +1 -1
- package/lib/jet-hub-store.d.ts +49 -1
- package/lib/jet-hub-store.d.ts.map +1 -1
- package/lib/jet-hub-store.js +34 -4
- package/lib/jet-hub-store.js.map +1 -1
- package/lib/llm-adapter.d.ts +22 -0
- package/lib/llm-adapter.d.ts.map +1 -1
- package/lib/llm-adapter.js +192 -12
- package/lib/llm-adapter.js.map +1 -1
- package/lib/lobsterai-adapter.d.ts.map +1 -1
- package/lib/lobsterai-adapter.js +54 -15
- package/lib/lobsterai-adapter.js.map +1 -1
- package/lib/lobsterai-auth.d.ts.map +1 -1
- package/lib/lobsterai-auth.js +1 -0
- package/lib/lobsterai-auth.js.map +1 -1
- package/lib/loomy-adapter.d.ts.map +1 -1
- package/lib/loomy-adapter.js +3 -1
- package/lib/loomy-adapter.js.map +1 -1
- package/lib/minimax-auth.d.ts.map +1 -1
- package/lib/minimax-auth.js +1 -0
- package/lib/minimax-auth.js.map +1 -1
- package/lib/oauth.d.ts.map +1 -1
- package/lib/oauth.js +22 -1
- package/lib/oauth.js.map +1 -1
- package/lib/officeace-adapter.d.ts.map +1 -1
- package/lib/officeace-adapter.js +147 -21
- package/lib/officeace-adapter.js.map +1 -1
- package/lib/openai-gateway/tencent-fingerprint.d.ts.map +1 -1
- package/lib/openai-gateway/tencent-fingerprint.js +83 -0
- package/lib/openai-gateway/tencent-fingerprint.js.map +1 -1
- package/lib/opencode-adapter.d.ts +27 -0
- package/lib/opencode-adapter.d.ts.map +1 -1
- package/lib/opencode-adapter.js +57 -8
- package/lib/opencode-adapter.js.map +1 -1
- package/lib/opencode-bun-tls.d.ts +103 -0
- package/lib/opencode-bun-tls.d.ts.map +1 -0
- package/lib/opencode-bun-tls.js +196 -0
- package/lib/opencode-bun-tls.js.map +1 -0
- package/lib/opencode-messages.d.ts +0 -19
- package/lib/opencode-messages.d.ts.map +1 -1
- package/lib/opencode-messages.js +30 -33
- package/lib/opencode-messages.js.map +1 -1
- package/lib/opencode-official-prompt.d.ts +62 -0
- package/lib/opencode-official-prompt.d.ts.map +1 -0
- package/lib/opencode-official-prompt.js +119 -0
- package/lib/opencode-official-prompt.js.map +1 -0
- package/lib/opencode-official-tools.d.ts +27 -0
- package/lib/opencode-official-tools.d.ts.map +1 -0
- package/lib/opencode-official-tools.js +340 -0
- package/lib/opencode-official-tools.js.map +1 -0
- package/lib/opencode-product.d.ts.map +1 -1
- package/lib/opencode-product.js +3 -2
- package/lib/opencode-product.js.map +1 -1
- package/lib/opencode-stream.d.ts.map +1 -1
- package/lib/opencode-stream.js +8 -7
- package/lib/opencode-stream.js.map +1 -1
- package/lib/provider-credits.d.ts +2 -0
- package/lib/provider-credits.d.ts.map +1 -1
- package/lib/provider-credits.js +20 -17
- package/lib/provider-credits.js.map +1 -1
- package/lib/provider-http-pool.d.ts +85 -0
- package/lib/provider-http-pool.d.ts.map +1 -0
- package/lib/provider-http-pool.js +224 -0
- package/lib/provider-http-pool.js.map +1 -0
- package/lib/provider-registry.d.ts +9 -6
- package/lib/provider-registry.d.ts.map +1 -1
- package/lib/provider-registry.js +11 -58
- package/lib/provider-registry.js.map +1 -1
- package/lib/qoder-auth-wasm.wasm +0 -0
- package/lib/qoder-auth.d.ts.map +1 -1
- package/lib/qoder-auth.js +1 -0
- package/lib/qoder-auth.js.map +1 -1
- package/lib/raccoon-adapter.d.ts.map +1 -1
- package/lib/raccoon-adapter.js +115 -17
- package/lib/raccoon-adapter.js.map +1 -1
- package/lib/raccoon-auth.d.ts +6 -0
- package/lib/raccoon-auth.d.ts.map +1 -1
- package/lib/raccoon-auth.js +9 -1
- package/lib/raccoon-auth.js.map +1 -1
- package/lib/raccoon-credits.d.ts +38 -5
- package/lib/raccoon-credits.d.ts.map +1 -1
- package/lib/raccoon-credits.js +127 -6
- package/lib/raccoon-credits.js.map +1 -1
- package/lib/raccoon.d.ts +14 -2
- package/lib/raccoon.d.ts.map +1 -1
- package/lib/raccoon.js +14 -2
- package/lib/raccoon.js.map +1 -1
- package/lib/service.d.ts.map +1 -1
- package/lib/service.js +1 -0
- package/lib/service.js.map +1 -1
- package/lib/trae-adapter.d.ts.map +1 -1
- package/lib/trae-adapter.js +3 -1
- package/lib/trae-adapter.js.map +1 -1
- package/lib/trae-auth.d.ts.map +1 -1
- package/lib/trae-auth.js +1 -0
- package/lib/trae-auth.js.map +1 -1
- package/lib/types.d.ts +113 -16
- package/lib/types.d.ts.map +1 -1
- package/lib/types.js.map +1 -1
- package/lib/usage-badge.d.ts +67 -1
- package/lib/usage-badge.d.ts.map +1 -1
- package/lib/usage-badge.js +136 -18
- package/lib/usage-badge.js.map +1 -1
- package/lib/webdav-auto-sync.d.ts +96 -0
- package/lib/webdav-auto-sync.d.ts.map +1 -0
- package/lib/webdav-auto-sync.js +0 -0
- package/lib/webdav-auto-sync.js.map +1 -0
- package/lib/webdav-sync-crypto.d.ts +18 -0
- package/lib/webdav-sync-crypto.d.ts.map +1 -0
- package/lib/webdav-sync-crypto.js +72 -0
- package/lib/webdav-sync-crypto.js.map +1 -0
- package/lib/webdav-sync-merge.d.ts +31 -0
- package/lib/webdav-sync-merge.d.ts.map +1 -0
- package/lib/webdav-sync-merge.js +0 -0
- package/lib/webdav-sync-merge.js.map +1 -0
- package/lib/webdav-sync.d.ts +155 -0
- package/lib/webdav-sync.d.ts.map +1 -0
- package/lib/webdav-sync.js +412 -0
- package/lib/webdav-sync.js.map +1 -0
- package/lib/zcode-adapter.d.ts.map +1 -1
- package/lib/zcode-adapter.js +112 -31
- package/lib/zcode-adapter.js.map +1 -1
- package/lib/zcode-upstream.d.ts +59 -0
- package/lib/zcode-upstream.d.ts.map +1 -1
- package/lib/zcode-upstream.js +137 -2
- package/lib/zcode-upstream.js.map +1 -1
- package/locale/en.json +0 -0
- package/locale/zh.json +0 -0
- package/package.json +3 -2
- package/lib/stepcode-adapter.d.ts +0 -150
- package/lib/stepcode-adapter.d.ts.map +0 -1
- package/lib/stepcode-adapter.js +0 -303
- package/lib/stepcode-adapter.js.map +0 -1
- package/lib/stepcode-auth.d.ts +0 -154
- package/lib/stepcode-auth.d.ts.map +0 -1
- package/lib/stepcode-auth.js +0 -287
- package/lib/stepcode-auth.js.map +0 -1
- package/lib/stepcode-oauth.d.ts +0 -194
- package/lib/stepcode-oauth.d.ts.map +0 -1
- package/lib/stepcode-oauth.js +0 -496
- package/lib/stepcode-oauth.js.map +0 -1
- package/lib/stepcode-product.d.ts +0 -255
- package/lib/stepcode-product.d.ts.map +0 -1
- package/lib/stepcode-product.js +0 -256
- package/lib/stepcode-product.js.map +0 -1
- package/lib/stepcode.d.ts +0 -230
- package/lib/stepcode.d.ts.map +0 -1
- package/lib/stepcode.js +0 -300
- package/lib/stepcode.js.map +0 -1
- package/lib/teleagent-adapter.d.ts +0 -108
- package/lib/teleagent-adapter.d.ts.map +0 -1
- package/lib/teleagent-adapter.js +0 -278
- package/lib/teleagent-adapter.js.map +0 -1
- package/lib/teleagent-auth.d.ts +0 -279
- package/lib/teleagent-auth.d.ts.map +0 -1
- package/lib/teleagent-auth.js +0 -512
- package/lib/teleagent-auth.js.map +0 -1
- package/lib/teleagent-cdp-login.d.ts +0 -100
- package/lib/teleagent-cdp-login.d.ts.map +0 -1
- package/lib/teleagent-cdp-login.js +0 -402
- package/lib/teleagent-cdp-login.js.map +0 -1
- package/lib/teleagent-credits.d.ts +0 -120
- package/lib/teleagent-credits.d.ts.map +0 -1
- package/lib/teleagent-credits.js +0 -288
- package/lib/teleagent-credits.js.map +0 -1
- package/lib/teleagent-product.d.ts +0 -182
- package/lib/teleagent-product.d.ts.map +0 -1
- package/lib/teleagent-product.js +0 -172
- package/lib/teleagent-product.js.map +0 -1
- package/lib/teleagent.d.ts +0 -268
- package/lib/teleagent.d.ts.map +0 -1
- package/lib/teleagent.js +0 -422
- package/lib/teleagent.js.map +0 -1
package/lib/stepcode.d.ts
DELETED
|
@@ -1,230 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Step Code(阶跃星辰)协议层:常量、凭据结构与**纯函数**。
|
|
3
|
-
*
|
|
4
|
-
* 本文件**不发任何网络请求**(登录流程在 `stepcode-oauth.ts`,
|
|
5
|
-
* 服务编排在 `stepcode-auth.ts`),因此可完整单测。
|
|
6
|
-
*
|
|
7
|
-
* ## 凭据形态:静态 api_key,**没有真实续期**
|
|
8
|
-
*
|
|
9
|
-
* 官方 `loginStepOAuth()` 在轮询到 `state:"ready"` 后返回:
|
|
10
|
-
* ```js
|
|
11
|
-
* { access: ready.apiKey,
|
|
12
|
-
* refresh: STEP_STATIC_REFRESH_TOKEN, // "step-static-credential"
|
|
13
|
-
* expires: Number.MAX_SAFE_INTEGER,
|
|
14
|
-
* ...ready.uid ? { uid: ready.uid } : {} }
|
|
15
|
-
* ```
|
|
16
|
-
* 而 `refreshStepOAuth()` 的全部实现是:
|
|
17
|
-
* ```js
|
|
18
|
-
* if (credentials.refresh !== STEP_STATIC_REFRESH_TOKEN)
|
|
19
|
-
* throw new Error("This Step credential cannot be refreshed. Run `step login` again.")
|
|
20
|
-
* return { ...credentials, expires: Number.MAX_SAFE_INTEGER }
|
|
21
|
-
* ```
|
|
22
|
-
*
|
|
23
|
-
* ⇒ 三个结论,**都不要凭直觉改**:
|
|
24
|
-
* 1. 订阅登录换来的**就是一个 API Key**(不是 access/refresh token 对);
|
|
25
|
-
* 2. 那个 `refresh` 字段是**哨兵字符串**,只用于「判断这份凭据是不是 Step 的」,
|
|
26
|
-
* **不能**拿去请求任何续期端点(不存在这样的端点);
|
|
27
|
-
* 3. `expires` 恒为 `Number.MAX_SAFE_INTEGER` ⇒ **永不过期**。
|
|
28
|
-
*
|
|
29
|
-
* 故本 provider 与 `teleagent` / `loomy` / `zcode` 同类:
|
|
30
|
-
* {@link isStepcodeRefreshable} 恒 `false`,`refresh()` 退化为「探测有效性」。
|
|
31
|
-
* ⚠️ 把账号池占位条目的 `refreshable` 写成 `true` 会让定时器每 30 分钟
|
|
32
|
-
* 对一个不可能成功的操作发一轮请求(AGENTS.md 在 teleagent 上记过这条)。
|
|
33
|
-
*/
|
|
34
|
-
import { type StepcodeFallbackModel, type StepcodeProduct } from './stepcode-product.js';
|
|
35
|
-
/**
|
|
36
|
-
* 官方哨兵 refresh 值(bundle `STEP_STATIC_REFRESH_TOKEN`)。
|
|
37
|
-
*
|
|
38
|
-
* ⚠️ **它不是令牌**,只是一个「这份凭据来自 Step 订阅登录」的标记。
|
|
39
|
-
* 持久化它是为了与官方 `auth.json` 的形状对齐(官方 `type:"oauth"` 条目
|
|
40
|
-
* 里就存着这个值),且将来若官方真的加了续期端点,判据现成。
|
|
41
|
-
*/
|
|
42
|
-
export declare const STEPCODE_STATIC_REFRESH_TOKEN = "step-static-credential";
|
|
43
|
-
/** Step Code 凭据(存进 `ctx.credentials` 的 JSON 形状)。 */
|
|
44
|
-
export interface StepcodeCredential {
|
|
45
|
-
/**
|
|
46
|
-
* 订阅 API Key(官方 `credential.api_key`)。
|
|
47
|
-
*
|
|
48
|
-
* ⚠️ **字段名必须是 `access_token`** —— `AccountPool.findAccountIdByCredential`
|
|
49
|
-
* 对非 `codearts` 的 provider 统一取这个字段作账号身份标识
|
|
50
|
-
* (`docs/adding-a-new-provider.md`「凭据结构」硬性契约)。
|
|
51
|
-
* 换个名字会让「同 key 重复登录」判重失效,池里长出重复账号。
|
|
52
|
-
*/
|
|
53
|
-
access_token: string;
|
|
54
|
-
/**
|
|
55
|
-
* 账号标识(官方 `readBoundedUid(readString(payload, "uid"))`)。
|
|
56
|
-
*
|
|
57
|
-
* ⚠️ `uid` 在 poll 响应的**顶层**,不在 `credential` 里 —— 别去
|
|
58
|
-
* `credential.uid` 找(那里没有,会静默丢失账号名)。
|
|
59
|
-
*/
|
|
60
|
-
uid?: string;
|
|
61
|
-
/** 登录时上报的 profile(决定区域;见 {@link StepcodeProduct.authBase})。 */
|
|
62
|
-
profile?: string;
|
|
63
|
-
/**
|
|
64
|
-
* 过期时间(毫秒时间戳字符串)。
|
|
65
|
-
*
|
|
66
|
-
* ⚠️ 静态凭据**永不过期** ⇒ 正常路径下**不写这个字段**。
|
|
67
|
-
* 保留它是为了兼容「用户手写的凭据」与将来的服务端变更;
|
|
68
|
-
* {@link isStepcodeExpired} 在两者都读不到时**保守判未过期**
|
|
69
|
-
* (判成已过期会让每次发消息都先触发一次必然无效的续期探测 ——
|
|
70
|
-
* 与 teleagent 的同款取舍一致)。
|
|
71
|
-
*/
|
|
72
|
-
expires_at?: string;
|
|
73
|
-
/** 展示用昵称(当前无来源端点,留空即用 uid)。 */
|
|
74
|
-
nickname?: string;
|
|
75
|
-
/** 官方哨兵 refresh 标记(见 {@link STEPCODE_STATIC_REFRESH_TOKEN})。 */
|
|
76
|
-
refresh?: string;
|
|
77
|
-
}
|
|
78
|
-
/**
|
|
79
|
-
* 解析凭据 JSON;形状不对返回 `undefined`(**不抛错**)。
|
|
80
|
-
*
|
|
81
|
-
* ⚠️ 判据是 `access_token` 非空 —— 它是唯一必需字段。
|
|
82
|
-
* 官方 `readStepBearerToken()` 对 `type:"oauth"` 取 `access`、
|
|
83
|
-
* 对 `type:"api_key"` 取 `key`;我们统一存成 `access_token`
|
|
84
|
-
* (见该字段的注释:账号池判重依赖这个名字)。
|
|
85
|
-
*/
|
|
86
|
-
export declare function parseStepcodeCredential(value: string): StepcodeCredential | undefined;
|
|
87
|
-
/**
|
|
88
|
-
* 凭据过期时刻(毫秒);读不到返回 `undefined`。
|
|
89
|
-
*
|
|
90
|
-
* ⚠️ 静态凭据正常没有 `expires_at` ⇒ 返回 `undefined`(「未知」),
|
|
91
|
-
* **不是** `0`(那会被当成 1970 年、恒判已过期)。
|
|
92
|
-
*/
|
|
93
|
-
export declare function stepcodeCredentialExpiresAtMs(credential: StepcodeCredential): number | undefined;
|
|
94
|
-
/**
|
|
95
|
-
* 是否已过期。
|
|
96
|
-
*
|
|
97
|
-
* ⚠️ **读不到过期时间时保守判「未过期」** —— 官方给这类凭据的
|
|
98
|
-
* `expires` 就是 `Number.MAX_SAFE_INTEGER`。判成已过期会让每次发消息
|
|
99
|
-
* 都先触发一次必然失败的续期探测(本 provider 没有续期端点)。
|
|
100
|
-
*/
|
|
101
|
-
export declare function isStepcodeExpired(credential: StepcodeCredential): boolean;
|
|
102
|
-
/**
|
|
103
|
-
* 是否可续期 —— **恒 `false`**。
|
|
104
|
-
*
|
|
105
|
-
* ⚠️ 不要「优化」成 `true`:官方 `refreshStepOAuth()` 不发任何请求,
|
|
106
|
-
* 只是校验哨兵值后原样返回。详见模块头。
|
|
107
|
-
*/
|
|
108
|
-
export declare function isStepcodeRefreshable(_credential: StepcodeCredential): boolean;
|
|
109
|
-
/**
|
|
110
|
-
* 推理/目录请求头。
|
|
111
|
-
*
|
|
112
|
-
* 只有一个 `Authorization: Bearer <api_key>`。
|
|
113
|
-
*
|
|
114
|
-
* ⚠️ **没有**渠道密钥、**没有**签名、**没有**归属头 —— 这是 Step Code
|
|
115
|
-
* 与 teleagent(双凭据头 + HMAC 签名)、qoder(WASM 签名)最大的差异,
|
|
116
|
-
* 也是它最不容易出错的地方。**不要**照抄别家的头集合
|
|
117
|
-
* (多发的头可能被网关拒,AGENTS.md 在 TRAE 那条记过
|
|
118
|
-
* 「`content-type` 被叠成重复值 → 400」的教训)。
|
|
119
|
-
*/
|
|
120
|
-
export declare function stepcodeAuthHeaders(credential: StepcodeCredential): Record<string, string>;
|
|
121
|
-
/** 生成登录用的 poll token(官方 `randomBytes(32).toString("hex")` → 64 位 hex)。 */
|
|
122
|
-
export declare function generateStepcodePollToken(): string;
|
|
123
|
-
/**
|
|
124
|
-
* `flow_id` 合法性判据(bundle `FLOW_ID_PATTERN = /^[A-Za-z0-9._-]{1,128}$/u`)。
|
|
125
|
-
*
|
|
126
|
-
* ⚠️ 必须校验:官方在 init 与 poll **两处**都校,因为它会被拼进 URL 路径
|
|
127
|
-
* (`/poll/{flow_id}`)—— 不校验就等于把服务端返回值直接注入自己的请求路径。
|
|
128
|
-
*/
|
|
129
|
-
export declare const STEPCODE_FLOW_ID_PATTERN: RegExp;
|
|
130
|
-
/** `flow_id` 是否合法。 */
|
|
131
|
-
export declare function isValidStepcodeFlowId(value: unknown): value is string;
|
|
132
|
-
/**
|
|
133
|
-
* `uid` 归一(bundle `readBoundedUid`:≤64 字符且 `/^[\w.@:-]+$/u`,否则丢弃)。
|
|
134
|
-
*
|
|
135
|
-
* ⚠️ 同样是「服务端返回值会进本地存储/展示」的输入校验,不要放宽。
|
|
136
|
-
*/
|
|
137
|
-
export declare function normalizeStepcodeUid(value: unknown): string | undefined;
|
|
138
|
-
/**
|
|
139
|
-
* 从服务端信封里提取错误详情(bundle `envelopeDetail`:取 `desc` 字段,
|
|
140
|
-
* 剥掉控制字符后截断到 {@link STEPCODE_MAX_ERROR_DETAIL_LENGTH})。
|
|
141
|
-
*
|
|
142
|
-
* ⚠️ Step 的业务错误**不放在 HTTP 状态码里**,而是 HTTP 200 +
|
|
143
|
-
* `{ status: <非 0>, desc: "..." }`。只看 `response.ok` 会把这类失败
|
|
144
|
-
* 当成成功(与 Qoder「错误帧必须能抛错」是同型缺陷)。
|
|
145
|
-
*/
|
|
146
|
-
export declare function stepcodeEnvelopeDetail(payload: unknown): string;
|
|
147
|
-
/**
|
|
148
|
-
* 信封是否表示失败(官方判据:`payload.status !== undefined && payload.status !== 0`)。
|
|
149
|
-
*
|
|
150
|
-
* ⚠️ **`status` 缺席不算失败** —— 官方就是这么写的:poll 的成功响应
|
|
151
|
-
* 可能根本没有 `status` 字段。写成 `status !== 0` 会把正常响应全判成失败。
|
|
152
|
-
*/
|
|
153
|
-
export declare function isStepcodeEnvelopeError(payload: unknown): boolean;
|
|
154
|
-
/** 归一后的模型条目(远端与兜底**共用**的形状)。 */
|
|
155
|
-
export interface StepcodeModelEntry {
|
|
156
|
-
id: string;
|
|
157
|
-
/**
|
|
158
|
-
* 展示名。
|
|
159
|
-
*
|
|
160
|
-
* ⚠️ 官方 `stepModelConfig(entry.id, entry.id, …)` 把 **id 同时当 name**
|
|
161
|
-
* (远端 `/v1/models` 不下发独立展示名)。我们照此办理 ——
|
|
162
|
-
* **不编造**「Step 5 Preview」这类好看的中文名,因为拿不到权威来源
|
|
163
|
-
* (AGENTS.md 在 Qoder 上记过「展示名不能只写厂商」的教训,
|
|
164
|
-
* 但那条的前提是**目录里有真实展示名**;这里没有)。
|
|
165
|
-
*/
|
|
166
|
-
name: string;
|
|
167
|
-
/**
|
|
168
|
-
* 上下文窗口(远端 `max_input_tokens`)。
|
|
169
|
-
*
|
|
170
|
-
* **`0` 是「未知」哨兵**,不是合法窗口 —— `resolveModel` 必须判 `> 0`
|
|
171
|
-
* 才声明(与 teleagent / minimax 同口径)。
|
|
172
|
-
*/
|
|
173
|
-
contextWindow: number;
|
|
174
|
-
/** 是否支持图片输入(远端 `enable_vision_input`)。 */
|
|
175
|
-
supportsImage: boolean;
|
|
176
|
-
/** 是否支持思考(远端 `enable_reason`)。 */
|
|
177
|
-
reasoning: boolean;
|
|
178
|
-
/**
|
|
179
|
-
* 支持的思考档位(远端 `reasoning_effort_support_list`)。
|
|
180
|
-
*
|
|
181
|
-
* ⚠️ 空/缺失时**整个键不产出**(`undefined`),而不是给空数组 ——
|
|
182
|
-
* 调用方据「有没有这个键」决定是否声明 `reasoning`。
|
|
183
|
-
*/
|
|
184
|
-
efforts?: readonly string[];
|
|
185
|
-
/** 服务端下发的模型类型(用于白名单过滤,展示不用)。 */
|
|
186
|
-
modelType?: string;
|
|
187
|
-
}
|
|
188
|
-
/**
|
|
189
|
-
* 把**远端**目录条目归一。
|
|
190
|
-
*
|
|
191
|
-
* 字段名逐字对应官方 `fetchStepModels` 的解析:
|
|
192
|
-
* `id` / `model_type` / `max_input_tokens` / `enable_reason` /
|
|
193
|
-
* `enable_vision_input` / `reasoning_effort_support_list`。
|
|
194
|
-
*
|
|
195
|
-
* ⚠️ 解析不出 `id` ⇒ `undefined`(**不编造**,由调用方过滤)。
|
|
196
|
-
* ⚠️ `reasoning_effort_support_list` 只保留**非空字符串**项
|
|
197
|
-
* (官方 `readStringArray` 的 `filter(v => typeof v === "string" && v.trim())`),
|
|
198
|
-
* 且过滤后为空 ⇒ 整个键不产出。
|
|
199
|
-
*/
|
|
200
|
-
export declare function normalizeStepcodeModel(raw: unknown): StepcodeModelEntry | undefined;
|
|
201
|
-
/**
|
|
202
|
-
* 按官方口径过滤 + 去重远端目录。
|
|
203
|
-
*
|
|
204
|
-
* 复刻 `fetchStepModels` 的两步:
|
|
205
|
-
* 1. **条件式**类型过滤(只有当**至少一个**条目带 `model_type` 时才启用白名单);
|
|
206
|
-
* 2. 按 `id` 去重,保留首次出现。
|
|
207
|
-
*
|
|
208
|
-
* ⚠️ 第 1 步的「条件式」是关键,见 {@link STEPCODE_USABLE_MODEL_TYPES} 的注释。
|
|
209
|
-
*/
|
|
210
|
-
export declare function filterStepcodeModels(entries: readonly StepcodeModelEntry[]): readonly StepcodeModelEntry[];
|
|
211
|
-
/**
|
|
212
|
-
* 解析远端 `/v1/models` 响应体。
|
|
213
|
-
*
|
|
214
|
-
* 官方只认 `{ data: [...] }`(`Array.isArray(payload.data) ? payload.data : []`),
|
|
215
|
-
* 非对象条目直接跳过。失败一律返回 `[]`(**不抛错**)——
|
|
216
|
-
* 目录是展示信息,不该让整个 provider 报错。
|
|
217
|
-
*/
|
|
218
|
-
export declare function parseStepcodeModelsPayload(payload: unknown): readonly StepcodeModelEntry[];
|
|
219
|
-
/** 兜底表条目转归一形状(**直接搬运字面量**,不走远端归一规则)。 */
|
|
220
|
-
export declare function stepcodeFallbackToEntry(model: StepcodeFallbackModel): StepcodeModelEntry;
|
|
221
|
-
/** 默认产品下的兜底条目(当前为空表,见 {@link StepcodeProduct.fallbackModels})。 */
|
|
222
|
-
export declare function stepcodeFallbackEntries(product?: StepcodeProduct): readonly StepcodeModelEntry[];
|
|
223
|
-
/**
|
|
224
|
-
* 官方 `readStepBearerToken()` 的等价实现:从凭据里取 Bearer 值。
|
|
225
|
-
*
|
|
226
|
-
* ⚠️ 空串必须归一成 `undefined`(官方 `.trim() || undefined`)——
|
|
227
|
-
* 否则调用方会把 `Bearer ` 发出去,拿到一个语焉不详的 401。
|
|
228
|
-
*/
|
|
229
|
-
export declare function stepcodeBearerToken(credential: StepcodeCredential | undefined): string | undefined;
|
|
230
|
-
//# sourceMappingURL=stepcode.d.ts.map
|
package/lib/stepcode.d.ts.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"stepcode.d.ts","sourceRoot":"","sources":["../src/stepcode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,EAKL,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAA;AAE9B;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,2BAA2B,CAAA;AAErE,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAmBD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAUrF;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,kBAAkB,GAC7B,MAAM,GAAG,SAAS,CAKpB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAIzE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,kBAAkB,GAAG,OAAO,CAE9E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAK1F;AAED,0EAA0E;AAC1E,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,QAA6B,CAAA;AAElE,sBAAsB;AACtB,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAErE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAKvE;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAM/D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAIjE;AAED,gCAAgC;AAChC,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV;;;;;;;;OAQG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;OAKG;IACH,aAAa,EAAE,MAAM,CAAA;IACrB,0CAA0C;IAC1C,aAAa,EAAE,OAAO,CAAA;IACtB,kCAAkC;IAClC,SAAS,EAAE,OAAO,CAAA;IAClB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CA2BnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,kBAAkB,EAAE,GACrC,SAAS,kBAAkB,EAAE,CAe/B;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,kBAAkB,EAAE,CAU1F;AAED,wCAAwC;AACxC,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,qBAAqB,GAAG,kBAAkB,CAYxF;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,eAA0B,GAClC,SAAS,kBAAkB,EAAE,CAE/B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,kBAAkB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAIlG"}
|
package/lib/stepcode.js
DELETED
|
@@ -1,300 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Step Code(阶跃星辰)协议层:常量、凭据结构与**纯函数**。
|
|
3
|
-
*
|
|
4
|
-
* 本文件**不发任何网络请求**(登录流程在 `stepcode-oauth.ts`,
|
|
5
|
-
* 服务编排在 `stepcode-auth.ts`),因此可完整单测。
|
|
6
|
-
*
|
|
7
|
-
* ## 凭据形态:静态 api_key,**没有真实续期**
|
|
8
|
-
*
|
|
9
|
-
* 官方 `loginStepOAuth()` 在轮询到 `state:"ready"` 后返回:
|
|
10
|
-
* ```js
|
|
11
|
-
* { access: ready.apiKey,
|
|
12
|
-
* refresh: STEP_STATIC_REFRESH_TOKEN, // "step-static-credential"
|
|
13
|
-
* expires: Number.MAX_SAFE_INTEGER,
|
|
14
|
-
* ...ready.uid ? { uid: ready.uid } : {} }
|
|
15
|
-
* ```
|
|
16
|
-
* 而 `refreshStepOAuth()` 的全部实现是:
|
|
17
|
-
* ```js
|
|
18
|
-
* if (credentials.refresh !== STEP_STATIC_REFRESH_TOKEN)
|
|
19
|
-
* throw new Error("This Step credential cannot be refreshed. Run `step login` again.")
|
|
20
|
-
* return { ...credentials, expires: Number.MAX_SAFE_INTEGER }
|
|
21
|
-
* ```
|
|
22
|
-
*
|
|
23
|
-
* ⇒ 三个结论,**都不要凭直觉改**:
|
|
24
|
-
* 1. 订阅登录换来的**就是一个 API Key**(不是 access/refresh token 对);
|
|
25
|
-
* 2. 那个 `refresh` 字段是**哨兵字符串**,只用于「判断这份凭据是不是 Step 的」,
|
|
26
|
-
* **不能**拿去请求任何续期端点(不存在这样的端点);
|
|
27
|
-
* 3. `expires` 恒为 `Number.MAX_SAFE_INTEGER` ⇒ **永不过期**。
|
|
28
|
-
*
|
|
29
|
-
* 故本 provider 与 `teleagent` / `loomy` / `zcode` 同类:
|
|
30
|
-
* {@link isStepcodeRefreshable} 恒 `false`,`refresh()` 退化为「探测有效性」。
|
|
31
|
-
* ⚠️ 把账号池占位条目的 `refreshable` 写成 `true` 会让定时器每 30 分钟
|
|
32
|
-
* 对一个不可能成功的操作发一轮请求(AGENTS.md 在 teleagent 上记过这条)。
|
|
33
|
-
*/
|
|
34
|
-
import { randomBytes } from 'node:crypto';
|
|
35
|
-
import { STEPCODE, STEPCODE_DEFAULT_CONTEXT_WINDOW, STEPCODE_MAX_ERROR_DETAIL_LENGTH, STEPCODE_USABLE_MODEL_TYPES, } from './stepcode-product.js';
|
|
36
|
-
/**
|
|
37
|
-
* 官方哨兵 refresh 值(bundle `STEP_STATIC_REFRESH_TOKEN`)。
|
|
38
|
-
*
|
|
39
|
-
* ⚠️ **它不是令牌**,只是一个「这份凭据来自 Step 订阅登录」的标记。
|
|
40
|
-
* 持久化它是为了与官方 `auth.json` 的形状对齐(官方 `type:"oauth"` 条目
|
|
41
|
-
* 里就存着这个值),且将来若官方真的加了续期端点,判据现成。
|
|
42
|
-
*/
|
|
43
|
-
export const STEPCODE_STATIC_REFRESH_TOKEN = 'step-static-credential';
|
|
44
|
-
/** 非空字符串归一(trim 后为空则 undefined)。 */
|
|
45
|
-
function nonEmptyString(value) {
|
|
46
|
-
return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
|
|
47
|
-
}
|
|
48
|
-
/** 只放行**安全正整数**。 */
|
|
49
|
-
function positiveInt(value) {
|
|
50
|
-
return typeof value === 'number' && Number.isFinite(value) && Number.isSafeInteger(value) && value > 0
|
|
51
|
-
? value
|
|
52
|
-
: undefined;
|
|
53
|
-
}
|
|
54
|
-
/** 只放行布尔(官方 `readBoolean`:非布尔一律 undefined,不做真值转换)。 */
|
|
55
|
-
function optionalBoolean(value) {
|
|
56
|
-
return typeof value === 'boolean' ? value : undefined;
|
|
57
|
-
}
|
|
58
|
-
/**
|
|
59
|
-
* 解析凭据 JSON;形状不对返回 `undefined`(**不抛错**)。
|
|
60
|
-
*
|
|
61
|
-
* ⚠️ 判据是 `access_token` 非空 —— 它是唯一必需字段。
|
|
62
|
-
* 官方 `readStepBearerToken()` 对 `type:"oauth"` 取 `access`、
|
|
63
|
-
* 对 `type:"api_key"` 取 `key`;我们统一存成 `access_token`
|
|
64
|
-
* (见该字段的注释:账号池判重依赖这个名字)。
|
|
65
|
-
*/
|
|
66
|
-
export function parseStepcodeCredential(value) {
|
|
67
|
-
try {
|
|
68
|
-
const parsed = JSON.parse(value);
|
|
69
|
-
return typeof parsed === 'object' && parsed !== null
|
|
70
|
-
&& nonEmptyString(parsed.access_token) !== undefined
|
|
71
|
-
? parsed
|
|
72
|
-
: undefined;
|
|
73
|
-
}
|
|
74
|
-
catch {
|
|
75
|
-
return undefined;
|
|
76
|
-
}
|
|
77
|
-
}
|
|
78
|
-
/**
|
|
79
|
-
* 凭据过期时刻(毫秒);读不到返回 `undefined`。
|
|
80
|
-
*
|
|
81
|
-
* ⚠️ 静态凭据正常没有 `expires_at` ⇒ 返回 `undefined`(「未知」),
|
|
82
|
-
* **不是** `0`(那会被当成 1970 年、恒判已过期)。
|
|
83
|
-
*/
|
|
84
|
-
export function stepcodeCredentialExpiresAtMs(credential) {
|
|
85
|
-
const raw = nonEmptyString(credential.expires_at);
|
|
86
|
-
if (raw === undefined)
|
|
87
|
-
return undefined;
|
|
88
|
-
const parsed = Number(raw);
|
|
89
|
-
return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
|
|
90
|
-
}
|
|
91
|
-
/**
|
|
92
|
-
* 是否已过期。
|
|
93
|
-
*
|
|
94
|
-
* ⚠️ **读不到过期时间时保守判「未过期」** —— 官方给这类凭据的
|
|
95
|
-
* `expires` 就是 `Number.MAX_SAFE_INTEGER`。判成已过期会让每次发消息
|
|
96
|
-
* 都先触发一次必然失败的续期探测(本 provider 没有续期端点)。
|
|
97
|
-
*/
|
|
98
|
-
export function isStepcodeExpired(credential) {
|
|
99
|
-
const expiresAt = stepcodeCredentialExpiresAtMs(credential);
|
|
100
|
-
if (expiresAt === undefined)
|
|
101
|
-
return false;
|
|
102
|
-
return expiresAt <= Date.now();
|
|
103
|
-
}
|
|
104
|
-
/**
|
|
105
|
-
* 是否可续期 —— **恒 `false`**。
|
|
106
|
-
*
|
|
107
|
-
* ⚠️ 不要「优化」成 `true`:官方 `refreshStepOAuth()` 不发任何请求,
|
|
108
|
-
* 只是校验哨兵值后原样返回。详见模块头。
|
|
109
|
-
*/
|
|
110
|
-
export function isStepcodeRefreshable(_credential) {
|
|
111
|
-
return false;
|
|
112
|
-
}
|
|
113
|
-
/**
|
|
114
|
-
* 推理/目录请求头。
|
|
115
|
-
*
|
|
116
|
-
* 只有一个 `Authorization: Bearer <api_key>`。
|
|
117
|
-
*
|
|
118
|
-
* ⚠️ **没有**渠道密钥、**没有**签名、**没有**归属头 —— 这是 Step Code
|
|
119
|
-
* 与 teleagent(双凭据头 + HMAC 签名)、qoder(WASM 签名)最大的差异,
|
|
120
|
-
* 也是它最不容易出错的地方。**不要**照抄别家的头集合
|
|
121
|
-
* (多发的头可能被网关拒,AGENTS.md 在 TRAE 那条记过
|
|
122
|
-
* 「`content-type` 被叠成重复值 → 400」的教训)。
|
|
123
|
-
*/
|
|
124
|
-
export function stepcodeAuthHeaders(credential) {
|
|
125
|
-
return {
|
|
126
|
-
accept: 'application/json',
|
|
127
|
-
authorization: `Bearer ${credential.access_token.trim()}`,
|
|
128
|
-
};
|
|
129
|
-
}
|
|
130
|
-
/** 生成登录用的 poll token(官方 `randomBytes(32).toString("hex")` → 64 位 hex)。 */
|
|
131
|
-
export function generateStepcodePollToken() {
|
|
132
|
-
return randomBytes(32).toString('hex');
|
|
133
|
-
}
|
|
134
|
-
/**
|
|
135
|
-
* `flow_id` 合法性判据(bundle `FLOW_ID_PATTERN = /^[A-Za-z0-9._-]{1,128}$/u`)。
|
|
136
|
-
*
|
|
137
|
-
* ⚠️ 必须校验:官方在 init 与 poll **两处**都校,因为它会被拼进 URL 路径
|
|
138
|
-
* (`/poll/{flow_id}`)—— 不校验就等于把服务端返回值直接注入自己的请求路径。
|
|
139
|
-
*/
|
|
140
|
-
export const STEPCODE_FLOW_ID_PATTERN = /^[A-Za-z0-9._-]{1,128}$/u;
|
|
141
|
-
/** `flow_id` 是否合法。 */
|
|
142
|
-
export function isValidStepcodeFlowId(value) {
|
|
143
|
-
return typeof value === 'string' && STEPCODE_FLOW_ID_PATTERN.test(value);
|
|
144
|
-
}
|
|
145
|
-
/**
|
|
146
|
-
* `uid` 归一(bundle `readBoundedUid`:≤64 字符且 `/^[\w.@:-]+$/u`,否则丢弃)。
|
|
147
|
-
*
|
|
148
|
-
* ⚠️ 同样是「服务端返回值会进本地存储/展示」的输入校验,不要放宽。
|
|
149
|
-
*/
|
|
150
|
-
export function normalizeStepcodeUid(value) {
|
|
151
|
-
const raw = nonEmptyString(value);
|
|
152
|
-
if (raw === undefined)
|
|
153
|
-
return undefined;
|
|
154
|
-
if (raw.length > 64)
|
|
155
|
-
return undefined;
|
|
156
|
-
return /^[\w.@:-]+$/u.test(raw) ? raw : undefined;
|
|
157
|
-
}
|
|
158
|
-
/**
|
|
159
|
-
* 从服务端信封里提取错误详情(bundle `envelopeDetail`:取 `desc` 字段,
|
|
160
|
-
* 剥掉控制字符后截断到 {@link STEPCODE_MAX_ERROR_DETAIL_LENGTH})。
|
|
161
|
-
*
|
|
162
|
-
* ⚠️ Step 的业务错误**不放在 HTTP 状态码里**,而是 HTTP 200 +
|
|
163
|
-
* `{ status: <非 0>, desc: "..." }`。只看 `response.ok` 会把这类失败
|
|
164
|
-
* 当成成功(与 Qoder「错误帧必须能抛错」是同型缺陷)。
|
|
165
|
-
*/
|
|
166
|
-
export function stepcodeEnvelopeDetail(payload) {
|
|
167
|
-
if (typeof payload !== 'object' || payload === null || Array.isArray(payload))
|
|
168
|
-
return '';
|
|
169
|
-
const desc = nonEmptyString(payload.desc);
|
|
170
|
-
if (desc === undefined)
|
|
171
|
-
return '';
|
|
172
|
-
// \p{Cc} 控制字符 + \p{Cf} 格式字符(官方同款),防止把终端转义序列带进日志/UI。
|
|
173
|
-
return desc.replace(/[\p{Cc}\p{Cf}]/gu, '').slice(0, STEPCODE_MAX_ERROR_DETAIL_LENGTH);
|
|
174
|
-
}
|
|
175
|
-
/**
|
|
176
|
-
* 信封是否表示失败(官方判据:`payload.status !== undefined && payload.status !== 0`)。
|
|
177
|
-
*
|
|
178
|
-
* ⚠️ **`status` 缺席不算失败** —— 官方就是这么写的:poll 的成功响应
|
|
179
|
-
* 可能根本没有 `status` 字段。写成 `status !== 0` 会把正常响应全判成失败。
|
|
180
|
-
*/
|
|
181
|
-
export function isStepcodeEnvelopeError(payload) {
|
|
182
|
-
if (typeof payload !== 'object' || payload === null || Array.isArray(payload))
|
|
183
|
-
return false;
|
|
184
|
-
const status = payload.status;
|
|
185
|
-
return status !== undefined && status !== 0;
|
|
186
|
-
}
|
|
187
|
-
/**
|
|
188
|
-
* 把**远端**目录条目归一。
|
|
189
|
-
*
|
|
190
|
-
* 字段名逐字对应官方 `fetchStepModels` 的解析:
|
|
191
|
-
* `id` / `model_type` / `max_input_tokens` / `enable_reason` /
|
|
192
|
-
* `enable_vision_input` / `reasoning_effort_support_list`。
|
|
193
|
-
*
|
|
194
|
-
* ⚠️ 解析不出 `id` ⇒ `undefined`(**不编造**,由调用方过滤)。
|
|
195
|
-
* ⚠️ `reasoning_effort_support_list` 只保留**非空字符串**项
|
|
196
|
-
* (官方 `readStringArray` 的 `filter(v => typeof v === "string" && v.trim())`),
|
|
197
|
-
* 且过滤后为空 ⇒ 整个键不产出。
|
|
198
|
-
*/
|
|
199
|
-
export function normalizeStepcodeModel(raw) {
|
|
200
|
-
if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
|
|
201
|
-
return undefined;
|
|
202
|
-
const record = raw;
|
|
203
|
-
const id = nonEmptyString(record.id);
|
|
204
|
-
if (id === undefined)
|
|
205
|
-
return undefined;
|
|
206
|
-
const efforts = Array.isArray(record.reasoning_effort_support_list)
|
|
207
|
-
? record.reasoning_effort_support_list.filter((value) => typeof value === 'string' && value.trim().length > 0).map((value) => value.trim())
|
|
208
|
-
: undefined;
|
|
209
|
-
const reasoning = optionalBoolean(record.enable_reason);
|
|
210
|
-
return {
|
|
211
|
-
id,
|
|
212
|
-
name: id,
|
|
213
|
-
// 远端没给窗口时用官方默认值(`STEP_MODEL_DEFAULTS.contextWindow = 256000`)。
|
|
214
|
-
contextWindow: positiveInt(record.max_input_tokens) ?? STEPCODE_DEFAULT_CONTEXT_WINDOW,
|
|
215
|
-
supportsImage: optionalBoolean(record.enable_vision_input) === true,
|
|
216
|
-
// ⚠️ 官方口径:`reasoning: meta?.reasoning ?? (hasEfforts ? true : STEP_MODEL_DEFAULTS.reasoning)`
|
|
217
|
-
// —— 有档位就认为支持思考,否则用默认 false。照抄这条推论链,
|
|
218
|
-
// 不要简化成 `record.enable_reason === true`(会在服务端只下发档位
|
|
219
|
-
// 而漏发 enable_reason 时把思考能力判没)。
|
|
220
|
-
reasoning: reasoning ?? (efforts !== undefined && efforts.length > 0 ? true : false),
|
|
221
|
-
...efforts !== undefined && efforts.length > 0 ? { efforts: Object.freeze(efforts) } : {},
|
|
222
|
-
...nonEmptyString(record.model_type) === undefined ? {} : { modelType: nonEmptyString(record.model_type) },
|
|
223
|
-
};
|
|
224
|
-
}
|
|
225
|
-
/**
|
|
226
|
-
* 按官方口径过滤 + 去重远端目录。
|
|
227
|
-
*
|
|
228
|
-
* 复刻 `fetchStepModels` 的两步:
|
|
229
|
-
* 1. **条件式**类型过滤(只有当**至少一个**条目带 `model_type` 时才启用白名单);
|
|
230
|
-
* 2. 按 `id` 去重,保留首次出现。
|
|
231
|
-
*
|
|
232
|
-
* ⚠️ 第 1 步的「条件式」是关键,见 {@link STEPCODE_USABLE_MODEL_TYPES} 的注释。
|
|
233
|
-
*/
|
|
234
|
-
export function filterStepcodeModels(entries) {
|
|
235
|
-
const typed = entries.some((entry) => entry.modelType !== undefined);
|
|
236
|
-
const usable = typed
|
|
237
|
-
? entries.filter((entry) => entry.modelType !== undefined && STEPCODE_USABLE_MODEL_TYPES.has(entry.modelType))
|
|
238
|
-
: entries;
|
|
239
|
-
const seen = new Set();
|
|
240
|
-
const result = [];
|
|
241
|
-
for (const entry of usable) {
|
|
242
|
-
if (seen.has(entry.id))
|
|
243
|
-
continue;
|
|
244
|
-
seen.add(entry.id);
|
|
245
|
-
result.push(entry);
|
|
246
|
-
}
|
|
247
|
-
return result;
|
|
248
|
-
}
|
|
249
|
-
/**
|
|
250
|
-
* 解析远端 `/v1/models` 响应体。
|
|
251
|
-
*
|
|
252
|
-
* 官方只认 `{ data: [...] }`(`Array.isArray(payload.data) ? payload.data : []`),
|
|
253
|
-
* 非对象条目直接跳过。失败一律返回 `[]`(**不抛错**)——
|
|
254
|
-
* 目录是展示信息,不该让整个 provider 报错。
|
|
255
|
-
*/
|
|
256
|
-
export function parseStepcodeModelsPayload(payload) {
|
|
257
|
-
if (typeof payload !== 'object' || payload === null)
|
|
258
|
-
return [];
|
|
259
|
-
const data = payload.data;
|
|
260
|
-
if (!Array.isArray(data))
|
|
261
|
-
return [];
|
|
262
|
-
const entries = [];
|
|
263
|
-
for (const raw of data) {
|
|
264
|
-
const entry = normalizeStepcodeModel(raw);
|
|
265
|
-
if (entry !== undefined)
|
|
266
|
-
entries.push(entry);
|
|
267
|
-
}
|
|
268
|
-
return filterStepcodeModels(entries);
|
|
269
|
-
}
|
|
270
|
-
/** 兜底表条目转归一形状(**直接搬运字面量**,不走远端归一规则)。 */
|
|
271
|
-
export function stepcodeFallbackToEntry(model) {
|
|
272
|
-
return {
|
|
273
|
-
id: model.id,
|
|
274
|
-
name: model.name,
|
|
275
|
-
contextWindow: model.contextWindow,
|
|
276
|
-
supportsImage: model.supportsImage,
|
|
277
|
-
// 兜底表没有 enable_reason 字段:有档位即认为支持思考(与远端推论链一致)。
|
|
278
|
-
reasoning: model.efforts !== undefined && model.efforts.length > 0,
|
|
279
|
-
...model.efforts === undefined || model.efforts.length === 0
|
|
280
|
-
? {}
|
|
281
|
-
: { efforts: Object.freeze([...model.efforts]) },
|
|
282
|
-
};
|
|
283
|
-
}
|
|
284
|
-
/** 默认产品下的兜底条目(当前为空表,见 {@link StepcodeProduct.fallbackModels})。 */
|
|
285
|
-
export function stepcodeFallbackEntries(product = STEPCODE) {
|
|
286
|
-
return product.fallbackModels.map(stepcodeFallbackToEntry);
|
|
287
|
-
}
|
|
288
|
-
/**
|
|
289
|
-
* 官方 `readStepBearerToken()` 的等价实现:从凭据里取 Bearer 值。
|
|
290
|
-
*
|
|
291
|
-
* ⚠️ 空串必须归一成 `undefined`(官方 `.trim() || undefined`)——
|
|
292
|
-
* 否则调用方会把 `Bearer ` 发出去,拿到一个语焉不详的 401。
|
|
293
|
-
*/
|
|
294
|
-
export function stepcodeBearerToken(credential) {
|
|
295
|
-
if (credential === undefined)
|
|
296
|
-
return undefined;
|
|
297
|
-
const token = credential.access_token?.trim();
|
|
298
|
-
return token === undefined || token.length === 0 ? undefined : token;
|
|
299
|
-
}
|
|
300
|
-
//# sourceMappingURL=stepcode.js.map
|
package/lib/stepcode.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"stepcode.js","sourceRoot":"","sources":["../src/stepcode.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,108 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* TeleAgent 模型适配器。
|
|
3
|
-
*
|
|
4
|
-
* ## 协议族 = OpenAI 兼容(**无加密**)
|
|
5
|
-
*
|
|
6
|
-
* `POST {apiBase}/api/v1/chat/completions`,请求体是标准 OpenAI 形状,
|
|
7
|
-
* 响应是标准 SSE。⇒ 消息序列化与 SSE 消费**复用** `src/openai-compat.ts`
|
|
8
|
-
* (`serializeMessages` / `consumeOpenAiSse` / 错误归类),
|
|
9
|
-
* **不**新建 messages 层 —— 与 minimax(Anthropic Messages)、
|
|
10
|
-
* trae(SOLO 自定义事件)是本质差异,也是本 provider 最薄的一层。
|
|
11
|
-
*
|
|
12
|
-
* ## 两个凭据在两个头上(最容易踩的坑)
|
|
13
|
-
*
|
|
14
|
-
* - `Authorization: Bearer <内置 NewApi apiKey>` —— **渠道**身份(asar 硬编码);
|
|
15
|
-
* - `X-Token: <用户 token>` —— **用户**身份(决定谁的额度、谁的账号)。
|
|
16
|
-
*
|
|
17
|
-
* ⚠️ 把用户 token 塞进 Bearer 会 401。见 {@link teleagentInferHeaders}。
|
|
18
|
-
*
|
|
19
|
-
* ## 思考档位:**当前不声明**
|
|
20
|
-
*
|
|
21
|
-
* asar 的 `KG` 种子表(`chat-nano` / `chat-lite`)**没有**下发
|
|
22
|
-
* `thinking_config` / `effort_options`,档位/前沿模型的参数来自服务端目录缓存
|
|
23
|
-
* (我们尚未定位到其拉取端点)。⇒ `resolveModel` **不产出** `reasoning`,
|
|
24
|
-
* DSH 显示「当前模型未提供推理等级」。
|
|
25
|
-
*
|
|
26
|
-
* ⚠️ **不要**按截图或直觉给它们编档位 —— 与 Qoder「`qmodel` 没有档位就是没有,
|
|
27
|
-
* 不要猜」是同一条教训。拿到真实目录后一并补齐。
|
|
28
|
-
*
|
|
29
|
-
* ## 图片:**声明不支持即报错,不静默丢图**
|
|
30
|
-
*
|
|
31
|
-
* 兜底表 `supportsImage` 恒 false(未实测),故收到图片时抛
|
|
32
|
-
* `UNSUPPORTED_CONTENT`。静默丢图会让用户以为模型看到了图片
|
|
33
|
-
* (与 cline / lobsterai / minimax 的既有契约一致)。
|
|
34
|
-
*/
|
|
35
|
-
import { LlmAdapter } from '@deepseek-ai/dsh-llm';
|
|
36
|
-
import type { GenerateOptions, LlmModelInfo, LlmProviderInfo, LlmResolvedModelInfo, StreamChunk } from '@deepseek-ai/dsh-llm';
|
|
37
|
-
import type { Context } from '@deepseek-ai/cordis';
|
|
38
|
-
import type { CredentialRef } from '@deepseek-ai/dsh-credentials';
|
|
39
|
-
import type { AccountPool } from './account-pool.js';
|
|
40
|
-
import { type TeleagentProduct } from './teleagent-product.js';
|
|
41
|
-
import { type TeleagentCredential, type TeleagentModelEntry } from './teleagent.js';
|
|
42
|
-
/** {@link TeleagentAdapter} 的构造选项。 */
|
|
43
|
-
export interface TeleagentAdapterOptions {
|
|
44
|
-
/** 单凭据回退 ref(无账号池时)。 */
|
|
45
|
-
credentialRef: CredentialRef;
|
|
46
|
-
/** 解析当前可用凭据。 */
|
|
47
|
-
resolveCredential: (modelId?: string) => Promise<TeleagentCredential | undefined>;
|
|
48
|
-
/** 凭据失效时的处理(本 provider 是「探测有效性」)。 */
|
|
49
|
-
refresh: () => Promise<void>;
|
|
50
|
-
/** 拉取远端模型目录;失败/缺省时适配器回退兜底表。 */
|
|
51
|
-
fetchRemoteModels?: () => Promise<readonly TeleagentModelEntry[]>;
|
|
52
|
-
/** 账号池(目录门控与黑名单)。 */
|
|
53
|
-
accountPool?: AccountPool;
|
|
54
|
-
/**
|
|
55
|
-
* 内联一张图片(`ctx.attachments.readImage` 桥接)。
|
|
56
|
-
*
|
|
57
|
-
* ⚠️ 当前兜底表 `supportsImage` 恒 false,故本字段**实际不会被用到**;
|
|
58
|
-
* 保留它是为了「实测带图通过后只需改兜底表」,不必再动接线。
|
|
59
|
-
*/
|
|
60
|
-
readImage?: (attachment: unknown) => Promise<{
|
|
61
|
-
data: Uint8Array;
|
|
62
|
-
mediaType: string;
|
|
63
|
-
} | undefined>;
|
|
64
|
-
/** 产品配置;默认 {@link TELEAGENT}。 */
|
|
65
|
-
product?: TeleagentProduct;
|
|
66
|
-
}
|
|
67
|
-
/** TeleAgent 模型适配器。 */
|
|
68
|
-
export declare class TeleagentAdapter extends LlmAdapter {
|
|
69
|
-
private readonly options;
|
|
70
|
-
private readonly product;
|
|
71
|
-
private remoteModels;
|
|
72
|
-
constructor(options: TeleagentAdapterOptions);
|
|
73
|
-
providerInfo(provider: string): LlmProviderInfo;
|
|
74
|
-
/** 取(并缓存)模型目录;远端失败回退兜底表。 */
|
|
75
|
-
private loadModels;
|
|
76
|
-
/**
|
|
77
|
-
* 完整目录(**不套黑名单**),供 Jet Hub「显示列表」用。
|
|
78
|
-
*
|
|
79
|
-
* ⚠️ **必须同步返回数组,不能是 `async`**(minimax 接线时踩过的真实缺陷):
|
|
80
|
-
* `jet-hub-rpc.ts` 的两处消费者都不 await,返回 Promise 会让
|
|
81
|
-
* 「显示列表」与「关闭全部」同时崩(`all is not iterable`)。
|
|
82
|
-
* 读缓存是安全的:RPC 在调用本方法前已先 `await llm.listModels(provider)`,
|
|
83
|
-
* 而 `listModels` 内部会 `await loadModels()` 落缓存。
|
|
84
|
-
*/
|
|
85
|
-
listAllModels(): readonly {
|
|
86
|
-
id: string;
|
|
87
|
-
name: string;
|
|
88
|
-
}[];
|
|
89
|
-
private inputModalitiesFor;
|
|
90
|
-
listModels(_provider: string): Promise<readonly LlmModelInfo[]>;
|
|
91
|
-
resolveModel(provider: string, model: string, _signal?: AbortSignal): Promise<LlmResolvedModelInfo>;
|
|
92
|
-
/** 兼容 0.1.1-rc.2 的 `prepareCall` shim(与其余适配器同款)。 */
|
|
93
|
-
prepareCall(provider: string, model: string, signal?: AbortSignal): Promise<{
|
|
94
|
-
model: LlmResolvedModelInfo;
|
|
95
|
-
stream: (options: GenerateOptions) => AsyncIterable<StreamChunk>;
|
|
96
|
-
}>;
|
|
97
|
-
/**
|
|
98
|
-
* 发一次 OpenAI 兼容的流式请求。
|
|
99
|
-
*
|
|
100
|
-
* ⚠️ 凭据过期先静默探测一次(本 provider 无续期,探测失败即抛终态错误)。
|
|
101
|
-
* ⚠️ **错误必须抛错**,不静默返回空流(Qoder 早期的同型缺陷:
|
|
102
|
-
* UI 表现为「干净地停止、无任何报错」)。
|
|
103
|
-
*/
|
|
104
|
-
stream(options: GenerateOptions): AsyncIterable<StreamChunk>;
|
|
105
|
-
}
|
|
106
|
-
/** 在 `ctx.llm` 上注册 teleagent provider 路由与适配器。 */
|
|
107
|
-
export declare function registerTeleagentLlm(ctx: Context, options: TeleagentAdapterOptions): TeleagentAdapter;
|
|
108
|
-
//# sourceMappingURL=teleagent-adapter.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"teleagent-adapter.d.ts","sourceRoot":"","sources":["../src/teleagent-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,UAAU,EAAY,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,WAAW,EACZ,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAQpD,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACzB,MAAM,gBAAgB,CAAA;AAqBvB,sCAAsC;AACtC,MAAM,WAAW,uBAAuB;IACtC,wBAAwB;IACxB,aAAa,EAAE,aAAa,CAAA;IAC5B,gBAAgB;IAChB,iBAAiB,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAA;IACjF,qCAAqC;IACrC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,+BAA+B;IAC/B,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC,CAAA;IACjE,qBAAqB;IACrB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAA;IACjG,iCAAiC;IACjC,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAC3B;AAED,uBAAuB;AACvB,qBAAa,gBAAiB,SAAQ,UAAU;IAIlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,YAAY,CAA4C;gBAEnC,OAAO,EAAE,uBAAuB;IAK7D,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe;IAK/C,4BAA4B;YACd,UAAU;IAkBxB;;;;;;;;OAQG;IACH,aAAa,IAAI,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;IAKxD,OAAO,CAAC,kBAAkB;IAIpB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC;IAmB/D,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,oBAAoB,CAAC;IA0BhC,oDAAoD;IAC9C,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QACT,KAAK,EAAE,oBAAoB,CAAA;QAC3B,MAAM,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,aAAa,CAAC,WAAW,CAAC,CAAA;KACjE,CAAC;IAOF;;;;;;OAMG;IACI,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,CAAC,WAAW,CAAC;CAqHpE;AAED,iDAAiD;AACjD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,uBAAuB,GAC/B,gBAAgB,CAKlB"}
|