@mindstudio-ai/remy 0.1.266 → 0.1.268

package/dist/headless.js

@@ -1043,7 +1043,6 @@ function extractFrontmatter(content) {
 var DEFAULT_MAX_LINES = 500;
 var readSpecTool = {
   definition: {
-    clearable: true,
     name: "readSpec",
     description: "Read a spec file from src/ with line numbers. Always read a spec file before editing it. Paths are relative to the project root and must start with src/ (e.g., src/app.md, src/interfaces/web.md).",
     inputSchema: {
@@ -1157,7 +1156,6 @@ function acquireFileLock(filePath) {
 // src/tools/spec/writeSpec.ts
 var writeSpecTool = {
   definition: {
-    clearable: true,
     name: "writeSpec",
     description: "Create a new spec file or completely overwrite an existing one in src/. Parent directories are created automatically. Use this for new spec files or full rewrites. For targeted changes to existing specs, use editSpec instead.",
     inputSchema: {
@@ -1295,7 +1293,6 @@ function formatOccurrenceError(count, lines, filePath) {
 // src/tools/spec/editSpec.ts
 var editSpecTool = {
   definition: {
-    clearable: true,
     name: "editSpec",
     description: "Make a targeted find/replace edit to a spec file (src/*.md). old_string must appear exactly once (minor indentation differences are handled automatically); set replace_all to true to replace every occurrence. Read the file with readSpec first so you match the exact text, and include the full enclosing structure rather than an inner fragment. The file's YAML frontmatter (the leading --- \u2026 --- block, which holds required fields like name) is protected \u2014 an edit that would remove or malform it is refused. For a full rewrite, use writeSpec.",
     inputSchema: {
@@ -1400,7 +1397,6 @@ import fs9 from "fs/promises";
 import path6 from "path";
 var listSpecFilesTool = {
   definition: {
-    clearable: false,
     name: "listSpecFiles",
     description: "List all files in the src/ directory (spec files, brand guidelines, interface specs, references). Use this to understand what spec files exist before reading or editing them.",
     inputSchema: {
@@ -1451,7 +1447,6 @@ async function listRecursive(dir) {
 // src/tools/spec/presentPublishPlan.ts
 var presentPublishPlanTool = {
   definition: {
-    clearable: false,
     name: "presentPublishPlan",
     description: "Present a publish changelog to the user for approval. Write a clear markdown summary of what changed since the last deploy. The user will see this in a full-screen view and can approve or dismiss. Call this BEFORE committing or pushing.",
     inputSchema: {
@@ -1476,7 +1471,6 @@ import fs10 from "fs/promises";
 var PLAN_FILE = ".remy-plan.md";
 var writePlanTool = {
   definition: {
-    clearable: false,
     name: "writePlan",
     description: "Write an implementation plan for user approval before making changes. Use this only for large, multi-step changes like new features, new interface types, or when the user explicitly asks to see a plan. Most work should be done autonomously without a plan. Write a clear markdown summary of what you intend to do in plain language \u2014 describe the changes from the user's perspective, not as a list of files and code paths. The plan is displayed standalone in the UI with approve/reject buttons attached. The plan body ends with its last substantive section \u2014 do not write any closing line addressed to the reader. No 'If this lands, I'll start building,' no 'Let me know what to adjust,' no 'Approve when ready,' no trailing horizontal rule with a sign-off. Wrap-up text belongs in your chat message alongside the plan, not in the plan file. If the user asks for revisions, call this tool again with updated content to overwrite the plan.",
     inputSchema: {
@@ -1507,7 +1501,6 @@ import fs11 from "fs/promises";
 var PLAN_FILE2 = ".remy-plan.md";
 var updatePlanStatusTool = {
   definition: {
-    clearable: false,
     name: "updatePlanStatus",
     description: 'Update the status of the current implementation plan. Use when the user approves or rejects the plan via chat (e.g. "looks good, go ahead" or "scrap it"). Approving sets the plan to active so you can begin implementation. Rejecting deletes the plan.',
     inputSchema: {
@@ -1549,7 +1542,6 @@ var updatePlanStatusTool = {
 // src/tools/common/setProjectOnboardingState.ts
 var setProjectOnboardingStateTool = {
   definition: {
-    clearable: false,
     name: "setProjectOnboardingState",
     description: "Advance the project onboarding state. Forward-only: building \u2192 buildComplete \u2192 onboardingFinished. Normally driven by automated actions \u2014 don't call this out of order during a normal build, or you'll skip stages the user hasn't experienced. Exception: if the project has been in `building` for a while, the build is clearly done (the user is iterating on a working app, deploying, etc.), and the user reports the editor seems stuck \u2014 disabled Preview/Spec/Code tabs, no reveal, etc. \u2014 call `setProjectOnboardingState({ state: 'buildComplete' })` to unstick them. `onboardingFinished` is always set by the frontend after the user dismisses the reveal; never call it yourself.",
     inputSchema: {
@@ -1572,7 +1564,6 @@ var setProjectOnboardingStateTool = {
 // src/tools/common/promptUser.ts
 var promptUserTool = {
   definition: {
-    clearable: false,
     name: "promptUser",
     description: 'Ask the user structured questions. Choose type first: "form" for structured intake (5+ questions, takes over screen), "inline" for quick clarifications or confirmations. Blocks until the user responds. Result contains `_dismissed: true` if the user dismisses without answering.',
     inputSchema: {
@@ -1704,7 +1695,6 @@ ${lines.join("\n")}`;
 // src/tools/common/confirmDestructiveAction.ts
 var confirmDestructiveActionTool = {
   definition: {
-    clearable: false,
     name: "confirmDestructiveAction",
     description: "Confirm a destructive or irreversible action with the user. Use for things like deleting data, resetting the database, or discarding draft work. Do not use after presentPublishPlan or writePlan (those already include approval). Do not use before onboarding state transitions.",
     inputSchema: {
@@ -1878,7 +1868,6 @@ function runCli(command, args, options) {
 // src/subagents/sdkConsultant/index.ts
 var askMindStudioSdkTool = {
   definition: {
-    clearable: false,
     name: "askMindStudioSdk",
     description: "@mindstudio-ai/agent backend SDK expert. Knows every backend action, AI model, connector, and configuration option. Returns architectural guidance and working code. Only covers the backend SDK (@mindstudio-ai/agent) \u2014 do NOT use for frontend/interface SDK questions (@mindstudio-ai/interface) like file uploads, auth, or client-side APIs. Describe what you want to build, not just what API method you need. Batch related questions into a single query.",
     inputSchema: {
@@ -2019,7 +2008,6 @@ function stripDollarKeys(envelope) {
 // src/tools/common/searchGoogle.ts
 var searchGoogleTool = {
   definition: {
-    clearable: false,
     name: "searchGoogle",
     description: "Search Google and return results. Use for research, finding documentation, looking up APIs, or any task where web search would help.",
     inputSchema: {
@@ -2050,7 +2038,6 @@ var searchGoogleTool = {
 // src/tools/common/setProjectMetadata.ts
 var setProjectMetadataTool = {
   definition: {
-    clearable: false,
     name: "setProjectMetadata",
     description: "Set project metadata. Can update any combination of: display name, short description, app icon, and Open Graph share image. Provide only the fields you want to change.",
     inputSchema: {
@@ -2082,8 +2069,13 @@ var setProjectMetadataTool = {
 
 // src/tools/common/compactConversation.ts
 var compactConversationTool = {
+  backgroundOnly: true,
+  // Silent: the completed summary is written onto the tool block for the UI
+  // detail view only. The model must never receive it as a message — it gets
+  // the summary the correct way, as the checkpoint prefix in every later API
+  // call (cleanMessagesForApi).
+  backgroundNotify: "silent",
   definition: {
-    clearable: false,
     name: "compactConversation",
     description: "Compact the conversation history by summarizing older messages into a checkpoint. The summary preserves key decisions, what was built, and the current state of the project, but drops the verbose tool results, diffs, and intermediate steps that are no longer useful. Runs in the background.",
     inputSchema: {
@@ -2095,11 +2087,32 @@ var compactConversationTool = {
     if (!context?.conversationMessages || !context.apiConfig) {
       return "Error: compaction requires execution context.";
     }
+    const { toolCallId, onBackgroundComplete, toolRegistry } = context;
     triggerCompaction(
       { messages: context.conversationMessages },
       context.apiConfig,
-      { blocking: false, requestId: context.requestId }
-    ).catch(() => {
+      // origin/toolCallId tell the headless listener a real block exists —
+      // it must not synthesize a UI-only one for this compaction.
+      {
+        blocking: false,
+        requestId: context.requestId,
+        origin: "tool",
+        toolCallId
+      }
+    ).then((summaries) => {
+      onBackgroundComplete?.(
+        toolCallId,
+        "compactConversation",
+        formatSummariesResult(summaries)
+      );
+    }).catch((err) => {
+      onBackgroundComplete?.(
+        toolCallId,
+        "compactConversation",
+        `Error: ${err.message || "Compaction failed"}`
+      );
+    }).finally(() => {
+      toolRegistry?.unregister(toolCallId);
     });
     return "Compaction started in the background.";
   }
@@ -2108,7 +2121,6 @@ var compactConversationTool = {
 // src/tools/common/loadSkill.ts
 var loadSkillTool = {
   definition: {
-    clearable: true,
     name: "loadSkill",
     description: "Load the full reference for a platform capability that isn't in your system prompt \u2014 task agents, agent interfaces, voice interfaces, MCP interfaces, data sources. The available skills and the trigger for each are listed in <available_skills>. Load one before writing code in its area, not after: these are APIs where a plausible-looking guess is usually wrong. Calling this is cheap and expected \u2014 if you're unsure whether you need it, load it. Only covers the capabilities listed in the catalog; for backend SDK actions and model IDs use askMindStudioSdk.",
     inputSchema: {
@@ -2159,7 +2171,6 @@ function isBinary(buffer) {
 }
 var readFileTool = {
   definition: {
-    clearable: true,
     name: "readFile",
     description: "Read a file's contents with line numbers. Always read a file before editing it \u2014 never guess at contents. By default returns the first 500 lines, and at most 64KB \u2014 a file with very wide lines (a CSV, a minified bundle) comes back short of 500 lines, so read a narrower range or grep rather than paging through it. To read a specific range, pass startLine and endLine (1-indexed, inclusive) \u2014 e.g. to read lines 253\u2013343, pass startLine: 253, endLine: 343. To read the end of a file or log, pass tail (the number of lines from the end). Line numbers in the output correspond to what editFile expects. For a large file, locate the relevant section first (symbols or grep), then read just that range.",
     inputSchema: {
@@ -2263,7 +2274,6 @@ import fs14 from "fs/promises";
 import path7 from "path";
 var writeFileTool = {
   definition: {
-    clearable: true,
     name: "writeFile",
     description: "Create a new file or completely overwrite an existing one. Parent directories are created automatically. Use this for new files or full rewrites. For targeted changes to existing files, use editFile instead \u2014 it preserves the parts you don't want to change and avoids errors from forgetting to include unchanged code.",
     inputSchema: {
@@ -2329,7 +2339,6 @@ ${unifiedDiff(input.path, oldContent ?? "", input.content)}`;
 import fs15 from "fs/promises";
 var editFileTool = {
   definition: {
-    clearable: true,
     name: "editFile",
     description: "Replace a string in a file. old_string must appear exactly once (minor indentation differences are handled automatically). Set replace_all to true to replace every occurrence at once. For bulk mechanical substitutions (renaming a variable, swapping colors), prefer replace_all. Always read the file first so you know the exact text to match. When editing nested structures (objects, function bodies, arrays, template literals), always include the full enclosing structure in old_string rather than just an inner fragment. Replacing a partial slice from the middle of nested code is the most common source of syntax errors.",
     inputSchema: {
@@ -2422,7 +2431,6 @@ var DEFAULT_MAX_LINES2 = 500;
 var MAX_OUTPUT_BYTES = 3e4;
 var bashTool = {
   definition: {
-    clearable: true,
     name: "bash",
     description: "Run a shell command and return stdout + stderr. 120-second timeout by default (configurable). Use for: npm install/build/test, git operations, tsc --noEmit, or any CLI tool. Prefer dedicated tools over bash when available (use grep instead of bash + rg, readFile instead of bash + cat). Output is truncated to 500 lines or 30KB, whichever comes first. If a command would emit a lot of data, narrow it down (grep, head/tail, --short flags) rather than reading everything.",
     inputSchema: {
@@ -2544,7 +2552,6 @@ function formatResults(stdout, max, mode) {
 }
 var grepTool = {
   definition: {
-    clearable: true,
     name: "grep",
     description: "Search file contents for a regex pattern. Returns matching lines with file paths and line numbers (default 50 results). Use this to find where something is used, locate function definitions, or search for patterns across the codebase. Set outputMode to 'count' for per-file match counts (like grep -c) or 'filesWithMatches' for just the file paths (like grep -l). Add context (like grep -C), or contextBefore/contextAfter (like grep -B/-A), to include surrounding lines. Set caseInsensitive (like grep -i) for a case-insensitive search. For finding a symbol's definition precisely, prefer the definition tool if LSP is available. Automatically excludes node_modules and .git.",
     inputSchema: {
@@ -2656,7 +2663,6 @@ import fg from "fast-glob";
 var DEFAULT_MAX2 = 200;
 var globTool = {
   definition: {
-    clearable: true,
     name: "glob",
     description: 'Find files matching a glob pattern. Returns matching file paths sorted alphabetically (default 200 results). Use this to discover project structure, find files by name or extension, or check if a file exists. Common patterns: "**/*.ts" (all TypeScript files), "src/**/*.tsx" (React components in src), "*.json" (root-level JSON files). Automatically excludes node_modules and .git.',
     inputSchema: {
@@ -2754,7 +2760,6 @@ async function formatFile(dirPath, name, indent) {
 }
 var listDirTool = {
   definition: {
-    clearable: true,
     name: "listDir",
     description: "List the contents of a directory with one level of subdirectory expansion. Shows file sizes and collapses single-child directory chains (a/b/c/ shown as one entry). Use this for a quick overview of a directory's structure. For finding files across the whole project, use glob instead.",
     inputSchema: {
@@ -2831,7 +2836,6 @@ var listDirTool = {
 // src/tools/code/editsFinished.ts
 var editsFinishedTool = {
   definition: {
-    clearable: false,
     name: "editsFinished",
     description: "Signal that file edits are complete. Call this after you finish writing/editing files so the live preview updates cleanly. The preview is paused while you edit to avoid showing broken intermediate states \u2014 this unpauses it. If you forget to call this, the preview updates when your turn ends.",
     inputSchema: {
@@ -2898,7 +2902,6 @@ async function lspRequest(endpoint, body) {
 // src/tools/code/lspDiagnostics.ts
 var lspDiagnosticsTool = {
   definition: {
-    clearable: true,
     name: "lspDiagnostics",
     description: "Get TypeScript diagnostics (type errors, warnings) for a file, with suggested fixes when available. Use this after editing a file to check for errors.",
     inputSchema: {
@@ -2947,7 +2950,6 @@ var lspDiagnosticsTool = {
 // src/tools/code/restartProcess.ts
 var restartProcessTool = {
   definition: {
-    clearable: false,
     name: "restartProcess",
     description: "Restart a managed sandbox process. Use this after running npm install or changing package.json to restart the dev server so it picks up new dependencies.",
     inputSchema: {
@@ -2974,7 +2976,6 @@ var restartProcessTool = {
 // src/tools/code/runScenario.ts
 var runScenarioTool = {
   definition: {
-    clearable: true,
     name: "runScenario",
     description: "Run a scenario to seed the dev database with test data. By default truncates all tables first, then executes the seed function and impersonates the scenario roles. Use skipTruncate to run the seed function against existing data without resetting. Blocks until complete. Scenario IDs are defined in mindstudio.json. If it fails, check .logs/tunnel.log or .logs/requests.ndjson for details. Return synchronously - no need to sleep before checking results.",
     inputSchema: {
@@ -3000,7 +3001,6 @@ var runScenarioTool = {
 // src/tools/code/runMethod.ts
 var runMethodTool = {
   definition: {
-    clearable: true,
     name: "runMethod",
     description: 'Run a method in the dev environment and return the result. Use for testing methods after writing or modifying them. Returns output, captured console output, errors with stack traces, and duration. If it fails, check .logs/tunnel.log or .logs/requests.ndjson for more details. Returns synchronously \u2014 no need to sleep before checking results.\n\nBy default methods run unauthenticated. If the method is auth-gated (calls `auth.requireRole()`, filters on `auth.userId`, etc.), pass `userId: "testUser"` to run as the default test user \u2014 no scenario setup required, no userId lookup.',
     inputSchema: {
@@ -3035,7 +3035,6 @@ var runMethodTool = {
 // src/tools/code/queryDatabase.ts
 var queryDatabaseTool = {
   definition: {
-    clearable: true,
     name: "queryDatabase",
     description: "Execute a raw SQL query against the dev database and return the results. Use for inspecting data and debugging issues.",
     inputSchema: {
@@ -3385,16 +3384,55 @@ function capToolResult(result) {
 }
 
 // src/statusWatcher.ts
+var INTERNAL_PAYLOAD_MARKERS = [
+  "[USER CANCELLED]",
+  "[INTERRUPTED]",
+  "[INTERRUPTED - PARTIAL OUTPUT RETRIEVED]",
+  "<background_results>",
+  "<tool_result"
+];
+function sanitizeStatusText(text) {
+  if (!text) {
+    return "";
+  }
+  for (const marker of INTERNAL_PAYLOAD_MARKERS) {
+    if (text.includes(marker)) {
+      return "";
+    }
+  }
+  const truncIdx = text.indexOf("(tool result truncated at");
+  return truncIdx === -1 ? text : text.slice(0, truncIdx);
+}
 function startStatusWatcher(config) {
   const { apiConfig, getContext, onStatus, interval = 5e3, signal } = config;
   let inflight2 = false;
   let stopped = false;
   let pauseCount = 0;
   const url = `${apiConfig.baseUrl}/_internal/v2/agent/remy/generate-status`;
+  let consecutiveFailures = 0;
+  let backoffMs = 0;
+  let nextAllowedAt = 0;
+  const MAX_CONSECUTIVE_FAILURES = 10;
+  const MAX_BACKOFF_MS = 6e4;
+  function recordFailure() {
+    consecutiveFailures++;
+    backoffMs = Math.min(
+      backoffMs === 0 ? interval : backoffMs * 2,
+      MAX_BACKOFF_MS
+    );
+    nextAllowedAt = Date.now() + backoffMs;
+    if (consecutiveFailures >= MAX_CONSECUTIVE_FAILURES && !stopped) {
+      stopped = true;
+      clearInterval(timer);
+    }
+  }
   async function tick() {
     if (stopped || signal?.aborted || inflight2 || pauseCount > 0) {
       return;
     }
+    if (Date.now() < nextAllowedAt) {
+      return;
+    }
     inflight2 = true;
     try {
       const context = getContext();
@@ -3410,18 +3448,29 @@ function startStatusWatcher(config) {
         body: JSON.stringify({ appId: apiConfig.appId, context }),
         signal
       });
-      if (!res.ok || stopped) {
+      if (stopped) {
+        return;
+      }
+      if (!res.ok) {
+        recordFailure();
         return;
       }
       const data = await res.json();
       if (!data.label) {
+        recordFailure();
         return;
       }
+      consecutiveFailures = 0;
+      backoffMs = 0;
+      nextAllowedAt = 0;
       if (pauseCount > 0 || stopped || signal?.aborted) {
         return;
       }
       onStatus(data.label);
     } catch {
+      if (!stopped && !signal?.aborted) {
+        recordFailure();
+      }
     } finally {
       inflight2 = false;
     }
@@ -3518,7 +3567,12 @@ ${summaryBlock.text}
     }
     startIdx = checkpointIdx + 1;
   }
-  const messagesToProcess = fixOrphanedToolCalls(messages.slice(startIdx));
+  const apiMessages = messages.slice(startIdx).filter(
+    (msg) => !(msg.role === "assistant" && Array.isArray(msg.content) && msg.content.some(
+      (b) => b.type === "tool" && b.uiOnly
+    ))
+  );
+  const messagesToProcess = fixOrphanedToolCalls(apiMessages);
   const toolUseIds = /* @__PURE__ */ new Set();
   for (const msg of messagesToProcess) {
     if (msg.role === "assistant" && Array.isArray(msg.content)) {
@@ -3660,329 +3714,341 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
       return { text: USER_CANCELLED_RESULT, messages: thisInvocation() };
     }
     let lastToolResult = "";
-    while (true) {
-      turns++;
-      if (signal?.aborted) {
-        return abortResult([]);
-      }
-      const iterStart = Date.now();
-      const contentBlocks = [];
-      let thinkingStartedAt = 0;
-      let lastThinkingRelatedStartedAt;
-      let stopReason = "end_turn";
-      let currentToolNames = "";
-      let lastUsage;
-      let lastProviderMetadata;
-      let lastModelId;
-      const statusWatcher = startStatusWatcher({
-        apiConfig,
-        getContext: () => {
-          const parts = [];
-          if (task) {
-            parts.push(`Task: ${task.slice(-200)}`);
-          }
-          const text = getPartialText(contentBlocks);
-          if (text) {
-            parts.push(`Assistant text: ${text.slice(-500)}`);
-          }
-          if (currentToolNames) {
-            parts.push(`Tool: ${currentToolNames}`);
-          }
-          if (lastToolResult) {
-            parts.push(`Tool result: ${lastToolResult.slice(-200)}`);
-          }
-          return parts.join("\n");
-        },
-        onStatus: (label) => emit({ type: "status", message: label }),
-        signal
-      });
-      try {
-        for await (const event of streamChatWithRetry(
-          {
-            ...apiConfig,
-            model,
-            requestId,
-            subAgentId,
-            system: fullSystem,
-            messages: cleanMessagesForApi(messages),
-            tools: tools2,
-            signal
-          },
-          {
-            onRetry: (attempt) => emit({
-              type: "status",
-              message: `Lost connection, retrying (attempt ${attempt + 2} of 3)`
-            })
+    let watchedBlocks = [];
+    let watchedToolNames = "";
+    const statusWatcher = startStatusWatcher({
+      apiConfig,
+      getContext: () => {
+        const parts = [];
+        if (task) {
+          parts.push(`Task: ${sanitizeStatusText(task).slice(-200)}`);
+        }
+        const text = getPartialText(watchedBlocks);
+        if (text) {
+          parts.push(`Assistant text: ${text.slice(-500)}`);
+        }
+        if (watchedToolNames) {
+          parts.push(`Tool: ${watchedToolNames}`);
+        }
+        const toolResult = sanitizeStatusText(lastToolResult);
+        if (toolResult) {
+          parts.push(`Tool result: ${toolResult.slice(-200)}`);
+        }
+        return parts.join("\n");
+      },
+      onStatus: (label) => emit({ type: "status", message: label }),
+      signal
+    });
+    try {
+      while (true) {
+        turns++;
+        if (signal?.aborted) {
+          return abortResult([]);
+        }
+        const iterStart = Date.now();
+        const contentBlocks = [];
+        let thinkingStartedAt = 0;
+        let lastThinkingRelatedStartedAt;
+        let stopReason = "end_turn";
+        let lastUsage;
+        let lastProviderMetadata;
+        let lastModelId;
+        watchedBlocks = contentBlocks;
+        watchedToolNames = "";
+        try {
+          for await (const event of streamChatWithRetry(
+            {
+              ...apiConfig,
+              model,
+              requestId,
+              subAgentId,
+              system: fullSystem,
+              messages: cleanMessagesForApi(messages),
+              tools: tools2,
+              signal
+            },
+            {
+              onRetry: (attempt) => emit({
+                type: "status",
+                message: `Lost connection, retrying (attempt ${attempt + 2} of 3)`
+              })
+            }
+          )) {
+            if (signal?.aborted) {
+              break;
+            }
+            switch (event.type) {
+              case "text": {
+                const lastBlock = contentBlocks.at(-1);
+                if (lastBlock?.type === "text") {
+                  lastBlock.text += event.text;
+                } else {
+                  contentBlocks.push({
+                    type: "text",
+                    text: event.text,
+                    startedAt: event.ts
+                  });
+                }
+                emit({ type: "text", text: event.text });
+                break;
+              }
+              case "thinking":
+                if (!thinkingStartedAt) {
+                  thinkingStartedAt = event.ts;
+                }
+                emit({ type: "thinking", text: event.text });
+                break;
+              case "thinking_complete":
+                contentBlocks.push({
+                  type: "thinking",
+                  thinking: event.thinking,
+                  signature: event.signature,
+                  startedAt: thinkingStartedAt,
+                  completedAt: event.ts
+                });
+                lastThinkingRelatedStartedAt = thinkingStartedAt;
+                thinkingStartedAt = 0;
+                break;
+              case "redacted_thinking_complete": {
+                const startedAt = lastThinkingRelatedStartedAt !== void 0 ? lastThinkingRelatedStartedAt + 1 : event.ts;
+                contentBlocks.push({
+                  type: "redacted_thinking",
+                  data: event.data,
+                  startedAt,
+                  completedAt: event.ts
+                });
+                lastThinkingRelatedStartedAt = startedAt;
+                break;
+              }
+              case "tool_use":
+                contentBlocks.push({
+                  type: "tool",
+                  id: event.id,
+                  name: event.name,
+                  input: event.input,
+                  startedAt: Date.now()
+                });
+                emit({
+                  type: "tool_start",
+                  id: event.id,
+                  name: event.name,
+                  input: event.input
+                });
+                break;
+              case "done":
+                stopReason = event.stopReason;
+                lastUsage = {
+                  inputTokens: event.usage.inputTokens,
+                  outputTokens: event.usage.outputTokens,
+                  cacheCreationTokens: event.usage.cacheCreationTokens,
+                  cacheReadTokens: event.usage.cacheReadTokens,
+                  llmCalls: 1
+                };
+                lastProviderMetadata = event.providerMetadata;
+                lastModelId = event.modelId;
+                recordUsage({
+                  ts: Date.now(),
+                  requestId,
+                  agentName: subAgentId || "sub-agent",
+                  parentToolId,
+                  modelId: event.modelId,
+                  inputTokens: event.usage.inputTokens,
+                  outputTokens: event.usage.outputTokens,
+                  cacheCreationTokens: event.usage.cacheCreationTokens,
+                  cacheReadTokens: event.usage.cacheReadTokens,
+                  cost: nanoToDollars(event.cost),
+                  billingEvents: event.billingEvents,
+                  durationMs: Date.now() - iterStart,
+                  toolNames: contentBlocks.filter(
+                    (b) => b.type === "tool"
+                  ).map((b) => b.name)
+                });
+                break;
+              case "error":
+                statusWatcher.stop();
+                return {
+                  text: `Error: ${event.error}`,
+                  messages: thisInvocation()
+                };
+            }
           }
-        )) {
-          if (signal?.aborted) {
-            break;
+        } catch (err) {
+          if (!signal?.aborted) {
+            throw err;
           }
-          switch (event.type) {
-            case "text": {
-              const lastBlock = contentBlocks.at(-1);
-              if (lastBlock?.type === "text") {
-                lastBlock.text += event.text;
-              } else {
-                contentBlocks.push({
-                  type: "text",
-                  text: event.text,
-                  startedAt: event.ts
+        }
+        if (signal?.aborted) {
+          statusWatcher.stop();
+          return abortResult(contentBlocks);
+        }
+        messages.push({
+          role: "assistant",
+          content: contentBlocks,
+          ...lastUsage ? { usage: lastUsage } : {},
+          ...lastProviderMetadata ? { providerMetadata: lastProviderMetadata } : {},
+          model: lastModelId ?? model
+        });
+        const toolCalls = contentBlocks.filter(
+          (b) => b.type === "tool"
+        );
+        if (stopReason !== "tool_use" || toolCalls.length === 0) {
+          statusWatcher.stop();
+          const text = getPartialText(contentBlocks);
+          const hasArtifacts = Object.keys(artifacts).length > 0;
+          return {
+            text,
+            messages: thisInvocation(),
+            ...hasArtifacts ? { artifacts } : {}
+          };
+        }
+        log7.info("Tools executing", {
+          requestId,
+          parentToolId,
+          count: toolCalls.length,
+          tools: toolCalls.map((tc) => tc.name)
+        });
+        watchedToolNames = toolCalls.map((tc) => tc.name).join(", ");
+        const results = await Promise.all(
+          toolCalls.map(async (tc) => {
+            if (signal?.aborted) {
+              return {
+                id: tc.id,
+                result: USER_CANCELLED_RESULT,
+                isError: true
+              };
+            }
+            let settle;
+            const resultPromise = new Promise((res) => {
+              settle = (result, isError) => res({ id: tc.id, result, isError });
+            });
+            let toolAbort = new AbortController();
+            const cascadeAbort = () => toolAbort.abort();
+            signal?.addEventListener("abort", cascadeAbort, { once: true });
+            let settled = false;
+            const safeSettle = (result, isError) => {
+              if (settled) {
+                return;
+              }
+              settled = true;
+              signal?.removeEventListener("abort", cascadeAbort);
+              settle(result, isError);
+            };
+            const run2 = async (input) => {
+              try {
+                let result;
+                if (externalTools.has(tc.name) && resolveExternalTool) {
+                  result = await resolveExternalTool(tc.id, tc.name, input);
+                } else {
+                  const onLog = (line) => emit({
+                    type: "tool_input_delta",
+                    id: tc.id,
+                    name: tc.name,
+                    result: line
+                  });
+                  result = await executeTool2(
+                    tc.name,
+                    input,
+                    tc.id,
+                    onLog,
+                    subAgentMessages
+                  );
+                }
+                safeSettle(capToolResult(result), result.startsWith("Error"));
+              } catch (err) {
+                safeSettle(`Error: ${err.message}`, true);
+              }
+            };
+            const entry = {
+              id: tc.id,
+              name: tc.name,
+              input: tc.input,
+              parentToolId,
+              abortController: toolAbort,
+              startedAt: Date.now(),
+              settle: safeSettle,
+              rerun: (newInput) => {
+                settled = false;
+                toolAbort = new AbortController();
+                signal?.addEventListener("abort", () => toolAbort.abort(), {
+                  once: true
                 });
+                entry.abortController = toolAbort;
+                entry.input = newInput;
+                run2(newInput);
               }
-              emit({ type: "text", text: event.text });
-              break;
+            };
+            toolRegistry?.register(entry);
+            const toolStart = Date.now();
+            run2(tc.input);
+            const r = await resultPromise;
+            toolRegistry?.unregister(tc.id);
+            log7.info("Tool completed", {
+              requestId,
+              parentToolId,
+              toolCallId: tc.id,
+              name: tc.name,
+              durationMs: Date.now() - toolStart,
+              isError: r.isError
+            });
+            emit({
+              type: "tool_done",
+              id: tc.id,
+              name: tc.name,
+              result: r.result,
+              isError: r.isError
+            });
+            return r;
+          })
+        );
+        lastToolResult = results.at(-1)?.result ?? "";
+        for (const r of results) {
+          const block = contentBlocks.find(
+            (b) => b.type === "tool" && b.id === r.id
+          );
+          if (block?.type === "tool") {
+            block.result = r.result;
+            block.isError = r.isError;
+            block.completedAt = Date.now();
+            const innerMsgs = subAgentMessages.get(r.id);
+            if (innerMsgs) {
+              block.subAgentMessages = innerMsgs;
             }
-            case "thinking":
-              if (!thinkingStartedAt) {
-                thinkingStartedAt = event.ts;
+            if (captureArtifacts?.includes(block.name) && !r.isError) {
+              try {
+                artifacts[block.name] = JSON.parse(r.result);
+              } catch {
               }
-              emit({ type: "thinking", text: event.text });
-              break;
-            case "thinking_complete":
-              contentBlocks.push({
-                type: "thinking",
-                thinking: event.thinking,
-                signature: event.signature,
-                startedAt: thinkingStartedAt,
-                completedAt: event.ts
-              });
-              lastThinkingRelatedStartedAt = thinkingStartedAt;
-              thinkingStartedAt = 0;
-              break;
-            case "redacted_thinking_complete": {
-              const startedAt = lastThinkingRelatedStartedAt !== void 0 ? lastThinkingRelatedStartedAt + 1 : event.ts;
-              contentBlocks.push({
-                type: "redacted_thinking",
-                data: event.data,
-                startedAt,
-                completedAt: event.ts
-              });
-              lastThinkingRelatedStartedAt = startedAt;
-              break;
             }
-            case "tool_use":
-              contentBlocks.push({
-                type: "tool",
-                id: event.id,
-                name: event.name,
-                input: event.input,
-                startedAt: Date.now()
-              });
-              emit({
-                type: "tool_start",
-                id: event.id,
-                name: event.name,
-                input: event.input
-              });
-              break;
-            case "done":
-              stopReason = event.stopReason;
-              lastUsage = {
-                inputTokens: event.usage.inputTokens,
-                outputTokens: event.usage.outputTokens,
-                cacheCreationTokens: event.usage.cacheCreationTokens,
-                cacheReadTokens: event.usage.cacheReadTokens,
-                llmCalls: 1
-              };
-              lastProviderMetadata = event.providerMetadata;
-              lastModelId = event.modelId;
-              recordUsage({
-                ts: Date.now(),
-                requestId,
-                agentName: subAgentId || "sub-agent",
-                parentToolId,
-                modelId: event.modelId,
-                inputTokens: event.usage.inputTokens,
-                outputTokens: event.usage.outputTokens,
-                cacheCreationTokens: event.usage.cacheCreationTokens,
-                cacheReadTokens: event.usage.cacheReadTokens,
-                cost: nanoToDollars(event.cost),
-                billingEvents: event.billingEvents,
-                durationMs: Date.now() - iterStart,
-                toolNames: contentBlocks.filter(
-                  (b) => b.type === "tool"
-                ).map((b) => b.name)
-              });
-              break;
-            case "error":
-              return {
-                text: `Error: ${event.error}`,
-                messages: thisInvocation()
-              };
           }
-        }
-      } catch (err) {
-        if (!signal?.aborted) {
-          throw err;
+          messages.push({
+            role: "user",
+            content: r.result,
+            toolCallId: r.id,
+            isToolError: r.isError
+          });
         }
       }
-      if (signal?.aborted) {
-        statusWatcher.stop();
-        return abortResult(contentBlocks);
-      }
-      messages.push({
-        role: "assistant",
-        content: contentBlocks,
-        ...lastUsage ? { usage: lastUsage } : {},
-        ...lastProviderMetadata ? { providerMetadata: lastProviderMetadata } : {},
-        model: lastModelId ?? model
+    } finally {
+      statusWatcher.stop();
+    }
+  };
+  const wrapRun = async () => {
+    try {
+      const result = await run();
+      log7.info("Sub-agent complete", {
+        requestId,
+        parentToolId,
+        agentName,
+        durationMs: Date.now() - runStart,
+        turns
       });
-      const toolCalls = contentBlocks.filter(
-        (b) => b.type === "tool"
-      );
-      if (stopReason !== "tool_use" || toolCalls.length === 0) {
-        statusWatcher.stop();
-        const text = getPartialText(contentBlocks);
-        const hasArtifacts = Object.keys(artifacts).length > 0;
-        return {
-          text,
-          messages: thisInvocation(),
-          ...hasArtifacts ? { artifacts } : {}
-        };
-      }
-      log7.info("Tools executing", {
+      return result;
+    } catch (err) {
+      log7.warn("Sub-agent error", {
         requestId,
         parentToolId,
-        count: toolCalls.length,
-        tools: toolCalls.map((tc) => tc.name)
-      });
-      currentToolNames = toolCalls.map((tc) => tc.name).join(", ");
-      const results = await Promise.all(
-        toolCalls.map(async (tc) => {
-          if (signal?.aborted) {
-            return { id: tc.id, result: USER_CANCELLED_RESULT, isError: true };
-          }
-          let settle;
-          const resultPromise = new Promise((res) => {
-            settle = (result, isError) => res({ id: tc.id, result, isError });
-          });
-          let toolAbort = new AbortController();
-          const cascadeAbort = () => toolAbort.abort();
-          signal?.addEventListener("abort", cascadeAbort, { once: true });
-          let settled = false;
-          const safeSettle = (result, isError) => {
-            if (settled) {
-              return;
-            }
-            settled = true;
-            signal?.removeEventListener("abort", cascadeAbort);
-            settle(result, isError);
-          };
-          const run2 = async (input) => {
-            try {
-              let result;
-              if (externalTools.has(tc.name) && resolveExternalTool) {
-                result = await resolveExternalTool(tc.id, tc.name, input);
-              } else {
-                const onLog = (line) => emit({
-                  type: "tool_input_delta",
-                  id: tc.id,
-                  name: tc.name,
-                  result: line
-                });
-                result = await executeTool2(
-                  tc.name,
-                  input,
-                  tc.id,
-                  onLog,
-                  subAgentMessages
-                );
-              }
-              safeSettle(capToolResult(result), result.startsWith("Error"));
-            } catch (err) {
-              safeSettle(`Error: ${err.message}`, true);
-            }
-          };
-          const entry = {
-            id: tc.id,
-            name: tc.name,
-            input: tc.input,
-            parentToolId,
-            abortController: toolAbort,
-            startedAt: Date.now(),
-            settle: safeSettle,
-            rerun: (newInput) => {
-              settled = false;
-              toolAbort = new AbortController();
-              signal?.addEventListener("abort", () => toolAbort.abort(), {
-                once: true
-              });
-              entry.abortController = toolAbort;
-              entry.input = newInput;
-              run2(newInput);
-            }
-          };
-          toolRegistry?.register(entry);
-          const toolStart = Date.now();
-          run2(tc.input);
-          const r = await resultPromise;
-          toolRegistry?.unregister(tc.id);
-          log7.info("Tool completed", {
-            requestId,
-            parentToolId,
-            toolCallId: tc.id,
-            name: tc.name,
-            durationMs: Date.now() - toolStart,
-            isError: r.isError
-          });
-          emit({
-            type: "tool_done",
-            id: tc.id,
-            name: tc.name,
-            result: r.result,
-            isError: r.isError
-          });
-          return r;
-        })
-      );
-      statusWatcher.stop();
-      lastToolResult = results.at(-1)?.result ?? "";
-      for (const r of results) {
-        const block = contentBlocks.find(
-          (b) => b.type === "tool" && b.id === r.id
-        );
-        if (block?.type === "tool") {
-          block.result = r.result;
-          block.isError = r.isError;
-          block.completedAt = Date.now();
-          const innerMsgs = subAgentMessages.get(r.id);
-          if (innerMsgs) {
-            block.subAgentMessages = innerMsgs;
-          }
-          if (captureArtifacts?.includes(block.name) && !r.isError) {
-            try {
-              artifacts[block.name] = JSON.parse(r.result);
-            } catch {
-            }
-          }
-        }
-        messages.push({
-          role: "user",
-          content: r.result,
-          toolCallId: r.id,
-          isToolError: r.isError
-        });
-      }
-    }
-  };
-  const wrapRun = async () => {
-    try {
-      const result = await run();
-      log7.info("Sub-agent complete", {
-        requestId,
-        parentToolId,
-        agentName,
-        durationMs: Date.now() - runStart,
-        turns
-      });
-      return result;
-    } catch (err) {
-      log7.warn("Sub-agent error", {
-        requestId,
-        parentToolId,
-        agentName,
-        error: err.message
+        agentName,
+        error: err.message
       });
       throw err;
     }
@@ -4040,7 +4106,6 @@ var COMMON_READ_TOOL_NAMES = new Set(
 // src/subagents/browserAutomation/tools.ts
 var BROWSER_TOOLS = [
   {
-    clearable: false,
     name: "setupBrowser",
     description: "Pre-authenticate the browser and optionally navigate to a starting page. Call this before interacting with authenticated content instead of manually logging in. Auth is optional \u2014 omit to just navigate without authenticating.",
     inputSchema: {
@@ -4073,7 +4138,6 @@ var BROWSER_TOOLS = [
     }
   },
   {
-    clearable: true,
     name: "browserCommand",
     description: "Interact with the app's live preview by sending browser commands. Commands execute sequentially with an animated cursor. Always start with a snapshot to see the current state and get ref identifiers. The result includes a snapshot field with the final page state after all steps complete. On error, the failing step has an error field and execution stops. Batches that contain an interactive step (click, type, select) also return a `recording` object \u2014 one chunk of a continuous per-session rrweb recording that the viewer stitches into a single replay (not a standalone per-call clip). Timeout: 120s.",
     inputSchema: {
@@ -4490,7 +4554,6 @@ async function runBrowserAutomation(task, context, opts) {
 }
 var browserAutomationTool = {
   definition: {
-    clearable: true,
     name: "runAutomatedBrowserTest",
     description: "Run an automated browser test against the live preview. Describe what to test \u2014 the agent figures out how. Use after meaningful changes to frontend code, to reproduce user-reported issues, or to test end-to-end flows. Never give it explicit values to use when filling out forms or creating accounts \u2014 it will use its own judgement (often it needs specific values to trigger dev-mode bypasses of things like login verification codes).",
     inputSchema: {
@@ -4520,7 +4583,6 @@ var browserAutomationTool = {
 
 // src/tools/code/screenshot.ts
 var screenshotDefinition = {
-  clearable: true,
   name: "screenshot",
   description: "Capture a screenshot of the app preview and get a description of what's on screen. Choose `fullPage`: `false` captures just the visible viewport (fast \u2014 for a specific section the page is scrolled to), `true` captures the entire page top-to-bottom (slower \u2014 for overall composition or content past the fold). Captures the settled page state \u2014 it cannot catch animations, transitions, or transient state. The analysis is not precise about every detail \u2014 for example it cannot reliably identify specific fonts by name, only describe what the letterforms look like. Optionally provide specific questions about what you're looking for. Use a bulleted list to ask many questions at once. To ask additional questions about a screenshot you have already captured, pass its URL as `imageUrl` to skip recapture; `imageUrl` also accepts the disk path of an image file (a user upload, a saved asset) to analyze that instead of the preview. If the screenshot requires interaction first (logging in, clicking a tab, dismissing a modal, scrolling to a section), use the instructions param to describe the steps. To render a fixed-size image such as an Open Graph share card, set `width` and `height` (e.g. 1200 \xD7 630) and `format: 'png'`: the tool navigates to `path`, clips to exactly those pixel dimensions, and returns the image URL.",
   inputSchema: {
@@ -4626,7 +4688,6 @@ __export(searchGoogle_exports, {
   execute: () => execute
 });
 var definition = {
-  clearable: false,
   name: "searchGoogle",
   description: 'Search Google for web results. Reserch modern design trends in industries or verticals, "best [domain] apps 2026", ui patterns, or find something specific if the the user has an explicit reference. Searching for and reading case studies is a great way to get information and context about a project\'s domain. Prioritize authoritative sources like Figma and other design leaders, avoid random blog spam. Pick one or more URLs from the results and then use `scrapeWebUrl` to get their text content.',
   inputSchema: {
@@ -4659,7 +4720,6 @@ __export(scrapeWebUrl_exports, {
   execute: () => execute2
 });
 var definition2 = {
-  clearable: false,
   name: "scrapeWebUrl",
   description: "Fetch the content of a web page as markdown. Use when reading sites from search results or specific things the user wants to incorporate.",
   inputSchema: {
@@ -4717,7 +4777,6 @@ Identify the specific design moves that make this page interesting and unique, d
 Respond only with your analysis as Markdown and absolutely no other text. Do not use emojis - use unicode if you need symbols.
 `;
 var definition3 = {
-  clearable: false,
   name: "analyzeDesign",
   description: "Analyze the visual design of a website, an image URL, or an image file on disk. Websites are automatically screenshotted first. Provides static image analysis only, will not capture animations or video. If no prompt is provided, performs a full design reference analysis (mood, color, typography, layout, distinctiveness). Provide a custom prompt to ask a specific design question instead. Use a bulleted list to ask many questions at once.",
   inputSchema: {
@@ -4782,7 +4841,6 @@ __export(analyzeImage_exports, {
   execute: () => execute4
 });
 var definition4 = {
-  clearable: true,
   name: "analyzeImage",
   description: "Analyze an image using a vision model. Provides static image analysis only, will not capture animations or video. Returns an objective description of what is visible \u2014 shapes, colors, layout, text, artifacts. Use for factual inventory of image contents, not for subjective design judgment - the vision model providing the analysis has no sense of design. You are the design expert - use the analysis tool for factual inventory, then apply your own expertise for quality and suitability assessments. Optionally provide specific questions about what you're looking for. Use a bulleted list to ask many questions at once. If you are analyzing a screenshot of the app preview, you can reuse the same screenshot URL multiple times to ask multiple questions.",
   inputSchema: {
@@ -5016,7 +5074,6 @@ async function generateImageAssets(opts) {
 
 // src/subagents/designExpert/tools/images/generateImages.ts
 var definition5 = {
-  clearable: false,
   name: "generateImages",
   description: "Generate images. Returns CDN URLs with a quality analysis for each image. Produces high-quality results for everything from photorealistic images and abstract/creative visuals. Pass multiple prompts to generate in parallel. No need to analyze images separately after generating \u2014 the analysis is included.",
   inputSchema: {
@@ -5084,7 +5141,6 @@ __export(editImages_exports, {
   execute: () => execute6
 });
 var definition6 = {
-  clearable: false,
   name: "editImages",
   description: "Edit or transform existing images. Provide one or more source image URLs as reference and a prompt describing the desired edit. Use for compositing, style transfer, subject transformation, blending multiple references, or incorporating one or more references into something new. Returns CDN URLs with analysis.",
   inputSchema: {
@@ -5162,7 +5218,6 @@ var COPY_EDITOR_TOOLS = [...COMMON_READ_TOOLS];
 var BASE_PROMPT2 = readAsset("subagents/copyEditor", "prompt.md");
 var copyEditorTool = {
   definition: {
-    clearable: false,
     name: "copyEditor",
     description: "Hand it user-facing copy and it hands back a sharper version \u2014 better structured for its audience and free of the overused words, telltale constructions, and rhythms that make text read as AI-generated. Think of it as a design expert for words: it elevates how the copy communicates and strips the AI fingerprints, but it never invents facts or claims you didn't give it. Use it on anything users will read: in-app strings, empty states, errors, the Build Overview, deck copy, launch posts, Slack announcements. Readonly.",
     inputSchema: {
@@ -5210,7 +5265,6 @@ var copyEditorTool = {
 
 // src/subagents/designExpert/tools/polishCopy.ts
 var definition7 = {
-  clearable: false,
   name: "polishCopy",
   description: "Hand off any user-facing copy you've written \u2014 headlines, captions, labels, body text \u2014 and get back a sharper version: better built for its audience and free of the fingerprints that make writing read as AI. It elevates how the copy communicates without inventing facts or claims you didn't give it. Give it the text plus what it's for (where it appears, the audience).",
   inputSchema: {
@@ -5562,7 +5616,6 @@ async function runDesignExpert(opts, context) {
 }
 var designExpertTool = {
   definition: {
-    clearable: false,
     name: "visualDesignExpert",
     description: DESCRIPTION,
     inputSchema: {
@@ -5770,7 +5823,6 @@ function getProductVisionPrompt() {
 // src/subagents/productVision/index.ts
 var productVisionTool = {
   definition: {
-    clearable: false,
     name: "productVision",
     description: "Owns the product roadmap. Reads spec and roadmap files automatically. Creates, updates, and deletes roadmap items in src/roadmap/. Describe the situation and what needs to happen.",
     inputSchema: {
@@ -5883,7 +5935,6 @@ var SANITY_CHECK_TOOLS = [
 var BASE_PROMPT4 = readAsset("subagents/codeSanityCheck", "prompt.md");
 var codeSanityCheckTool = {
   definition: {
-    clearable: false,
     name: "codeSanityCheck",
     description: 'Quick sanity check on an approach before building. Reviews architecture, package choices, and flags potential issues. Usually responds with "looks good." Occasionally catches something important. Readonly \u2014 can search the web and read code but cannot modify anything.',
     inputSchema: {
@@ -5929,6 +5980,121 @@ var codeSanityCheckTool = {
   }
 };
 
+// src/tools/spec/writeBuildOverview.ts
+import fs20 from "fs";
+var OVERVIEW_FILE = "src/overview.html";
+var DESIGN_BRIEF = `We are building the Build Overview for this app \u2014 the home page of its Spec tab. It is a calm, dense, one-page reference of everything the app actually contains, including the parts the user can't see. It renders flush inside the Spec tab's content panel (the IDE supplies the surrounding nav).
+
+Take the plain-language copy in <overview_copy> and lay it out and skin it into a single, beautiful, self-contained HTML document in the app's own brand.
+
+### The single hard rule
+The copy in <overview_copy> is final \u2014 it was authored and edited before it reached you. Treat it as locked content to typeset, not a draft to improve. Reproduce the words exactly: do not rewrite, rephrase, shorten, expand, reorder, or "polish" them, and do not run them through any copy tool. This is the opposite of your usual role \u2014 here you own layout, typography, and visual design only, and the words (every number, name, label, claim, and sentence) are fixed. A single changed word or wrong number breaks this document's purpose.
+
+### What it is (and is not)
+- A typeset reference dossier: composed, dense, a little cool \u2014 substantial at a glance, then readable. Density communicates substance; sparse and airy reads as "not much here."
+- Brand-skinned: pull the palette, type system, and a single accent from the app's spec. The accent leads labels and figures; it is a mark, not a fill.
+- NOT a slide deck \u2014 no theatrics, no building to a climax, no persuasion.
+- NOT a docs site \u2014 no raised or shadowed cards, no hover-lift, no clickable-feeling surfaces, no sticky table of contents.
+- NOT a sparse memo \u2014 a restrained single-column page under-sells the work.
+- No header chrome and no footer: open straight on the app's logo and name so it sits flush with the IDE.
+
+### Constraints
+- A single self-contained HTML file. Fonts may load from a CDN; everything else (CSS, the logo SVG) is inline.
+- Responsive: fills the embedded panel width and collapses gracefully at narrow widths.`;
+var OVERVIEW_SHELL = `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<!-- This renders inside an iframe in the IDE. Keep it a simple, self-contained
+     static document \u2014 no scroll/zoom/accessibility scaffolding beyond this head.
+     The user-scalable=no viewport is intentional; leave it. -->
+<meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+<title>Build Overview</title>
+<!-- SKIN: link the app's fonts here (CDN \u2014 e.g. Fontshare / Google Fonts). -->
+<style>
+*, *::before, *::after { margin: 0; padding: 0; box-sizing: border-box; }
+</style>
+</head>
+<body>
+<!-- Compose the Build Overview here. Layout, sections, type, and styling are
+     yours \u2014 keep everything inline and self-contained, brand-skinned from the
+     app's spec. -->
+</body>
+</html>`;
+function initialDelivery() {
+  return `### Your deliverable
+Write the complete Build Overview to \`${OVERVIEW_FILE}\`. The file does not exist yet \u2014 start from this scaffold, which carries the technical hygiene for the iframed render context (keep the viewport meta and the reset). Layout, sections, type, and styling are yours to compose.
+
+<overview_shell>
+${OVERVIEW_SHELL}
+</overview_shell>
+
+Then reply with a one-line summary of what you wrote.`;
+}
+function refreshDelivery() {
+  return `### Your deliverable
+The Build Overview already exists at \`${OVERVIEW_FILE}\`. Read it, then update it to reflect <overview_copy>, preserving its established skin \u2014 change only what the copy changed.
+
+Then reply with a one-line summary of what you changed.`;
+}
+async function renderBuildOverview(content, context, opts) {
+  if (!content) {
+    return "Error: writeBuildOverview requires non-empty `content` (the overview copy).";
+  }
+  const exists = fs20.existsSync(OVERVIEW_FILE);
+  const task = `<overview_copy>${content}</overview_copy>
+
+${DESIGN_BRIEF}
+
+${exists ? refreshDelivery() : initialDelivery()}`;
+  try {
+    if (opts.background) {
+      const result2 = await runDesignExpertRender(
+        { task, background: true, reportingName: "writeBuildOverview" },
+        context
+      );
+      context.subAgentMessages?.set(context.toolCallId, result2.messages);
+      return result2.text;
+    }
+    const result = await runDesignExpertRender({ task }, context);
+    context.subAgentMessages?.set(context.toolCallId, result.messages);
+    if (!fs20.existsSync(OVERVIEW_FILE)) {
+      return `Error: the design expert did not write ${OVERVIEW_FILE}. Its reply was:
+${result.text}`;
+    }
+    return `Build overview written to ${OVERVIEW_FILE}. ${result.text}`;
+  } catch (err) {
+    return `Error generating build overview: ${err.message}`;
+  }
+}
+var buildOverviewTool = {
+  definition: {
+    name: "writeBuildOverview",
+    description: "Generate or refresh the Build Overview \u2014 the project's home page in the Spec tab: a single-page, plain-language reference of everything the app actually contains, including the parts the user can't see (data stores, backend operations, access and roles, background jobs, seeded scenarios, the design system). You author the full copy: read the manifest and spec and state, plainly and exactly, what genuinely exists \u2014 real names and accurate counts \u2014 in calm, declarative, present-tense outcome language, with no persuasion or hype. Describe only what exists. Pass the complete copy as `content`; the design expert lays it out and skins it to the app's brand using your copy verbatim \u2014 it typesets your words, it does not rewrite them, so polish the copy before you pass it. Generate it at the end of a build; routine refreshes ride specSync's `refreshBuildOverview` flag instead, so call this directly only for the initial generation or when the user explicitly asks.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        content: {
+          type: "string",
+          description: "The full Build Overview copy you authored: everything the app contains, in plain present-tense outcome language, with real names and exact counts. The design expert lays this out and skins it to the brand verbatim \u2014 it styles your words, it does not rewrite them \u2014 so this should be the final copy."
+        }
+      },
+      required: ["content"]
+    }
+  },
+  async execute(input, context) {
+    if (!context) {
+      return "Error: writeBuildOverview requires execution context for design expert delegation";
+    }
+    const content = (input.content ?? "").trim();
+    const background = Boolean(content) && fs20.existsSync(OVERVIEW_FILE);
+    if (background) {
+      input.background = true;
+    }
+    return renderBuildOverview(content, context, { background });
+  }
+};
+
 // src/subagents/specSync/tools.ts
 var SPEC_SYNC_TOOLS = [
   ...COMMON_READ_TOOLS,
@@ -5963,15 +6129,18 @@ var specSyncTool = {
   // next real turn as a hidden background_results note instead.
   backgroundNotify: "passive",
   definition: {
-    clearable: false,
     name: "specSync",
-    description: "Reconcile the spec to bring it in line with code changes you have made. Provide a brief, bulleted list of what changed and why; it finds the affected spec sections and updates them to match. Always runs in the background and completes silently \u2014 do not wait for it; its outcome appears as an automated note at the start of a later turn.",
+    description: "Reconcile the spec to bring it in line with code changes you have made. Provide a brief, bulleted list of what changed and why; it finds the affected spec sections and updates them to match. Set `refreshBuildOverview` after a deploy or a large milestone to also re-author the Build Overview from the updated spec. Always runs in the background and completes silently \u2014 do not wait for it; its outcome appears as an automated note at the start of a later turn.",
     inputSchema: {
       type: "object",
       properties: {
         task: {
           type: "string",
           description: "What you changed in the code and why, in plain language \u2014 the way you would explain it to a teammate. The specialist reads the spec itself and decides which sections to update; you do not need to name files or spec locations."
+        },
+        refreshBuildOverview: {
+          type: "boolean",
+          description: "Also refresh the Build Overview (src/overview.html) after reconciling \u2014 the specialist authors fresh copy from the updated spec and re-renders the page. Set this after a deploy or a large milestone; leave it off for routine syncs."
         }
       },
       required: ["task"]
@@ -5995,12 +6164,27 @@ var specSyncTool = {
       parts.push(specIndex);
     }
     const system = parts.join("\n\n");
+    const refreshOverview = input.refreshBuildOverview === true;
+    const tools2 = refreshOverview ? [...SPEC_SYNC_TOOLS, buildOverviewTool.definition] : SPEC_SYNC_TOOLS;
+    const task = refreshOverview ? `${input.task}
+
+After reconciling the spec, refresh the Build Overview: author the complete updated copy from the freshly-reconciled spec (follow the writeBuildOverview tool description) and call \`writeBuildOverview\` once with the final copy.` : input.task;
     const result = await runSubAgent({
       system,
-      task: input.task,
-      tools: SPEC_SYNC_TOOLS,
+      task,
+      tools: tools2,
       externalTools: /* @__PURE__ */ new Set(),
-      executeTool: (name, toolInput) => executeTool(name, toolInput, context),
+      executeTool: (name, toolInput, toolCallId, _onLog, sams) => {
+        if (name === "writeBuildOverview") {
+          const childCtx = toolCallId ? { ...deriveContext(context, toolCallId), subAgentMessages: sams } : { ...context, subAgentMessages: sams };
+          return renderBuildOverview(
+            String(toolInput.content ?? "").trim(),
+            childCtx,
+            { background: false }
+          );
+        }
+        return executeTool(name, toolInput, context);
+      },
       apiConfig: context.apiConfig,
       model: resolveModel("specSync", context.models, context.model),
       subAgentId: "specSync",
@@ -6031,7 +6215,6 @@ var specSyncTool = {
 // src/tools/common/scrapeWebUrl.ts
 var scrapeWebUrlTool = {
   definition: {
-    clearable: false,
     name: "scrapeWebUrl",
     description: "Scrape the content of a web page. Returns the HTML of the page as markdown text. Optionally capture a screenshot if you need see the visual design. Use this when you need to fetch or analyze content from a website",
     inputSchema: {
@@ -6073,119 +6256,9 @@ var scrapeWebUrlTool = {
   }
 };
 
-// src/tools/spec/writeBuildOverview.ts
-import fs20 from "fs";
-var OVERVIEW_FILE = "src/overview.html";
-var DESIGN_BRIEF = `We are building the Build Overview for this app \u2014 the home page of its Spec tab. It is a calm, dense, one-page reference of everything the app actually contains, including the parts the user can't see. It renders flush inside the Spec tab's content panel (the IDE supplies the surrounding nav).
-
-Take the plain-language copy in <overview_copy> and lay it out and skin it into a single, beautiful, self-contained HTML document in the app's own brand.
-
-### The single hard rule
-The copy in <overview_copy> is final \u2014 it was authored and edited before it reached you. Treat it as locked content to typeset, not a draft to improve. Reproduce the words exactly: do not rewrite, rephrase, shorten, expand, reorder, or "polish" them, and do not run them through any copy tool. This is the opposite of your usual role \u2014 here you own layout, typography, and visual design only, and the words (every number, name, label, claim, and sentence) are fixed. A single changed word or wrong number breaks this document's purpose.
-
-### What it is (and is not)
-- A typeset reference dossier: composed, dense, a little cool \u2014 substantial at a glance, then readable. Density communicates substance; sparse and airy reads as "not much here."
-- Brand-skinned: pull the palette, type system, and a single accent from the app's spec. The accent leads labels and figures; it is a mark, not a fill.
-- NOT a slide deck \u2014 no theatrics, no building to a climax, no persuasion.
-- NOT a docs site \u2014 no raised or shadowed cards, no hover-lift, no clickable-feeling surfaces, no sticky table of contents.
-- NOT a sparse memo \u2014 a restrained single-column page under-sells the work.
-- No header chrome and no footer: open straight on the app's logo and name so it sits flush with the IDE.
-
-### Constraints
-- A single self-contained HTML file. Fonts may load from a CDN; everything else (CSS, the logo SVG) is inline.
-- Responsive: fills the embedded panel width and collapses gracefully at narrow widths.`;
-var OVERVIEW_SHELL = `<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="utf-8">
-<!-- This renders inside an iframe in the IDE. Keep it a simple, self-contained
-     static document \u2014 no scroll/zoom/accessibility scaffolding beyond this head.
-     The user-scalable=no viewport is intentional; leave it. -->
-<meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
-<title>Build Overview</title>
-<!-- SKIN: link the app's fonts here (CDN \u2014 e.g. Fontshare / Google Fonts). -->
-<style>
-*, *::before, *::after { margin: 0; padding: 0; box-sizing: border-box; }
-</style>
-</head>
-<body>
-<!-- Compose the Build Overview here. Layout, sections, type, and styling are
-     yours \u2014 keep everything inline and self-contained, brand-skinned from the
-     app's spec. -->
-</body>
-</html>`;
-function initialDelivery() {
-  return `### Your deliverable
-Write the complete Build Overview to \`${OVERVIEW_FILE}\`. The file does not exist yet \u2014 start from this scaffold, which carries the technical hygiene for the iframed render context (keep the viewport meta and the reset). Layout, sections, type, and styling are yours to compose.
-
-<overview_shell>
-${OVERVIEW_SHELL}
-</overview_shell>
-
-Then reply with a one-line summary of what you wrote.`;
-}
-function refreshDelivery() {
-  return `### Your deliverable
-The Build Overview already exists at \`${OVERVIEW_FILE}\`. Read it, then update it to reflect <overview_copy>, preserving its established skin \u2014 change only what the copy changed.
-
-Then reply with a one-line summary of what you changed.`;
-}
-var buildOverviewTool = {
-  definition: {
-    clearable: false,
-    name: "writeBuildOverview",
-    description: "Generate or refresh the Build Overview \u2014 the project's home page in the Spec tab: a single-page, plain-language reference of everything the app actually contains, including the parts the user can't see (data stores, backend operations, access and roles, background jobs, seeded scenarios, the design system). You author the full copy: read the manifest and spec and state, plainly and exactly, what genuinely exists \u2014 real names and accurate counts \u2014 in calm, declarative, present-tense outcome language, with no persuasion or hype. Describe only what exists. Pass the complete copy as `content`; the design expert lays it out and skins it to the app's brand using your copy verbatim \u2014 it typesets your words, it does not rewrite them, so polish the copy before you pass it. Generate it at the end of a build and refresh it after meaningful work.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        content: {
-          type: "string",
-          description: "The full Build Overview copy you authored: everything the app contains, in plain present-tense outcome language, with real names and exact counts. The design expert lays this out and skins it to the brand verbatim \u2014 it styles your words, it does not rewrite them \u2014 so this should be the final copy."
-        }
-      },
-      required: ["content"]
-    }
-  },
-  async execute(input, context) {
-    if (!context) {
-      return "Error: writeBuildOverview requires execution context for design expert delegation";
-    }
-    const content = (input.content ?? "").trim();
-    if (!content) {
-      return "Error: writeBuildOverview requires non-empty `content` (the overview copy).";
-    }
-    const exists = fs20.existsSync(OVERVIEW_FILE);
-    const task = `<overview_copy>${content}</overview_copy>
-
-${DESIGN_BRIEF}
-
-${exists ? refreshDelivery() : initialDelivery()}`;
-    try {
-      if (exists) {
-        input.background = true;
-        const result2 = await runDesignExpertRender(
-          { task, background: true, reportingName: "writeBuildOverview" },
-          context
-        );
-        context.subAgentMessages?.set(context.toolCallId, result2.messages);
-        return result2.text;
-      }
-      const result = await runDesignExpertRender({ task }, context);
-      context.subAgentMessages?.set(context.toolCallId, result.messages);
-      if (!fs20.existsSync(OVERVIEW_FILE)) {
-        return `Error: the design expert did not write ${OVERVIEW_FILE}. Its reply was:
-${result.text}`;
-      }
-      return `Build overview written to ${OVERVIEW_FILE}. ${result.text}`;
-    } catch (err) {
-      return `Error generating build overview: ${err.message}`;
-    }
-  }
-};
-
-// src/tools/index.ts
-function deriveContext(parent, toolCallId) {
-  return { ...parent, toolCallId };
+// src/tools/index.ts
+function deriveContext(parent, toolCallId) {
+  return { ...parent, toolCallId };
 }
 var ALL_TOOLS = [
   // Common
@@ -6381,7 +6454,11 @@ function getConversationMessagesForSummary(messages, endIndex) {
       break;
     }
   }
-  return messages.slice(startIdx, endIndex);
+  return messages.slice(startIdx, endIndex).filter(
+    (msg) => !(Array.isArray(msg.content) && msg.content.some(
+      (b) => b.type === "tool" && b.uiOnly
+    ))
+  );
 }
 function getSubAgentMessagesForSummary(messages, subAgentName, endIndex) {
   let checkpointIdx = -1;
@@ -6659,6 +6736,11 @@ import path12 from "path";
 var log10 = createLogger("session");
 var SESSION_FILE = ".remy-session.json";
 var ARCHIVE_DIR = ".logs/sessions";
+function writeFileAtomicSync(file, data) {
+  const tmp = `${file}.tmp`;
+  fs21.writeFileSync(tmp, data, "utf-8");
+  fs21.renameSync(tmp, file);
+}
 var ROTATE_THRESHOLD_BYTES = 32 * 1024 * 1024;
 var RETAIN_TAIL_BYTES = 16 * 1024 * 1024;
 var ARCHIVE_RETENTION_BYTES = 64 * 1024 * 1024;
@@ -6758,7 +6840,7 @@ function archiveMessages(messages, label, models) {
   if (models && Object.keys(models).length > 0) {
     payload.models = models;
   }
-  fs21.writeFileSync(dest, JSON.stringify(payload), "utf-8");
+  writeFileAtomicSync(dest, JSON.stringify(payload));
   archiveCountCache.set(path12.basename(dest), count);
   log10.info("Session archived", { label, dest, messageCount: count });
   pruneArchives();
@@ -6963,7 +7045,7 @@ function saveSession(state) {
     if (Buffer.byteLength(serialized, "utf-8") > ROTATE_THRESHOLD_BYTES && rotate(state)) {
       serialized = JSON.stringify(buildPayload(state));
     }
-    fs21.writeFileSync(SESSION_FILE, serialized, "utf-8");
+    writeFileAtomicSync(SESSION_FILE, serialized);
     log10.info("Session saved", { messageCount: state.messages.length });
   } catch (err) {
     log10.warn("Session save failed", { error: err.message });
@@ -6993,6 +7075,28 @@ function clearSession(state) {
 var log11 = createLogger("compaction:trigger");
 var pending = null;
 var inflightCompaction = null;
+function getInflightCompaction() {
+  return inflightCompaction;
+}
+function summariesOf(result) {
+  const out = [];
+  for (const msg of result.checkpoints) {
+    if (!Array.isArray(msg.content)) {
+      continue;
+    }
+    for (const block of msg.content) {
+      if (block.type === "summary") {
+        out.push({
+          name: block.name,
+          text: block.text,
+          ...block.recent && { recent: block.recent },
+          startedAt: block.startedAt
+        });
+      }
+    }
+  }
+  return out;
+}
 function applyPendingSummaries(state) {
   const drained = pending;
   pending = null;
@@ -7013,6 +7117,25 @@ function applyPendingSummaries(state) {
   });
   saveSession(state);
 }
+var SUMMARY_SECTION_LABELS = {
+  conversation: "Conversation",
+  visualDesignExpert: "Design Agent Thread",
+  productVision: "Roadmap Agent Thread"
+};
+function formatSummariesResult(summaries) {
+  if (summaries === null) {
+    return "A compaction checkpoint was already pending \u2014 no new compaction was needed.";
+  }
+  if (summaries.length === 0) {
+    return "Nothing to compact \u2014 the conversation is already fully summarized.";
+  }
+  if (summaries.length === 1 && summaries[0].name === "conversation") {
+    return summaries[0].text;
+  }
+  return summaries.map((s) => `## ${SUMMARY_SECTION_LABELS[s.name] ?? s.name}
+
+${s.text}`).join("\n\n");
+}
 var listener = null;
 function setCompactionListener(l) {
   listener = l;
@@ -7023,18 +7146,24 @@ function triggerCompaction(state, apiConfig, opts = {}) {
   }
   if (pending) {
     log11.info("Compaction skipped \u2014 a checkpoint is already waiting to apply");
-    return Promise.resolve();
+    return Promise.resolve(null);
   }
-  const { blocking = false, requestId, model } = opts;
-  listener?.({ type: "started", blocking, requestId });
+  const { blocking = false, requestId, model, origin, toolCallId } = opts;
+  listener?.({ type: "started", blocking, requestId, origin, toolCallId });
   inflightCompaction = compactConversation(
     state.messages,
     apiConfig,
     resolveModel("conversationSummarizer", state.models, model)
   ).then((result) => {
     pending = result;
-    listener?.({ type: "complete", requestId });
+    const summaries = summariesOf(result);
+    listener?.({
+      type: "complete",
+      requestId,
+      ...summaries.length > 0 && { summaries }
+    });
     log11.info("Compaction complete");
+    return summaries;
   }).catch((err) => {
     const message = err.message || "Compaction failed";
     listener?.({ type: "complete", error: message, requestId });
@@ -7554,6 +7683,62 @@ function parsePartialJson(jsonString) {
   return parseAny();
 }
 
+// src/automatedActions/resolve.ts
+var NON_ACTION_SENTINELS = /* @__PURE__ */ new Set(["background_results"]);
+function resolveAction(text) {
+  const parsed = parseSentinel(text);
+  if (!parsed) {
+    return null;
+  }
+  const { name: triggerName, remainder } = parsed;
+  if (NON_ACTION_SENTINELS.has(triggerName)) {
+    return null;
+  }
+  let params = {};
+  if (remainder) {
+    try {
+      params = JSON.parse(remainder.split("\n")[0]);
+    } catch {
+    }
+  }
+  let body = readAsset("automatedActions", `${triggerName}.md`);
+  let next;
+  const fmMatch = body.match(/^---\s*\n([\s\S]*?)\n---/);
+  if (fmMatch) {
+    const nextMatch = fmMatch[1].match(/^\s*next:\s*(\w+)\s*$/m);
+    if (nextMatch) {
+      next = nextMatch[1];
+    }
+  }
+  body = body.replace(/^---[\s\S]*?---\s*/, "");
+  for (const [key, value] of Object.entries(params)) {
+    const str = typeof value === "string" ? value : JSON.stringify(value);
+    body = body.replaceAll(`{{${key}}}`, str);
+  }
+  return {
+    message: automatedMessage(triggerName, body),
+    next
+  };
+}
+function getActionChain(startName) {
+  const chain = [];
+  const seen = /* @__PURE__ */ new Set();
+  let name = startName;
+  while (name && !seen.has(name)) {
+    seen.add(name);
+    chain.push(name);
+    let body;
+    try {
+      body = readAsset("automatedActions", `${name}.md`);
+    } catch {
+      break;
+    }
+    const fm = body.match(/^---\s*\n([\s\S]*?)\n---/);
+    name = fm?.[1].match(/^\s*next:\s*(\w+)\s*$/m)?.[1];
+  }
+  return chain;
+}
+
 // src/errors.ts
 var patterns = [
   [
@@ -7705,6 +7890,9 @@ async function runTurn(params) {
   let lastCompletedTools = "";
   let lastCompletedInput = "";
   let lastCompletedResult = "";
+  let subAgentText = "";
+  let currentToolNames = "";
+  let contentBlocksRef = [];
   let turnInputTokens = 0;
   let turnOutputTokens = 0;
   let turnCacheCreation = 0;
@@ -7713,281 +7901,328 @@ async function runTurn(params) {
   let lastCallInputTokens = 0;
   let lastCallCacheCreation = 0;
   let lastCallCacheRead = 0;
-  while (true) {
-    let getOrCreateAccumulator2 = function(id, name) {
-      let acc = toolInputAccumulators.get(id);
-      if (!acc) {
-        acc = { name, json: "", started: false, lastEmittedCount: 0 };
-        toolInputAccumulators.set(id, acc);
-      }
-      return acc;
-    };
-    var getOrCreateAccumulator = getOrCreateAccumulator2;
-    if (signal?.aborted) {
-      onEvent({ type: "turn_cancelled" });
-      saveSession(state);
-      return;
-    }
-    const iterStart = Date.now();
-    const contentBlocks = [];
-    const thinkingBlockStartTimes = [];
-    let thinkingCompleteCount = 0;
-    let lastThinkingRelatedStartedAt;
-    let textBlockOpen = false;
-    const toolInputAccumulators = /* @__PURE__ */ new Map();
-    let stopReason = "end_turn";
-    let turnProviderMetadata;
-    let turnModelId;
-    let subAgentText = "";
-    let currentToolNames = "";
-    const statusWatcher = isFirstMessage ? { stop() {
-    }, pause() {
-    }, resume() {
-    } } : startStatusWatcher({
-      apiConfig,
-      getContext: () => {
-        const parts = [];
-        const toolName = currentToolNames || getToolCalls(contentBlocks).filter((tc) => !STATUS_EXCLUDED_TOOLS.has(tc.name)).at(-1)?.name || lastCompletedTools;
-        if (toolName) {
-          parts.push(`Tool: ${toolName}`);
-        }
-        if (lastCompletedInput) {
-          parts.push(`Tool input: ${lastCompletedInput.slice(-1500)}`);
-        }
-        if (lastCompletedResult) {
-          parts.push(`Tool result: ${lastCompletedResult.slice(-1500)}`);
-        }
-        const text = subAgentText || getTextContent(contentBlocks).slice(-2e3);
-        if (text) {
-          parts.push(`Assistant text: ${text}`);
-        }
-        if (onboardingState && onboardingState !== "onboardingFinished") {
-          parts.push(`Build phase: ${onboardingState}`);
+  const statusWatcher = isFirstMessage ? { stop() {
+  }, pause() {
+  }, resume() {
+  } } : startStatusWatcher({
+    apiConfig,
+    getContext: () => {
+      const parts = [];
+      const toolName = currentToolNames || getToolCalls(contentBlocksRef).filter((tc) => !STATUS_EXCLUDED_TOOLS.has(tc.name)).at(-1)?.name || lastCompletedTools;
+      if (toolName) {
+        parts.push(`Tool: ${toolName}`);
+      }
+      const toolInput = sanitizeStatusText(lastCompletedInput);
+      if (toolInput) {
+        parts.push(`Tool input: ${toolInput.slice(-1500)}`);
+      }
+      const toolResult = sanitizeStatusText(lastCompletedResult);
+      if (toolResult) {
+        parts.push(`Tool result: ${toolResult.slice(-1500)}`);
+      }
+      const text = subAgentText || getTextContent(contentBlocksRef).slice(-2e3);
+      if (text) {
+        parts.push(`Assistant text: ${text}`);
+      }
+      if (onboardingState && onboardingState !== "onboardingFinished") {
+        parts.push(`Build phase: ${onboardingState}`);
+      }
+      let hasUserSignal = false;
+      for (const entry of keptEntries) {
+        if (entry.hidden) {
+          continue;
         }
-        for (const entry of keptEntries) {
-          const automated = parseSentinel(entry.text);
-          if (automated) {
+        const automated = parseSentinel(entry.text);
+        if (automated) {
+          if (!NON_ACTION_SENTINELS.has(automated.name)) {
             parts.push(`Automated action: ${automated.name}`);
-          } else if (entry.text) {
-            parts.push(`User request: ${entry.text.slice(-500)}`);
+            hasUserSignal = true;
           }
+        } else if (entry.text) {
+          parts.push(`User request: ${entry.text.slice(-500)}`);
+          hasUserSignal = true;
         }
-        return parts.join("\n");
-      },
-      onStatus: (label) => onEvent({ type: "status", message: label }),
-      signal
-    });
-    async function handlePartialInput(acc, id, name, partial) {
-      const tool = getToolByName(name);
-      if (!tool?.streaming) {
-        return;
       }
-      const {
-        contentField = "content",
-        transform,
-        partialInput
-      } = tool.streaming;
-      if (partialInput) {
-        const result = partialInput(partial, acc.lastEmittedCount);
-        if (!result) {
-          return;
-        }
-        acc.lastEmittedCount = result.emittedCount;
-        acc.started = true;
-        onEvent({
-          type: "tool_start",
-          id,
-          name,
-          input: result.input,
-          partial: true
-        });
-        return;
+      if (!hasUserSignal && !toolName && !text) {
+        return "";
       }
-      const content = partial[contentField];
-      if (typeof content !== "string") {
+      return parts.join("\n");
+    },
+    onStatus: (label) => onEvent({ type: "status", message: label }),
+    signal
+  });
+  try {
+    while (true) {
+      let getOrCreateAccumulator2 = function(id, name) {
+        let acc = toolInputAccumulators.get(id);
+        if (!acc) {
+          acc = { name, json: "", started: false, lastEmittedCount: 0 };
+          toolInputAccumulators.set(id, acc);
+        }
+        return acc;
+      };
+      var getOrCreateAccumulator = getOrCreateAccumulator2;
+      if (signal?.aborted) {
+        onEvent({ type: "turn_cancelled" });
+        saveSession(state);
         return;
       }
-      if (!acc.started) {
-        acc.started = true;
-        onEvent({ type: "tool_start", id, name, input: partial });
-      }
-      if (transform) {
-        const result = await transform(partial);
-        if (result === null) {
+      const iterStart = Date.now();
+      const contentBlocks = [];
+      const thinkingBlockStartTimes = [];
+      let thinkingCompleteCount = 0;
+      let lastThinkingRelatedStartedAt;
+      let textBlockOpen = false;
+      const toolInputAccumulators = /* @__PURE__ */ new Map();
+      let stopReason = "end_turn";
+      let turnProviderMetadata;
+      let turnModelId;
+      contentBlocksRef = contentBlocks;
+      subAgentText = "";
+      currentToolNames = "";
+      async function handlePartialInput(acc, id, name, partial) {
+        const tool = getToolByName(name);
+        if (!tool?.streaming) {
           return;
         }
-        onEvent({ type: "tool_input_delta", id, name, result });
-      } else {
-        onEvent({ type: "tool_input_delta", id, name, result: content });
-      }
-    }
-    try {
-      for await (const event of streamChatWithRetry(
-        {
-          ...apiConfig,
-          model: parentModel,
-          requestId,
-          system,
-          messages: cleanMessagesForApi(state.messages),
-          tools: tools2,
-          signal
-        },
-        {
-          onRetry: (attempt) => {
-            onEvent({
-              type: "status",
-              message: `Lost connection, retrying (attempt ${attempt + 2} of 3)`
-            });
+        const {
+          contentField = "content",
+          transform,
+          partialInput
+        } = tool.streaming;
+        if (partialInput) {
+          const result = partialInput(partial, acc.lastEmittedCount);
+          if (!result) {
+            return;
           }
+          acc.lastEmittedCount = result.emittedCount;
+          acc.started = true;
+          onEvent({
+            type: "tool_start",
+            id,
+            name,
+            input: result.input,
+            partial: true
+          });
+          return;
         }
-      )) {
-        if (signal?.aborted) {
-          break;
+        const content = partial[contentField];
+        if (typeof content !== "string") {
+          return;
         }
-        switch (event.type) {
-          case "text": {
-            const lastBlock = contentBlocks.at(-1);
-            if (lastBlock?.type === "text" && textBlockOpen) {
-              lastBlock.text += event.text;
-            } else {
-              contentBlocks.push({
-                type: "text",
-                text: event.text,
-                startedAt: event.ts
-              });
-            }
-            textBlockOpen = true;
-            onEvent({ type: "text", text: event.text });
-            break;
+        if (!acc.started) {
+          acc.started = true;
+          onEvent({ type: "tool_start", id, name, input: partial });
+        }
+        if (transform) {
+          const result = await transform(partial);
+          if (result === null) {
+            return;
           }
-          case "thinking":
-            if (event.text === "") {
-              thinkingBlockStartTimes.push(event.ts);
-              textBlockOpen = false;
+          onEvent({ type: "tool_input_delta", id, name, result });
+        } else {
+          onEvent({ type: "tool_input_delta", id, name, result: content });
+        }
+      }
+      try {
+        for await (const event of streamChatWithRetry(
+          {
+            ...apiConfig,
+            model: parentModel,
+            requestId,
+            system,
+            messages: cleanMessagesForApi(state.messages),
+            tools: tools2,
+            signal
+          },
+          {
+            onRetry: (attempt) => {
+              onEvent({
+                type: "status",
+                message: `Lost connection, retrying (attempt ${attempt + 2} of 3)`
+              });
             }
-            onEvent({ type: "thinking", text: event.text });
-            break;
-          case "thinking_complete": {
-            const startedAt = thinkingBlockStartTimes[thinkingCompleteCount] ?? event.ts;
-            contentBlocks.push({
-              type: "thinking",
-              thinking: event.thinking,
-              signature: event.signature,
-              startedAt,
-              completedAt: event.ts
-            });
-            thinkingCompleteCount++;
-            lastThinkingRelatedStartedAt = startedAt;
-            break;
           }
-          case "redacted_thinking_complete": {
-            const startedAt = lastThinkingRelatedStartedAt !== void 0 ? lastThinkingRelatedStartedAt + 1 : event.ts;
-            contentBlocks.push({
-              type: "redacted_thinking",
-              data: event.data,
-              startedAt,
-              completedAt: event.ts
-            });
-            lastThinkingRelatedStartedAt = startedAt;
+        )) {
+          if (signal?.aborted) {
             break;
           }
-          case "tool_input_delta": {
-            const acc = getOrCreateAccumulator2(event.id, event.name);
-            acc.json += event.delta;
-            try {
-              const partial = parsePartialJson(acc.json);
-              await handlePartialInput(acc, event.id, event.name, partial);
-            } catch {
+          switch (event.type) {
+            case "text": {
+              const lastBlock = contentBlocks.at(-1);
+              if (lastBlock?.type === "text" && textBlockOpen) {
+                lastBlock.text += event.text;
+              } else {
+                contentBlocks.push({
+                  type: "text",
+                  text: event.text,
+                  startedAt: event.ts
+                });
+              }
+              textBlockOpen = true;
+              onEvent({ type: "text", text: event.text });
+              break;
             }
-            break;
-          }
-          case "tool_input_args": {
-            const acc = getOrCreateAccumulator2(event.id, event.name);
-            await handlePartialInput(acc, event.id, event.name, event.args);
-            break;
-          }
-          case "tool_use": {
-            const tool = getToolByName(event.name);
-            contentBlocks.push({
-              type: "tool",
-              id: event.id,
-              name: event.name,
-              input: event.input,
-              startedAt: event.ts,
-              ...(event.input.background || tool?.backgroundOnly) && {
-                background: true
+            case "thinking":
+              if (event.text === "") {
+                thinkingBlockStartTimes.push(event.ts);
+                textBlockOpen = false;
               }
-            });
-            const acc = toolInputAccumulators.get(event.id);
-            const wasStreamed = acc?.started ?? false;
-            const isInputStreaming = !!tool?.streaming?.partialInput;
-            log14.info("Tool received", {
-              requestId,
-              toolCallId: event.id,
-              name: event.name
-            });
-            if (!wasStreamed || isInputStreaming) {
-              onEvent({
-                type: "tool_start",
+              onEvent({ type: "thinking", text: event.text });
+              break;
+            case "thinking_complete": {
+              const startedAt = thinkingBlockStartTimes[thinkingCompleteCount] ?? event.ts;
+              contentBlocks.push({
+                type: "thinking",
+                thinking: event.thinking,
+                signature: event.signature,
+                startedAt,
+                completedAt: event.ts
+              });
+              thinkingCompleteCount++;
+              lastThinkingRelatedStartedAt = startedAt;
+              break;
+            }
+            case "redacted_thinking_complete": {
+              const startedAt = lastThinkingRelatedStartedAt !== void 0 ? lastThinkingRelatedStartedAt + 1 : event.ts;
+              contentBlocks.push({
+                type: "redacted_thinking",
+                data: event.data,
+                startedAt,
+                completedAt: event.ts
+              });
+              lastThinkingRelatedStartedAt = startedAt;
+              break;
+            }
+            case "tool_input_delta": {
+              const acc = getOrCreateAccumulator2(event.id, event.name);
+              acc.json += event.delta;
+              try {
+                const partial = parsePartialJson(acc.json);
+                await handlePartialInput(acc, event.id, event.name, partial);
+              } catch {
+              }
+              break;
+            }
+            case "tool_input_args": {
+              const acc = getOrCreateAccumulator2(event.id, event.name);
+              await handlePartialInput(acc, event.id, event.name, event.args);
+              break;
+            }
+            case "tool_use": {
+              const tool = getToolByName(event.name);
+              contentBlocks.push({
+                type: "tool",
                 id: event.id,
                 name: event.name,
-                input: event.input
+                input: event.input,
+                startedAt: event.ts,
+                ...(event.input.background || tool?.backgroundOnly) && {
+                  background: true
+                }
+              });
+              const acc = toolInputAccumulators.get(event.id);
+              const wasStreamed = acc?.started ?? false;
+              const isInputStreaming = !!tool?.streaming?.partialInput;
+              log14.info("Tool received", {
+                requestId,
+                toolCallId: event.id,
+                name: event.name
               });
+              if (!wasStreamed || isInputStreaming) {
+                onEvent({
+                  type: "tool_start",
+                  id: event.id,
+                  name: event.name,
+                  input: event.input,
+                  // Mirror the content-block stamp above so the live event
+                  // matches what a history reload shows — without it the
+                  // frontend renders background rows as already complete.
+                  ...isBackgroundCall({
+                    name: event.name,
+                    input: event.input
+                  }) && { background: true }
+                });
+              }
+              break;
             }
-            break;
+            case "done":
+              stopReason = event.stopReason;
+              turnProviderMetadata = event.providerMetadata;
+              turnModelId = event.modelId;
+              turnLlmCalls++;
+              lastCallInputTokens = event.usage.inputTokens;
+              lastCallCacheCreation = event.usage.cacheCreationTokens ?? 0;
+              lastCallCacheRead = event.usage.cacheReadTokens ?? 0;
+              turnInputTokens += lastCallInputTokens;
+              turnOutputTokens += event.usage.outputTokens;
+              turnCacheCreation += lastCallCacheCreation;
+              turnCacheRead += lastCallCacheRead;
+              recordUsage({
+                ts: Date.now(),
+                requestId,
+                agentName: "parent",
+                modelId: event.modelId,
+                inputTokens: event.usage.inputTokens,
+                outputTokens: event.usage.outputTokens,
+                cacheCreationTokens: event.usage.cacheCreationTokens,
+                cacheReadTokens: event.usage.cacheReadTokens,
+                cost: nanoToDollars(event.cost),
+                billingEvents: event.billingEvents,
+                durationMs: Date.now() - iterStart,
+                toolNames: contentBlocks.filter(
+                  (b) => b.type === "tool"
+                ).map((b) => b.name)
+              });
+              break;
+            case "error":
+              statusWatcher.stop();
+              onEvent({
+                type: "error",
+                error: friendlyError(event.error),
+                ...event.code ? { code: event.code } : {}
+              });
+              return;
           }
-          case "done":
-            stopReason = event.stopReason;
-            turnProviderMetadata = event.providerMetadata;
-            turnModelId = event.modelId;
-            turnLlmCalls++;
-            lastCallInputTokens = event.usage.inputTokens;
-            lastCallCacheCreation = event.usage.cacheCreationTokens ?? 0;
-            lastCallCacheRead = event.usage.cacheReadTokens ?? 0;
-            turnInputTokens += lastCallInputTokens;
-            turnOutputTokens += event.usage.outputTokens;
-            turnCacheCreation += lastCallCacheCreation;
-            turnCacheRead += lastCallCacheRead;
-            recordUsage({
-              ts: Date.now(),
-              requestId,
-              agentName: "parent",
-              modelId: event.modelId,
-              inputTokens: event.usage.inputTokens,
-              outputTokens: event.usage.outputTokens,
-              cacheCreationTokens: event.usage.cacheCreationTokens,
-              cacheReadTokens: event.usage.cacheReadTokens,
-              cost: nanoToDollars(event.cost),
-              billingEvents: event.billingEvents,
-              durationMs: Date.now() - iterStart,
-              toolNames: contentBlocks.filter(
-                (b) => b.type === "tool"
-              ).map((b) => b.name)
-            });
-            break;
-          case "error":
-            onEvent({
-              type: "error",
-              error: friendlyError(event.error),
-              ...event.code ? { code: event.code } : {}
-            });
-            return;
+        }
+      } catch (err) {
+        if (signal?.aborted) {
+        } else {
+          throw err;
         }
       }
-    } catch (err) {
       if (signal?.aborted) {
-      } else {
-        throw err;
+        statusWatcher.stop();
+        if (contentBlocks.length > 0) {
+          contentBlocks.push({
+            type: "text",
+            text: "\n\n(cancelled)",
+            startedAt: Date.now()
+          });
+          state.messages.push({
+            role: "assistant",
+            content: [...contentBlocks].sort(
+              (a, b) => a.startedAt - b.startedAt
+            ),
+            usage: {
+              inputTokens: turnInputTokens,
+              outputTokens: turnOutputTokens,
+              cacheCreationTokens: turnCacheCreation || void 0,
+              cacheReadTokens: turnCacheRead || void 0,
+              llmCalls: turnLlmCalls
+            },
+            ...turnProviderMetadata && {
+              providerMetadata: turnProviderMetadata
+            },
+            model: turnModelId ?? parentModel,
+            ...modelOverride && { modelOverride }
+          });
+        }
+        onEvent({ type: "turn_cancelled" });
+        saveSession(state);
+        return;
       }
-    }
-    if (signal?.aborted) {
-      statusWatcher.stop();
       if (contentBlocks.length > 0) {
-        contentBlocks.push({
-          type: "text",
-          text: "\n\n(cancelled)",
-          startedAt: Date.now()
-        });
         state.messages.push({
           role: "assistant",
           content: [...contentBlocks].sort((a, b) => a.startedAt - b.startedAt),
@@ -8005,229 +8240,212 @@ async function runTurn(params) {
           ...modelOverride && { modelOverride }
         });
       }
-      onEvent({ type: "turn_cancelled" });
-      saveSession(state);
-      return;
-    }
-    if (contentBlocks.length > 0) {
-      state.messages.push({
-        role: "assistant",
-        content: [...contentBlocks].sort((a, b) => a.startedAt - b.startedAt),
-        usage: {
-          inputTokens: turnInputTokens,
-          outputTokens: turnOutputTokens,
-          cacheCreationTokens: turnCacheCreation || void 0,
-          cacheReadTokens: turnCacheRead || void 0,
-          llmCalls: turnLlmCalls
-        },
-        ...turnProviderMetadata && { providerMetadata: turnProviderMetadata },
-        model: turnModelId ?? parentModel,
-        ...modelOverride && { modelOverride }
-      });
-    }
-    const toolCalls = getToolCalls(contentBlocks);
-    if (stopReason !== "tool_use" || toolCalls.length === 0) {
-      statusWatcher.stop();
-      saveSession(state);
-      onEvent({
-        type: "turn_done",
-        stats: {
-          inputTokens: turnInputTokens,
-          outputTokens: turnOutputTokens,
-          cacheCreationTokens: turnCacheCreation || void 0,
-          cacheReadTokens: turnCacheRead || void 0,
-          llmCalls: turnLlmCalls,
-          lastCallInputTokens,
-          lastCallCacheCreation: lastCallCacheCreation || void 0,
-          lastCallCacheRead: lastCallCacheRead || void 0
-        }
-      });
-      return;
-    }
-    log14.info("Tools executing", {
-      requestId,
-      count: toolCalls.length,
-      tools: toolCalls.map((tc) => tc.name)
-    });
-    currentToolNames = toolCalls.filter((tc) => !STATUS_EXCLUDED_TOOLS.has(tc.name)).map((tc) => tc.name).join(", ");
-    const wrappedOnEvent = (e) => {
-      if ("parentToolId" in e && e.parentToolId) {
-        if (e.type === "text") {
-          subAgentText = e.text;
-        } else if (e.type === "tool_start") {
-          subAgentText = `Using ${e.name}`;
-        }
+      const toolCalls = getToolCalls(contentBlocks);
+      if (stopReason !== "tool_use" || toolCalls.length === 0) {
+        statusWatcher.stop();
+        saveSession(state);
+        onEvent({
+          type: "turn_done",
+          stats: {
+            inputTokens: turnInputTokens,
+            outputTokens: turnOutputTokens,
+            cacheCreationTokens: turnCacheCreation || void 0,
+            cacheReadTokens: turnCacheRead || void 0,
+            llmCalls: turnLlmCalls,
+            lastCallInputTokens,
+            lastCallCacheCreation: lastCallCacheCreation || void 0,
+            lastCallCacheRead: lastCallCacheRead || void 0
+          }
+        });
+        return;
       }
-      onEvent(e);
-    };
-    const subAgentMessages = /* @__PURE__ */ new Map();
-    const results = await Promise.all(
-      toolCalls.map(async (tc) => {
-        if (signal?.aborted) {
-          return { id: tc.id, result: USER_CANCELLED_RESULT, isError: true };
+      log14.info("Tools executing", {
+        requestId,
+        count: toolCalls.length,
+        tools: toolCalls.map((tc) => tc.name)
+      });
+      currentToolNames = toolCalls.filter((tc) => !STATUS_EXCLUDED_TOOLS.has(tc.name)).map((tc) => tc.name).join(", ");
+      const wrappedOnEvent = (e) => {
+        if ("parentToolId" in e && e.parentToolId) {
+          if (e.type === "text") {
+            subAgentText = e.text;
+          } else if (e.type === "tool_start") {
+            subAgentText = `Using ${e.name}`;
+          }
         }
-        const toolStart = Date.now();
-        let settle;
-        const resultPromise = new Promise((res) => {
-          settle = (result, isError) => res({ id: tc.id, result, isError });
-        });
-        let toolAbort = new AbortController();
-        let settled = false;
-        const safeSettle = (result, isError) => {
-          if (settled) {
-            return;
+        onEvent(e);
+      };
+      const subAgentMessages = /* @__PURE__ */ new Map();
+      const results = await Promise.all(
+        toolCalls.map(async (tc) => {
+          if (signal?.aborted) {
+            return { id: tc.id, result: USER_CANCELLED_RESULT, isError: true };
           }
-          settled = true;
-          signal?.removeEventListener("abort", cascadeAbort);
-          settle(result, isError);
-        };
-        const cascadeAbort = () => {
-          toolAbort.abort();
-          safeSettle(USER_CANCELLED_RESULT, true);
-        };
-        signal?.addEventListener("abort", cascadeAbort, { once: true });
-        const run = async (input) => {
-          try {
-            let result;
-            if (EXTERNAL_TOOLS.has(tc.name) && resolveExternalTool) {
-              saveSession(state);
-              log14.info("Waiting for external tool result", {
-                requestId,
-                toolCallId: tc.id,
-                name: tc.name
-              });
-              const blocksUser = USER_BLOCKING_EXTERNAL_TOOLS.has(tc.name);
-              if (blocksUser) {
-                statusWatcher.pause();
-              }
-              try {
-                result = await resolveExternalTool(tc.id, tc.name, input);
-              } finally {
+          const toolStart = Date.now();
+          let settle;
+          const resultPromise = new Promise((res) => {
+            settle = (result, isError) => res({ id: tc.id, result, isError });
+          });
+          let toolAbort = new AbortController();
+          let settled = false;
+          const safeSettle = (result, isError) => {
+            if (settled) {
+              return;
+            }
+            settled = true;
+            signal?.removeEventListener("abort", cascadeAbort);
+            settle(result, isError);
+          };
+          const cascadeAbort = () => {
+            toolAbort.abort();
+            safeSettle(USER_CANCELLED_RESULT, true);
+          };
+          signal?.addEventListener("abort", cascadeAbort, { once: true });
+          const run = async (input) => {
+            try {
+              let result;
+              if (EXTERNAL_TOOLS.has(tc.name) && resolveExternalTool) {
+                saveSession(state);
+                log14.info("Waiting for external tool result", {
+                  requestId,
+                  toolCallId: tc.id,
+                  name: tc.name
+                });
+                const blocksUser = USER_BLOCKING_EXTERNAL_TOOLS.has(tc.name);
                 if (blocksUser) {
-                  statusWatcher.resume();
+                  statusWatcher.pause();
                 }
+                try {
+                  result = await resolveExternalTool(tc.id, tc.name, input);
+                } finally {
+                  if (blocksUser) {
+                    statusWatcher.resume();
+                  }
+                }
+              } else {
+                result = await executeTool(tc.name, input, {
+                  apiConfig,
+                  model,
+                  models: state.models,
+                  signal: toolAbort.signal,
+                  onEvent: wrappedOnEvent,
+                  resolveExternalTool,
+                  toolCallId: tc.id,
+                  requestId,
+                  onboardingState,
+                  subAgentMessages,
+                  conversationMessages: state.messages,
+                  toolRegistry,
+                  onBackgroundComplete,
+                  onLog: (line) => wrappedOnEvent({
+                    type: "tool_input_delta",
+                    id: tc.id,
+                    name: tc.name,
+                    result: line
+                  })
+                });
               }
-            } else {
-              result = await executeTool(tc.name, input, {
-                apiConfig,
-                model,
-                models: state.models,
-                signal: toolAbort.signal,
-                onEvent: wrappedOnEvent,
-                resolveExternalTool,
-                toolCallId: tc.id,
-                requestId,
-                onboardingState,
-                subAgentMessages,
-                conversationMessages: state.messages,
-                toolRegistry,
-                onBackgroundComplete,
-                onLog: (line) => wrappedOnEvent({
-                  type: "tool_input_delta",
-                  id: tc.id,
-                  name: tc.name,
-                  result: line
-                })
+              safeSettle(capToolResult(result), result.startsWith("Error"));
+            } catch (err) {
+              safeSettle(`Error: ${err.message}`, true);
+            }
+          };
+          const entry = {
+            id: tc.id,
+            name: tc.name,
+            input: tc.input,
+            abortController: toolAbort,
+            startedAt: toolStart,
+            settle: safeSettle,
+            rerun: (newInput) => {
+              settled = false;
+              toolAbort = new AbortController();
+              signal?.addEventListener("abort", () => toolAbort.abort(), {
+                once: true
               });
+              entry.abortController = toolAbort;
+              entry.input = newInput;
+              run(newInput);
             }
-            safeSettle(capToolResult(result), result.startsWith("Error"));
-          } catch (err) {
-            safeSettle(`Error: ${err.message}`, true);
+          };
+          toolRegistry?.register(entry);
+          run(tc.input);
+          const r = await resultPromise;
+          if (!isBackgroundCall(tc)) {
+            toolRegistry?.unregister(tc.id);
           }
-        };
-        const entry = {
-          id: tc.id,
-          name: tc.name,
-          input: tc.input,
-          abortController: toolAbort,
-          startedAt: toolStart,
-          settle: safeSettle,
-          rerun: (newInput) => {
-            settled = false;
-            toolAbort = new AbortController();
-            signal?.addEventListener("abort", () => toolAbort.abort(), {
-              once: true
-            });
-            entry.abortController = toolAbort;
-            entry.input = newInput;
-            run(newInput);
+          log14.info("Tool completed", {
+            requestId,
+            toolCallId: tc.id,
+            name: tc.name,
+            durationMs: Date.now() - toolStart,
+            isError: r.isError
+          });
+          onEvent({
+            type: "tool_done",
+            id: tc.id,
+            name: tc.name,
+            result: r.result,
+            isError: r.isError
+          });
+          if (!r.isError && BRAND_TRIGGERING_TOOLS.has(tc.name)) {
+            triggerBrandExtraction(
+              apiConfig,
+              resolveModel("brandExtractor", state.models, model)
+            );
           }
-        };
-        toolRegistry?.register(entry);
-        run(tc.input);
-        const r = await resultPromise;
-        if (!isBackgroundCall(tc)) {
-          toolRegistry?.unregister(tc.id);
-        }
-        log14.info("Tool completed", {
-          requestId,
-          toolCallId: tc.id,
-          name: tc.name,
-          durationMs: Date.now() - toolStart,
-          isError: r.isError
-        });
-        onEvent({
-          type: "tool_done",
-          id: tc.id,
-          name: tc.name,
-          result: r.result,
-          isError: r.isError
-        });
-        if (!r.isError && BRAND_TRIGGERING_TOOLS.has(tc.name)) {
-          triggerBrandExtraction(
-            apiConfig,
-            resolveModel("brandExtractor", state.models, model)
-          );
-        }
-        return r;
-      })
-    );
-    statusWatcher.stop();
-    for (const r of results) {
-      const block = contentBlocks.find(
-        (b) => b.type === "tool" && b.id === r.id
+          return r;
+        })
       );
-      if (block?.type === "tool") {
-        block.result = r.result;
-        block.isError = r.isError;
-        block.completedAt = Date.now();
-        const msgs = subAgentMessages.get(r.id);
-        if (msgs) {
-          block.subAgentMessages = msgs;
+      for (const r of results) {
+        const block = contentBlocks.find(
+          (b) => b.type === "tool" && b.id === r.id
+        );
+        if (block?.type === "tool") {
+          block.result = r.result;
+          block.isError = r.isError;
+          block.completedAt = Date.now();
+          const msgs = subAgentMessages.get(r.id);
+          if (msgs) {
+            block.subAgentMessages = msgs;
+          }
         }
       }
-    }
-    const lastNonExcluded = toolCalls.filter(
-      (tc) => !STATUS_EXCLUDED_TOOLS.has(tc.name)
-    );
-    lastCompletedTools = lastNonExcluded.map((tc) => tc.name).join(", ");
-    lastCompletedInput = JSON.stringify(lastNonExcluded.at(-1)?.input ?? {});
-    lastCompletedResult = results.at(-1)?.result ?? "";
-    for (const r of results) {
-      state.messages.push({
-        role: "user",
-        content: r.result,
-        toolCallId: r.id,
-        isToolError: r.isError
-      });
-    }
-    if (takeSteering && !signal?.aborted) {
-      const injected = (await takeSteering()).filter(
-        (e) => e.text.trim().length > 0 || (e.attachments?.length ?? 0) > 0
+      const lastNonExcluded = toolCalls.filter(
+        (tc) => !STATUS_EXCLUDED_TOOLS.has(tc.name)
       );
-      if (injected.length > 0) {
-        for (const entry of injected) {
-          appendEntry(entry);
-          keptEntries.push(entry);
+      lastCompletedTools = lastNonExcluded.map((tc) => tc.name).join(", ");
+      lastCompletedInput = JSON.stringify(lastNonExcluded.at(-1)?.input ?? {});
+      lastCompletedResult = results.at(-1)?.result ?? "";
+      for (const r of results) {
+        state.messages.push({
+          role: "user",
+          content: r.result,
+          toolCallId: r.id,
+          isToolError: r.isError
+        });
+      }
+      if (takeSteering && !signal?.aborted) {
+        const injected = (await takeSteering()).filter(
+          (e) => e.text.trim().length > 0 || (e.attachments?.length ?? 0) > 0
+        );
+        if (injected.length > 0) {
+          for (const entry of injected) {
+            appendEntry(entry);
+            keptEntries.push(entry);
+          }
+          saveSession(state);
         }
+      }
+      if (signal?.aborted) {
+        statusWatcher.stop();
+        onEvent({ type: "turn_cancelled" });
         saveSession(state);
+        return;
       }
     }
-    if (signal?.aborted) {
-      onEvent({ type: "turn_cancelled" });
-      saveSession(state);
-      return;
-    }
+  } finally {
+    statusWatcher.stop();
   }
 }
 
@@ -8511,62 +8729,6 @@ var MessageQueue = class {
   }
 };
 
-// src/automatedActions/resolve.ts
-var NON_ACTION_SENTINELS = /* @__PURE__ */ new Set(["background_results"]);
-function resolveAction(text) {
-  const parsed = parseSentinel(text);
-  if (!parsed) {
-    return null;
-  }
-  const { name: triggerName, remainder } = parsed;
-  if (NON_ACTION_SENTINELS.has(triggerName)) {
-    return null;
-  }
-  let params = {};
-  if (remainder) {
-    try {
-      params = JSON.parse(remainder.split("\n")[0]);
-    } catch {
-    }
-  }
-  let body = readAsset("automatedActions", `${triggerName}.md`);
-  let next;
-  const fmMatch = body.match(/^---\s*\n([\s\S]*?)\n---/);
-  if (fmMatch) {
-    const nextMatch = fmMatch[1].match(/^\s*next:\s*(\w+)\s*$/m);
-    if (nextMatch) {
-      next = nextMatch[1];
-    }
-  }
-  body = body.replace(/^---[\s\S]*?---\s*/, "");
-  for (const [key, value] of Object.entries(params)) {
-    const str = typeof value === "string" ? value : JSON.stringify(value);
-    body = body.replaceAll(`{{${key}}}`, str);
-  }
-  return {
-    message: automatedMessage(triggerName, body),
-    next
-  };
-}
-function getActionChain(startName) {
-  const chain = [];
-  const seen = /* @__PURE__ */ new Set();
-  let name = startName;
-  while (name && !seen.has(name)) {
-    seen.add(name);
-    chain.push(name);
-    let body;
-    try {
-      body = readAsset("automatedActions", `${name}.md`);
-    } catch {
-      break;
-    }
-    const fm = body.match(/^---\s*\n([\s\S]*?)\n---/);
-    name = fm?.[1].match(/^\s*next:\s*(\w+)\s*$/m)?.[1];
-  }
-  return chain;
-}
-
 // src/headless/index.ts
 var log16 = createLogger("headless");
 var EXTERNAL_TOOL_TIMEOUT_MS = 3e5;
@@ -8622,6 +8784,13 @@ var HeadlessSession = class {
   earlyResults = /* @__PURE__ */ new Map();
   // Tool block updates from background completions (separate from the message queue)
   pendingBlockUpdates = [];
+  /**
+   * Id of the UI-only tool block synthesized for the in-flight user/gate
+   * compaction (see the compaction listener). Model-invoked compactions have
+   * a real block and never set this. Single slot — triggerCompaction is
+   * single-flight.
+   */
+  syntheticCompactionId = null;
   // Tool lifecycle management — shared across all nesting depths
   toolRegistry = new ToolRegistry();
   // IO — accumulates stdin bytes between newline boundaries
@@ -8653,6 +8822,7 @@ var HeadlessSession = class {
       this.emit("queue_changed", { queuedMessages: this.queue.snapshot() });
     });
     this.passivePen = loadPassiveResults();
+    this.persistStats();
     if (resumed) {
       this.emit("session_restored", {
         messageCount: this.state.messages.length,
@@ -8675,15 +8845,61 @@ var HeadlessSession = class {
         );
         this.sessionStats.compactionInProgress = true;
         this.persistStats();
+        if (!event.toolCallId && (event.origin === "user" || event.origin === "gate")) {
+          const id = `compact_${Date.now()}`;
+          this.syntheticCompactionId = id;
+          this.state.messages.push({
+            role: "assistant",
+            content: [
+              {
+                type: "tool",
+                id,
+                name: "compactConversation",
+                input: {},
+                startedAt: Date.now(),
+                background: true,
+                uiOnly: true,
+                result: "Compaction started in the background."
+              }
+            ]
+          });
+          saveSession(this.state);
+          this.onEvent({
+            type: "tool_start",
+            id,
+            name: "compactConversation",
+            input: {},
+            background: true
+          });
+          this.onEvent({
+            type: "tool_done",
+            id,
+            name: "compactConversation",
+            result: "Compaction started in the background.",
+            isError: false
+          });
+        }
       } else {
         const data = event.error ? { error: event.error } : {};
         this.emit("compaction_complete", data, event.requestId);
+        if (this.syntheticCompactionId) {
+          const id = this.syntheticCompactionId;
+          this.syntheticCompactionId = null;
+          this.onBackgroundComplete(
+            id,
+            "compactConversation",
+            event.error ? `Error: ${event.error}` : formatSummariesResult(event.summaries ?? [])
+          );
+        }
         this.sessionStats.compactionInProgress = false;
         if (!event.error) {
           this.sessionStats.lastContextSize = 0;
         }
         this.sessionStats.messageCount = this.state.messages.length;
         this.persistStats();
+        if (!this.running) {
+          this.kickDrain();
+        }
       }
     });
     process.stdin.setEncoding("utf-8");
@@ -8822,7 +9038,8 @@ var HeadlessSession = class {
       await triggerCompaction(this.state, this.config, {
         blocking: true,
         requestId,
-        model: this.opts.model
+        model: this.opts.model,
+        origin: "gate"
       });
       applyPendingSummaries(this.state);
     } catch {
@@ -8851,6 +9068,12 @@ var HeadlessSession = class {
       }
       return;
     }
+    if (notify === "silent") {
+      if (!this.running) {
+        this.applyPendingBlockUpdates();
+      }
+      return;
+    }
     this.queue.push({
       command: {
         action: "message",
@@ -9232,6 +9455,12 @@ var HeadlessSession = class {
     this.completedEmitted = false;
     this.lastCompleted = null;
     this.turnStart = Date.now();
+    const inflight2 = getInflightCompaction();
+    if (inflight2) {
+      await inflight2.catch(() => {
+      });
+    }
+    applyPendingSummaries(this.state);
     if (this.passivePen.length > 0) {
       const swept = this.passivePen.splice(0);
       this.persistStats();
@@ -9321,7 +9550,7 @@ var HeadlessSession = class {
     this.applyPendingBlockUpdates();
   }
   async handleMessage(parsed, requestId) {
-    if (this.running) {
+    if (this.running || getInflightCompaction()) {
       const command = { ...parsed };
       if (requestId && command.requestId === void 0) {
         command.requestId = requestId;
@@ -9331,6 +9560,9 @@ var HeadlessSession = class {
         source: "user",
         enqueuedAt: Date.now()
       });
+      if (!this.running && !getInflightCompaction()) {
+        this.kickDrain();
+      }
       return;
     }
     this.running = true;
@@ -9338,6 +9570,7 @@ var HeadlessSession = class {
       await this.runSingleTurn(parsed, requestId);
       await this.drainQueueLoop();
     } finally {
+      this.currentAbort?.abort();
       this.currentAbort = null;
       this.currentRequestId = void 0;
       this.running = false;
@@ -9369,6 +9602,18 @@ var HeadlessSession = class {
   async drainQueueLoop() {
     while (this.queue.length > 0) {
       const head = this.queue.peek();
+      if (head.command.action === "compact") {
+        this.queue.shift();
+        await triggerCompaction(this.state, this.config, {
+          blocking: true,
+          requestId: head.command.requestId,
+          model: this.opts.model,
+          origin: "user"
+        }).catch(() => {
+        });
+        applyPendingSummaries(this.state);
+        continue;
+      }
       if (head.source === "chain") {
         const item = this.queue.shift();
         const rid = item.command.requestId ?? `chain-${Date.now()}`;
@@ -9413,6 +9658,7 @@ var HeadlessSession = class {
     try {
       await this.drainQueueLoop();
     } finally {
+      this.currentAbort?.abort();
       this.currentAbort = null;
       this.currentRequestId = void 0;
       this.running = false;
@@ -9659,11 +9905,31 @@ var HeadlessSession = class {
       return;
     }
     if (action === "compact") {
+      if (this.running) {
+        const alreadyQueued = this.queue.snapshot().some((it) => it.command.action === "compact");
+        if (!alreadyQueued) {
+          this.queue.push({
+            command: {
+              action: "compact",
+              // Display label for the queue card (matches the automated
+              // action idiom); never resolved as an action — drainQueueLoop
+              // routes on command.action before any sentinel handling.
+              text: sentinel("compact"),
+              requestId
+            },
+            source: "user",
+            enqueuedAt: Date.now()
+          });
+        }
+        this.emit("completed", { success: true, queued: true }, requestId);
+        return;
+      }
       try {
         await triggerCompaction(this.state, this.config, {
           blocking: false,
           requestId,
-          model: this.opts.model
+          model: this.opts.model,
+          origin: "user"
         });
         if (!this.running) {
           applyPendingSummaries(this.state);