@jjh32456/dsh-longlive 1.6.7 → 1.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (289) hide show
  1. package/CHANGELOG.md +70 -1508
  2. package/LICENSE +1 -1
  3. package/QUICKSTART.md +34 -13
  4. package/README.en.md +18 -7
  5. package/README.md +34 -9
  6. package/SPEC.md +5 -5
  7. package/cordis.patch.yml +23 -9
  8. package/docs/ANSWER-GUARD.md +92 -0
  9. package/docs/ARCHITECTURE.md +4 -3
  10. package/docs/AUTO-RECALL-WIRING.md +1 -1
  11. package/docs/AUTO-RECALL.md +15 -9
  12. package/docs/CONFIG.md +168 -35
  13. package/docs/ERRORS.md +17 -5
  14. package/docs/FAQ.md +7 -7
  15. package/docs/FEATURES.md +96 -28
  16. package/docs/MIGRATION-1.6.0.md +2 -2
  17. package/docs/OPERATIONS.md +6 -6
  18. package/docs/PANEL-INTEGRATION.md +6 -0
  19. package/docs/PRIVACY.md +88 -0
  20. package/docs/QUICKSTART.md +5 -5
  21. package/docs/README.en.md +4 -2
  22. package/docs/RESIDENT-WATCHER.md +1 -1
  23. package/docs/SESSION-WATCH.md +6 -6
  24. package/docs/TROUBLESHOOTING.md +4 -4
  25. package/package.json +47 -117
  26. package/runbook.md +2 -2
  27. package/scripts/backfill-auto-cards.mjs +98 -0
  28. package/scripts/install-surgery-task.ps1 +5 -2
  29. package/scripts/lib/session-watch-fixture.mjs +1 -1
  30. package/scripts/longlive-doctor.mjs +6 -0
  31. package/scripts/migrate-180.mjs +163 -0
  32. package/scripts/recall-index-build.mjs +128 -0
  33. package/scripts/session-watch-drill.mjs +1 -1
  34. package/scripts/surgery-run.cmd +1 -1
  35. package/scripts/unattended-surgery.ps1 +5 -2
  36. package/scripts/verify-card-anchors.mjs +138 -0
  37. package/src/actions/audit.js +125 -0
  38. package/src/actions/evidence.js +122 -0
  39. package/src/actions/fs.js +162 -0
  40. package/src/activity/index.js +760 -0
  41. package/src/activity/model.js +351 -0
  42. package/src/activity/store.js +644 -0
  43. package/src/activity/thinking.js +176 -0
  44. package/src/adapters/constants.js +11 -0
  45. package/src/adapters/engram/data/aliases.json +51 -0
  46. package/src/adapters/engram/data/policy.json +8 -0
  47. package/src/adapters/engram/data/routing-rules.json +546 -0
  48. package/src/adapters/engram/index.js +235 -0
  49. package/src/adapters/registry.js +315 -0
  50. package/src/answer/audit.js +193 -0
  51. package/src/answer/evidence.js +30 -0
  52. package/src/answer/guard.js +1370 -0
  53. package/src/answer/index.js +1067 -0
  54. package/src/answer/query.js +111 -0
  55. package/src/answer/second-hop.mjs +101 -0
  56. package/src/auto-truncate.js +1 -1
  57. package/src/config.js +171 -47
  58. package/src/deps.js +6 -4
  59. package/src/features.js +182 -6
  60. package/src/heartbeat.js +156 -23
  61. package/src/identity/handover.js +52 -1
  62. package/src/identity/index.js +13 -5
  63. package/src/identity/inject-position.js +2 -2
  64. package/src/index.js +97 -7
  65. package/src/lifecycle/gap-clocks.js +328 -0
  66. package/src/lifecycle/index.js +269 -0
  67. package/src/live.js +22 -2
  68. package/src/memory/activity-capture.js +229 -0
  69. package/src/memory/anchors.js +194 -0
  70. package/src/memory/audit-records.js +222 -0
  71. package/src/memory/auto-cards.js +401 -0
  72. package/src/memory/capture.js +442 -0
  73. package/src/memory/card-anchors.js +203 -0
  74. package/src/memory/conflicts.js +106 -0
  75. package/src/memory/decay.js +311 -0
  76. package/src/memory/distill.js +471 -0
  77. package/src/memory/event-index.js +917 -0
  78. package/src/memory/evidence-chain.js +295 -0
  79. package/src/memory/evidence.js +145 -0
  80. package/src/memory/filter-runner.js +1 -1
  81. package/src/memory/filter.js +5 -1
  82. package/src/memory/forget-v2.js +410 -0
  83. package/src/memory/forget.js +71 -0
  84. package/src/memory/frames-activation.js +247 -0
  85. package/src/memory/fts-query.js +174 -0
  86. package/src/memory/governance.js +604 -0
  87. package/src/memory/index.js +1 -0
  88. package/src/memory/l2-gate.js +169 -0
  89. package/src/memory/lock.js +121 -0
  90. package/src/memory/migrate.js +139 -0
  91. package/src/memory/recall-v2.js +223 -0
  92. package/src/memory/recall.js +65 -2
  93. package/src/memory/records.js +425 -0
  94. package/src/memory/retention.js +128 -0
  95. package/src/memory/review.js +124 -0
  96. package/src/memory/trust.js +88 -0
  97. package/src/memory/version-chain.js +264 -0
  98. package/src/memory/wal.js +137 -0
  99. package/src/memory/working-frame.js +516 -0
  100. package/src/metrics/classify.mjs +5 -3
  101. package/src/metrics/index.mjs +21 -1
  102. package/src/metrics/prestep-latency.mjs +300 -0
  103. package/src/metrics/store.mjs +25 -0
  104. package/src/policy-profile.js +18 -3
  105. package/src/recall/anaphora.mjs +87 -0
  106. package/src/recall/cards.mjs +7 -0
  107. package/src/recall/embedding.mjs +8 -8
  108. package/src/recall/entities.mjs +112 -0
  109. package/src/recall/index.js +235 -19
  110. package/src/recall/inject-order.mjs +10 -8
  111. package/src/recall/privacy.mjs +105 -16
  112. package/src/recall/recall-core.mjs +116 -10
  113. package/src/recall/shared-visibility.js +302 -0
  114. package/src/recall/time-normalizer.mjs +196 -0
  115. package/src/role/activation.js +191 -0
  116. package/src/role/attention.js +318 -0
  117. package/src/role/base.js +36 -0
  118. package/src/role/channels.js +423 -0
  119. package/src/role/index.js +425 -0
  120. package/src/role/interfaces.js +115 -0
  121. package/src/role/personality.js +370 -0
  122. package/src/role/readers.js +151 -0
  123. package/src/role/relationships.js +477 -0
  124. package/src/role/store.js +202 -0
  125. package/src/role/writeprotect.js +373 -0
  126. package/src/router/aliases.json +176 -25
  127. package/src/router/background/agent-runner.mjs +1 -1
  128. package/src/router/background/anchor.mjs +1 -1
  129. package/src/router/background/audit.mjs +2 -2
  130. package/src/router/background/budget-ledger.mjs +2 -2
  131. package/src/router/background/host-sim.mjs +1 -1
  132. package/src/router/background/memory.mjs +4 -4
  133. package/src/router/background/queue.mjs +1 -1
  134. package/src/router/background/retry.mjs +1 -1
  135. package/src/router/background/router.mjs +1 -1
  136. package/src/router/background/stream.mjs +1 -1
  137. package/src/router/background/tool-policy.mjs +1 -1
  138. package/src/router/design-headings.json +5 -5
  139. package/src/router/face/config.mjs +1 -1
  140. package/src/router/face/identity.mjs +3 -3
  141. package/src/router/judge.mjs +8 -7
  142. package/src/router/policies/generic.json +21 -4
  143. package/src/router/route.js +109 -22
  144. package/src/router/router.mjs +10 -6
  145. package/src/router/routing-rules.json +260 -445
  146. package/src/router/run-sim.mjs +8 -8
  147. package/src/router/runtime.js +23 -12
  148. package/src/router/service/board.mjs +95 -15
  149. package/src/router/service/config.mjs +5 -5
  150. package/src/router/service/context.mjs +1 -1
  151. package/src/router/service/hint.mjs +14 -0
  152. package/src/router/service/queue.mjs +1 -1
  153. package/src/router/service/service.mjs +27 -11
  154. package/src/router/shadow.mjs +4 -3
  155. package/src/surgery-recovery.js +2 -2
  156. package/src/tool-output.js +2 -2
  157. package/src/tools.js +39 -7
  158. package/src/truncate-visible.js +2 -2
  159. package/src/ui/actions.js +1312 -0
  160. package/src/ui/panel-api.js +367 -0
  161. package/src/ui/panel-auth.js +251 -0
  162. package/src/ui/panel-integrity.js +243 -0
  163. package/src/ui/routes-readonly.js +695 -0
  164. package/src/ui/routes.js +3 -0
  165. package/docs/DEV.md +0 -279
  166. package/docs/PRESENCE-BUS-WIRING.md +0 -491
  167. package/docs/PRESENCE-BUS.md +0 -694
  168. package/docs/SURGERY.md +0 -186
  169. package/scripts/mark-core-cards.mjs +0 -289
  170. package/scripts/pack.mjs +0 -392
  171. package/scripts/router-proposals.mjs +0 -386
  172. package/src/router/fixtures/M1.json +0 -16
  173. package/src/router/fixtures/M2.json +0 -16
  174. package/src/router/fixtures/M3.json +0 -20
  175. package/src/router/fixtures/M4.json +0 -20
  176. package/src/router/fixtures/M5.json +0 -45
  177. package/src/router/fixtures/M6.json +0 -53
  178. package/src/router/fixtures/M7.json +0 -46
  179. package/src/router/fixtures/S1.json +0 -20
  180. package/src/router/fixtures/S2.json +0 -23
  181. package/src/router/fixtures/S3.json +0 -20
  182. package/src/router/fixtures/S4.json +0 -34
  183. package/src/router/fixtures/S5.json +0 -43
  184. package/src/router/fixtures/S6.json +0 -47
  185. package/src/router/fixtures/T1.json +0 -23
  186. package/src/router/fixtures/T2.json +0 -16
  187. package/src/router/fixtures/T3.json +0 -19
  188. package/src/router/fixtures/T4.json +0 -16
  189. package/src/router/fixtures/X1.json +0 -17
  190. package/src/router/fixtures/X2.json +0 -20
  191. package/src/router/gen-design-headings.mjs +0 -107
  192. package/src/router/policies/owner-rulings-2026-11-03.json +0 -62
  193. package/test/auto-recall.test.mjs +0 -474
  194. package/test/auto-truncate.test.mjs +0 -931
  195. package/test/autobind.test.mjs +0 -385
  196. package/test/bus.test.mjs +0 -1572
  197. package/test/cli-guard.test.mjs +0 -198
  198. package/test/conclusion.test.mjs +0 -408
  199. package/test/config-schema.test.mjs +0 -204
  200. package/test/d6-output.test.mjs +0 -194
  201. package/test/d6.test.mjs +0 -395
  202. package/test/deps.test.mjs +0 -342
  203. package/test/doctor-setup.test.mjs +0 -297
  204. package/test/embedding-recall.test.mjs +0 -347
  205. package/test/feature-flags.test.mjs +0 -568
  206. package/test/filter-shadow.test.mjs +0 -170
  207. package/test/fixtures/baseline-0.8.0-registration.json +0 -556
  208. package/test/fixtures/d6-header-tools.json +0 -1
  209. package/test/fixtures/lock-child.mjs +0 -67
  210. package/test/fixtures/pre-step-container.mjs +0 -100
  211. package/test/fixtures/privacy-memory/topics/pii-unmarked.md +0 -9
  212. package/test/fixtures/privacy-memory/topics/secret-local-only.md +0 -11
  213. package/test/fixtures/profile-session-longlive-config.json +0 -20
  214. package/test/fixtures/proposal-cas-child.mjs +0 -66
  215. package/test/host-engine-status.test.mjs +0 -307
  216. package/test/hot-truncate.test.mjs +0 -1349
  217. package/test/identity-card-marker.test.mjs +0 -307
  218. package/test/identity-router/run.mjs +0 -721
  219. package/test/integration-pre-step.test.mjs +0 -553
  220. package/test/live.test.mjs +0 -1020
  221. package/test/maintenance-schedule.test.mjs +0 -538
  222. package/test/memory.test.mjs +0 -2828
  223. package/test/metrics.test.mjs +0 -478
  224. package/test/orchestrator.test.mjs +0 -266
  225. package/test/p1_probe.mjs +0 -97
  226. package/test/packaging.test.mjs +0 -182
  227. package/test/portability.test.mjs +0 -343
  228. package/test/rc4-regressions.test.mjs +0 -562
  229. package/test/rc5-regressions.test.mjs +0 -197
  230. package/test/rc6-chinese.test.mjs +0 -394
  231. package/test/router-1100/apply-off.test.mjs +0 -175
  232. package/test/router-1100/budget-reconcile.test.mjs +0 -215
  233. package/test/router-1100/config-context.test.mjs +0 -211
  234. package/test/router-1100/helpers.mjs +0 -129
  235. package/test/router-1100/hint-envelope.test.mjs +0 -150
  236. package/test/router-1100/lock-crossproc.test.mjs +0 -206
  237. package/test/router-1100/proposal-cas-crossproc.test.mjs +0 -184
  238. package/test/router-1100/router-apply.test.mjs +0 -372
  239. package/test/router-1100/router-fixb.test.mjs +0 -602
  240. package/test/router-1100/router-proposals.test.mjs +0 -405
  241. package/test/router-1100/router-queue-lease-wal.test.mjs +0 -355
  242. package/test/router-1100/router-security-cr.test.mjs +0 -333
  243. package/test/router-1100/service-lifecycle.test.mjs +0 -220
  244. package/test/router-1100/tools-contract.test.mjs +0 -164
  245. package/test/router-1100/turn-reflect-tick.test.mjs +0 -89
  246. package/test/router-1100/v6-contract.test.mjs +0 -158
  247. package/test/router-1100/v6b-contract.test.mjs +0 -293
  248. package/test/router-1100/v6c-contract.test.mjs +0 -249
  249. package/test/router-1100/wal-rotation.test.mjs +0 -375
  250. package/test/router-1100/wp1-config.test.mjs +0 -170
  251. package/test/router-1100/wp1-default-off.test.mjs +0 -77
  252. package/test/router-1100/wp1-model-status.test.mjs +0 -90
  253. package/test/router-1100/wp1-status.test.mjs +0 -220
  254. package/test/router-1100/wp1-tools.test.mjs +0 -146
  255. package/test/router-1100/wp5-cli.test.mjs +0 -240
  256. package/test/router-1100/wp5-model-auto.test.mjs +0 -418
  257. package/test/router-1100/wp6-merge.test.mjs +0 -386
  258. package/test/router-1100/wp6-wake.test.mjs +0 -502
  259. package/test/router-background/audit.test.mjs +0 -37
  260. package/test/router-background/budget-ledger.test.mjs +0 -330
  261. package/test/router-background/cross-process.test.mjs +0 -222
  262. package/test/router-background/fixtures/cross-child.mjs +0 -85
  263. package/test/router-background/fixtures/real-shapes.mjs +0 -239
  264. package/test/router-background/router.test.mjs +0 -1044
  265. package/test/router-background/stream-retry.test.mjs +0 -358
  266. package/test/router-background/tool-agent.test.mjs +0 -384
  267. package/test/router-face/bridge.test.mjs +0 -169
  268. package/test/router-face/face.test.mjs +0 -316
  269. package/test/router-failclosed.test.mjs +0 -466
  270. package/test/router-identity.test.mjs +0 -384
  271. package/test/router-l1-l2.contract.test.mjs +0 -1075
  272. package/test/router-memory-tools.test.mjs +0 -262
  273. package/test/router-policy.test.mjs +0 -225
  274. package/test/router-runtime.test.mjs +0 -438
  275. package/test/router-shadow.test.mjs +0 -287
  276. package/test/router.test.mjs +0 -903
  277. package/test/run-rc.mjs +0 -299
  278. package/test/run.mjs +0 -2469
  279. package/test/safety-defaults.test.mjs +0 -179
  280. package/test/seeded-load.test.mjs +0 -436
  281. package/test/session-original.test.mjs +0 -338
  282. package/test/surgery-recovery.test.mjs +0 -936
  283. package/test/t7_drive.mjs +0 -151
  284. package/test/tool-output.test.mjs +0 -393
  285. package/test/tool-schema.test.mjs +0 -177
  286. package/test/tools_contract.test.mjs +0 -716
  287. package/test/truncate-visible.test.mjs +0 -1150
  288. package/test/ui-flags.test.mjs +0 -477
  289. package/test/v4-hardening.test.mjs +0 -427
