@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,192 @@
|
|
|
1
|
+
// entry/adapter-kit.ts —�?四个 07 �?entry 共用的适配胶水(分�?07�?//
|
|
2
|
+
// 不是业务逻辑,只有四类翻译助手:告警出口、entry 私有台账、文本提取�?// BlobSink �?DSH storage 桥。纪律与 loop.ts 一致:�?@deepseek-ai 静�?import�?// 宿主依赖全部 duck-type;内核只 import 公开接口(state.ts �?BlobSink/StateStore)�?
|
|
3
|
+
import { StateStore } from '../kernel/state.js';
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
/** 告警出口签名(红�?5:不许静默)�?*/
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
/** 宿主 logger �?duck-type 面(dsh-cordis-host-runner 装配;缺省落 stderr)�?*/
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
/** 可序列化的单条事实(Error �?message;对�?�?JSON)�?*/
|
|
23
|
+
export function detailString(detail ) {
|
|
24
|
+
if (detail instanceof Error) return detail.message;
|
|
25
|
+
if (typeof detail === 'string') return detail;
|
|
26
|
+
try {
|
|
27
|
+
return JSON.stringify(detail);
|
|
28
|
+
} catch {
|
|
29
|
+
return String(detail);
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/** 告警出口:优先宿�?logger,否�?stderr(与 loop.ts �?apply 同款,绝不静默)�?*/
|
|
34
|
+
export function makeWarn(ctx , tag ) {
|
|
35
|
+
return (message, detail) => {
|
|
36
|
+
const logger = (ctx.get?.('logger') ?? null) ;
|
|
37
|
+
const text = `[${tag}] ${message}${detail === undefined ? '' : ` :: ${detailString(detail)}`}`;
|
|
38
|
+
if (logger?.warn !== undefined) logger.warn(text);
|
|
39
|
+
else console.error(text);
|
|
40
|
+
};
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/** entry 私有台账:内�?append-only 事实流(红线 5 �?不许静默"载体)�?*/
|
|
44
|
+
export class EntryLedger {
|
|
45
|
+
records = [];
|
|
46
|
+
#seq = 0;
|
|
47
|
+
|
|
48
|
+
push(kind , data = {}) {
|
|
49
|
+
this.records.push({ seq: ++this.#seq, at: Date.now(), kind, data });
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
count(kind ) {
|
|
53
|
+
return this.records.filter((r) => r.kind === kind).length;
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/** ContentBlock[](dsh-llm/lib/types/types.d.ts �?text 块族)→ 纯文本�?*/
|
|
58
|
+
export function contentTextOf(content ) {
|
|
59
|
+
if (content === undefined || content === null) return '';
|
|
60
|
+
if (typeof content === 'string') return content;
|
|
61
|
+
if (Array.isArray(content)) {
|
|
62
|
+
return content
|
|
63
|
+
.map((block) => {
|
|
64
|
+
if (typeof block === 'string') return block;
|
|
65
|
+
if (block !== null && typeof block === 'object' && 'text' in block && typeof (block ).text === 'string') {
|
|
66
|
+
return (block ).text;
|
|
67
|
+
}
|
|
68
|
+
return '';
|
|
69
|
+
})
|
|
70
|
+
.filter((t) => t !== '')
|
|
71
|
+
.join('\n');
|
|
72
|
+
}
|
|
73
|
+
return String(content);
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/** 线格式消息(GenerateOptions.messages)→ 拼接文本(content �?text 块数组)�?*/
|
|
77
|
+
export function wireMessageText(m ) {
|
|
78
|
+
return m.content.map((b) => (typeof b?.text === 'string' ? b.text : '')).join('\n');
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
// ---------------------------------------------------------------------------
|
|
82
|
+
// BlobSink �?DSH storage 桥(state-handle / obs-broker 共用�?IO 胶水,非业务逻辑�?// ---------------------------------------------------------------------------
|
|
83
|
+
|
|
84
|
+
/** 镜像 dsh-storage/lib/types/backend.d.ts KvUnit(rc.1 :82-159;duck-type�?*/
|
|
85
|
+
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
|
|
89
|
+
|
|
90
|
+
/** 镜像 dsh-storage/lib/types/index.d.ts Storage + registry.d.ts BackendRegistry(duck-type�?*/
|
|
91
|
+
|
|
92
|
+
|
|
93
|
+
|
|
94
|
+
|
|
95
|
+
/**
|
|
96
|
+
* per-record 布局的表键须匹配 [a-zA-Z0-9_-]+(backend.d.ts:96-98),而键族含
|
|
97
|
+
* sha256 hex(天然安全)与句柄串(含 ':' '@' '/')——统一确定性净化;
|
|
98
|
+
* read 走同一映射。理论碰撞('a:b' vs 'a_b')对内容寻址键族不构成实际问题,如实记录�? */
|
|
99
|
+
export function safeKvKey(key ) {
|
|
100
|
+
return key.replace(/[^a-zA-Z0-9_-]/g, '_') || 'root';
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
export function bytesToB64(data ) {
|
|
104
|
+
return Buffer.from(data.buffer, data.byteOffset, data.byteLength).toString('base64');
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
export function b64ToBytes(b64 ) {
|
|
108
|
+
const buf = Buffer.from(b64, 'base64');
|
|
109
|
+
return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
/**
|
|
113
|
+
* 内核 BlobSink 适配:内存覆盖读 + 写回后异�?putRecord 持久�? * 内核 write 是同�?void——异步层不回压,持久化失败告警留痕不毁任务(红线 5)�? * attach() 前写入只进内存(fail-open 降级窗口);attach 时用持久层水合内存�? */
|
|
114
|
+
export class DurableBlobSink {
|
|
115
|
+
#mem = new Map ();
|
|
116
|
+
#warn ;
|
|
117
|
+
#onFault ;
|
|
118
|
+
#unit ;
|
|
119
|
+
#pending = [];
|
|
120
|
+
|
|
121
|
+
constructor(warn , onFault ) {
|
|
122
|
+
this.#warn = warn;
|
|
123
|
+
this.#onFault = onFault;
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
get attached() {
|
|
127
|
+
return this.#unit !== undefined;
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
attach(unit , hydrate ) {
|
|
131
|
+
this.#unit = unit;
|
|
132
|
+
for (const [key, data] of hydrate) this.#mem.set(key, data);
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
write(key , data ) {
|
|
136
|
+
this.#mem.set(key, data);
|
|
137
|
+
const unit = this.#unit;
|
|
138
|
+
if (unit === undefined) return;
|
|
139
|
+
const put = unit
|
|
140
|
+
.putRecord('blobs', safeKvKey(key), { b64: bytesToB64(data) })
|
|
141
|
+
.catch((error) => {
|
|
142
|
+
this.#onFault('persist-error', { key, error: String(error) });
|
|
143
|
+
this.#warn(`blob ${key.slice(0, 12)}�?持久化失败(内存继续服务)`, error);
|
|
144
|
+
});
|
|
145
|
+
this.#pending.push(put);
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
read(key ) {
|
|
149
|
+
return this.#mem.get(key);
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
/** 内核 obs �?BlobSink 面(put(ref, string))桥接�?*/
|
|
153
|
+
asTextSink() {
|
|
154
|
+
const encoder = new TextEncoder();
|
|
155
|
+
const decoder = new TextDecoder();
|
|
156
|
+
return {
|
|
157
|
+
put: (ref, content) => this.write(ref, encoder.encode(content)),
|
|
158
|
+
readRaw: (ref) => {
|
|
159
|
+
const data = this.read(ref);
|
|
160
|
+
return data === undefined ? undefined : decoder.decode(data);
|
|
161
|
+
},
|
|
162
|
+
};
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
async flush() {
|
|
166
|
+
await Promise.allSettled([...this.#pending]);
|
|
167
|
+
this.#pending = [];
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
/** 从持久层水合 blobs �?�?attach 用的键值对(state-handle 启动路径)�?*/
|
|
172
|
+
export function hydrateFromUnit(unit ) {
|
|
173
|
+
return unit.loadAll().then((all) => {
|
|
174
|
+
const out = [];
|
|
175
|
+
for (const [key, value] of Object.entries(all.tables['blobs'] ?? {})) {
|
|
176
|
+
const b64 = (value )?.b64;
|
|
177
|
+
if (typeof b64 === 'string') out.push([key, b64ToBytes(b64)]);
|
|
178
|
+
}
|
|
179
|
+
return out;
|
|
180
|
+
});
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
/** 打开 staging/state 共用�?KvUnit(后端固�?'json';失败返�?undefined 由调用方降级)�?*/
|
|
184
|
+
export async function openKvUnit(storage , unit , tables ) {
|
|
185
|
+
return (await storage?.backend?.get('json')?.kv?.open({ name: unit, version: 1, tables: [...tables], hasGlobal: false, layout: 'per-record' })) ?? undefined;
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
/** 复用内核逐行 diff 的临时载体(action-gate diffStaged 用;零业务逻辑重写)�?*/
|
|
189
|
+
export function kernelDiffer() {
|
|
190
|
+
return new StateStore();
|
|
191
|
+
}
|
|
192
|
+
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
// entry/context-render.ts —— 装配器接入(M5 适配,分派 07)
|
|
2
|
+
//
|
|
3
|
+
// 形态判定(任务书:"若 06 号 loop 完整接管装配,本 entry 退化为 pre-request 断言器
|
|
4
|
+
// (只跑 O6 preflight)——以 06 的实际形态为准"):06 驱动器经内核 ContextRenderer
|
|
5
|
+
// 全权装配(稳定前缀/追加区/易变尾、O3 差分、O5 阶梯、O6 内置断言),本插件请求路径上
|
|
6
|
+
// 不存在 SystemPromptProjection 注入(dsh-agent-loop/lib/types/runtime-context.d.ts 的
|
|
7
|
+
// 前缀稳定设计目标与本 entry 方向一致,但不适用于 loop-built 请求)。因此本 entry 是:
|
|
8
|
+
// 1. llm/stream waterfall 上的 O6 pre-request 断言器(宿主边界的第二道独立见证):
|
|
9
|
+
// 逐会话断言首条消息(稳定前缀 system)逐字节不变——凡有逐请求动态字段漏进稳定前缀
|
|
10
|
+
// (O4 破坏),第二次请求必在此被拒;违反 → 内核 PrefixBrokenError 原样上抛(fail-closed,
|
|
11
|
+
// 拒绝发送,宁可任务失败不烧缓存);逐请求落 prefix 台账(08 号 prefix_hash 序列数据源)。
|
|
12
|
+
// 2. freezeDynamics(O4)出口:内核 ContextRenderer 的动态冻结语义对非 loop 装配路径
|
|
13
|
+
// 开放(volatile-tail / turn-freeze;稳定前缀结构性禁入)。
|
|
14
|
+
// fail-open(红线 5):断言器自身异常 → 放行 + ledger 记 preflight_error;
|
|
15
|
+
// 前缀破坏是策略违规不是自身异常——fail-closed 上抛,两者严格区分。
|
|
16
|
+
|
|
17
|
+
import { assertPrefixStable, PrefixBrokenError, renderHash, ContextRenderer } from '../kernel/render.js';
|
|
18
|
+
|
|
19
|
+
import { makeWarn, EntryLedger, wireMessageText } from './adapter-kit.js';
|
|
20
|
+
|
|
21
|
+
import { asPluginEffect } from './cordis-compat.js';
|
|
22
|
+
|
|
23
|
+
/** 镜像 dsh-llm GenerateOptions(读子集;types.d.ts:538-580) */
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
/** 线格式消息 → 内核 RenderMessage(content text 块拼接)。 */
|
|
31
|
+
function toRenderMessage(m ) {
|
|
32
|
+
const text = wireMessageText(m );
|
|
33
|
+
return { role: (m.role ?? 'user') , content: text };
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
export const name = 'stream-agent-context-render';
|
|
55
|
+
export const inject = [];
|
|
56
|
+
|
|
57
|
+
export default function apply(ctx , config = {}) {
|
|
58
|
+
const warn = makeWarn(ctx, 'context-render');
|
|
59
|
+
const faults = new EntryLedger();
|
|
60
|
+
/** 会话 → 首请求快照(首条消息 = 稳定前缀 system;逐字节冻结)。 */
|
|
61
|
+
const sessions = new Map ();
|
|
62
|
+
const freezeRenderer = new ContextRenderer({
|
|
63
|
+
system: config.system ?? '(stream-agent context-render:动态冻结载体,稳定前缀无业务内容)',
|
|
64
|
+
protocol: '', toolSchemas: '', invariants: '',
|
|
65
|
+
});
|
|
66
|
+
|
|
67
|
+
const preflight = (messages , sessionId ) => {
|
|
68
|
+
if (messages.length === 0) throw new PrefixBrokenError(0, '非空消息序列', '空序列', ':preflight 拒绝空请求');
|
|
69
|
+
const first = messages[0];
|
|
70
|
+
const state = sessions.get(sessionId);
|
|
71
|
+
if (state === undefined) {
|
|
72
|
+
sessions.set(sessionId, { first, requests: 1 });
|
|
73
|
+
} else {
|
|
74
|
+
// O6 fail-closed:稳定前缀逐字节断言(内核校验器原样使用,不静默修复)
|
|
75
|
+
assertPrefixStable([state.first], [first]);
|
|
76
|
+
state.requests += 1;
|
|
77
|
+
}
|
|
78
|
+
const stableHash = renderHash([first]);
|
|
79
|
+
const fullHash = renderHash(messages);
|
|
80
|
+
faults.push('prefix', {
|
|
81
|
+
session: sessionId,
|
|
82
|
+
request: state?.requests ?? 1,
|
|
83
|
+
stableHash,
|
|
84
|
+
fullHash,
|
|
85
|
+
messages: messages.length,
|
|
86
|
+
});
|
|
87
|
+
return { request: state?.requests ?? 1, stableHash, fullHash };
|
|
88
|
+
};
|
|
89
|
+
|
|
90
|
+
const onStream = (options, next) => {
|
|
91
|
+
try {
|
|
92
|
+
if (config.faultInjection === true) throw new Error('injected preflight fault');
|
|
93
|
+
if (options.messages !== undefined && options.messages.length > 0) {
|
|
94
|
+
preflight(options.messages.map(toRenderMessage), options.sessionId ?? '');
|
|
95
|
+
}
|
|
96
|
+
} catch (error) {
|
|
97
|
+
if (error instanceof PrefixBrokenError) {
|
|
98
|
+
// 策略违规:fail-closed,拒绝发送(宁可任务失败不烧缓存——README O6 原文语义)
|
|
99
|
+
faults.push('prefix-broken', { session: options.sessionId ?? '', error: error.message });
|
|
100
|
+
throw error;
|
|
101
|
+
}
|
|
102
|
+
// 断言器自身异常:fail-open,放行不静默(红线 5)
|
|
103
|
+
faults.push('preflight_error', { error: error instanceof Error ? error.message : String(error) });
|
|
104
|
+
warn('preflight 异常:请求放行(fail-open)', error);
|
|
105
|
+
}
|
|
106
|
+
return next();
|
|
107
|
+
};
|
|
108
|
+
|
|
109
|
+
if (typeof ctx.on !== 'function') throw new Error('[context-render] ctx.on 不可用:无法挂载 llm/stream 断言器');
|
|
110
|
+
ctx.on('llm/stream', onStream );
|
|
111
|
+
if (config.announce === true) console.error('[context-render] mounted: llm/stream O6 preflight asserter');
|
|
112
|
+
|
|
113
|
+
return asPluginEffect({
|
|
114
|
+
preflight,
|
|
115
|
+
freezeDynamics: (dynamics, placement) => freezeRenderer.freezeDynamics(dynamics, placement),
|
|
116
|
+
faults,
|
|
117
|
+
dispose: () => {},
|
|
118
|
+
});
|
|
119
|
+
}
|
|
@@ -0,0 +1,289 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// entry/control-bar-cli.ts —— 控制栏命令行(v0.2.1)
|
|
3
|
+
//
|
|
4
|
+
// dsh-stream-agent 进入交互控制栏(TTY)
|
|
5
|
+
// dsh-stream-agent bar 同上(显式)
|
|
6
|
+
// dsh-stream-agent bar --once 打印一次面板就退出(非 TTY 自动如此)
|
|
7
|
+
// dsh-stream-agent status 一行状态(--json 输出机器可读)
|
|
8
|
+
// dsh-stream-agent mode lean 直接切模式(balanced / lean / compat / power)
|
|
9
|
+
// dsh-stream-agent lang en 直接切语言(zh / en)
|
|
10
|
+
// dsh-stream-agent help 全模式指南
|
|
11
|
+
//
|
|
12
|
+
// 交互键位:1-4 选模式 · ↑↓/jk 移动 · Enter 应用 · l 中/英 · ? 帮助 · r 重置 · q 退出
|
|
13
|
+
//
|
|
14
|
+
// 零依赖:只用 node:process 与内核渲染(kernel/control-bar.ts 是唯一输出源,
|
|
15
|
+
// 保证 CLI 与插件装载横幅的中英文案、宽度、语义完全一致)。
|
|
16
|
+
|
|
17
|
+
import { readdirSync } from 'node:fs';
|
|
18
|
+
import { MODES, getMode, isModeId } from '../kernel/modes.js';
|
|
19
|
+
import {
|
|
20
|
+
createControlState,
|
|
21
|
+
isLang,
|
|
22
|
+
renderBanner,
|
|
23
|
+
renderHelp,
|
|
24
|
+
renderJson,
|
|
25
|
+
renderPanel,
|
|
26
|
+
renderStatusBar,
|
|
27
|
+
t,
|
|
28
|
+
} from '../kernel/control-bar.js';
|
|
29
|
+
|
|
30
|
+
import { VERSION } from '../version.js';
|
|
31
|
+
import { controlFileOf, readPersistedControl, writePersistedControl } from './control-state.js';
|
|
32
|
+
import { ControlSession } from './control-session.js';
|
|
33
|
+
import { resolveStateDir } from './json-persistence.js';
|
|
34
|
+
import { appendIntentRecord, intentFileOf, loadIntentRecords, pendingIntents } from './intent-log.js';
|
|
35
|
+
|
|
36
|
+
const CLEAR = '\x1b[2J\x1b[H';
|
|
37
|
+
|
|
38
|
+
function columns() {
|
|
39
|
+
return process.stdout.columns ?? 80;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
function loadState() {
|
|
43
|
+
const { state } = readPersistedControl();
|
|
44
|
+
return createControlState(state);
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
function save(state ) {
|
|
48
|
+
return writePersistedControl(state);
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
function print(lines ) {
|
|
52
|
+
process.stdout.write(`${lines.join('\n')}\n`);
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
function usage(lang ) {
|
|
56
|
+
const zh = lang === 'zh';
|
|
57
|
+
return [
|
|
58
|
+
zh ? '用法' : 'Usage',
|
|
59
|
+
' dsh-stream-agent [bar] [--once] [--json] ' + (zh ? '控制栏(交互 / 一次性)' : 'control bar (interactive / once)'),
|
|
60
|
+
' dsh-stream-agent status [--json] ' + (zh ? '当前模式与语言' : 'current mode and language'),
|
|
61
|
+
' dsh-stream-agent mode <balanced|lean|compat|power>',
|
|
62
|
+
' dsh-stream-agent lang <zh|en>',
|
|
63
|
+
' dsh-stream-agent intents [--ack <sessionId>] ' + (zh ? 'F6 意图核对:列出"有意图无回执"(--ack 人工确认后闭合)' : 'F6 intent triage: list intents without receipts (--ack to close)'),
|
|
64
|
+
' dsh-stream-agent help ' + (zh ? '全模式指南' : 'full mode guide'),
|
|
65
|
+
'',
|
|
66
|
+
zh ? '状态文件' : 'State file',
|
|
67
|
+
` ${controlFileOf()}`,
|
|
68
|
+
'',
|
|
69
|
+
zh
|
|
70
|
+
? '发布提示:v0.2.1 的 npm 源最多 3 天内可用;在此之前请用仓库路径安装'
|
|
71
|
+
: 'Release note: the v0.2.1 npm source lands within 3 days; install from the repo path until then',
|
|
72
|
+
];
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
// ---------------------------------------------------------------------------
|
|
76
|
+
// 交互模式
|
|
77
|
+
// ---------------------------------------------------------------------------
|
|
78
|
+
|
|
79
|
+
function runInteractive(initial ) {
|
|
80
|
+
const session = new ControlSession(initial, {
|
|
81
|
+
save: (next) => save(next),
|
|
82
|
+
columns: () => process.stdout.columns,
|
|
83
|
+
});
|
|
84
|
+
|
|
85
|
+
const draw = () => {
|
|
86
|
+
process.stdout.write(session.frame());
|
|
87
|
+
};
|
|
88
|
+
|
|
89
|
+
const stdin = process.stdin;
|
|
90
|
+
stdin.setRawMode?.(true);
|
|
91
|
+
stdin.resume();
|
|
92
|
+
stdin.setEncoding('utf8');
|
|
93
|
+
|
|
94
|
+
draw();
|
|
95
|
+
|
|
96
|
+
let finished = false;
|
|
97
|
+
const cleanup = () => {
|
|
98
|
+
if (finished) return;
|
|
99
|
+
finished = true;
|
|
100
|
+
stdin.off('data', onData);
|
|
101
|
+
stdin.setRawMode?.(false);
|
|
102
|
+
stdin.pause();
|
|
103
|
+
process.stdout.write(`${CLEAR}${renderStatusBar(session.state, { version: VERSION })}\n`);
|
|
104
|
+
process.exit(0);
|
|
105
|
+
};
|
|
106
|
+
|
|
107
|
+
function onData(chunk ) {
|
|
108
|
+
for (const key of splitKeys(chunk)) {
|
|
109
|
+
const result = session.handle(key);
|
|
110
|
+
if (result.quit) {
|
|
111
|
+
cleanup();
|
|
112
|
+
return;
|
|
113
|
+
}
|
|
114
|
+
if (result.changed) draw();
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
process.on('SIGINT', cleanup);
|
|
119
|
+
stdin.on('data', onData);
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
/** 把一次 data chunk 拆成按键序列(方向键是 \x1b[A / \x1b[B 三字节)。 */
|
|
123
|
+
export function splitKeys(chunk ) {
|
|
124
|
+
const keys = [];
|
|
125
|
+
let i = 0;
|
|
126
|
+
while (i < chunk.length) {
|
|
127
|
+
if (chunk[i] === '\x1b' && chunk[i + 1] === '[' && i + 2 < chunk.length) {
|
|
128
|
+
keys.push(chunk.slice(i, i + 3));
|
|
129
|
+
i += 3;
|
|
130
|
+
continue;
|
|
131
|
+
}
|
|
132
|
+
keys.push(chunk[i]);
|
|
133
|
+
i += 1;
|
|
134
|
+
}
|
|
135
|
+
return keys;
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
// ---------------------------------------------------------------------------
|
|
139
|
+
// 命令分发
|
|
140
|
+
// ---------------------------------------------------------------------------
|
|
141
|
+
|
|
142
|
+
function main(argv ) {
|
|
143
|
+
const args = [...argv];
|
|
144
|
+
const json = args.includes('--json');
|
|
145
|
+
const once = args.includes('--once');
|
|
146
|
+
const rest = args.filter((a) => a !== '--json' && a !== '--once');
|
|
147
|
+
const command = rest[0] ?? 'bar';
|
|
148
|
+
const state = loadState();
|
|
149
|
+
|
|
150
|
+
switch (command) {
|
|
151
|
+
case '--version':
|
|
152
|
+
case '-v':
|
|
153
|
+
case 'version':
|
|
154
|
+
process.stdout.write(`${VERSION}\n`);
|
|
155
|
+
return 0;
|
|
156
|
+
|
|
157
|
+
case '--help':
|
|
158
|
+
case '-h':
|
|
159
|
+
case 'help': {
|
|
160
|
+
// 帮助 = 全模式指南(新人真正要看的)+ 用法;不再重复引导横幅
|
|
161
|
+
print(renderHelp(state, { version: VERSION, columns: columns() }));
|
|
162
|
+
print(['', ...usage(state.lang)]);
|
|
163
|
+
return 0;
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
case 'status': {
|
|
167
|
+
if (json) {
|
|
168
|
+
process.stdout.write(`${renderJson(state, { version: VERSION })}\n`);
|
|
169
|
+
} else {
|
|
170
|
+
print([
|
|
171
|
+
renderStatusBar(state, { version: VERSION }),
|
|
172
|
+
`${t('docs', state.lang)}: README.md#control-bar`,
|
|
173
|
+
]);
|
|
174
|
+
}
|
|
175
|
+
return 0;
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
case 'mode': {
|
|
179
|
+
const target = rest[1];
|
|
180
|
+
if (target === undefined) {
|
|
181
|
+
print([`${t('mode', state.lang)}: ${MODES.map((m) => `${m.order}=${m.id}`).join(' ')}`]);
|
|
182
|
+
return 1;
|
|
183
|
+
}
|
|
184
|
+
if (!isModeId(target)) {
|
|
185
|
+
print([t('unknownMode', state.lang)]);
|
|
186
|
+
return 2;
|
|
187
|
+
}
|
|
188
|
+
const next = { ...state, mode: target };
|
|
189
|
+
const file = save(next);
|
|
190
|
+
if (json) {
|
|
191
|
+
process.stdout.write(`${renderJson(next, { version: VERSION })}\n`);
|
|
192
|
+
} else {
|
|
193
|
+
print([`${t('mode', state.lang)} → ${getMode(target).order} ${getMode(target).label[state.lang]}(${target})`,
|
|
194
|
+
`${t('saved', state.lang)}: ${file}`]);
|
|
195
|
+
}
|
|
196
|
+
return 0;
|
|
197
|
+
}
|
|
198
|
+
|
|
199
|
+
case 'lang': {
|
|
200
|
+
const target = rest[1];
|
|
201
|
+
if (!isLang(target)) {
|
|
202
|
+
print([t('unknownLang', state.lang)]);
|
|
203
|
+
return 2;
|
|
204
|
+
}
|
|
205
|
+
const next = { ...state, lang: target };
|
|
206
|
+
save(next);
|
|
207
|
+
print([renderStatusBar(next, { version: VERSION, columns: columns() })]);
|
|
208
|
+
return 0;
|
|
209
|
+
}
|
|
210
|
+
|
|
211
|
+
case 'intents': {
|
|
212
|
+
// F6 停机核对出口:列出各会话"有意图无回执"(pending)与失败意图(failed);
|
|
213
|
+
// --ack <sessionId> 追加 ack 记录闭合全部 pending(人工确认"未发生/放弃"后执行)。
|
|
214
|
+
const stateRoot = resolveStateDir();
|
|
215
|
+
const intentsDir = `${stateRoot}/intents`;
|
|
216
|
+
const ackTarget = rest[1] === '--ack' ? rest[2] : undefined;
|
|
217
|
+
const zh = state.lang === 'zh';
|
|
218
|
+
let sessions = [];
|
|
219
|
+
try {
|
|
220
|
+
sessions = readdirSync(intentsDir).filter((f) => f.endsWith('.jsonl')).map((f) => f.replace(/\.jsonl$/, ''));
|
|
221
|
+
} catch {
|
|
222
|
+
sessions = [];
|
|
223
|
+
}
|
|
224
|
+
if (sessions.length === 0) {
|
|
225
|
+
print([zh ? '没有意图日志(无写入或 F6 未启用)。' : 'No intent logs (no writes, or F6 disabled).']);
|
|
226
|
+
return 0;
|
|
227
|
+
}
|
|
228
|
+
if (ackTarget !== undefined) {
|
|
229
|
+
const file = intentFileOf(stateRoot, ackTarget);
|
|
230
|
+
if (!sessions.includes(ackTarget)) {
|
|
231
|
+
print([zh ? `未知会话:${ackTarget}` : `Unknown session: ${ackTarget}`]);
|
|
232
|
+
return 2;
|
|
233
|
+
}
|
|
234
|
+
const { records } = loadIntentRecords(file);
|
|
235
|
+
const open = pendingIntents(records).filter((p) => p.state === 'pending');
|
|
236
|
+
if (open.length === 0) {
|
|
237
|
+
print([zh ? `会话 ${ackTarget} 没有待核对的意图。` : `Session ${ackTarget} has no pending intents.`]);
|
|
238
|
+
return 0;
|
|
239
|
+
}
|
|
240
|
+
appendIntentRecord(file, { type: 'ack', seq: records.length + 1, at: new Date().toISOString(), intentSeqs: open.map((p) => p.intent.seq), note: 'cli --ack' });
|
|
241
|
+
print([zh
|
|
242
|
+
? `已确认 ${open.length} 条意图(会话 ${ackTarget}):下一次 resume 不再停机核对。`
|
|
243
|
+
: `Acked ${open.length} intent(s) for session ${ackTarget}: next resume will not halt.`]);
|
|
244
|
+
return 0;
|
|
245
|
+
}
|
|
246
|
+
const lines = [zh ? '写前意图核对(F6):' : 'Intent triage (F6):'];
|
|
247
|
+
for (const session of sessions) {
|
|
248
|
+
const { records, badLines } = loadIntentRecords(intentFileOf(stateRoot, session));
|
|
249
|
+
const pending = pendingIntents(records).filter((p) => p.state === 'pending');
|
|
250
|
+
const failed = pendingIntents(records).filter((p) => p.state === 'failed');
|
|
251
|
+
lines.push(` ${session}: ${zh ? '待核对' : 'pending'} ${pending.length} · ${zh ? '失败已闭合' : 'failed(closed)'} ${failed.length}${badLines > 0 ? ` · ${zh ? '坏行' : 'bad lines'} ${badLines}` : ''}`);
|
|
252
|
+
for (const p of pending) {
|
|
253
|
+
lines.push(` - [seq ${p.intent.seq}] ${p.intent.op} ${p.intent.path} (cmd=${p.intent.cmdId} fp=${p.intent.fingerprint} at=${p.intent.at})`);
|
|
254
|
+
}
|
|
255
|
+
}
|
|
256
|
+
lines.push('', zh
|
|
257
|
+
? '待核对 = 写入可能已发生(进程在写入中被杀)。人工核对文件后:dsh-stream-agent intents --ack <sessionId> 闭合;'
|
|
258
|
+
: 'Pending = the write MAY have happened (process killed mid-write). Verify files, then run: dsh-stream-agent intents --ack <sessionId>');
|
|
259
|
+
print(lines);
|
|
260
|
+
return 0;
|
|
261
|
+
}
|
|
262
|
+
|
|
263
|
+
case 'bar': {
|
|
264
|
+
const interactive = process.stdin.isTTY === true && process.stdout.isTTY === true && !once;
|
|
265
|
+
if (!interactive) {
|
|
266
|
+
print(renderPanel(state, { version: VERSION, columns: columns() }));
|
|
267
|
+
if (process.stdin.isTTY !== true) print(['', ` ${t('notTty', state.lang)}`]);
|
|
268
|
+
return 0;
|
|
269
|
+
}
|
|
270
|
+
runInteractive(state);
|
|
271
|
+
return 0;
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
default:
|
|
275
|
+
print([`${t('usage', state.lang)}: dsh-stream-agent [bar|status|mode|lang|help]`, t('unknownMode', state.lang)]);
|
|
276
|
+
return 2;
|
|
277
|
+
}
|
|
278
|
+
}
|
|
279
|
+
|
|
280
|
+
const invokedDirectly = (process.argv[1] ?? '').endsWith('control-bar-cli.js')
|
|
281
|
+
|| (process.argv[1] ?? '').endsWith('control-bar-cli.ts');
|
|
282
|
+
|
|
283
|
+
if (invokedDirectly) {
|
|
284
|
+
// 管道下游提前关闭(`| head`)不是错误:安静退出,别把 EPIPE 栈打到用户脸上
|
|
285
|
+
process.stdout.on('error', (error ) => {
|
|
286
|
+
if (error?.code === 'EPIPE') process.exit(0);
|
|
287
|
+
});
|
|
288
|
+
process.exitCode = main(process.argv.slice(2));
|
|
289
|
+
}
|