@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,178 @@
|
|
|
1
|
+
// entry/obs-broker.ts —— 观测过滤(M2 适配,分派 07)
|
|
2
|
+
//
|
|
3
|
+
// 挂点(06 号 loop 完整接管装配后的实际形态,任务书"以 06 的实际形态为准"):
|
|
4
|
+
// 1. tools/post-execute waterfall(工具结果出口,dsh-tools/lib/types/events.d.ts:40):
|
|
5
|
+
// 结果全文 → 共享 BlobSink(ctx.state,接 DSH storage)落盘 → kernel/obs 登记(audit)。
|
|
6
|
+
// 失败结果原样放行且 info_gain=high(内核 classify:ok=false 一律 high,模型必须看到失败);
|
|
7
|
+
// 结果内容绝不改写(decision 走 next() 原样 accept——驱动器 tf-peek 依赖原文,改写会毁 O2)。
|
|
8
|
+
// 2. llm/stream waterfall(F4,dsh-llm/lib/types/index.d.ts:45):逐请求泄漏扫描——
|
|
9
|
+
// 已登记 blob 全文若原样出现在任一请求消息(含骨架单行不算,须全文逐字节包含),
|
|
10
|
+
// 记 leak 台账(证据流,不阻断——阻断属"只记账不改流"的反面,且会误伤非本插件装配的请求);
|
|
11
|
+
// 并逐请求落指标(08 号 METRICS.md 口径:produced/injected/peeked/injectedRatio)。
|
|
12
|
+
// 3. fail-open(红线 5):任一挂点自身异常 → 全量放行 + ledger 记 broker_error,绝不静默。
|
|
13
|
+
//
|
|
14
|
+
// 注入决策(O1 三档 / O2 peek / O3 差分 / 饥饿升格)由 06 驱动器经其内核 ObservationLedger
|
|
15
|
+
// 落实(loop.ts #executeCommand → observe / #buildInjections);本 entry 的 ledger 是
|
|
16
|
+
// ToolsService 通道的全量旁证口径(含驱动器映射命令与原生 tool_call,供 08 号对账)。
|
|
17
|
+
|
|
18
|
+
import { ObservationLedger } from '../kernel/obs.ts';
|
|
19
|
+
import type { BlobSink as StateBlobSink } from '../kernel/state.ts';
|
|
20
|
+
import { makeWarn, EntryLedger, contentTextOf, wireMessageText } from './adapter-kit.ts';
|
|
21
|
+
import type { HostCtxLike } from './adapter-kit.ts';
|
|
22
|
+
import { asPluginEffect } from './cordis-compat.ts';
|
|
23
|
+
|
|
24
|
+
/** 镜像 dsh-tools/lib/types/contracts.d.ts:163-191 ToolExecution(读子集) */
|
|
25
|
+
interface ToolExecLike {
|
|
26
|
+
callId: string;
|
|
27
|
+
name: string;
|
|
28
|
+
arguments?: unknown;
|
|
29
|
+
}
|
|
30
|
+
/** 镜像 contracts.d.ts:289-311 ToolExecutionResult(读子集) */
|
|
31
|
+
interface ToolResultLike {
|
|
32
|
+
isError: boolean;
|
|
33
|
+
content: unknown;
|
|
34
|
+
}
|
|
35
|
+
/** 镜像 events.d.ts:40 tools/post-execute 监听器面 */
|
|
36
|
+
type PostExecuteListener = (exec: ToolExecLike, result: Readonly<ToolResultLike>, next: () => Promise<unknown>) => Promise<unknown>;
|
|
37
|
+
/** 镜像 dsh-llm/lib/types/index.d.ts:45 llm/stream waterfall 监听器面 */
|
|
38
|
+
type StreamListener = (options: { messages?: readonly { content: unknown }[]; sessionId?: string }, next: () => AsyncIterable<unknown>) => AsyncIterable<unknown>;
|
|
39
|
+
/** 镜像 state-handle.ts 提供的 StateService(duck-type,只读 sink) */
|
|
40
|
+
interface StateServiceLike {
|
|
41
|
+
sink: StateBlobSink;
|
|
42
|
+
durable: boolean;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
export interface ObsBrokerConfig {
|
|
46
|
+
/** 饥饿防线阈值(透传内核;本 entry 不驱动 step 语义,仅为透传配置位) */
|
|
47
|
+
starvationThreshold?: number;
|
|
48
|
+
/** 泄漏判定的最小 blob 体积(过短回执免检;默认 64 字符) */
|
|
49
|
+
leakMinChars?: number;
|
|
50
|
+
/** 测试注错位:'audit' 在登记路径抛、'scan' 在扫描路径抛;生产不得设置 */
|
|
51
|
+
faultInjection?: 'audit' | 'scan';
|
|
52
|
+
/** 装载自证横幅(排障用;preset/patch 激活对 CLI 静默,探针 A 惯例) */
|
|
53
|
+
announce?: boolean;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
export interface ObsBrokerHandle {
|
|
57
|
+
ledger: ObservationLedger;
|
|
58
|
+
faults: EntryLedger;
|
|
59
|
+
counters(): { injected: number; produced: number; peeked: number; injectedRatio: number };
|
|
60
|
+
dispose: () => void;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/** 内核 obs 的 BlobSink 面(put(ref, string))→ state BlobSink 面(write(key, bytes))桥接 */
|
|
64
|
+
function obsSinkBridge(inner: StateBlobSink): { put(ref: string, content: string): void; readRaw(ref: string): string | undefined } {
|
|
65
|
+
const encoder = new TextEncoder();
|
|
66
|
+
const decoder = new TextDecoder();
|
|
67
|
+
return {
|
|
68
|
+
put(ref, content) {
|
|
69
|
+
inner.write(ref, encoder.encode(content));
|
|
70
|
+
},
|
|
71
|
+
readRaw(ref) {
|
|
72
|
+
const data = inner.read(ref);
|
|
73
|
+
return data === undefined ? undefined : decoder.decode(data);
|
|
74
|
+
},
|
|
75
|
+
};
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/** 观测 key:稳定目标优先(同文件重复读被内核识别为 none),退化到 工具:callId。 */
|
|
79
|
+
function observationKeyOf(exec: ToolExecLike): string {
|
|
80
|
+
const args = (exec.arguments ?? {}) as Record<string, unknown>;
|
|
81
|
+
const target = args['file_path'] ?? args['path'] ?? args['command'] ?? args['url'];
|
|
82
|
+
return typeof target === 'string' && target !== '' ? `${exec.name}:${target}` : `${exec.name}:${exec.callId}`;
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
export const name = 'stream-agent-obs-broker';
|
|
86
|
+
export const inject = ['tools', 'state'];
|
|
87
|
+
|
|
88
|
+
export default function apply(ctx: HostCtxLike, config: ObsBrokerConfig = {}): ObsBrokerHandle {
|
|
89
|
+
const warn = makeWarn(ctx, 'obs-broker');
|
|
90
|
+
const faults = new EntryLedger();
|
|
91
|
+
const state = ctx.get?.('state') as StateServiceLike | undefined;
|
|
92
|
+
if (state === undefined) warn('ctx.state 服务不可用:blob 落盘降级为进程内存(resume 后不可重放)');
|
|
93
|
+
const bridge = obsSinkBridge(state?.sink ?? { write: () => {}, read: () => undefined });
|
|
94
|
+
const ledger = new ObservationLedger({ sink: { put: (ref, content) => bridge.put(ref, content) }, starvationThreshold: config.starvationThreshold });
|
|
95
|
+
|
|
96
|
+
// ---- 工具结果出口:登记(audit)+ 原样放行 ----------------------------------
|
|
97
|
+
const onPostExecute: PostExecuteListener = (exec, result, next) => {
|
|
98
|
+
try {
|
|
99
|
+
if (config.faultInjection === 'audit') throw new Error('injected broker fault (audit)');
|
|
100
|
+
const content = contentTextOf(result.content);
|
|
101
|
+
const observation = ledger.observe({
|
|
102
|
+
tool: exec.name,
|
|
103
|
+
ok: !result.isError,
|
|
104
|
+
key: observationKeyOf(exec),
|
|
105
|
+
content,
|
|
106
|
+
callId: exec.callId,
|
|
107
|
+
});
|
|
108
|
+
faults.push('audit', {
|
|
109
|
+
callId: exec.callId,
|
|
110
|
+
tool: exec.name,
|
|
111
|
+
isError: result.isError,
|
|
112
|
+
chars: content.length,
|
|
113
|
+
handle: observation.handle,
|
|
114
|
+
info_gain: observation.info_gain, // 失败必为 high(内核规则);模型必须看到失败
|
|
115
|
+
reason: observation.reason,
|
|
116
|
+
});
|
|
117
|
+
} catch (error) {
|
|
118
|
+
// fail-open:登记异常不影响工具结果放行;broker_error 留痕(红线 5)
|
|
119
|
+
faults.push('broker_error', { at: 'post-execute', error: error instanceof Error ? error.message : String(error) });
|
|
120
|
+
warn('观测登记异常:结果原样放行', error);
|
|
121
|
+
}
|
|
122
|
+
return next(); // 原样放行(成功与失败同权;改写会毁驱动器的 tf-peek 原文依赖)
|
|
123
|
+
};
|
|
124
|
+
|
|
125
|
+
// ---- llm/stream:泄漏扫描 + 指标落账(只读,不阻断不改写)-------------------
|
|
126
|
+
let requestSeq = 0;
|
|
127
|
+
const onStream: StreamListener = (options, next) => {
|
|
128
|
+
try {
|
|
129
|
+
if (config.faultInjection === 'scan') throw new Error('injected broker fault (scan)');
|
|
130
|
+
const messages = options.messages ?? [];
|
|
131
|
+
const leaks: Array<{ handle: string; message: number }> = [];
|
|
132
|
+
if (messages.length > 0) {
|
|
133
|
+
const texts = messages.map((m) => wireMessageText(m as { content: readonly { type: string; text?: string }[] }));
|
|
134
|
+
for (const record of ledger.records()) {
|
|
135
|
+
if (record.handle === '') continue;
|
|
136
|
+
const blob = bridge.readRaw(record.handle);
|
|
137
|
+
if (blob === undefined || blob.length < (config.leakMinChars ?? 64)) continue;
|
|
138
|
+
texts.forEach((text, index) => {
|
|
139
|
+
if (text.includes(blob)) leaks.push({ handle: record.handle, message: index });
|
|
140
|
+
});
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
for (const leak of leaks) faults.push('leak', { ...leak, session: options.sessionId ?? '' });
|
|
144
|
+
requestSeq += 1;
|
|
145
|
+
const counters = ledger.counters();
|
|
146
|
+
faults.push('metrics', {
|
|
147
|
+
session: options.sessionId ?? '',
|
|
148
|
+
request: requestSeq,
|
|
149
|
+
messages: messages.length,
|
|
150
|
+
leaks: leaks.length,
|
|
151
|
+
produced: counters.produced,
|
|
152
|
+
injected: counters.injected,
|
|
153
|
+
peeked: counters.peeked,
|
|
154
|
+
injectedRatio: ledger.injectedRatio(),
|
|
155
|
+
});
|
|
156
|
+
} catch (error) {
|
|
157
|
+
// fail-open:扫描异常 → 全量放行 + broker_error 留痕
|
|
158
|
+
faults.push('broker_error', { at: 'llm/stream', error: error instanceof Error ? error.message : String(error) });
|
|
159
|
+
warn('泄漏扫描异常:请求全量放行', error);
|
|
160
|
+
}
|
|
161
|
+
return next();
|
|
162
|
+
};
|
|
163
|
+
|
|
164
|
+
if (typeof ctx.on !== 'function') throw new Error('[obs-broker] ctx.on 不可用:无法挂载 tools/llm 事件');
|
|
165
|
+
ctx.on('tools/post-execute', onPostExecute as unknown as (...args: never[]) => unknown);
|
|
166
|
+
ctx.on('llm/stream', onStream as unknown as (...args: never[]) => unknown);
|
|
167
|
+
if (config.announce === true) console.error('[obs-broker] mounted: tools/post-execute + llm/stream listeners');
|
|
168
|
+
|
|
169
|
+
return asPluginEffect({
|
|
170
|
+
ledger,
|
|
171
|
+
faults,
|
|
172
|
+
counters() {
|
|
173
|
+
const c = ledger.counters();
|
|
174
|
+
return { ...c, injectedRatio: ledger.injectedRatio() };
|
|
175
|
+
},
|
|
176
|
+
dispose: () => {},
|
|
177
|
+
});
|
|
178
|
+
}
|
|
@@ -0,0 +1,405 @@
|
|
|
1
|
+
// entry/ptc-bridge.ts —— PTC 桥接(tf-code 执行通道;0.2.0 引入,0.3.0 收口 K2–K5)
|
|
2
|
+
//
|
|
3
|
+
// 把宿主 PTC runtime(@deepseek-ai/dsh-ptc-runtime,ctx.ptcRuntime 服务缝)
|
|
4
|
+
// 收编为单流协议的一个执行通道:模型在流里写 <tf-code> 程序(可擦除 TS 的 async 函数体),
|
|
5
|
+
// 驱动器闭合即派发到 runtime 沙箱执行,返回值/日志句柄化进 obs 账本——中间结果不进上下文。
|
|
6
|
+
//
|
|
7
|
+
// 宿主依赖全部 duck-type(红线:零 @deepseek-ai 静态 import),形状以官方 README 为锚:
|
|
8
|
+
// const spec = ctx.ptcRuntime.resolve({ program, bindings: [{ global, functions }], timeoutMs?, signal?, cwd? })
|
|
9
|
+
// const result = await ctx.ptcRuntime.run(spec) // result.value / result.logs / result.error / result.sandbox
|
|
10
|
+
// 程序失败 resolve 在 result.error(kind: exception/timeout/abort/worker-exit/invalid-output/
|
|
11
|
+
// output-limit/protocol/sandbox-unavailable——K3 八类保真,逐类给出可重试结论);
|
|
12
|
+
// run() reject 只表示调用方误用。
|
|
13
|
+
//
|
|
14
|
+
// 0.3.0 收口(beta.2):
|
|
15
|
+
// K2 策略透传与沙箱记账 —— resolve 透传会话 cwd(与 tf-write/tf-read 同一解析语义);
|
|
16
|
+
// result.sandbox 的 mode/denied/enforcement 逐次记账,enforcement=partial 显式标注,
|
|
17
|
+
// 不宣称隔离。沙箱不可用(sandbox-unavailable)与程序失败分开记账。
|
|
18
|
+
// K3 失败分类保真 —— 八类 kind 原样保留;classifyCodeFailure 给出可重试/不可重试结论;
|
|
19
|
+
// 拒绝(沙箱/误用)与代码错误分开,不引导模型改代码重试环境问题。
|
|
20
|
+
// K4 取消链路 —— 回合 signal 直通 resolve;配额超限或回合取消时本桥自铸 controller
|
|
21
|
+
// 同步 abort,绑定调用不再派发;abort(用户取消)与 timeout 分账。
|
|
22
|
+
// K5 配额 —— 子调用次数 / 输出字节 / 墙钟三项硬限制;超限结构化终止
|
|
23
|
+
// (kind: quota-exceeded),不靠提示。
|
|
24
|
+
//
|
|
25
|
+
// 安全面:程序本身不做任何 IO——唯一的绑定命名空间 tools(write/read/pwsh/edit)走驱动器
|
|
26
|
+
// 同一条 executeTools 通道,宿主 guard/工作区策略/凭据全部生效。
|
|
27
|
+
//
|
|
28
|
+
// fail-open(红线 5):runtime 形状不符 → 通道关闭并告警;命令级失败 → 结构化错误注入,
|
|
29
|
+
// 绝不静默。
|
|
30
|
+
|
|
31
|
+
/** 镜像 dsh-ptc-runtime 的 PtcRuntime 服务面(resolve + run 两段式;timeout 描述符可选)。 */
|
|
32
|
+
export interface PtcRuntimeLike {
|
|
33
|
+
resolve(request: {
|
|
34
|
+
program: string;
|
|
35
|
+
bindings?: ReadonlyArray<{ global: string; functions: Record<string, (args: unknown) => Promise<unknown>> }>;
|
|
36
|
+
timeoutMs?: number | null;
|
|
37
|
+
signal?: AbortSignal;
|
|
38
|
+
cwd?: string;
|
|
39
|
+
}): unknown;
|
|
40
|
+
run(spec: unknown): Promise<PtcRunResultLike>;
|
|
41
|
+
/** 诊断描述符(官方契约:'typescript');仅用于日志与校验,不做语义分支 */
|
|
42
|
+
language?: string;
|
|
43
|
+
readonly timeout?: { defaultMs: number; maxMs: number };
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
/** 镜像 PtcRunResult:无损 JSON 值 / 逐通道日志 / 正交错误 kind / 沙箱事实(K2)。 */
|
|
47
|
+
export interface PtcRunResultLike {
|
|
48
|
+
value?: unknown;
|
|
49
|
+
logs?: unknown;
|
|
50
|
+
error?: { kind: string; message?: string } | null;
|
|
51
|
+
/** 宿主沙箱事实(官方契约字段;防御式读取,缺席 = 不可得,不编造)。 */
|
|
52
|
+
sandbox?: { mode?: unknown; denied?: unknown; enforcement?: unknown } | null;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/** K2 沙箱记账事实(只记录宿主报告的事实,不做任何推导或包装)。 */
|
|
56
|
+
export interface SandboxFacts {
|
|
57
|
+
/** 宿主文件策略模式(read-only / workspace-write / danger-full-access / partial 报告)。 */
|
|
58
|
+
mode?: string;
|
|
59
|
+
/** 被拒绝的路径/操作列表(宿主报告;无则省略)。 */
|
|
60
|
+
denied?: string[];
|
|
61
|
+
/** 执行面:full(完全强制)| partial(Windows 档:硬链接别名/读取不受限/AppContainer 边界)。 */
|
|
62
|
+
enforcement?: 'full' | 'partial';
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/** 最小工具批形状(与 loop.ts 的 ToolBatchInputLike 结构兼容,避免模块环) */
|
|
66
|
+
interface ToolBatchInputMinimal {
|
|
67
|
+
calls: readonly { type: 'tool-call'; id: string; name: string; arguments: string }[];
|
|
68
|
+
signal: AbortSignal;
|
|
69
|
+
maxParallelToolCalls?: number;
|
|
70
|
+
agent?: unknown;
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
interface ToolBatchResultMinimal {
|
|
74
|
+
results: readonly { callId: string; result: { content: unknown; isError: boolean } }[];
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/** tf-code 的执行器面(驱动器经 DriverPorts.executeCode 调用)。 */
|
|
78
|
+
export type CodeExecutor = (input: {
|
|
79
|
+
callId: string;
|
|
80
|
+
/** 可擦除 TS 的 async 函数体(顶层 await / return 可用) */
|
|
81
|
+
code: string;
|
|
82
|
+
/** 毫秒;undefined = 宿主 provider 默认 */
|
|
83
|
+
timeoutMs?: number;
|
|
84
|
+
/** 回合取消 signal(K4:取消直通 resolve;绑定调用共用此 signal) */
|
|
85
|
+
signal: AbortSignal;
|
|
86
|
+
/** 会话工作区(K2:与 tf-write/tf-read 同一解析语义;缺省 = 宿主默认目录) */
|
|
87
|
+
cwd?: string;
|
|
88
|
+
/** 透传给工具批(fs 工具的 session 解析依赖,见 loop.ts W1 教训) */
|
|
89
|
+
agent?: unknown;
|
|
90
|
+
}) => Promise<CodeOutcome>;
|
|
91
|
+
|
|
92
|
+
export interface CodeOutcome {
|
|
93
|
+
ok: boolean;
|
|
94
|
+
/** 成功:result.value 的无损 JSON 序列化 */
|
|
95
|
+
valueJson?: string;
|
|
96
|
+
/** 失败:人类可读诊断(kind + message,≤500 字符) */
|
|
97
|
+
error?: string;
|
|
98
|
+
/** 失败:结构化 kind(K3 八类原样保留 + 插件级 ptc-runtime-misuse / quota-exceeded) */
|
|
99
|
+
kind?: string;
|
|
100
|
+
/** 失败:可重试结论与处置建议(K3;注入文案的唯一来源) */
|
|
101
|
+
retryable?: boolean;
|
|
102
|
+
advice?: string;
|
|
103
|
+
logs?: string;
|
|
104
|
+
/** K2 沙箱事实(成功与失败都记账;宿主未报告 = 缺省,不编造) */
|
|
105
|
+
sandbox?: SandboxFacts;
|
|
106
|
+
/** K2:本次运行实际下发的 cwd(对账用;未传 = 宿主默认目录) */
|
|
107
|
+
cwd?: string;
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
/** K5 配额三项硬限制(全部缺省可覆盖;0/负数 = 关闭该项并记账)。 */
|
|
111
|
+
export interface CodeQuota {
|
|
112
|
+
/** 单次 tf-code 允许的绑定(子)调用次数上限;超限后不再派发绑定调用。 */
|
|
113
|
+
maxSubcalls?: number;
|
|
114
|
+
/** 返回值 + 日志合计的字节上限(UTF-8);超限结构化终止。 */
|
|
115
|
+
maxOutputBytes?: number;
|
|
116
|
+
/** 墙钟上限(毫秒,插件侧硬终止;与宿主 timeoutMs 独立记账)。 */
|
|
117
|
+
maxWallMs?: number;
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
export const DEFAULT_CODE_QUOTA: Required<CodeQuota> = {
|
|
121
|
+
maxSubcalls: 64,
|
|
122
|
+
maxOutputBytes: 256 * 1024,
|
|
123
|
+
maxWallMs: 300_000,
|
|
124
|
+
};
|
|
125
|
+
|
|
126
|
+
/**
|
|
127
|
+
* K3 失败分类(八类 kind + 插件级两类):可重试结论与处置建议的唯一来源。
|
|
128
|
+
* - exception:有明确修复信息时修改程序可重试(换新 id);
|
|
129
|
+
* - timeout:调整预算或减量后可重试;
|
|
130
|
+
* - abort:用户取消——不可重试,改道或放弃;
|
|
131
|
+
* - worker-exit:默认不自动重试——先判定程序是否已产生写入,再决定继续或放弃;
|
|
132
|
+
* - invalid-output:原样重跑无用;
|
|
133
|
+
* - output-limit:需减量(返回值太大);
|
|
134
|
+
* - protocol:需修程序(协议层错误);
|
|
135
|
+
* - sandbox-unavailable:环境问题——不得重试,不得改代码;
|
|
136
|
+
* - ptc-runtime-misuse:调用方误用(插件/宿主装配层问题);
|
|
137
|
+
* - quota-exceeded:插件配额硬终止——减量后可重试。
|
|
138
|
+
* 拒绝与代码错误分开:沙箱拒绝不是"代码写错",不引导改代码。
|
|
139
|
+
*/
|
|
140
|
+
const CODE_FAILURE_ADVICE: Readonly<Record<string, { retryable: boolean; advice: string }>> = {
|
|
141
|
+
exception: { retryable: true, advice: '按诊断修复程序体(语法/绑定参数),换新 id 重发。' },
|
|
142
|
+
timeout: { retryable: true, advice: '减小程序规模或提高 timeout 属性(毫秒)后换新 id 重发。' },
|
|
143
|
+
abort: { retryable: false, advice: '用户取消了本回合:不要重试本程序;如需继续请等待新指令。' },
|
|
144
|
+
'worker-exit': { retryable: false, advice: '工作进程异常退出:先确认程序是否已产生文件写入(tf-read/台账),再决定继续或放弃;不要直接重跑。' },
|
|
145
|
+
'invalid-output': { retryable: false, advice: '程序返回了无效输出:原样重跑无用,请修改返回值结构后换新 id 重发。' },
|
|
146
|
+
'output-limit': { retryable: false, advice: '返回值超过上限:减少返回数据量(只 return 摘要/样本),换新 id 重发。' },
|
|
147
|
+
protocol: { retryable: false, advice: '程序违反 runtime 协议(如保留了保留成员):修改程序体后换新 id 重发。' },
|
|
148
|
+
'sandbox-unavailable': { retryable: false, advice: '沙箱环境不可用(非代码错误):不要修改代码重试;改道 tf-bash/tf-write 或报告环境问题。' },
|
|
149
|
+
'ptc-runtime-misuse': { retryable: false, advice: 'runtime 通道调用失败(装配层问题):不要重试本程序;请报告排障信息。' },
|
|
150
|
+
'quota-exceeded': { retryable: false, advice: '插件配额硬终止:减少子调用/输出量后换新 id 重发(诊断里有超限项)。' },
|
|
151
|
+
};
|
|
152
|
+
|
|
153
|
+
/** K3:kind → 可重试结论与建议;未知 kind 保守判不可重试(不引导盲目重试)。 */
|
|
154
|
+
export function classifyCodeFailure(kind: string): { retryable: boolean; advice: string } {
|
|
155
|
+
return CODE_FAILURE_ADVICE[kind] ?? { retryable: false, advice: '未知失败类型:请按诊断处理,不要盲目重试。' };
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
/** 形状校验:resolve + run 双函数在位才算 PtcRuntime(防止同名服务形状漂移时误接)。 */
|
|
159
|
+
export function looksLikePtcRuntime(candidate: unknown): candidate is PtcRuntimeLike {
|
|
160
|
+
if (candidate === null || typeof candidate !== 'object') return false;
|
|
161
|
+
const c = candidate as { resolve?: unknown; run?: unknown };
|
|
162
|
+
return typeof c.resolve === 'function' && typeof c.run === 'function';
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
/** logs 通道展平:string 原样 / 数组逐项递归拼接 / 对象 JSON(形状以官方 README 为锚,防御式)。 */
|
|
166
|
+
function flattenLogs(logs: unknown, depth = 0): string | undefined {
|
|
167
|
+
if (logs === undefined || logs === null) return undefined;
|
|
168
|
+
if (typeof logs === 'string') return logs === '' ? undefined : logs;
|
|
169
|
+
if (depth >= 3) return JSON.stringify(logs);
|
|
170
|
+
if (Array.isArray(logs)) {
|
|
171
|
+
const parts = logs.map((item) => flattenLogs(item, depth + 1)).filter((s): s is string => s !== undefined);
|
|
172
|
+
return parts.length === 0 ? undefined : parts.join('\n');
|
|
173
|
+
}
|
|
174
|
+
return JSON.stringify(logs);
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
/** K2 沙箱事实提取:只透传宿主报告的字段;缺席字段不编造(防御式,形状漂移不炸)。 */
|
|
178
|
+
function extractSandboxFacts(sandbox: PtcRunResultLike['sandbox']): SandboxFacts | undefined {
|
|
179
|
+
if (sandbox === undefined || sandbox === null || typeof sandbox !== 'object') return undefined;
|
|
180
|
+
const s = sandbox as { mode?: unknown; denied?: unknown; enforcement?: unknown };
|
|
181
|
+
const facts: SandboxFacts = {};
|
|
182
|
+
if (typeof s.mode === 'string') facts.mode = s.mode;
|
|
183
|
+
if (Array.isArray(s.denied)) facts.denied = s.denied.map((d) => (typeof d === 'string' ? d : JSON.stringify(d)));
|
|
184
|
+
if (s.enforcement === 'full' || s.enforcement === 'partial') facts.enforcement = s.enforcement;
|
|
185
|
+
return Object.keys(facts).length > 0 ? facts : undefined;
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
/** 错误诊断:kind + message(message 字段防御式提取)。 */
|
|
189
|
+
function describeRunError(error: NonNullable<PtcRunResultLike['error']>): string {
|
|
190
|
+
const message = typeof (error as { message?: unknown }).message === 'string' ? (error as { message: string }).message : JSON.stringify(error);
|
|
191
|
+
return `${error.kind}: ${message}`.slice(0, 500);
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
/** K5 配额状态(单次 tf-code 执行一个实例)。 */
|
|
195
|
+
class QuotaTracker {
|
|
196
|
+
readonly #limits: Required<CodeQuota>;
|
|
197
|
+
#subcalls = 0;
|
|
198
|
+
#exceeded: string | null = null;
|
|
199
|
+
constructor(limits: CodeQuota | undefined) {
|
|
200
|
+
this.#limits = { ...DEFAULT_CODE_QUOTA, ...(limits ?? {}) };
|
|
201
|
+
}
|
|
202
|
+
/** 绑定调用记账:超限返回结构化原因(调用方以此抛错,程序可捕获但标志已置位)。 */
|
|
203
|
+
onSubcall(): string | null {
|
|
204
|
+
if (this.#exceeded !== null) return this.#exceeded;
|
|
205
|
+
this.#subcalls += 1;
|
|
206
|
+
if (this.#limits.maxSubcalls > 0 && this.#subcalls > this.#limits.maxSubcalls) {
|
|
207
|
+
this.#exceeded = `subcalls>${this.#limits.maxSubcalls}`;
|
|
208
|
+
return this.#exceeded;
|
|
209
|
+
}
|
|
210
|
+
return null;
|
|
211
|
+
}
|
|
212
|
+
/** 输出字节判定:超限返回结构化原因。 */
|
|
213
|
+
checkOutput(bytes: number): string | null {
|
|
214
|
+
if (this.#exceeded !== null) return this.#exceeded;
|
|
215
|
+
if (this.#limits.maxOutputBytes > 0 && bytes > this.#limits.maxOutputBytes) {
|
|
216
|
+
this.#exceeded = `output-bytes ${bytes}>${this.#limits.maxOutputBytes}`;
|
|
217
|
+
return this.#exceeded;
|
|
218
|
+
}
|
|
219
|
+
return null;
|
|
220
|
+
}
|
|
221
|
+
/** 墙钟判定:超限返回结构化原因。 */
|
|
222
|
+
checkWall(elapsedMs: number): string | null {
|
|
223
|
+
if (this.#exceeded !== null) return this.#exceeded;
|
|
224
|
+
if (this.#limits.maxWallMs > 0 && elapsedMs > this.#limits.maxWallMs) {
|
|
225
|
+
this.#exceeded = `wall-ms ${Math.round(elapsedMs)}>${this.#limits.maxWallMs}`;
|
|
226
|
+
return this.#exceeded;
|
|
227
|
+
}
|
|
228
|
+
return null;
|
|
229
|
+
}
|
|
230
|
+
get exceeded(): string | null {
|
|
231
|
+
return this.#exceeded;
|
|
232
|
+
}
|
|
233
|
+
}
|
|
234
|
+
|
|
235
|
+
/** 单条工具绑定调用:走宿主同一条 executeTools 通道;isError → 抛(对齐 PTC 的 ToolCallError 语义,
|
|
236
|
+
* 程序内可 try/catch 继续或让程序失败 resolve 到 result.error)。 */
|
|
237
|
+
async function runOneBinding(
|
|
238
|
+
deps: { executeTools(input: ToolBatchInputMinimal): Promise<ToolBatchResultMinimal> },
|
|
239
|
+
name: string,
|
|
240
|
+
args: unknown,
|
|
241
|
+
callId: string,
|
|
242
|
+
signal: AbortSignal,
|
|
243
|
+
agent: unknown,
|
|
244
|
+
): Promise<unknown> {
|
|
245
|
+
const result = await deps.executeTools({
|
|
246
|
+
calls: [{ type: 'tool-call', id: `${callId}:ptc:${name}`, name, arguments: JSON.stringify(args ?? {}) }],
|
|
247
|
+
signal,
|
|
248
|
+
maxParallelToolCalls: 1,
|
|
249
|
+
...(agent === undefined ? {} : { agent }),
|
|
250
|
+
});
|
|
251
|
+
const first = result.results[0];
|
|
252
|
+
const content = first?.result?.content;
|
|
253
|
+
const text = content === undefined || content === null
|
|
254
|
+
? ''
|
|
255
|
+
: typeof content === 'string'
|
|
256
|
+
? content
|
|
257
|
+
: Array.isArray(content)
|
|
258
|
+
? content.map((block) => (typeof block === 'object' && block !== null && 'text' in (block as { text?: unknown }) && typeof (block as { text: unknown }).text === 'string' ? (block as { text: string }).text : JSON.stringify(block))).join('\n')
|
|
259
|
+
: String(content);
|
|
260
|
+
if (first?.result?.isError === true) throw new Error(text === '' ? `${name} failed` : text);
|
|
261
|
+
return text;
|
|
262
|
+
}
|
|
263
|
+
|
|
264
|
+
/**
|
|
265
|
+
* 构造 tf-code 执行器:resolve(校验 + 默认值)→ run(沙箱执行)→ CodeOutcome。
|
|
266
|
+
* 绑定命名空间固定为 tools(write/read/pwsh——与 tf-write/tf-read/tf-bash 同映射),
|
|
267
|
+
* 让程序具备文件与命令能力,且全部走宿主管线。
|
|
268
|
+
*
|
|
269
|
+
* 0.3.0(K2/K4/K5):
|
|
270
|
+
* - cwd 透传 resolve(会话工作区,与 tf-write/tf-read 同一解析语义);
|
|
271
|
+
* - 回合 signal 直通 resolve;配额/取消通过自铸 controller 同步传导;
|
|
272
|
+
* - 配额三项硬限制(子调用 / 输出字节 / 墙钟),超限结构化终止(kind: quota-exceeded);
|
|
273
|
+
* - 沙箱事实逐次记账(成功与失败都带)。
|
|
274
|
+
*/
|
|
275
|
+
export function createCodeExecutor(
|
|
276
|
+
runtime: PtcRuntimeLike,
|
|
277
|
+
deps: {
|
|
278
|
+
executeTools(input: ToolBatchInputMinimal): Promise<ToolBatchResultMinimal>;
|
|
279
|
+
/** K5 配额(缺省 DEFAULT_CODE_QUOTA;显式 0/负数 = 关闭该项)。 */
|
|
280
|
+
quota?: CodeQuota;
|
|
281
|
+
},
|
|
282
|
+
): CodeExecutor {
|
|
283
|
+
return async (input) => {
|
|
284
|
+
const quota = new QuotaTracker(deps.quota);
|
|
285
|
+
const startedAt = Date.now();
|
|
286
|
+
// K4:自铸 controller —— 回合 signal 触发时同步 abort;墙钟超限也走同一通道。
|
|
287
|
+
const controller = new AbortController();
|
|
288
|
+
const onOuterAbort = (): void => {
|
|
289
|
+
controller.abort(input.signal.reason instanceof Error ? input.signal.reason : new Error('tf-code aborted by turn signal'));
|
|
290
|
+
};
|
|
291
|
+
if (input.signal.aborted) onOuterAbort();
|
|
292
|
+
else input.signal.addEventListener('abort', onOuterAbort, { once: true });
|
|
293
|
+
let wallTimer: ReturnType<typeof setTimeout> | undefined;
|
|
294
|
+
const maxWallMs = { ...DEFAULT_CODE_QUOTA, ...(deps.quota ?? {}) }.maxWallMs;
|
|
295
|
+
if (maxWallMs > 0) {
|
|
296
|
+
wallTimer = setTimeout(() => {
|
|
297
|
+
controller.abort(new Error(`tf-code wall clock beyond ${maxWallMs}ms (quota)`));
|
|
298
|
+
}, maxWallMs);
|
|
299
|
+
}
|
|
300
|
+
|
|
301
|
+
const bindings = [
|
|
302
|
+
{
|
|
303
|
+
global: 'tools',
|
|
304
|
+
functions: {
|
|
305
|
+
write: (args: unknown) => {
|
|
306
|
+
const over = quota.onSubcall();
|
|
307
|
+
if (over !== null) throw new Error(`quota-exceeded: ${over}`);
|
|
308
|
+
return runOneBinding(deps, 'write', args, input.callId, controller.signal, input.agent);
|
|
309
|
+
},
|
|
310
|
+
read: (args: unknown) => {
|
|
311
|
+
const over = quota.onSubcall();
|
|
312
|
+
if (over !== null) throw new Error(`quota-exceeded: ${over}`);
|
|
313
|
+
return runOneBinding(deps, 'read', args, input.callId, controller.signal, input.agent);
|
|
314
|
+
},
|
|
315
|
+
pwsh: (args: unknown) => {
|
|
316
|
+
const over = quota.onSubcall();
|
|
317
|
+
if (over !== null) throw new Error(`quota-exceeded: ${over}`);
|
|
318
|
+
return runOneBinding(deps, 'pwsh', args, input.callId, controller.signal, input.agent);
|
|
319
|
+
},
|
|
320
|
+
},
|
|
321
|
+
},
|
|
322
|
+
];
|
|
323
|
+
|
|
324
|
+
const finishFailure = (kind: string, message: string, logs?: string, sandbox?: SandboxFacts): CodeOutcome => {
|
|
325
|
+
const cls = classifyCodeFailure(kind);
|
|
326
|
+
return {
|
|
327
|
+
ok: false,
|
|
328
|
+
kind,
|
|
329
|
+
error: `${kind}: ${message}`.slice(0, 500),
|
|
330
|
+
retryable: cls.retryable,
|
|
331
|
+
advice: cls.advice,
|
|
332
|
+
...(logs === undefined ? {} : { logs }),
|
|
333
|
+
...(sandbox === undefined ? {} : { sandbox }),
|
|
334
|
+
cwd: input.cwd,
|
|
335
|
+
};
|
|
336
|
+
};
|
|
337
|
+
|
|
338
|
+
try {
|
|
339
|
+
const spec = runtime.resolve({
|
|
340
|
+
program: input.code,
|
|
341
|
+
bindings,
|
|
342
|
+
...(input.timeoutMs === undefined ? {} : { timeoutMs: input.timeoutMs }),
|
|
343
|
+
signal: controller.signal,
|
|
344
|
+
...(input.cwd === undefined ? {} : { cwd: input.cwd }),
|
|
345
|
+
});
|
|
346
|
+
const result = await runtime.run(spec);
|
|
347
|
+
if (wallTimer !== undefined) clearTimeout(wallTimer);
|
|
348
|
+
input.signal.removeEventListener('abort', onOuterAbort);
|
|
349
|
+
const logs = flattenLogs(result.logs);
|
|
350
|
+
const sandbox = extractSandboxFacts(result.sandbox);
|
|
351
|
+
// 回合取消(K4):abort 与 timeout 分账——kind 取宿主报告值,没有则按 abort 归账。
|
|
352
|
+
if (input.signal.aborted && (result.error === undefined || result.error === null)) {
|
|
353
|
+
return { ...finishFailure('abort', '回合在 tf-code 执行期间被取消', logs), sandbox, ...(input.cwd === undefined ? {} : { cwd: input.cwd }) };
|
|
354
|
+
}
|
|
355
|
+
// K5 墙钟(插件侧硬终止,与宿主 timeout 独立记账)。
|
|
356
|
+
const wallOver = quota.checkWall(Date.now() - startedAt);
|
|
357
|
+
if (wallOver !== null) {
|
|
358
|
+
return { ...finishFailure('quota-exceeded', `wall clock: ${wallOver}`, logs), sandbox };
|
|
359
|
+
}
|
|
360
|
+
if (result.error !== undefined && result.error !== null) {
|
|
361
|
+
// K3:八类 kind 原样保留(宿主报告什么就是什么),分类结论由 classifyCodeFailure 给出。
|
|
362
|
+
const kind = typeof result.error.kind === 'string' && result.error.kind !== '' ? result.error.kind : 'exception';
|
|
363
|
+
const cls = classifyCodeFailure(kind);
|
|
364
|
+
return {
|
|
365
|
+
ok: false,
|
|
366
|
+
kind,
|
|
367
|
+
error: describeRunError(result.error),
|
|
368
|
+
retryable: cls.retryable,
|
|
369
|
+
advice: cls.advice,
|
|
370
|
+
...(logs === undefined ? {} : { logs }),
|
|
371
|
+
...(sandbox === undefined ? {} : { sandbox }),
|
|
372
|
+
cwd: input.cwd,
|
|
373
|
+
};
|
|
374
|
+
}
|
|
375
|
+
// value = 无损 JSON(seam 契约);undefined 视为程序无返回值
|
|
376
|
+
const valueJson = result.value === undefined ? 'undefined' : JSON.stringify(result.value) ?? 'undefined';
|
|
377
|
+
// K5 输出字节(值 + 日志合计)。
|
|
378
|
+
const bytes = Buffer.byteLength(valueJson, 'utf8') + (logs === undefined ? 0 : Buffer.byteLength(logs, 'utf8'));
|
|
379
|
+
const outOver = quota.checkOutput(bytes);
|
|
380
|
+
if (outOver !== null) {
|
|
381
|
+
return { ...finishFailure('quota-exceeded', `output bytes: ${outOver}`), sandbox };
|
|
382
|
+
}
|
|
383
|
+
if (quota.exceeded !== null) {
|
|
384
|
+
// 程序内部吞掉了配额错误也照样结构化终止:配额是硬终止,不是提示。
|
|
385
|
+
return { ...finishFailure('quota-exceeded', `binding calls: ${quota.exceeded}`), sandbox };
|
|
386
|
+
}
|
|
387
|
+
return {
|
|
388
|
+
ok: true,
|
|
389
|
+
valueJson,
|
|
390
|
+
...(logs === undefined ? {} : { logs }),
|
|
391
|
+
...(sandbox === undefined ? {} : { sandbox }),
|
|
392
|
+
cwd: input.cwd,
|
|
393
|
+
};
|
|
394
|
+
} catch (error) {
|
|
395
|
+
if (wallTimer !== undefined) clearTimeout(wallTimer);
|
|
396
|
+
input.signal.removeEventListener('abort', onOuterAbort);
|
|
397
|
+
// run() reject = 调用方误用(形状不符/已 dispose 等),如实失败不静默。
|
|
398
|
+
// 回合取消导致的 reject 归 abort 账(K4:取消与误用分账)。
|
|
399
|
+
if (input.signal.aborted || controller.signal.aborted) {
|
|
400
|
+
return finishFailure('abort', 'tf-code 被取消(回合 signal 或配额墙钟触发)');
|
|
401
|
+
}
|
|
402
|
+
return finishFailure('ptc-runtime-misuse', error instanceof Error ? error.message : String(error));
|
|
403
|
+
}
|
|
404
|
+
};
|
|
405
|
+
}
|