@@ -1,358 +0,0 @@
1
- // test/stream-retry.test.mjs — 真实 stream 契约 + RATE_LIMIT/QUOTA 策略的验收测试
2
- //
3
- // 覆盖 mustFix 7(block 数组 / finish 失败码 / usage / abort 后 drain)与
4
- // mustFix 9(RATE_LIMIT 退避、QUOTA 停、非幂等不重试)。
5
-
6
- import test from 'node:test';
7
- import assert from 'node:assert/strict';
8
- import {
9
- buildMessages,
10
- consumeStream,
11
- normalizeUsage,
12
- } from '../../src/router/background/stream.mjs';
13
- import {
14
- capRetryAfter,
15
- classifyCode,
16
- computeBackoff,
17
- retryOnFailure,
18
- stopReasonFor,
19
- } from '../../src/router/background/retry.mjs';
20
- import { MockLlm } from '../../src/router/background/mock-llm.mjs';
21
-
22
- const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
23
-
24
- async function* fromChunks(chunks, { onReturn } = {}) {
25
- try {
26
- for (const chunk of chunks) {
27
- if (chunk instanceof Error) throw chunk;
28
- if (chunk?.wait) await sleep(chunk.wait);
29
- else yield chunk;
30
- }
31
- } finally {
32
- onReturn?.();
33
- }
34
- }
35
-
36
- test('buildMessages:content 是 block 数组,空 system 不产生空消息', () => {
37
- const messages = buildMessages({ system: '你是路由器', prompt: '处理 t1' });
38
- assert.equal(messages.length, 2);
39
- assert.equal(messages[0].role, 'system');
40
- assert.deepEqual(messages[0].content, [{ type: 'text', text: '你是路由器' }]);
41
- assert.equal(messages[1].role, 'user');
42
- assert.deepEqual(messages[1].content, [{ type: 'text', text: '处理 t1' }]);
43
-
44
- const noSystem = buildMessages({ system: ' ', prompt: 'hi' });
45
- assert.equal(noSystem.length, 1);
46
- assert.equal(noSystem[0].role, 'user');
47
- assert.equal(typeof noSystem[0].content, 'object');
48
- assert.ok(Array.isArray(noSystem[0].content));
49
- });
50
-
51
- test('normalizeUsage:camelCase 为主,snake_case 兼容并标 legacy,total 可显式覆盖、NaN 标 invalid', () => {
52
- assert.deepEqual(normalizeUsage({ inputTokens: 10, outputTokens: 5 }), {
53
- inputTokens: 10, outputTokens: 5, cacheReadTokens: 0, cacheWriteTokens: 0, totalTokens: 15, legacy: false, invalid: false,
54
- });
55
- const legacy = normalizeUsage({ input_tokens: 7, output_tokens: 3, total_tokens: 20 });
56
- assert.equal(legacy.legacy, true);
57
- assert.equal(legacy.totalTokens, 20);
58
- assert.equal(legacy.inputTokens, 7);
59
- // F12:NaN 不得被洗成 0 当免费,必须标 invalid 交给 Router fail-closed。
60
- const nan = normalizeUsage({ inputTokens: NaN, outputTokens: 0 });
61
- assert.equal(nan.invalid, true);
62
- assert.ok(Number.isNaN(nan.totalTokens));
63
- const negative = normalizeUsage({ inputTokens: -5, outputTokens: 0 });
64
- assert.equal(negative.invalid, true);
65
- assert.equal(negative.inputTokens, -5);
66
- assert.equal(normalizeUsage(null), null);
67
- });
68
-
69
- test('consumeStream 正常路径:text-delta 拼接、usage、terminal finish', async () => {
70
- const stream = fromChunks([
71
- { type: 'block-start', index: 0, blockType: 'text' },
72
- { type: 'text-delta', index: 0, text: '你' },
73
- { type: 'text-delta', index: 0, text: '好' },
74
- { type: 'usage', usage: { inputTokens: 11, outputTokens: 2 } },
75
- { type: 'finish', reason: { kind: 'stop' } },
76
- ]);
77
- const result = await consumeStream(stream);
78
- assert.equal(result.ok, true);
79
- assert.equal(result.text, '你好');
80
- assert.equal(result.usage.totalTokens, 13);
81
- assert.equal(result.finish.kind, 'stop');
82
- assert.equal(result.finished, true);
83
- assert.equal(result.missingFinish, false);
84
- assert.equal(result.code, null);
85
- });
86
-
87
- test('consumeStream 失败 finish:读 chunk.reason.failure 的稳定错误码', async () => {
88
- const stream = fromChunks([
89
- { type: 'text-delta', index: 0, text: '部分' },
90
- {
91
- type: 'finish',
92
- reason: {
93
- kind: 'error',
94
- failure: { code: 'RATE_LIMIT', message: 'slow down', providerRetryAfterMs: 1200, status: 429 },
95
- },
96
- },
97
- ]);
98
- const result = await consumeStream(stream);
99
- assert.equal(result.ok, false);
100
- assert.equal(result.code, 'RATE_LIMIT');
101
- assert.equal(result.failure.message, 'slow down');
102
- assert.equal(result.failure.providerRetryAfterMs, 1200);
103
- assert.equal(result.aborted, false);
104
- assert.equal(result.finished, true);
105
- });
106
-
107
- test('consumeStream 缺 finish:返回 E_STREAM_NO_FINISH,不向外抛', async () => {
108
- const stream = fromChunks([
109
- { type: 'text-delta', index: 0, text: '半截' },
110
- ]);
111
- const result = await consumeStream(stream);
112
- assert.equal(result.ok, false);
113
- assert.equal(result.code, 'E_STREAM_NO_FINISH');
114
- assert.equal(result.missingFinish, true);
115
- assert.equal(result.finished, false);
116
- });
117
-
118
- test('consumeStream abort:设置 aborted、drain 到 finish、始终 return() 清理', async () => {
119
- let returned = false;
120
- const controller = new AbortController();
121
- const stream = (async function* () {
122
- try {
123
- yield { type: 'text-delta', index: 0, text: 'a' };
124
- await sleep(30);
125
- yield { type: 'text-delta', index: 0, text: 'b' };
126
- yield { type: 'usage', usage: { inputTokens: 1, outputTokens: 1 } };
127
- yield { type: 'finish', reason: { kind: 'aborted', failure: { code: 'ABORTED' } } };
128
- } finally {
129
- returned = true;
130
- }
131
- })();
132
-
133
- const running = consumeStream(stream, { signal: controller.signal, drainTimeoutMs: 100 });
134
- await sleep(5);
135
- controller.abort('test');
136
- const result = await running;
137
-
138
- assert.equal(result.aborted, true);
139
- assert.equal(result.ok, false);
140
- assert.equal(result.finished, true);
141
- assert.equal(result.finish.kind, 'aborted');
142
- assert.equal(result.code, 'ABORTED');
143
- assert.equal(result.text, 'a');
144
- assert.ok(result.drained >= 1);
145
- assert.equal(returned, true, 'generator finally 必须执行');
146
- });
147
-
148
- test('consumeStream abort 卡住:drain 超时后 return() 有时限,不永久挂起', async () => {
149
- let returned = false;
150
- const controller = new AbortController();
151
- const stream = (async function* () {
152
- try {
153
- yield { type: 'text-delta', index: 0, text: 'x' };
154
- await sleep(200);
155
- yield { type: 'finish', reason: { kind: 'stop' } };
156
- } finally {
157
- returned = true;
158
- }
159
- })();
160
-
161
- const started = Date.now();
162
- const running = consumeStream(stream, {
163
- signal: controller.signal,
164
- drainTimeoutMs: 20,
165
- returnTimeoutMs: 30,
166
- });
167
- await sleep(5);
168
- controller.abort('test');
169
- const result = await running;
170
- const elapsed = Date.now() - started;
171
-
172
- assert.equal(result.aborted, true);
173
- assert.equal(result.drainTimedOut, true);
174
- assert.equal(result.code, 'E_ABORTED');
175
- // P10:旧实现 await iterator.return() 无限期,tick 永远不 settle。
176
- assert.equal(result.returnTimedOut, true, 'return() 必须有超时标记');
177
- assert.ok(elapsed < 180, `consumeStream 返回耗时 ${elapsed}ms,不能等挂住的 generator`);
178
-
179
- // return() 仍然排在这个 generator 的队列里,等它自己的 sleep 结束后 finally 会执行。
180
- await sleep(260);
181
- assert.equal(returned, true, 'generator 最终仍应被清理,只是调用方不再等它');
182
- });
183
-
184
- test('consumeStream 输入不是 AsyncIterable:抛 E_STREAM_NOT_ASYNC_ITERABLE', async () => {
185
- await assert.rejects(
186
- () => consumeStream({ ok: true }),
187
- (error) => error.code === 'E_STREAM_NOT_ASYNC_ITERABLE',
188
- );
189
- });
190
-
191
- test('consumeStream chunk 上限:超限抛 E_STREAM_CHUNK_LIMIT', async () => {
192
- const many = [];
193
- for (let i = 0; i < 5; i += 1) many.push({ type: 'text-delta', index: 0, text: 'x' });
194
- await assert.rejects(
195
- () => consumeStream(fromChunks(many), { maxChunks: 3 }),
196
- (error) => error.code === 'E_STREAM_CHUNK_LIMIT',
197
- );
198
- });
199
-
200
- test('retryOnFailure:RATE_LIMIT 指数退避后成功,attempts 与 onRetry 正确', async () => {
201
- let attempts = 0;
202
- const retries = [];
203
- const result = await retryOnFailure(async (attempt) => {
204
- attempts += 1;
205
- if (attempt < 3) return { failure: { code: 'RATE_LIMIT', message: '429' } };
206
- return { ok: true, value: 'done' };
207
- }, {
208
- maxAttempts: 3,
209
- initialDelayMs: 1,
210
- jitterRatio: 0,
211
- onRetry: (event) => retries.push(event),
212
- });
213
-
214
- assert.equal(result.ok, true);
215
- assert.equal(result.value, 'done');
216
- assert.equal(result.attempts, 3);
217
- assert.equal(attempts, 3);
218
- assert.equal(retries.length, 2);
219
- assert.equal(retries[0].code, 'RATE_LIMIT');
220
- assert.equal(retries[0].delayMs, 1);
221
- });
222
-
223
- test('retryOnFailure:providerRetryAfterMs 优先于指数退避,且封顶 30s', async () => {
224
- const delays = [];
225
- const result = await retryOnFailure(async (attempt) => (
226
- attempt === 1
227
- ? { failure: { code: 'RATE_LIMIT', providerRetryAfterMs: 7 } }
228
- : { ok: true }
229
- ), {
230
- maxAttempts: 2,
231
- initialDelayMs: 1,
232
- onRetry: (event) => delays.push(event.delayMs),
233
- });
234
- assert.equal(result.ok, true);
235
- assert.equal(delays[0], 7);
236
-
237
- // 生产默认上限就是 30s:provider 给多少都不能让后台 tick 睡更久。
238
- assert.equal(capRetryAfter(99999), 30000);
239
- assert.equal(capRetryAfter(-5), 0);
240
-
241
- // 为了不真睡 30s,这里把上限压到 25ms,断言「封顶逻辑」本身。
242
- const capped = [];
243
- await retryOnFailure(async () => ({ failure: { code: 'RATE_LIMIT', providerRetryAfterMs: 99999 } }), {
244
- maxAttempts: 2,
245
- maxRetryAfterMs: 25,
246
- onRetry: (event) => capped.push(event.delayMs),
247
- });
248
- assert.deepEqual(capped, [25], 'provider Retry-After 必须被 maxRetryAfterMs 截断');
249
- });
250
-
251
- test('retryOnFailure:失败 attempt 的 usage 也计入总额(P26:60+30 必须记 90)', async () => {
252
- let calls = 0;
253
- const result = await retryOnFailure(async (attempt) => {
254
- calls += 1;
255
- if (attempt === 1) {
256
- return {
257
- failure: { code: 'SERVER', message: 'upstream 500' },
258
- usage: { inputTokens: 40, outputTokens: 20, totalTokens: 60 },
259
- };
260
- }
261
- return { ok: true, usage: { inputTokens: 20, outputTokens: 10, totalTokens: 30 } };
262
- }, { maxAttempts: 2, initialDelayMs: 1, jitterRatio: 0 });
263
-
264
- assert.equal(calls, 2);
265
- assert.equal(result.ok, true);
266
- assert.equal(result.usage.totalTokens, 90, 'provider 已计费两次,预算必须按 90 扣');
267
- assert.equal(result.usage.inputTokens, 60);
268
- assert.equal(result.usage.outputTokens, 30);
269
- });
270
-
271
- test('retryOnFailure:QUOTA 立即停(quota_exceeded),不重试', async () => {
272
- let calls = 0;
273
- const result = await retryOnFailure(async () => {
274
- calls += 1;
275
- return { failure: { code: 'QUOTA', message: 'quota exhausted' } };
276
- }, { maxAttempts: 5, initialDelayMs: 1 });
277
-
278
- assert.equal(calls, 1);
279
- assert.equal(result.stopReason, 'quota_exceeded');
280
- assert.equal(result.failure.code, 'QUOTA');
281
- });
282
-
283
- test('retryOnFailure:AUTH 不重试(auth_failed),非幂等调用不重试', async () => {
284
- let authCalls = 0;
285
- const auth = await retryOnFailure(async () => {
286
- authCalls += 1;
287
- return { failure: { code: 'AUTH' } };
288
- }, { maxAttempts: 5 });
289
- assert.equal(authCalls, 1);
290
- assert.equal(auth.stopReason, 'auth_failed');
291
-
292
- let sideEffectCalls = 0;
293
- const nonIdempotent = await retryOnFailure(async () => {
294
- sideEffectCalls += 1;
295
- return { failure: { code: 'RATE_LIMIT' } };
296
- }, { maxAttempts: 5, idempotent: false });
297
- assert.equal(sideEffectCalls, 1);
298
- assert.equal(nonIdempotent.retryExhausted, true);
299
- });
300
-
301
- test('retryOnFailure:退避期间 abort 返回 E_ABORTED,不再发下一次', async () => {
302
- const controller = new AbortController();
303
- let calls = 0;
304
- const running = retryOnFailure(async () => {
305
- calls += 1;
306
- return { failure: { code: 'RATE_LIMIT' } };
307
- }, {
308
- maxAttempts: 5,
309
- initialDelayMs: 100,
310
- signal: controller.signal,
311
- onRetry: () => setTimeout(() => controller.abort('stop'), 5),
312
- });
313
- const result = await running;
314
- assert.equal(result.aborted, true);
315
- assert.equal(result.failure.code, 'E_ABORTED');
316
- assert.equal(calls, 1);
317
- });
318
-
319
- test('classifyCode / stopReasonFor / computeBackoff:错误码分类与抖动边界', () => {
320
- assert.equal(classifyCode('RATE_LIMIT'), 'retry');
321
- assert.equal(classifyCode('QUOTA'), 'stop');
322
- assert.equal(classifyCode('AUTH'), 'fatal');
323
- assert.equal(classifyCode('MOCK_CRASH'), 'unknown');
324
- assert.equal(stopReasonFor('ACCOUNT_QUOTA'), 'quota_exceeded');
325
- assert.equal(stopReasonFor('CONTEXT_WINDOW_EXCEEDED'), 'context_window_exceeded');
326
- assert.equal(stopReasonFor('RATE_LIMIT'), null);
327
-
328
- assert.equal(computeBackoff({ attempt: 1, initialDelayMs: 500, jitterRatio: 0 }), 500);
329
- assert.equal(computeBackoff({ attempt: 2, initialDelayMs: 500, jitterRatio: 0 }), 1000);
330
- assert.equal(computeBackoff({ attempt: 99, initialDelayMs: 500, maxDelayMs: 10000, jitterRatio: 0 }), 10000);
331
- const jittered = computeBackoff({ attempt: 1, initialDelayMs: 1000, jitterRatio: 0.5, random: () => 0 });
332
- assert.equal(jittered, 500);
333
- });
334
-
335
- test('MockLlm:拒绝字符串 content,失败注入走 finish.reason.failure,abort 走 aborted finish', async () => {
336
- const bad = new MockLlm().stream({ messages: [{ role: 'user', content: 'hello' }] });
337
- await assert.rejects(async () => {
338
- for await (const _ of bad) { /* should throw before yield */ }
339
- }, (error) => error.code === 'E_MOCK_BAD_MESSAGES');
340
-
341
- const failing = new MockLlm({ failOn: new Map([['t1', 'RATE_LIMIT']]) });
342
- const result = await consumeStream(failing.stream({
343
- messages: buildMessages({ prompt: 'x' }),
344
- task: { id: 't1' },
345
- }));
346
- assert.equal(result.code, 'RATE_LIMIT');
347
- assert.equal(result.finished, true);
348
-
349
- const controller = new AbortController();
350
- controller.abort('test');
351
- const aborted = await consumeStream(new MockLlm().stream({
352
- messages: buildMessages({ prompt: 'x' }),
353
- task: { id: 't2' },
354
- signal: controller.signal,
355
- }));
356
- assert.equal(aborted.aborted, true);
357
- assert.equal(aborted.code, 'ABORTED');
358
- });