neoctl 0.2.35 → 0.2.37

package/dist/web/index.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { subagentHeader, subagentStatusFacts } from "./status-semantics.js";
 import http from "node:http";
 import fs from "node:fs/promises";
 import path from "node:path";
@@ -31,6 +32,10 @@ import { parseReplCommand, helpText, replCommandDefinitions } from "../repl/comm
 import { writeSessionMarkdownExport } from "../session/session-export.js";
 import { DefaultContextManager } from "../context/context-manager.js";
 import { createImageId } from "../types/messages.js";
+import { readToolCallDetail, toolErrorText, allowToolDetailRequest, sanitizeAgentToolPayload, redactToolDetail } from "./tool-call-detail.js";
+import { terminalFacts, terminalPreviews, terminalResultText } from "./terminal-presentation.js";
+import { createAgentContentDetailResolver } from "./agent-content-detail.js";
+import { toolDetailFieldsFromDetail } from "./tool-detail-fields.js";
 import { WEB_HTML } from "./html.js";
 import { openDirectory } from "../open-directory.js";
 import { resolveImageBlockDataResultSync, resolveImageBlockDataSync } from "../core/image-storage.js";
@@ -167,14 +172,10 @@ export async function createWebRuntime(options = {}) {
             tools.register(tool);
     const agentRuntime = { modelGateway, tools, taskStore };
     registerTool(createAgentTool(agentRuntime), { source: "builtin" });
+    let runtime;
     const resumeHandler = async (taskId, directive) => {
-        const dummyContext = {
-            agentId: "main",
-            tools,
-            appState: new InMemoryAppState("main", options.cwd),
-            emit: () => undefined,
-        };
-        return resumeAgentTask(taskId, directive, agentRuntime, taskStore, dummyContext);
+        const parentContext = createResumeParentContext(runtime.engine, tools, options.cwd);
+        return resumeAgentTask(taskId, directive, agentRuntime, taskStore, parentContext);
     };
     for (const tool of createSubagentTools(taskStore, resumeHandler))
         registerTool(tool, { source: "builtin" });
@@ -210,8 +211,9 @@ export async function createWebRuntime(options = {}) {
         },
     });
     await engine.initialize();
+    activateSession({ engine, taskStore });
     const initialMetrics = await engine.contextMetrics();
