mslxdff 0.1.199 → 0.1.203

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 (327) hide show
  1. package/README.md +3 -3
  2. package/bin/mslxdff.js +1 -1
  3. package/package.json +38 -38
  4. package/plugins/README.md +14 -14
  5. package/plugins/prefer-model.mjs.example +14 -14
  6. package/src/anthropic/count-tokens.js +61 -61
  7. package/src/anthropic/request-body.js +126 -126
  8. package/src/anthropic/shared.js +18 -18
  9. package/src/anthropic/sse-aggregate.js +56 -56
  10. package/src/anthropic/translate.js +287 -287
  11. package/src/anthropic/web-search.js +361 -361
  12. package/src/api-kind.js +31 -31
  13. package/src/autostart.js +288 -288
  14. package/src/bench/probe.js +1 -1
  15. package/src/bench/runner.js +1 -1
  16. package/src/bench/via-probe.js +1 -1
  17. package/src/bench/via.js +144 -144
  18. package/src/bench/workbuddy-bench.js +1 -1
  19. package/src/chat/config.js +11 -11
  20. package/src/chat/cooling.js +81 -81
  21. package/src/chat/direct.js +58 -58
  22. package/src/chat/index.js +6 -6
  23. package/src/chat/spinner.js +38 -38
  24. package/src/chat/sse.js +69 -69
  25. package/src/chat/stats.js +247 -247
  26. package/src/chat/store.js +48 -48
  27. package/src/chat/tool-handlers.js +67 -67
  28. package/src/chat/tools.js +1 -1
  29. package/src/chat/upstream.js +59 -59
  30. package/src/chat-pipeline/auto-race.js +158 -158
  31. package/src/chat-pipeline/empty-turn.js +147 -147
  32. package/src/chat-pipeline/engine.js +17 -17
  33. package/src/chat-pipeline/serial-trial.js +283 -283
  34. package/src/chat-pipeline/terminal-verdict.js +147 -147
  35. package/src/chooser.js +54 -54
  36. package/src/claude-desktop/apply.js +101 -101
  37. package/src/claude-desktop/context1m.js +38 -38
  38. package/src/claude-desktop/doctor.js +146 -146
  39. package/src/claude-desktop/slots.js +152 -152
  40. package/src/cli/bootstrap.js +1 -1
  41. package/src/cli/commands/claude-desktop.js +284 -284
  42. package/src/cli/commands/daemon.js +231 -231
  43. package/src/cli/commands/model/list-live.js +22 -22
  44. package/src/cli/commands/model/list-providers.js +76 -76
  45. package/src/cli/commands/model/list-render.js +77 -77
  46. package/src/cli/commands/model/list-sort.js +52 -52
  47. package/src/cli/commands/model/list-tty.js +76 -76
  48. package/src/cli/commands/model/list.js +166 -166
  49. package/src/cli/commands/model/live-models.js +24 -24
  50. package/src/cli/commands/model/stats.js +43 -43
  51. package/src/cli/commands/model/status.js +47 -47
  52. package/src/cli/commands/model.js +51 -51
  53. package/src/cli/commands/provider/add.js +108 -108
  54. package/src/cli/commands/provider/allowlist.js +99 -99
  55. package/src/cli/commands/provider/cline-free.js +99 -99
  56. package/src/cli/commands/provider/cline-login.js +218 -218
  57. package/src/cli/commands/provider/cline-quota.js +65 -65
  58. package/src/cli/commands/provider/codearts-login.js +45 -45
  59. package/src/cli/commands/provider/config.js +119 -119
  60. package/src/cli/commands/provider/globalqwenwork-login.js +126 -126
  61. package/src/cli/commands/provider/keys-guard.js +50 -50
  62. package/src/cli/commands/provider/keys.js +161 -161
  63. package/src/cli/commands/provider/qoder-checkin.js +81 -81
  64. package/src/cli/commands/provider/qoder-login.js +102 -102
  65. package/src/cli/commands/provider/raccoon-login.js +180 -180
  66. package/src/cli/commands/provider/raccoon-password.js +162 -162
  67. package/src/cli/commands/provider/raccoon-quota.js +109 -109
  68. package/src/cli/commands/provider/traework-checkin.js +144 -144
  69. package/src/cli/commands/provider/traework-login.js +164 -164
  70. package/src/cli/commands/provider/workbuddy-login.js +153 -153
  71. package/src/cli/commands/provider/zcode-login.js +77 -77
  72. package/src/cli/commands/provider/zcode-quota.js +55 -55
  73. package/src/cli/commands/provider.js +1 -1
  74. package/src/cli/commands/stats.js +149 -149
  75. package/src/cli/commands/system.js +261 -261
  76. package/src/cli/commands/timezone.js +47 -47
  77. package/src/cli/commands/use-group.js +60 -60
  78. package/src/cli/commands/workbuddy.js +189 -189
  79. package/src/cli/format.js +141 -141
  80. package/src/cli/group-helpers.js +70 -70
  81. package/src/cli/help.js +80 -80
  82. package/src/cli/index.js +70 -70
  83. package/src/cli/interactive.js +121 -121
  84. package/src/cli/join-core.js +99 -99
  85. package/src/cli/join-wizard.js +175 -175
  86. package/src/cli/policy.js +136 -136
  87. package/src/cli/provider-row.js +126 -126
  88. package/src/cli/util.js +24 -24
  89. package/src/compat.js +53 -53
  90. package/src/events.js +38 -38
  91. package/src/free-lane.js +131 -131
  92. package/src/free-watcher.js +63 -63
  93. package/src/groups.js +262 -262
  94. package/src/logs.js +195 -195
  95. package/src/metrics.js +62 -62
  96. package/src/model-capabilities/context-lookup.js +65 -65
  97. package/src/model-capabilities/merge.js +142 -142
  98. package/src/model-trace.js +187 -187
  99. package/src/models.js +1 -1
  100. package/src/opencode-identity.js +72 -72
  101. package/src/peers.js +254 -251
  102. package/src/plugins.js +107 -107
  103. package/src/providers/base.js +164 -164
  104. package/src/providers/classify.js +22 -22
  105. package/src/providers/cline/allowlist-sync.js +93 -93
  106. package/src/providers/cline/free-catalog.js +71 -71
  107. package/src/providers/cline/headers.js +37 -37
  108. package/src/providers/cline/index.js +130 -130
  109. package/src/providers/cline/models.js +150 -150
  110. package/src/providers/cline/usage.js +274 -274
  111. package/src/providers/codearts/auth-pool.js +148 -148
  112. package/src/providers/codearts/concurrency.js +34 -34
  113. package/src/providers/codearts/const.js +65 -65
  114. package/src/providers/codearts/dpop.js +95 -95
  115. package/src/providers/codearts/index.js +175 -175
  116. package/src/providers/codearts/login.js +214 -214
  117. package/src/providers/codearts/models.js +182 -182
  118. package/src/providers/codearts/sign.js +96 -96
  119. package/src/providers/codearts/sse.js +204 -204
  120. package/src/providers/codearts/stream.js +209 -209
  121. package/src/providers/codearts/sts.js +124 -124
  122. package/src/providers/codearts.js +1 -1
  123. package/src/providers/dispatcher.js +146 -146
  124. package/src/providers/generic.js +156 -156
  125. package/src/providers/globalqwenwork/account-store.js +141 -141
  126. package/src/providers/globalqwenwork/constants.js +73 -73
  127. package/src/providers/globalqwenwork/crypto.js +2 -2
  128. package/src/providers/globalqwenwork/http.js +2 -2
  129. package/src/providers/globalqwenwork/index.js +331 -331
  130. package/src/providers/globalqwenwork/payload.js +147 -147
  131. package/src/providers/globalqwenwork/rsa.js +2 -2
  132. package/src/providers/globalqwenwork/sse.js +2 -2
  133. package/src/providers/globalqwenwork/stream.js +2 -2
  134. package/src/providers/globalqwenwork.js +1 -1
  135. package/src/providers/globalworkbuddy/account-store.js +198 -198
  136. package/src/providers/globalworkbuddy/auth.js +97 -97
  137. package/src/providers/globalworkbuddy/catalog.js +138 -138
  138. package/src/providers/globalworkbuddy/constants.js +73 -73
  139. package/src/providers/globalworkbuddy/device-auth.js +120 -120
  140. package/src/providers/globalworkbuddy/errors.js +98 -98
  141. package/src/providers/globalworkbuddy/headers.js +89 -89
  142. package/src/providers/globalworkbuddy/models.js +96 -96
  143. package/src/providers/globalworkbuddy/payload.js +80 -80
  144. package/src/providers/index.js +5 -5
  145. package/src/providers/model-id.js +172 -172
  146. package/src/providers/opencode.js +19 -19
  147. package/src/providers/openrouter.js +31 -31
  148. package/src/providers/qoder/account-store.js +106 -106
  149. package/src/providers/qoder/aggregate.js +60 -60
  150. package/src/providers/qoder/baseprompt.json +591 -591
  151. package/src/providers/qoder/checkin.js +160 -160
  152. package/src/providers/qoder/constants.js +44 -44
  153. package/src/providers/qoder/encode.js +41 -41
  154. package/src/providers/qoder/fingerprint.js +38 -38
  155. package/src/providers/qoder/models.js +77 -77
  156. package/src/providers/qoder/oauth.js +84 -84
  157. package/src/providers/qoder/payload.js +162 -162
  158. package/src/providers/qoder/request.js +27 -27
  159. package/src/providers/qoder/session.js +134 -134
  160. package/src/providers/qoder/sticky.js +38 -38
  161. package/src/providers/qoder/stream.js +116 -116
  162. package/src/providers/qoder.js +1 -1
  163. package/src/providers/raccoon/account-store.js +216 -216
  164. package/src/providers/raccoon/auth.js +67 -67
  165. package/src/providers/raccoon/chat.js +228 -228
  166. package/src/providers/raccoon/const.js +180 -165
  167. package/src/providers/raccoon/credits.js +185 -175
  168. package/src/providers/raccoon/crypto.js +43 -0
  169. package/src/providers/raccoon/envelope.js +31 -31
  170. package/src/providers/raccoon/headers.js +45 -45
  171. package/src/providers/raccoon/index.js +216 -216
  172. package/src/providers/raccoon/login.js +279 -279
  173. package/src/providers/raccoon/models.js +160 -160
  174. package/src/providers/raccoon/password-login.js +102 -87
  175. package/src/providers/raccoon/qr-codewords.js +115 -115
  176. package/src/providers/raccoon/qr.js +236 -236
  177. package/src/providers/raccoon/sse.js +135 -135
  178. package/src/providers/responses-channel.js +120 -120
  179. package/src/providers/share-keys.js +53 -53
  180. package/src/providers/traework/account-store.js +234 -234
  181. package/src/providers/traework/chat.js +217 -217
  182. package/src/providers/traework/checkin.js +77 -77
  183. package/src/providers/traework/constants.js +41 -41
  184. package/src/providers/traework/errors.js +52 -52
  185. package/src/providers/traework/headers.js +79 -79
  186. package/src/providers/traework/index.js +132 -132
  187. package/src/providers/traework/market-identity.js +116 -116
  188. package/src/providers/traework/models.js +98 -98
  189. package/src/providers/traework/payload.js +86 -86
  190. package/src/providers/traework/sse.js +184 -184
  191. package/src/providers/traework/token.js +52 -52
  192. package/src/providers/traework.js +2 -2
  193. package/src/providers/workbuddy/account-store.js +186 -186
  194. package/src/providers/workbuddy/auth.js +158 -158
  195. package/src/providers/workbuddy/balance.js +86 -86
  196. package/src/providers/workbuddy/cat-travel.js +125 -125
  197. package/src/providers/workbuddy/checkin.js +75 -75
  198. package/src/providers/workbuddy/desktop-info.js +78 -78
  199. package/src/providers/workbuddy/growth-api.js +67 -67
  200. package/src/providers/workbuddy/growth-plans.js +63 -63
  201. package/src/providers/workbuddy/growth.js +181 -181
  202. package/src/providers/workbuddy/index.js +217 -217
  203. package/src/providers/workbuddy/models.js +126 -126
  204. package/src/providers/workbuddy/payload.js +141 -141
  205. package/src/providers/workbuddy/rotation-log.js +83 -83
  206. package/src/providers/workbuddy/sanitize-tools.js +61 -61
  207. package/src/providers/workbuddy/sdk-chat.js +26 -26
  208. package/src/providers/workbuddy-balance.js +78 -78
  209. package/src/providers/zcode/account-store.js +129 -129
  210. package/src/providers/zcode/auth.js +28 -28
  211. package/src/providers/zcode/chat.js +179 -179
  212. package/src/providers/zcode/const.js +54 -54
  213. package/src/providers/zcode/context-shape.js +162 -162
  214. package/src/providers/zcode/headers.js +93 -93
  215. package/src/providers/zcode/index.js +124 -124
  216. package/src/providers/zcode/models.js +65 -65
  217. package/src/providers/zcode/oauth.js +120 -120
  218. package/src/providers/zcode/quota.js +176 -176
  219. package/src/providers/zcode/sse.js +196 -196
  220. package/src/readline-compat.js +25 -25
  221. package/src/responses/translate.js +311 -311
  222. package/src/routes/chat/broadband-handler.js +72 -72
  223. package/src/routes/chat/empty-turn-report.js +31 -31
  224. package/src/routes/chat/exhausted-handler.js +87 -87
  225. package/src/routes/chat/hedge-handler.js +130 -130
  226. package/src/routes/chat/index.js +1 -1
  227. package/src/routes/chat/local-handler.js +63 -63
  228. package/src/routes/chat/peer-handler.js +81 -81
  229. package/src/routes/chat.js +3 -3
  230. package/src/routes/fallback.js +88 -88
  231. package/src/routes/groups-relay.js +214 -214
  232. package/src/routes/groups.js +122 -122
  233. package/src/routes/helpers.js +83 -83
  234. package/src/routes/index.js +147 -147
  235. package/src/routes/messages-route.js +365 -365
  236. package/src/routes/peers.js +23 -1
  237. package/src/routes/relay-queue.js +181 -181
  238. package/src/routes/relay.js +60 -60
  239. package/src/routes/responses-route.js +213 -213
  240. package/src/routes/stream-body.js +84 -84
  241. package/src/routes/stream-hold.js +337 -337
  242. package/src/routes/stream-scan.js +366 -366
  243. package/src/routes.js +3 -3
  244. package/src/runtime/auto-update.js +113 -113
  245. package/src/runtime/bootstrap.js +8 -0
  246. package/src/runtime/broadband-stream.js +79 -79
  247. package/src/runtime/broadband.js +103 -103
  248. package/src/runtime/group-sync.js +81 -81
  249. package/src/runtime/keep-warm.js +120 -0
  250. package/src/runtime/lifecycle-forensics.js +116 -116
  251. package/src/runtime/lifecycle-log.js +87 -87
  252. package/src/runtime/log-stamp.js +73 -73
  253. package/src/runtime/proc-info.js +137 -137
  254. package/src/runtime/qoder-checkin.js +93 -93
  255. package/src/runtime/raccoon-checkin.js +126 -126
  256. package/src/runtime/server-lifecycle.js +189 -189
  257. package/src/runtime/traework-checkin.js +118 -118
  258. package/src/runtime/workbuddy-checkin.js +120 -120
  259. package/src/runtime/workbuddy-growth.js +133 -133
  260. package/src/server.js +7 -0
  261. package/src/state/facade.js +58 -58
  262. package/src/state/memory.js +162 -162
  263. package/src/state/merge.js +25 -25
  264. package/src/state/migrations/cline-unify.js +94 -94
  265. package/src/state/migrations.js +33 -33
  266. package/src/state/persist.js +42 -42
  267. package/src/state/provider-config.js +142 -142
  268. package/src/state/schemas/group.js +31 -31
  269. package/src/state/schemas/model.js +94 -94
  270. package/src/state/schemas/peer.js +31 -31
  271. package/src/state/schemas/port.js +10 -10
  272. package/src/state/schemas/provider.js +202 -202
  273. package/src/state/schemas/timezone.js +70 -70
  274. package/src/state/schemas/token.js +48 -48
  275. package/src/state/schemas/use-group.js +102 -102
  276. package/src/state/store.js +176 -176
  277. package/src/state.js +1 -1
  278. package/src/sync-claude-desktop.js +234 -234
  279. package/src/sync-claude.js +152 -152
  280. package/src/sync-codex.js +116 -116
  281. package/src/sync-workbuddy.js +158 -158
  282. package/src/talk-full-redact.js +129 -129
  283. package/src/talk-full.js +131 -131
  284. package/src/talk-log.js +257 -257
  285. package/src/text-tokens.js +52 -52
  286. package/src/thinking-effort.js +67 -67
  287. package/src/time.js +106 -106
  288. package/src/timeline.js +26 -26
  289. package/src/transport/index.js +1 -1
  290. package/src/upstream-engine/index.js +74 -72
  291. package/src/upstream-engine/mode.js +15 -15
  292. package/src/upstream-engine/sdk/attempt.js +221 -221
  293. package/src/upstream-engine/sdk/chat.js +28 -28
  294. package/src/upstream-engine/sdk/convert.js +192 -192
  295. package/src/upstream-engine/sdk/diagnose.js +62 -62
  296. package/src/upstream-engine/sdk/dispatch.js +55 -55
  297. package/src/upstream-engine/sdk/responses.js +176 -176
  298. package/src/upstream-engine/sdk/sse.js +166 -166
  299. package/src/upstream-responses.js +305 -305
  300. package/src/upstream.js +53 -1
  301. package/src/usage/record.js +106 -106
  302. package/src/usage/report.js +195 -195
  303. package/src/v6pool/claim.js +157 -157
  304. package/src/v6pool/config.js +65 -65
  305. package/src/v6pool/detect.js +130 -130
  306. package/src/v6pool/index.js +152 -152
  307. package/src/v6pool/prefix.js +140 -140
  308. package/src/v6pool/probe.js +40 -40
  309. package/src/v6pool/report.js +104 -104
  310. package/src/v6pool/rotate.js +263 -239
  311. package/src/warp-pool/config.js +74 -74
  312. package/src/warp-pool/health.js +106 -106
  313. package/src/warp-pool/identity.js +141 -141
  314. package/src/warp-pool/index.js +358 -358
  315. package/src/warp-pool/keys.js +29 -29
  316. package/src/warp-pool/nodes.js +95 -95
  317. package/src/warp-pool/ports.js +160 -160
  318. package/src/warp-pool/register.js +113 -113
  319. package/src/warp-pool/report.js +232 -232
  320. package/src/warp-pool/revive.js +168 -168
  321. package/src/warp-pool/rotate.js +214 -214
  322. package/src/warp-pool/strategy.js +43 -43
  323. package/src/warp-pool/verdict.js +69 -69
  324. package/src/warp-pool/wireproxy.js +162 -162
  325. package/docs/cli_help_mini.md +0 -146
  326. package/src/providers/AGENTS.md +0 -49
  327. package/src/routes/AGENTS.md +0 -37
