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

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 (158) hide show
  1. package/CHANGELOG.md +497 -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 +3852 -0
  19. package/dist/entry/mock-provider.js +536 -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 +632 -0
  30. package/dist/kernel/render.js +444 -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 +415 -0
  87. package/scripts/repair-session-logs.mjs +403 -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 +3852 -0
  100. package/src/entry/mock-provider.ts +536 -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 +632 -0
  111. package/src/kernel/render.ts +444 -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/kernel/obs.test.ts +329 -0
  126. package/test/kernel/parser.test.ts +450 -0
  127. package/test/loop.test.ts +1393 -0
  128. package/test/mock-provider.test.ts +386 -0
  129. package/test/ptc-bridge.test.ts +356 -0
  130. package/test/render.test.ts +418 -0
  131. package/test/s2-install-check.test.ts +46 -0
  132. package/test/scenarios/3-file-basic.json +13 -0
  133. package/test/scenarios/5-file-basic.json +22 -0
  134. package/test/scenarios/burn-more.json +9 -0
  135. package/test/scenarios/degraded-final.json +10 -0
  136. package/test/scenarios/fault-abort-xml.json +11 -0
  137. package/test/scenarios/fault-malformed-command.json +12 -0
  138. package/test/scenarios/fault-midstream-abort.json +11 -0
  139. package/test/scenarios/fault-saturating-output.json +9 -0
  140. package/test/scenarios/fault-timeout.json +9 -0
  141. package/test/scenarios/peek-first.json +11 -0
  142. package/test/scenarios/peek-second.json +11 -0
  143. package/test/scenarios/peek-third.json +10 -0
  144. package/test/scenarios/recover-final.json +10 -0
  145. package/test/scenarios/reroute-first.json +17 -0
  146. package/test/scenarios/reroute-second.json +16 -0
  147. package/test/scenarios/starvation-final.json +10 -0
  148. package/test/scenarios/starvation-promote.json +11 -0
  149. package/test/scenarios/wait-tools-continue.json +10 -0
  150. package/test/scenarios/wait-tools-xml.json +22 -0
  151. package/test/scenarios/wait-tools.json +15 -0
  152. package/test/session-format.test.ts +234 -0
  153. package/test/state.test.ts +335 -0
  154. package/test/stream-v02.test.ts +264 -0
  155. package/test/v031-display.test.ts +333 -0
  156. package/ui/client.js +576 -0
  157. package/ui/index.js +282 -0
  158. package/ui/package.json +26 -0
