@mindstudio-ai/remy 0.1.340 → 0.1.342

package/dist/headless.js

@@ -4,8 +4,12 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
+// src/headless/index.ts
+import os2 from "os";
+import fs22 from "fs";
+import path13 from "path";
+
 // src/logger.ts
-import fs from "fs";
 var LEVELS = {
   error: 0,
   warn: 1,
@@ -54,7 +58,7 @@ function createLogger(module) {
 }
 
 // src/config.ts
-import fs2 from "fs";
+import fs from "fs";
 import path from "path";
 import os from "os";
 var log = createLogger("config");
@@ -66,7 +70,7 @@ var CONFIG_PATH = path.join(
 var DEFAULT_BASE_URL = "https://api.mindstudio.ai";
 function loadConfigFile() {
   try {
-    const raw = fs2.readFileSync(CONFIG_PATH, "utf-8");
+    const raw = fs.readFileSync(CONFIG_PATH, "utf-8");
     log.debug("Loaded config file", { path: CONFIG_PATH });
     return JSON.parse(raw);
   } catch (err) {
@@ -773,7 +777,7 @@ async function initModelRegistry(config) {
 }
 
 // src/assets.ts
-import fs3 from "fs";
+import fs2 from "fs";
 import path2 from "path";
 var ASSETS_BASE = import.meta.dirname ?? path2.dirname(new URL(import.meta.url).pathname);
 function assetPath(...segments) {
@@ -782,7 +786,7 @@ function assetPath(...segments) {
 function readAsset(...segments) {
   const full = assetPath(...segments);
   try {
-    return fs3.readFileSync(full, "utf-8").trim();
+    return fs2.readFileSync(full, "utf-8").trim();
   } catch {
     throw new Error(`Required asset missing: ${full}`);
   }
@@ -790,14 +794,14 @@ function readAsset(...segments) {
 function readJsonAsset(fallback, ...segments) {
   const full = assetPath(...segments);
   try {
-    return JSON.parse(fs3.readFileSync(full, "utf-8"));
+    return JSON.parse(fs2.readFileSync(full, "utf-8"));
   } catch {
     return fallback;
   }
 }
 
 // src/prompt/static/projectContext.ts
-import fs4 from "fs";
+import fs3 from "fs";
 
 // src/projectRoot.ts
 var PROJECT_ROOT = process.cwd();
@@ -812,7 +816,7 @@ File paths are relative to this directory. Every tool operates here and bash com
 }
 function loadAppIdentity() {
   try {
-    const manifest = JSON.parse(fs4.readFileSync("mindstudio.json", "utf-8"));
+    const manifest = JSON.parse(fs3.readFileSync("mindstudio.json", "utf-8"));
     const name = typeof manifest.name === "string" ? manifest.name.trim() : "";
     if (!name) {
       return "";
@@ -829,7 +833,7 @@ Full manifest: \`mindstudio.json\` (read it when you need the app's structure, t
 }
 function loadPlanStatus(onboardingState) {
   try {
-    const content = fs4.readFileSync(".remy-plan.md", "utf-8");
+    const content = fs3.readFileSync(".remy-plan.md", "utf-8");
     const match = content.match(/^---\n([\s\S]*?)\n---/);
     const status = match?.[1]?.match(/^status:\s*(.+)$/m)?.[1]?.trim();
     if (status === "pending" && onboardingState === "intake") {
@@ -857,7 +861,7 @@ The user has approved your implementation plan in .remy-plan.md. You may referen
 }
 
 // src/skillCatalog.ts
-import fs5 from "fs";
+import fs4 from "fs";
 import path3 from "path";
 function parseFrontmatter(content) {
   const match = content.match(/^---\n([\s\S]*?)\n---/);
@@ -876,7 +880,7 @@ function parseFrontmatter(content) {
 function buildSkillCatalog(opts) {
   let files;
   try {
-    files = fs5.readdirSync(opts.dir).filter((f) => f.endsWith(".md"));
+    files = fs4.readdirSync(opts.dir).filter((f) => f.endsWith(".md"));
   } catch {
     files = [];
   }
@@ -884,7 +888,7 @@ function buildSkillCatalog(opts) {
   for (const file of files.sort()) {
     const full = path3.join(opts.dir, file);
     const id = file.replace(/\.md$/, "");
-    const fields = parseFrontmatter(fs5.readFileSync(full, "utf-8"));
+    const fields = parseFrontmatter(fs4.readFileSync(full, "utf-8"));
     if (!fields.name || !fields.what || !fields.when) {
       continue;
     }
@@ -903,7 +907,7 @@ function buildSkillCatalog(opts) {
       return skills.find((s) => s.id === id);
     },
     readBody(skill) {
-      return fs5.readFileSync(skill.path, "utf-8").replace(/^---[\s\S]*?---\s*/, "").trim();
+      return fs4.readFileSync(skill.path, "utf-8").replace(/^---[\s\S]*?---\s*/, "").trim();
     },
     renderCatalogBlock() {
       if (skills.length === 0) {
@@ -1175,7 +1179,7 @@ function mergeBackgroundResultsMessages(messages) {
 }
 
 // src/tools/spec/readSpec.ts
-import fs6 from "fs/promises";
+import fs5 from "fs/promises";
 
 // src/tools/spec/_helpers.ts
 function validateSpecPath(filePath) {
@@ -1229,7 +1233,7 @@ var readSpecTool = {
       return `Error: ${err.message}`;
     }
     try {
-      const content = await fs6.readFile(input.path, "utf-8");
+      const content = await fs5.readFile(input.path, "utf-8");
       const allLines = content.split("\n");
       const totalLines = allLines.length;
       const maxLines = input.maxLines === 0 ? Infinity : input.maxLines || DEFAULT_MAX_LINES;
@@ -1257,7 +1261,7 @@ var readSpecTool = {
 };
 
 // src/tools/spec/writeSpec.ts
-import fs7 from "fs/promises";
+import fs6 from "fs/promises";
 import path4 from "path";
 
 // src/tools/_helpers/diff.ts
@@ -1333,7 +1337,7 @@ var writeSpecTool = {
   },
   streaming: {
     transform: async (partial) => {
-      const oldContent = await fs7.readFile(partial.path, "utf-8").catch(() => "");
+      const oldContent = await fs6.readFile(partial.path, "utf-8").catch(() => "");
       const lineCount = partial.content.split("\n").length;
       return `Writing ${partial.path} (${lineCount} lines)
 ${unifiedDiff(partial.path, oldContent, partial.content)}`;
@@ -1347,13 +1351,13 @@ ${unifiedDiff(partial.path, oldContent, partial.content)}`;
     }
     const release = await acquireFileLock(input.path);
     try {
-      await fs7.mkdir(path4.dirname(input.path), { recursive: true });
+      await fs6.mkdir(path4.dirname(input.path), { recursive: true });
       let oldContent = null;
       try {
-        oldContent = await fs7.readFile(input.path, "utf-8");
+        oldContent = await fs6.readFile(input.path, "utf-8");
       } catch {
       }
-      await fs7.writeFile(input.path, input.content, "utf-8");
+      await fs6.writeFile(input.path, input.content, "utf-8");
       const lineCount = input.content.split("\n").length;
       const label = oldContent !== null ? "Wrote" : "Created";
       return `${label} ${input.path} (${lineCount} lines)
@@ -1367,7 +1371,7 @@ ${unifiedDiff(input.path, oldContent ?? "", input.content)}`;
 };
 
 // src/tools/spec/editSpec.ts
-import fs8 from "fs/promises";
+import fs7 from "fs/promises";
 
 // src/tools/code/editFile/_helpers.ts
 function buildLineOffsets(content) {
@@ -1486,7 +1490,7 @@ var editSpecTool = {
     try {
       let content;
       try {
-        content = await fs8.readFile(input.path, "utf-8");
+        content = await fs7.readFile(input.path, "utf-8");
       } catch (err) {
         return `Error reading file: ${err.message}`;
       }
@@ -1539,7 +1543,7 @@ var editSpecTool = {
         return `Error: that edit would remove or malform the spec's YAML frontmatter (the leading \`--- \u2026 ---\` block, which holds required fields like \`name\`). Narrow old_string to the body content you meant to change and leave the frontmatter block intact.`;
       }
       try {
-        await fs8.writeFile(input.path, updated, "utf-8");
+        await fs7.writeFile(input.path, updated, "utf-8");
       } catch (err) {
         return `Error writing file: ${err.message}`;
       }
@@ -1551,7 +1555,7 @@ var editSpecTool = {
 };
 
 // src/tools/spec/listSpecFiles.ts
-import fs9 from "fs/promises";
+import fs8 from "fs/promises";
 import path5 from "path";
 var listSpecFilesTool = {
   definition: {
@@ -1580,7 +1584,7 @@ var listSpecFilesTool = {
 };
 async function listRecursive(dir) {
   const results = [];
-  const entries = await fs9.readdir(dir, { withFileTypes: true });
+  const entries = await fs8.readdir(dir, { withFileTypes: true });
   entries.sort((a, b) => {
     if (a.isDirectory() && !b.isDirectory()) {
       return -1;
@@ -1628,18 +1632,18 @@ var presentPublishPlanTool = {
 };
 
 // src/atomicWrite.ts
-import fs10 from "fs";
+import fs9 from "fs";
 import fsp from "fs/promises";
 var writeFileAtomicSync = (file, data) => {
   const tmp = `${file}.${process.pid}.tmp`;
-  const fd2 = fs10.openSync(tmp, "w");
+  const fd2 = fs9.openSync(tmp, "w");
   try {
-    fs10.writeSync(fd2, data);
-    fs10.fsyncSync(fd2);
+    fs9.writeSync(fd2, data);
+    fs9.fsyncSync(fd2);
   } finally {
-    fs10.closeSync(fd2);
+    fs9.closeSync(fd2);
   }
-  fs10.renameSync(tmp, file);
+  fs9.renameSync(tmp, file);
 };
 var writeFileAtomic = async (file, data) => {
   const tmp = `${file}.${process.pid}.tmp`;
@@ -1683,7 +1687,7 @@ ${content}`;
 };
 
 // src/tools/spec/updatePlanStatus.ts
-import fs11 from "fs/promises";
+import fs10 from "fs/promises";
 var PLAN_FILE2 = ".remy-plan.md";
 var updatePlanStatusTool = {
   definition: {
@@ -1703,17 +1707,17 @@ var updatePlanStatusTool = {
   },
   async execute(input, context) {
     const status = input.status;
-    if (context?.onboardingState === "intake") {
+    if (context.onboardingState === "intake") {
       return `The initial plan isn't approved or rejected through this tool \u2014 the user decides via "Start Building". Keep discussing, and revise the plan with writePlan if they want changes.`;
     }
     let content;
     try {
-      content = await fs11.readFile(PLAN_FILE2, "utf-8");
+      content = await fs10.readFile(PLAN_FILE2, "utf-8");
     } catch {
       return "No plan file found.";
     }
     if (status === "rejected") {
-      await fs11.unlink(PLAN_FILE2).catch(() => {
+      await fs10.unlink(PLAN_FILE2).catch(() => {
       });
       return "Plan rejected and removed.";
     }
@@ -1852,22 +1856,13 @@ var promptUserTool = {
       };
     }
   },
-  async execute(input) {
-    const questions = input.questions;
-    const lines = questions.map((q) => {
-      let line = `- ${q.question}`;
-      if (q.type === "select" || q.type === "checklist") {
-        const opts = (q.options || []).map(
-          (o) => typeof o === "string" ? o : o.label
-        );
-        line += q.type === "checklist" ? ` (pick one or more: ${opts.join(" / ")})` : ` (${opts.join(" / ")})`;
-      } else if (q.type === "file") {
-        line += " (upload file)";
-      }
-      return line;
-    });
-    return `Please answer these questions:
-${lines.join("\n")}`;
+  // Unreachable: promptUser is in EXTERNAL_TOOLS, so every call is answered by
+  // the sandbox rather than here. Present because the Tool interface requires
+  // it, and identical to the other nine external tools for that reason. It
+  // used to render the questions as prose for a local CLI — see the note on
+  // runTurn for why a plausible-looking local answer was the dangerous part.
+  async execute() {
+    return "ok";
   }
 };
 
@@ -2067,7 +2062,7 @@ var askMindStudioSdkTool = {
     const result = await runCli("mindstudio", ["ask", query], {
       timeout: 48e4,
       maxBuffer: 512 * 1024,
-      onLog: context?.onLog
+      onLog: context.onLog
     });
     return formatCliResult(result);
   }
@@ -2122,8 +2117,8 @@ var compactConversationTool = {
     }
   },
   async execute(_input, context) {
-    if (!context?.conversationMessages || !context.apiConfig) {
-      return "Error: compaction requires execution context.";
+    if (!context.conversationMessages) {
+      return "Error: compaction requires the conversation history.";
     }
     const { toolCallId, onBackgroundComplete, toolRegistry } = context;
     triggerCompaction(
@@ -2197,7 +2192,7 @@ This reference lives at ${skill.path}. Re-read it with readFile if you need it a
 };
 
 // src/tools/code/readFile.ts
-import fs12 from "fs/promises";
+import fs11 from "fs/promises";
 var DEFAULT_WINDOW = 500;
 var MAX_BYTES = 64 * 1024;
 function isBinary(buffer) {
@@ -2238,7 +2233,7 @@ var readFileTool = {
   },
   async execute(input) {
     try {
-      const buffer = await fs12.readFile(input.path);
+      const buffer = await fs11.readFile(input.path);
       if (isBinary(buffer)) {
         const size = buffer.length;
         const unit = size > 1024 * 1024 ? `${(size / (1024 * 1024)).toFixed(1)}MB` : `${(size / 1024).toFixed(1)}KB`;
@@ -2310,7 +2305,7 @@ var readFileTool = {
 };
 
 // src/tools/code/writeFile.ts
-import fs13 from "fs/promises";
+import fs12 from "fs/promises";
 import path6 from "path";
 var writeFileTool = {
   definition: {
@@ -2347,7 +2342,7 @@ var writeFileTool = {
         lastNewlineCount = newlineCount;
         const lastNewline = partial.content.lastIndexOf("\n");
         const completeContent = partial.content.substring(0, lastNewline + 1);
-        const oldContent = await fs13.readFile(partial.path, "utf-8").catch(() => "");
+        const oldContent = await fs12.readFile(partial.path, "utf-8").catch(() => "");
         return `Writing ${partial.path} (${newlineCount} lines)
 ${unifiedDiff(partial.path, oldContent, completeContent)}`;
       }
@@ -2356,13 +2351,13 @@ ${unifiedDiff(partial.path, oldContent, completeContent)}`;
   async execute(input) {
     const release = await acquireFileLock(input.path);
     try {
-      await fs13.mkdir(path6.dirname(input.path), { recursive: true });
+      await fs12.mkdir(path6.dirname(input.path), { recursive: true });
       let oldContent = null;
       try {
-        oldContent = await fs13.readFile(input.path, "utf-8");
+        oldContent = await fs12.readFile(input.path, "utf-8");
       } catch {
       }
-      await fs13.writeFile(input.path, input.content, "utf-8");
+      await fs12.writeFile(input.path, input.content, "utf-8");
       const lineCount = input.content.split("\n").length;
       const label = oldContent !== null ? "Wrote" : "Created";
       return `${label} ${input.path} (${lineCount} lines)
@@ -2376,7 +2371,7 @@ ${unifiedDiff(input.path, oldContent ?? "", input.content)}`;
 };
 
 // src/tools/code/editFile/index.ts
-import fs14 from "fs/promises";
+import fs13 from "fs/promises";
 var editFileTool = {
   definition: {
     name: "editFile",
@@ -2407,7 +2402,7 @@ var editFileTool = {
   async execute(input) {
     const release = await acquireFileLock(input.path);
     try {
-      const content = await fs14.readFile(input.path, "utf-8");
+      const content = await fs13.readFile(input.path, "utf-8");
       const { old_string, new_string, replace_all } = input;
       const occurrences = findOccurrences(content, old_string);
       if (replace_all) {
@@ -2423,7 +2418,7 @@ var editFileTool = {
             new_string
           );
         }
-        await fs14.writeFile(input.path, updated, "utf-8");
+        await fs13.writeFile(input.path, updated, "utf-8");
         return `Replaced ${occurrences.length} occurrence${occurrences.length > 1 ? "s" : ""} in ${input.path}
 ${unifiedDiff(input.path, content, updated)}`;
       }
@@ -2434,7 +2429,7 @@ ${unifiedDiff(input.path, content, updated)}`;
           old_string.length,
           new_string
         );
-        await fs14.writeFile(input.path, updated, "utf-8");
+        await fs13.writeFile(input.path, updated, "utf-8");
         return `Updated ${input.path}
 ${unifiedDiff(input.path, content, updated)}`;
       }
@@ -2450,7 +2445,7 @@ ${unifiedDiff(input.path, content, updated)}`;
           flex.matchedText.length,
           new_string
         );
-        await fs14.writeFile(input.path, updated, "utf-8");
+        await fs13.writeFile(input.path, updated, "utf-8");
         return `Updated ${input.path} (matched with flexible whitespace at line ${flex.line})
 ${unifiedDiff(input.path, content, updated)}`;
       }
@@ -2522,12 +2517,12 @@ var bashTool = {
       child.stdout.on("data", (chunk) => {
         const text = chunk.toString();
         output += text;
-        context?.onLog?.(text);
+        context.onLog?.(text);
       });
       child.stderr.on("data", (chunk) => {
         const text = chunk.toString();
         output += text;
-        context?.onLog?.(text);
+        context.onLog?.(text);
       });
       const timer = setTimeout(() => {
         child.kill("SIGTERM");
@@ -2788,12 +2783,12 @@ var globTool = {
 };
 
 // src/tools/code/listDir.ts
-import fs15 from "fs/promises";
+import fs14 from "fs/promises";
 import path8 from "path";
 var EXCLUDE = /* @__PURE__ */ new Set([".git", "node_modules"]);
 var MAX_CHILDREN = 15;
 async function readAndSort(dirPath) {
-  const entries = await fs15.readdir(dirPath, { withFileTypes: true });
+  const entries = await fs14.readdir(dirPath, { withFileTypes: true });
   return entries.filter((e) => !EXCLUDE.has(e.name)).sort((a, b) => {
     if (a.isDirectory() && !b.isDirectory()) {
       return -1;
@@ -2834,7 +2829,7 @@ function formatSize(bytes) {
 }
 async function formatFile(dirPath, name, indent) {
   try {
-    const stat6 = await fs15.stat(path8.join(dirPath, name));
+    const stat6 = await fs14.stat(path8.join(dirPath, name));
     return `${indent}${name}${" ".repeat(Math.max(1, 30 - indent.length - name.length))}${formatSize(stat6.size)}`;
   } catch {
     return `${indent}${name}`;
@@ -3167,7 +3162,7 @@ var queryDatabaseTool = {
 };
 
 // src/usageLedger.ts
-import fs16 from "fs";
+import fs15 from "fs";
 var LEDGER_FILE = ".logs/usage.ndjson";
 function thinkingTokensFromBilling(billingEvents, outputTokens) {
   if (!billingEvents?.length) {
@@ -3183,10 +3178,10 @@ function nanoToDollars(nano) {
 function recordUsage(entry) {
   try {
     if (fd === null) {
-      fs16.mkdirSync(".logs", { recursive: true });
-      fd = fs16.openSync(LEDGER_FILE, "a");
+      fs15.mkdirSync(".logs", { recursive: true });
+      fd = fs15.openSync(LEDGER_FILE, "a");
     }
-    fs16.writeSync(fd, JSON.stringify(entry) + "\n");
+    fs15.writeSync(fd, JSON.stringify(entry) + "\n");
   } catch {
   }
 }
@@ -3477,7 +3472,7 @@ async function captureAndAnalyzeScreenshot(promptOrOptions) {
   let onLog;
   let model;
   let apiConfig;
-  let path13;
+  let path14;
   let fullPage = true;
   let width;
   let height;
@@ -3485,7 +3480,7 @@ async function captureAndAnalyzeScreenshot(promptOrOptions) {
   if (typeof promptOrOptions === "object" && promptOrOptions !== null) {
     prompt = promptOrOptions.prompt;
     existingImage = promptOrOptions.image;
-    path13 = promptOrOptions.path;
+    path14 = promptOrOptions.path;
     if (promptOrOptions.fullPage !== void 0) {
       fullPage = promptOrOptions.fullPage;
     }
@@ -3509,7 +3504,7 @@ async function captureAndAnalyzeScreenshot(promptOrOptions) {
     const ssResult = await sidecarRequest(
       fullPage ? "/screenshot-full-page" : "/screenshot-viewport",
       {
-        ...path13 ? { path: path13 } : {},
+        ...path14 ? { path: path14 } : {},
         ...width != null ? { width } : {},
         ...height != null ? { height } : {},
         ...format ? { format } : {}
@@ -4251,7 +4246,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
             try {
               let result;
               let recording;
-              if (externalTools.has(tc.name) && resolveExternalTool) {
+              if (externalTools.has(tc.name)) {
                 result = await resolveExternalTool(tc.id, tc.name, input);
                 if (tc.name === "browserCommand") {
                   const lifted = liftRecording(result);
@@ -4301,11 +4296,11 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
               run2(newInput);
             }
           };
-          toolRegistry?.register(entry);
+          toolRegistry.register(entry);
           const toolStart = Date.now();
           run2(tc.input);
           const r = await resultPromise;
-          toolRegistry?.unregister(tc.id);
+          toolRegistry.unregister(tc.id);
           log8.info("Tool completed", {
             requestId,
             parentToolId,
@@ -4381,7 +4376,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
     return wrapRun();
   }
   log8.info("Sub-agent backgrounded", { requestId, parentToolId, agentName });
-  toolRegistry?.register({
+  toolRegistry.register({
     id: parentToolId,
     name: agentName,
     input: { task },
@@ -4407,10 +4402,10 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
     }
   };
   runDetached().then((finalResult) => {
-    toolRegistry?.unregister(parentToolId);
+    toolRegistry.unregister(parentToolId);
     onBackgroundComplete?.(finalResult);
   }).catch((err) => {
-    toolRegistry?.unregister(parentToolId);
+    toolRegistry.unregister(parentToolId);
     onBackgroundComplete?.({ text: `Error: ${err.message}`, messages: [] });
   });
   return { text: ack, messages: [], backgrounded: true };
@@ -4573,12 +4568,12 @@ var BROWSER_TOOLS = [
 var BROWSER_EXTERNAL_TOOLS = /* @__PURE__ */ new Set(["browserCommand"]);
 
 // src/subagents/common/context.ts
-import fs17 from "fs";
+import fs16 from "fs";
 import path9 from "path";
 function walkMdFiles(dir, skip) {
   const files = [];
   try {
-    for (const entry of fs17.readdirSync(dir, { withFileTypes: true })) {
+    for (const entry of fs16.readdirSync(dir, { withFileTypes: true })) {
       const full = path9.join(dir, entry.name);
       if (entry.isDirectory()) {
         if (!skip?.has(entry.name) && !entry.name.startsWith(".")) {
@@ -4594,7 +4589,7 @@ function walkMdFiles(dir, skip) {
 }
 function parseFrontmatter2(filePath) {
   try {
-    const content = fs17.readFileSync(filePath, "utf-8");
+    const content = fs16.readFileSync(filePath, "utf-8");
     const match = content.match(/^---\n([\s\S]*?)\n---/);
     if (!match) {
       return {};
@@ -4640,7 +4635,7 @@ function loadRoadmapIndex() {
   const parts = [];
   try {
     const indexJson = JSON.parse(
-      fs17.readFileSync("src/roadmap/index.json", "utf-8")
+      fs16.readFileSync("src/roadmap/index.json", "utf-8")
     );
     if (indexJson.lanes?.length > 0) {
       const laneLines = indexJson.lanes.map(
@@ -4809,9 +4804,6 @@ async function runBrowserAutomation(task, context, opts) {
       requestId: context.requestId,
       onEvent: context.onEvent,
       resolveExternalTool: async (id, name, input) => {
-        if (!context.resolveExternalTool) {
-          return "Error: no external tool resolver";
-        }
         const result2 = await context.resolveExternalTool(id, name, input);
         if (name === "browserCommand") {
           try {
@@ -4910,9 +4902,6 @@ var browserAutomationTool = {
     }
   },
   async execute(input, context) {
-    if (!context) {
-      return "Error: browser automation requires execution context (only available in headless mode)";
-    }
     const result = await runBrowserAutomation(input.task, context);
     let text = result.text;
     if (result.screenshot) {
@@ -4929,7 +4918,7 @@ Replay of this run: ![Browser test replay](replay:${context.toolCallId})`;
       const { sessionId, startTs, endTs } = result.replay;
       text += `
 
-To render this replay as an mp4 (returns a public URL): \`remy-admin recordings export --session ${sessionId} --from ${startTs} --to ${endTs}\``;
+To render this replay as an mp4 (returns a public URL): \`remy-admin qa-recordings export --session ${sessionId} --from ${startTs} --to ${endTs}\``;
     }
     return text;
   }
@@ -4981,7 +4970,7 @@ var screenshotDefinition = {
 };
 async function executeScreenshot(input, onLog, context) {
   const fullPage = input.fullPage === true;
-  const model = resolveModel("imageAnalysis", context?.models, context?.model);
+  const model = resolveModel("imageAnalysis", context.models, context.model);
   try {
     if (input.imageUrl) {
       return await captureAndAnalyzeScreenshot({
@@ -4989,10 +4978,10 @@ async function executeScreenshot(input, onLog, context) {
         image: input.imageUrl,
         onLog,
         model,
-        apiConfig: context?.apiConfig
+        apiConfig: context.apiConfig
       });
     }
-    if (input.instructions && context) {
+    if (input.instructions) {
       const shotKind = fullPage ? "full-page" : "viewport";
       const task = input.path ? `Navigate to "${input.path}", then: ${input.instructions}. After completing these steps, take a ${shotKind} screenshot.` : `${input.instructions}. After completing these steps, take a ${shotKind} screenshot.`;
       const result = await runBrowserAutomation(task, context, {
@@ -5017,7 +5006,7 @@ async function executeScreenshot(input, onLog, context) {
         styleMap,
         onLog,
         model,
-        apiConfig: context?.apiConfig
+        apiConfig: context.apiConfig
       });
     }
     const release = await acquireBrowserLock();
@@ -5031,7 +5020,7 @@ async function executeScreenshot(input, onLog, context) {
         format: input.format,
         onLog,
         model,
-        apiConfig: context?.apiConfig
+        apiConfig: context.apiConfig
       });
     } finally {
       release();
@@ -5042,7 +5031,7 @@ async function executeScreenshot(input, onLog, context) {
 }
 var screenshotTool = {
   definition: screenshotDefinition,
-  execute: (input, context) => executeScreenshot(input, context?.onLog, context)
+  execute: (input, context) => executeScreenshot(input, context.onLog, context)
 };
 
 // src/tools/common/scrapeWebUrl.ts
@@ -5113,7 +5102,7 @@ var scrapeWebUrlTool = {
     return fetchWebPage(input.url, {
       screenshot: true,
       caller: "parent",
-      onLog: context?.onLog
+      onLog: context.onLog
     });
   }
 };
@@ -5239,9 +5228,6 @@ var researchTool = {
     }
   },
   async execute(input, context) {
-    if (!context) {
-      return "Error: research requires execution context";
-    }
     return runResearch(input.task, context);
   }
 };
@@ -5398,7 +5384,7 @@ async function execute2(input, onLog, context) {
     prompt: RENDER_ANALYZE_PROMPT,
     image: url,
     onLog,
-    model: resolveModel("imageAnalysis", context?.models, context?.model)
+    model: resolveModel("imageAnalysis", context.models, context.model)
   }).then((r) => r.analysis).catch((err) => `Could not review this image: ${err.message}`);
   return JSON.stringify({
     images: [
@@ -5538,9 +5524,9 @@ async function analyze(image, prompt, onLog, context, extra) {
   const analyzed = await analyzeImage({
     prompt,
     image,
-    apiConfig: context?.apiConfig,
+    apiConfig: context.apiConfig,
     onLog,
-    model: resolveModel("imageAnalysis", context?.models, context?.model)
+    model: resolveModel("imageAnalysis", context.models, context.model)
   });
   return JSON.stringify({
     url: analyzed.url,
@@ -5548,18 +5534,18 @@ async function analyze(image, prompt, onLog, context, extra) {
     ...extra
   });
 }
-async function analyzeLocalHtml(path13, customPrompt, onLog, context) {
+async function analyzeLocalHtml(path14, customPrompt, onLog, context) {
   let raw;
   try {
-    raw = await readFile2(join2(PROJECT_ROOT, path13), "utf8");
+    raw = await readFile2(join2(PROJECT_ROOT, path14), "utf8");
   } catch {
-    return `No file at "${path13}". Paths resolve from the project root; list the directory to check the name.`;
+    return `No file at "${path14}". Paths resolve from the project root; list the directory to check the name.`;
   }
   const { name, description, html } = splitFrontmatter(raw);
   if (!html.trim()) {
-    return `"${path13}" has no HTML to render.`;
+    return `"${path14}" has no HTML to render.`;
   }
-  onLog?.(`Rendering ${path13} in the sandbox browser...`);
+  onLog?.(`Rendering ${path14} in the sandbox browser...`);
   const release = await acquireBrowserLock();
   let rendered;
   try {
@@ -5570,7 +5556,7 @@ async function analyzeLocalHtml(path13, customPrompt, onLog, context) {
       autoHeight: true
     });
   } catch (err) {
-    return `Could not render ${path13}: ${err?.message ?? err}`;
+    return `Could not render ${path14}: ${err?.message ?? err}`;
   } finally {
     release();
   }
@@ -5619,9 +5605,9 @@ async function execute4(input, onLog, context) {
   const { url, analysis } = await analyzeImage({
     prompt,
     image: input.imageUrl,
-    apiConfig: context?.apiConfig,
+    apiConfig: context.apiConfig,
     onLog,
-    model: resolveModel("imageAnalysis", context?.models, context?.model)
+    model: resolveModel("imageAnalysis", context.models, context.model)
   });
   return JSON.stringify({ url, analysis });
 }
@@ -5899,21 +5885,21 @@ async function execute5(input, onLog, context) {
     sourceImages: input.referenceImage ? [input.referenceImage] : void 0,
     enhancePrompts: true,
     onLog,
-    apiConfig: context?.apiConfig,
+    apiConfig: context.apiConfig,
     imageGenerationModel: resolveModel(
       "imageGeneration",
-      context?.models,
-      context?.model
+      context.models,
+      context.model
     ),
     imageAnalysisModel: resolveModel(
       "imageAnalysis",
-      context?.models,
-      context?.model
+      context.models,
+      context.model
     ),
     imagePromptEnhancerModel: resolveModel(
       "imagePromptEnhancer",
-      context?.models,
-      context?.model
+      context.models,
+      context.model
     )
   });
 }
@@ -5969,21 +5955,21 @@ async function execute6(input, onLog, context) {
     transparentBackground: input.transparentBackground,
     enhancePrompts: false,
     onLog,
-    apiConfig: context?.apiConfig,
+    apiConfig: context.apiConfig,
     imageGenerationModel: resolveModel(
       "imageGeneration",
-      context?.models,
-      context?.model
+      context.models,
+      context.model
     ),
     imageAnalysisModel: resolveModel(
       "imageAnalysis",
-      context?.models,
-      context?.model
+      context.models,
+      context.model
     ),
     imagePromptEnhancerModel: resolveModel(
       "imagePromptEnhancer",
-      context?.models,
-      context?.model
+      context.models,
+      context.model
     )
   });
 }
@@ -6016,9 +6002,6 @@ var copyEditorTool = {
     }
   },
   async execute(input, context) {
-    if (!context) {
-      return "Error: copy editor requires execution context";
-    }
     const specIndex = loadSpecIndex();
     const parts = [BASE_PROMPT3];
     parts.push("<!-- cache_breakpoint -->");
@@ -6232,9 +6215,6 @@ async function uploadMirror(context, slug, content) {
   }
 }
 async function execute9(input, onLog, context) {
-  if (!context) {
-    return "Error: createWireframe requires execution context";
-  }
   const name = String(input.name ?? "");
   const slug = String(input.slug ?? "");
   const description = String(input.description ?? "");
@@ -6295,9 +6275,6 @@ var research = {
     }
   },
   execute: (input, _onLog, context) => {
-    if (!context) {
-      return Promise.resolve("Error: research requires execution context");
-    }
     return runResearch(input.task, context);
   }
 };
@@ -6327,12 +6304,12 @@ async function executeDesignExpertTool(name, input, context, toolCallId, onLog)
   if (!tool) {
     return `Error: unknown tool "${name}"`;
   }
-  const childContext = context && toolCallId ? deriveContext(context, toolCallId, onLog) : context;
+  const childContext = toolCallId ? deriveContext(context, toolCallId, onLog) : context;
   return tool.execute(input, onLog, childContext);
 }
 
 // src/subagents/designExpert/data/sampleCache.ts
-import fs18 from "fs";
+import fs17 from "fs";
 var SAMPLE_FILE = ".remy-design-sample.json";
 var cached2 = null;
 function generateIndices(poolSize, sampleSize) {
@@ -6346,7 +6323,7 @@ function generateIndices(poolSize, sampleSize) {
 }
 function load() {
   try {
-    return JSON.parse(fs18.readFileSync(SAMPLE_FILE, "utf-8"));
+    return JSON.parse(fs17.readFileSync(SAMPLE_FILE, "utf-8"));
   } catch {
     return null;
   }
@@ -6703,9 +6680,6 @@ var designExpertTool = {
     }
   },
   async execute(input, context) {
-    if (!context) {
-      return "Error: visual design expert requires execution context";
-    }
     const result = await runDesignExpert(
       {
         task: input.task,
@@ -6773,7 +6747,7 @@ var VISION_TOOLS = [
 ];
 
 // src/subagents/productVision/executor.ts
-import fs19 from "fs";
+import fs18 from "fs";
 import path10 from "path";
 var ROADMAP_DIR = "src/roadmap";
 var PITCH_DECK_SHELL = readAsset(
@@ -6788,13 +6762,13 @@ async function executeVisionTool(name, input, context) {
     case "writeFile": {
       const filePath = resolve3(input.path);
       try {
-        fs19.mkdirSync(ROADMAP_DIR, { recursive: true });
+        fs18.mkdirSync(ROADMAP_DIR, { recursive: true });
         let oldContent = null;
         try {
-          oldContent = fs19.readFileSync(filePath, "utf-8");
+          oldContent = fs18.readFileSync(filePath, "utf-8");
         } catch {
         }
-        fs19.writeFileSync(filePath, input.content, "utf-8");
+        fs18.writeFileSync(filePath, input.content, "utf-8");
         const lineCount = input.content.split("\n").length;
         const label = oldContent !== null ? "Wrote" : "Created";
         return `${label} ${filePath} (${lineCount} lines)
@@ -6806,11 +6780,11 @@ ${unifiedDiff(filePath, oldContent ?? "", input.content)}`;
     case "deleteFile": {
       const filePath = resolve3(input.path);
       try {
-        if (!fs19.existsSync(filePath)) {
+        if (!fs18.existsSync(filePath)) {
           return `Error: ${filePath} does not exist`;
         }
-        const oldContent = fs19.readFileSync(filePath, "utf-8");
-        fs19.unlinkSync(filePath);
+        const oldContent = fs18.readFileSync(filePath, "utf-8");
+        fs18.unlinkSync(filePath);
         return `Deleted ${filePath}
 ${unifiedDiff(filePath, oldContent, "")}`;
       } catch (err) {
@@ -6818,14 +6792,11 @@ ${unifiedDiff(filePath, oldContent, "")}`;
       }
     }
     case "writePitchDeck": {
-      if (!context) {
-        return "Error: writePitchDeck requires execution context for design expert delegation";
-      }
       const filePath = resolve3("pitch.html");
       try {
-        fs19.mkdirSync(ROADMAP_DIR, { recursive: true });
-        const exists = fs19.existsSync(filePath);
-        const before = exists ? fs19.statSync(filePath).mtimeMs : null;
+        fs18.mkdirSync(ROADMAP_DIR, { recursive: true });
+        const exists = fs18.existsSync(filePath);
+        const before = exists ? fs18.statSync(filePath).mtimeMs : null;
         const delivery = exists ? `### Your deliverable
 The pitch deck already exists at \`${filePath}\`. Read it, then update it for the new <pitch_content>, keeping the presentation scaffolding intact \u2014 change only what needs to change.
 
@@ -6855,11 +6826,11 @@ Maintain the bones of the presentation scaffolding. Always keep the progress bar
 ${delivery}`;
         const result = await runDesignExpertRender({ task }, context);
         context.subAgentMessages?.set(context.toolCallId, result.messages);
-        if (!fs19.existsSync(filePath)) {
+        if (!fs18.existsSync(filePath)) {
           return `Error: the design expert did not write ${filePath}. Its reply was:
 ${result.text}`;
         }
-        if (before !== null && fs19.statSync(filePath).mtimeMs === before) {
+        if (before !== null && fs18.statSync(filePath).mtimeMs === before) {
           return `Error: the pitch deck at ${filePath} was not modified. The design expert's reply was:
 ${result.text}`;
         }
@@ -6910,9 +6881,6 @@ var productVisionTool = {
     }
   },
   async execute(input, context) {
-    if (!context) {
-      return "Error: product vision requires execution context";
-    }
     const history = context.conversationMessages ? getSubAgentHistory(context.conversationMessages, "productVision") : [];
     const result = await runSubAgent({
       system: getProductVisionPrompt(),
@@ -7038,9 +7006,6 @@ var codeSanityCheckTool = {
     }
   },
   async execute(input, context) {
-    if (!context) {
-      return "Error: code sanity check requires execution context";
-    }
     const specIndex = loadSpecIndex();
     const parts = [BASE_PROMPT5, loadPlatformBrief()];
     parts.push("<!-- cache_breakpoint -->");
@@ -7086,7 +7051,7 @@ var codeSanityCheckTool = {
 };
 
 // src/tools/spec/writeBuildOverview.ts
-import fs20 from "fs";
+import fs19 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).
 
@@ -7146,7 +7111,7 @@ 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 exists = fs19.existsSync(OVERVIEW_FILE);
   const task = `<overview_copy>${content}</overview_copy>
 
 ${DESIGN_BRIEF}
@@ -7163,7 +7128,7 @@ ${exists ? refreshDelivery() : initialDelivery()}`;
     }
     const result = await runDesignExpertRender({ task }, context);
     context.subAgentMessages?.set(context.toolCallId, result.messages);
-    if (!fs20.existsSync(OVERVIEW_FILE)) {
+    if (!fs19.existsSync(OVERVIEW_FILE)) {
       return `Error: the design expert did not write ${OVERVIEW_FILE}. Its reply was:
 ${result.text}`;
     }
@@ -7188,11 +7153,8 @@ var buildOverviewTool = {
     }
   },
   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);
+    const background = Boolean(content) && fs19.existsSync(OVERVIEW_FILE);
     if (background) {
       input.background = true;
     }
@@ -7252,9 +7214,6 @@ var specSyncTool = {
     }
   },
   async execute(input, context) {
-    if (!context) {
-      return "Error: spec sync requires execution context";
-    }
     if (context.onboardingState !== "onboardingFinished") {
       return "Spec sync runs only after the build is finished (onboardingFinished). During intake and the initial build you author the spec directly, so there is nothing to reconcile yet.";
     }
@@ -7445,9 +7404,6 @@ var reviewExistingProjectTool = {
     }
   },
   async execute(input, context) {
-    if (!context) {
-      return "Error: reviewExistingProject requires execution context";
-    }
     return runReviewExistingProject(input, context);
   }
 };
@@ -7949,7 +7905,7 @@ Write the summary of the conversation above, following your instructions.`;
 }
 
 // src/session.ts
-import fs21 from "fs";
+import fs20 from "fs";
 import path11 from "path";
 var log12 = createLogger("session");
 var SESSION_FILE = ".remy-session.json";
@@ -7963,7 +7919,7 @@ var ARCHIVE_MSG_CACHE_MAX = 3;
 function loadSession(state) {
   pruneArchives();
   try {
-    const raw = fs21.readFileSync(SESSION_FILE, "utf-8");
+    const raw = fs20.readFileSync(SESSION_FILE, "utf-8");
     const data = JSON.parse(raw);
     if (data.models && typeof data.models === "object") {
       state.models = data.models;
@@ -7979,7 +7935,7 @@ function loadSession(state) {
   } catch {
     try {
       const quarantine = `${SESSION_FILE}.corrupt-${Date.now()}`;
-      fs21.renameSync(SESSION_FILE, quarantine);
+      fs20.renameSync(SESSION_FILE, quarantine);
       log12.warn(`Session file unreadable \u2014 quarantined to ${quarantine}`);
     } catch {
     }
@@ -8031,12 +7987,12 @@ function buildPayload(state) {
   return payload;
 }
 function archiveMessages(messages, label, models) {
-  fs21.mkdirSync(ARCHIVE_DIR, { recursive: true });
+  fs20.mkdirSync(ARCHIVE_DIR, { recursive: true });
   const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
   const count = messages.length;
   let dest = path11.join(ARCHIVE_DIR, `${label}-${ts}.c${count}.json`);
   let n = 1;
-  while (fs21.existsSync(dest)) {
+  while (fs20.existsSync(dest)) {
     dest = path11.join(ARCHIVE_DIR, `${label}-${ts}-${n++}.c${count}.json`);
   }
   const payload = { messages };
@@ -8051,13 +8007,13 @@ function archiveMessages(messages, label, models) {
 }
 function pruneArchives() {
   try {
-    const entries = fs21.readdirSync(ARCHIVE_DIR).filter((name) => ARCHIVE_NAME_RE.test(name));
+    const entries = fs20.readdirSync(ARCHIVE_DIR).filter((name) => ARCHIVE_NAME_RE.test(name));
     if (entries.length <= 1) {
       return;
     }
     const archives = entries.map((name) => ({
       name,
-      size: fs21.statSync(path11.join(ARCHIVE_DIR, name)).size
+      size: fs20.statSync(path11.join(ARCHIVE_DIR, name)).size
     })).sort(
       (a, b) => archiveSortKey(b.name).localeCompare(archiveSortKey(a.name))
     );
@@ -8075,7 +8031,7 @@ function pruneArchives() {
     let freed = 0;
     for (let i = cut; i < archives.length; i++) {
       try {
-        fs21.unlinkSync(path11.join(ARCHIVE_DIR, archives[i].name));
+        fs20.unlinkSync(path11.join(ARCHIVE_DIR, archives[i].name));
         freed += archives[i].size;
         removed++;
       } catch {
@@ -8099,7 +8055,7 @@ function parseArchive(name) {
     return cached3;
   }
   try {
-    const raw = fs21.readFileSync(path11.join(ARCHIVE_DIR, name), "utf-8");
+    const raw = fs20.readFileSync(path11.join(ARCHIVE_DIR, name), "utf-8");
     const data = JSON.parse(raw);
     const messages = Array.isArray(data?.messages) ? data.messages : [];
     for (const msg of messages) {
@@ -8140,7 +8096,7 @@ function readArchiveMessages(name) {
 function listConversationArchives() {
   let names;
   try {
-    names = fs21.readdirSync(ARCHIVE_DIR).filter((n) => ARCHIVE_NAME_RE.test(n));
+    names = fs20.readdirSync(ARCHIVE_DIR).filter((n) => ARCHIVE_NAME_RE.test(n));
   } catch {
     return { slots: [], archivedCount: 0 };
   }
@@ -8426,7 +8382,7 @@ function triggerCompaction(state, apiConfig, opts = {}) {
 }
 
 // src/brandExtraction/index.ts
-import fs22 from "fs";
+import fs21 from "fs";
 import path12 from "path";
 import { createHash } from "crypto";
 var log14 = createLogger("brandExtraction");
@@ -8477,7 +8433,7 @@ function sha256(input) {
 }
 function readSafe(filePath) {
   try {
-    return fs22.readFileSync(filePath, "utf-8");
+    return fs21.readFileSync(filePath, "utf-8");
   } catch {
     return "";
   }
@@ -8503,7 +8459,7 @@ function readBrandManifest() {
 function walkMdFiles2(dir) {
   const results = [];
   try {
-    const entries = fs22.readdirSync(dir, { withFileTypes: true });
+    const entries = fs21.readdirSync(dir, { withFileTypes: true });
     for (const entry of entries) {
       const full = path12.join(dir, entry.name);
       if (entry.isDirectory()) {
@@ -8520,7 +8476,7 @@ function walkMdFiles2(dir) {
 }
 function parseFrontmatter3(filePath) {
   try {
-    const content = fs22.readFileSync(filePath, "utf-8");
+    const content = fs21.readFileSync(filePath, "utf-8");
     const match = content.match(/^---\n([\s\S]*?)\n---/);
     if (!match) {
       return { type: "" };
@@ -8738,7 +8694,7 @@ function persistBrand(brand, inputHash) {
 }
 function readCache() {
   try {
-    const raw = fs22.readFileSync(CACHE_FILE, "utf-8");
+    const raw = fs21.readFileSync(CACHE_FILE, "utf-8");
     const parsed = JSON.parse(raw);
     if (parsed && typeof parsed.inputHash === "string" && typeof parsed.generatedAt === "number") {
       return parsed;
@@ -10009,7 +9965,7 @@ async function runTurn(params) {
           const run = async (input) => {
             try {
               let result;
-              if (EXTERNAL_TOOLS.has(tc.name) && resolveExternalTool) {
+              if (EXTERNAL_TOOLS.has(tc.name)) {
                 saveSession(state);
                 log16.info("Waiting for external tool result", {
                   requestId,
@@ -10073,11 +10029,11 @@ async function runTurn(params) {
               run(newInput);
             }
           };
-          toolRegistry?.register(entry);
+          toolRegistry.register(entry);
           run(tc.input);
           const r = await resultPromise;
           if (!isBackgroundCall(tc)) {
-            toolRegistry?.unregister(tc.id);
+            toolRegistry.unregister(tc.id);
           }
           log16.info("Tool completed", {
             requestId,
@@ -10135,7 +10091,7 @@ async function runTurn(params) {
         midTurnCompactions++;
         await compactNow(`context ${lastCallInputTokens} > ${forceCompactAt}`);
       }
-      if (takeSteering && !signal?.aborted) {
+      if (!signal?.aborted) {
         const injected = (await takeSteering()).filter(
           (e) => e.text.trim().length > 0 || (e.attachments?.length ?? 0) > 0
         );
@@ -10708,6 +10664,31 @@ var MessageQueue = class {
 
 // src/headless/index.ts
 var log19 = createLogger("headless");
+var startupLog = createLogger("startup");
+function logStartup(config, model, flagApiKey) {
+  let version = "(unknown)";
+  try {
+    version = JSON.parse(
+      fs22.readFileSync(
+        path13.join(import.meta.dirname, "..", "package.json"),
+        "utf-8"
+      )
+    ).version;
+  } catch {
+  }
+  startupLog.info("Startup", {
+    version,
+    node: process.version,
+    platform: `${os2.platform()} ${os2.arch()}`,
+    os: `${os2.type()} ${os2.release()}`,
+    cwd: process.cwd(),
+    bin: process.argv[1],
+    model: model || "(default)",
+    baseUrl: config.baseUrl,
+    apiKey: config.apiKey ? `${config.apiKey.slice(0, 8)}...${config.apiKey.slice(-4)}` : "(none)",
+    keySource: flagApiKey ? "cli flag" : process.env.MINDSTUDIO_API_KEY ? "env var" : "config file"
+  });
+}
 var EXTERNAL_TOOL_TIMEOUT_MS = 3e5;
 var LONG_RUNNING_TOOLS = /* @__PURE__ */ new Set(["runMethod", "testJewel"]);
 var LONG_RUNNING_TOOL_TIMEOUT_MS = 18e5;
@@ -10816,6 +10797,7 @@ var HeadlessSession = class {
       apiKey: this.opts.apiKey,
       baseUrl: this.opts.baseUrl
     });
+    logStartup(this.config, this.opts.model, this.opts.apiKey);
     await initModelRegistry(this.config);
     await initOrgContext(this.config);
     const resumed = loadSession(this.state);