-    return {
+    runtime = {
         engine,
         appPromptStore,
         communicationLogger,
@@ -242,6 +244,7 @@ export async function createWebRuntime(options = {}) {
             resolveSession: options.resolveSessionToolOverrides,
         },
     };
+    return runtime;
 }
 function normalizeWebRuntimePlugins(value) {
     if (!Array.isArray(value))
@@ -274,10 +277,46 @@ function applyToolOverrides(registry, catalog, globalOverrides, sessionOverrides
     for (const tool of catalog)
         registry.setEnabled(tool.name, sessionOverrides[tool.name] ?? globalOverrides[tool.name] ?? true);
 }
-function createTaskNotificationSource(taskStore) {
+/** Bind only the foreground view; never stop work owned by another session. */
+export function activateSession(runtime) {
+    const sessionDir = runtime.engine.snapshot().session?.sessionDir || undefined;
+    const summary = runtime.taskStore.bindSession?.(sessionDir);
+    const interruptedTasks = summary?.loaded ? runtime.taskStore.recoverableInterruptedTasks?.(sessionDir) ?? [] : [];
+    if (interruptedTasks.length) {
+        runtime.engine.noteRecoverableSubagents(() => {
+            for (const task of interruptedTasks)
+                runtime.taskStore.markNotified(task.taskId);
+        });
+    }
+}
+export function sessionAgentTasks(runtime) {
+    const dir = runtime.engine.snapshot().session?.sessionDir || undefined;
+    // Older embedders provide minimal TaskStore mocks with no persistence API.
+    return runtime.taskStore.list().filter((task) => !runtime.taskStore.bindSession
+        || task.ownerSessionDir === (dir ? path.resolve(dir) : undefined));
+}
+export function createResumeParentContext(engine, tools, cwd) {
+    const snapshot = engine.snapshot();
+    const session = snapshot.session;
     return {
-        collectUnnotifiedCompletions() {
-            return taskStore.collectUnnotifiedCompletions().map((task) => ({
+        agentId: snapshot.agentId ?? "main",
+        tools,
+        appState: new InMemoryAppState(snapshot.agentId ?? "main", cwd),
+        session: session?.sessionDir ? {
+            sessionId: session.sessionId,
+            sessionDir: session.sessionDir,
+            rootDir: path.dirname(session.sessionDir),
+        } : undefined,
+        options: { mainLoopModel: snapshot.model, reasoning: snapshot.reasoning,
+            contextWindowTokensOverride: snapshot.contextWindowTokensOverride },
+        emit: () => undefined,
+    };
+}
+export function createTaskNotificationSource(taskStore) {
+    return {
+        collectUnnotifiedCompletions(sessionDir) {
+            return taskStore.collectUnnotifiedCompletions(sessionDir).filter((task) => !taskStore.bindSession
+                || task.ownerSessionDir === (sessionDir ? path.resolve(sessionDir) : undefined)).map((task) => ({
                 taskId: task.taskId,
                 agentId: task.agentId,
                 status: task.status,
@@ -364,6 +403,7 @@ function webRuntimeScopeKey(scope) {
 }
 export class WebRepl {
     runtime;
+    agentContentReader = createAgentContentDetailResolver();
     subscribers = new Set();
     eventSequence = 0;
     pendingDeltaOperations = [];
@@ -389,7 +429,6 @@ export class WebRepl {
     pendingUserImageEchoMessageId;
     runtimeContextRevision = 0;
     runtimeContextPublishQueue = Promise.resolve();
-    pendingRuntimeConfiguration = false;
     backgroundSessionRuns = new Map();
     suppressReattachedStreaming = new Set();
     constructor(runtime) {
@@ -433,18 +472,53 @@ export class WebRepl {
             this.send(subscriber, "client.reload", payload);
         return subscribers.length;
     }
+    async toolCallDetail(sessionId, toolUseId, messageId) {
+        const session = this.runtime.engine.snapshot().session;
+        const detail = await readToolCallDetail({ sessionId: session?.sessionId ?? "", expectedSessionId: sessionId, sessionDir: session?.sessionDir, toolUseId, messageId, redact: value => this.runtime.engine.redactDisplayValue(value), entries: this.runtime.engine.getDisplayEntries() });
+        return detail ? this.runtime.engine.redactDisplayValue({ ...detail, fields: toolDetailFieldsFromDetail(detail) }) : undefined;
+    }
+    async agentContent(sessionId, view, request) {
+        const session = this.runtime.engine.snapshot().session;
+        if (!session?.sessionDir || sessionId !== session.sessionId || !["timeline", "delegation", "report", "messages"].includes(view))
+            return undefined;
+        // Loading/recovery belongs to activateSession, never this read-only route.
+        if (!this.runtime.taskStore.getInSession(request.taskId, session.sessionDir))
+            return undefined;
+        return this.agentContentReader[view]({
+            ownerSessionId: sessionId, ownerSessionDir: session.sessionDir, taskStore: this.runtime.taskStore,
+            redact: value => this.runtime.engine.redactDisplayValue(value),
+        }, request);
+    }
+    terminalOutput(sessionId, runId, stream, offset, limitBytes) {
+        const session = this.runtime.engine.snapshot().session;
+        if (!session?.sessionDir || !sessionId || sessionId !== session.sessionId || !runId || !["stdout", "stderr"].includes(stream))
+            return undefined;
+        if (!Number.isSafeInteger(offset) || offset < 0 || !Number.isSafeInteger(limitBytes) || limitBytes < 4 || limitBytes > 262144)
+            return undefined;
+        const manager = this.runtime.execProcessManager;
+        const registered = manager.registerOwnerSession(sessionId, session.sessionDir);
+        if (!registered.ok)
+            return undefined;
+        const page = manager.readOutput(sessionId, runId, { stream: stream, offset, limitBytes });
+        // Cursor addresses stored bytes, not the possibly additionally redacted response length.
+        return page.ok ? this.runtime.engine.redactDisplayValue({ sessionId, runId, ...page.value }) : undefined;
+    }
     snapshot(includeCatalog = false) {
         const backgroundTasks = this.backgroundTasks();
+        const engineSnapshot = this.runtime.engine.snapshot();
         return {
-            lines: this.lines,
+            lines: this.lines.map(line => line.toolError ? { ...line, toolError: this.runtime.engine.redactDisplayValue?.(line.toolError) ?? line.toolError } : line),
             status: this.status,
             busy: this.busy,
             queuedInput: this.queuedInput,
             backgroundTaskCount: backgroundTasks.length,
             backgroundTasks,
+            terminalTaskHistory: this.terminalTaskHistory(),
+            agentTaskHistory: sessionAgentTasks(this.runtime).filter((task) => this.runtime.taskStore.isTerminal(task)).sort((a, b) => b.updatedAt.localeCompare(a.updatedAt)).map((task) => this.agentTaskSnapshot(task)),
             backgroundSessionRunCount: this.backgroundSessionRuns.size,
             runningSessionIds: [...this.backgroundSessionRuns.keys()],
-            session: this.runtime.engine.snapshot().session,
+            session: engineSnapshot.session,
+            modelSettings: { model: engineSnapshot.model, reasoning: engineSnapshot.reasoning },
             fastMode: this.runtime.engine.isFastMode(),
             appPrompt: this.runtime.engine.getAppPrompt(),
             catalog: includeCatalog ? webCatalog(this.runtime) : undefined,
@@ -514,6 +588,8 @@ export class WebRepl {
         };
     }
     async setGlobalTools(value) {
+        if (this.busy)
+            return actionFailure("TOOL_UPDATE_BLOCKED", "cannot change global tools while a response is running");
         if (!isRecord(value))
             return actionFailure("INVALID_REQUEST", "tool overrides must be an object");
         const support = this.runtime.toolSupport;
@@ -524,12 +600,10 @@ export class WebRepl {
             return normalized;
         try {
             support.globalOverrides = normalized.value;
+            this.syncPluginToolRegistration();
+            applyToolOverrides(this.runtime.tools, support.catalog, support.globalOverrides, support.sessionOverrides);
             if (support.persistGlobal)
                 await support.persistGlobal(support.globalOverrides);
-            if (this.busy)
-                this.pendingRuntimeConfiguration = true;
-            else
-                await this.applyRuntimeConfiguration();
             await this.refreshToolConfiguration();
             return { ok: true, state: this.globalTools() };
         }
@@ -538,6 +612,8 @@ export class WebRepl {
         }
     }
     async setSessionTools(value) {
+        if (this.busy)
+            return actionFailure("TOOL_UPDATE_BLOCKED", "cannot change session tools while a response is running");
         if (!isRecord(value))
             return actionFailure("INVALID_REQUEST", "tool overrides must be an object");
         const support = this.runtime.toolSupport;
@@ -561,6 +637,8 @@ export class WebRepl {
         await this.applySessionToolOverrides(await support.resolveSession(sessionId), false);
     }
     async setSessionPlugins(value) {
+        if (this.busy)
+            return actionFailure("PLUGIN_UPDATE_BLOCKED", "cannot change session plugins while a response is running");
         if (!isRecord(value))
             return actionFailure("INVALID_REQUEST", "plugin overrides must be an object");
         const support = this.runtime.pluginSupport;
@@ -624,13 +702,11 @@ export class WebRepl {
         if (!support)
             return;
         support.sessionOverrides = normalizeToolOverrides(overrides, support.catalog);
+        this.syncPluginToolRegistration();
+        applyToolOverrides(this.runtime.tools, support.catalog, support.globalOverrides, support.sessionOverrides);
         const sessionId = this.runtime.engine.snapshot().session?.sessionId;
         if (persist && sessionId && support.persistSession)
             await support.persistSession(sessionId, support.sessionOverrides);
-        if (this.busy)
-            this.pendingRuntimeConfiguration = true;
-        else
-            await this.applyRuntimeConfiguration();
         await this.refreshToolConfiguration();
     }
     syncPluginToolRegistration() {
@@ -645,18 +721,6 @@ export class WebRepl {
                 this.runtime.tools.register(tool);
         }
     }
-    async applyRuntimeConfiguration() {
-        this.syncPluginToolRegistration();
-        const pluginSupport = this.runtime.pluginSupport;
-        if (pluginSupport) {
-            const activePlugins = activeWebRuntimePlugins(pluginSupport.catalog, pluginSupport.overrides);
-            this.runtime.engine.setRuntimePlugins([...pluginSupport.basePluginIds, ...activePlugins.map((plugin) => plugin.id)], [...pluginSupport.basePromptSections, ...activePlugins.flatMap((plugin) => plugin.promptSections ?? [])]);
-        }
-        const toolSupport = this.runtime.toolSupport;
-        if (toolSupport)
-            applyToolOverrides(this.runtime.tools, toolSupport.catalog, toolSupport.globalOverrides, toolSupport.sessionOverrides);
-        this.pendingRuntimeConfiguration = false;
-    }
     async refreshToolConfiguration() {
         const metrics = await this.runtime.engine.contextMetrics();
         this.runtime.initialMetrics = metrics;
@@ -669,14 +733,21 @@ export class WebRepl {
         if (!support)
             return;
         const normalized = normalizePluginOverrides(overrides, support.catalog);
+        for (const plugin of support.catalog)
+            for (const tool of plugin.tools)
+                this.runtime.tools.unregister(tool.name);
+        const activePlugins = activeWebRuntimePlugins(support.catalog, normalized);
+        for (const plugin of activePlugins)
+            for (const tool of plugin.tools)
+                this.runtime.tools.register(tool);
         support.overrides = normalized;
+        const toolSupport = this.runtime.toolSupport;
+        if (toolSupport)
+            applyToolOverrides(this.runtime.tools, toolSupport.catalog, toolSupport.globalOverrides, toolSupport.sessionOverrides);
+        this.runtime.engine.setRuntimePlugins([...support.basePluginIds, ...activePlugins.map((plugin) => plugin.id)], [...support.basePromptSections, ...activePlugins.flatMap((plugin) => plugin.promptSections ?? [])]);
         const sessionId = this.runtime.engine.snapshot().session?.sessionId;
         if (persist && sessionId && support.persist)
             await support.persist(sessionId, normalized);
-        if (this.busy)
-            this.pendingRuntimeConfiguration = true;
-        else
-            await this.applyRuntimeConfiguration();
         const metrics = await this.runtime.engine.contextMetrics();
         this.runtime.initialMetrics = metrics;
         this.setStatus({ ...this.status, metrics, activityTick: this.status.activityTick + 1 });
@@ -727,11 +798,7 @@ export class WebRepl {
         this.queuedAttachments = [...(this.queuedAttachments ?? []), ...attachments].slice(0, 20);
     }
     startRun(text, attachments = []) {
-        const run = (async () => {
-            if (this.pendingRuntimeConfiguration)
-                await this.applyRuntimeConfiguration();
-            await this.handleCommandOrPrompt(text, attachments);
-        })().catch((error) => {
+        const run = this.handleCommandOrPrompt(text, attachments).catch((error) => {
             this.append({ kind: "error", text: error instanceof Error ? error.message : String(error) });
             this.setBusy(false);
             this.setStatus({ ...this.status, phase: "ready", detail: undefined });
@@ -759,6 +826,7 @@ export class WebRepl {
             await this.detachRunningForeground("session switch");
             this.runtime.engine = this.runtime.engine.forkForSession(sessionId, true);
             await this.runtime.engine.initialize();
+            activateSession(this.runtime);
             const snapshot = this.runtime.engine.snapshot().session;
             if (!snapshot)
                 throw new Error("session transcripts are disabled");
@@ -776,6 +844,7 @@ export class WebRepl {
             await this.detachRunningForeground("new session");
             this.runtime.engine = this.runtime.engine.forkForSession(undefined, false);
             await this.runtime.engine.initialize();
+            activateSession(this.runtime);
             const snapshot = this.runtime.engine.snapshot().session;
             if (!snapshot)
                 throw new Error("session transcripts are disabled");
@@ -892,6 +961,8 @@ export class WebRepl {
         }
     }
     async setContextWindowK(value) {
+        if (this.busy)
+            return actionFailure("CONTEXT_WINDOW_UPDATE_BLOCKED", "cannot change context window while a response is running");
         if (typeof value !== "string" || !/^\d+$/u.test(value) || Number(value) <= 0) {
             return actionFailure("CONTEXT_WINDOW_INVALID", "context window must be a positive integer in k");
         }
@@ -1017,24 +1088,77 @@ export class WebRepl {
         this.broadcastSync();
         return runWasActive;
     }
+    agentTaskSnapshot(task) {
+        const terminal = this.runtime.taskStore.isTerminal(task);
+        // Redact complete values before any public preview boundary: clipping first can expose
+        // a credential prefix which no longer matches the runtime registry's full value.
+        const safeText = (value) => value === undefined ? undefined : this.runtime.engine.redactDisplayValue(value);
+        const result = (value, limit = 1500) => {
+            if (!value)
+                return undefined;
+            if (value.displaySource !== "agent_report" && value.displaySource !== "visible_text") {
+                return { content: "", truncated: false, status: value.status, availability: "unavailable", reason: "旧报告缺少获准展示来源；不会公开未验证的文本" };
+            }
+            const content = safeText(value.content);
+            return { content: content.slice(0, limit), truncated: content.length > limit, status: value.status };
+        };
+        const error = safeText(task.error);
+        return this.runtime.engine.redactDisplayValue({
+            kind: "agent", taskId: task.taskId, agentId: task.agentId,
+            agentType: task.agentType, type: task.type, status: task.status,
+            description: task.description, runGeneration: task.runGeneration ?? 1,
+            progress: { visibleText: task.progress.visibleText?.channel === "visible" && task.progress.visibleText.redactionVersion === 1 && task.progress.visibleText.runGeneration === task.runGeneration ? this.runtime.engine.redactDisplayValue(task.progress.visibleText) : undefined, lastActivity: task.progress.lastActivity, currentAction: task.progress.currentAction, totalToolUseCount: task.progress.totalToolUseCount, steps: task.progress.steps?.slice(-8).map((step) => ({ id: step.id, title: step.title, status: step.status })) },
+            pendingMessageCount: task.pendingMessages.length,
+            deliveredRetainedThisRun: task.messageReceipts?.filter((receipt) => receipt.status === "delivered" && receipt.runGeneration === task.runGeneration).length,
+            messageReceipts: (task.messageReceipts ?? []).slice(-20).map(({ id, status, queuedAt, deliveredAt, runGeneration }) => ({ id, status, queuedAt, deliveredAt, runGeneration })),
+            result: terminal ? result(task.result) : undefined,
+            error: terminal ? error?.slice(0, 1500) : undefined,
+            errorTruncated: terminal && (error?.length ?? 0) > 1500,
+            runHistory: (task.runHistory ?? []).map((run) => {
+                const archivedError = safeText(run.error);
+                return { runGeneration: run.runGeneration, status: run.status, startedAt: run.startedAt, durationMs: run.durationMs, completedAt: run.completedAt, result: result(run.result, 600), error: archivedError?.slice(0, 600), errorTruncated: (archivedError?.length ?? 0) > 600 };
+            }),
+            createdAt: task.createdAt, updatedAt: task.updatedAt, startedAt: task.startedAt, completedAt: task.completedAt, durationMs: task.durationMs,
+        });
+    }
+    terminalTaskHistory() {
+        const session = this.runtime.engine.snapshot().session;
+        if (!session?.sessionId || !session.sessionDir)
+            return [];
+        const manager = this.runtime.execProcessManager;
+        if (!manager.registerOwnerSession?.(session.sessionId, session.sessionDir).ok)
+            return [];
+        const records = [];
+        let offset = 0;
+        do {
+            const history = manager.listHistory(session.sessionId, { offset, limit: 200 });
+            if (!history.ok)
+                break;
+            records.push(...history.value.records);
+            if (history.value.nextOffset === null)
+                break;
+            offset = history.value.nextOffset;
+        } while (true);
+        return records.reverse().map(({ record }) => ({
+            kind: "terminal", taskId: `terminal:${record.runId}`, type: "终端",
+            ownerSessionId: session.sessionId, sessionId: record.runId,
+            status: record.lifecycle === "lost" ? "lost" : record.exit?.status ?? "unknown",
+            description: record.metadata.description || record.metadata.command || "终端运行",
+            command: record.metadata.command, cwd: record.metadata.cwd, shell: record.metadata.shell,
+            tty: record.metadata.tty, processId: record.metadata.processId,
+            createdAt: record.metadata.startedAt, completedAt: record.exit?.finishedAt,
+            durationMs: record.exit?.durationMs, exitCode: record.exit?.exitCode,
+            signal: record.exit?.signal, terminationReason: record.exit?.terminationReason,
+            outputAvailability: record.availability, outputTruncated: record.truncated,
+            metadataTruncated: record.metadata.truncatedFields,
+        })).map(task => this.runtime.engine.redactDisplayValue(task));
+    }
     backgroundTasks() {
-        const agentTasks = this.runtime.taskStore.list()
+        const agentTasks = sessionAgentTasks(this.runtime)
             .filter((task) => !this.runtime.taskStore.isTerminal(task))
-            .map((task) => ({
-            kind: "agent",
-            taskId: task.taskId,
-            agentId: task.agentId,
-            agentType: task.agentType,
-            type: task.type,
-            status: task.status,
-            description: task.description,
-            prompt: task.prompt,
-            progress: task.progress,
-            outputFile: task.outputFile,
-            createdAt: task.createdAt,
-            updatedAt: task.updatedAt,
-        }));
-        const terminalTasks = this.runtime.execProcessManager.list()
+            .map((task) => this.agentTaskSnapshot(task));
+        const ownerSessionId = this.runtime.engine.snapshot().session?.sessionId;
+        const terminalTasks = (ownerSessionId ? this.runtime.execProcessManager.list(ownerSessionId) : [])
             .filter((terminal) => terminal.status === "running" && terminal.backgrounded)
             .map((terminal) => ({
             kind: "terminal",
@@ -1042,7 +1166,8 @@ export class WebRepl {
             type: "终端",
             status: terminal.status,
             description: terminal.description || terminal.command,
-            createdAt: Date.now() - terminal.duration_ms,
+            createdAt: terminal.started_at,
+            ownerSessionId,
             sessionId: terminal.session_id,
             processId: terminal.process_id,
             command: terminal.command,
@@ -1050,8 +1175,11 @@ export class WebRepl {
             shell: terminal.shell,
             tty: terminal.tty,
             durationMs: terminal.duration_ms,
-            output: terminal.output,
-            outputEnd: terminal.outputEnd,
+            // Output is loaded from the owner-bound reader, never copied into state snapshots.
+            exitCode: terminal.exit_code,
+            signal: terminal.signal,
+            terminationReason: terminal.termination_reason,
+            outputAvailability: terminal.output_ref.availability,
         }));
         const sessionTasks = [...this.backgroundSessionRuns.values()].map((run) => ({
             kind: "session",
@@ -1108,6 +1236,7 @@ export class WebRepl {
         await this.detachRunningForeground("session switch");
         this.backgroundSessionRuns.delete(run.sessionId);
         this.runtime.engine = run.engine;
+        activateSession(this.runtime);
         this.activeAbortController = run.abortController;
         this.interruptArmed = false;
         this.foregroundRun = run.promise;
@@ -1260,7 +1389,7 @@ export class WebRepl {
                 return liveLineId;
             }, runtimeToolResultPresenter(this.runtime));
         }
-        const steps = (liveLine.toolStream?.steps ?? []).map((step) => step.status === "running" ? { ...step, status: event.ok ? "completed" : "failed" } : step);
+        const steps = (liveLine.toolStream?.steps ?? []).map((step) => step.status === "running" ? { ...step, status: "unknown" } : step);
         if (replacement) {
             this.replaceLine(liveLineId, {
                 ...replacement,
@@ -1430,6 +1559,7 @@ export class WebRepl {
             return void this.append({ kind: "system", text: formatUsageTotals(this.runtime.usage.snapshot()), previewStyle: "summary" });
         if (command.type === "reset") {
             this.runtime.engine.reset();
+            activateSession(this.runtime);
             this.runtime.usage.reset();
             this.status = await resetStatus(this.runtime);
             this.append(systemLine("transcript reset"));
@@ -1684,6 +1814,10 @@ export class WebRepl {
         this.queueDeltaOperation(operation);
     }
     queueDeltaOperation(operation) {
+        if (operation.type === "line.append" && operation.line.toolError)
+            operation = { ...operation, line: { ...operation.line, toolError: this.runtime.engine.redactDisplayValue?.(operation.line.toolError) ?? operation.line.toolError } };
+        if (operation.type === "line.patch" && operation.patch.toolError)
+            operation = { ...operation, patch: { ...operation.patch, toolError: this.runtime.engine.redactDisplayValue?.(operation.patch.toolError) ?? operation.patch.toolError } };
         this.pendingDeltaOperations.push(operation);
         this.scheduleDeltaFlush();
     }
@@ -1727,18 +1861,11 @@ export class WebRepl {
         }
     }
     queueTerminalOutput(delta) {
-        if (!this.subscribers.size || !this.runtime.execProcessManager.isBackgroundRunning(delta.sessionId))
+        const ownerSessionId = this.runtime.engine.snapshot().session?.sessionId;
+        if (!this.subscribers.size || !ownerSessionId || delta.ownerSessionId !== ownerSessionId)
             return;
-        const outputStart = Number(delta.outputStart ?? 0);
-        const outputEnd = Number(delta.outputEnd ?? outputStart + delta.text.length);
-        const pending = this.pendingTerminalOutput.get(delta.sessionId);
-        if (pending && pending.outputEnd === outputStart) {
-            pending.text = appendBoundedText(pending.text, delta.text, TERMINAL_OUTPUT_EVENT_MAX_CHARS);
-            pending.outputEnd = outputEnd;
-        }
-        else {
-            this.pendingTerminalOutput.set(delta.sessionId, { text: delta.text.slice(-TERMINAL_OUTPUT_EVENT_MAX_CHARS), outputStart, outputEnd });
-        }
+        // Invalidation only. The reader owns independent stream cursors; SSE is not a full-output source.
+        this.pendingTerminalOutput.set(delta.sessionId, { ownerSessionId });
         if (this.terminalOutputTimer)
             return;
         this.terminalOutputTimer = setTimeout(() => this.flushTerminalOutput(), TERMINAL_OUTPUT_FLUSH_MS);
@@ -1746,12 +1873,12 @@ export class WebRepl {
     }
     flushTerminalOutput() {
         this.terminalOutputTimer = undefined;
-        if (!this.pendingTerminalOutput.size)
-            return;
-        const updates = [...this.pendingTerminalOutput.entries()].map(([sessionId, output]) => ({ sessionId, ...output }));
+        const ownerSessionId = this.runtime.engine.snapshot().session?.sessionId;
+        const updates = [...this.pendingTerminalOutput.entries()].filter(([, output]) => output.ownerSessionId === ownerSessionId).map(([sessionId, output]) => ({ sessionId, ...output, invalidated: true }));
         this.pendingTerminalOutput.clear();
-        for (const subscriber of this.subscribers)
-            this.send(subscriber, "terminal.output", { updates });
+        if (updates.length)
+            for (const subscriber of this.subscribers)
+                this.send(subscriber, "terminal.output", { updates });
     }
     broadcastSync() {
         this.discardPendingDeltaOperations();
@@ -1802,10 +1929,38 @@ async function route(req, res, router) {
             const body = await readJsonBody(req);
             return sendJson(res, await router.requestClientReload(body));
         }
+        if (["/api/tool-call-detail", "/api/terminal-output", "/api/agent-content"].includes(url.pathname) && !allowToolDetailRequest(req.headers.origin, req.headers.host, req.headers["sec-fetch-site"])) {
+            return sendJson(res, { error: "详情访问被拒绝" }, 403);
+        }
         const scope = webRuntimeScopeFromUrl(url);
         const repl = await router.get(scope);
         if (req.method === "GET" && url.pathname === "/events")
             return repl.subscribe(res, router.clientInfo());
+        if (req.method === "GET" && url.pathname === "/api/tool-call-detail") {
+            res.setHeader("Cache-Control", "no-store");
+            const detail = await repl.toolCallDetail(url.searchParams.get("sessionId") ?? "", url.searchParams.get("toolUseId") ?? "", url.searchParams.get("messageId") ?? undefined);
+            if (!detail)
+                return sendJson(res, { error: "调用详情不可获取或无权访问" }, 404);
+            return sendJson(res, detail);
+        }
+        if (req.method === "GET" && url.pathname === "/api/agent-content") {
+            res.setHeader("Cache-Control", "no-store");
+            const refresh = url.searchParams.get("refresh");
+            if (refresh !== null && refresh !== "true" && refresh !== "false")
+                return sendJson(res, { error: "代理详情参数无效" }, 404);
+            const page = await repl.agentContent(url.searchParams.get("sessionId") ?? "", url.searchParams.get("view") ?? "timeline", {
+                taskId: url.searchParams.get("taskId") ?? "", runGeneration: Number(url.searchParams.get("runGeneration")),
+                ...(url.searchParams.has("cursor") ? { cursor: url.searchParams.get("cursor") } : {}),
+                ...(url.searchParams.has("pageChars") ? { pageChars: Number(url.searchParams.get("pageChars")) } : {}),
+                ...(url.searchParams.has("refresh") ? { refresh: url.searchParams.get("refresh") === "true" } : {}),
+            });
+            return page ? sendJson(res, page) : sendJson(res, { error: "代理内容不可获取或无权访问" }, 404);
+        }
+        if (req.method === "GET" && url.pathname === "/api/terminal-output") {
+            res.setHeader("Cache-Control", "no-store");
+            const page = repl.terminalOutput(url.searchParams.get("sessionId") ?? "", url.searchParams.get("runId") ?? "", url.searchParams.get("stream") ?? "stdout", Number(url.searchParams.get("offset") ?? 0), Number(url.searchParams.get("limitBytes") ?? 65536));
+            return page ? sendJson(res, page) : sendJson(res, { error: "终端输出不可获取或无权访问" }, 404);
+        }
         if (req.method === "GET" && url.pathname === "/api/state")
             return sendJson(res, repl.snapshot(true));
         if (req.method === "GET" && url.pathname === "/api/runtime-context")
@@ -2727,13 +2882,19 @@ function formatToolUse(toolUse) {
     return { kind: "tool", toolName: toolUse.name, toolPresentation, toolUseId: toolUse.id, title: toolPresentation.label, bodyTitle: summary.bodyTitle, text: summary.text, toolDisplay: buildToolUseDisplay(toolUse.name, toolUse.input), previewStyle: "summary", presentationLevel, collapsible: true };
 }
 function formatToolResultLine(toolName, output, ok, presentToolResult) {
+    // Hidden fallback reports in historical agent payloads must not enter line.text
+    // even when the frontend suppresses the ordinary result preview.
+    const authorized = sanitizeAgentToolPayload(toolName, output);
+    if (toolName.startsWith("subagent_"))
+        output = authorized.value;
     const presentation = normalizeToolResultPresentation(presentToolResult?.(toolName, output, ok));
     const resources = presentation?.resources ?? toolResources(output);
     const formatted = resources?.length
         ? { text: ok ? "资源已准备好。" : "资源准备失败。", full: true, bodyTitle: ok ? "资源已就绪" : "资源准备失败" }
-        : formatToolResult(toolName, output, ok);
+        : formatToolResult(toolName, toolName.startsWith("subagent_") ? redactToolDetail(output) : output, ok);
     return {
         kind: ok ? "tool" : "error",
+        toolError: ok ? undefined : toolErrorText(output, ok).slice(0, 2000),
         toolName,
         toolPresentation: toolPresentationForSource(toolName),
         title: presentation?.title ?? toolTitle(toolName, "finished"),
@@ -2920,12 +3081,16 @@ function normalizeToolDisplay(display) {
     const visibleText = new Set([subject, purpose].filter((value) => Boolean(value)).map(normalizeDisplayText));
     const facts = display.facts.filter((fact) => {
         const normalized = normalizeDisplayText(fact.value);
-        if (!normalized || visibleText.has(normalized))
+        const identity = `${fact.label}\0${normalized}`;
+        if (!normalized || visibleText.has(identity))
             return false;
-        visibleText.add(normalized);
+        visibleText.add(identity);
         return true;
     });
     const previews = display.previews.filter((preview) => {
+        // Keep identical nonempty streams, but never render empty output panels.
+        if (/^(stdout|stderr)(?:$|[（ ·])/.test(preview.label ?? ""))
+            return !!preview.content.trim();
         const normalized = normalizeDisplayText(preview.content);
         if (!normalized || visibleText.has(normalized))
             return false;
@@ -2959,8 +3124,10 @@ function buildToolUseDisplay(toolName, input) {
     }
     else if (toolName === "expose_downloads")
         pushToolFact(facts, "文件", arrayLabel(data.paths), true);
-    else if (toolName === "subagent_message")
-        pushToolFact(facts, "接收方", data.target);
+    else if (toolName === "subagent_message") {
+        if (typeof data.message === "string" && data.message.trim())
+            previews.push({ kind: "text", content: data.message });
+    }
     else if (toolName.startsWith("subagent_"))
         pushToolFact(facts, "任务", data.task_id, true);
     else if (toolName.startsWith("secret_")) {
@@ -2974,7 +3141,7 @@ function buildToolUseDisplay(toolName, input) {
     return normalizeToolDisplay({ subject, purpose, facts, previews });
 }
 function buildToolResultDisplay(toolName, output, ok) {
-    const data = isRecord(output) ? output : {};
+    const data = toolName.startsWith("subagent_") ? subagentHeader(output) : isRecord(output) ? output : {};
     const facts = [];
     const previews = [];
     let subject = toolDisplaySubject(toolName, data);
@@ -2987,13 +3154,8 @@ function buildToolResultDisplay(toolName, output, ok) {
         subject = undefined;
         purpose = stringValue(data.description);
         pushToolPreview(previews, "命令", "code", data.command);
-        const outputText = [stringValue(data.stdout), stringValue(data.stderr)].filter(Boolean).join("\n");
-        if (outputText)
-            pushToolPreview(previews, data.stderr ? "输出 / 错误" : "输出", "code", outputText);
-        if (data.timed_out && !outputText)
-            pushToolFact(facts, "状态", "命令执行超时", false, "warning");
-        else if ((!ok || (typeof data.exit_code === "number" && data.exit_code !== 0)) && !outputText)
-            pushToolFact(facts, "状态", `退出码 ${data.exit_code ?? "未知"}`, false, "danger");
+        previews.push(...terminalPreviews(data));
+        facts.push(...terminalFacts(data));
     }
     else if (toolName === "file_search") {
         subject = stringValue(data.query) || stringValue(data.grepPath) || stringValue(data.path);
@@ -3016,7 +3178,7 @@ function buildToolResultDisplay(toolName, output, ok) {
     else if (toolName === "image_create") {
         subject = stringValue(data.semanticName);
         pushToolFact(facts, "图片", `${numberValue(data.returnedImages) ?? arrayLength(data.images)} 张`);
-        pushToolFact(facts, "尺寸", data.size);
+        pushToolFact(facts, "请求尺寸", data.size === "auto" ? "auto（自动策略）" : data.size);
     }
     else if (toolName === "image_inspect") {
         subject = arrayLabel(data.imageRefs);
@@ -3026,6 +3188,9 @@ function buildToolResultDisplay(toolName, output, ok) {
     }
     else if (toolName.startsWith("subagent_") || toolName === "subagent_run") {
         subject = stringValue(data.description) || stringValue(data.task_id) || stringValue(data.agent_id);
+        facts.push(...subagentStatusFacts(toolName, output, ok));
+        pushToolFact(facts, "轮次", data.run_generation);
+        pushToolFact(facts, "待交付", data.pending_messages);
     }
     else if (toolName === "subagent_message") {
         subject = stringValue(data.target);
@@ -3209,21 +3374,8 @@ function diffLineMarker(line) {
 function isExecOutput(value) {
     return isRecord(value) && typeof value.command === "string" && typeof value.duration_ms === "number";
 }
-function formatExecToolResult(output, ok) {
-    const status = output.status === "running" ? "运行中" : output.timed_out ? "已超时" : ok ? "已完成" : "执行失败";
-    const description = typeof output.description === "string" ? output.description.trim() : "";
-    const lines = [description ? `目的：${description}` : "执行命令", `状态：${status}`, `耗时：${output.duration_ms}ms`];
-    if (output.status === "running" && typeof output.session_id === "string")
-        lines.push(`会话：${output.session_id}`);
-    const stdout = typeof output.stdout === "string" ? output.stdout.replace(/\s+$/u, "") : "";
-    const stderr = typeof output.stderr === "string" ? output.stderr.replace(/\s+$/u, "") : "";
-    if (stdout)
-        lines.push("输出：", stdout);
-    if (stderr)
-        lines.push("错误：", stderr);
-    if (!stdout && !stderr)
-        lines.push(ok ? "无输出。" : "没有捕获到输出。");
-    return lines.join("\n");
+function formatExecToolResult(output, _ok) {
+    return terminalResultText(output);
 }
 function formatImageGenerationToolResult(output, ok) {
     const error = typeof output.error === "string" ? output.error : undefined;