neoctl 0.2.36 → 0.2.37

package/dist/web/smoke-web-terminal-tasks.js

@@ -1,91 +1,141 @@
+import assert from "node:assert/strict";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
 import { ExecProcessManager } from "../tools/builtins/exec-process-manager.js";
 import { WebRepl } from "./index.js";
+const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+async function until(predicate) {
+    const deadline = Date.now() + 5_000;
+    while (!predicate()) {
+        assert.ok(Date.now() < deadline, "timed out waiting for real terminal output");
+        await delay(25);
+    }
+}
 async function main() {
-    const processManager = new ExecProcessManager({ completedRetentionMs: 2_000 });
-    const started = await processManager.execute(terminalOptions(), 0);
-    const sessionId = started.session_id;
-    let outputNotifications = 0;
-    const unsubscribeOutput = processManager.subscribeOutput(() => { outputNotifications += 1; });
-    await new Promise((resolve) => setTimeout(resolve, 250));
-    const foregroundId = processManager.start({ ...terminalOptions(), description: "尚在前台等待" });
+    const root = fs.mkdtempSync(path.join(os.tmpdir(), "web-terminal-tasks-"));
+    const ownerA = "web-smoke", ownerB = "other-owner";
+    const directories = { [ownerA]: path.join(root, ownerA), [ownerB]: path.join(root, ownerB) };
+    Object.values(directories).forEach((dir) => fs.mkdirSync(dir));
+    const manager = new ExecProcessManager({ sessionsRoot: root, completedRetentionMs: 2_000 });
+    let currentOwner = ownerA;
     const runtime = {
-        execProcessManager: processManager,
-        taskStore: {
-            activeCount: () => 0,
-            subscribe: () => () => undefined,
-            list: () => [],
-            isTerminal: () => false,
-        },
+        execProcessManager: manager,
+        taskStore: { activeCount: () => 0, subscribe: () => () => undefined, list: () => [], isTerminal: () => false },
         engine: {
-            getDisplayEntries: () => [],
-            getHistoryMessages: () => [],
-            snapshot: () => ({ messages: 0, session: { sessionId: "web-smoke" } }),
-            isFastMode: () => false,
-            getAppPrompt: () => ({ hasActivePrompt: false }),
+            getDisplayEntries: () => [], getHistoryMessages: () => [],
+            snapshot: () => ({ messages: 0, session: { sessionId: currentOwner, sessionDir: directories[currentOwner] } }),
+            redactDisplayValue: (value) => value,
+            isFastMode: () => false, getAppPrompt: () => ({ hasActivePrompt: false }),
             onSessionTitleChange: () => () => undefined,
         },
         initialMetrics: {},
     };
     const repl = new WebRepl(runtime);
-    const sseFrames = [];
-    const subscriber = {
-        blocked: false,
-        needsSync: false,
-        needsRuntimeContext: false,
-        response: {
-            destroyed: false,
-            write: (frame) => { sseFrames.push(frame); return true; },
-        },
-    };
-    repl.subscribers.add(subscriber);
-    const snapshot = repl.snapshot();
-    const terminal = snapshot.backgroundTasks[0];
-    const visible = snapshot.backgroundTaskCount === 1
-        && snapshot.backgroundTasks.length === 1
-        && terminal?.kind === "terminal"
-        && terminal?.sessionId === sessionId
-        && terminal?.command === "node background terminal smoke";
-    const foregroundHidden = snapshot.backgroundTasks.every((task) => task.sessionId !== foregroundId);
-    const liveOutputVisible = String(terminal?.output || "").includes("background-output-ready");
-    const liveOutputNotified = outputNotifications > 0;
-    const backgroundIgnoresTimeout = started.status === "running" && await remainsRunningAfter(sessionId, processManager, 300);
-    const terminalOutputSsePublished = sseFrames.some((frame) => frame.includes("event: terminal.output") && frame.includes("background-output-ready"));
-    unsubscribeOutput();
-    await processManager.interact(sessionId, { signal: "kill", yieldTimeMs: 3_000 });
-    await processManager.interact(foregroundId, { signal: "kill", yieldTimeMs: 3_000 });
-    const cleared = repl.snapshot().backgroundTasks.length === 0;
-    const checks = {
-        runningTerminalIsListed: visible,
-        foregroundTerminalIsHidden: foregroundHidden,
-        liveOutputVisible,
-        liveOutputNotified,
-        backgroundIgnoresTimeout,
-        terminalOutputSsePublished,
-        terminalIsRemovedAfterExit: cleared,
-    };
-    const ok = Object.values(checks).every(Boolean);
-    console.log(JSON.stringify({ ok, checks }, null, 2));
-    if (!ok)
-        process.exitCode = 1;
-}
-async function remainsRunningAfter(sessionId, processManager, delayMs) {
-    await new Promise((resolve) => setTimeout(resolve, delayMs));
-    return processManager.list().some((task) => task.session_id === sessionId && task.status === "running");
+    const frames = [];
+    const internal = repl;
+    const subscriber = { blocked: false, needsSync: false, needsRuntimeContext: false,
+        response: { destroyed: false, write: (frame) => { frames.push(frame); return true; } } };
+    internal.subscribers.add(subscriber);
+    const snapshot = () => repl.snapshot();
+    const updates = () => frames.filter((frame) => frame.includes("\nevent: terminal.output\n"))
+        .flatMap((frame) => JSON.parse(frame.split("\ndata: ")[1].trim()).updates);
+    const checks = {};
+    let notifications = 0;
+    const unsubscribe = manager.subscribeOutput(() => { notifications++; });
+    try {
+        const a = await manager.execute(terminalOptions(ownerA, directories[ownerA]), 0);
+        const b = await manager.execute(terminalOptions(ownerB, directories[ownerB]), 0);
+        const foregroundId = manager.start({ ...terminalOptions(ownerA, directories[ownerA]), timeoutMs: 10_000, description: "尚在前台等待" });
+        await manager.interact(a.session_id, { ownerId: ownerA, chars: "owner-A-output\n", yieldTimeMs: 150 });
+        await manager.interact(b.session_id, { ownerId: ownerB, chars: "owner-B-private\n", yieldTimeMs: 150 });
+        await until(() => updates().some((u) => u.sessionId === a.session_id));
+        const active = snapshot();
+        assert.equal(active.backgroundTaskCount, 1);
+        assert.equal(active.backgroundTasks.length, 1);
+        assert.equal(active.backgroundTasks[0]?.sessionId, a.session_id);
+        assert.equal(active.backgroundTasks[0]?.ownerSessionId, ownerA);
+        assert.equal(active.backgroundTasks[0]?.command, "node background terminal smoke");
+        assert.equal(active.backgroundTasks[0]?.kind, "terminal");
+        assert.ok(active.backgroundTasks.every((t) => t.sessionId !== foregroundId && t.sessionId !== b.session_id));
+        assert.deepEqual(active.terminalTaskHistory, []);
+        checks.ownerBoundBackgroundOnly = true;
+        assert.ok(!("output" in active.backgroundTasks[0]));
+        assert.ok(!JSON.stringify(active).includes("owner-A-output") && !JSON.stringify(active).includes("owner-B-private"));
+        checks.snapshotsNeverContainTerminalBody = true;
+        const page = repl.terminalOutput(ownerA, a.session_id, "stdout", 0, 65536);
+        assert.ok(page && page.text?.includes("owner-A-output\n"));
+        assert.equal(page.record.lifecycle, "running");
+        assert.equal(repl.terminalOutput(ownerA, b.session_id, "stdout", 0, 65536), undefined);
+        assert.equal(repl.terminalOutput(ownerB, b.session_id, "stdout", 0, 65536), undefined);
+        checks.ownerReaderAvailableAndForeignOwnerDenied = true;
+        assert.ok(notifications > 0);
+        assert.ok(updates().length > 0);
+        for (const update of updates()) {
+            assert.deepEqual(Object.keys(update).sort(), ["invalidated", "ownerSessionId", "sessionId"]);
+            assert.equal(update.invalidated, true);
+            assert.equal(update.ownerSessionId, ownerA);
+            assert.equal(update.sessionId, a.session_id);
+        }
+        assert.ok(!frames.some((frame) => frame.includes("owner-B-private") || frame.includes("owner-A-output")));
+        checks.realOutputSseInvalidatesWithoutBodyOrForeignOwner = true;
+        await delay(250);
+        assert.ok(manager.list(ownerA).some((t) => t.session_id === a.session_id && t.status === "running"));
+        checks.backgroundIgnoresForegroundTimeout = true;
+        // Deterministic delayed flush boundary: a queued old-owner update must not cross a session switch.
+        frames.length = 0;
+        internal.queueTerminalOutput({ sessionId: a.session_id, ownerSessionId: ownerA, stream: "stdout", text: "must-not-leak" });
+        currentOwner = ownerB;
+        internal.flushTerminalOutput();
+        assert.deepEqual(updates(), []);
+        internal.queueTerminalOutput({ sessionId: a.session_id, ownerSessionId: ownerA, stream: "stdout", text: "late-old-owner" });
+        internal.flushTerminalOutput();
+        assert.deepEqual(updates(), []);
+        const switched = snapshot();
+        assert.deepEqual(switched.backgroundTasks.map((t) => t.sessionId), [b.session_id]);
+        assert.deepEqual(switched.terminalTaskHistory, []);
+        assert.equal(repl.terminalOutput(ownerA, a.session_id, "stdout", 0, 65536), undefined);
+        checks.sessionSwitchDropsQueuedAndLateForeignInvalidation = true;
+        const killedB = await manager.interact(b.session_id, { ownerId: ownerB, signal: "kill", yieldTimeMs: 3_000 });
+        const historyB = snapshot();
+        assert.equal(historyB.backgroundTasks.length, 0);
+        assert.deepEqual(historyB.terminalTaskHistory.map((t) => t.sessionId), [b.session_id]);
+        assert.equal(historyB.terminalTaskHistory[0]?.status, killedB.status);
+        assert.equal(historyB.terminalTaskHistory[0]?.exitCode, killedB.exit_code);
+        currentOwner = ownerA;
+        assert.deepEqual(snapshot().terminalTaskHistory, []);
+        const killedA = await manager.interact(a.session_id, { ownerId: ownerA, signal: "kill", yieldTimeMs: 3_000 });
+        await manager.interact(foregroundId, { ownerId: ownerA, signal: "kill", yieldTimeMs: 3_000 });
+        const ended = snapshot();
+        assert.equal(ended.backgroundTasks.length, 0);
+        assert.equal(ended.terminalTaskHistory.length, 2);
+        assert.ok(ended.terminalTaskHistory.every((t) => t.ownerSessionId === ownerA && t.sessionId !== b.session_id));
+        const terminal = ended.terminalTaskHistory.find((t) => t.sessionId === a.session_id);
+        assert.equal(terminal.status, killedA.status);
+        assert.equal(terminal.exitCode, killedA.exit_code);
+        assert.equal(terminal.signal, killedA.signal);
+        assert.equal(terminal.terminationReason, killedA.termination_reason);
+        assert.equal(terminal.durationMs, killedA.duration_ms);
+        assert.ok(!("output" in terminal));
+        assert.ok(repl.terminalOutput(ownerA, a.session_id, "stdout", 0, 65536)?.text?.includes("owner-A-output"));
+        checks.terminalMovesToOwnerHistoryWithExactFactsAndReadableOutput = true;
+        console.log(JSON.stringify({ ok: true, checks }, null, 2));
+    }
+    finally {
+        unsubscribe();
+        internal.subscribers.delete(subscriber);
+        manager.terminateAll();
+        await until(() => manager.list().every((task) => task.status !== "running"));
+        fs.rmSync(root, { recursive: true, force: true });
+    }
 }
