@mindstudio-ai/remy 0.1.26 → 0.1.28

package/dist/index.js

@@ -904,7 +904,7 @@ var init_promptUser = __esm({
                         }
                       ]
                     },
-                    description: "Options for select and checklist types. Each can be a string or { label, description }."
+                    description: "Options for select and checklist types. Each can be a string or { label, description }. Image URLs (e.g. https://i.mscdn.ai/...) are rendered as visual previews, so use the URL directly as the option string when presenting images for the user to choose between."
                   },
                   multiple: {
                     type: "boolean",
@@ -1013,27 +1013,75 @@ var init_confirmDestructiveAction = __esm({
 });
 
 // src/subagents/common/runCli.ts
-import { exec } from "child_process";
+import { spawn } from "child_process";
 function runCli(cmd, options) {
   return new Promise((resolve) => {
-    exec(
-      cmd,
-      {
-        timeout: options?.timeout ?? 6e4,
-        maxBuffer: options?.maxBuffer ?? 1024 * 1024
-      },
-      (err, stdout, stderr) => {
-        if (stdout.trim()) {
-          resolve(stdout.trim());
-          return;
+    const timeout = options?.timeout ?? 6e4;
+    const maxBuffer = options?.maxBuffer ?? 1024 * 1024;
+    const cmdWithLogs = options?.jsonLogs && !cmd.includes("--json-logs") ? cmd.replace(/^(mindstudio\s+\S+)/, "$1 --json-logs") : cmd;
+    const child = spawn("sh", ["-c", cmdWithLogs], {
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    const logs = [];
+    let stdout = "";
+    let stderr = "";
+    let stdoutSize = 0;
+    let stderrSize = 0;
+    let killed = false;
+    child.stdout.on("data", (chunk) => {
+      stdoutSize += chunk.length;
+      if (stdoutSize <= maxBuffer) {
+        stdout += chunk.toString();
+      } else if (!killed) {
+        killed = true;
+        child.kill();
+      }
+    });
+    child.stderr.on("data", (chunk) => {
+      stderrSize += chunk.length;
+      if (stderrSize > maxBuffer) {
+        if (!killed) {
+          killed = true;
+          child.kill();
         }
-        if (err) {
-          resolve(`Error: ${stderr.trim() || err.message}`);
-          return;
+        return;
+      }
+      const text = chunk.toString();
+      stderr += text;
+      for (const line of text.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed[0] !== "{") {
+          continue;
+        }
+        try {
+          const entry = JSON.parse(trimmed);
+          if (entry.type === "log" && entry.value) {
+            const prefix = entry.tag ? `[${entry.tag}]` : "[log]";
+            logs.push(`${prefix} ${entry.value}`);
+          }
+        } catch {
         }
-        resolve("(no response)");
       }
-    );
+    });
+    const timer = setTimeout(() => {
+      killed = true;
+      child.kill();
+    }, timeout);
+    child.on("close", (code) => {
+      clearTimeout(timer);
+      const logBlock = logs.length > 0 ? logs.join("\n") + "\n\n" : "";
+      const out = stdout.trim();
+      if (out) {
+        resolve(logBlock + out);
+        return;
+      }
+      if (code !== 0 || killed) {
+        const errMsg = stderr.trim() || (killed ? "Process timed out" : `Exit code ${code}`);
+        resolve(logBlock + `Error: ${errMsg}`);
+        return;
+      }
+      resolve(logBlock + "(no response)");
+    });
   });
 }
 var init_runCli = __esm({
@@ -1496,7 +1544,7 @@ ${unifiedDiff(input.path, content, updated)}`;
 });
 
 // src/tools/code/bash.ts
-import { exec as exec2 } from "child_process";
+import { exec } from "child_process";
 var DEFAULT_TIMEOUT_MS, DEFAULT_MAX_LINES3, bashTool;
 var init_bash = __esm({
   "src/tools/code/bash.ts"() {
@@ -1534,7 +1582,7 @@ var init_bash = __esm({
         const maxLines = input.maxLines === 0 ? Infinity : input.maxLines || DEFAULT_MAX_LINES3;
         const timeoutMs = input.timeout ? input.timeout * 1e3 : DEFAULT_TIMEOUT_MS;
         return new Promise((resolve) => {
-          exec2(
+          exec(
             input.command,
             {
               timeout: timeoutMs,
@@ -1576,7 +1624,7 @@ var init_bash = __esm({
 });
 
 // src/tools/code/grep.ts
-import { exec as exec3 } from "child_process";
+import { exec as exec2 } from "child_process";
 function formatResults(stdout, max) {
   const lines = stdout.trim().split("\n");
   let result = lines.join("\n");
@@ -1627,12 +1675,12 @@ var init_grep = __esm({
         const rgCmd = `rg -n --no-heading --max-count=${max}${globFlag} '${escaped}' ${searchPath}`;
         const grepCmd = `grep -rn --max-count=${max} '${escaped}' ${searchPath} --include='*.ts' --include='*.tsx' --include='*.js' --include='*.json' --include='*.md'`;
         return new Promise((resolve) => {
-          exec3(rgCmd, { maxBuffer: 512 * 1024 }, (err, stdout) => {
+          exec2(rgCmd, { maxBuffer: 512 * 1024 }, (err, stdout) => {
             if (stdout?.trim()) {
               resolve(formatResults(stdout, max));
               return;
             }
-            exec3(grepCmd, { maxBuffer: 512 * 1024 }, (_err, grepStdout) => {
+            exec2(grepCmd, { maxBuffer: 512 * 1024 }, (_err, grepStdout) => {
               if (grepStdout?.trim()) {
                 resolve(formatResults(grepStdout, max));
               } else {
@@ -1966,42 +2014,78 @@ var init_runMethod = __esm({
   }
 });
 
-// src/tools/code/screenshot.ts
-var DEFAULT_PROMPT, screenshotTool;
+// src/tools/_helpers/screenshot.ts
+async function captureAndAnalyzeScreenshot(promptOrOptions) {
+  let prompt;
+  let fullPage = false;
+  if (typeof promptOrOptions === "object" && promptOrOptions !== null) {
+    prompt = promptOrOptions.prompt;
+    fullPage = promptOrOptions.fullPage ?? false;
+  } else {
+    prompt = promptOrOptions;
+  }
+  const ssResult = await sidecarRequest(
+    "/screenshot",
+    { fullPage },
+    { timeout: 12e4 }
+  );
+  log.debug("Screenshot response", { ssResult });
+  const url = ssResult?.url || ssResult?.screenshotUrl;
+  if (!url) {
+    throw new Error(
+      `No URL in sidecar response. The browser may not be ready yet. Response: ${JSON.stringify(ssResult)}`
+    );
+  }
+  if (prompt === false) {
+    return url;
+  }
+  const analysisPrompt = prompt || SCREENSHOT_ANALYSIS_PROMPT;
+  const analysis = await runCli(
+    `mindstudio analyze-image --prompt ${JSON.stringify(analysisPrompt)} --image-url ${JSON.stringify(url)} --output-key analysis --no-meta`
+  );
+  return JSON.stringify({ url, analysis });
+}
+var SCREENSHOT_ANALYSIS_PROMPT;
 var init_screenshot = __esm({
-  "src/tools/code/screenshot.ts"() {
+  "src/tools/_helpers/screenshot.ts"() {
     "use strict";
     init_sidecar();
     init_runCli();
-    DEFAULT_PROMPT = "Describe this app screenshot for a developer who cannot see it. What is visible on screen: the layout, content, interactive elements, any loading or error states. Be concise and factual.";
+    init_logger();
+    SCREENSHOT_ANALYSIS_PROMPT = "Describe everything visible on screen from top to bottom \u2014 every element, its position, its size relative to the viewport, its colors, its content. Be thorough and spatial. After the inventory, note anything that looks visually broken (overlapping elements, clipped text, misaligned components).";
+  }
+});
+
+// src/tools/code/screenshot.ts
+var screenshotTool;
+var init_screenshot2 = __esm({
+  "src/tools/code/screenshot.ts"() {
+    "use strict";
+    init_screenshot();
     screenshotTool = {
       definition: {
         name: "screenshot",
-        description: "Capture a screenshot of the app preview and get a description of what's on screen. Optionally provide a specific question about what you're looking for.",
+        description: "Capture a screenshot of the app preview and get a description of what's on screen. Optionally provide a specific question about what you're looking for. By default captures the viewport (what the user sees). Set fullPage to capture the entire scrollable page.",
         inputSchema: {
           type: "object",
           properties: {
             prompt: {
               type: "string",
               description: "Optional question about the screenshot. If omitted, returns a general description of what's visible."
+            },
+            fullPage: {
+              type: "boolean",
+              description: "Capture the full scrollable page instead of just the viewport. Use when you need to see below-the-fold content."
             }
           }
         }
       },
       async execute(input) {
         try {
-          const { url } = await sidecarRequest(
-            "/screenshot",
-            {},
-            { timeout: 12e4 }
-          );
-          const analysisPrompt = input.prompt || DEFAULT_PROMPT;
-          const analysis = await runCli(
-            `mindstudio analyze-image --prompt ${JSON.stringify(analysisPrompt)} --image-url ${JSON.stringify(url)} --output-key analysis --no-meta`
-          );
-          return `Screenshot: ${url}
-
-${analysis}`;
+          return await captureAndAnalyzeScreenshot({
+            prompt: input.prompt,
+            fullPage: input.fullPage
+          });
         } catch (err) {
           return `Error taking screenshot: ${err.message}`;
         }
@@ -2076,7 +2160,9 @@ async function runSubAgent(config) {
         ...apiConfig,
         model,
         subAgentId,
-        system,
+        system: `${system}
+
+Current date/time: ${(/* @__PURE__ */ new Date()).toISOString().replace("T", " ").replace(/\.\d+Z$/, " UTC")}`,
         messages: cleanMessagesForApi(messages),
         tools,
         signal
@@ -2171,7 +2257,7 @@ async function runSubAgent(config) {
           if (externalTools.has(tc.name) && resolveExternalTool) {
             result = await resolveExternalTool(tc.id, tc.name, tc.input);
           } else {
-            result = await executeTool2(tc.name, tc.input);
+            result = await executeTool2(tc.name, tc.input, tc.id);
           }
           const isError = result.startsWith("Error");
           emit2({
@@ -2196,6 +2282,13 @@ async function runSubAgent(config) {
       })
     );
     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;
+      }
       messages.push({
         role: "user",
         content: r.result,
@@ -2233,8 +2326,18 @@ var init_tools = __esm({
                 properties: {
                   command: {
                     type: "string",
-                    enum: ["snapshot", "click", "type", "wait", "evaluate"],
-                    description: "snapshot: accessibility tree of the page (waits for network to settle). click: click an element (animated cursor, full event sequence). type: type text into input (one char at a time, works with React/Vue/Svelte). wait: wait for an element to appear (polls 100ms, waits for network). evaluate: run JS in the page."
+                    enum: [
+                      "snapshot",
+                      "click",
+                      "type",
+                      "select",
+                      "wait",
+                      "navigate",
+                      "evaluate",
+                      "styles",
+                      "screenshot"
+                    ],
+                    description: "snapshot: accessibility tree of the page (waits for network to settle). click: click an element (animated cursor, full event sequence). type: type text into input (one char at a time, works with React/Vue/Svelte). select: select a dropdown option by text. wait: wait for an element to appear (polls 100ms, waits for network). navigate: navigate to a URL within the app (waits for load, subsequent steps run on new page). evaluate: run JS in the page. styles: read computed CSS styles from elements (pass properties array with camelCase names, or omit for defaults). screenshot: full-page viewport-stitched screenshot (returns base64 JPEG with dimensions)."
                   },
                   ref: {
                     type: "string",
@@ -2256,6 +2359,10 @@ var init_tools = __esm({
                     type: "string",
                     description: "CSS selector fallback (last resort)."
                   },
+                  option: {
+                    type: "string",
+                    description: "For select: the option text to select from a dropdown."
+                  },
                   clear: {
                     type: "boolean",
                     description: "For type: clear the field before typing."
@@ -2267,6 +2374,15 @@ var init_tools = __esm({
                   script: {
                     type: "string",
                     description: "For evaluate: JavaScript to run in the page."
+                  },
+                  url: {
+                    type: "string",
+                    description: 'For navigate: the URL to navigate to (e.g., "/quiz", "/settings").'
+                  },
+                  properties: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: 'For styles: camelCase CSS property names to read (e.g., ["backgroundColor", "borderRadius", "fontSize"]). Omit for a default set.'
                   }
                 },
                 required: ["command"]
@@ -2293,7 +2409,7 @@ var init_tools = __esm({
         }
       }
     ];
-    BROWSER_EXTERNAL_TOOLS = /* @__PURE__ */ new Set(["browserCommand", "screenshot"]);
+    BROWSER_EXTERNAL_TOOLS = /* @__PURE__ */ new Set(["browserCommand"]);
   }
 });
 
@@ -2332,16 +2448,19 @@ var init_browserAutomation = __esm({
     init_tools();
     init_prompt();
     init_sidecar();
+    init_screenshot();
+    init_runCli();
+    init_logger();
     browserAutomationTool = {
       definition: {
         name: "runAutomatedBrowserTest",
-        description: "Run an automated browser test against the live preview. The test agent always starts on the main page, so include navigation instructions if the test involves a sub-page. The browser uses the current user roles and dev database state, so run a scenario first if you need specific data or roles. Use after writing or modifying frontend code, to reproduce user-reported issues, or to test end-to-end flows.",
+        description: "Run an automated browser test against the live preview. Describe what to test \u2014 the agent figures out how. Use after writing or modifying frontend code, to reproduce user-reported issues, or to test end-to-end flows.",
         inputSchema: {
           type: "object",
           properties: {
             task: {
               type: "string",
-              description: "What to test, in natural language. Include how to navigate to the relevant page and what data/roles to expect."
+              description: "What to test, in natural language. Keep it brief \u2014 the agent reads the spec and figures out navigation, data setup, and test strategy on its own."
             }
           },
           required: ["task"]
@@ -2369,6 +2488,13 @@ var init_browserAutomation = __esm({
           tools: BROWSER_TOOLS,
           externalTools: BROWSER_EXTERNAL_TOOLS,
           executeTool: async (name) => {
+            if (name === "screenshot") {
+              try {
+                return await captureAndAnalyzeScreenshot();
+              } catch (err) {
+                return `Error taking screenshot: ${err.message}`;
+              }
+            }
             if (name === "resetBrowser") {
               try {
                 await sidecarRequest("/reset-browser", {}, { timeout: 5e3 });
@@ -2385,7 +2511,50 @@ var init_browserAutomation = __esm({
           signal: context.signal,
           parentToolId: context.toolCallId,
           onEvent: context.onEvent,
-          resolveExternalTool: context.resolveExternalTool
+          resolveExternalTool: async (id, name, input2) => {
+            if (!context.resolveExternalTool) {
+              return "Error: no external tool resolver";
+            }
+            const result2 = await context.resolveExternalTool(id, name, input2);
+            if (name === "browserCommand") {
+              try {
+                const parsed = JSON.parse(result2);
+                const screenshotSteps = (parsed.steps || []).filter(
+                  (s) => s.command === "screenshot" && s.result?.url
+                );
+                if (screenshotSteps.length > 0) {
+                  const batchInput = screenshotSteps.map((s) => ({
+                    stepType: "analyzeImage",
+                    step: {
+                      imageUrl: s.result.url,
+                      prompt: SCREENSHOT_ANALYSIS_PROMPT
+                    }
+                  }));
+                  const batchResult = await runCli(
+                    `mindstudio batch --no-meta ${JSON.stringify(JSON.stringify(batchInput))}`,
+                    { timeout: 12e4 }
+                  );
+                  try {
+                    const analyses = JSON.parse(batchResult);
+                    let ai = 0;
+                    for (const step of parsed.steps) {
+                      if (step.command === "screenshot" && step.result?.url && ai < analyses.length) {
+                        step.result.analysis = analyses[ai]?.output?.analysis || analyses[ai]?.output || "";
+                        ai++;
+                      }
+                    }
+                  } catch {
+                    log.debug("Failed to parse batch analysis result", {
+                      batchResult
+                    });
+                  }
+                  return JSON.stringify(parsed);
+                }
+              } catch {
+              }
+            }
+            return result2;
+          }
         });
         context.subAgentMessages?.set(context.toolCallId, result.messages);
         return result.text;
@@ -2395,22 +2564,20 @@ var init_browserAutomation = __esm({
 });
 
 // src/subagents/designExpert/tools.ts
-async function executeDesignExpertTool(name, input) {
+import fs11 from "fs";
+import path5 from "path";
+function resolvePath(filename) {
+  const local4 = path5.join(base2, filename);
+  return fs11.existsSync(local4) ? local4 : path5.join(base2, "subagents", "designExpert", filename);
+}
+async function executeDesignExpertTool(name, input, context, toolCallId) {
   switch (name) {
     case "screenshot": {
       try {
-        const { url } = await sidecarRequest(
-          "/screenshot",
-          {},
-          { timeout: 12e4 }
-        );
-        const analysisPrompt = input.prompt || "Describe this app screenshot for a visual designer reviewing the current state. What is visible: layout, typography, colors, spacing, imagery. Note anything that looks broken or off. Be concise.";
-        const analysis = await runCli(
-          `mindstudio analyze-image --prompt ${JSON.stringify(analysisPrompt)} --image-url ${JSON.stringify(url)} --output-key analysis --no-meta`
-        );
-        return `Screenshot: ${url}
-
-${analysis}`;
+        return await captureAndAnalyzeScreenshot({
+          prompt: input.prompt,
+          fullPage: input.fullPage
+        });
       } catch (err) {
         return `Error taking screenshot: ${err.message}`;
       }
@@ -2449,12 +2616,6 @@ ${analysis}`;
 
 ${analysis}`;
     }
-    case "searchProductScreenshots": {
-      const query = `${input.product} product screenshot UI 2026`;
-      return runCli(
-        `mindstudio search-google-images --query ${JSON.stringify(query)} --export-type json --output-key images --no-meta`
-      );
-    }
     case "generateImages": {
       const prompts = input.prompts;
       const width = input.width || 2048;
@@ -2470,7 +2631,8 @@ ${analysis}`;
           }
         });
         const url = await runCli(
-          `mindstudio generate-image '${step}' --output-key imageUrl --no-meta`
+          `mindstudio generate-image '${step}' --output-key imageUrl --no-meta`,
+          { jsonLogs: true }
         );
         imageUrls = [url];
       } else {
@@ -2485,7 +2647,8 @@ ${analysis}`;
           }
         }));
         const batchResult = await runCli(
-          `mindstudio batch '${JSON.stringify(steps)}' --no-meta`
+          `mindstudio batch '${JSON.stringify(steps)}' --no-meta`,
+          { jsonLogs: true }
         );
         try {
           const parsed = JSON.parse(batchResult);
@@ -2496,38 +2659,44 @@ ${analysis}`;
           return batchResult;
         }
       }
-      const analyses = await Promise.all(
+      const images = await Promise.all(
         imageUrls.map(async (url, i) => {
           if (url.startsWith("Error")) {
-            return `Image ${i + 1}: ${url}`;
+            return { prompt: prompts[i], error: url };
           }
           const analysis = await runCli(
             `mindstudio analyze-image --prompt ${JSON.stringify(ANALYZE_PROMPT)} --image-url ${JSON.stringify(url)} --output-key analysis --no-meta`
           );
-          return `**Image ${i + 1}:** ${url}
-Prompt: ${prompts[i]}
-Analysis: ${analysis}`;
+          return { url, prompt: prompts[i], analysis, width, height };
         })
       );
-      return analyses.join("\n\n");
+      return `%%JSON%%${JSON.stringify({ images })}`;
+    }
+    case "runBrowserTest": {
+      if (!context) {
+        return "Error: browser testing requires execution context (only available in headless mode)";
+      }
+      return browserAutomationTool.execute(
+        { task: input.task },
+        {
+          ...context,
+          toolCallId: toolCallId || context.toolCallId
+        }
+      );
     }
     default:
       return `Error: unknown tool "${name}"`;
   }
 }