@@ -0,0 +1,123 @@
1
+ // entry/control-bar.ts —— 控制栏 entry(v0.2.1)
2
+ //
3
+ // 三件事,全部 fail-open:
4
+ // ① 装载时把控制栏打到 stderr:接管状态 + 当前模式 + 上手四步 + 打开方式。
5
+ // bundle 激活对 CLI 是静默的(v0.2.0 的教训:用户只看到一条 warning),
6
+ // 控制栏是插件"自证已装载 + 教怎么用"的唯一直观出口。
7
+ // ② 提供 ctx.streamAgentControl 服务:其它 entry / 诊断脚本可读当前模式与语言。
8
+ // ③ 状态与 loop 共用同一份 control.json(control-state.ts),改模式不需要重启。
9
+ //
10
+ // 红线:本 entry 不得因为"配置坏了"而装载失败。resolveControlState 全程 fail-open,
11
+ // 告警走 logger/stderr,绝不上抛(v0.2.1 事故链见 cordis-compat.ts)。
12
+
13
+ import { createControlState, renderBanner, renderStatusBar } from '../kernel/control-bar.js';
14
+
15
+ import { getMode } from '../kernel/modes.js';
16
+
17
+ import { VERSION } from '../version.js';
18
+ import { asPluginEffect } from './cordis-compat.js';
19
+
20
+ import { resolveControlState, writePersistedControl } from './control-state.js';
21
+ import { isTakeoverActive, onTakeover } from './takeover-registry.js';
22
+
23
+
24
+                              
25
+
26
+            
27
+
28
+                     
29
+
30
+                      
31
+
32
+                 
33
+
34
+
35
+
36
+
37
+
38
+
39
+
40
+
41
+
42
+
43
+
44
+
45
+
46
+ export const name = 'stream-agent-control-bar';
47
+ export const inject = [];
48
+
49
+ export default function apply(ctx , config = {}) {
50
+ const version = config.version ?? VERSION;
51
+ const warn = (message , detail ) => {
52
+ const logger = (ctx.get?.('logger') ?? null) ;
53
+ const text = `[control-bar] ${message}${detail === undefined ? '' : ` :: ${String(detail)}`}`;
54
+ if (logger?.warn !== undefined) logger.warn(text);
55
+ else console.error(text);
56
+ };
57
+
58
+ const resolved = resolveControlState({ mode: config.mode, lang: config.lang }, config.stateDir, warn);
59
+ let state = createControlState({ mode: resolved.mode, lang: resolved.lang });
60
+ const file = resolved.file;
61
+
62
+ const persist = () => {
63
+ try {
64
+ writePersistedControl(state, config.stateDir);
65
+ } catch (error) {
66
+ warn(`控制栏状态写入失败(本次运行内仍然生效):${file}`, error);
67
+ }
68
+ };
69
+
70
+ const service = {
71
+ state: () => ({ ...state }),
72
+ mode: () => getMode(state.mode),
73
+ setMode: (mode, shouldPersist = true) => {
74
+ state = { ...state, mode: getMode(mode).id };
75
+ if (shouldPersist) persist();
76
+ return { ...state };
77
+ },
78
+ setLang: (lang, shouldPersist = true) => {
79
+ state = { ...state, lang: lang === 'en' ? 'en' : 'zh' };
80
+ if (shouldPersist) persist();
81
+ return { ...state };
82
+ },
83
+ statusLine: (active) => renderStatusBar(state, {
84
+ version,
85
+ ...(active === undefined ? { active: isTakeoverActive() } : { active }),
86
+ columns: process.stderr.columns,
87
+ }),
88
+ active: () => isTakeoverActive(),
89
+ file,
90
+ };
91
+
92
+ // 横幅时机(不靠定时器猜):控制栏排在 loop 之前挂载,因此先订阅"接管成立"事件;
93
+ // 若 loop 已经接管(控制栏后挂载的组合),onTakeover 会立即回调。
94
+ // 兜底:若 1.5s 内没有任何接管(bundle 只挂了一半),打印一次"未接管",便于定位。
95
+ let printed = false;
96
+ const printBanner = () => {
97
+ if (printed) return;
98
+ printed = true;
99
+ const active = isTakeoverActive();
100
+ for (const line of renderBanner(state, { version, active, columns: process.stderr.columns })) console.error(line);
101
+ };
102
+ const announce = config.announce !== false && process.env.STREAM_AGENT_NO_BANNER !== '1';
103
+ const offTakeover = announce ? onTakeover(printBanner) : () => {};
104
+ const fallbackTimer = announce
105
+ ? setTimeout(printBanner, 1500)
106
+ : undefined;
107
+ fallbackTimer?.unref?.();
108
+
109
+ // 服务提供是可选能力:宿主没有 provide(或已被占用)时只告警,不影响装载。
110
+ try {
111
+ if (typeof ctx.provide === 'function') ctx.provide('streamAgentControl', service);
112
+ } catch (error) {
113
+ warn('ctx.provide(streamAgentControl) 失败(其余功能不受影响)', error);
114
+ }
115
+
116
+ return asPluginEffect({
117
+ ...service,
118
+ dispose: () => {
119
+ offTakeover();
120
+ if (fallbackTimer !== undefined) clearTimeout(fallbackTimer);
121
+ },
122
+ });
123
+ }
@@ -0,0 +1,115 @@
1
+ // entry/control-session.ts —— 交互栏的会话状态机(v0.2.1)
2
+ //
3
+ // 把"按键 → 状态 → 画面"从终端 IO 里剥出来:runInteractive 只负责 raw mode 与写 stdout,
4
+ // 状态机本身可被 node --test 直接驱动(无需 pty),中英切换与落盘行为因此可被钉死。
5
+ //
6
+ // 一次 handle() 的返回值:
7
+ // { quit: true } 调用方收尾退出
8
+ // { changed: true } 画面需要重绘(状态变了)
9
+ // { changed: false } 按键无副作用(未知键)
10
+
11
+ import { DEFAULT_MODE, getMode } from '../kernel/modes.js';
12
+
13
+ import { createControlState, interpretKey, moveFocus, otherLang, renderHelp, renderPanel, t } from '../kernel/control-bar.js';
14
+
15
+ import { VERSION } from '../version.js';
16
+
17
+
18
+                              
19
+
20
+                  
21
+
22
+
23
+
24
+
25
+ export class ControlSession {
26
+ state ;
27
+ focus ;
28
+ helpOpen = false;
29
+ note = '';
30
+ #deps ;
31
+
32
+ constructor(initial , deps ) {
33
+ this.state = createControlState(initial);
34
+ this.focus = this.state.mode;
35
+ this.#deps = deps;
36
+ }
37
+
38
+ get version() {
39
+ return this.#deps.version ?? VERSION;
40
+ }
41
+
42
+ /** 整屏文本(含清屏序列),直接 write 即可。 */
43
+ frame() {
44
+ const columns = this.#deps.columns();
45
+ const body = this.helpOpen
46
+ ? renderHelp(this.state, { version: this.version, columns })
47
+ : renderPanel(this.state, { version: this.version, columns, focus: this.focus });
48
+ const footer = this.note === '' ? [] : ['', ` ${this.note}`];
49
+ return `\x1b[2J\x1b[H${[...body, ...footer].join('\n')}\n`;
50
+ }
51
+
52
+ /** 应用一个模式并落盘(digit / Enter / r 共用)。 */
53
+ applyMode(mode ) {
54
+ this.state = { ...this.state, mode: getMode(mode).id };
55
+ this.focus = this.state.mode;
56
+ const lang = this.state.lang;
57
+ try {
58
+ const file = this.#deps.save(this.state);
59
+ const spec = getMode(mode);
60
+ this.note = `${t('saved', lang)}: ${t('mode', lang)} ${spec.order} ${spec.label[lang]} | ${file}`;
61
+ } catch (error) {
62
+ this.note = `${t('writeFailed', lang)}: ${String(error)}`;
63
+ }
64
+ }
65
+
66
+ /** 切语言并落盘:中英两个方向都必须即时反映到画面与盘上。 */
67
+ toggleLang() {
68
+ this.state = { ...this.state, lang: otherLang(this.state.lang) };
69
+ try {
70
+ this.#deps.save(this.state);
71
+ this.note = t(this.state.lang === 'zh' ? 'noteLangZh' : 'noteLangEn', this.state.lang);
72
+ } catch (error) {
73
+ this.note = `${t('writeFailed', this.state.lang)}: ${String(error)}`;
74
+ }
75
+ }
76
+
77
+ /** 重置:模式回默认,语言保持不变(语言是阅读偏好,不该被"重置模式"带走)。 */
78
+ reset() {
79
+ this.applyMode(DEFAULT_MODE);
80
+ }
81
+
82
+ handle(key ) {
83
+ const action = interpretKey(key, { helpOpen: this.helpOpen });
84
+ switch (action.kind) {
85
+ case 'quit':
86
+ return { quit: true, changed: false };
87
+ case 'toggle-help':
88
+ this.helpOpen = !this.helpOpen;
89
+ this.note = '';
90
+ return { quit: false, changed: true };
91
+ case 'close-help':
92
+ this.helpOpen = false;
93
+ this.note = '';
94
+ return { quit: false, changed: true };
95
+ case 'toggle-lang':
96
+ this.toggleLang();
97
+ return { quit: false, changed: true };
98
+ case 'reset':
99
+ this.reset();
100
+ return { quit: false, changed: true };
101
+ case 'move':
102
+ this.focus = moveFocus(this.focus, action.delta);
103
+ this.note = '';
104
+ return { quit: false, changed: true };
105
+ case 'apply':
106
+ this.applyMode(this.focus);
107
+ return { quit: false, changed: true };
108
+ case 'select':
109
+ this.applyMode(action.mode);
110
+ return { quit: false, changed: true };
111
+ default:
112
+ return { quit: false, changed: false };
113
+ }
114
+ }
115
+ }
@@ -0,0 +1,125 @@
1
+ // entry/control-state.ts —— 控制栏状态的落盘与解析(v0.2.1)
2
+ //
3
+ // 状态只有一个文件:<stateDir>/control.json(默认 ~/.dsh-stream-agent/control.json,
4
+ // STREAM_AGENT_STATE_DIR 可改)。内容刻意极小,便于用户手改与排障:
5
+ // { "mode": "balanced", "lang": "zh", "updatedAt": "2026-11-16T13:00:00.000Z", "schema": 1 }
6
+ //
7
+ // 读写纪律:
8
+ // · 读:任何异常(不存在 / 坏 JSON / 未知模式)一律 fail-open 回默认值,并给出可选告警。
9
+ // 插件装载期不能因为一个"配置文件坏了"而失败——这是 v0.2.0 事故的直接教训。
10
+ // · 写:先写临时文件再 rename(原子替换),避免半截文件。
11
+ // · 优先级(高 → 低):装配显式 config > 环境变量 > control.json > 内置默认。
12
+ // 显式配置永远压过控制栏,模式只是"给没写配置的人一个好默认"。
13
+
14
+ import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
15
+ import { join } from 'node:path';
16
+ import { DEFAULT_LANG, isLang } from '../kernel/control-bar.js';
17
+
18
+ import { DEFAULT_MODE, isModeId } from '../kernel/modes.js';
19
+
20
+ import { resolveStateDir } from './json-persistence.js';
21
+
22
+ export const CONTROL_SCHEMA = 1;
23
+ export const CONTROL_FILE = 'control.json';
24
+
25
+
26
+
27
+
28
+
29
+
30
+
31
+
32
+
33
+                                     
34
+
35
+                            
36
+
37
+
38
+
39
+
40
+ export function controlFileOf(stateDir ) {
41
+ return join(resolveStateDir(stateDir), CONTROL_FILE);
42
+ }
43
+
44
+ /** 读取落盘状态;文件缺失/损坏/字段非法一律回默认(不抛错)。 */
45
+ export function readPersistedControl(
46
+ stateDir ,
47
+ onWarning ,
48
+ ) {
49
+ const file = controlFileOf(stateDir);
50
+ const fallback = { mode: DEFAULT_MODE, lang: DEFAULT_LANG };
51
+ if (!existsSync(file)) return { state: fallback, found: false, file };
52
+ try {
53
+ const raw = JSON.parse(readFileSync(file, 'utf8')) ;
54
+ const state = {
55
+ mode: isModeId(raw.mode) ? raw.mode : fallback.mode,
56
+ lang: isLang(raw.lang) ? raw.lang : fallback.lang,
57
+ };
58
+ return {
59
+ state,
60
+ found: true,
61
+ file,
62
+ updatedAt: typeof raw.updatedAt === 'string' ? raw.updatedAt : undefined,
63
+ };
64
+ } catch (error) {
65
+ // 坏文件不阻断装载,也不静默:告警后回默认值(下次写入会修复它)
66
+ onWarning?.(`控制栏状态文件不可解析,已回默认模式/语言:${file}`, error);
67
+ return { state: fallback, found: false, file };
68
+ }
69
+ }
70
+
71
+ /** 原子写入(tmp + rename);返回落盘路径。失败抛错由 CLI 呈现给用户。 */
72
+ export function writePersistedControl(state , stateDir ) {
73
+ const file = controlFileOf(stateDir);
74
+ mkdirSync(resolveStateDir(stateDir), { recursive: true });
75
+ const payload = {
76
+ schema: CONTROL_SCHEMA,
77
+ mode: state.mode,
78
+ lang: state.lang,
79
+ updatedAt: new Date().toISOString(),
80
+ };
81
+ const tmp = `${file}.${process.pid}.tmp`;
82
+ writeFileSync(tmp, `${JSON.stringify(payload, null, 2)}\n`, 'utf8');
83
+ renameSync(tmp, file);
84
+ return file;
85
+ }
86
+
87
+ /**
88
+ * 解析生效状态:显式 config → 环境变量 → 落盘 → 默认。
89
+ *
90
+ * @param explicit 装配里写死的值(LoopEntryConfig.mode / .lang;undefined 表示没写)
91
+ * @param stateDir 状态根目录(与 loop 的 stateDir 配置保持一致)
92
+ */
93
+ export function resolveControlState(
94
+ explicit = {},
95
+ stateDir ,
96
+ onWarning ,
97
+ ) {
98
+ const persisted = readPersistedControl(stateDir, onWarning);
99
+ const envMode = process.env.STREAM_AGENT_MODE;
100
+ const envLang = process.env.STREAM_AGENT_LANG;
101
+
102
+ let mode = persisted.state.mode;
103
+ let modeSource = persisted.found ? 'file' : 'default';
104
+ if (isModeId(envMode)) {
105
+ mode = envMode;
106
+ modeSource = 'env';
107
+ }
108
+ if (isModeId(explicit.mode)) {
109
+ mode = explicit.mode;
110
+ modeSource = 'config';
111
+ }
112
+
113
+ let lang = persisted.state.lang;
114
+ let langSource = persisted.found ? 'file' : 'default';
115
+ if (isLang(envLang)) {
116
+ lang = envLang;
117
+ langSource = 'env';
118
+ }
119
+ if (isLang(explicit.lang)) {
120
+ lang = explicit.lang;
121
+ langSource = 'config';
122
+ }
123
+
124
+ return { mode, lang, modeSource, langSource, file: persisted.file };
125
+ }
@@ -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
+
41
+
42
+
43
+
44
+ /**
45
+ * 读取一个可选服务;不存在、不可用或触发 inject 守卫时一律返回 undefined。
46
+ *
47
+ * @param ctx 宿主 context(Cordis Proxy 或测试桩)
48
+ * @param name 服务名(如 'ptcRuntime' / 'sessionProjections' / 'loader')
49
+ */
50
+ export function getService (ctx , name ) {
51
+ const probe = ctx ;
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 ;
57
+ } catch {
58
+ // ctx.get 在极端桩上也可能抛:按缺失处理,继续 ②
59
+ }
60
+ // ② 兼容路:测试桩把服务挂在 ctx 上;Cordis 下这一步会被 inject 守卫拦下 →
61
+ // catch 掉,语义仍是"服务不存在"(绝不让它冒泡毁掉 entry)
62
+ try {
63
+ const value = (ctx )[name];
64
+ if (value !== undefined && value !== null) return value ;
65
+ } catch {
66
+ return undefined;
67
+ }
68
+ return undefined;
69
+ }
70
+
71
+ /** 服务存在且具备指定方法(鸭子类型校验,避免"服务在但形状不对"炸在半路)。 */
72
+ export function hasMethod(service , method ) {
73
+ return service !== null && typeof service === 'object'
74
+ && typeof (service )[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 (handle ) {
90
+ const disposer = () => {
91
+ const dispose = (handle ).dispose;
92
+ if (typeof dispose === 'function') (dispose )();
93
+ };
94
+ return Object.assign(disposer, handle) ;
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.js';
16
+
17
+
18
+ /** 镜像 dsh-llm/lib/types/index.d.ts:45 llm/stream waterfall 监听器面(duck-type) */
19
+
20
+
21
+
22
+                              
23
+
24
+                            
25
+
26
+            
27
+
28
+
29
+
30
+ /** 循环安全的 JSON 序列化(messages 可能含宿主对象;失败降级为标记位 + 占位文本) */
31
+ function safeJson(value ) {
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 = [];
41
+
42
+
43
+
44
+
45
+
46
+
47
+
48
+ export default function apply(ctx , config = {}) {
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 ), { 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 ) => {
66
+ appendFileSync(file , line + '\n', 'utf8');
67
+ };
68
+
69
+ const onStream = (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 );
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
+ }