-function terminalOptions() {
+function terminalOptions(ownerId, sessionDir) {
     return {
-        command: "node background terminal smoke",
-        description: "后台终端冒烟测试",
-        cwd: process.cwd(),
-        shell: { requested: "node", file: process.execPath, args: ["-e", "setTimeout(() => console.log('background-output-ready'), 100); setTimeout(() => console.log('background-output-ready-live'), 350); setTimeout(() => {}, 5000);", "--"] },
-        env: {},
-        timeoutMs: 150,
-        maxOutputChars: 4_000,
-        tty: false,
+        ownerId, sessionDir, command: "node background terminal smoke", description: "后台终端冒烟测试", cwd: process.cwd(),
+        shell: { requested: "node", file: process.execPath,
+            args: ["-e", "process.stdin.setEncoding('utf8');process.stdin.on('data', text => process.stdout.write(text));setTimeout(()=>{},10000);", "--"] },
+        env: {}, timeoutMs: 150, maxOutputChars: 4_000, tty: false,
     };
 }
-void main().catch((error) => {
-    console.error(error);
-    process.exitCode = 1;
-});
+void main().catch((error) => { console.error(error); process.exitCode = 1; });
 //# sourceMappingURL=smoke-web-terminal-tasks.js.map

package/dist/web/smoke-web-terminal-tasks.js.map

@@ -1 +1 @@
-{"version":3,"file":"smoke-web-terminal-tasks.js","sourceRoot":"","sources":["../../src/web/smoke-web-terminal-tasks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"smoke-web-terminal-tasks.js","sourceRoot":"","sources":["../../src/web/smoke-web-terminal-tasks.ts"],"names":[],"mappings":"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"}

package/dist/web/status-semantics.d.ts

@@ -0,0 +1,11 @@
+export type StatusDomain = 'call' | 'task' | 'delivery' | 'readiness' | 'completeness' | 'launch';
+export declare function statusText(domain: StatusDomain, value: unknown): string;
+export declare function callStatus(line: any): {
+    key: string;
+    label: string;
+};
+export declare function subagentHeader(output: unknown): Record<string, any>;
+export declare function subagentStatusFacts(name: string, output: unknown, ok?: boolean): {
+    label: string;
+    value: string;
+}[];

package/dist/web/status-semantics.js

@@ -0,0 +1,59 @@
+const labels = {
+    call: { running: '调用中', success: '调用成功', failed: '调用失败' },
+    task: { pending: '排队中', running: '运行中', completed: '已完成', failed: '失败', killed: '已停止' },
+    delivery: { queued: '已入队', queued_for_resume: '已入队，待显式续跑', delivered: '已交付', not_queued: '未入队', failed: '投递失败' },
+    readiness: { ready: '结果已就绪', not_ready: '暂无终态结果' },
+    completeness: { completed: '完整', incomplete: '不完整' },
+    launch: { async_launched: '已异步启动', resumed: '已启动续跑' },
+};
+export function statusText(domain, value) {
+    if (value === undefined || value === null || value === '')
+        return '未提供';
+    return labels[domain][String(value)] ?? '未知状态';
+}
+export function callStatus(line) {
+    const value = line?.live ? 'running' : line?.titleStatus === 'failure' || line?.kind === 'error' ? 'failed' : line?.titleStatus === 'success' ? 'success' : undefined;
+    return { key: value === 'success' ? 'completed' : value ?? 'unknown', label: statusText('call', value) };
+}
+// Only the anchored, ordered protocol header is eligible. Never search output/error bodies.
+export function subagentHeader(output) {
+    if (output && typeof output === 'object' && !Array.isArray(output))
+        return output;
+    if (typeof output !== 'string')
+        return {};
+    const match = /^\s*<retrieval_status>([^<>]*)<\/retrieval_status>\s*<task_id>([^<>]*)<\/task_id>\s*<task_type>([^<>]*)<\/task_type>\s*<status>([^<>]*)<\/status>\s*<run_generation>([^<>]*)<\/run_generation>\s*<pending_messages>([^<>]*)<\/pending_messages>\s*<requires_resume>(true|false)<\/requires_resume>\s*<agent_id>([^<>]*)<\/agent_id>\s*<output>/.exec(output);
+    if (!match)
+        return {};
+    const keys = ['retrieval_status', 'task_id', 'task_type', 'status', 'run_generation', 'pending_messages', 'requires_resume', 'agent_id'];
+    const data = Object.fromEntries(keys.map((key, i) => [key, match[i + 1]]));
+    data.requires_resume = data.requires_resume === 'true';
+    return data;
+}
+export function subagentStatusFacts(name, output, ok) {
+    const data = subagentHeader(output);
+    const facts = [];
+    const add = (label, domain, value) => facts.push({ label, value: statusText(domain, value) });
+    add('调用状态', 'call', ok === true ? 'success' : ok === false ? 'failed' : undefined);
+    if (name === 'subagent_message') {
+        const delivery = ok === false ? 'not_queued' : data.status === 'queued_for_resume' ? data.status : data.delivery_status ?? data.status;
+        add('消息交付', 'delivery', delivery);
+        if (['queued', 'queued_for_resume'].includes(delivery))
+            facts.push({ label: '交付说明', value: '仅入队，不代表已交付或完成' });
+        if (delivery === 'delivered')
+            facts.push({ label: '交付说明', value: '已进入模型上下文，不代表采纳或完成' });
+    }
+    else if (['async_launched', 'resumed'].includes(data.status))
+        add('启动状态', 'launch', data.status);
+    else if (name === 'subagent_run' && ['completed', 'incomplete'].includes(data.status))
+        add('结果完整性', 'completeness', data.status);
+    else if (name !== 'subagent_list')
+        add('任务状态', 'task', data.status);
+    if (name === 'subagent_output' || data.retrieval_status !== undefined)
+        add('结果就绪', 'readiness', data.retrieval_status);
+    if (data.result_status !== undefined || data.result?.status !== undefined)
+        add('结果完整性', 'completeness', data.result_status ?? data.result?.status);
+    if (data.requires_resume === true)
+        facts.push({ label: '后续', value: '需要显式续跑' });
+    return facts;
+}
+//# sourceMappingURL=status-semantics.js.map

package/dist/web/status-semantics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-semantics.js","sourceRoot":"","sources":["../../src/web/status-semantics.ts"],"names":[],"mappings":"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"}

package/dist/web/terminal-presentation.d.ts

@@ -0,0 +1,15 @@
+export interface TerminalFact {
+    label: string;
+    value: string;
+    code?: boolean;
+    tone?: 'neutral' | 'warning' | 'danger';
+}
+export interface TerminalPreview {
+    label: string;
+    kind: 'code';
+    content: string;
+}
+export declare function terminalStatus(data: Record<string, unknown>): string;
+export declare function terminalFacts(data: Record<string, unknown>): TerminalFact[];
+export declare function terminalPreviews(data: Record<string, unknown>, limit?: number): TerminalPreview[];
+export declare function terminalResultText(data: Record<string, unknown>): string;

package/dist/web/terminal-presentation.js

@@ -0,0 +1,61 @@
+const supplied = (value) => value === undefined || value === null ? '未提供' : String(value);
+export function terminalStatus(data) {
+    if (data.status === 'running')
+        return '运行中';
+    if (data.status === 'lost')
+        return '运行已失联';
+    if (data.timed_out === true || data.termination_reason === 'timeout')
+        return '已超时';
+    if (['interrupt', 'terminate', 'kill', 'interrupted', 'terminated', 'killed'].includes(String(data.termination_reason)) || ['killed', 'stopped'].includes(String(data.status)))
+        return '已停止';
+    if (data.termination_reason === 'failed' || (typeof data.exit_code === 'number' && data.exit_code !== 0))
+        return '执行失败';
+    if (data.exit_code === 0)
+        return '已完成';
+    if (data.signal !== undefined && data.signal !== null)
+        return '因信号终止';
+    if (data.status === 'exited')
+        return '已退出（结果未提供）';
+    return '未提供';
+}
+export function terminalFacts(data) {
+    const facts = [
+        { label: '运行状态', value: terminalStatus(data) },
+        { label: '退出码', value: supplied(data.exit_code), code: true },
+        { label: '信号', value: supplied(data.signal) },
+        { label: '终止原因', value: supplied(data.termination_reason) },
+        { label: '耗时', value: typeof data.duration_ms === 'number' && Number.isFinite(data.duration_ms) && data.duration_ms >= 0 ? `${data.duration_ms} ms` : '未提供' },
+    ];
+    if (typeof data.session_id === 'string')
+        facts.push({ label: '终端会话', value: data.session_id, code: true });
+    const omitted = data.omitted_chars && typeof data.omitted_chars === 'object' ? data.omitted_chars : undefined;
+    const counts = data.output_chars && typeof data.output_chars === 'object' ? data.output_chars : undefined;
+    for (const stream of ['stdout', 'stderr']) {
+        const count = counts?.[stream];
+        const missing = omitted?.[stream];
+        if (typeof count === 'number')
+            facts.push({ label: `${stream} 本次字符`, value: String(count) });
+        if (typeof missing === 'number')
+            facts.push({ label: `${stream} 本次省略`, value: String(missing), ...(missing > 0 ? { tone: 'warning' } : {}) });
+    }
+    return facts;
+}
+export function terminalPreviews(data, limit = 1400) {
+    const previews = [];
+    for (const stream of ['stdout', 'stderr']) {
+        const value = data[stream];
+        if (typeof value !== 'string')
+            continue;
+        previews.push({ label: `${stream}${data.tty === true && stream === 'stdout' ? '（TTY 合流）' : ''}${value.length > limit ? ' · 预览已截断' : ''}`, kind: 'code', content: value.length > limit ? value.slice(0, limit) : value });
+    }
+    return previews;
+}
+export function terminalResultText(data) {
+    const head = terminalFacts(data).map(fact => `${fact.label}：${fact.value}`);
+    for (const stream of ['stdout', 'stderr']) {
+        const value = data[stream];
+        head.push(`${stream}${data.tty === true && stream === 'stdout' ? '（TTY 合流）' : ''}：`, typeof value === 'string' ? value === '' ? '（本次返回为空）' : value : '未提供');
+    }
+    return head.join('\n');
+}
+//# sourceMappingURL=terminal-presentation.js.map

package/dist/web/terminal-presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-presentation.js","sourceRoot":"","sources":["../../src/web/terminal-presentation.ts"],"names":[],"mappings":"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"}

package/dist/web/terminal-presentation.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/web/terminal-presentation.test.js

@@ -0,0 +1,33 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { terminalFacts, terminalPreviews, terminalResultText, terminalStatus } from './terminal-presentation.js';
+test('terminal streams preserve all whitespace and remain separate', () => {
+    const text = '\n  first\n\n\tlast  \n\n';
+    const previews = terminalPreviews({ stdout: text, stderr: text });
+    assert.equal(previews.length, 2);
+    assert.equal(previews[0]?.content, text);
+    assert.equal(previews[1]?.content, text);
+    assert.equal(previews[1]?.label, 'stderr');
+    assert.ok(terminalResultText({ stdout: text, stderr: '' }).includes(text));
+    assert.equal(terminalPreviews({ stdout: '', stderr: '\n' }).length, 2);
+});
+test('status uses exit facts not tool invocation success', () => {
+    for (const [input, expected] of [
+        [{ status: 'running' }, '运行中'], [{ status: 'exited', exit_code: 0 }, '已完成'],
+        [{ status: 'exited', exit_code: 7 }, '执行失败'], [{ status: 'exited', exit_code: 0, termination_reason: 'terminate' }, '已停止'],
+        [{ status: 'exited', timed_out: true }, '已超时'], [{ status: 'exited', signal: 'SIGTERM' }, '因信号终止'],
+        [{ status: 'exited' }, '已退出（结果未提供）'], [{ status: 'lost' }, '运行已失联'], [{}, '未提供'],
+    ])
+        assert.equal(terminalStatus(input), expected);
+});
+test('zero, missing, truncation and TTY semantics are explicit', () => {
+    const facts = terminalFacts({ exit_code: 0, duration_ms: 0, output_chars: { stdout: 0 }, omitted_chars: { stdout: 0, stderr: 20 } });
+    assert.equal(facts.find(x => x.label === '退出码')?.value, '0');
+    assert.equal(facts.find(x => x.label === '信号')?.value, '未提供');
+    assert.equal(facts.find(x => x.label === '耗时')?.value, '0 ms');
+    assert.equal(facts.find(x => x.label === 'stdout 本次字符')?.value, '0');
+    assert.equal(facts.find(x => x.label === 'stderr 本次省略')?.tone, 'warning');
+    assert.match(terminalPreviews({ stdout: '123456', tty: true }, 4)[0].label, /TTY 合流.*截断/);
+    assert.equal(terminalPreviews({ stdout: '123456' }, 4)[0].content, '1234');
+});
+//# sourceMappingURL=terminal-presentation.test.js.map

package/dist/web/terminal-presentation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-presentation.test.js","sourceRoot":"","sources":["../../src/web/terminal-presentation.test.ts"],"names":[],"mappings":"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"}

package/dist/web/tool-call-detail.d.ts

@@ -0,0 +1,40 @@
+import type { Message } from '../types/messages.js';
+export interface DetailPart {
+    state: 'complete' | 'truncated' | 'missing' | 'unavailable';
+    text: string;
+    reason: string;
+}
+export interface ToolCallDetail {
+    sessionId: string;
+    toolUseId: string;
+    messageId?: string;
+    toolName: string;
+    ok?: boolean;
+    input: DetailPart;
+    result: DetailPart;
+    error: DetailPart;
+}
+/** Compatibility entry point: display user-owned tool data without text rewriting. */
+export declare function redactToolDetail(value: unknown): unknown;
+/** Source authorization, BEFORE registry redaction, serialization or preview slicing.
+ * Provenance authorizes only the same result object's content, never sibling/history prose.
+ * This is not a secret redactor; callers must retain their existing redaction boundary.
+ */
+export declare function sanitizeAgentToolPayload(name: string, output: unknown): {
+    value: unknown;
+    unavailable?: string;
+};
+export declare function toolErrorText(output: unknown, ok: boolean): string;
+export declare function allowToolDetailRequest(origin: string | undefined, host: string | undefined, fetchSite: string | undefined): boolean;
+export declare function readToolCallDetail(options: {
+    sessionId: string;
+    expectedSessionId: string;
+    sessionDir?: string;
+    toolUseId: string;
+    messageId?: string;
+    redact?: (value: unknown) => unknown;
+    entries: readonly {
+        type: string;
+        message?: Message;
+    }[];
+}): Promise<ToolCallDetail | undefined>;