@hugesb/dsh-stream-agent 0.0.0-stage → 0.3.2

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 (161) hide show
  1. package/CHANGELOG.md +622 -0
  2. package/CONTRIBUTING.md +72 -0
  3. package/LICENSE +202 -0
  4. package/README.en.md +349 -0
  5. package/README.md +300 -3
  6. package/cordis.patch.yml +77 -0
  7. package/dist/entry/action-gate.js +206 -0
  8. package/dist/entry/adapter-kit.js +192 -0
  9. package/dist/entry/context-render.js +119 -0
  10. package/dist/entry/control-bar-cli.js +289 -0
  11. package/dist/entry/control-bar.js +123 -0
  12. package/dist/entry/control-session.js +115 -0
  13. package/dist/entry/control-state.js +125 -0
  14. package/dist/entry/cordis-compat.js +95 -0
  15. package/dist/entry/eval-probe.js +112 -0
  16. package/dist/entry/intent-log.js +121 -0
  17. package/dist/entry/json-persistence.js +306 -0
  18. package/dist/entry/loop.js +4163 -0
  19. package/dist/entry/mock-provider.js +549 -0
  20. package/dist/entry/obs-broker.js +178 -0
  21. package/dist/entry/ptc-bridge.js +405 -0
  22. package/dist/entry/state-handle.js +217 -0
  23. package/dist/entry/takeover-registry.js +60 -0
  24. package/dist/kernel/control-bar.js +559 -0
  25. package/dist/kernel/final.js +62 -0
  26. package/dist/kernel/gate.js +464 -0
  27. package/dist/kernel/modes.js +253 -0
  28. package/dist/kernel/obs.js +517 -0
  29. package/dist/kernel/parser.js +1081 -0
  30. package/dist/kernel/render.js +466 -0
  31. package/dist/kernel/state.js +416 -0
  32. package/dist/version.js +9 -0
  33. package/docs/TEST-PROPOSITIONS.md +139 -0
  34. package/docs/adr-001-segment-boundary.md +61 -0
  35. package/docs/architecture.md +104 -0
  36. package/docs/desktop-ui-feasibility.md +277 -0
  37. package/docs/disabled-lines-audit.md +53 -0
  38. package/docs/limitations.md +181 -0
  39. package/docs/protocol.md +99 -0
  40. package/docs/v0.4.0-plan.md +50 -0
  41. package/eval/METRICS.md +128 -0
  42. package/eval/RESULTS.md +246 -0
  43. package/eval/tasks/fixtures/big-report.md +298 -0
  44. package/eval/tasks/fixtures/build-manifest.txt +5 -0
  45. package/eval/tasks/fixtures/deploy.yaml +4 -0
  46. package/eval/tasks/fixtures/error.log +200 -0
  47. package/eval/tasks/fixtures/features.yaml +4 -0
  48. package/eval/tasks/fixtures/pipeline.yaml +4 -0
  49. package/eval/tasks/fixtures/sales-q1.csv +61 -0
  50. package/eval/tasks/fixtures/settings.yaml +4 -0
  51. package/eval/tasks/fixtures/users-roster.json +304 -0
  52. package/eval/tasks/fixtures/users-scores.json +20 -0
  53. package/eval/tasks/gen-fixtures.cjs +80 -0
  54. package/eval/tasks/tasks.json +150 -0
  55. package/eval/tools/f6-kill-drill.cjs +176 -0
  56. package/eval/tools/f6-kill-drill.worker.cjs +131 -0
  57. package/eval/tools/gen-results.cjs +191 -0
  58. package/eval/tools/machine-test.cjs +200 -0
  59. package/eval/tools/manual-code-scenarios.md +59 -0
  60. package/eval/tools/replay-check.cjs +311 -0
  61. package/eval/tools/runner.cjs +219 -0
  62. package/eval/tools/session-log.cjs +106 -0
  63. package/eval/tools/summarize.cjs +185 -0
  64. package/eval/tools/t3-cells.cjs +173 -0
  65. package/package.json +73 -6
  66. package/patches/adapters-smoke.yml +41 -0
  67. package/patches/eval-account.yml +36 -0
  68. package/patches/eval-baseline.yml +33 -0
  69. package/patches/eval-stream-code-off.yml +46 -0
  70. package/patches/eval-stream-code-on.yml +47 -0
  71. package/patches/eval-stream.yml +54 -0
  72. package/patches/takeover.yml +42 -0
  73. package/patches/test-preset.yml +23 -0
  74. package/preset/stream/cordis.patch.yml +39 -0
  75. package/preset/stream/package.json +13 -0
  76. package/preset.yml +56 -0
  77. package/profiles/stream/README.md +66 -0
  78. package/profiles/stream/cordis.patch.yml +12 -0
  79. package/profiles/stream/package.json +17 -0
  80. package/profiles/stream-headless/package.json +16 -0
  81. package/scripts/build.mjs +103 -0
  82. package/scripts/check-consistency.mjs +146 -0
  83. package/scripts/gate.mjs +138 -0
  84. package/scripts/install-check.mjs +116 -0
  85. package/scripts/install-cycle.mjs +88 -0
  86. package/scripts/release.mjs +428 -0
  87. package/scripts/repair-session-logs.mjs +498 -0
  88. package/src/entry/action-gate.ts +206 -0
  89. package/src/entry/adapter-kit.ts +192 -0
  90. package/src/entry/context-render.ts +119 -0
  91. package/src/entry/control-bar-cli.ts +289 -0
  92. package/src/entry/control-bar.ts +123 -0
  93. package/src/entry/control-session.ts +115 -0
  94. package/src/entry/control-state.ts +125 -0
  95. package/src/entry/cordis-compat.ts +95 -0
  96. package/src/entry/eval-probe.ts +112 -0
  97. package/src/entry/intent-log.ts +121 -0
  98. package/src/entry/json-persistence.ts +306 -0
  99. package/src/entry/loop.ts +4163 -0
  100. package/src/entry/mock-provider.ts +549 -0
  101. package/src/entry/obs-broker.ts +178 -0
  102. package/src/entry/ptc-bridge.ts +405 -0
  103. package/src/entry/state-handle.ts +217 -0
  104. package/src/entry/takeover-registry.ts +60 -0
  105. package/src/kernel/control-bar.ts +559 -0
  106. package/src/kernel/final.ts +62 -0
  107. package/src/kernel/gate.ts +464 -0
  108. package/src/kernel/modes.ts +253 -0
  109. package/src/kernel/obs.ts +517 -0
  110. package/src/kernel/parser.ts +1081 -0
  111. package/src/kernel/render.ts +466 -0
  112. package/src/kernel/state.ts +416 -0
  113. package/src/version.ts +9 -0
  114. package/test/activation.test.ts +187 -0
  115. package/test/adapters.test.ts +676 -0
  116. package/test/control-bar.test.ts +486 -0
  117. package/test/desktop-ui.test.ts +359 -0
  118. package/test/eval-probe.test.ts +139 -0
  119. package/test/f5-plan.test.ts +221 -0
  120. package/test/f6-intent.test.ts +168 -0
  121. package/test/f7-segment.test.ts +190 -0
  122. package/test/fix-limits.test.ts +599 -0
  123. package/test/gate.test.ts +380 -0
  124. package/test/helpers/stub-loop.ts +240 -0
  125. package/test/host-conformance.test.ts +418 -0
  126. package/test/kernel/obs.test.ts +329 -0
  127. package/test/kernel/parser.test.ts +451 -0
  128. package/test/loop.test.ts +1393 -0
  129. package/test/mock-provider.test.ts +386 -0
  130. package/test/ptc-bridge.test.ts +356 -0
  131. package/test/render.test.ts +418 -0
  132. package/test/s2-install-check.test.ts +46 -0
  133. package/test/scenarios/3-file-basic.json +13 -0
  134. package/test/scenarios/5-file-basic.json +22 -0
  135. package/test/scenarios/burn-more.json +9 -0
  136. package/test/scenarios/degraded-final.json +10 -0
  137. package/test/scenarios/fault-abort-xml.json +11 -0
  138. package/test/scenarios/fault-malformed-command.json +12 -0
  139. package/test/scenarios/fault-midstream-abort.json +11 -0
  140. package/test/scenarios/fault-saturating-output.json +9 -0
  141. package/test/scenarios/fault-timeout.json +9 -0
  142. package/test/scenarios/peek-first.json +11 -0
  143. package/test/scenarios/peek-second.json +11 -0
  144. package/test/scenarios/peek-third.json +10 -0
  145. package/test/scenarios/recover-final.json +10 -0
  146. package/test/scenarios/reroute-first.json +17 -0
  147. package/test/scenarios/reroute-second.json +16 -0
  148. package/test/scenarios/starvation-final.json +10 -0
  149. package/test/scenarios/starvation-promote.json +11 -0
  150. package/test/scenarios/wait-tools-continue.json +10 -0
  151. package/test/scenarios/wait-tools-xml.json +22 -0
  152. package/test/scenarios/wait-tools.json +15 -0
  153. package/test/session-format.test.ts +234 -0
  154. package/test/state.test.ts +335 -0
  155. package/test/stream-v02.test.ts +264 -0
  156. package/test/v031-display.test.ts +333 -0
  157. package/test/v032-conflict.test.ts +191 -0
  158. package/test/v032-truncation.test.ts +291 -0
  159. package/ui/client.js +576 -0
  160. package/ui/index.js +282 -0
  161. package/ui/package.json +26 -0
