@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.
- package/CHANGELOG.md +70 -1508
- package/LICENSE +1 -1
- package/QUICKSTART.md +34 -13
- package/README.en.md +18 -7
- package/README.md +34 -9
- package/SPEC.md +5 -5
- package/cordis.patch.yml +23 -9
- package/docs/ANSWER-GUARD.md +92 -0
- package/docs/ARCHITECTURE.md +4 -3
- package/docs/AUTO-RECALL-WIRING.md +1 -1
- package/docs/AUTO-RECALL.md +15 -9
- package/docs/CONFIG.md +168 -35
- package/docs/ERRORS.md +17 -5
- package/docs/FAQ.md +7 -7
- package/docs/FEATURES.md +96 -28
- package/docs/MIGRATION-1.6.0.md +2 -2
- package/docs/OPERATIONS.md +6 -6
- package/docs/PANEL-INTEGRATION.md +6 -0
- package/docs/PRIVACY.md +88 -0
- package/docs/QUICKSTART.md +5 -5
- package/docs/README.en.md +4 -2
- package/docs/RESIDENT-WATCHER.md +1 -1
- package/docs/SESSION-WATCH.md +6 -6
- package/docs/TROUBLESHOOTING.md +4 -4
- package/package.json +47 -117
- package/runbook.md +2 -2
- package/scripts/backfill-auto-cards.mjs +98 -0
- package/scripts/install-surgery-task.ps1 +5 -2
- package/scripts/lib/session-watch-fixture.mjs +1 -1
- package/scripts/longlive-doctor.mjs +6 -0
- package/scripts/migrate-180.mjs +163 -0
- package/scripts/recall-index-build.mjs +128 -0
- package/scripts/session-watch-drill.mjs +1 -1
- package/scripts/surgery-run.cmd +1 -1
- package/scripts/unattended-surgery.ps1 +5 -2
- package/scripts/verify-card-anchors.mjs +138 -0
- package/src/actions/audit.js +125 -0
- package/src/actions/evidence.js +122 -0
- package/src/actions/fs.js +162 -0
- package/src/activity/index.js +760 -0
- package/src/activity/model.js +351 -0
- package/src/activity/store.js +644 -0
- package/src/activity/thinking.js +176 -0
- package/src/adapters/constants.js +11 -0
- package/src/adapters/engram/data/aliases.json +51 -0
- package/src/adapters/engram/data/policy.json +8 -0
- package/src/adapters/engram/data/routing-rules.json +546 -0
- package/src/adapters/engram/index.js +235 -0
- package/src/adapters/registry.js +315 -0
- package/src/answer/audit.js +193 -0
- package/src/answer/evidence.js +30 -0
- package/src/answer/guard.js +1370 -0
- package/src/answer/index.js +1067 -0
- package/src/answer/query.js +111 -0
- package/src/answer/second-hop.mjs +101 -0
- package/src/auto-truncate.js +1 -1
- package/src/config.js +171 -47
- package/src/deps.js +6 -4
- package/src/features.js +182 -6
- package/src/heartbeat.js +156 -23
- package/src/identity/handover.js +52 -1
- package/src/identity/index.js +13 -5
- package/src/identity/inject-position.js +2 -2
- package/src/index.js +97 -7
- package/src/lifecycle/gap-clocks.js +328 -0
- package/src/lifecycle/index.js +269 -0
- package/src/live.js +22 -2
- package/src/memory/activity-capture.js +229 -0
- package/src/memory/anchors.js +194 -0
- package/src/memory/audit-records.js +222 -0
- package/src/memory/auto-cards.js +401 -0
- package/src/memory/capture.js +442 -0
- package/src/memory/card-anchors.js +203 -0
- package/src/memory/conflicts.js +106 -0
- package/src/memory/decay.js +311 -0
- package/src/memory/distill.js +471 -0
- package/src/memory/event-index.js +917 -0
- package/src/memory/evidence-chain.js +295 -0
- package/src/memory/evidence.js +145 -0
- package/src/memory/filter-runner.js +1 -1
- package/src/memory/filter.js +5 -1
- package/src/memory/forget-v2.js +410 -0
- package/src/memory/forget.js +71 -0
- package/src/memory/frames-activation.js +247 -0
- package/src/memory/fts-query.js +174 -0
- package/src/memory/governance.js +604 -0
- package/src/memory/index.js +1 -0
- package/src/memory/l2-gate.js +169 -0
- package/src/memory/lock.js +121 -0
- package/src/memory/migrate.js +139 -0
- package/src/memory/recall-v2.js +223 -0
- package/src/memory/recall.js +65 -2
- package/src/memory/records.js +425 -0
- package/src/memory/retention.js +128 -0
- package/src/memory/review.js +124 -0
- package/src/memory/trust.js +88 -0
- package/src/memory/version-chain.js +264 -0
- package/src/memory/wal.js +137 -0
- package/src/memory/working-frame.js +516 -0
- package/src/metrics/classify.mjs +5 -3
- package/src/metrics/index.mjs +21 -1
- package/src/metrics/prestep-latency.mjs +300 -0
- package/src/metrics/store.mjs +25 -0
- package/src/policy-profile.js +18 -3
- package/src/recall/anaphora.mjs +87 -0
- package/src/recall/cards.mjs +7 -0
- package/src/recall/embedding.mjs +8 -8
- package/src/recall/entities.mjs +112 -0
- package/src/recall/index.js +235 -19
- package/src/recall/inject-order.mjs +10 -8
- package/src/recall/privacy.mjs +105 -16
- package/src/recall/recall-core.mjs +116 -10
- package/src/recall/shared-visibility.js +302 -0
- package/src/recall/time-normalizer.mjs +196 -0
- package/src/role/activation.js +191 -0
- package/src/role/attention.js +318 -0
- package/src/role/base.js +36 -0
- package/src/role/channels.js +423 -0
- package/src/role/index.js +425 -0
- package/src/role/interfaces.js +115 -0
- package/src/role/personality.js +370 -0
- package/src/role/readers.js +151 -0
- package/src/role/relationships.js +477 -0
- package/src/role/store.js +202 -0
- package/src/role/writeprotect.js +373 -0
- package/src/router/aliases.json +176 -25
- package/src/router/background/agent-runner.mjs +1 -1
- package/src/router/background/anchor.mjs +1 -1
- package/src/router/background/audit.mjs +2 -2
- package/src/router/background/budget-ledger.mjs +2 -2
- package/src/router/background/host-sim.mjs +1 -1
- package/src/router/background/memory.mjs +4 -4
- package/src/router/background/queue.mjs +1 -1
- package/src/router/background/retry.mjs +1 -1
- package/src/router/background/router.mjs +1 -1
- package/src/router/background/stream.mjs +1 -1
- package/src/router/background/tool-policy.mjs +1 -1
- package/src/router/design-headings.json +5 -5
- package/src/router/face/config.mjs +1 -1
- package/src/router/face/identity.mjs +3 -3
- package/src/router/judge.mjs +8 -7
- package/src/router/policies/generic.json +21 -4
- package/src/router/route.js +109 -22
- package/src/router/router.mjs +10 -6
- package/src/router/routing-rules.json +260 -445
- package/src/router/run-sim.mjs +8 -8
- package/src/router/runtime.js +23 -12
- package/src/router/service/board.mjs +95 -15
- package/src/router/service/config.mjs +5 -5
- package/src/router/service/context.mjs +1 -1
- package/src/router/service/hint.mjs +14 -0
- package/src/router/service/queue.mjs +1 -1
- package/src/router/service/service.mjs +27 -11
- package/src/router/shadow.mjs +4 -3
- package/src/surgery-recovery.js +2 -2
- package/src/tool-output.js +2 -2
- package/src/tools.js +39 -7
- package/src/truncate-visible.js +2 -2
- package/src/ui/actions.js +1312 -0
- package/src/ui/panel-api.js +367 -0
- package/src/ui/panel-auth.js +251 -0
- package/src/ui/panel-integrity.js +243 -0
- package/src/ui/routes-readonly.js +695 -0
- package/src/ui/routes.js +3 -0
- package/docs/DEV.md +0 -279
- package/docs/PRESENCE-BUS-WIRING.md +0 -491
- package/docs/PRESENCE-BUS.md +0 -694
- package/docs/SURGERY.md +0 -186
- package/scripts/mark-core-cards.mjs +0 -289
- package/scripts/pack.mjs +0 -392
- package/scripts/router-proposals.mjs +0 -386
- package/src/router/fixtures/M1.json +0 -16
- package/src/router/fixtures/M2.json +0 -16
- package/src/router/fixtures/M3.json +0 -20
- package/src/router/fixtures/M4.json +0 -20
- package/src/router/fixtures/M5.json +0 -45
- package/src/router/fixtures/M6.json +0 -53
- package/src/router/fixtures/M7.json +0 -46
- package/src/router/fixtures/S1.json +0 -20
- package/src/router/fixtures/S2.json +0 -23
- package/src/router/fixtures/S3.json +0 -20
- package/src/router/fixtures/S4.json +0 -34
- package/src/router/fixtures/S5.json +0 -43
- package/src/router/fixtures/S6.json +0 -47
- package/src/router/fixtures/T1.json +0 -23
- package/src/router/fixtures/T2.json +0 -16
- package/src/router/fixtures/T3.json +0 -19
- package/src/router/fixtures/T4.json +0 -16
- package/src/router/fixtures/X1.json +0 -17
- package/src/router/fixtures/X2.json +0 -20
- package/src/router/gen-design-headings.mjs +0 -107
- package/src/router/policies/owner-rulings-2026-11-03.json +0 -62
- package/test/auto-recall.test.mjs +0 -474
- package/test/auto-truncate.test.mjs +0 -931
- package/test/autobind.test.mjs +0 -385
- package/test/bus.test.mjs +0 -1572
- package/test/cli-guard.test.mjs +0 -198
- package/test/conclusion.test.mjs +0 -408
- package/test/config-schema.test.mjs +0 -204
- package/test/d6-output.test.mjs +0 -194
- package/test/d6.test.mjs +0 -395
- package/test/deps.test.mjs +0 -342
- package/test/doctor-setup.test.mjs +0 -297
- package/test/embedding-recall.test.mjs +0 -347
- package/test/feature-flags.test.mjs +0 -568
- package/test/filter-shadow.test.mjs +0 -170
- package/test/fixtures/baseline-0.8.0-registration.json +0 -556
- package/test/fixtures/d6-header-tools.json +0 -1
- package/test/fixtures/lock-child.mjs +0 -67
- package/test/fixtures/pre-step-container.mjs +0 -100
- package/test/fixtures/privacy-memory/topics/pii-unmarked.md +0 -9
- package/test/fixtures/privacy-memory/topics/secret-local-only.md +0 -11
- package/test/fixtures/profile-session-longlive-config.json +0 -20
- package/test/fixtures/proposal-cas-child.mjs +0 -66
- package/test/host-engine-status.test.mjs +0 -307
- package/test/hot-truncate.test.mjs +0 -1349
- package/test/identity-card-marker.test.mjs +0 -307
- package/test/identity-router/run.mjs +0 -721
- package/test/integration-pre-step.test.mjs +0 -553
- package/test/live.test.mjs +0 -1020
- package/test/maintenance-schedule.test.mjs +0 -538
- package/test/memory.test.mjs +0 -2828
- package/test/metrics.test.mjs +0 -478
- package/test/orchestrator.test.mjs +0 -266
- package/test/p1_probe.mjs +0 -97
- package/test/packaging.test.mjs +0 -182
- package/test/portability.test.mjs +0 -343
- package/test/rc4-regressions.test.mjs +0 -562
- package/test/rc5-regressions.test.mjs +0 -197
- package/test/rc6-chinese.test.mjs +0 -394
- package/test/router-1100/apply-off.test.mjs +0 -175
- package/test/router-1100/budget-reconcile.test.mjs +0 -215
- package/test/router-1100/config-context.test.mjs +0 -211
- package/test/router-1100/helpers.mjs +0 -129
- package/test/router-1100/hint-envelope.test.mjs +0 -150
- package/test/router-1100/lock-crossproc.test.mjs +0 -206
- package/test/router-1100/proposal-cas-crossproc.test.mjs +0 -184
- package/test/router-1100/router-apply.test.mjs +0 -372
- package/test/router-1100/router-fixb.test.mjs +0 -602
- package/test/router-1100/router-proposals.test.mjs +0 -405
- package/test/router-1100/router-queue-lease-wal.test.mjs +0 -355
- package/test/router-1100/router-security-cr.test.mjs +0 -333
- package/test/router-1100/service-lifecycle.test.mjs +0 -220
- package/test/router-1100/tools-contract.test.mjs +0 -164
- package/test/router-1100/turn-reflect-tick.test.mjs +0 -89
- package/test/router-1100/v6-contract.test.mjs +0 -158
- package/test/router-1100/v6b-contract.test.mjs +0 -293
- package/test/router-1100/v6c-contract.test.mjs +0 -249
- package/test/router-1100/wal-rotation.test.mjs +0 -375
- package/test/router-1100/wp1-config.test.mjs +0 -170
- package/test/router-1100/wp1-default-off.test.mjs +0 -77
- package/test/router-1100/wp1-model-status.test.mjs +0 -90
- package/test/router-1100/wp1-status.test.mjs +0 -220
- package/test/router-1100/wp1-tools.test.mjs +0 -146
- package/test/router-1100/wp5-cli.test.mjs +0 -240
- package/test/router-1100/wp5-model-auto.test.mjs +0 -418
- package/test/router-1100/wp6-merge.test.mjs +0 -386
- package/test/router-1100/wp6-wake.test.mjs +0 -502
- package/test/router-background/audit.test.mjs +0 -37
- package/test/router-background/budget-ledger.test.mjs +0 -330
- package/test/router-background/cross-process.test.mjs +0 -222
- package/test/router-background/fixtures/cross-child.mjs +0 -85
- package/test/router-background/fixtures/real-shapes.mjs +0 -239
- package/test/router-background/router.test.mjs +0 -1044
- package/test/router-background/stream-retry.test.mjs +0 -358
- package/test/router-background/tool-agent.test.mjs +0 -384
- package/test/router-face/bridge.test.mjs +0 -169
- package/test/router-face/face.test.mjs +0 -316
- package/test/router-failclosed.test.mjs +0 -466
- package/test/router-identity.test.mjs +0 -384
- package/test/router-l1-l2.contract.test.mjs +0 -1075
- package/test/router-memory-tools.test.mjs +0 -262
- package/test/router-policy.test.mjs +0 -225
- package/test/router-runtime.test.mjs +0 -438
- package/test/router-shadow.test.mjs +0 -287
- package/test/router.test.mjs +0 -903
- package/test/run-rc.mjs +0 -299
- package/test/run.mjs +0 -2469
- package/test/safety-defaults.test.mjs +0 -179
- package/test/seeded-load.test.mjs +0 -436
- package/test/session-original.test.mjs +0 -338
- package/test/surgery-recovery.test.mjs +0 -936
- package/test/t7_drive.mjs +0 -151
- package/test/tool-output.test.mjs +0 -393
- package/test/tool-schema.test.mjs +0 -177
- package/test/tools_contract.test.mjs +0 -716
- package/test/truncate-visible.test.mjs +0 -1150
- package/test/ui-flags.test.mjs +0 -477
- 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
|
-
});
|