-var DESIGN_REFERENCE_PROMPT, DESIGN_EXPERT_TOOLS;
+var base2, DESIGN_REFERENCE_PROMPT, DESIGN_EXPERT_TOOLS;
 var init_tools2 = __esm({
   "src/subagents/designExpert/tools.ts"() {
     "use strict";
     init_runCli();
-    init_sidecar();
-    DESIGN_REFERENCE_PROMPT = `Analyze this website/app screenshot as a design reference. Assess:
-1) Mood/aesthetic
-2) Color palette with approximate hex values and palette strategy
-3) Typography style
-4) Layout composition (symmetric/asymmetric, grid structure, whitespace usage, content density)
-5) What makes it distinctive and interesting vs generic AI-generated interfaces
-Be specific and concise.`;
+    init_screenshot();
+    init_browserAutomation();
+    base2 = import.meta.dirname ?? path5.dirname(new URL(import.meta.url).pathname);
+    DESIGN_REFERENCE_PROMPT = fs11.readFileSync(resolvePath("prompts/tool-prompts/design-analysis.md"), "utf-8").trim();
     DESIGN_EXPERT_TOOLS = [
       {
         name: "searchGoogle",
@@ -2581,24 +2750,33 @@ Be specific and concise.`;
       },
       {
         name: "screenshot",
-        description: "Capture a screenshot of the app preview. Returns a CDN URL. Use to review the current state of the UI being built.",
+        description: "Capture a screenshot of the app preview. Returns a CDN URL with visual analysis. Use to review the current state of the UI being built. By default captures the viewport. Set fullPage to capture the entire scrollable page.",
         inputSchema: {
           type: "object",
-          properties: {}
+          properties: {
+            prompt: {
+              type: "string",
+              description: "Optional specific question about the screenshot."
+            },
+            fullPage: {
+              type: "boolean",
+              description: "Capture the full scrollable page instead of just the viewport. Use when you need to see below-the-fold content."
+            }
+          }
         }
       },
       {
-        name: "searchProductScreenshots",
-        description: 'Search for screenshots of real products and apps. Use to find what existing products look like ("stripe dashboard", "linear app", "notion workspace"). Returns image results of actual product UI. Use this for layout and design research on real products, NOT for abstract design inspiration.',
+        name: "runBrowserTest",
+        description: "Run an automated browser test against the live app preview. Use to verify visual implementation: check computed styles, navigate between pages, take analyzed screenshots. Describe what you want to verify and the browser agent handles the interaction.",
         inputSchema: {
           type: "object",
           properties: {
-            product: {
+            task: {
               type: "string",
-              description: 'The product or app to find screenshots of (e.g., "stripe dashboard", "figma editor", "mercury banking app").'
+              description: 'What to verify, in natural language. E.g., "Check that the hero section cards have border-radius: 24px and the correct rotation angles" or "Navigate to /about and screenshot it".'
             }
           },
-          required: ["product"]
+          required: ["task"]
         }
       },
       {
@@ -2631,13 +2809,13 @@ Be specific and concise.`;
 });
 
 // src/subagents/common/context.ts
-import fs11 from "fs";
-import path5 from "path";
+import fs12 from "fs";
+import path6 from "path";
 function walkMdFiles(dir, skip) {
   const files = [];
   try {
-    for (const entry of fs11.readdirSync(dir, { withFileTypes: true })) {
-      const full = path5.join(dir, entry.name);
+    for (const entry of fs12.readdirSync(dir, { withFileTypes: true })) {
+      const full = path6.join(dir, entry.name);
       if (entry.isDirectory()) {
         if (!skip?.has(entry.name)) {
           files.push(...walkMdFiles(full, skip));
@@ -2657,7 +2835,7 @@ function loadFilesAsXml(dir, tag, skip) {
   }
   const sections = files.map((f) => {
     try {
-      const content = fs11.readFileSync(f, "utf-8").trim();
+      const content = fs12.readFileSync(f, "utf-8").trim();
       return `<file path="${f}">
 ${content}
 </file>`;
@@ -2732,18 +2910,18 @@ var init_context = __esm({
 });
 
 // src/subagents/designExpert/prompt.ts
-import fs12 from "fs";
-import path6 from "path";
-function resolvePath(filename) {
-  const local4 = path6.join(base2, filename);
-  return fs12.existsSync(local4) ? local4 : path6.join(base2, "subagents", "designExpert", filename);
+import fs13 from "fs";
+import path7 from "path";
+function resolvePath2(filename) {
+  const local4 = path7.join(base3, filename);
+  return fs13.existsSync(local4) ? local4 : path7.join(base3, "subagents", "designExpert", filename);
 }
 function readFile(filename) {
-  return fs12.readFileSync(resolvePath(filename), "utf-8").trim();
+  return fs13.readFileSync(resolvePath2(filename), "utf-8").trim();
 }
 function readJson(filename, fallback) {
   try {
-    return JSON.parse(fs12.readFileSync(resolvePath(filename), "utf-8"));
+    return JSON.parse(fs13.readFileSync(resolvePath2(filename), "utf-8"));
   } catch {
     return fallback;
   }
@@ -2764,7 +2942,6 @@ function getDesignExpertPrompt() {
   const pairings = sample(fontData.pairings, 20);
   const images = sample(inspirationImages, 15);
   const fontList = fonts.map((f) => {
-    const tags = f.tags.length ? ` (${f.tags.join(", ")})` : "";
     let cssInfo = "";
     if (f.source === "fontshare") {
       cssInfo = ` CSS: ${fontData.cssUrlPattern.replace("{slug}", f.slug).replace("{weights}", f.weights.join(","))}`;
@@ -2773,7 +2950,8 @@ function getDesignExpertPrompt() {
     } else if (f.source === "open-foundry") {
       cssInfo = " (self-host required)";
     }
-    return `- **${f.name}** \u2014 ${f.category}${tags}. Weights: ${f.weights.join(", ")}.${f.variable ? " Variable." : ""}${f.italics ? " Has italics." : ""}${cssInfo}`;
+    const desc = f.description ? ` ${f.description}` : "";
+    return `- **${f.name}** \u2014 ${f.category}. Weights: ${f.weights.join(", ")}.${f.variable ? " Variable." : ""}${f.italics ? " Has italics." : ""}${cssInfo}${desc}`;
   }).join("\n");
   const pairingList = pairings.map(
     (p) => `- **${p.heading.font}** (${p.heading.weight}) heading + **${p.body.font}** (${p.body.weight}) body`
@@ -2791,13 +2969,13 @@ ${fontList}
 ${pairingList}
 </fonts_to_consider>` : "";
   const imageList = images.map((img) => `- ${img.analysis}`).join("\n\n");
-  const inspirationSection = images.length ? `<inspiration_images>
+  const inspirationSection = images.length ? `<design_inspiration>
 ## Design inspiration
 
-This is what the bar looks like. These are real sites that made it onto curated design galleries because they did something bold, intentional, and memorable. Study the moves they make \u2014 the confident color choices, the unexpected layouts, the typography that carries the whole page. Your recommendations should feel like they belong in this company.
+This is what the bar looks like. These are real sites that made it onto curated design galleries because they did something bold, intentional, and memorable. Use them as inspiration and let the takeaways guide your work. Your designs should feel like they belong in this company.
 
 ${imageList}
-</inspiration_images>` : "";
+</design_inspiration>` : "";
   const specContext = loadSpecContext();
   let prompt = PROMPT_TEMPLATE.replace(
     "{{fonts_to_consider}}",
@@ -2810,12 +2988,12 @@ ${specContext}`;
   }
   return prompt;
 }
-var base2, RUNTIME_PLACEHOLDERS, PROMPT_TEMPLATE, fontData, inspirationImages;
+var base3, RUNTIME_PLACEHOLDERS, PROMPT_TEMPLATE, fontData, inspirationImages;
 var init_prompt2 = __esm({
   "src/subagents/designExpert/prompt.ts"() {
     "use strict";
     init_context();
-    base2 = import.meta.dirname ?? path6.dirname(new URL(import.meta.url).pathname);
+    base3 = import.meta.dirname ?? path7.dirname(new URL(import.meta.url).pathname);
     RUNTIME_PLACEHOLDERS = /* @__PURE__ */ new Set([
       "fonts_to_consider",
       "inspiration_images"
@@ -2870,7 +3048,7 @@ Visual design expert. Describe the situation and what you need \u2014 the agent
           task: input.task,
           tools: DESIGN_EXPERT_TOOLS,
           externalTools: /* @__PURE__ */ new Set(),
-          executeTool: executeDesignExpertTool,
+          executeTool: (name, input2, toolCallId) => executeDesignExpertTool(name, input2, context, toolCallId),
           apiConfig: context.apiConfig,
           model: context.model,
           subAgentId: "visualDesignExpert",
@@ -2991,8 +3169,8 @@ var init_tools3 = __esm({
 });
 
 // src/subagents/productVision/executor.ts
-import fs13 from "fs";
-import path7 from "path";
+import fs14 from "fs";
+import path8 from "path";
 function formatRequires(requires) {
   return requires.length === 0 ? "[]" : `[${requires.map((r) => `"${r}"`).join(", ")}]`;
 }
@@ -3007,9 +3185,10 @@ async function executeVisionTool(name, input) {
         requires,
         body
       } = input;
-      const filePath = path7.join(ROADMAP_DIR, `${slug}.md`);
+      const filePath = path8.join(ROADMAP_DIR, `${slug}.md`);
       try {
-        fs13.mkdirSync(ROADMAP_DIR, { recursive: true });
+        fs14.mkdirSync(ROADMAP_DIR, { recursive: true });
+        const oldContent = fs14.existsSync(filePath) ? fs14.readFileSync(filePath, "utf-8") : "";
         const content = `---
 name: ${itemName}
 type: roadmap
@@ -3021,20 +3200,24 @@ requires: ${formatRequires(requires)}
 
 ${body}
 `;
-        fs13.writeFileSync(filePath, content, "utf-8");
-        return `Wrote ${filePath}`;
+        fs14.writeFileSync(filePath, content, "utf-8");
+        const lineCount = content.split("\n").length;
+        const label = oldContent ? "Updated" : "Wrote";
+        return `${label} ${filePath} (${lineCount} lines)
+${unifiedDiff(filePath, oldContent, content)}`;
       } catch (err) {
         return `Error writing ${filePath}: ${err.message}`;
       }
     }
     case "updateRoadmapItem": {
       const { slug } = input;
-      const filePath = path7.join(ROADMAP_DIR, `${slug}.md`);
+      const filePath = path8.join(ROADMAP_DIR, `${slug}.md`);
       try {
-        if (!fs13.existsSync(filePath)) {
+        if (!fs14.existsSync(filePath)) {
           return `Error: ${filePath} does not exist`;
         }
-        let content = fs13.readFileSync(filePath, "utf-8");
+        const oldContent = fs14.readFileSync(filePath, "utf-8");
+        let content = oldContent;
         if (input.status) {
           content = content.replace(
             /^status:\s*.+$/m,
@@ -3086,21 +3269,25 @@ ${input.appendHistory}
 `;
           }
         }
-        fs13.writeFileSync(filePath, content, "utf-8");
-        return `Updated ${filePath}`;
+        fs14.writeFileSync(filePath, content, "utf-8");
+        const lineCount = content.split("\n").length;
+        return `Updated ${filePath} (${lineCount} lines)
+${unifiedDiff(filePath, oldContent, content)}`;
       } catch (err) {
         return `Error updating ${filePath}: ${err.message}`;
       }
     }
     case "deleteRoadmapItem": {
       const { slug } = input;
-      const filePath = path7.join(ROADMAP_DIR, `${slug}.md`);
+      const filePath = path8.join(ROADMAP_DIR, `${slug}.md`);
       try {
-        if (!fs13.existsSync(filePath)) {
+        if (!fs14.existsSync(filePath)) {
           return `Error: ${filePath} does not exist`;
         }
-        fs13.unlinkSync(filePath);
-        return `Deleted ${filePath}`;
+        const oldContent = fs14.readFileSync(filePath, "utf-8");
+        fs14.unlinkSync(filePath);
+        return `Deleted ${filePath}
+${unifiedDiff(filePath, oldContent, "")}`;
       } catch (err) {
         return `Error deleting ${filePath}: ${err.message}`;
       }
@@ -3113,14 +3300,15 @@ var ROADMAP_DIR;
 var init_executor = __esm({
   "src/subagents/productVision/executor.ts"() {
     "use strict";
+    init_diff();
     init_context();
     ROADMAP_DIR = "src/roadmap";
   }
 });
 
 // src/subagents/productVision/prompt.ts
-import fs14 from "fs";
-import path8 from "path";
+import fs15 from "fs";
+import path9 from "path";
 function getProductVisionPrompt() {
   const specContext = loadSpecContext();
   const roadmapContext = loadRoadmapContext();
@@ -3133,16 +3321,16 @@ function getProductVisionPrompt() {
   }
   return parts.join("\n\n");
 }
-var base3, local2, PROMPT_PATH2, BASE_PROMPT2;
+var base4, local2, PROMPT_PATH2, BASE_PROMPT2;
 var init_prompt3 = __esm({
   "src/subagents/productVision/prompt.ts"() {
     "use strict";
     init_executor();
     init_context();
-    base3 = import.meta.dirname ?? path8.dirname(new URL(import.meta.url).pathname);
-    local2 = path8.join(base3, "prompt.md");
-    PROMPT_PATH2 = fs14.existsSync(local2) ? local2 : path8.join(base3, "subagents", "productVision", "prompt.md");
-    BASE_PROMPT2 = fs14.readFileSync(PROMPT_PATH2, "utf-8").trim();
+    base4 = import.meta.dirname ?? path9.dirname(new URL(import.meta.url).pathname);
+    local2 = path9.join(base4, "prompt.md");
+    PROMPT_PATH2 = fs15.existsSync(local2) ? local2 : path9.join(base4, "subagents", "productVision", "prompt.md");
+    BASE_PROMPT2 = fs15.readFileSync(PROMPT_PATH2, "utf-8").trim();
   }
 });
 
@@ -3293,9 +3481,9 @@ var init_tools4 = __esm({
 });
 
 // src/subagents/codeSanityCheck/index.ts
-import fs15 from "fs";
-import path9 from "path";
-var base4, local3, PROMPT_PATH3, BASE_PROMPT3, codeSanityCheckTool;
+import fs16 from "fs";
+import path10 from "path";
+var base5, local3, PROMPT_PATH3, BASE_PROMPT3, codeSanityCheckTool;
 var init_codeSanityCheck = __esm({
   "src/subagents/codeSanityCheck/index.ts"() {
     "use strict";
@@ -3303,10 +3491,10 @@ var init_codeSanityCheck = __esm({
     init_context();
     init_tools5();
     init_tools4();
-    base4 = import.meta.dirname ?? path9.dirname(new URL(import.meta.url).pathname);
-    local3 = path9.join(base4, "prompt.md");
-    PROMPT_PATH3 = fs15.existsSync(local3) ? local3 : path9.join(base4, "subagents", "codeSanityCheck", "prompt.md");
-    BASE_PROMPT3 = fs15.readFileSync(PROMPT_PATH3, "utf-8").trim();
+    base5 = import.meta.dirname ?? path10.dirname(new URL(import.meta.url).pathname);
+    local3 = path10.join(base5, "prompt.md");
+    PROMPT_PATH3 = fs16.existsSync(local3) ? local3 : path10.join(base5, "subagents", "codeSanityCheck", "prompt.md");
+    BASE_PROMPT3 = fs16.readFileSync(PROMPT_PATH3, "utf-8").trim();
     codeSanityCheckTool = {
       definition: {
         name: "codeSanityCheck",
@@ -3464,7 +3652,7 @@ var init_tools5 = __esm({
     init_restartProcess();
     init_runScenario();
     init_runMethod();
-    init_screenshot();
+    init_screenshot2();
     init_browserAutomation();
     init_designExpert();
     init_productVision();
@@ -3473,10 +3661,10 @@ var init_tools5 = __esm({
 });
 
 // src/session.ts
-import fs16 from "fs";
+import fs17 from "fs";
 function loadSession(state) {
   try {
-    const raw = fs16.readFileSync(SESSION_FILE, "utf-8");
+    const raw = fs17.readFileSync(SESSION_FILE, "utf-8");
     const data = JSON.parse(raw);
     if (Array.isArray(data.messages) && data.messages.length > 0) {
       state.messages = sanitizeMessages(data.messages);
@@ -3524,7 +3712,7 @@ function sanitizeMessages(messages) {
 }
 function saveSession(state) {
   try {
-    fs16.writeFileSync(
+    fs17.writeFileSync(
       SESSION_FILE,
       JSON.stringify({ messages: state.messages }, null, 2),
       "utf-8"
@@ -3535,7 +3723,7 @@ function saveSession(state) {
 function clearSession(state) {
   state.messages = [];
   try {
-    fs16.unlinkSync(SESSION_FILE);
+    fs17.unlinkSync(SESSION_FILE);
   } catch {
   }
 }
@@ -4281,12 +4469,12 @@ var init_agent = __esm({
 });
 
 // src/prompt/static/projectContext.ts
-import fs17 from "fs";
-import path10 from "path";
+import fs18 from "fs";
+import path11 from "path";
 function loadProjectInstructions() {
   for (const file of AGENT_INSTRUCTION_FILES) {
     try {
-      const content = fs17.readFileSync(file, "utf-8").trim();
+      const content = fs18.readFileSync(file, "utf-8").trim();
       if (content) {
         return `
 ## Project Instructions (${file})
@@ -4299,7 +4487,7 @@ ${content}`;
 }
 function loadProjectManifest() {
   try {
-    const manifest = fs17.readFileSync("mindstudio.json", "utf-8");
+    const manifest = fs18.readFileSync("mindstudio.json", "utf-8");
     return `
 ## Project Manifest (mindstudio.json)
 \`\`\`json
@@ -4340,9 +4528,9 @@ ${entries.join("\n")}`;
 function walkMdFiles2(dir) {
   const results = [];
   try {
-    const entries = fs17.readdirSync(dir, { withFileTypes: true });
+    const entries = fs18.readdirSync(dir, { withFileTypes: true });
     for (const entry of entries) {
-      const full = path10.join(dir, entry.name);
+      const full = path11.join(dir, entry.name);
       if (entry.isDirectory()) {
         results.push(...walkMdFiles2(full));
       } else if (entry.name.endsWith(".md")) {
@@ -4355,7 +4543,7 @@ function walkMdFiles2(dir) {
 }
 function parseFrontmatter(filePath) {
   try {
-    const content = fs17.readFileSync(filePath, "utf-8");
+    const content = fs18.readFileSync(filePath, "utf-8");
     const match = content.match(/^---\n([\s\S]*?)\n---/);
     if (!match) {
       return { name: "", description: "", type: "" };
@@ -4371,7 +4559,7 @@ function parseFrontmatter(filePath) {
 }
 function loadProjectFileListing() {
   try {
-    const entries = fs17.readdirSync(".", { withFileTypes: true });
+    const entries = fs18.readdirSync(".", { withFileTypes: true });
     const listing = entries.filter((e) => e.name !== ".git" && e.name !== "node_modules").sort((a, b) => {
       if (a.isDirectory() && !b.isDirectory()) {
         return -1;
@@ -4414,12 +4602,12 @@ var init_projectContext = __esm({
 });
 
 // src/prompt/index.ts
-import fs18 from "fs";
-import path11 from "path";
+import fs19 from "fs";
+import path12 from "path";
 function requireFile(filePath) {
-  const full = path11.join(PROMPT_DIR, filePath);
+  const full = path12.join(PROMPT_DIR, filePath);
   try {
-    return fs18.readFileSync(full, "utf-8").trim();
+    return fs19.readFileSync(full, "utf-8").trim();
   } catch {
     throw new Error(`Required prompt file missing: ${full}`);
   }
@@ -4438,14 +4626,11 @@ function buildSystemPrompt(onboardingState, viewContext) {
     loadSpecFileMetadata(),
     loadProjectFileListing()
   ].filter(Boolean).join("\n");
-  const now = (/* @__PURE__ */ new Date()).toLocaleString("en-US", {
-    dateStyle: "full",
-    timeStyle: "long"
-  });
+  const now = (/* @__PURE__ */ new Date()).toISOString().replace("T", " ").replace(/\.\d+Z$/, " UTC");
   const template = `
 {{static/identity.md}}
 
-The current date is ${now}.
+Current date/time: ${now}
 
 <platform_docs>
   <platform>
@@ -4546,17 +4731,17 @@ var init_prompt4 = __esm({
     "use strict";
     init_lsp();
     init_projectContext();
-    PROMPT_DIR = import.meta.dirname ?? path11.dirname(new URL(import.meta.url).pathname);
+    PROMPT_DIR = import.meta.dirname ?? path12.dirname(new URL(import.meta.url).pathname);
   }
 });
 
 // src/config.ts
-import fs19 from "fs";
-import path12 from "path";
+import fs20 from "fs";
+import path13 from "path";
 import os from "os";
 function loadConfigFile() {
   try {
-    const raw = fs19.readFileSync(CONFIG_PATH, "utf-8");
+    const raw = fs20.readFileSync(CONFIG_PATH, "utf-8");
     log.debug("Loaded config file", { path: CONFIG_PATH });
     return JSON.parse(raw);
   } catch (err) {
@@ -4592,7 +4777,7 @@ var init_config = __esm({
   "src/config.ts"() {
     "use strict";
     init_logger();
-    CONFIG_PATH = path12.join(
+    CONFIG_PATH = path13.join(
       os.homedir(),
       ".mindstudio-local-tunnel",
       "config.json"
@@ -4607,13 +4792,46 @@ __export(headless_exports, {
   startHeadless: () => startHeadless
 });
 import { createInterface } from "readline";
-import fs20 from "fs";
-import path13 from "path";
+import fs21 from "fs";
+import path14 from "path";
 function loadActionPrompt(name) {
-  return fs20.readFileSync(path13.join(ACTIONS_DIR, `${name}.md`), "utf-8").trim();
+  return fs21.readFileSync(path14.join(ACTIONS_DIR, `${name}.md`), "utf-8").trim();
 }
-function emit(event, data) {
-  process.stdout.write(JSON.stringify({ event, ...data }) + "\n");
+function emit(event, data, requestId) {
+  const payload = { event, ...data };
+  if (requestId) {
+    payload.requestId = requestId;
+  }
+  process.stdout.write(JSON.stringify(payload) + "\n");
+}
+function handleGetHistory(state) {
+  return { messages: state.messages };
+}
+function handleClear(state) {
+  clearSession(state);
+  return {};
+}
+function handleCancel(currentAbort, pendingTools) {
+  if (currentAbort) {
+    currentAbort.abort();
+  }
+  for (const [id, pending] of pendingTools) {
+    clearTimeout(pending.timeout);
+    pending.resolve("Error: cancelled");
+    pendingTools.delete(id);
+  }
+  return {};
+}
+function dispatchSimple(requestId, eventName, handler) {
+  try {
+    const data = handler();
+    if (eventName) {
+      emit(eventName, data, requestId);
+    }
+    emit("completed", { success: true }, requestId);
+  } catch (err) {
+    emit("completed", { success: false, error: err.message }, requestId);
+  }
 }
 async function startHeadless(opts = {}) {
   const stderrWrite = (...args2) => {
@@ -4632,72 +4850,15 @@ async function startHeadless(opts = {}) {
   const state = createAgentState();
   const resumed = loadSession(state);
   if (resumed) {
-    emit("session_restored", {
-      messageCount: state.messages.length
-    });
+    emit("session_restored", { messageCount: state.messages.length });
   }
   let running = false;
   let currentAbort = null;
+  let currentRequestId;
+  let completedEmitted = false;
   const EXTERNAL_TOOL_TIMEOUT_MS = 3e5;
   const pendingTools = /* @__PURE__ */ new Map();
   const earlyResults = /* @__PURE__ */ new Map();
-  function onEvent(e) {
-    switch (e.type) {
-      case "text":
-        emit("text", {
-          text: e.text,
-          ...e.parentToolId && { parentToolId: e.parentToolId }
-        });
-        break;
-      case "thinking":
-        emit("thinking", {
-          text: e.text,
-          ...e.parentToolId && { parentToolId: e.parentToolId }
-        });
-        break;
-      case "tool_input_delta":
-        emit("tool_input_delta", {
-          id: e.id,
-          name: e.name,
-          result: e.result,
-          ...e.parentToolId && { parentToolId: e.parentToolId }
-        });
-        break;
-      case "tool_start":
-        emit("tool_start", {
-          id: e.id,
-          name: e.name,
-          input: e.input,
-          ...e.partial && { partial: true },
-          ...e.parentToolId && { parentToolId: e.parentToolId }
-        });
-        break;
-      case "tool_done":
-        emit("tool_done", {
-          id: e.id,
-          name: e.name,
-          result: e.result,
-          isError: e.isError,
-          ...e.parentToolId && { parentToolId: e.parentToolId }
-        });
-        break;
-      case "turn_started":
-        emit("turn_started");
-        break;
-      case "turn_done":
-        emit("turn_done");
-        break;
-      case "turn_cancelled":
-        emit("turn_cancelled");
-        break;
-      case "error":
-        emit("error", { error: e.error });
-        break;
-      case "status":
-        emit("status", { message: e.message });
-        break;
-    }
-  }
   const USER_FACING_TOOLS = /* @__PURE__ */ new Set([
     "promptUser",
     "confirmDestructiveAction",
@@ -4728,6 +4889,158 @@ async function startHeadless(opts = {}) {
       });
     });
   }
+  function onEvent(e) {
+    const rid = currentRequestId;
+    switch (e.type) {
+      // Suppressed — caller already knows the request started
+      case "turn_started":
+        return;
+      // Terminal events — translate to `completed`
+      case "turn_done":
+        completedEmitted = true;
+        emit("completed", { success: true }, rid);
+        return;
+      case "turn_cancelled":
+        completedEmitted = true;
+        emit("completed", { success: false, error: "cancelled" }, rid);
+        return;
+      // Streaming events — forward with requestId
+      case "text":
+        emit(
+          "text",
+          {
+            text: e.text,
+            ...e.parentToolId && { parentToolId: e.parentToolId }
+          },
+          rid
+        );
+        return;
+      case "thinking":
+        emit(
+          "thinking",
+          {
+            text: e.text,
+            ...e.parentToolId && { parentToolId: e.parentToolId }
+          },
+          rid
+        );
+        return;
+      case "tool_input_delta":
+        emit(
+          "tool_input_delta",
+          {
+            id: e.id,
+            name: e.name,
+            result: e.result,
+            ...e.parentToolId && { parentToolId: e.parentToolId }
+          },
+          rid
+        );
+        return;
+      case "tool_start":
+        emit(
+          "tool_start",
+          {
+            id: e.id,
+            name: e.name,
+            input: e.input,
+            ...e.partial && { partial: true },
+            ...e.parentToolId && { parentToolId: e.parentToolId }
+          },
+          rid
+        );
+        return;
+      case "tool_done":
+        emit(
+          "tool_done",
+          {
+            id: e.id,
+            name: e.name,
+            result: e.result,
+            isError: e.isError,
+            ...e.parentToolId && { parentToolId: e.parentToolId }
+          },
+          rid
+        );
+        return;
+      case "status":
+        emit("status", { message: e.message }, rid);
+        return;
+      case "error":
+        emit("error", { error: e.error }, rid);
+        return;
+    }
+  }
+  async function handleMessage(parsed, requestId) {
+    if (running) {
+      emit(
+        "error",
+        { error: "Agent is already processing a message" },
+        requestId
+      );
+      emit(
+        "completed",
+        { success: false, error: "Agent is already processing a message" },
+        requestId
+      );
+      return;
+    }
+    running = true;
+    currentRequestId = requestId;
+    currentAbort = new AbortController();
+    completedEmitted = false;
+    const attachments = parsed.attachments;
+    if (attachments?.length) {
+      console.warn(
+        `[headless] Message has ${attachments.length} attachment(s):`,
+        attachments.map((a) => a.url)
+      );
+    }
+    let userMessage = parsed.text ?? "";
+    const isCommand = !!parsed.runCommand;
+    if (parsed.runCommand === "sync") {
+      userMessage = loadActionPrompt("sync");
+    } else if (parsed.runCommand === "publish") {
+      userMessage = loadActionPrompt("publish");
+    } else if (parsed.runCommand === "buildFromInitialSpec") {
+      userMessage = loadActionPrompt("buildFromInitialSpec");
+    }
+    const onboardingState = parsed.onboardingState ?? "onboardingFinished";
+    const system = buildSystemPrompt(
+      onboardingState,
+      parsed.viewContext
+    );
+    try {
+      await runTurn({
+        state,
+        userMessage,
+        attachments,
+        apiConfig: config,
+        system,
+        model: opts.model,
+        onboardingState,
+        signal: currentAbort.signal,
+        onEvent,
+        resolveExternalTool,
+        hidden: isCommand
+      });
+      if (!completedEmitted) {
+        emit(
+          "completed",
+          { success: false, error: "Turn ended unexpectedly" },
+          requestId
+        );
+      }
+    } catch (err) {
+      if (!completedEmitted) {
+        emit("error", { error: err.message }, requestId);
+        emit("completed", { success: false, error: err.message }, requestId);
+      }
+    }
+    currentAbort = null;
+    currentRequestId = void 0;
+    running = false;
+  }
   const rl = createInterface({ input: process.stdin });
   rl.on("line", async (line) => {
     let parsed;
@@ -4737,82 +5050,42 @@ async function startHeadless(opts = {}) {
       emit("error", { error: "Invalid JSON on stdin" });
       return;
     }
-    if (parsed.action === "tool_result" && parsed.id) {
-      const pending = pendingTools.get(parsed.id);
+    const { action, requestId } = parsed;
+    if (action === "tool_result" && parsed.id) {
+      const id = parsed.id;
+      const result = parsed.result ?? "";
+      const pending = pendingTools.get(id);
       if (pending) {
-        pendingTools.delete(parsed.id);
-        pending.resolve(parsed.result ?? "");
+        pendingTools.delete(id);
+        pending.resolve(result);
       } else {
-        earlyResults.set(parsed.id, parsed.result ?? "");
+        earlyResults.set(id, result);
       }
       return;
     }
-    if (parsed.action === "get_history") {
-      emit("history", {
-        messages: state.messages
-      });
+    if (action === "get_history") {
+      dispatchSimple(requestId, "history", () => handleGetHistory(state));
       return;
     }
-    if (parsed.action === "clear") {
-      clearSession(state);
-      emit("session_cleared");
+    if (action === "clear") {
+      dispatchSimple(requestId, "session_cleared", () => handleClear(state));
       return;
     }
-    if (parsed.action === "cancel") {
-      if (currentAbort) {
-        currentAbort.abort();
-      }
-      for (const [id, pending] of pendingTools) {
-        clearTimeout(pending.timeout);
-        pending.resolve("Error: cancelled");
-        pendingTools.delete(id);
-      }
+    if (action === "cancel") {
+      handleCancel(currentAbort, pendingTools);
+      emit("completed", { success: true }, requestId);
       return;
     }
-    if (parsed.action === "message" && (parsed.text || parsed.runCommand)) {
-      if (running) {
-        emit("error", { error: "Agent is already processing a message" });
-        return;
-      }
-      running = true;
-      currentAbort = new AbortController();
-      if (parsed.attachments?.length) {
-        console.warn(
-          `[headless] Message has ${parsed.attachments.length} attachment(s):`,
-          parsed.attachments.map((a) => a.url)
-        );
-      }
-      let userMessage = parsed.text ?? "";
-      const isCommand = !!parsed.runCommand;
-      if (parsed.runCommand === "sync") {
-        userMessage = loadActionPrompt("sync");
-      } else if (parsed.runCommand === "publish") {
-        userMessage = loadActionPrompt("publish");
-      } else if (parsed.runCommand === "buildFromInitialSpec") {
-        userMessage = loadActionPrompt("buildFromInitialSpec");
-      }
-      const onboardingState = parsed.onboardingState ?? "onboardingFinished";
-      const system = buildSystemPrompt(onboardingState, parsed.viewContext);
-      try {
-        await runTurn({
-          state,
-          userMessage,
-          attachments: parsed.attachments,
-          apiConfig: config,
-          system,
-          model: opts.model,
-          onboardingState,
-          signal: currentAbort.signal,
-          onEvent,
-          resolveExternalTool,
-          hidden: isCommand
-        });
-      } catch (err) {
-        emit("error", { error: err.message });
-      }
-      currentAbort = null;
-      running = false;
+    if (action === "message") {
+      await handleMessage(parsed, requestId);
+      return;
     }
+    emit("error", { error: `Unknown action: ${action}` }, requestId);
+    emit(
+      "completed",
+      { success: false, error: `Unknown action: ${action}` },
+      requestId
+    );
   });
   rl.on("close", () => {
     emit("stopping");
@@ -4837,16 +5110,16 @@ var init_headless = __esm({
     init_lsp();
     init_agent();
     init_session();
-    BASE_DIR = import.meta.dirname ?? path13.dirname(new URL(import.meta.url).pathname);
-    ACTIONS_DIR = path13.join(BASE_DIR, "actions");
+    BASE_DIR = import.meta.dirname ?? path14.dirname(new URL(import.meta.url).pathname);
+    ACTIONS_DIR = path14.join(BASE_DIR, "actions");
   }
 });
 
 // src/index.tsx
 import { render } from "ink";
 import os2 from "os";
-import fs21 from "fs";
-import path14 from "path";
+import fs22 from "fs";
+import path15 from "path";
 
 // src/tui/App.tsx
 import { useState as useState2, useCallback, useRef } from "react";
@@ -5163,8 +5436,8 @@ for (let i = 0; i < args.length; i++) {
 }
 function printDebugInfo(config) {
   const pkg = JSON.parse(
-    fs21.readFileSync(
-      path14.join(import.meta.dirname, "..", "package.json"),
+    fs22.readFileSync(
+      path15.join(import.meta.dirname, "..", "package.json"),
       "utf-8"
     )
   );