@jjh32456/dsh-longlive 1.6.8 → 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 (288) hide show
  1. package/CHANGELOG.md +69 -1539
  2. package/LICENSE +1 -1
  3. package/QUICKSTART.md +33 -12
  4. package/README.en.md +17 -7
  5. package/README.md +29 -10
  6. package/SPEC.md +5 -5
  7. package/cordis.patch.yml +17 -12
  8. package/docs/ANSWER-GUARD.md +92 -0
  9. package/docs/ARCHITECTURE.md +3 -3
  10. package/docs/AUTO-RECALL-WIRING.md +1 -1
  11. package/docs/AUTO-RECALL.md +15 -9
  12. package/docs/CONFIG.md +143 -37
  13. package/docs/ERRORS.md +17 -5
  14. package/docs/FAQ.md +7 -7
  15. package/docs/FEATURES.md +66 -29
  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 +3 -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 +42 -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 +129 -18
  41. package/src/activity/model.js +11 -1
  42. package/src/activity/store.js +22 -3
  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 +145 -48
  58. package/src/deps.js +6 -4
  59. package/src/features.js +158 -8
  60. package/src/identity/index.js +13 -5
  61. package/src/identity/inject-position.js +2 -2
  62. package/src/index.js +97 -7
  63. package/src/lifecycle/gap-clocks.js +328 -0
  64. package/src/lifecycle/index.js +269 -0
  65. package/src/memory/activity-capture.js +229 -0
  66. package/src/memory/anchors.js +194 -0
  67. package/src/memory/audit-records.js +222 -0
  68. package/src/memory/auto-cards.js +401 -0
  69. package/src/memory/capture.js +442 -0
  70. package/src/memory/card-anchors.js +203 -0
  71. package/src/memory/conflicts.js +106 -0
  72. package/src/memory/decay.js +311 -0
  73. package/src/memory/distill.js +471 -0
  74. package/src/memory/event-index.js +917 -0
  75. package/src/memory/evidence-chain.js +295 -0
  76. package/src/memory/evidence.js +145 -0
  77. package/src/memory/filter-runner.js +1 -1
  78. package/src/memory/filter.js +5 -1
  79. package/src/memory/forget-v2.js +410 -0
  80. package/src/memory/forget.js +71 -0
  81. package/src/memory/frames-activation.js +247 -0
  82. package/src/memory/fts-query.js +174 -0
  83. package/src/memory/governance.js +604 -0
  84. package/src/memory/index.js +1 -0
  85. package/src/memory/l2-gate.js +169 -0
  86. package/src/memory/lock.js +121 -0
  87. package/src/memory/migrate.js +139 -0
  88. package/src/memory/recall-v2.js +223 -0
  89. package/src/memory/recall.js +65 -2
  90. package/src/memory/records.js +425 -0
  91. package/src/memory/retention.js +128 -0
  92. package/src/memory/review.js +124 -0
  93. package/src/memory/trust.js +88 -0
  94. package/src/memory/version-chain.js +264 -0
  95. package/src/memory/wal.js +137 -0
  96. package/src/memory/working-frame.js +516 -0
  97. package/src/metrics/classify.mjs +5 -3
  98. package/src/metrics/index.mjs +21 -1
  99. package/src/metrics/prestep-latency.mjs +300 -0
  100. package/src/metrics/store.mjs +25 -0
  101. package/src/policy-profile.js +18 -3
  102. package/src/recall/anaphora.mjs +87 -0
  103. package/src/recall/cards.mjs +7 -0
  104. package/src/recall/embedding.mjs +8 -8
  105. package/src/recall/entities.mjs +112 -0
  106. package/src/recall/index.js +235 -19
  107. package/src/recall/inject-order.mjs +10 -8
  108. package/src/recall/privacy.mjs +1 -1
  109. package/src/recall/recall-core.mjs +116 -10
  110. package/src/recall/shared-visibility.js +302 -0
  111. package/src/recall/time-normalizer.mjs +196 -0
  112. package/src/role/activation.js +191 -0
  113. package/src/role/attention.js +318 -0
  114. package/src/role/base.js +36 -0
  115. package/src/role/channels.js +423 -0
  116. package/src/role/index.js +425 -0
  117. package/src/role/interfaces.js +115 -0
  118. package/src/role/personality.js +370 -0
  119. package/src/role/readers.js +151 -0
  120. package/src/role/relationships.js +477 -0
  121. package/src/role/store.js +202 -0
  122. package/src/role/writeprotect.js +373 -0
  123. package/src/router/aliases.json +176 -25
  124. package/src/router/background/agent-runner.mjs +1 -1
  125. package/src/router/background/anchor.mjs +1 -1
  126. package/src/router/background/audit.mjs +2 -2
  127. package/src/router/background/budget-ledger.mjs +2 -2
  128. package/src/router/background/host-sim.mjs +1 -1
  129. package/src/router/background/memory.mjs +4 -4
  130. package/src/router/background/queue.mjs +1 -1
  131. package/src/router/background/retry.mjs +1 -1
  132. package/src/router/background/router.mjs +1 -1
  133. package/src/router/background/stream.mjs +1 -1
  134. package/src/router/background/tool-policy.mjs +1 -1
  135. package/src/router/design-headings.json +5 -5
  136. package/src/router/face/config.mjs +1 -1
  137. package/src/router/face/identity.mjs +3 -3
  138. package/src/router/judge.mjs +8 -7
  139. package/src/router/policies/generic.json +21 -4
  140. package/src/router/route.js +109 -22
  141. package/src/router/router.mjs +10 -6
  142. package/src/router/routing-rules.json +260 -445
  143. package/src/router/run-sim.mjs +8 -8
  144. package/src/router/runtime.js +23 -12
  145. package/src/router/service/config.mjs +5 -5
  146. package/src/router/service/context.mjs +1 -1
  147. package/src/router/service/queue.mjs +1 -1
  148. package/src/router/shadow.mjs +4 -3
  149. package/src/surgery-recovery.js +2 -2
  150. package/src/tool-output.js +2 -2
  151. package/src/tools.js +39 -7
  152. package/src/truncate-visible.js +2 -2
  153. package/src/ui/actions.js +1312 -0
  154. package/src/ui/panel-api.js +367 -0
  155. package/src/ui/panel-auth.js +251 -0
  156. package/src/ui/panel-integrity.js +243 -0
  157. package/src/ui/routes-readonly.js +695 -0
  158. package/src/ui/routes.js +3 -0
  159. package/docs/DEV.md +0 -279
  160. package/docs/PRESENCE-BUS-WIRING.md +0 -491
  161. package/docs/PRESENCE-BUS.md +0 -694
  162. package/docs/SURGERY.md +0 -186
  163. package/scripts/mark-core-cards.mjs +0 -289
  164. package/scripts/pack.mjs +0 -392
  165. package/scripts/router-proposals.mjs +0 -386
  166. package/src/router/fixtures/M1.json +0 -16
  167. package/src/router/fixtures/M2.json +0 -16
  168. package/src/router/fixtures/M3.json +0 -20
  169. package/src/router/fixtures/M4.json +0 -20
  170. package/src/router/fixtures/M5.json +0 -45
  171. package/src/router/fixtures/M6.json +0 -53
  172. package/src/router/fixtures/M7.json +0 -46
  173. package/src/router/fixtures/S1.json +0 -20
  174. package/src/router/fixtures/S2.json +0 -23
  175. package/src/router/fixtures/S3.json +0 -20
  176. package/src/router/fixtures/S4.json +0 -34
  177. package/src/router/fixtures/S5.json +0 -43
  178. package/src/router/fixtures/S6.json +0 -47
  179. package/src/router/fixtures/T1.json +0 -23
  180. package/src/router/fixtures/T2.json +0 -16
  181. package/src/router/fixtures/T3.json +0 -19
  182. package/src/router/fixtures/T4.json +0 -16
  183. package/src/router/fixtures/X1.json +0 -17
  184. package/src/router/fixtures/X2.json +0 -20
  185. package/src/router/gen-design-headings.mjs +0 -107
  186. package/src/router/policies/owner-rulings-2026-11-03.json +0 -62
  187. package/test/activity-realtime.test.mjs +0 -959
  188. package/test/activity-stream.test.mjs +0 -512
  189. package/test/auto-recall.test.mjs +0 -474
  190. package/test/auto-truncate.test.mjs +0 -931
  191. package/test/autobind.test.mjs +0 -399
  192. package/test/bus.test.mjs +0 -1572
  193. package/test/cli-guard.test.mjs +0 -198
  194. package/test/conclusion.test.mjs +0 -408
  195. package/test/config-schema.test.mjs +0 -210
  196. package/test/d6-output.test.mjs +0 -194
  197. package/test/d6.test.mjs +0 -395
  198. package/test/deps.test.mjs +0 -342
  199. package/test/doctor-setup.test.mjs +0 -297
  200. package/test/embedding-recall.test.mjs +0 -347
  201. package/test/feature-flags.test.mjs +0 -585
  202. package/test/filter-shadow.test.mjs +0 -170
  203. package/test/fixtures/activity-append-child.mjs +0 -29
  204. package/test/fixtures/baseline-0.8.0-registration.json +0 -556
  205. package/test/fixtures/d6-header-tools.json +0 -1
  206. package/test/fixtures/lock-child.mjs +0 -67
  207. package/test/fixtures/pre-step-container.mjs +0 -100
  208. package/test/fixtures/privacy-memory/topics/pii-unmarked.md +0 -9
  209. package/test/fixtures/privacy-memory/topics/secret-local-only.md +0 -11
  210. package/test/fixtures/profile-session-longlive-config.json +0 -20
  211. package/test/fixtures/proposal-cas-child.mjs +0 -66
  212. package/test/host-engine-status.test.mjs +0 -307
  213. package/test/hot-truncate.test.mjs +0 -1349
  214. package/test/identity-card-marker.test.mjs +0 -307
  215. package/test/identity-router/run.mjs +0 -721
  216. package/test/integration-pre-step.test.mjs +0 -553
  217. package/test/live.test.mjs +0 -1023
  218. package/test/maintenance-schedule.test.mjs +0 -538
  219. package/test/memory.test.mjs +0 -2828
  220. package/test/metrics.test.mjs +0 -478
  221. package/test/orchestrator.test.mjs +0 -266
  222. package/test/p1_probe.mjs +0 -97
  223. package/test/packaging.test.mjs +0 -184
  224. package/test/portability.test.mjs +0 -343
  225. package/test/rc4-regressions.test.mjs +0 -562
  226. package/test/rc5-regressions.test.mjs +0 -197
  227. package/test/rc6-chinese.test.mjs +0 -394
  228. package/test/router-1100/apply-off.test.mjs +0 -175
  229. package/test/router-1100/budget-reconcile.test.mjs +0 -215
  230. package/test/router-1100/config-context.test.mjs +0 -211
  231. package/test/router-1100/helpers.mjs +0 -129
  232. package/test/router-1100/hint-envelope.test.mjs +0 -150
  233. package/test/router-1100/lock-crossproc.test.mjs +0 -206
  234. package/test/router-1100/proposal-cas-crossproc.test.mjs +0 -184
  235. package/test/router-1100/router-apply.test.mjs +0 -372
  236. package/test/router-1100/router-fixb.test.mjs +0 -602
  237. package/test/router-1100/router-proposals.test.mjs +0 -405
  238. package/test/router-1100/router-queue-lease-wal.test.mjs +0 -355
  239. package/test/router-1100/router-security-cr.test.mjs +0 -333
  240. package/test/router-1100/service-lifecycle.test.mjs +0 -220
  241. package/test/router-1100/tools-contract.test.mjs +0 -164
  242. package/test/router-1100/turn-reflect-tick.test.mjs +0 -89
  243. package/test/router-1100/v6-contract.test.mjs +0 -158
  244. package/test/router-1100/v6b-contract.test.mjs +0 -293
  245. package/test/router-1100/v6c-contract.test.mjs +0 -249
  246. package/test/router-1100/wal-rotation.test.mjs +0 -375
  247. package/test/router-1100/wp1-config.test.mjs +0 -170
  248. package/test/router-1100/wp1-default-off.test.mjs +0 -77
  249. package/test/router-1100/wp1-model-status.test.mjs +0 -90
  250. package/test/router-1100/wp1-status.test.mjs +0 -220
  251. package/test/router-1100/wp1-tools.test.mjs +0 -146
  252. package/test/router-1100/wp5-cli.test.mjs +0 -240
  253. package/test/router-1100/wp5-model-auto.test.mjs +0 -418
  254. package/test/router-1100/wp6-merge.test.mjs +0 -386
  255. package/test/router-1100/wp6-wake.test.mjs +0 -502
  256. package/test/router-background/audit.test.mjs +0 -37
  257. package/test/router-background/budget-ledger.test.mjs +0 -330
  258. package/test/router-background/cross-process.test.mjs +0 -222
  259. package/test/router-background/fixtures/cross-child.mjs +0 -85
  260. package/test/router-background/fixtures/real-shapes.mjs +0 -239
  261. package/test/router-background/router.test.mjs +0 -1076
  262. package/test/router-background/stream-retry.test.mjs +0 -358
  263. package/test/router-background/tool-agent.test.mjs +0 -384
  264. package/test/router-face/bridge.test.mjs +0 -169
  265. package/test/router-face/face.test.mjs +0 -316
  266. package/test/router-failclosed.test.mjs +0 -466
  267. package/test/router-identity.test.mjs +0 -384
  268. package/test/router-l1-l2.contract.test.mjs +0 -1075
  269. package/test/router-memory-tools.test.mjs +0 -262
  270. package/test/router-policy.test.mjs +0 -225
  271. package/test/router-runtime.test.mjs +0 -438
  272. package/test/router-shadow.test.mjs +0 -287
  273. package/test/router.test.mjs +0 -903
  274. package/test/run-rc.mjs +0 -315
  275. package/test/run.mjs +0 -2469
  276. package/test/safety-defaults.test.mjs +0 -181
  277. package/test/seeded-load.test.mjs +0 -436
  278. package/test/session-original.test.mjs +0 -338
  279. package/test/state-truth.test.mjs +0 -937
  280. package/test/surgery-recovery.test.mjs +0 -936
  281. package/test/t7_drive.mjs +0 -151
  282. package/test/tool-output.test.mjs +0 -393
  283. package/test/tool-schema.test.mjs +0 -177
  284. package/test/tools_contract.test.mjs +0 -716
  285. package/test/truncate-visible.test.mjs +0 -1150
  286. package/test/ui-flags.test.mjs +0 -477
  287. package/test/v4-hardening.test.mjs +0 -427
  288. package/test/version-consistency.test.mjs +0 -286
@@ -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
- });