neoctl 0.2.45 → 0.2.47

package/dist/web/index.js

@@ -1,4 +1,10 @@
 #!/usr/bin/env node
+import { applyToolInputChanges } from "../model/tool-input-stream.js";
+import { toolActivity } from "./tool-activity.js";
+import { toolObservationResult } from "./tool-observation-result.js";
+import { DemoMode, DEMO_MARKER, DEMO_PROMPT } from "./demo-mode.js";
+import { DemoTools } from "./demo-tools.js";
+import { createTextMessage } from "../types/messages.js";
 import { imageResultMetadata } from "./image-result-metadata.js";
 import { subagentHeader, subagentStatusFacts } from "./status-semantics.js";
 import { handlePromptConfigRequest } from "./prompt-config-protocol.js";
@@ -26,6 +32,7 @@ import { ExecProcessManager } from "../tools/builtins/exec-process-manager.js";
 import { listDirectoryTool, readFileTool } from "../tools/builtins/filesystem-tools.js";
 import { grepTool } from "../tools/builtins/grep-tool.js";
 import { searchTool } from "../tools/builtins/search-tool.js";
+import { createFrameworkFeedbackTool, FrameworkFeedbackStore } from "../tools/builtins/framework-feedback-tool.js";
 import { planTool } from "../tools/builtins/plan-tool.js";
 import { createOpenAIImageGenerationTool } from "../tools/builtins/image-generation-tool.js";
 import { createLoadImageTool } from "../tools/builtins/image-loader-tool.js";
