@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.
- package/CHANGELOG.md +622 -0
- package/CONTRIBUTING.md +72 -0
- package/LICENSE +202 -0
- package/README.en.md +349 -0
- package/README.md +300 -3
- package/cordis.patch.yml +77 -0
- package/dist/entry/action-gate.js +206 -0
- package/dist/entry/adapter-kit.js +192 -0
- package/dist/entry/context-render.js +119 -0
- package/dist/entry/control-bar-cli.js +289 -0
- package/dist/entry/control-bar.js +123 -0
- package/dist/entry/control-session.js +115 -0
- package/dist/entry/control-state.js +125 -0
- package/dist/entry/cordis-compat.js +95 -0
- package/dist/entry/eval-probe.js +112 -0
- package/dist/entry/intent-log.js +121 -0
- package/dist/entry/json-persistence.js +306 -0
- package/dist/entry/loop.js +4163 -0
- package/dist/entry/mock-provider.js +549 -0
- package/dist/entry/obs-broker.js +178 -0
- package/dist/entry/ptc-bridge.js +405 -0
- package/dist/entry/state-handle.js +217 -0
- package/dist/entry/takeover-registry.js +60 -0
- package/dist/kernel/control-bar.js +559 -0
- package/dist/kernel/final.js +62 -0
- package/dist/kernel/gate.js +464 -0
- package/dist/kernel/modes.js +253 -0
- package/dist/kernel/obs.js +517 -0
- package/dist/kernel/parser.js +1081 -0
- package/dist/kernel/render.js +466 -0
- package/dist/kernel/state.js +416 -0
- package/dist/version.js +9 -0
- package/docs/TEST-PROPOSITIONS.md +139 -0
- package/docs/adr-001-segment-boundary.md +61 -0
- package/docs/architecture.md +104 -0
- package/docs/desktop-ui-feasibility.md +277 -0
- package/docs/disabled-lines-audit.md +53 -0
- package/docs/limitations.md +181 -0
- package/docs/protocol.md +99 -0
- package/docs/v0.4.0-plan.md +50 -0
- package/eval/METRICS.md +128 -0
- package/eval/RESULTS.md +246 -0
- package/eval/tasks/fixtures/big-report.md +298 -0
- package/eval/tasks/fixtures/build-manifest.txt +5 -0
- package/eval/tasks/fixtures/deploy.yaml +4 -0
- package/eval/tasks/fixtures/error.log +200 -0
- package/eval/tasks/fixtures/features.yaml +4 -0
- package/eval/tasks/fixtures/pipeline.yaml +4 -0
- package/eval/tasks/fixtures/sales-q1.csv +61 -0
- package/eval/tasks/fixtures/settings.yaml +4 -0
- package/eval/tasks/fixtures/users-roster.json +304 -0
- package/eval/tasks/fixtures/users-scores.json +20 -0
- package/eval/tasks/gen-fixtures.cjs +80 -0
- package/eval/tasks/tasks.json +150 -0
- package/eval/tools/f6-kill-drill.cjs +176 -0
- package/eval/tools/f6-kill-drill.worker.cjs +131 -0
- package/eval/tools/gen-results.cjs +191 -0
- package/eval/tools/machine-test.cjs +200 -0
- package/eval/tools/manual-code-scenarios.md +59 -0
- package/eval/tools/replay-check.cjs +311 -0
- package/eval/tools/runner.cjs +219 -0
- package/eval/tools/session-log.cjs +106 -0
- package/eval/tools/summarize.cjs +185 -0
- package/eval/tools/t3-cells.cjs +173 -0
- package/package.json +73 -6
- package/patches/adapters-smoke.yml +41 -0
- package/patches/eval-account.yml +36 -0
- package/patches/eval-baseline.yml +33 -0
- package/patches/eval-stream-code-off.yml +46 -0
- package/patches/eval-stream-code-on.yml +47 -0
- package/patches/eval-stream.yml +54 -0
- package/patches/takeover.yml +42 -0
- package/patches/test-preset.yml +23 -0
- package/preset/stream/cordis.patch.yml +39 -0
- package/preset/stream/package.json +13 -0
- package/preset.yml +56 -0
- package/profiles/stream/README.md +66 -0
- package/profiles/stream/cordis.patch.yml +12 -0
- package/profiles/stream/package.json +17 -0
- package/profiles/stream-headless/package.json +16 -0
- package/scripts/build.mjs +103 -0
- package/scripts/check-consistency.mjs +146 -0
- package/scripts/gate.mjs +138 -0
- package/scripts/install-check.mjs +116 -0
- package/scripts/install-cycle.mjs +88 -0
- package/scripts/release.mjs +428 -0
- package/scripts/repair-session-logs.mjs +498 -0
- package/src/entry/action-gate.ts +206 -0
- package/src/entry/adapter-kit.ts +192 -0
- package/src/entry/context-render.ts +119 -0
- package/src/entry/control-bar-cli.ts +289 -0
- package/src/entry/control-bar.ts +123 -0
- package/src/entry/control-session.ts +115 -0
- package/src/entry/control-state.ts +125 -0
- package/src/entry/cordis-compat.ts +95 -0
- package/src/entry/eval-probe.ts +112 -0
- package/src/entry/intent-log.ts +121 -0
- package/src/entry/json-persistence.ts +306 -0
- package/src/entry/loop.ts +4163 -0
- package/src/entry/mock-provider.ts +549 -0
- package/src/entry/obs-broker.ts +178 -0
- package/src/entry/ptc-bridge.ts +405 -0
- package/src/entry/state-handle.ts +217 -0
- package/src/entry/takeover-registry.ts +60 -0
- package/src/kernel/control-bar.ts +559 -0
- package/src/kernel/final.ts +62 -0
- package/src/kernel/gate.ts +464 -0
- package/src/kernel/modes.ts +253 -0
- package/src/kernel/obs.ts +517 -0
- package/src/kernel/parser.ts +1081 -0
- package/src/kernel/render.ts +466 -0
- package/src/kernel/state.ts +416 -0
- package/src/version.ts +9 -0
- package/test/activation.test.ts +187 -0
- package/test/adapters.test.ts +676 -0
- package/test/control-bar.test.ts +486 -0
- package/test/desktop-ui.test.ts +359 -0
- package/test/eval-probe.test.ts +139 -0
- package/test/f5-plan.test.ts +221 -0
- package/test/f6-intent.test.ts +168 -0
- package/test/f7-segment.test.ts +190 -0
- package/test/fix-limits.test.ts +599 -0
- package/test/gate.test.ts +380 -0
- package/test/helpers/stub-loop.ts +240 -0
- package/test/host-conformance.test.ts +418 -0
- package/test/kernel/obs.test.ts +329 -0
- package/test/kernel/parser.test.ts +451 -0
- package/test/loop.test.ts +1393 -0
- package/test/mock-provider.test.ts +386 -0
- package/test/ptc-bridge.test.ts +356 -0
- package/test/render.test.ts +418 -0
- package/test/s2-install-check.test.ts +46 -0
- package/test/scenarios/3-file-basic.json +13 -0
- package/test/scenarios/5-file-basic.json +22 -0
- package/test/scenarios/burn-more.json +9 -0
- package/test/scenarios/degraded-final.json +10 -0
- package/test/scenarios/fault-abort-xml.json +11 -0
- package/test/scenarios/fault-malformed-command.json +12 -0
- package/test/scenarios/fault-midstream-abort.json +11 -0
- package/test/scenarios/fault-saturating-output.json +9 -0
- package/test/scenarios/fault-timeout.json +9 -0
- package/test/scenarios/peek-first.json +11 -0
- package/test/scenarios/peek-second.json +11 -0
- package/test/scenarios/peek-third.json +10 -0
- package/test/scenarios/recover-final.json +10 -0
- package/test/scenarios/reroute-first.json +17 -0
- package/test/scenarios/reroute-second.json +16 -0
- package/test/scenarios/starvation-final.json +10 -0
- package/test/scenarios/starvation-promote.json +11 -0
- package/test/scenarios/wait-tools-continue.json +10 -0
- package/test/scenarios/wait-tools-xml.json +22 -0
- package/test/scenarios/wait-tools.json +15 -0
- package/test/session-format.test.ts +234 -0
- package/test/state.test.ts +335 -0
- package/test/stream-v02.test.ts +264 -0
- package/test/v031-display.test.ts +333 -0
- package/test/v032-conflict.test.ts +191 -0
- package/test/v032-truncation.test.ts +291 -0
- package/ui/client.js +576 -0
- package/ui/index.js +282 -0
- package/ui/package.json +26 -0
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
// entry/cordis-compat.ts —— Cordis 4.x 适配纪律(v0.2.1 修复:桌面端整层接管未激活)
|
|
2
|
+
//
|
|
3
|
+
// 事故(v0.2.0,dsh 桌面 profile 实测):
|
|
4
|
+
// warning: 1 entry did not activate stream-agent
|
|
5
|
+
// cannot get property "ptcRuntime" without inject
|
|
6
|
+
//
|
|
7
|
+
// 两个独立的装载期缺陷叠在同一条路径上,第一个先炸、第二个被掩盖:
|
|
8
|
+
//
|
|
9
|
+
// 【缺陷 1|属性裸读】Cordis 4.x 的 context 是 Proxy,get trap
|
|
10
|
+
// (cordis/lib/index.js:1251-1280)对「未在 inject 里声明的服务」做**裸属性读取**会直接抛:
|
|
11
|
+
// `cannot get property "<name>" without inject`
|
|
12
|
+
// v0.2.0 的 loop entry 写的是
|
|
13
|
+
// (ctx as { ptcRuntime?: unknown }).ptcRuntime ?? ctx.get?.('ptcRuntime')
|
|
14
|
+
// ——`??` 左侧先求值,属性读取先抛,右侧的 ctx.get 兜底永远到不了。ptcRuntime 是
|
|
15
|
+
// *可选* 服务(宿主不挂 PTC 时不存在),于是 apply() 在装载期抛错。
|
|
16
|
+
//
|
|
17
|
+
// 【缺陷 2|effect 契约】同一个 apply 末尾 `return { factory, dispose }`。Cordis 的函数式
|
|
18
|
+
// 插件把**返回值当作 effect 收集**(cordis/lib/index.js:431-459 `_execute`):
|
|
19
|
+
// 只有 function / null / thenable / iterator 合法,返回普通对象直接
|
|
20
|
+
// `TypeError: Invalid effect`(:460)。五个 entry 全都返回句柄对象,因此即使修好缺陷 1,
|
|
21
|
+
// 每个 entry 仍会失败——只是报错换成 "Invalid effect",更难定位。
|
|
22
|
+
//
|
|
23
|
+
// 后果(两者相同):fiber 进入 failed 态(state 3)→ apply 里的注册被回滚 →
|
|
24
|
+
// agent factory 没有注册 → bundle 里内建 agent-loop 已被停用 →
|
|
25
|
+
// 该 profile 里一个 agent 都创建不出来(插件"装了但完全不能用")。
|
|
26
|
+
//
|
|
27
|
+
// 纪律(本文件即唯一出口):
|
|
28
|
+
// 1. 可选服务只走 ctx.get(name)(reflect.get 明确无 inject 要求,
|
|
29
|
+
// cordis/lib/index.js:1329-1349 的注释原文:"Read a service from the store
|
|
30
|
+
// without the inject requirement")。
|
|
31
|
+
// 2. 兼容非 Cordis 的测试桩:桩对象把服务直接挂在 ctx 上,因此 ctx.get 未命中时
|
|
32
|
+
// 再试一次属性读取——但**必须**包在 try/catch 里,让 inject 守卫的抛错降级为
|
|
33
|
+
// "服务不存在",而不是毁掉整个 entry 的装载。
|
|
34
|
+
// 3. 绝不把可选服务写进 inject 数组:数组形式在 Cordis 里是「必需」,服务缺席时
|
|
35
|
+
// fiber 会永远 pending(装载被挂起),比抛错更难排查。
|
|
36
|
+
// 4. entry 的返回值必须是**函数**(disposer):句柄对象经 asPluginEffect() 包一层,
|
|
37
|
+
// 属性全部挂在函数上,测试与调用方照旧读 handle.xxx,Cordis 侧拿到的是合法 effect。
|
|
38
|
+
|
|
39
|
+
/** 探测所需的最小 context 面(Cordis 与测试桩的公共子集)。 */
|
|
40
|
+
export interface ServiceProbeCtx {
|
|
41
|
+
get?(service: string): unknown;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* 读取一个可选服务;不存在、不可用或触发 inject 守卫时一律返回 undefined。
|
|
46
|
+
*
|
|
47
|
+
* @param ctx 宿主 context(Cordis Proxy 或测试桩)
|
|
48
|
+
* @param name 服务名(如 'ptcRuntime' / 'sessionProjections' / 'loader')
|
|
49
|
+
*/
|
|
50
|
+
export function getService<T>(ctx: unknown, name: string): T | undefined {
|
|
51
|
+
const probe = ctx as ServiceProbeCtx | undefined;
|
|
52
|
+
if (probe === undefined || probe === null) return undefined;
|
|
53
|
+
// ① 正路:reflect.get,不需要 inject
|
|
54
|
+
try {
|
|
55
|
+
const value = probe.get?.(name);
|
|
56
|
+
if (value !== undefined && value !== null) return value as T;
|
|
57
|
+
} catch {
|
|
58
|
+
// ctx.get 在极端桩上也可能抛:按缺失处理,继续 ②
|
|
59
|
+
}
|
|
60
|
+
// ② 兼容路:测试桩把服务挂在 ctx 上;Cordis 下这一步会被 inject 守卫拦下 →
|
|
61
|
+
// catch 掉,语义仍是"服务不存在"(绝不让它冒泡毁掉 entry)
|
|
62
|
+
try {
|
|
63
|
+
const value = (ctx as Record<string, unknown>)[name];
|
|
64
|
+
if (value !== undefined && value !== null) return value as T;
|
|
65
|
+
} catch {
|
|
66
|
+
return undefined;
|
|
67
|
+
}
|
|
68
|
+
return undefined;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/** 服务存在且具备指定方法(鸭子类型校验,避免"服务在但形状不对"炸在半路)。 */
|
|
72
|
+
export function hasMethod(service: unknown, method: string): boolean {
|
|
73
|
+
return service !== null && typeof service === 'object'
|
|
74
|
+
&& typeof (service as Record<string, unknown>)[method] === 'function';
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/**
|
|
78
|
+
* 把 entry 的句柄对象包成 Cordis 合法的 effect(返回函数 = disposer)。
|
|
79
|
+
*
|
|
80
|
+
* Cordis 的函数式插件契约:返回值只能是 function / null / thenable / iterator
|
|
81
|
+
* (cordis/lib/index.js:431-459),普通对象会被判为 `Invalid effect` 并让 fiber 失败。
|
|
82
|
+
* 本包五个 entry 都返回句柄对象(测试与调用方按对象读取),因此统一经此包装:
|
|
83
|
+
* 函数本体负责卸载(调用句柄上的 dispose),句柄的全部属性照旧可直接读。
|
|
84
|
+
*
|
|
85
|
+
* @example
|
|
86
|
+
* const handle = { service, dispose };
|
|
87
|
+
* return asPluginEffect(handle); // typeof 返回值 === 'function'
|
|
88
|
+
*/
|
|
89
|
+
export function asPluginEffect<T extends object>(handle: T): T & (() => void) {
|
|
90
|
+
const disposer = (): void => {
|
|
91
|
+
const dispose = (handle as { dispose?: unknown }).dispose;
|
|
92
|
+
if (typeof dispose === 'function') (dispose as () => void)();
|
|
93
|
+
};
|
|
94
|
+
return Object.assign(disposer, handle) as T & (() => void);
|
|
95
|
+
}
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
// entry/eval-probe.ts —— 中立评测探针(分派 08,METRICS.md E4 插桩事实)
|
|
2
|
+
//
|
|
3
|
+
// 职责(只读测量,不改流):挂 llm/stream waterfall(F4),逐请求把 GenerateOptions 原文
|
|
4
|
+
// (messages/config/…)与逐 chunk(含 usage 原文 JSON、finish)落盘 JSONL,供 08 号评测:
|
|
5
|
+
// - M1 单位任务 token:usage 原文逐条留存(E3:inputTokens 为未缓存输入,cache 分量单列);
|
|
6
|
+
// - M4 prefix_hash:逐请求 messages 原文(E2:session log 的 request/header 不含 messages);
|
|
7
|
+
// - M2 对账口径:请求序列(与 session log request/header 对账)。
|
|
8
|
+
// 两臂同装(baseline / stream 两个 eval patch),插桩对称 = 测量仪器不进对照变量。
|
|
9
|
+
//
|
|
10
|
+
// fail-open(红线 5):探针记录异常 → 立即停用记录(进程内一次告警),流原样透传绝不改写。
|
|
11
|
+
// 探针是 eval 专用 entry:生产 preset.yml 不引用;dumpDir 走 config 或 DSH_EVAL_PROBE_DIR env。
|
|
12
|
+
|
|
13
|
+
import { appendFileSync, mkdirSync } from 'node:fs';
|
|
14
|
+
import { dirname, join } from 'node:path';
|
|
15
|
+
import { makeWarn } from './adapter-kit.ts';
|
|
16
|
+
import type { HostCtxLike } from './adapter-kit.ts';
|
|
17
|
+
|
|
18
|
+
/** 镜像 dsh-llm/lib/types/index.d.ts:45 llm/stream waterfall 监听器面(duck-type) */
|
|
19
|
+
type StreamListener = (options: Record<string, unknown>, next: () => AsyncIterable<unknown>) => AsyncIterable<unknown>;
|
|
20
|
+
|
|
21
|
+
export interface EvalProbeConfig {
|
|
22
|
+
/** 落盘目录(缺省读 DSH_EVAL_PROBE_DIR env;两者都无 → 只透传不记录 + 一次告警) */
|
|
23
|
+
dumpDir?: string;
|
|
24
|
+
/** 落盘文件名(缺省 probe.jsonl;一个进程一个文件,pid 记进每条记录) */
|
|
25
|
+
file?: string;
|
|
26
|
+
/** 装载自证横幅(排障用) */
|
|
27
|
+
announce?: boolean;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/** 循环安全的 JSON 序列化(messages 可能含宿主对象;失败降级为标记位 + 占位文本) */
|
|
31
|
+
function safeJson(value: unknown): { ok: boolean; text: string } {
|
|
32
|
+
try {
|
|
33
|
+
return { ok: true, text: JSON.stringify(value, (_k, v) => (typeof v === 'bigint' ? String(v) : v)) };
|
|
34
|
+
} catch {
|
|
35
|
+
return { ok: false, text: JSON.stringify({ unserializable: String(value).slice(0, 2000) }) };
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
export const name = 'stream-agent-eval-probe';
|
|
40
|
+
export const inject: string[] = [];
|
|
41
|
+
|
|
42
|
+
export interface EvalProbeHandle {
|
|
43
|
+
file: string | undefined;
|
|
44
|
+
requestCount: () => number;
|
|
45
|
+
dispose: () => void;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
export default function apply(ctx: HostCtxLike, config: EvalProbeConfig = {}): EvalProbeHandle {
|
|
49
|
+
const warn = makeWarn(ctx, 'eval-probe');
|
|
50
|
+
const dumpDir = config.dumpDir ?? process.env.DSH_EVAL_PROBE_DIR ?? '';
|
|
51
|
+
const file = dumpDir === '' ? undefined : join(dumpDir, config.file ?? 'probe.jsonl');
|
|
52
|
+
let disabled = file === undefined;
|
|
53
|
+
if (disabled) {
|
|
54
|
+
warn('未配置 dumpDir/DSH_EVAL_PROBE_DIR:探针挂载但只透传不记录(评测装配遗漏?)');
|
|
55
|
+
} else {
|
|
56
|
+
try {
|
|
57
|
+
mkdirSync(dirname(file as string), { recursive: true });
|
|
58
|
+
} catch (error) {
|
|
59
|
+
disabled = true;
|
|
60
|
+
warn('dumpDir 不可创建:探针停用记录,只透传(fail-open)', error);
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
let seq = 0;
|
|
64
|
+
|
|
65
|
+
const appendLine = (line: string): void => {
|
|
66
|
+
appendFileSync(file as string, line + '\n', 'utf8');
|
|
67
|
+
};
|
|
68
|
+
|
|
69
|
+
const onStream: StreamListener = (options, next) => {
|
|
70
|
+
if (disabled) return next();
|
|
71
|
+
const seqNow = ++seq;
|
|
72
|
+
try {
|
|
73
|
+
const s = safeJson(options);
|
|
74
|
+
appendLine(JSON.stringify({
|
|
75
|
+
kind: 'request', seq: seqNow, at: Date.now(), pid: process.pid,
|
|
76
|
+
session: options['sessionId'] ?? '', optionsDirty: !s.ok, options: s.text,
|
|
77
|
+
}));
|
|
78
|
+
} catch (error) {
|
|
79
|
+
disabled = true;
|
|
80
|
+
warn('探针记录失败:本进程停用记录,流原样透传(fail-open)', error);
|
|
81
|
+
return next();
|
|
82
|
+
}
|
|
83
|
+
const inner = next();
|
|
84
|
+
return (async function* () {
|
|
85
|
+
try {
|
|
86
|
+
for await (const chunk of inner) {
|
|
87
|
+
try {
|
|
88
|
+
const s = safeJson(chunk);
|
|
89
|
+
appendLine(JSON.stringify({ kind: 'chunk', seq: seqNow, at: Date.now(), chunk: s.text }));
|
|
90
|
+
} catch { /* 记录失败不影响流转发(fail-open 分界:测量不动流本身) */ }
|
|
91
|
+
yield chunk; // 原样透传:一个字节不改
|
|
92
|
+
}
|
|
93
|
+
} finally {
|
|
94
|
+
try {
|
|
95
|
+
appendLine(JSON.stringify({ kind: 'stream-end', seq: seqNow, at: Date.now() }));
|
|
96
|
+
} catch { /* 同上 */ }
|
|
97
|
+
}
|
|
98
|
+
})();
|
|
99
|
+
};
|
|
100
|
+
|
|
101
|
+
if (typeof ctx.on !== 'function') throw new Error('[eval-probe] ctx.on 不可用:无法挂载 llm/stream');
|
|
102
|
+
ctx.on('llm/stream', onStream as unknown as (...args: never[]) => unknown);
|
|
103
|
+
if (config.announce === true) {
|
|
104
|
+
console.error(`[eval-probe] mounted: llm/stream passthrough + capture${file === undefined ? '' : ` -> ${file}`}`);
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
return {
|
|
108
|
+
file,
|
|
109
|
+
requestCount: () => seq,
|
|
110
|
+
dispose: () => {},
|
|
111
|
+
};
|
|
112
|
+
}
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
// entry/intent-log.ts —— F6 恢复意图:写前意图落盘(fsync)+ 写后回执 + resume 停机核对
|
|
2
|
+
//
|
|
3
|
+
// 红线(v0.4.0 规划 F6,随 0.3.0 实施):
|
|
4
|
+
// · 意图必须在写入发生**之前**落盘并 fsync——崩溃后"有意图无回执"即可判定"写入可能已发生";
|
|
5
|
+
// · 写后回执记录结果与时间;三态判定:未发生(意图前崩溃)/ 已发生(有意图有回执且 ok)/
|
|
6
|
+
// 不确定(有意图无回执——强制杀在写入中);
|
|
7
|
+
// · resume 时"有意图无回执"一律**停机核对**,不自动重放、不自动继续;
|
|
8
|
+
// · 零注入:意图与回执不进模型上下文,只在账本与 resume 判定中使用。
|
|
9
|
+
//
|
|
10
|
+
// 文件布局:<stateRoot>/intents/<sessionId>.jsonl,每行一个 JSON 记录:
|
|
11
|
+
// { type:'intent', seq, at, sessionId, cmdId, op, path, fingerprint }
|
|
12
|
+
// { type:'receipt', seq, at, intentSeq, ok, detail? }
|
|
13
|
+
// { type:'ack', seq, at, intentSeqs, note? } —— 人工核对后的确认(CLI intents --ack)
|
|
14
|
+
|
|
15
|
+
import { closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, writeFileSync } from 'node:fs';
|
|
16
|
+
import { createHash } from 'node:crypto';
|
|
17
|
+
import { dirname, join } from 'node:path';
|
|
18
|
+
|
|
19
|
+
/** 写前意图记录(写入发生前 fsync 落盘)。 */
|
|
20
|
+
export interface IntentRecord {
|
|
21
|
+
type: 'intent';
|
|
22
|
+
seq: number;
|
|
23
|
+
at: string;
|
|
24
|
+
sessionId: string;
|
|
25
|
+
cmdId: string;
|
|
26
|
+
/** 操作类型:write / edit / append(与 tf-write / tf-edit / tf-append 一一对应) */
|
|
27
|
+
op: 'write' | 'edit' | 'append';
|
|
28
|
+
path: string;
|
|
29
|
+
/** 内容指纹(sha256 前 16 位)——对账"写的是什么",不落内容本身 */
|
|
30
|
+
fingerprint: string;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/** 写后回执记录(命令落定即追加;失败也记——把意图闭合为"已发生但失败")。 */
|
|
34
|
+
export interface IntentReceiptRecord {
|
|
35
|
+
type: 'receipt';
|
|
36
|
+
seq: number;
|
|
37
|
+
at: string;
|
|
38
|
+
/** 对应 intent.seq;-1 = 找不到对应意图(防御式,不静默丢) */
|
|
39
|
+
intentSeq: number;
|
|
40
|
+
ok: boolean;
|
|
41
|
+
detail?: string;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/** 人工核对确认(CLI intents --ack;停机核对的出口)。 */
|
|
45
|
+
export interface IntentAckRecord {
|
|
46
|
+
type: 'ack';
|
|
47
|
+
seq: number;
|
|
48
|
+
at: string;
|
|
49
|
+
intentSeqs: number[];
|
|
50
|
+
note?: string;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
export type IntentLogRecord = IntentRecord | IntentReceiptRecord | IntentAckRecord;
|
|
54
|
+
|
|
55
|
+
/** 内容指纹(sha256 前 16 位;够对账,不泄露内容)。 */
|
|
56
|
+
export function intentFingerprint(content: string): string {
|
|
57
|
+
return createHash('sha256').update(content, 'utf8').digest('hex').slice(0, 16);
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/** 会话的意图日志路径:<stateRoot>/intents/<sessionId>.jsonl。 */
|
|
61
|
+
export function intentFileOf(stateRoot: string, sessionId: string): string {
|
|
62
|
+
return join(stateRoot, 'intents', `${sessionId}.jsonl`);
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/** 追加一条记录并 fsync(崩溃安全的关键:写入发生前意图必须已到盘)。 */
|
|
66
|
+
export function appendIntentRecord(file: string, record: IntentLogRecord): void {
|
|
67
|
+
mkdirSync(dirname(file), { recursive: true });
|
|
68
|
+
const fd = openSync(file, 'a');
|
|
69
|
+
try {
|
|
70
|
+
writeFileSync(fd, `${JSON.stringify(record)}\n`, { encoding: 'utf8' });
|
|
71
|
+
fsyncSync(fd);
|
|
72
|
+
} finally {
|
|
73
|
+
closeSync(fd);
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/** 读取全部记录(坏行如实跳过并计数,不中断——崩溃可能截断最后一行)。 */
|
|
78
|
+
export function loadIntentRecords(file: string): { records: IntentLogRecord[]; badLines: number } {
|
|
79
|
+
if (!existsSync(file)) return { records: [], badLines: 0 };
|
|
80
|
+
const records: IntentLogRecord[] = [];
|
|
81
|
+
let badLines = 0;
|
|
82
|
+
for (const line of readFileSync(file, 'utf8').split('\n')) {
|
|
83
|
+
if (line.trim() === '') continue;
|
|
84
|
+
try {
|
|
85
|
+
const parsed = JSON.parse(line) as IntentLogRecord;
|
|
86
|
+
if (parsed.type === 'intent' || parsed.type === 'receipt' || parsed.type === 'ack') records.push(parsed);
|
|
87
|
+
else badLines += 1;
|
|
88
|
+
} catch {
|
|
89
|
+
badLines += 1;
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
return { records, badLines };
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
export interface PendingIntent {
|
|
96
|
+
intent: IntentRecord;
|
|
97
|
+
/** 三态判定:pending = 有意图无回执(不确定:写入可能已发生);failed = 已发生但失败 */
|
|
98
|
+
state: 'pending' | 'failed';
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/**
|
|
102
|
+
* 计算"有意图无回执"集合(resume 停机核对的输入):
|
|
103
|
+
* - intent 没有任何 receipt 引用、也不在任何 ack 里 → pending(不确定);
|
|
104
|
+
* - intent 的 receipt ok=false 且无后续 ack → failed(已发生但失败——列出供参考,不阻断)。
|
|
105
|
+
*/
|
|
106
|
+
export function pendingIntents(records: readonly IntentLogRecord[]): PendingIntent[] {
|
|
107
|
+
const receiptByIntent = new Map<number, IntentReceiptRecord>();
|
|
108
|
+
const acked = new Set<number>();
|
|
109
|
+
for (const r of records) {
|
|
110
|
+
if (r.type === 'receipt') receiptByIntent.set(r.intentSeq, r);
|
|
111
|
+
if (r.type === 'ack') for (const seq of r.intentSeqs) acked.add(seq);
|
|
112
|
+
}
|
|
113
|
+
const out: PendingIntent[] = [];
|
|
114
|
+
for (const r of records) {
|
|
115
|
+
if (r.type !== 'intent' || acked.has(r.seq)) continue;
|
|
116
|
+
const receipt = receiptByIntent.get(r.seq);
|
|
117
|
+
if (receipt === undefined) out.push({ intent: r, state: 'pending' });
|
|
118
|
+
else if (!receipt.ok) out.push({ intent: r, state: 'failed' });
|
|
119
|
+
}
|
|
120
|
+
return out;
|
|
121
|
+
}
|
|
@@ -0,0 +1,306 @@
|
|
|
1
|
+
// entry/json-persistence.ts —— 插件本地持久化兜底(修复已知限制 3 / 4)
|
|
2
|
+
//
|
|
3
|
+
// 职责:宿主缺 storage backend、缺 sessionPersistence、或 dsh-session 模块不可达
|
|
4
|
+
// (bundle 形态 bare import 解析不到宿主同一副本)时,提供零依赖的本地文件持久化面:
|
|
5
|
+
// ① JsonFileKvUnit —— KvUnit 的本地 JSON 文件实现(state-handle 降级用:
|
|
6
|
+
// 句柄目录 + blob 落盘,resume 可重建,不再是易失内存);
|
|
7
|
+
// ② createJsonlPersistence —— 会话事件 JSONL 持久化(AgentFactory.create/resume 的
|
|
8
|
+
// persistence 降级实现;headless 未挂 sessionPersistence 时
|
|
9
|
+
// 跨会话 resume 真正可用);
|
|
10
|
+
// ③ FileLedgerSink —— plugin:tf-agent/* 台账的 JSONL 落点(bundle 形态 plugin
|
|
11
|
+
// record 通道降级时的可重放落点,不再是易失内存台账);
|
|
12
|
+
// ④ withEventCapture —— 会话 append 代理:事件镜像进 ② 的 JSONL(仅降级路径用)。
|
|
13
|
+
//
|
|
14
|
+
// 纪律(与 adapter-kit 一致):零 @deepseek-ai 依赖;fail-open(红线 5)——
|
|
15
|
+
// IO 失败向上抛错或走告警出口,绝不静默吞事实。
|
|
16
|
+
|
|
17
|
+
import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
|
|
18
|
+
import { homedir } from 'node:os';
|
|
19
|
+
import { dirname, join } from 'node:path';
|
|
20
|
+
import type { KvUnitLike, Warn } from './adapter-kit.ts';
|
|
21
|
+
|
|
22
|
+
// ---------------------------------------------------------------------------
|
|
23
|
+
// 状态目录
|
|
24
|
+
// ---------------------------------------------------------------------------
|
|
25
|
+
|
|
26
|
+
/** 状态根目录解析:config 显式指定 → env STREAM_AGENT_STATE_DIR → ~/.dsh-stream-agent */
|
|
27
|
+
export function resolveStateDir(configDir?: string): string {
|
|
28
|
+
if (configDir !== undefined && configDir.trim() !== '') return configDir;
|
|
29
|
+
const env = process.env.STREAM_AGENT_STATE_DIR;
|
|
30
|
+
if (env !== undefined && env.trim() !== '') return env;
|
|
31
|
+
return join(homedir(), '.dsh-stream-agent');
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/** 文件名安全化(session id 可能含 ':' '/' 等路径字符)。 */
|
|
35
|
+
export function safeFileName(id: string): string {
|
|
36
|
+
return id.replace(/[^a-zA-Z0-9._-]/g, '_') || 'session';
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
// ---------------------------------------------------------------------------
|
|
40
|
+
// ① KvUnit —— JSON 文件实现(镜像 adapter-kit.KvUnitLike)
|
|
41
|
+
// ---------------------------------------------------------------------------
|
|
42
|
+
|
|
43
|
+
interface JsonKvFile {
|
|
44
|
+
tables: Record<string, Record<string, unknown>>;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
function loadJsonKv(file: string, warn: Warn): JsonKvFile {
|
|
48
|
+
if (!existsSync(file)) return { tables: {} };
|
|
49
|
+
try {
|
|
50
|
+
const raw = JSON.parse(readFileSync(file, 'utf8')) as Partial<JsonKvFile>;
|
|
51
|
+
return { tables: (raw.tables ?? {}) as Record<string, Record<string, unknown>> };
|
|
52
|
+
} catch (error) {
|
|
53
|
+
warn(`本地 KvUnit 文件损坏,按空库打开(原文件保留在 ${file}.corrupt 语义之外,不做改写)`, error);
|
|
54
|
+
return { tables: {} };
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/** 原子写:tmp + rename,避免半截 JSON。 */
|
|
59
|
+
function flushJsonKv(file: string, data: JsonKvFile): void {
|
|
60
|
+
const tmp = `${file}.tmp`;
|
|
61
|
+
writeFileSync(tmp, JSON.stringify(data), 'utf8');
|
|
62
|
+
renameSync(tmp, file);
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* 本地 JSON 文件 KvUnit。open 时创建目录并真实写一次(可写性探针失败即抛,
|
|
67
|
+
* 由调用方走最终内存降级——绝不带着假 durable 面)。putRecord 走串行队列
|
|
68
|
+
* 防读改写竞态;每次写全量重写文件(插件规模的状态量下足够,简单优先)。
|
|
69
|
+
*/
|
|
70
|
+
export class JsonFileKvUnit implements KvUnitLike {
|
|
71
|
+
readonly #file: string;
|
|
72
|
+
readonly #warn: Warn;
|
|
73
|
+
readonly #cache: JsonKvFile;
|
|
74
|
+
#queue: Promise<void> = Promise.resolve();
|
|
75
|
+
#closed = false;
|
|
76
|
+
|
|
77
|
+
constructor(dir: string, name: string, warn: Warn) {
|
|
78
|
+
this.#warn = warn;
|
|
79
|
+
mkdirSync(dir, { recursive: true });
|
|
80
|
+
this.#file = join(dir, `${safeFileName(name)}.json`);
|
|
81
|
+
// 可写性探针:文件缺失时落一次空库(rename 原子性同时验证目录可写)
|
|
82
|
+
if (!existsSync(this.#file)) flushJsonKv(this.#file, { tables: {} });
|
|
83
|
+
this.#cache = loadJsonKv(this.#file, warn);
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
/** 实际落盘文件路径(排障/日志用)。 */
|
|
87
|
+
get file(): string {
|
|
88
|
+
return this.#file;
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
async loadAll(): Promise<{ tables: Record<string, Record<string, unknown>>; global: unknown }> {
|
|
92
|
+
return { tables: this.#cache.tables, global: null };
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
async putRecord(table: string, key: string, value: unknown): Promise<void> {
|
|
96
|
+
const op = this.#queue.then(() => {
|
|
97
|
+
if (this.#closed) throw new Error('kv unit closed');
|
|
98
|
+
const t = this.#cache.tables[table] ?? (this.#cache.tables[table] = {});
|
|
99
|
+
t[key] = value;
|
|
100
|
+
flushJsonKv(this.#file, this.#cache);
|
|
101
|
+
});
|
|
102
|
+
this.#queue = op.catch(() => {}); // 队列不因单次失败卡死;错误由 await 侧上抛
|
|
103
|
+
await op;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
async close(): Promise<void> {
|
|
107
|
+
await this.#queue;
|
|
108
|
+
this.#closed = true;
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
// ---------------------------------------------------------------------------
|
|
113
|
+
// ② 会话事件 JSONL 持久化(AgentFactory.create/resume 的 persistence 降级实现)
|
|
114
|
+
// ---------------------------------------------------------------------------
|
|
115
|
+
|
|
116
|
+
const HEADER_KIND = '__tf_agent_header__';
|
|
117
|
+
|
|
118
|
+
export interface JsonlSessionHandle {
|
|
119
|
+
close(): Promise<void>;
|
|
120
|
+
append(events: readonly unknown[]): Promise<void>;
|
|
121
|
+
read(from: number): Promise<{ events: readonly unknown[]; eventState?: unknown }>;
|
|
122
|
+
header: unknown;
|
|
123
|
+
inheritedEventCount?: number;
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
export interface JsonlPersistence {
|
|
127
|
+
create(header: unknown, opts?: { inheritedEventCount?: number; signal?: AbortSignal }): Promise<JsonlSessionHandle>;
|
|
128
|
+
open(id: string, mode: string, opts?: { signal?: AbortSignal }): Promise<JsonlSessionHandle>;
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
/**
|
|
132
|
+
* 逐会话一个 JSONL 文件:<sessionsDir>/<sessionId>.jsonl。
|
|
133
|
+
* 首行 header(kind=__tf_agent_header__),后续每行一个会话事件(原样对象)。
|
|
134
|
+
* append 同步落盘(appendFileSync;会话事件频度低,简单优先于缓冲)。
|
|
135
|
+
*/
|
|
136
|
+
class JsonlSessionFile {
|
|
137
|
+
readonly #file: string;
|
|
138
|
+
readonly #warn: Warn;
|
|
139
|
+
readonly #sessionId: string;
|
|
140
|
+
#header: unknown = undefined;
|
|
141
|
+
#inheritedEventCount: number | undefined = undefined;
|
|
142
|
+
#events: unknown[] = [];
|
|
143
|
+
#loaded = false;
|
|
144
|
+
|
|
145
|
+
constructor(sessionsDir: string, sessionId: string, warn: Warn) {
|
|
146
|
+
this.#warn = warn;
|
|
147
|
+
this.#sessionId = sessionId;
|
|
148
|
+
mkdirSync(sessionsDir, { recursive: true });
|
|
149
|
+
this.#file = join(sessionsDir, `${safeFileName(sessionId)}.jsonl`);
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
/** create 路径:写 header 行(已存在文件 → 抛错,上层转 resume 语义打开)。 */
|
|
153
|
+
initHeader(header: unknown, inheritedEventCount?: number): void {
|
|
154
|
+
if (existsSync(this.#file)) {
|
|
155
|
+
throw new Error(`session already exists: ${this.#sessionId}`);
|
|
156
|
+
}
|
|
157
|
+
appendFileSync(this.#file, `${JSON.stringify({ kind: HEADER_KIND, header, inheritedEventCount })}\n`, 'utf8');
|
|
158
|
+
this.#header = header;
|
|
159
|
+
this.#inheritedEventCount = inheritedEventCount;
|
|
160
|
+
this.#loaded = true;
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
/** open 路径:冷读全部行(坏行跳过 + 告警,不静默吞事件)。 */
|
|
164
|
+
load(): void {
|
|
165
|
+
this.#events = [];
|
|
166
|
+
if (!existsSync(this.#file)) {
|
|
167
|
+
throw new Error(`session log not found: ${this.#sessionId}`);
|
|
168
|
+
}
|
|
169
|
+
const lines = readFileSync(this.#file, 'utf8').split('\n');
|
|
170
|
+
let first = true;
|
|
171
|
+
for (const line of lines) {
|
|
172
|
+
if (line.trim() === '') continue;
|
|
173
|
+
let parsed: unknown;
|
|
174
|
+
try {
|
|
175
|
+
parsed = JSON.parse(line);
|
|
176
|
+
} catch (error) {
|
|
177
|
+
this.#warn(`会话 JSONL 坏行跳过(${this.#file})`, error);
|
|
178
|
+
continue;
|
|
179
|
+
}
|
|
180
|
+
const rec = parsed as { kind?: unknown; header?: unknown; inheritedEventCount?: unknown };
|
|
181
|
+
if (first && rec?.kind === HEADER_KIND) {
|
|
182
|
+
this.#header = rec.header;
|
|
183
|
+
this.#inheritedEventCount = typeof rec.inheritedEventCount === 'number' ? rec.inheritedEventCount : undefined;
|
|
184
|
+
first = false;
|
|
185
|
+
continue;
|
|
186
|
+
}
|
|
187
|
+
first = false;
|
|
188
|
+
this.#events.push(parsed);
|
|
189
|
+
}
|
|
190
|
+
this.#loaded = true;
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
async append(events: readonly unknown[]): Promise<void> {
|
|
194
|
+
if (!this.#loaded) throw new Error('session jsonl not initialized');
|
|
195
|
+
for (const event of events) {
|
|
196
|
+
appendFileSync(this.#file, `${JSON.stringify(event)}\n`, 'utf8');
|
|
197
|
+
this.#events.push(event);
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
async read(from: number): Promise<{ events: readonly unknown[]; eventState?: unknown }> {
|
|
202
|
+
if (!this.#loaded) throw new Error('session jsonl not initialized');
|
|
203
|
+
const start = Math.max(0, Math.floor(from));
|
|
204
|
+
return { events: this.#events.slice(start) };
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
async close(): Promise<void> {
|
|
208
|
+
// appendFileSync 直写,无需 flush
|
|
209
|
+
}
|
|
210
|
+
|
|
211
|
+
get headerValue(): unknown {
|
|
212
|
+
return this.#header;
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
get inheritedCount(): number | undefined {
|
|
216
|
+
return this.#inheritedEventCount;
|
|
217
|
+
}
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
/** 创建 per-session 的 JSONL persistence 工厂(AgentFactory 降级接驳点)。 */
|
|
221
|
+
export function createJsonlPersistence(sessionsDir: string, sessionId: string, warn: Warn): JsonlPersistence {
|
|
222
|
+
return {
|
|
223
|
+
async create(header, opts) {
|
|
224
|
+
const f = new JsonlSessionFile(sessionsDir, sessionId, warn);
|
|
225
|
+
f.initHeader(header, opts?.inheritedEventCount);
|
|
226
|
+
return f;
|
|
227
|
+
},
|
|
228
|
+
async open(id) {
|
|
229
|
+
const f = new JsonlSessionFile(sessionsDir, id, warn);
|
|
230
|
+
f.load();
|
|
231
|
+
return f;
|
|
232
|
+
},
|
|
233
|
+
};
|
|
234
|
+
}
|
|
235
|
+
|
|
236
|
+
// ---------------------------------------------------------------------------
|
|
237
|
+
// ③ plugin:tf-agent/* 台账 JSONL(bundle 形态 plugin record 通道降级落点)
|
|
238
|
+
// ---------------------------------------------------------------------------
|
|
239
|
+
|
|
240
|
+
export interface FileLedgerFallback {
|
|
241
|
+
appendRecord(type: string, data: unknown): void;
|
|
242
|
+
/** 台账文件路径(resume 重放读取用;缺省 = 只写不读,无法重放) */
|
|
243
|
+
file?: string;
|
|
244
|
+
}
|
|
245
|
+
|
|
246
|
+
export function ledgerFileOf(stateDir: string, sessionId: string): string {
|
|
247
|
+
return join(stateDir, 'ledger', `${safeFileName(sessionId)}.jsonl`);
|
|
248
|
+
}
|
|
249
|
+
|
|
250
|
+
/** 追加一条台账记录(同步落盘;目录缺则建)。IO 失败向上抛——驱动器侧告警不静默。 */
|
|
251
|
+
export function appendLedgerRecord(file: string, type: string, data: unknown): void {
|
|
252
|
+
mkdirSync(dirname(file), { recursive: true });
|
|
253
|
+
appendFileSync(file, `${JSON.stringify({ at: new Date().toISOString(), type, data })}\n`, 'utf8');
|
|
254
|
+
}
|
|
255
|
+
|
|
256
|
+
/** 读回台账记录(resume 重放用;坏行跳过并计数,由调用方决定是否告警)。 */
|
|
257
|
+
export function loadLedgerRecords(file: string): { records: Array<{ type: string; data: unknown }>; skipped: number } {
|
|
258
|
+
if (!existsSync(file)) return { records: [], skipped: 0 };
|
|
259
|
+
const records: Array<{ type: string; data: unknown }> = [];
|
|
260
|
+
let skipped = 0;
|
|
261
|
+
for (const line of readFileSync(file, 'utf8').split('\n')) {
|
|
262
|
+
if (line.trim() === '') continue;
|
|
263
|
+
try {
|
|
264
|
+
const rec = JSON.parse(line) as { type?: unknown; data?: unknown };
|
|
265
|
+
if (typeof rec?.type === 'string') records.push({ type: rec.type, data: rec.data });
|
|
266
|
+
else skipped += 1;
|
|
267
|
+
} catch {
|
|
268
|
+
skipped += 1;
|
|
269
|
+
}
|
|
270
|
+
}
|
|
271
|
+
return { records, skipped };
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
// ---------------------------------------------------------------------------
|
|
275
|
+
// ④ 会话事件捕获代理(仅降级持久化路径使用)
|
|
276
|
+
// ---------------------------------------------------------------------------
|
|
277
|
+
|
|
278
|
+
/**
|
|
279
|
+
* 会话 append 代理:事件镜像进 JSONL,其余方法/属性原型链透传
|
|
280
|
+
* (snapshotEvents / header / seq 等行为不变)。宿主 checkpoint 机制依赖
|
|
281
|
+
* sessionPersistence 存在;降级路径没有它,事件捕获只能在这里做。
|
|
282
|
+
*/
|
|
283
|
+
export function withEventCapture(
|
|
284
|
+
session: unknown,
|
|
285
|
+
sink: { appendEvents(events: readonly unknown[]): void },
|
|
286
|
+
warn: Warn,
|
|
287
|
+
): unknown {
|
|
288
|
+
if (session === null || typeof session !== 'object') return session;
|
|
289
|
+
const target = session as { append?: (type: string, data: unknown, opts?: unknown) => unknown };
|
|
290
|
+
if (typeof target.append !== 'function') return session;
|
|
291
|
+
const wrapped = Object.create(session) as Record<string, unknown>;
|
|
292
|
+
wrapped.append = (type: string, data: unknown, opts?: unknown) => {
|
|
293
|
+
const appended = target.append!(type, data, opts);
|
|
294
|
+
// 落盘对象:宿主返回的完整事件优先(保真 seq/type/data),拿不到事件对象则用最小形状
|
|
295
|
+
const event = appended !== null && typeof appended === 'object'
|
|
296
|
+
? { type, data, ...(appended as Record<string, unknown>) }
|
|
297
|
+
: { type, data };
|
|
298
|
+
try {
|
|
299
|
+
sink.appendEvents([event]);
|
|
300
|
+
} catch (error) {
|
|
301
|
+
warn('会话事件镜像落盘失败(fail-open:内存事实不丢,本事件不再重试)', error);
|
|
302
|
+
}
|
|
303
|
+
return appended;
|
|
304
|
+
};
|
|
305
|
+
return wrapped;
|
|
306
|
+
}
|