@@ -0,0 +1,676 @@
1
+ // test/adapters.test.ts —— 分派 07:四个薄适配 entry
2
+ //
3
+ // 覆盖分派 07 验收:
4
+ // - state-handle:provide ctx.state / BlobSink 接 storage(含 per-record 键约束模拟)/
5
+ // resume 重建句柄目录(file/obs/blob 三族)/ 失配 fail-closed / storage 降级 fail-open
6
+ // - obs-broker:工具结果出口登记(失败→high)/ 三档 none 去重 / 结果原样放行 /
7
+ // llm/stream 泄漏扫描(骨架不误报、全文必报)/ 指标口径 / broker_error fail-open
8
+ // - action-gate:未声明受治理动作 deny 可读(内核原文透传)/ spec 后工作区哈希不变 /
9
+ // 凭据一次性三路径(already_used / expired / hash_mismatch)+ unknown /
10
+ // strict 模式透传 / fatal 无通道拒绝 / gate_error fail-open
11
+ // - context-render:O6 preflight 逐会话稳定前缀断言(violation → fail-closed 抛
12
+ // PrefixBrokenError)/ prefix 台账 / preflight_error fail-open / O4 freezeDynamics
13
+ // - 组装 E2E:driver + state-handle + obs-broker + context-render + mock 模型——
14
+ // 单文件读任务上下文无全文(泄漏扫描 0 + 逐消息断言)+ tf-peek 第 42 行取回成功
15
+
16
+ import { describe, it, beforeEach } from 'node:test';
17
+ import assert from 'node:assert/strict';
18
+ import { mkdtempSync, mkdirSync, rmSync, writeFileSync, readFileSync } from 'node:fs';
19
+ import { tmpdir } from 'node:os';
20
+ import { join } from 'node:path';
21
+
22
+ import applyStateHandle from '../src/entry/state-handle.ts';
23
+ import type { StateService, StateSnapshot } from '../src/entry/state-handle.ts';
24
+ import applyObsBroker from '../src/entry/obs-broker.ts';
25
+ import type { ObsBrokerHandle } from '../src/entry/obs-broker.ts';
26
+ import applyActionGate from '../src/entry/action-gate.ts';
27
+ import type { ActionGateHandle } from '../src/entry/action-gate.ts';
28
+ import applyContextRender from '../src/entry/context-render.ts';
29
+ import type { ContextRenderHandle } from '../src/entry/context-render.ts';
30
+ import { SingleStreamDriver, normalizeStreamShim } from '../src/entry/loop.ts';
31
+ import type { StreamRequestOptions, ToolBatchInputLike, ToolBatchResultLike } from '../src/entry/loop.ts';
32
+ import { createMockModel } from '../src/entry/mock-provider.ts';
33
+ import type { Scenario, StreamChunk } from '../src/entry/mock-provider.ts';
34
+ import { PrefixBrokenError } from '../src/kernel/render.ts';
35
+ import { MemoryBlobSink } from '../src/kernel/state.ts';
36
+ import type { BlobSink } from '../src/kernel/state.ts';
37
+
38
+ // ---------------------------------------------------------------------------
39
+ // 测试设施:fake Cordis ctx + fake storage + fake tools
40
+ // ---------------------------------------------------------------------------
41
+
42
+ function makeFakeCtx() {
43
+ const services = new Map<string, unknown>();
44
+ const listeners = new Map<string, Array<(...args: unknown[]) => unknown>>();
45
+ const warnings: string[] = [];
46
+ const ctx = {
47
+ get: (name: string): unknown => services.get(name),
48
+ provide: (name: string, value: unknown): unknown => {
49
+ services.set(name, value);
50
+ return () => services.delete(name);
51
+ },
52
+ on: (event: string, listener: (...args: unknown[]) => unknown): unknown => {
53
+ const list = listeners.get(event) ?? [];
54
+ list.push(listener);
55
+ listeners.set(event, list);
56
+ return () => {
57
+ const i = list.indexOf(listener);
58
+ if (i >= 0) list.splice(i, 1);
59
+ };
60
+ },
61
+ effect: (fn: () => () => void): unknown => {
62
+ fn();
63
+ return undefined;
64
+ },
65
+ };
66
+ services.set('logger', { warn: (m: string) => warnings.push(m) });
67
+ return { ctx, services, listeners, warnings };
68
+ }
69
+
70
+ /** 宿主 per-record 键约束模拟:键不匹配 [a-zA-Z0-9_-]+ 直接拒绝(backend.d.ts:96-98)。 */
71
+ class MemKvUnit {
72
+ tables: Record<string, Record<string, unknown>>;
73
+ constructor(tables: string[]) {
74
+ this.tables = Object.fromEntries(tables.map((t) => [t, {}]));
75
+ }
76
+ async loadAll(): Promise<{ tables: Record<string, Record<string, unknown>>; global: unknown }> {
77
+ return { tables: structuredClone(this.tables), global: null };
78
+ }
79
+ async putRecord(table: string, key: string, value: unknown): Promise<void> {
80
+ assert.match(key, /^[a-zA-Z0-9_-]+$/, `unsafe kv key: ${key}`);
81
+ this.tables[table]![key] = structuredClone(value);
82
+ }
83
+ async close(): Promise<void> {}
84
+ }
85
+
86
+ function makeStorage(unit: MemKvUnit): { backend: { get(name: string): { kv: { open(): Promise<MemKvUnit> } } } } {
87
+ return { backend: { get: (name: string) => (name === 'json' ? { kv: { open: async () => unit } } : assert.fail(`unknown backend ${name}`)) } };
88
+ }
89
+
90
+ const tick = (): Promise<void> => new Promise((resolve) => setTimeout(resolve, 5));
91
+
92
+ interface GuardBox { guard?: (exec: { name: string; arguments?: unknown }) => string | undefined }
93
+
94
+ function makeTools(body: (name: string, args: Record<string, unknown>) => { content: unknown; isError: boolean }) {
95
+ const listeners: Array<(...args: unknown[]) => unknown> = [];
96
+ const box: GuardBox = {};
97
+ const service = {
98
+ guard: (g: NonNullable<GuardBox['guard']>): (() => void) => {
99
+ box.guard = g;
100
+ return () => {
101
+ box.guard = undefined;
102
+ };
103
+ },
104
+ onPostExecute: (fn: (...args: unknown[]) => unknown): void => {
105
+ listeners.push(fn);
106
+ },
107
+ execute: async (input: ToolBatchInputLike): Promise<ToolBatchResultLike> => {
108
+ const results: ToolBatchResultLike['results'] = [];
109
+ for (const call of input.calls) {
110
+ let args: Record<string, unknown> = {};
111
+ try {
112
+ args = JSON.parse(call.arguments) as Record<string, unknown>;
113
+ } catch {
114
+ results.push({ callId: call.id, result: { content: [{ type: 'text', text: 'bad JSON arguments' }], isError: true } });
115
+ continue;
116
+ }
117
+ let outcome = body(call.name, args);
118
+ // 管线顺序模拟:pre-execute policy(略)→ guards → body → post-execute waterfall
119
+ if (box.guard !== undefined) {
120
+ const denial = box.guard({ name: call.name, arguments: args });
121
+ if (denial !== undefined) outcome = { content: [{ type: 'text', text: denial }], isError: true };
122
+ }
123
+ let decision: { content: unknown; isError: boolean } = outcome;
124
+ for (const fn of listeners) {
125
+ decision = (await fn({ callId: call.id, name: call.name, arguments: args }, decision, () => Promise.resolve(decision))) as typeof decision;
126
+ }
127
+ results.push({ callId: call.id, result: { content: decision.content, isError: decision.isError } });
128
+ }
129
+ return { results, additionalContexts: [], concluded: false };
130
+ },
131
+ };
132
+ return { service, listeners, box };
133
+ }
134
+
135
+ /** state 快照(测试辅助):file/obs/blob 三族句柄一次布齐。 */
136
+ function seedHandles(service: StateService): StateSnapshot {
137
+ service.store.put('file-content-alpha', { kind: 'file', path: 'src/a.ts' });
138
+ service.store.put('obs-content-beta', { kind: 'obs', tool: 'read', callId: 'c9' });
139
+ service.store.put('blob-content-gamma');
140
+ return service.snapshot();
141
+ }
142
+
143
+ // ---------------------------------------------------------------------------
144
+ // A. state-handle
145
+ // ---------------------------------------------------------------------------
146
+
147
+ describe('07 state-handle', () => {
148
+ it('A1: provide ctx.state;storage 接驳后 blob 落持久层(键约束内)', async () => {
149
+ const unit = new MemKvUnit(['blobs', 'handles']);
150
+ const { ctx, services } = makeFakeCtx();
151
+ services.set('storage', makeStorage(unit));
152
+ const { service } = applyStateHandle(ctx as never, {});
153
+ await tick();
154
+ assert.equal(service.durable, true);
155
+ const h = service.store.put('persist-me', { kind: 'file', path: 'p.txt' });
156
+ assert.equal(service.store.get(h), 'persist-me');
157
+ await tick();
158
+ const persisted = Object.values(unit.tables['blobs']!);
159
+ assert.equal(persisted.length >= 1, true, 'blob 应写入 storage');
160
+ });
161
+
162
+ it('A2: resume 从持久层重建句柄目录(file/obs/blob 三族逐一对上)', async () => {
163
+ const unit = new MemKvUnit(['blobs', 'handles']);
164
+ const first = makeFakeCtx();
165
+ first.services.set('storage', makeStorage(unit));
166
+ const one = applyStateHandle(first.ctx as never, {});
167
+ await tick();
168
+ const snap = seedHandles(one.service);
169
+ await one.service.persist();
170
+ await one.dispose();
171
+
172
+ const second = makeFakeCtx();
173
+ second.services.set('storage', makeStorage(unit)); // "重启":同一持久层,全新内存
174
+ const two = applyStateHandle(second.ctx as never, {});
175
+ await tick();
176
+ assert.equal(two.service.durable, true);
177
+ const report = await two.service.resume();
178
+ assert.equal(report.ok, true, `mismatches: ${report.mismatches.join('; ')}`);
179
+ assert.deepEqual(
180
+ two.service.store.handles().map((h) => `${h.kind}:${h.path}@v${h.version}`),
181
+ snap.handles.map((e) => e.handle),
182
+ );
183
+ // 内容逐字节一致:以重建 store 取回原文
184
+ const restored = two.service.store.handles().map((h) => two.service.store.get(h));
185
+ assert.deepEqual(restored, ['file-content-alpha', 'obs-content-beta', 'blob-content-gamma']);
186
+ await two.dispose();
187
+ });
188
+
189
+ it('A3: resume 失配 fail-closed——不切换 store,报告 mismatches', async () => {
190
+ const unit = new MemKvUnit(['blobs', 'handles']);
191
+ const first = makeFakeCtx();
192
+ first.services.set('storage', makeStorage(unit));
193
+ const one = applyStateHandle(first.ctx as never, {});
194
+ await tick();
195
+ seedHandles(one.service);
196
+ await one.service.persist();
197
+
198
+ // 篡改快照内容 → 内容寻址重建必然失配
199
+ const tampered = Object.values(unit.tables['handles']!)[0] as { handle: string; contentB64: string };
200
+ tampered.contentB64 = Buffer.from('corrupted').toString('base64');
201
+
202
+ const second = makeFakeCtx();
203
+ second.services.set('storage', makeStorage(unit));
204
+ const two = applyStateHandle(second.ctx as never, {});
205
+ await tick();
206
+ const storeBefore = two.service.store;
207
+ const report = await two.service.resume();
208
+ assert.equal(report.ok, false);
209
+ assert.equal(report.mismatches.length >= 1, true);
210
+ assert.equal(two.service.store, storeBefore, '失配时不许切换 store');
211
+ });
212
+
213
+ it('A4: storage 不可用 → 本地文件 KvUnit 兜底(durable=true,跨会话 resume 可用;修复限制 3);localFallback 关闭 → 内存降级', async () => {
214
+ const dir = mkdtempSync(join(tmpdir(), 'tf-state-'));
215
+ try {
216
+ // ① 默认:宿主 storage 缺位 → 本地 JSON 文件 KvUnit(durable),且降级路径告警不静默
217
+ const { ctx, warnings } = makeFakeCtx(); // 无 storage 服务
218
+ const first = applyStateHandle(ctx as never, { stateDir: dir });
219
+ await tick();
220
+ assert.equal(first.service.durable, true, '本地文件兜底后必须 durable');
221
+ const h = first.service.store.put('local-fallback-durable');
222
+ assert.equal(first.service.store.get(h), 'local-fallback-durable');
223
+ assert.equal(warnings.some((w) => w.includes('state-handle')), true, '宿主 storage 缺位必须告警');
224
+ await first.service.persist();
225
+ await first.dispose();
226
+ const handleStr = `${h.kind}:${h.path}@v${h.version}`;
227
+
228
+ // ② "重启":全新内存 + 同一 stateDir → 快照读回、resume 重建(跨会话,无宿主 storage)
229
+ const second = makeFakeCtx();
230
+ const two = applyStateHandle(second.ctx as never, { stateDir: dir });
231
+ await tick();
232
+ assert.equal(two.service.durable, true);
233
+ const report = await two.service.resume();
234
+ assert.equal(report.ok, true, `mismatches: ${report.mismatches.join('; ')}`);
235
+ const restored = two.service.store.handles().map((x) => `${x.kind}:${x.path}@v${x.version}`);
236
+ assert.ok(restored.includes(handleStr), `resume 应重建句柄 ${handleStr}`);
237
+ assert.equal(two.service.store.get(two.service.store.handles().find((x) => `${x.kind}:${x.path}@v${x.version}` === handleStr)!), 'local-fallback-durable');
238
+ await two.dispose();
239
+
240
+ // ③ localFallback:false → 维持 v0.1 内存降级行为(durable=false)
241
+ const third = makeFakeCtx();
242
+ const mem = applyStateHandle(third.ctx as never, { stateDir: dir, localFallback: false });
243
+ await tick();
244
+ assert.equal(mem.service.durable, false);
245
+ assert.equal(third.warnings.some((w) => w.includes('state-handle')), true, '内存降级必须告警');
246
+ await mem.service.persist();
247
+ } finally {
248
+ rmSync(dir, { recursive: true, force: true });
249
+ }
250
+ });
251
+
252
+ it('A5: announce 路径——装载横幅可输出且 apply 不抛(宿主冒烟曾在此抓到 ReferenceError)', async () => {
253
+ const { ctx, services } = makeFakeCtx();
254
+ services.set('storage', makeStorage(new MemKvUnit(['blobs', 'handles'])));
255
+ const banners: string[] = [];
256
+ const originalError = console.error;
257
+ console.error = (msg: unknown): void => {
258
+ banners.push(String(msg));
259
+ };
260
+ try {
261
+ const { service } = applyStateHandle(ctx as never, { announce: true });
262
+ await tick();
263
+ assert.equal(service.durable, true);
264
+ const obsEnv = makeFakeCtx();
265
+ obsEnv.services.set('state', { sink: service.sink, durable: true });
266
+ applyObsBroker(obsEnv.ctx as never, { announce: true });
267
+ applyContextRender(obsEnv.ctx as never, { announce: true });
268
+ const gateEnv = makeFakeCtx();
269
+ gateEnv.services.set('tools', { guard: () => () => {} });
270
+ gateEnv.services.set('storage', makeStorage(new MemKvUnit(['staged'])));
271
+ applyActionGate(gateEnv.ctx as never, { announce: true });
272
+ } finally {
273
+ console.error = originalError;
274
+ }
275
+ assert.equal(banners.some((b) => b.includes('[state-handle] mounted')), true);
276
+ assert.equal(banners.some((b) => b.includes('[obs-broker] mounted')), true);
277
+ assert.equal(banners.some((b) => b.includes('[action-gate] mounted')), true);
278
+ assert.equal(banners.some((b) => b.includes('[context-render] mounted')), true);
279
+ });
280
+ });
281
+
282
+ // ---------------------------------------------------------------------------
283
+ // B. obs-broker
284
+ // ---------------------------------------------------------------------------
285
+
286
+ describe('07 obs-broker', () => {
287
+ function setup(withState = true) {
288
+ const env = makeFakeCtx();
289
+ const sink: BlobSink = withState ? new MemoryBlobSink() : { write: () => {}, read: () => undefined };
290
+ env.services.set('state', { sink, durable: withState });
291
+ const handle = applyObsBroker(env.ctx as never, {}) as ObsBrokerHandle;
292
+ const postExecute = env.listeners.get('tools/post-execute')![0] as (
293
+ exec: { callId: string; name: string; arguments?: unknown },
294
+ result: { isError: boolean; content: unknown },
295
+ next: () => Promise<{ isError: boolean; content: unknown }>,
296
+ ) => Promise<{ isError: boolean; content: unknown }>;
297
+ const onStream = env.listeners.get('llm/stream')![0] as (
298
+ options: { messages?: { content: readonly { type: string; text?: string }[] }[]; sessionId?: string },
299
+ next: () => AsyncIterable<StreamChunk>,
300
+ ) => AsyncIterable<StreamChunk>;
301
+ return { env, handle, postExecute, onStream, sink };
302
+ }
303
+
304
+ it('B1: 工具结果出口登记——首次 read 成功 → high;结果原样放行;blob 落盘', async () => {
305
+ const { handle, postExecute } = setup();
306
+ const result = { isError: false, content: [{ type: 'text', text: 'line1\nline2' }] };
307
+ const out = await postExecute({ callId: 'r1', name: 'tf-read', arguments: { file_path: 'a.ts' } }, result, () => Promise.resolve(result));
308
+ assert.equal(out, result, '结果对象必须原样放行(不得改写)');
309
+ const counters = handle.counters();
310
+ assert.equal(counters.produced, 1);
311
+ assert.equal(counters.injected, 1, '首次 high 骨架计入 injected(08 号口径)');
312
+ const audit = handle.faults.records.find((r) => r.kind === 'audit');
313
+ assert.equal((audit?.data['info_gain'] as string), 'high');
314
+ assert.equal((audit?.data['handle'] as string), 'obs:read:r1@v1');
315
+ });
316
+
317
+ it('B2: 失败结果 info_gain=high(模型必须看到失败)且原样放行', async () => {
318
+ const { handle, postExecute } = setup();
319
+ const result = { isError: true, content: [{ type: 'text', text: 'EFAIL: boom' }] };
320
+ await postExecute({ callId: 'b1', name: 'tf-bash', arguments: { cmd: 'boom' } }, result, () => Promise.resolve(result));
321
+ const audit = handle.faults.records.find((r) => r.kind === 'audit');
322
+ assert.equal((audit?.data['info_gain'] as string), 'high');
323
+ assert.equal((audit?.data['isError'] as boolean), true);
324
+ });
325
+
326
+ it('B3: 同 key 同内容重复观测 → 内核归 none(连目录都不更新)', async () => {
327
+ const { handle, postExecute } = setup();
328
+ const result = { isError: false, content: [{ type: 'text', text: 'same' }] };
329
+ await postExecute({ callId: 'c1', name: 'tf-read', arguments: { file_path: 'same.txt' } }, result, () => Promise.resolve(result));
330
+ await postExecute({ callId: 'c2', name: 'tf-read', arguments: { file_path: 'same.txt' } }, result, () => Promise.resolve(result));
331
+ const audits = handle.faults.records.filter((r) => r.kind === 'audit');
332
+ assert.equal((audits[1]?.data['info_gain'] as string), 'none');
333
+ assert.equal((audits[1]?.data['reason'] as string), 'duplicate-observation');
334
+ });
335
+
336
+ it('B4: 泄漏扫描——骨架单行不误报;blob 全文原样出现必报 leak', async () => {
337
+ const { handle, onStream, postExecute } = setup();
338
+ const fullText = ['import os from "node:os"', 'export function alpha() {', ' return 1;', '}', 'export class Beta {}'].join('\n');
339
+ await postExecute({ callId: 'r1', name: 'tf-read', arguments: { file_path: 'a.ts' } }, { isError: false, content: [{ type: 'text', text: fullText }] }, () => Promise.resolve({ isError: false, content: [] }));
340
+
341
+ // 请求 1:只含骨架摘要(单行摘录)→ 无泄漏
342
+ const skeletonOnly = { messages: [{ content: [{ type: 'text', text: '[tf-stream:observation handle=obs:read:r1@v1]\n[骨架] 共 5 行\n L1 [import] import os from "node:os"' }] }], sessionId: 's1' };
343
+ for await (const _ of onStream(skeletonOnly, asyncEmptyStream())) void _;
344
+ assert.equal(handle.faults.count('leak'), 0, '骨架摘录不算泄漏');
345
+ assert.equal(handle.faults.count('metrics'), 1, '逐请求指标落账');
346
+
347
+ // 请求 2:全文原样出现 → leak 记录(证据流,不阻断)
348
+ const leaking = { messages: [{ content: [{ type: 'text', text: `[tf-stream:tool-result]\n${fullText}` }] }], sessionId: 's1' };
349
+ for await (const _ of onStream(leaking, asyncEmptyStream())) void _;
350
+ const leak = handle.faults.records.find((r) => r.kind === 'leak');
351
+ assert.notEqual(leak, undefined, '全文出现必须记录 leak');
352
+ assert.equal((leak?.data['handle'] as string), 'obs:read:r1@v1');
353
+ });
354
+
355
+ it('B5: fail-open(audit 路径注错)→ 结果照常放行 + broker_error 留痕', async () => {
356
+ const env = makeFakeCtx();
357
+ env.services.set('state', { sink: new MemoryBlobSink(), durable: true });
358
+ const handle = applyObsBroker(env.ctx as never, { faultInjection: 'audit' }) as ObsBrokerHandle;
359
+ const postExecute = env.listeners.get('tools/post-execute')![0] as (exec: unknown, result: { isError: boolean; content: unknown }, next: () => Promise<{ isError: boolean; content: unknown }>) => Promise<{ isError: boolean; content: unknown }>;
360
+ const result = { isError: false, content: [{ type: 'text', text: 'x' }] };
361
+ const out = await postExecute({ callId: 'f1', name: 'tf-read', arguments: {} }, result, () => Promise.resolve(result));
362
+ assert.equal(out, result, 'fail-open:放行不毁结果');
363
+ assert.equal(handle.faults.count('broker_error'), 1);
364
+ });
365
+
366
+ it('B6: fail-open(scan 路径注错)→ 请求照常放行 + broker_error 留痕', async () => {
367
+ const env = makeFakeCtx();
368
+ env.services.set('state', { sink: new MemoryBlobSink(), durable: true });
369
+ const handle = applyObsBroker(env.ctx as never, { faultInjection: 'scan' }) as ObsBrokerHandle;
370
+ const onStream = env.listeners.get('llm/stream')![0] as (options: unknown, next: () => AsyncIterable<StreamChunk>) => AsyncIterable<StreamChunk>;
371
+ let consumed = false;
372
+ const wrapped = onStream({ messages: [{ content: [{ type: 'text', text: 'hi' }] }] }, () => asyncEmptyStream()());
373
+ for await (const chunk of wrapped) {
374
+ if (chunk.type === 'finish') consumed = true; // next() 的流原样到达消费方
375
+ }
376
+ assert.equal(consumed, true, 'fail-open:流放行');
377
+ assert.equal(handle.faults.count('broker_error'), 1);
378
+ });
379
+ });
380
+
381
+ function asyncEmptyStream(): () => AsyncIterable<StreamChunk> {
382
+ return async function* () {
383
+ yield { type: 'finish', reason: { kind: 'stop' } };
384
+ } as AsyncIterable<StreamChunk>;
385
+ }
386
+
387
+ // ---------------------------------------------------------------------------
388
+ // C. action-gate
389
+ // ---------------------------------------------------------------------------
390
+
391
+ describe('07 action-gate', () => {
392
+ it('C1: read 级直接放行;stage-commit 模式下 write 走暂存闭环后放行', async () => {
393
+ const { ctx, services } = makeFakeCtx();
394
+ const { box } = makeTools(() => ({ content: [], isError: false }));
395
+ services.set('tools', { guard: (g: never) => (box.guard = g as never) && (() => {}) });
396
+ const handle = applyActionGate(ctx as never, {}) as ActionGateHandle;
397
+ assert.equal(box.guard?.({ name: 'read', arguments: { file_path: 'x' } }), undefined, 'read 放行');
398
+ assert.equal(box.guard?.({ name: 'write', arguments: { file_path: 'a.txt', content: 'v1' } }), undefined, 'spec 闭环后放行');
399
+ assert.equal(handle.registry.frozen, true);
400
+ });
401
+
402
+ it('C2: 未声明 reversibility 的受治理动作 → deny + 内核原文可读理由', async () => {
403
+ const { ctx, services } = makeFakeCtx();
404
+ const { box } = makeTools(() => ({ content: [], isError: false }));
405
+ services.set('tools', { guard: (g: never) => (box.guard = g as never) && (() => {}) });
406
+ applyActionGate(ctx as never, { actions: { write: 'spec', read: 'read', 'tf-write': 'spec', 'tf-read': 'read' } }) as ActionGateHandle;
407
+ const denial = box.guard?.({ name: 'tf-bash', arguments: {} }); // tf-* 前缀受治理但未声明
408
+ assert.match(denial ?? '', /undeclared-reversibility/);
409
+ assert.match(denial ?? '', /未注册的 action:tf-bash/, '内核 UnknownActionError 原文透传');
410
+ assert.equal(box.guard?.({ name: 'grep', arguments: {} }), undefined, '宿主自有工具不表意见');
411
+ });
412
+
413
+ it('C3: spec 后工作区哈希不变(暂存落 storage,不触碰工作区)', async () => {
414
+ const dir = mkdtempSync(join(tmpdir(), 'tf-gate-'));
415
+ try {
416
+ writeFileSync(join(dir, 'a.txt'), 'original', 'utf8');
417
+ const unit = new MemKvUnit(['staged']);
418
+ const { ctx, services } = makeFakeCtx();
419
+ const { box } = makeTools(() => ({ content: [], isError: false }));
420
+ services.set('tools', { guard: (g: never) => (box.guard = g as never) && (() => {}) });
421
+ services.set('storage', makeStorage(unit));
422
+ const handle = applyActionGate(ctx as never, { workspaceRoot: dir }) as ActionGateHandle;
423
+ await tick();
424
+ assert.equal(box.guard?.({ name: 'write', arguments: { file_path: 'a.txt', content: 'changed' } }), undefined);
425
+ assert.equal(readFileSync(join(dir, 'a.txt'), 'utf8'), 'original', '工作区不得被 spec 触碰');
426
+ const staged = Object.values(unit.tables['staged'] ?? {}) as Array<{ path: string; content: string }>;
427
+ assert.deepEqual(staged, [{ path: 'a.txt', content: 'changed' }], '暂存写入落在 storage');
428
+ } finally {
429
+ rmSync(dir, { recursive: true, force: true });
430
+ }
431
+ });
432
+
433
+ it('C4: 凭据一次性三路径 + unknown,全部结构化原因', async () => {
434
+ const dir = mkdtempSync(join(tmpdir(), 'tf-gate2-'));
435
+ try {
436
+ const { ctx, services } = makeFakeCtx();
437
+ const { box } = makeTools(() => ({ content: [], isError: false }));
438
+ services.set('tools', { guard: (g: never) => (box.guard = g as never) && (() => {}) });
439
+ const handle = applyActionGate(ctx as never, { workspaceRoot: dir, credentialTtlMs: 60_000 }) as ActionGateHandle;
440
+ // 路径 1 already_used
441
+ const spec = handle.gate.speculate({ action: 'tf-write', taskId: 't1', writes: [{ path: 'x.txt', content: 'v1' }] });
442
+ assert.equal(spec.verdict, 'allow');
443
+ const commit1 = handle.gate.commit({ action: 'tf-write', taskId: 't1', credential: spec.credential });
444
+ assert.equal(commit1.verdict, 'allow');
445
+ const commit2 = handle.gate.commit({ action: 'tf-write', taskId: 't1', credential: spec.credential });
446
+ assert.equal(commit2.verdict, 'deny');
447
+ assert.equal(commit2.verdict === 'deny' && commit2.rejection.reason, 'already_used');
448
+ // 路径 2 expired
449
+ const expiredEnv = makeFakeCtx();
450
+ const { box: box2 } = makeTools(() => ({ content: [], isError: false }));
451
+ expiredEnv.services.set('tools', { guard: (g: never) => (box2.guard = g as never) && (() => {}) });
452
+ const expiredGate = applyActionGate(expiredEnv.ctx as never, { workspaceRoot: dir, credentialTtlMs: 1 }) as ActionGateHandle;
453
+ const spec2 = expiredGate.gate.speculate({ action: 'tf-write', taskId: 't2', writes: [{ path: 'y.txt', content: 'v2' }] });
454
+ await tick();
455
+ const commit3 = expiredGate.gate.commit({ action: 'tf-write', taskId: 't2', credential: spec2.credential });
456
+ assert.equal(commit3.verdict === 'deny' && commit3.rejection.reason, 'expired');
457
+ // 路径 3 hash_mismatch(spec 之后目标内容变化)
458
+ writeFileSync(join(dir, 'z.txt'), 'before', 'utf8');
459
+ const spec3 = handle.gate.speculate({ action: 'tf-write', taskId: 't3', writes: [{ path: 'z.txt', content: 'after' }] });
460
+ writeFileSync(join(dir, 'z.txt'), 'changed-externally', 'utf8');
461
+ const commit4 = handle.gate.commit({ action: 'tf-write', taskId: 't3', credential: spec3.credential });
462
+ assert.equal(commit4.verdict === 'deny' && commit4.rejection.reason, 'hash_mismatch');
463
+ // 路径 4 unknown
464
+ const commit5 = handle.gate.commit({ action: 'tf-write', taskId: 't4', credential: { id: 'no-such-id', specHash: '', taskId: 't4', expiresAt: 0, used: false } });
465
+ assert.equal(commit5.verdict === 'deny' && commit5.rejection.reason, 'unknown');
466
+ } finally {
467
+ rmSync(dir, { recursive: true, force: true });
468
+ }
469
+ });
470
+
471
+ it('C5: strict 模式 spec 拒绝透传;C6 fatal 无批准通道拒绝;C7 commit 凭据校验走守卫', async () => {
472
+ const { ctx, services } = makeFakeCtx();
473
+ const { box } = makeTools(() => ({ content: [], isError: false }));
474
+ services.set('tools', { guard: (g: never) => (box.guard = g as never) && (() => {}) });
475
+ const handle = applyActionGate(ctx as never, { mode: 'strict', actions: { write: 'spec', read: 'read', 'tf-write': 'spec', 'tf-apply': 'commit', 'tf-nuke': 'fatal' } }) as ActionGateHandle;
476
+ const strictDenial = box.guard?.({ name: 'write', arguments: { file_path: 'a.txt', content: 'v' } });
477
+ assert.match(strictDenial ?? '', /spec-via-speculate/, '内核 admit 语义透传');
478
+ assert.equal(box.guard?.({ name: 'read', arguments: {} }), undefined);
479
+
480
+ const fatalDenial = box.guard?.({ name: 'tf-nuke', arguments: {} });
481
+ assert.match(fatalDenial ?? '', /fatal-no-approval-channel/);
482
+
483
+ const commitNoCredential = box.guard?.({ name: 'tf-apply', arguments: {} });
484
+ assert.match(commitNoCredential ?? '', /commit-requires-credential/);
485
+ const spec = handle.gate.speculate({ action: 'tf-write', taskId: 't', writes: [{ path: 'w.txt', content: '1' }] });
486
+ const commitDenial = box.guard?.({ name: 'tf-apply', arguments: { __credential: { id: 'wrong' } } });
487
+ assert.match(commitDenial ?? '', /unknown/, '凭据不存在 → 结构化拒绝');
488
+ void spec;
489
+ });
490
+
491
+ it('C8: 守卫自身异常 → fail-open 放行 + gate_error 留痕', () => {
492
+ const { ctx, services } = makeFakeCtx();
493
+ const { box } = makeTools(() => ({ content: [], isError: false }));
494
+ services.set('tools', { guard: (g: never) => (box.guard = g as never) && (() => {}) });
495
+ const handle = applyActionGate(ctx as never, { faultInjection: true }) as ActionGateHandle;
496
+ assert.equal(box.guard?.({ name: 'write', arguments: { file_path: 'a.txt', content: 'v' } }), undefined, 'fail-open 放行');
497
+ assert.equal(handle.faults.count('gate_error'), 1);
498
+ });
499
+ });
500
+
501
+ // ---------------------------------------------------------------------------
502
+ // D. context-render
503
+ // ---------------------------------------------------------------------------
504
+
505
+ describe('07 context-render', () => {
506
+ function setup(config: Record<string, unknown> = {}) {
507
+ const env = makeFakeCtx();
508
+ const handle = applyContextRender(env.ctx as never, config) as ContextRenderHandle;
509
+ const onStream = env.listeners.get('llm/stream')![0] as (options: unknown, next: () => AsyncIterable<StreamChunk>) => AsyncIterable<StreamChunk>;
510
+ return { env, handle, onStream };
511
+ }
512
+ const request = (system: string, user: string) => ({
513
+ messages: [
514
+ { role: 'system', content: [{ type: 'text', text: system }] },
515
+ { role: 'user', content: [{ type: 'text', text: user }] },
516
+ ],
517
+ sessionId: 'sess-1',
518
+ });
519
+
520
+ it('D1: 逐会话稳定前缀断言——同前缀多请求通过,prefix 台账逐请求落账', async () => {
521
+ const { handle, onStream } = setup();
522
+ for (let i = 1; i <= 3; i++) {
523
+ for await (const _ of onStream(request('SYSTEM-V1', `turn ${i}`), asyncEmptyStream())) void _;
524
+ }
525
+ const prefixes = handle.faults.records.filter((r) => r.kind === 'prefix');
526
+ assert.equal(prefixes.length, 3);
527
+ assert.equal(new Set(prefixes.map((r) => r.data['stableHash'])).size, 1, '稳定前缀 hash 逐请求恒定(O4/O6)');
528
+ });
529
+
530
+ it('D2: 稳定前缀被改动 → fail-closed 抛 PrefixBrokenError + prefix-broken 记录', async () => {
531
+ const { handle, onStream } = setup();
532
+ for await (const _ of onStream(request('SYSTEM-V1', 'q1'), asyncEmptyStream())) void _;
533
+ assert.throws(
534
+ () => onStream(request('SYSTEM-V2-DRIFT', 'q2'), asyncEmptyStream()).next(),
535
+ PrefixBrokenError,
536
+ '前缀破坏必须拒绝发送(fail-closed)',
537
+ );
538
+ assert.equal(handle.faults.count('prefix-broken'), 1);
539
+ });
540
+
541
+ it('D3: 断言器自身异常 → fail-open 放行 + preflight_error 留痕', async () => {
542
+ const { handle, onStream } = setup({ faultInjection: true });
543
+ let finished = false;
544
+ for await (const chunk of onStream(request('S', 'q'), asyncEmptyStream())) {
545
+ if (chunk.type === 'finish') finished = true;
546
+ }
547
+ assert.equal(finished, true, 'fail-open:流放行');
548
+ assert.equal(handle.faults.count('preflight_error'), 1);
549
+ });
550
+
551
+ it('D4: freezeDynamics(O4)——动态值撞稳定前缀即抛,正常归位不抛', () => {
552
+ const { handle } = setup();
553
+ assert.throws(() => handle.freezeDynamics({ t: '动态冻结载体' }, 'volatile-tail'), /DynamicInPrefixError|动态字段/);
554
+ handle.freezeDynamics({ now: '2026-11-14T00:00:00Z' }, 'volatile-tail'); // 易变尾:不抛
555
+ handle.freezeDynamics({ dir: '/w' }, 'turn-freeze'); // 回合冻结:不抛
556
+ });
557
+ });
558
+
559
+ // ---------------------------------------------------------------------------
560
+ // E. 组装 E2E:driver + 三 entry(验收:上下文无全文 + tf-peek 第 42 行)
561
+ // ---------------------------------------------------------------------------
562
+
563
+ describe('07 composed E2E', () => {
564
+ it('E1: 单文件读任务——上下文无全文(泄漏扫描 0 + 逐消息断言),tf-peek 取回第 42 行', async () => {
565
+ const lines = Array.from({ length: 100 }, (_, i) => (i === 41 ? 'L42-zebra: the answer lives here' : `filler line ${i + 1} padding padding`));
566
+ lines[0] = 'import os from "node:os"';
567
+ const bigTxt = lines.join('\n');
568
+ const dir = mkdtempSync(join(tmpdir(), 'tf-e2e-'));
569
+ try {
570
+ writeFileSync(join(dir, 'big.txt'), bigTxt, 'utf8');
571
+ const fullText = readFileSync(join(dir, 'big.txt'), 'utf8');
572
+ assert.equal(fullText, bigTxt);
573
+
574
+ // ---- fake 宿主 ----
575
+ const env = makeFakeCtx();
576
+ const unit = new MemKvUnit(['blobs', 'handles', 'staged']);
577
+ env.services.set('storage', makeStorage(unit));
578
+ const tools = makeTools((name, args) => {
579
+ if (name === 'read') return { content: [{ type: 'text', text: readFileSync(join(dir, String(args['file_path'])), 'utf8') }], isError: false };
580
+ return { content: [{ type: 'text', text: `unknown tool ${name}` }], isError: true };
581
+ });
582
+ env.services.set('tools', tools.service);
583
+ const state = applyStateHandle(env.ctx as never, {});
584
+ await tick();
585
+ const broker = applyObsBroker(env.ctx as never, {}) as ObsBrokerHandle;
586
+ applyActionGate(env.ctx as never, { workspaceRoot: dir });
587
+ const render = applyContextRender(env.ctx as never, {}) as ContextRenderHandle;
588
+ tools.listeners.push(...(env.listeners.get('tools/post-execute') ?? []));
589
+
590
+ // ---- mock 模型(三请求剧本:读 → peek 42 行 → final;顺序敏感:更具体的 marker 放前)----
591
+ const scenarios: Scenario[] = [
592
+ {
593
+ name: 'e2e-final',
594
+ match: { promptIncludes: 'tf-stream:peek' },
595
+ chunking: { charsPerChunk: 0, delayMs: 0 },
596
+ steps: [
597
+ { type: 'text', text: '第 42 行拿到了。\n' },
598
+ { type: 'commands', commands: ['<tf-final id="f1" summary="answer: L42-zebra"/>'] },
599
+ { type: 'finish', reason: 'stop' },
600
+ ],
601
+ },
602
+ {
603
+ name: 'e2e-peek',
604
+ match: { promptIncludes: 'tf-stream:observation' },
605
+ chunking: { charsPerChunk: 0, delayMs: 0 },
606
+ steps: [
607
+ { type: 'text', text: '看骨架,取回第 42 行。\n' },
608
+ { type: 'commands', commands: ['<tf-peek handle="obs:read:r1@v1" from_line="42" to_line="42" id="p1"/>'] },
609
+ { type: 'waitTools', count: 1, timeoutMs: 5000 },
610
+ { type: 'finish', reason: 'stop' },
611
+ ],
612
+ },
613
+ {
614
+ name: 'e2e-read',
615
+ match: { promptIncludes: '句柄演练 07' },
616
+ chunking: { charsPerChunk: 0, delayMs: 0 },
617
+ steps: [
618
+ { type: 'text', text: '先读 big.txt。\n' },
619
+ { type: 'commands', commands: ['<tf-read path="big.txt" id="r1"/>'] },
620
+ { type: 'waitTools', count: 1, timeoutMs: 5000 },
621
+ { type: 'finish', reason: 'stop' },
622
+ ],
623
+ },
624
+ ];
625
+ const model = createMockModel({ scenarios, provider: 'mock' });
626
+
627
+ // ---- llm.stream = broker 外层 → context-render 内层 → mock 的 waterfall 链 ----
628
+ const wireRequests: Array<StreamRequestOptions> = [];
629
+ const mockStream = (options: StreamRequestOptions): AsyncIterable<StreamChunk> =>
630
+ model.adapter.stream({ provider: options.provider, model: options.model, messages: options.messages, signal: options.signal });
631
+ const renderListener = env.listeners.get('llm/stream')!.find((fn) => fn !== (broker as unknown as { onStream?: unknown }).onStream)!;
632
+ void renderListener;
633
+ const [brokerOnStream, renderOnStream] = env.listeners.get('llm/stream')! as Array[
634
+ (options: { messages?: { content: unknown }[]; sessionId?: string }, next: () => AsyncIterable<StreamChunk>) => AsyncIterable<StreamChunk>
635
+ ];
636
+ const llm = {
637
+ stream: (options: StreamRequestOptions): AsyncIterable<StreamChunk> => {
638
+ wireRequests.push(options);
639
+ return brokerOnStream(options, () => renderOnStream(options, () => normalizeStreamShim(mockStream(options))));
640
+ },
641
+ };
642
+
643
+ const driver = new SingleStreamDriver(
644
+ {
645
+ stream: (options) => llm.stream(options),
646
+ executeTools: (input) => tools.service.execute(input),
647
+ onToolSettled: () => model.notifyToolResult(),
648
+ },
649
+ { provider: 'mock', model: 'mock-scenario', streamIdleTimeoutMs: 30_000 },
650
+ );
651
+ driver.pushUserTask('句柄演练 07:读 big.txt 并取回第 42 行。');
652
+ const reason = await driver.runTurn();
653
+ assert.equal(reason.kind, 'completed');
654
+
655
+ // ---- 验收 1:read 反馈(v0.2 完整反馈语义:3.9k 文件 < 8000 上限 → 全文反馈,泄漏照记)----
656
+ assert.ok(broker.faults.count('leak') >= 1, 'read 全文反馈按设计如实记 leak(07 §3.3 口径区分,非缺陷)');
657
+ const allTexts = wireRequests.flatMap((r) => r.messages.map((m) => m.content.map((b) => b.text ?? '').join('\n')));
658
+ assert.equal(allTexts.length >= 3, true);
659
+ assert.equal(allTexts.some((t) => t.includes(bigTxt)), true, '第二次请求包含 read 完整原文反馈(≤ 上限)');
660
+ // ---- 验收 2:tf-peek 第 42 行取回成功(peek 结果注入下一请求,final 携带答案)----
661
+ assert.equal(allTexts.some((t) => t.includes('L42-zebra: the answer lives here')), true, '第 42 行原文进入上下文(反馈或 peek)');
662
+ const finalRecord = driver.snapshot().records.find((r) => r.kind === 'final') as { summary?: string } | undefined;
663
+ assert.match(finalRecord?.summary ?? '', /L42-zebra/, '模型(剧本)基于取回内容作答');
664
+ // ---- 指标与 prefix 台账 ----
665
+ const counters = driver.snapshot().counters();
666
+ assert.equal(counters.produced >= 1, true);
667
+ assert.equal(counters.peeked, 2, 'v0.2:完整反馈自动 peek 1 次 + 模型 peek 1 次');
668
+ const prefixes = render.faults.records.filter((r) => r.kind === 'prefix');
669
+ assert.equal(prefixes.length, wireRequests.length, '逐请求 prefix 台账');
670
+ assert.equal(new Set(prefixes.map((r) => r.data['stableHash'])).size, 1, '稳定前缀 hash 全程恒定');
671
+ await state.dispose();
672
+ } finally {
673
+ rmSync(dir, { recursive: true, force: true });
674
+ }
675
+ });
676
+ });