@@ -1,214 +1,214 @@
1
- // warp-pool · 轮换 dispatcher:把每个请求委派给不同出口节点的 ProxyAgent。
2
- // 契约(MODULES.md §1):只需 dispatch(opts, handler) + close()/destroy()。
3
- // 注入点:src/transport/index.js 的 extDispatcher —— legacy(transport.request)与 SDK(sdk/attempt.js
4
- // 的 dispatcherFetch)两条路共用同一个 dispatcher 对象,故一处实现、两条路生效。
5
- //
6
- // 空池语义:bootstrap(注册设备/起隧道)完成前 list 为空 → 走直连兜底,行为与未启用本功能时一致;
7
- // bootstrap 完成后 setNodes() 换上真实出口。这样 daemon 启动不会因注册/下载而被阻塞。
8
- import { getUndici } from "../compat.js";
9
- import { createSelector } from "./strategy.js";
10
- import { looksLikeQuotaSignal, SIGNAL_MAX_BYTES, SIGNAL_STATUSES } from "./verdict.js";
11
-
12
- const SESSION_HEADER = "x-opencode-session";
13
-
14
- /** undici 的 dispatch opts.headers 是扁平数组 [k, v, k, v, ...]。 */
15
- export function headerValue(headers, name) {
16
- if (!Array.isArray(headers)) return "";
17
- const target = String(name).toLowerCase();
18
- for (let i = 0; i + 1 < headers.length; i += 2) {
19
- if (String(headers[i]).toLowerCase() === target) return String(headers[i + 1] ?? "");
20
- }
21
- return "";
22
- }
23
-
24
- /**
25
- * 让 dispatcher 看见上游的失败信号:复制一层 handler,其余方法原样转发(全部调用都落在副本上,this 一致)。
26
- *
27
- * 403/429 要**连正文一起**交出去才能判决(`403 FreeTierError` 与 `429 FreeUsageLimitError` 是同一条件,
28
- * 而 `429 BlackUsageLimitError` 是账号配额、绝不能换出口)——参照实现 zen-router 就是按正文里的具名判决
29
- * 分类的(internal/zen/errors.go)。故这两类状态码延迟到「正文到手」再回调:凑够具名判决即提前回调,
30
- * 否则等 onComplete/onError/触顶。其余状态码照旧在 onHeaders 立即回调(正文为空)。
31
- * 正文只**旁听**不消费:onData 原样转发给下游 handler,捕获 ≤ SIGNAL_MAX_BYTES 字节。
32
- */
33
- export function tapHandler(handler, tap) {
34
- if (!tap || !handler || typeof handler !== "object") return handler;
35
- const out = Object.assign(Object.create(Object.getPrototypeOf(handler)), handler);
36
- const origHeaders = handler.onHeaders;
37
- const origData = handler.onData;
38
- const origComplete = handler.onComplete;
39
- const origError = handler.onError;
40
- /** @type {null | { status: number, buf: Buffer[], size: number, done: boolean }} */
41
- let capture = null;
42
- const fire = () => {
43
- if (!capture || capture.done) return;
44
- capture.done = true;
45
- try { tap({ status: capture.status, text: Buffer.concat(capture.buf).toString("utf8") }); } catch {}
46
- };
47
-
48
- out.onHeaders = function (statusCode, headers, resume, statusText) {
49
- const code = Number(statusCode);
50
- // 只有 403/429 值得等正文;且必须下游真能收数据,否则退回「只按状态码判决」。
51
- if (SIGNAL_STATUSES.includes(code) && typeof origData === "function") {
52
- capture = { status: code, buf: [], size: 0, done: false };
53
- } else {
54
- try { tap({ status: code, text: "" }); } catch {}
55
- }
56
- return typeof origHeaders === "function" ? origHeaders.call(this, statusCode, headers, resume, statusText) : undefined;
57
- };
58
- out.onData = function (chunk) {
59
- if (capture && !capture.done) {
60
- try {
61
- const b = Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk));
62
- const room = SIGNAL_MAX_BYTES - capture.size;
63
- if (room > 0) {
64
- const slice = b.length > room ? b.subarray(0, room) : b;
65
- capture.buf.push(slice);
66
- capture.size += slice.length;
67
- }
68
- } catch {}
69
- // 具名判决一到手就判决,不必等整条 body;触顶也判(大 body 不许把判决拖成慢扫描)
70
- const text = capture.buf.length ? Buffer.concat(capture.buf).toString("utf8") : "";
71
- if (capture.size >= SIGNAL_MAX_BYTES || looksLikeQuotaSignal(text)) fire();
72
- }
73
- return typeof origData === "function" ? origData.call(this, chunk) : undefined;
74
- };
75
- out.onComplete = function (trailers) {
76
- fire();
77
- return typeof origComplete === "function" ? origComplete.call(this, trailers) : undefined;
78
- };
79
- out.onError = function (err) {
80
- fire();
81
- return typeof origError === "function" ? origError.call(this, err) : undefined;
82
- };
83
- return out;
84
- }
85
-
86
- /**
87
- * @param {{ nodes?: Array<{port:number, uri:string}>, strategy?: "session"|"request",
88
- * cooldownMs?: number, now?: () => number, log?: (s:string)=>void, onStatus?: (status:number, port:number)=>void,
89
- * agentOptions?: object, selector?: object }} [opts]
90
- */
91
- export function createRotatingDispatcher({
92
- nodes = [],
93
- strategy = "session",
94
- cooldownMs = 600_000,
95
- now = Date.now,
96
- log = () => {},
97
- onStatus = null,
98
- agentFactory,
99
- fallbackAgent,
100
- agentOptions = { connections: 8, keepAliveTimeout: 30_000, keepAliveMaxTimeout: 60_000, pipelining: 1 },
101
- selector = createSelector({ strategy }),
102
- } = {}) {
103
- const { ProxyAgent, Agent } = getUndici();
104
- if (typeof ProxyAgent !== "function") throw new Error("undici ProxyAgent 不可用:无法建立出口池");
105
- // 空池兜底:直连(等价 R3 里被顶掉的 keepAlive 池)。
106
- const fallback = fallbackAgent !== undefined ? fallbackAgent : typeof Agent === "function" ? new Agent(agentOptions) : null;
107
- let list = build(nodes);
108
-
109
- function build(nodesIn) {
110
- return (nodesIn || []).map((n, i) => ({
111
- index: i,
112
- port: Number(n.port),
113
- uri: String(n.uri),
114
- agent: agentFactory ? agentFactory(n.uri) : new ProxyAgent({ uri: n.uri, ...agentOptions }),
115
- cooldownUntil: 0,
116
- fails: 0,
117
- }));
118
- }
119
-
120
- function availableIndexes() {
121
- const t = now();
122
- const out = [];
123
- for (const e of list) if (e.cooldownUntil <= t) out.push(e.index);
124
- return out;
125
- }
126
-
127
- function markFailure(index) {
128
- const e = list[index];
129
- if (!e) return;
130
- e.fails += 1;
131
- e.cooldownUntil = now() + cooldownMs;
132
- if (e.fails === 1 || e.fails % 10 === 0) log(`[warp-pool] 节点 :${e.port} 连续失败 ${e.fails} 次,冷却 ${Math.round(cooldownMs / 1000)}s(中间次数静默:健康探活每分钟一轮,一个不通的节点曾把日志刷成 12 行/分钟)`);
133
- }
134
-
135
- function markOk(index) {
136
- const e = list[index];
137
- if (e) {
138
- e.fails = 0;
139
- e.cooldownUntil = 0;
140
- }
141
- }
142
-
143
- async function closePool(entries) {
144
- await Promise.all(
145
- entries.map((e) => {
146
- try {
147
- return Promise.resolve(e.agent.close?.()).catch(() => {});
148
- } catch {
149
- return Promise.resolve();
150
- }
151
- }),
152
- );
153
- }
154
-
155
- return {
156
- /** 每次请求调一次 = 轮换粒度。 */
157
- dispatch(opts, handler) {
158
- if (!list.length) {
159
- if (fallback) return fallback.dispatch(opts, handler);
160
- throw new Error("warp-pool:节点池为空且无直连兜底");
161
- }
162
- const avail = availableIndexes();
163
- // 全池冷却 ⇒ 直连兜底优先:硬派给已知不可用的节点 = 把请求挂到超时。
164
- if (!avail.length) return (fallback || list[0].agent).dispatch(opts, handler);
165
- const sessionKey = strategy === "session" ? headerValue(opts?.headers, SESSION_HEADER) : "";
166
- const e = list[selector.pick(avail, sessionKey)];
167
- return e.agent.dispatch(opts, tapHandler(handler, onStatus ? (sc) => onStatus(sc, e.port) : null));
168
- },
169
-
170
- /** 运行期换上一批出口(bootstrap 完成后调用);旧 Agent 池关闭。 */
171
- async setNodes(nodesIn) {
172
- const old = list;
173
- list = build(nodesIn);
174
- await closePool(old);
175
- return list.length;
176
- },
177
-
178
- /** 只读快照,供 health 探活用。 */
179
- entries() {
180
- return list.map((e) => ({ index: e.index, port: e.port, uri: e.uri, cooldownUntil: e.cooldownUntil, fails: e.fails }));
181
- },
182
-
183
- async close() {
184
- await closePool(list);
185
- list = [];
186
- if (fallback) {
187
- try {
188
- await fallback.close?.();
189
- } catch {}
190
- }
191
- },
192
-
193
- async destroy() {
194
- return this.close();
195
- },
196
-
197
- stats() {
198
- const t = now();
199
- return list.map((e) => ({
200
- port: e.port,
201
- uri: e.uri,
202
- cooling: e.cooldownUntil > t,
203
- cooldownMsLeft: Math.max(0, e.cooldownUntil - t),
204
- fails: e.fails,
205
- }));
206
- },
207
-
208
- markFailure,
209
- markOk,
210
- get size() {
211
- return list.length;
212
- },
213
- };
214
- }
1
+ // warp-pool · 轮换 dispatcher:把每个请求委派给不同出口节点的 ProxyAgent。
2
+ // 契约(MODULES.md §1):只需 dispatch(opts, handler) + close()/destroy()。
3
+ // 注入点:src/transport/index.js 的 extDispatcher —— legacy(transport.request)与 SDK(sdk/attempt.js
4
+ // 的 dispatcherFetch)两条路共用同一个 dispatcher 对象,故一处实现、两条路生效。
5
+ //
6
+ // 空池语义:bootstrap(注册设备/起隧道)完成前 list 为空 → 走直连兜底,行为与未启用本功能时一致;
7
+ // bootstrap 完成后 setNodes() 换上真实出口。这样 daemon 启动不会因注册/下载而被阻塞。
8
+ import { getUndici } from "../compat.js";
9
+ import { createSelector } from "./strategy.js";
10
+ import { looksLikeQuotaSignal, SIGNAL_MAX_BYTES, SIGNAL_STATUSES } from "./verdict.js";
11
+
12
+ const SESSION_HEADER = "x-opencode-session";
13
+
14
+ /** undici 的 dispatch opts.headers 是扁平数组 [k, v, k, v, ...]。 */
15
+ export function headerValue(headers, name) {
16
+ if (!Array.isArray(headers)) return "";
17
+ const target = String(name).toLowerCase();
18
+ for (let i = 0; i + 1 < headers.length; i += 2) {
19
+ if (String(headers[i]).toLowerCase() === target) return String(headers[i + 1] ?? "");
20
+ }
21
+ return "";
22
+ }
23
+
24
+ /**
25
+ * 让 dispatcher 看见上游的失败信号:复制一层 handler,其余方法原样转发(全部调用都落在副本上,this 一致)。
26
+ *
27
+ * 403/429 要**连正文一起**交出去才能判决(`403 FreeTierError` 与 `429 FreeUsageLimitError` 是同一条件,
28
+ * 而 `429 BlackUsageLimitError` 是账号配额、绝不能换出口)——参照实现 zen-router 就是按正文里的具名判决
29
+ * 分类的(internal/zen/errors.go)。故这两类状态码延迟到「正文到手」再回调:凑够具名判决即提前回调,
30
+ * 否则等 onComplete/onError/触顶。其余状态码照旧在 onHeaders 立即回调(正文为空)。
31
+ * 正文只**旁听**不消费:onData 原样转发给下游 handler,捕获 ≤ SIGNAL_MAX_BYTES 字节。
32
+ */
33
+ export function tapHandler(handler, tap) {
34
+ if (!tap || !handler || typeof handler !== "object") return handler;
35
+ const out = Object.assign(Object.create(Object.getPrototypeOf(handler)), handler);
36
+ const origHeaders = handler.onHeaders;
37
+ const origData = handler.onData;
38
+ const origComplete = handler.onComplete;
39
+ const origError = handler.onError;
40
+ /** @type {null | { status: number, buf: Buffer[], size: number, done: boolean }} */
41
+ let capture = null;
42
+ const fire = () => {
43
+ if (!capture || capture.done) return;
44
+ capture.done = true;
45
+ try { tap({ status: capture.status, text: Buffer.concat(capture.buf).toString("utf8") }); } catch {}
46
+ };
47
+
48
+ out.onHeaders = function (statusCode, headers, resume, statusText) {
49
+ const code = Number(statusCode);
50
+ // 只有 403/429 值得等正文;且必须下游真能收数据,否则退回「只按状态码判决」。
51
+ if (SIGNAL_STATUSES.includes(code) && typeof origData === "function") {
52
+ capture = { status: code, buf: [], size: 0, done: false };
53
+ } else {
54
+ try { tap({ status: code, text: "" }); } catch {}
55
+ }
56
+ return typeof origHeaders === "function" ? origHeaders.call(this, statusCode, headers, resume, statusText) : undefined;
57
+ };
58
+ out.onData = function (chunk) {
59
+ if (capture && !capture.done) {
60
+ try {
61
+ const b = Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk));
62
+ const room = SIGNAL_MAX_BYTES - capture.size;
63
+ if (room > 0) {
64
+ const slice = b.length > room ? b.subarray(0, room) : b;
65
+ capture.buf.push(slice);
66
+ capture.size += slice.length;
67
+ }
68
+ } catch {}
69
+ // 具名判决一到手就判决,不必等整条 body;触顶也判(大 body 不许把判决拖成慢扫描)
70
+ const text = capture.buf.length ? Buffer.concat(capture.buf).toString("utf8") : "";
71
+ if (capture.size >= SIGNAL_MAX_BYTES || looksLikeQuotaSignal(text)) fire();
72
+ }
73
+ return typeof origData === "function" ? origData.call(this, chunk) : undefined;
74
+ };
75
+ out.onComplete = function (trailers) {
76
+ fire();
77
+ return typeof origComplete === "function" ? origComplete.call(this, trailers) : undefined;
78
+ };
79
+ out.onError = function (err) {
80
+ fire();
81
+ return typeof origError === "function" ? origError.call(this, err) : undefined;
82
+ };
83
+ return out;
84
+ }
85
+
86
+ /**
87
+ * @param {{ nodes?: Array<{port:number, uri:string}>, strategy?: "session"|"request",
88
+ * cooldownMs?: number, now?: () => number, log?: (s:string)=>void, onStatus?: (status:number, port:number)=>void,
89
+ * agentOptions?: object, selector?: object }} [opts]
90
+ */
91
+ export function createRotatingDispatcher({
92
+ nodes = [],
93
+ strategy = "session",
94
+ cooldownMs = 600_000,
95
+ now = Date.now,
96
+ log = () => {},
97
+ onStatus = null,
98
+ agentFactory,
99
+ fallbackAgent,
100
+ agentOptions = { connections: 8, keepAliveTimeout: 30_000, keepAliveMaxTimeout: 60_000, pipelining: 1 },
101
+ selector = createSelector({ strategy }),
102
+ } = {}) {
103
+ const { ProxyAgent, Agent } = getUndici();
104
+ if (typeof ProxyAgent !== "function") throw new Error("undici ProxyAgent 不可用:无法建立出口池");
105
+ // 空池兜底:直连(等价 R3 里被顶掉的 keepAlive 池)。
106
+ const fallback = fallbackAgent !== undefined ? fallbackAgent : typeof Agent === "function" ? new Agent(agentOptions) : null;
107
+ let list = build(nodes);
108
+
109
+ function build(nodesIn) {
110
+ return (nodesIn || []).map((n, i) => ({
111
+ index: i,
112
+ port: Number(n.port),
113
+ uri: String(n.uri),
114
+ agent: agentFactory ? agentFactory(n.uri) : new ProxyAgent({ uri: n.uri, ...agentOptions }),
115
+ cooldownUntil: 0,
116
+ fails: 0,
117
+ }));
118
+ }
119
+
120
+ function availableIndexes() {
121
+ const t = now();
122
+ const out = [];
123
+ for (const e of list) if (e.cooldownUntil <= t) out.push(e.index);
124
+ return out;
125
+ }
126
+
127
+ function markFailure(index) {
128
+ const e = list[index];
129
+ if (!e) return;
130
+ e.fails += 1;
131
+ e.cooldownUntil = now() + cooldownMs;
132
+ if (e.fails === 1 || e.fails % 10 === 0) log(`[warp-pool] 节点 :${e.port} 连续失败 ${e.fails} 次,冷却 ${Math.round(cooldownMs / 1000)}s(中间次数静默:健康探活每分钟一轮,一个不通的节点曾把日志刷成 12 行/分钟)`);
133
+ }
134
+
135
+ function markOk(index) {
136
+ const e = list[index];
137
+ if (e) {
138
+ e.fails = 0;
139
+ e.cooldownUntil = 0;
140
+ }
141
+ }
142
+
143
+ async function closePool(entries) {
144
+ await Promise.all(
145
+ entries.map((e) => {
146
+ try {
147
+ return Promise.resolve(e.agent.close?.()).catch(() => {});
148
+ } catch {
149
+ return Promise.resolve();
150
+ }
151
+ }),
152
+ );
153
+ }
154
+
155
+ return {
156
+ /** 每次请求调一次 = 轮换粒度。 */
157
+ dispatch(opts, handler) {
158
+ if (!list.length) {
159
+ if (fallback) return fallback.dispatch(opts, handler);
160
+ throw new Error("warp-pool:节点池为空且无直连兜底");
161
+ }
162
+ const avail = availableIndexes();
163
+ // 全池冷却 ⇒ 直连兜底优先:硬派给已知不可用的节点 = 把请求挂到超时。
164
+ if (!avail.length) return (fallback || list[0].agent).dispatch(opts, handler);
165
+ const sessionKey = strategy === "session" ? headerValue(opts?.headers, SESSION_HEADER) : "";
166
+ const e = list[selector.pick(avail, sessionKey)];
167
+ return e.agent.dispatch(opts, tapHandler(handler, onStatus ? (sc) => onStatus(sc, e.port) : null));
168
+ },
169
+
170
+ /** 运行期换上一批出口(bootstrap 完成后调用);旧 Agent 池关闭。 */
171
+ async setNodes(nodesIn) {
172
+ const old = list;
173
+ list = build(nodesIn);
174
+ await closePool(old);
175
+ return list.length;
176
+ },
177
+
178
+ /** 只读快照,供 health 探活用。 */
179
+ entries() {
180
+ return list.map((e) => ({ index: e.index, port: e.port, uri: e.uri, cooldownUntil: e.cooldownUntil, fails: e.fails }));
181
+ },
182
+
183
+ async close() {
184
+ await closePool(list);
185
+ list = [];
186
+ if (fallback) {
187
+ try {
188
+ await fallback.close?.();
189
+ } catch {}
190
+ }
191
+ },
192
+
193
+ async destroy() {
194
+ return this.close();
195
+ },
196
+
197
+ stats() {
198
+ const t = now();
199
+ return list.map((e) => ({
200
+ port: e.port,
201
+ uri: e.uri,
202
+ cooling: e.cooldownUntil > t,
203
+ cooldownMsLeft: Math.max(0, e.cooldownUntil - t),
204
+ fails: e.fails,
205
+ }));
206
+ },
207
+
208
+ markFailure,
209
+ markOk,
210
+ get size() {
211
+ return list.length;
212
+ },
213
+ };
214
+ }
@@ -1,43 +1,43 @@
1
- // warp-pool · 选节点策略。
2
- //
3
- // session(默认):同一 `x-opencode-session` 恒粘同一出口。
4
- // 依据 src/upstream.js L14-16 的实测注释——上游按 session 做粘性路由(固定 session 两次请求 ~1.2s;
5
- // 每次随机时可能撞冷机器 26s+)。故"每请求换出口"会把请求打成冷启动。
6
- // request:每请求轮转,仅供实验(延迟代价见上)。
7
- const STICKY_MAX = 2000;
8
-
9
- export function createSelector({ strategy = "session" } = {}) {
10
- const sticky = new Map();
11
- let cursor = 0;
12
-
13
- /** @param {number[]} available 可用节点下标 @param {string} sessionKey */
14
- function pick(available, sessionKey) {
15
- if (!Array.isArray(available) || available.length === 0) return null;
16
- if (strategy === "session" && sessionKey) {
17
- const hit = sticky.get(sessionKey);
18
- if (hit !== undefined && available.includes(hit)) return hit;
19
- const chosen = available[cursor++ % available.length];
20
- sticky.set(sessionKey, chosen);
21
- if (sticky.size > STICKY_MAX) {
22
- const oldest = sticky.keys().next().value;
23
- sticky.delete(oldest);
24
- }
25
- return chosen;
26
- }
27
- return available[cursor++ % available.length];
28
- }
29
-
30
- return {
31
- pick,
32
- forget(sessionKey) {
33
- if (sessionKey === undefined) sticky.clear();
34
- else sticky.delete(sessionKey);
35
- },
36
- get tracked() {
37
- return sticky.size;
38
- },
39
- get strategy() {
40
- return strategy;
41
- },
42
- };
43
- }
1
+ // warp-pool · 选节点策略。
2
+ //
3
+ // session(默认):同一 `x-opencode-session` 恒粘同一出口。
4
+ // 依据 src/upstream.js L14-16 的实测注释——上游按 session 做粘性路由(固定 session 两次请求 ~1.2s;
5
+ // 每次随机时可能撞冷机器 26s+)。故"每请求换出口"会把请求打成冷启动。
6
+ // request:每请求轮转,仅供实验(延迟代价见上)。
7
+ const STICKY_MAX = 2000;
8
+
9
+ export function createSelector({ strategy = "session" } = {}) {
10
+ const sticky = new Map();
11
+ let cursor = 0;
12
+
13
+ /** @param {number[]} available 可用节点下标 @param {string} sessionKey */
14
+ function pick(available, sessionKey) {
15
+ if (!Array.isArray(available) || available.length === 0) return null;
16
+ if (strategy === "session" && sessionKey) {
17
+ const hit = sticky.get(sessionKey);
18
+ if (hit !== undefined && available.includes(hit)) return hit;
19
+ const chosen = available[cursor++ % available.length];
20
+ sticky.set(sessionKey, chosen);
21
+ if (sticky.size > STICKY_MAX) {
22
+ const oldest = sticky.keys().next().value;
23
+ sticky.delete(oldest);
24
+ }
25
+ return chosen;
26
+ }
27
+ return available[cursor++ % available.length];
28
+ }
29
+
30
+ return {
31
+ pick,
32
+ forget(sessionKey) {
33
+ if (sessionKey === undefined) sticky.clear();
34
+ else sticky.delete(sessionKey);
35
+ },
36
+ get tracked() {
37
+ return sticky.size;
38
+ },
39
+ get strategy() {
40
+ return strategy;
41
+ },
42
+ };
43
+ }