@@ -165,6 +172,8 @@ export async function createWebRuntime(options = {}) {
     if (modelConfig?.provider === "openai")
         registerTool(createOpenAIImageGenerationTool(), { source: "builtin" });
     registerTool(planTool, { source: "builtin" });
+    const frameworkFeedback = new FrameworkFeedbackStore(options.frameworkFeedbackDir);
+    registerTool(createFrameworkFeedbackTool(frameworkFeedback), { source: "builtin" });
     for (const tool of options.externalTools ?? [])
         registerTool(tool, { source: "external" });
     for (const plugin of pluginCatalog) {
@@ -232,6 +241,7 @@ export async function createWebRuntime(options = {}) {
     activateSession({ engine, taskStore });
     const initialMetrics = await engine.contextMetrics();
     runtime = {
+        frameworkFeedback,
         engine,
         appPromptStore,
         communicationLogger,
@@ -526,6 +536,24 @@ function webRuntimeScopeKey(scope) {
 }
 export class WebRepl {
     runtime;
+    demoOptions;
+    pendingContinuation;
+    runControl() {
+        const execution = this.runtime.engine.getExecutionState?.();
+        const resumable = (execution?.status === "paused" || execution?.status === "interrupted")
+            && (!this.activeAbortController || this.activeAbortController.signal.aborted);
+        const waiting = this.pendingContinuation?.engine === this.runtime.engine;
+        return {
+            state: waiting ? "resuming" : resumable ? execution.status : this.busy ? "running" : "idle",
+            canPause: !waiting && !resumable && !this.stoppingRun && !this.immediateSend && Boolean(this.activeAbortController),
+            canResume: resumable && !waiting && !this.immediateSend,
+            reason: execution?.reason,
+            timer: execution?.elapsedMs === undefined ? undefined : {
+                elapsedMs: execution.elapsedMs,
+                running: execution.status === "running" && !waiting,
+            },
+        };
+    }
     agentContentReader = createAgentContentDetailResolver();
     subscribers = new Set();
     eventSequence = 0;
@@ -537,6 +565,7 @@ export class WebRepl {
     lineId = 0;
     assistantLineId;
     thinkingLineId;
+    previousTurnToolId;
     finalizedThinkingLineId;
     liveToolLineIds = new Map();
     activeAbortController;
@@ -544,6 +573,7 @@ export class WebRepl {
     lines;
     status;
     busy = false;
+    compactingSession;
     queuedInput;
     queuedAttachments;
     foregroundRun;
@@ -556,8 +586,91 @@ export class WebRepl {
     runtimeContextPublishQueue = Promise.resolve();
     backgroundSessionRuns = new Map();
     suppressReattachedStreaming = new Set();
-    constructor(runtime) {
+    demoSessions = new WeakMap();
+    demoStatus = new WeakMap();
+    demoMessageQueues = new WeakMap();
+    demoStarting = false;
+    isDemo(engine = this.runtime.engine) {
+        const session = engine.snapshot().session;
+        const key = `${session?.sessionId}:${session?.firstWindowId}`;
+        const cached = this.demoStatus.get(engine);
+        if (cached?.key === key)
+            return cached.active || this.demoSessions.has(engine);
+        if (cached)
+            this.demoSessions.delete(engine);
+        const active = engine.getDisplayEntries().some(entry => entry.type === "message" && entry.message.metadata?.demoMode === DEMO_MARKER);
+        this.demoStatus.set(engine, { key, active });
+        if (active)
+            this.demoSessions.set(engine, null);
+        return active;
+    }
+    async startDemo(expectedSessionId) {
+        const engine = this.runtime.engine;
+        if (!expectedSessionId || expectedSessionId !== engine.snapshot().session?.sessionId)
+            return actionFailure("SESSION_MISMATCH", "会话已切换");
+        if (this.demoStarting || this.isDemo() || this.busy || this.foregroundRun || this.stoppingRun || this.queuedInput !== undefined
+            || this.backgroundTaskCount || engine.getDisplayEntries().length || this.lines.some(line => line.kind !== "system")) {
+            return actionFailure("DEMO_REQUIRES_EMPTY_SESSION", "仅空闲的空会话可以进入演示模式");
+        }
+        // Reserve synchronously before any await: double clicks and concurrent submits cannot start a second run.
+        this.demoStarting = true;
+        this.busy = true;
+        let demo;
+        try {
+            demo = new DemoMode(new DemoTools(this.runtime.tools, this.runtime.taskStore, this.runtime.execProcessManager), this.demoOptions.wait);
+            this.demoSessions.set(engine, demo);
+            const marker = createTextMessage("system", "");
+            marker.isMeta = true;
+            marker.metadata = { demoMode: DEMO_MARKER };
+            await engine.recordDisplayMessage(marker);
+            await demo.backend.prepare(engine.snapshot().session.sessionDir);
+            demo.controller.signal.throwIfAborted();
+            engine.setSimulation(demo);
+            this.startRun(DEMO_PROMPT);
+            return { ok: true };
+        }
+        catch (error) {
+            demo?.stop();
+            this.busy = false;
+            this.broadcastSync();
+            return actionFailure("DEMO_START_FAILED", error instanceof Error ? error.message : String(error));
+        }
+        finally {
+            this.demoStarting = false;
+        }
+    }
+    async recordDemoInput(text, attachments) {
+        const engine = this.runtime.engine;
+        if (!text.trim() && attachments.length === 0)
+            return { ok: true };
+        const previous = this.demoMessageQueues.get(engine) ?? Promise.resolve();
+        const pending = previous.catch(() => undefined).then(async () => {
+            const payload = buildWebPromptPayload(text, attachments);
+            const message = createTextMessage("user", payload.text);
+            if (payload.blocks)
+                message.blocks = payload.blocks;
+            const stored = await engine.recordDisplayMessage(message);
+            if (this.runtime.engine === engine) {
+                renderMessage(stored, line => this.append(line));
+                this.broadcastSync();
+            }
+        });
+        this.demoMessageQueues.set(engine, pending);
+        try {
+            await pending;
+            return { ok: true };
+        }
+        catch (error) {
+            return { ok: false, error: error instanceof Error ? error.message : String(error) };
+        }
+        finally {
+            if (this.demoMessageQueues.get(engine) === pending)
+                this.demoMessageQueues.delete(engine);
+        }
+    }
+    constructor(runtime, demoOptions = {}) {
         this.runtime = runtime;
+        this.demoOptions = demoOptions;
         const lineId = { current: 0 };
         this.lines = initialLines(runtime, lineId);
         this.lineId = lineId.current;
@@ -614,7 +727,7 @@ export class WebRepl {
             redact: value => this.runtime.engine.redactDisplayValue(value),
         }, request);
     }
-    terminalOutput(sessionId, runId, stream, offset, limitBytes) {
+    terminalOutput(sessionId, runId, stream, offset, limitBytes, tail = false) {
         const session = this.runtime.engine.snapshot().session;
         if (!session?.sessionDir || !sessionId || sessionId !== session.sessionId || !runId || !["stdout", "stderr"].includes(stream))
             return undefined;
@@ -624,7 +737,7 @@ export class WebRepl {
         const registered = manager.registerOwnerSession(sessionId, session.sessionDir);
         if (!registered.ok)
             return undefined;
-        const page = manager.readOutput(sessionId, runId, { stream: stream, offset, limitBytes });
+        const page = manager.readOutput(sessionId, runId, { stream: stream, offset, limitBytes, tail });
         // Cursor addresses stored bytes, not the possibly additionally redacted response length.
         return page.ok ? this.runtime.engine.redactDisplayValue({ sessionId, runId, ...page.value }) : undefined;
     }
@@ -640,7 +753,9 @@ export class WebRepl {
         return {
             lines: this.lines.map(line => line.toolError ? { ...line, toolError: this.runtime.engine.redactDisplayValue?.(line.toolError) ?? line.toolError } : line),
             status: this.timedStatus(),
-            busy: this.busy,
+            busy: this.runControl().canResume ? false : this.busy,
+            runControl: this.runControl(),
+            demoMode: this.isDemo(),
             queuedInput: this.queuedInput,
             backgroundTaskCount: backgroundTasks.length,
             backgroundTasks,
@@ -894,6 +1009,12 @@ export class WebRepl {
         this.publishRuntimeContext();
     }
     async submit(text, attachments = []) {
+        if (this.runControl().canResume && (!text.trimStart().startsWith("/") || !text.trim()))
+            return this.continueRun(text, attachments);
+        if (this.pendingContinuation)
+            return { ok: false, error: "续接请求已接收，请勿重复发送" };
+        if (this.isDemo())
+            return this.recordDemoInput(text, attachments);
         if (this.stoppingRun || this.immediateSend)
             return { ok: false, error: "正在停止上一轮请求，请稍后发送" };
         const trimmed = text.trim();
@@ -916,6 +1037,14 @@ export class WebRepl {
         return { ok: true };
     }
     async submitImmediately(text, attachments = []) {
+        if (this.runControl().canResume) {
+            const result = this.continueRun(text, attachments);
+            return result.ok ? { ok: true, interrupted: false } : result;
+        }
+        if (this.isDemo()) {
+            const result = await this.recordDemoInput(text, attachments);
+            return result.ok ? { ok: true, interrupted: false } : result;
+        }
         if (this.immediateSend)
             return { ok: false, error: "正在发送，请勿重复提交" };
         if (this.stoppingRun)
@@ -948,8 +1077,8 @@ export class WebRepl {
         this.queuedInput = mergeWebQueuedInput(this.queuedInput, text);
         this.queuedAttachments = [...(this.queuedAttachments ?? []), ...attachments].slice(0, 20);
     }
-    startRun(text, attachments = []) {
-        const run = this.handleCommandOrPrompt(text, attachments).catch((error) => {
+    startRun(text, attachments = [], continuationOnly = false) {
+        const run = this.handleCommandOrPrompt(text, attachments, continuationOnly).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 });
@@ -1013,6 +1142,7 @@ export class WebRepl {
         this.runtime.usage.reset();
         this.status = initialStatus(this.runtime, metrics);
         const lineId = { current: 0 };
+        this.previousTurnToolId = undefined;
         this.lines = initialLines(this.runtime, lineId);
         this.lineId = lineId.current;
         this.assistantLineId = undefined;
@@ -1186,9 +1316,28 @@ export class WebRepl {
     }
     async compactSession() {
         const engine = this.runtime.engine;
+        if (this.isDemo())
+            return actionFailure("DEMO_SCRIPTED", "演示会话由后台安排压缩");
+        if (this.compactingSession === engine)
+            return actionFailure("COMPACTION_IN_PROGRESS", "Context compaction is already running");
+        const showProgress = !this.busy;
+        const runToken = this.foregroundRunToken;
+        const controller = showProgress ? new AbortController() : undefined;
+        if (controller)
+            this.activeAbortController = controller;
+        let finishForeground;
+        const foreground = showProgress ? new Promise(resolve => { finishForeground = resolve; }) : undefined;
+        if (foreground)
+            this.foregroundRun = foreground;
+        if (showProgress) {
+            this.compactingSession = engine;
+            this.busy = true;
+            this.setStatus({ ...this.status, phase: "compacting", detail: "manualcompact: generating context summary", activityTick: this.status.activityTick + 1 });
+        }
         try {
-            const result = await engine.updateSessionSettings({ compact: true });
-            if (this.runtime.engine === engine) {
+            // An idle click executes now through the settings barrier, not the chat/input queue.
+            const result = await engine.updateSessionSettings({ compact: true }, { abortSignal: controller?.signal });
+            if (this.runtime.engine === engine && this.foregroundRunToken === runToken) {
                 if (result.compaction?.report)
                     this.appendCompaction(result.compaction.report);
                 if (!result.deferred)
@@ -1200,6 +1349,26 @@ export class WebRepl {
         catch (error) {
             return actionFailure("COMPACTION_FAILED", error instanceof Error ? error.message : String(error));
         }
+        finally {
+            if (controller && this.activeAbortController === controller)
+                this.activeAbortController = undefined;
+            if (this.compactingSession === engine)
+                this.compactingSession = undefined;
+            if (this.foregroundRun === foreground)
+                this.foregroundRun = undefined;
+            finishForeground?.();
+            if (showProgress && this.runtime.engine === engine && this.foregroundRunToken === runToken) {
+                this.busy = false;
+                this.setStatus({ ...this.status, phase: "ready", detail: undefined, activityTick: this.status.activityTick + 1 });
+                const queued = this.queuedInput;
+                const attachments = this.queuedAttachments ?? [];
+                if (queued !== undefined) {
+                    this.queuedInput = undefined;
+                    this.queuedAttachments = undefined;
+                    this.startRun(queued, attachments);
+                }
+            }
+        }
     }
     loginForm(providerValue) {
         const provider = parseLoginProvider(providerValue);
@@ -1244,9 +1413,72 @@ export class WebRepl {
         this.setStatus({ ...this.status, metrics, activityTick: this.status.activityTick + 1 });
         this.publishRuntimeContext();
     }
+    async listFrameworkFeedback(page, pageSize) {
+        if (!this.runtime.frameworkFeedback)
+            throw new Error("Framework feedback storage unavailable");
+        return this.runtime.frameworkFeedback.list(page, pageSize);
+    }
+    async deleteFrameworkFeedback(id) {
+        if (typeof id !== "string" || !/^\d{13}-[a-f0-9-]{36}$/.test(id))
+            return actionFailure("INVALID_REQUEST", "建议编号无效");
+        try {
+            if (!this.runtime.frameworkFeedback)
+                throw new Error("unavailable");
+            return { ok: true, deleted: await this.runtime.frameworkFeedback.delete(id) };
+        }
+        catch {
+            return actionFailure("FEEDBACK_DELETE_FAILED", "删除失败，请重试");
+        }
+    }
+    pauseRun() {
+        if (this.runControl().canResume)
+            return { ok: true };
+        if (!this.runControl().canPause)
+            return actionFailure("INVALID_REQUEST", "当前没有可暂停的会话执行");
+        this.runtime.engine.markExecutionPaused();
+        const queuedText = this.queuedInput;
+        const queuedAttachments = this.queuedAttachments;
+        // Do not await cooperative cancellation: the UI must stop immediately.
+        void this.stopForegroundRun("用户暂停了会话").catch(() => this.broadcastSync());
+        this.queuedInput = queuedText;
+        this.queuedAttachments = queuedAttachments;
+        this.status = { ...this.status, phase: "ready", detail: "paused", currentTool: undefined, retryCooldownUntil: undefined };
+        this.broadcastSync();
+        return { ok: true };
+    }
+    continueRun(text = "", attachments = []) {
+        if (!this.runControl().canResume)
+            return actionFailure("INVALID_REQUEST", "没有可恢复的执行，或续接请求已经提交");
+        const useQueue = !text.trim() && attachments.length === 0 && this.queuedInput !== undefined;
+        const request = { engine: this.runtime.engine,
+            text: text || (useQueue ? this.queuedInput : ""),
+            attachments: useQueue ? this.queuedAttachments ?? [] : attachments };
+        this.queuedInput = undefined;
+        this.queuedAttachments = undefined;
+        this.pendingContinuation = request;
+        this.broadcastSync();
+        // Accept immediately, but never overlap two queries on the same mutable engine.
+        void (async () => {
+            try {
+                await this.stoppingRun;
+                await this.foregroundRun;
+                if (this.pendingContinuation !== request || this.runtime.engine !== request.engine)
+                    return;
+                this.pendingContinuation = undefined;
+                this.startRun(request.text, request.attachments, !request.text.trim() && request.attachments.length === 0);
+            }
+            finally {
+                if (this.pendingContinuation === request)
+                    this.pendingContinuation = undefined;
+                this.broadcastSync();
+            }
+        })().catch(error => this.append({ kind: "error", text: error instanceof Error ? error.message : String(error) }));
+        return { ok: true };
+    }
     async interrupt() {
         if (this.immediateSend)
             await this.immediateSend;
+        this.demoSessions.get(this.runtime.engine)?.stop();
         const interrupted = await this.stopForegroundRun("Interrupted from neo web");
         return { ok: true, interrupted };
     }
@@ -1261,6 +1493,10 @@ export class WebRepl {
     append(line, streaming = false) {
         const id = ++this.lineId;
         const nextLine = { id, ...line };
+        if (line.activity && line.toolName && line.toolUseId && !line.image) {
+            nextLine.connectPreviousTool = this.previousTurnToolId !== undefined;
+            this.previousTurnToolId = id;
+        }
         this.lines.push(nextLine);
         if (streaming)
             this.broadcastDelta({ type: "line.append", line: nextLine });
@@ -1283,6 +1519,9 @@ export class WebRepl {
         this.broadcastSync();
     }
     replaceLine(id, patch) {
+        const previous = this.lines.find(line => line.id === id);
+        if (previous?.activity && patch.titleStatus)
+            patch.activity = { ...previous.activity, phase: patch.titleStatus === "success" ? "completed" : "failed" };
         this.lines = this.lines.map((line) => line.id === id ? { ...line, ...patch } : line);
         this.broadcastSync();
     }
@@ -1431,6 +1670,7 @@ export class WebRepl {
             signal: terminal.signal,
             terminationReason: terminal.termination_reason,
             outputAvailability: terminal.output_ref.availability,
+            outputRevision: terminal.output_ref.streams,
         }));
         const sessionTasks = [...this.backgroundSessionRuns.values()].map((run) => ({
             kind: "session",
@@ -1451,6 +1691,14 @@ export class WebRepl {
             .sort((left, right) => createdAtTime(right.createdAt) - createdAtTime(left.createdAt));
     }
     async detachRunningForeground(reason) {
+        if (this.pendingContinuation || this.stoppingRun)
+            throw new Error("上一轮请求正在取消，请稍后切换会话");
+        if (this.demoStarting)
+            throw new Error("演示模式正在启动");
+        if (this.isDemo() && this.busy) {
+            this.demoSessions.get(this.runtime.engine)?.stop();
+            return this.stopForegroundRun(reason);
+        }
         if (!this.busy)
             return false;
         const snapshot = this.runtime.engine.snapshot().session;
@@ -1512,6 +1760,12 @@ export class WebRepl {
     finalizeLiveLine(id) {
         if (id === undefined)
             return;
+        const previous = this.lines.find(line => line.id === id);
+        if (previous?.activity && ["generating", "queued", "running"].includes(previous.activity.phase)) {
+            const activity = { ...previous.activity, phase: previous.titleStatus === "success" ? "completed" : previous.titleStatus === "failure" ? "failed" : "interrupted" };
+            this.lines = this.lines.map(line => line.id === id ? { ...line, activity } : line);
+            this.queueDeltaOperation({ type: "line.patch", id, patch: { activity } });
+        }
         this.lines = this.lines.map((line) => line.id === id ? { ...line, live: false } : line);
         this.queueDeltaOperation({ type: "line.patch", id, patch: { live: false } });
     }
@@ -1531,6 +1785,8 @@ export class WebRepl {
     cancelLiveToolLines(reason) {
         for (const id of this.liveToolLineIds.values()) {
             const line = this.lines.find((item) => item.id === id);
+            if (line?.activity)
+                this.patchLiveToolLine(line.toolUseId, { activity: { ...line.activity, phase: "interrupted" } });
             const steps = (line?.toolStream?.steps ?? []).map((step) => step.status === "running" ? { ...step, status: "failed", phase: "cancelled" } : step);
             this.lines = this.lines.map((item) => item.id === id ? { ...item, live: false, kind: "error", titleStatus: "failure", bodyTitle: reason, toolStream: { ...item.toolStream, phase: "cancelled", message: reason, steps } } : item);
             this.queueDeltaOperation({ type: "line.patch", id, patch: { live: false, kind: "error", titleStatus: "failure", bodyTitle: reason, toolStream: { ...line?.toolStream, phase: "cancelled", message: reason, steps } } });
@@ -1631,7 +1887,12 @@ export class WebRepl {
         else {
             stream.message = progress.message;
         }
-        this.patchLiveToolLine(event.toolUse.id, { toolStream: stream });
+        const data = progress.data;
+        const observation = data && typeof data.task_id === "string" && Number.isSafeInteger(data.run_generation)
+            ? { ...line.observation, task_id: data.task_id, run_generation: data.run_generation }
+            : data && typeof data.session_id === "string" && ["terminal.started", "terminal.output.delta"].includes(String(data.type)) && ["terminal_run", "terminal_control"].includes(event.toolUse.name)
+                ? { ...line.observation, session_id: data.session_id, status: "running", command: typeof data.command === "string" ? data.command : line.observation?.command } : line.observation;
+        this.patchLiveToolLine(event.toolUse.id, { toolStream: stream, observation });
     }
     applyAvailableToolResult(event) {
         const liveLineId = this.liveToolLineIds.get(event.toolUse.id);
@@ -1663,19 +1924,28 @@ export class WebRepl {
         }
     }
     handleEvent(event) {
+        // Model lifecycle defines membership only. The frontend owns the fixed
+        // two-second playback and must not be interrupted by the next request.
+        if (event.type === "state" && event.phase === "calling_model")
+            this.previousTurnToolId = undefined;
         this.reduce(event);
         if (event.type === "timing.updated") {
             if (event.timing.kind === "tool") {
                 const line = this.lines.find(item => item.timing?.id === event.timing.id)
                     ?? this.lines.find(item => item.id === this.liveToolLineIds.get(event.timing.toolUseId));
                 if (line) {
-                    this.lines = this.lines.map(item => item.id === line.id ? { ...item, timing: event.timing } : item);
-                    this.queueDeltaOperation({ type: "line.patch", id: line.id, patch: { timing: event.timing } });
+                    const activity = line.activity && event.timing.status === "running" ? { ...line.activity, phase: "running" } : line.activity;
+                    this.lines = this.lines.map(item => item.id === line.id ? { ...item, timing: event.timing, activity } : item);
+                    this.queueDeltaOperation({ type: "line.patch", id: line.id, patch: { timing: event.timing, activity } });
                 }
             }
             this.queueDeltaStatus();
             return;
         }
+        if (event.type === "message" && event.message.metadata?.loadedImages === true && typeof event.message.metadata.sourceToolUseId === "string") {
+            renderObservedImages(event.message, line => this.append(line));
+            return;
+        }
         if (event.type === "message" && this.matchesPendingUserImageEcho(event.message)) {
             const messageId = this.pendingUserImageEchoMessageId;
             this.pendingUserImageEchoIds = undefined;
@@ -1684,7 +1954,35 @@ export class WebRepl {
             this.broadcastSync();
             return;
         }
-        if (event.type === "tool_call.started" || event.type === "tool_call.delta") {
+        if (event.type === "tool_call.started" || event.type === "tool_call.input") {
+            let id = this.liveToolLineIds.get(event.callId);
+            let previous = this.lines.find(line => line.id === id);
+            const name = event.name || previous?.toolName || "tool";
+            if (id === undefined) {
+                const activity = { phase: "generating", input: {} };
+                id = this.append({ ...formatToolUse({ id: event.callId, name, input: {} }), activity, live: true });
+                this.liveToolLineIds.set(event.callId, id);
+                previous = this.lines.find(line => line.id === id);
+            }
+            if (previous?.toolName !== name && name !== "tool")
+                this.patchLiveToolLine(event.callId, { toolName: name, title: toolTitle(name, "running"), toolPresentation: toolPresentationForSource(name) });
+            if (event.type === "tool_call.input") {
+                const activity = { phase: "generating", input: applyToolInputChanges(previous?.activity?.input || {}, event.changes), truncated: event.truncated };
+                this.lines = this.lines.map(line => line.id === id ? { ...line, activity } : line);
+                this.queueDeltaOperation({ type: "line.activity.input", id, changes: event.changes, truncated: event.truncated });
+            }
+            this.queueDeltaStatus();
+            return;
+        }
+        if (event.type === "tool_call.ready") {
+            const patch = { ...formatToolUse(event.toolUse), activity: toolActivity(event.toolUse.input, "queued"), live: true };
+            if (this.liveToolLineIds.has(event.toolUse.id))
+                this.patchLiveToolLine(event.toolUse.id, patch);
+            else
+                this.liveToolLineIds.set(event.toolUse.id, this.append(patch));
+            return;
+        }
+        if (event.type === "tool_call.delta") {
             this.queueDeltaStatus();
             return;
         }
@@ -1696,6 +1994,10 @@ export class WebRepl {
             this.broadcastSync();
             return;
         }
+        if (event.type === "assistant.output.done") {
+            this.queueDeltaStatus();
+            return;
+        }
         if (event.type === "assistant.delta") {
             this.finalizeThinkingLine();
             const id = this.assistantLineId ?? this.append({ kind: "assistant", text: "", live: true }, true);
@@ -1788,8 +2090,12 @@ export class WebRepl {
             this.finalizeLiveLine(this.assistantLineId);
             this.finalizeThinkingLine();
             this.assistantLineId = undefined;
-            const id = this.append({ ...formatToolUse(event.toolUse), live: true });
-            this.liveToolLineIds.set(event.toolUse.id, id);
+            const patch = { ...formatToolUse(event.toolUse), activity: toolActivity(event.toolUse.input, "queued"), live: true };
+            const existing = this.liveToolLineIds.get(event.toolUse.id);
+            if (existing === undefined)
+                this.liveToolLineIds.set(event.toolUse.id, this.append(patch));
+            else
+                this.patchLiveToolLine(event.toolUse.id, patch);
             return;
         }
         if (event.type === "tool.finished") {
@@ -1818,7 +2124,7 @@ export class WebRepl {
             .map((block) => block.imageId);
         return imageIds.length === pending.length && imageIds.every((imageId, index) => imageId === pending[index]);
     }
-    async handleCommandOrPrompt(text, attachments = []) {
+    async handleCommandOrPrompt(text, attachments = [], continuationOnly = false) {
         const command = parseReplCommand(text);
         if (command.type === "exit") {
             this.append(systemLine("neo web server is still running. Close this tab or stop the server process with Ctrl+C."));
@@ -1918,7 +2224,8 @@ export class WebRepl {
         }
         const promptPayload = buildWebPromptPayload(command.text, attachments);
         const optimisticMessageId = `web-user-${this.lineId + 1}`;
-        this.append({ kind: "user", text: promptPayload.displayText, messageId: optimisticMessageId });
+        if (!continuationOnly)
+            this.append({ kind: "user", text: promptPayload.displayText, messageId: optimisticMessageId });
         const optimisticImageIds = (promptPayload.blocks ?? [])
             .filter((block) => block.type === "image" && typeof block.imageId === "string")
             .map((block) => block.imageId);
@@ -1932,12 +2239,14 @@ export class WebRepl {
         this.setStatus({ ...this.status, phase: "running", detail: "working", modelOutput: undefined, usage: undefined, streamedOutputTokens: 0, inputTokenUpdatedAt: undefined, outputTokenUpdatedAt: undefined, retryCooldownUntil: undefined });
         const engine = this.runtime.engine;
         try {
-            for await (const event of engine.sendUserText(promptPayload.text, {
+            const options = {
                 abortSignal: abortController.signal,
                 blocks: promptPayload.blocks,
                 displayText: promptPayload.displayText,
                 stopAfterTurn: () => this.queuedInput !== undefined,
-            })) {
+            };
+            const stream = continuationOnly ? engine.continueExecution(options) : engine.sendUserText(promptPayload.text, options);
+            for await (const event of stream) {
                 if (this.foregroundRunToken !== runToken)
                     continue;
                 if (this.runtime.engine !== engine)
@@ -1960,6 +2269,7 @@ export class WebRepl {
             }
         }
         finally {
+            this.demoSessions.get(engine)?.backend.stop();
             if (this.foregroundRunToken !== runToken)
                 return;
             if (this.runtime.engine !== engine)
@@ -1970,6 +2280,11 @@ export class WebRepl {
             this.finalizeForegroundView();
             this.pendingUserImageEchoIds = undefined;
             this.pendingUserImageEchoMessageId = undefined;
+            if (engine.getExecutionState?.()?.status === "interrupted") {
+                this.setBusy(false);
+                this.setStatus({ ...this.status, phase: "ready", detail: "interrupted", retryCooldownUntil: undefined });
+                return;
+            }
             const queuedText = this.queuedInput;
             const queuedAttach = this.queuedAttachments;
             this.queuedInput = undefined;
@@ -2170,11 +2485,16 @@ export function compactLineOperations(operations) {
             previous.text += operation.text;
             continue;
         }
+        if (operation.type === "line.activity.input" && previous?.type === "line.activity.input" && previous.id === operation.id) {
+            previous.changes.push(...operation.changes);
+            previous.truncated = operation.truncated;
+            continue;
+        }
         if (operation.type === "line.patch" && previous?.type === "line.patch" && previous.id === operation.id) {
             previous.patch = { ...previous.patch, ...operation.patch };
             continue;
         }
-        compacted.push(operation.type === "line.patch" ? { ...operation, patch: { ...operation.patch } } : { ...operation });
+        compacted.push(operation.type === "line.patch" ? { ...operation, patch: { ...operation.patch } } : operation.type === "line.activity.input" ? { ...operation, changes: [...operation.changes] } : { ...operation });
     }
     return compacted;
 }
@@ -2232,7 +2552,7 @@ export async function handleWebRequest(req, res, router) {
         }
         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));
+            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), url.searchParams.get("tail") === "true");
             return page ? sendJson(res, page) : sendJson(res, { error: "终端输出不可获取或无权访问" }, 404);
         }
         if (req.method === "GET" && url.pathname === "/api/state")
@@ -2263,6 +2583,19 @@ export async function handleWebRequest(req, res, router) {
                 ? await workspaceRepl.deleteWorkspaceDirectory(body.path)
                 : actionFailure("CWD_NOT_CONFIGURED", "workspace navigation is not configured"));
         }
+        if (req.method === "POST" && url.pathname === "/api/framework-feedback/delete") {
+            const body = await readJsonBody(req);
+            return sendJson(res, await repl.deleteFrameworkFeedback(body?.id));
+        }
+        if (req.method === "GET" && url.pathname === "/api/framework-feedback") {
+            res.setHeader("Cache-Control", "no-store");
+            try {
+                return sendJson(res, await repl.listFrameworkFeedback(Number(url.searchParams.get("page") ?? 1), Number(url.searchParams.get("pageSize") ?? 10)));
+            }
+            catch {
+                return sendJson(res, { ok: false, error: "建议加载失败" }, 500);
+            }
+        }
         if (req.method === "GET" && url.pathname === "/api/tools")
             return sendJson(res, repl.globalTools());
         if (req.method === "POST" && url.pathname === "/api/tools/global") {
@@ -2321,6 +2654,8 @@ export async function handleWebRequest(req, res, router) {
             const body = await readJsonBody(req);
             return sendJson(res, await repl.setSessionModel(body.model, body.reasoning));
         }
+        if (req.method === "POST" && url.pathname === "/api/demo")
+            return sendJson(res, await repl.startDemo(url.searchParams.get("sessionId") ?? ""));
         if (req.method === "POST" && url.pathname === "/api/compact")
             return sendJson(res, await repl.compactSession());
         if (req.method === "POST" && url.pathname === "/api/fast-mode") {
@@ -2339,6 +2674,10 @@ export async function handleWebRequest(req, res, router) {
             const body = await readJsonBody(req);
             return sendJson(res, await repl.submitImmediately(String(body.text ?? ""), sanitizeWebAttachments(body.attachments)));
         }
+        if (req.method === "POST" && url.pathname === "/api/run/pause")
+            return sendJson(res, repl.pauseRun());
+        if (req.method === "POST" && url.pathname === "/api/run/continue")
+            return sendJson(res, repl.continueRun());
         if (req.method === "POST" && url.pathname === "/api/interrupt")
             return sendJson(res, await repl.interrupt());
         if (req.method === "POST" && url.pathname === "/api/queue/cancel")
@@ -2479,7 +2818,7 @@ function restoredHistoryLines(runtime) {
         if (line.toolUseId && line.titleStatus && historyToolLineIndexes.has(line.toolUseId)) {
             const index = historyToolLineIndexes.get(line.toolUseId);
             const started = lines[index];
-            lines[index] = { ...line, presentationLevel: mergePresentationLevel(line.presentationLevel, started.presentationLevel), toolDisplay: mergeToolDisplays(line.toolDisplay, started.toolDisplay) };
+            lines[index] = { ...line, activity: started.activity ? { ...started.activity, phase: line.titleStatus === "success" ? "completed" : "failed" } : undefined, presentationLevel: mergePresentationLevel(line.presentationLevel, started.presentationLevel), toolDisplay: mergeToolDisplays(line.toolDisplay, started.toolDisplay) };
             return index + 1;
         }
         lines.push(line);
@@ -2505,6 +2844,10 @@ function restoredHistoryLines(runtime) {
     }
     for (const [entryIndex, entry] of entries.entries()) {
         if (entry.type === "message") {
+            if (entry.message.metadata?.loadedImages === true && typeof entry.message.metadata.sourceToolUseId === "string") {
+                renderObservedImages(entry.message, append);
+                continue;
+            }
             renderMessage(entry.message, append, undefined, {
                 includeToolUseBlocks: true,
                 includeThinkingBlocks: true,
@@ -2520,6 +2863,8 @@ function restoredHistoryLines(runtime) {
         const matches = line.toolUseId ? toolTimings.get(line.toolUseId) : undefined;
         if (matches?.length === 1)
             line.timing = matches[0];
+        if (line.activity && !line.titleStatus)
+            line.activity = { ...line.activity, phase: "interrupted" };
     }
     return lines;
 }
@@ -2675,6 +3020,12 @@ function reduceStatus(status, event) {
         return { ...status, metrics: event.metrics, inputTokenUpdatedAt: event.metrics.estimatedInputTokens !== status.metrics?.estimatedInputTokens ? Date.now() : status.inputTokenUpdatedAt, activityTick: status.activityTick + 1 };
     if (event.type === "usage")
         return { ...status, usage: event.usage, inputTokenUpdatedAt: event.usage.inputTokens !== undefined ? Date.now() : status.inputTokenUpdatedAt, outputTokenUpdatedAt: event.usage.outputTokens !== undefined ? Date.now() : status.outputTokenUpdatedAt, activityTick: status.activityTick + 1 };
+    if (event.type === "assistant.output.done")
+        return status.modelOutput?.kind === "text" ? { ...status, modelOutput: undefined, activityTick: status.activityTick + 1 } : status;
+    if (event.type === "message" && event.message.role === "assistant" && event.message.blocks.some(block => block.type === "text") && status.modelOutput?.kind === "text")
+        return { ...status, modelOutput: undefined, activityTick: status.activityTick + 1 };
+    if (event.type === "assistant.delta" && !event.text)
+        return status;
     if (event.type === "assistant.delta")
         return { ...status, phase: "calling_model", modelOutput: { kind: "text" }, streamedOutputTokens: status.streamedOutputTokens + estimateTokens(event.text), outputTokenUpdatedAt: Date.now(), activityTick: status.activityTick + 1 };
     if (event.type === "thinking.delta")
@@ -3065,6 +3416,15 @@ function renderMessageImages(message, append, messageId = message.id) {
     }
     return rendered;
 }
+function renderObservedImages(message, append) {
+    for (const [index, block] of message.blocks.entries()) {
+        if (block.type !== "image")
+            continue;
+        const line = imageLineForBlock("tool_result", block, message.id, index);
+        if (line)
+            append({ ...line, observationOnly: true, messageId: message.id, parentToolName: "image_inspect", parentToolUseId: message.metadata?.sourceToolUseId });
+    }
+}
 function imageLineForBlock(role, block, messageId, blockIndex) {
     const kind = kindForRole(role);
     if (kind === "meta")
@@ -3150,6 +3510,8 @@ function compactionLine(report, createdAt = new Date().toISOString(), current =
     return {
         kind: "meta",
         title: "Context compaction",
+        presentationLevel: "primary",
+        collapsible: false,
         text: formatCompactionReportSummary(report),
         format: "plain",
         compaction: { ...report, createdAt, current },
@@ -3190,14 +3552,15 @@ function thinkingLine(text, live = false) {
     return { kind: "thinking", title: titleForKind("thinking"), text, previewStyle: "summary", summaryMaxLines: THINKING_SUMMARY_MAX_LINES, live };
 }
 function formatToolUse(toolUse) {
+    const activity = toolActivity(toolUse.input, "running");
     const toolPresentation = toolPresentationForSource(toolUse.name);
     const presentationLevel = toolPresentationLevel(toolUse.name, toolUse.input);
     if (toolUse.name === "plan_update" && isWebPlanPayload(toolUse.input))
-        return { kind: "tool", toolName: toolUse.name, toolPresentation, title: toolPresentation.label, bodyTitle: webPlanBodyTitle(toolUse.input), text: serializeWebPlanPayload(toolUse.input), presentationLevel, collapsible: true };
+        return { kind: "tool", activity, toolName: toolUse.name, toolPresentation, toolUseId: toolUse.id, title: toolPresentation.label, bodyTitle: webPlanBodyTitle(toolUse.input), text: serializeWebPlanPayload(toolUse.input), presentationLevel, collapsible: true };
     if (toolUse.name === "image_create")
-        return { kind: "tool", toolName: toolUse.name, toolPresentation, toolUseId: toolUse.id, title: toolPresentation.label, bodyTitle: "图片模型处理中", text: JSON.stringify(toolUse.input ?? {}, null, 2), format: "plain", previewStyle: "summary", presentationLevel: "primary", collapsible: true };
+        return { kind: "tool", activity, toolName: toolUse.name, toolPresentation, toolUseId: toolUse.id, title: toolPresentation.label, bodyTitle: "图片模型处理中", text: JSON.stringify(toolUse.input ?? {}, null, 2), format: "plain", previewStyle: "summary", presentationLevel: "primary", collapsible: true };
     const summary = summarizeToolUse(toolUse.name, toolUse.input);
-    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 };
+    return { kind: "tool", activity, 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
@@ -3212,6 +3575,7 @@ function formatToolResultLine(toolName, output, ok, presentToolResult) {
         : formatToolResult(toolName, toolName.startsWith("subagent_") ? redactToolDetail(output) : output, ok);
     return {
         kind: ok ? "tool" : "error",
+        observation: toolObservationResult(toolName, output),
         toolError: ok ? undefined : toolErrorText(output, ok).slice(0, 2000),
         toolName,
         toolPresentation: toolPresentationForSource(toolName),