@aiden-ade/sandbox-agent 0.1.14 → 0.1.16

package/dist/index.cjs

@@ -36,7 +36,7 @@ var require_XMLHttpRequest = __commonJS({
     "use strict";
     var fs = require("fs");
     var Url = require("url");
-    var spawn2 = require("child_process").spawn;
+    var spawn3 = require("child_process").spawn;
     module2.exports = XMLHttpRequest3;
     XMLHttpRequest3.XMLHttpRequest = XMLHttpRequest3;
     function XMLHttpRequest3(opts) {
@@ -332,7 +332,7 @@ var require_XMLHttpRequest = __commonJS({
           var syncFile = ".node-xmlhttprequest-sync-" + process.pid;
           fs.writeFileSync(syncFile, "", "utf8");
           var execString = "var http = require('http'), https = require('https'), fs = require('fs');var doRequest = http" + (ssl ? "s" : "") + ".request;var options = " + JSON.stringify(options) + ";var responseText = '';var responseData = Buffer.alloc(0);var req = doRequest(options, function(response) {response.on('data', function(chunk) {  var data = Buffer.from(chunk);  responseText += data.toString('utf8');  responseData = Buffer.concat([responseData, data]);});response.on('end', function() {fs.writeFileSync('" + contentFile + "', JSON.stringify({err: null, data: {statusCode: response.statusCode, headers: response.headers, text: responseText, data: responseData.toString('base64')}}), 'utf8');fs.unlinkSync('" + syncFile + "');});response.on('error', function(error) {fs.writeFileSync('" + contentFile + "', 'NODE-XMLHTTPREQUEST-ERROR:' + JSON.stringify(error), 'utf8');fs.unlinkSync('" + syncFile + "');});}).on('error', function(error) {fs.writeFileSync('" + contentFile + "', 'NODE-XMLHTTPREQUEST-ERROR:' + JSON.stringify(error), 'utf8');fs.unlinkSync('" + syncFile + "');});" + (data ? "req.write('" + JSON.stringify(data).slice(1, -1).replace(/'/g, "\\'") + "');" : "") + "req.end();";
-          var syncProc = spawn2(process.argv[0], ["-e", execString]);
+          var syncProc = spawn3(process.argv[0], ["-e", execString]);
           var statusText;
           while (fs.existsSync(syncFile)) {
           }
@@ -645,8 +645,8 @@ var require_common = __commonJS({
         }
         return debug12;
       }
-      function extend(namespace, delimiter) {
-        const newDebug = createDebug(this.namespace + (typeof delimiter === "undefined" ? ":" : delimiter) + namespace);
+      function extend(namespace, delimiter2) {
+        const newDebug = createDebug(this.namespace + (typeof delimiter2 === "undefined" ? ":" : delimiter2) + namespace);
         newDebug.log = this.log;
         return newDebug;
       }
@@ -4812,11 +4812,6 @@ var require_websocket_server = __commonJS({
 
 // ../agent-core/dist/index.js
 var import_child_process = require("child_process");
-var import_crypto = require("crypto");
-var import_fs = require("fs");
-var import_os = require("os");
-var import_path = require("path");
-var import_readline = require("readline");
 
 // ../shared/dist/agent/agent-definitions.js
 var COORDINATOR_PROMPT = `## You are the Coordinator
@@ -4940,7 +4935,7 @@ var GENERAL_PROMPT = `## You are the General Agent
 
 You are a flexible general-purpose agent (an Aiden agent profile) for work that does not need a specialist profile. Wear whatever hat the moment demands \u2014 product thinker, planner, programmer, debugger, tester. Read the room and pick the hat.
 
-When identifying yourself, say "I'm the General Agent (an Aiden agent profile)."
+Your name is Aiden, General Agent.
 
 Clarify the goal only when required, inspect the relevant context first, then complete the requested work directly. Keep changes focused, avoid unrelated refactors, and validate the result before reporting back.
 
@@ -5175,8 +5170,8 @@ var PLAN_MODE_PROMPT = [
   "Include dependencies, ordering, risks, key files/functions, and decision points where relevant.",
   "When the plan is ready, you MUST persist it by calling the create_plan MCP tool.",
   "Pass title, content, summary, taskId, and conversationId. Include teamId too when available.",
-  "If create_plan fails, retry it. Do not exit plan mode until the plan is persisted successfully.",
-  "After create_plan succeeds, call ExitPlanMode to hand the plan back for approval."
+  "If create_plan fails, retry it. Do not finish plan mode until the plan is persisted successfully.",
+  "After create_plan succeeds, present the plan title and artifact link to the user for approval."
 ].join("\n");
 var TEST_MODE_PROMPT = [
   "You are in test mode. Verify the implemented feature carefully.",
@@ -5206,12 +5201,25 @@ function getAidenAgentPrompt(agentId) {
 // ../shared/dist/agent/session-result.js
 var SESSION_RESUME_FAILED_MESSAGE = "Session resume failed. The previous session may have expired or is no longer available. Please start a new session.";
 
+// ../agent-core/dist/index.js
+var import_fs = require("fs");
+var import_os = require("os");
+var import_path = require("path");
+var import_crypto = require("crypto");
+var import_fs2 = require("fs");
+var import_fs3 = require("fs");
+var import_os2 = require("os");
+var import_path2 = require("path");
+var import_readline = require("readline");
+
 // ../shared/dist/constants/agent.js
 var INTERACTIVE_TOOL_NAMES = /* @__PURE__ */ new Set([
   "askuserquestion",
   "exitplanmode",
   "enterplanmode"
 ]);
+var AIDEN_AGENT_WORKOS_USER_ID_PREFIX = "aiden-agent:";
+var AIDEN_AGENT_WORKOS_USER_ID_LIKE_PATTERN = `${AIDEN_AGENT_WORKOS_USER_ID_PREFIX}%`;
 
 // ../shared/dist/constants/tasks.js
 var STATUS_OPTIONS = [
@@ -5232,17 +5240,9 @@ var DEFAULT_TEAM_STATUSES = STATUS_OPTIONS.map((o) => ({
 }));
 
 // ../agent-core/dist/index.js
-var import_fs2 = require("fs");
-var import_os2 = require("os");
-var import_path2 = require("path");
-function formatCliSpawnError(command, error) {
-  if (error.code === "ENOENT") {
-    return new Error(
-      `CLI command not found: ${command}. Install it or configure this provider with the full executable path.`
-    );
-  }
-  return error;
-}
+var import_fs4 = require("fs");
+var import_os3 = require("os");
+var import_path3 = require("path");
 function isLikelyProviderAuthError(stderr) {
   const lower = stderr.toLowerCase();
   return lower.includes("api key") || lower.includes("api_key") || lower.includes("invalid api key") || lower.includes("api key invalid") || lower.includes("unauthorized") || lower.includes("authentication failed") || lower.includes("authentication error") || lower.includes("provider settings") || lower.includes("invalid token") || lower.includes("token expired");
@@ -5287,23 +5287,6 @@ function isTransientError(errorMessage) {
   const lower = errorMessage.toLowerCase();
   return lower.includes("rate limit") || lower.includes("overloaded") || lower.includes("503") || lower.includes("429") || lower.includes("service unavailable") || lower.includes("etimedout") || lower.includes("econnreset") || lower.includes("econnrefused") || lower.includes("epipe");
 }
-function buildPromptWithSystem(config, promptText) {
-  const parts2 = [
-    config.systemPrompt?.trim(),
-    config.systemPromptAppend?.trim(),
-    promptText.trim()
-  ].filter((value2) => Boolean(value2 && value2.length > 0));
-  return parts2.join("\n\n");
-}
-function buildPlanModePrefix(promptText) {
-  return [
-    "You are in plan-only mode.",
-    "Do not make code changes or execute write operations.",
-    "Focus on analysis, planning, and explaining the next steps.",
-    "",
-    promptText
-  ].join("\n");
-}
 function planCliSpawn(command, args, env = process.env) {
   const isWindows = process.platform === "win32";
   const comSpec = env.ComSpec ?? process.env.ComSpec ?? "cmd.exe";
@@ -5339,48 +5322,334 @@ function spawnCli(command, args, context) {
     detached: process.platform !== "win32"
   });
 }
-function createGenericCliBackend(options) {
-  return {
-    kind: options.kind,
-    supportTier: options.supportTier,
-    async run(context) {
-      const presenter = context.presenter;
-      const state = {
-        process: null,
-        iterations: 0,
-        summary: "",
-        allowContinuation: options.allowContinuation ?? false
-      };
-      const prompt = options.augmentPrompt?.(context) ?? (context.config.mode === "plan" ? buildPlanModePrefix(buildPromptWithSystem(context.config, context.promptText)) : buildPromptWithSystem(context.config, context.promptText));
-      const args = options.buildArgs?.(context, prompt) ?? options.args.map((arg) => arg === "{{prompt}}" ? prompt : arg);
-      const child = spawnCli(options.command, args, context);
-      state.process = child;
-      context.onProcessSpawned?.(child);
-      const safeArgs = args.map(
-        (a, i) => i > 0 && args[i - 1] === "--system-prompt" ? `"<system-prompt ${a.length} chars>"` : a
-      );
-      console.info(`[${options.kind}] Spawning: ${options.command} ${safeArgs.join(" ")}`);
-      presenter.recordRawTranscript?.("system", `${options.command} ${args.join(" ")}`, {
-        backendKind: options.kind
-      });
-      child.stdin.on("error", (err) => {
-        if (err.code !== "EPIPE") {
-          console.error(`[${options.kind}] stdin error:`, err);
+function shouldUseReadOnlyRuntimePermissions(config) {
+  if (isReadOnlyAgent(config.agentId)) return true;
+  switch (config.mode) {
+    case "plan":
+    case "ask":
+    case "review":
+      return true;
+    default:
+      return false;
+  }
+}
+function getClaudePermissionMode(config) {
+  switch (config.mode) {
+    case "plan":
+    case "ask":
+    case "review":
+      return "plan";
+    default:
+      return "bypassPermissions";
+  }
+}
+function getClaudeDisallowedTools(config) {
+  return isReadOnlyAgent(config.agentId) ? ["Edit", "Write", "MultiEdit", "NotebookEdit"] : [];
+}
+function parseJsonObject(value2) {
+  try {
+    const parsed = JSON.parse(value2);
+    return typeof parsed === "object" && parsed !== null ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function parseMaybeJson(value2) {
+  if (typeof value2 !== "string") return value2;
+  return parseJsonObject(value2) ?? value2;
+}
+function normalizeCodexMcpToolResult(output) {
+  if (typeof output !== "string") return JSON.stringify(output ?? {}, null, 2);
+  const outputMarker = "\nOutput:\n";
+  const raw = output.includes(outputMarker) ? output.slice(output.indexOf(outputMarker) + outputMarker.length).trim() : output.trim();
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return raw;
+  }
+  if (Array.isArray(parsed)) {
+    const textBlocks = parsed.filter(
+      (entry) => typeof entry === "object" && entry !== null && "text" in entry
+    ).map((entry) => typeof entry.text === "string" ? entry.text : "").filter(Boolean);
+    if (textBlocks.length > 0) return textBlocks.join("\n");
+  }
+  return raw;
+}
+function findCodexSessionLog(runtimeSessionId, codexHome) {
+  if (!runtimeSessionId || !(0, import_fs.existsSync)(codexHome)) return null;
+  const root = (0, import_path.join)(codexHome, "sessions");
+  if (!(0, import_fs.existsSync)(root)) return null;
+  const matches = [];
+  const stack = [root];
+  while (stack.length > 0) {
+    const dir = stack.pop();
+    let entries;
+    try {
+      entries = (0, import_fs.readdirSync)(dir, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      const path = (0, import_path.join)(dir, entry.name);
+      if (entry.isDirectory()) {
+        stack.push(path);
+      } else if (entry.isFile() && entry.name.includes(runtimeSessionId) && entry.name.endsWith(".jsonl")) {
+        try {
+          matches.push({ path, mtimeMs: (0, import_fs.statSync)(path).mtimeMs });
+        } catch {
+          matches.push({ path, mtimeMs: 0 });
         }
-      });
-      if (options.stdinWriter) {
-        options.stdinWriter(child.stdin, context);
-      } else if (options.promptViaStdin) {
-        child.stdin.write(prompt);
-        child.stdin.end();
-      } else {
-        child.stdin.end();
       }
-      if (options.keepStdinOpen) {
-        state.stdin = child.stdin;
+    }
+  }
+  matches.sort((a, b) => b.mtimeMs - a.mtimeMs);
+  return matches[0]?.path ?? null;
+}
+async function replayCodexMcpToolEventsFromSessionLog(context, state) {
+  const runtimeSessionId = state.runtimeSessionId;
+  if (!runtimeSessionId) return;
+  const codexHome = context.env.CODEX_HOME || process.env.CODEX_HOME || (0, import_path.join)((0, import_os.homedir)(), ".codex");
+  const logPath = findCodexSessionLog(runtimeSessionId, codexHome);
+  if (!logPath) return;
+  const emittedToolIds = /* @__PURE__ */ new Set();
+  const lines = (0, import_fs.readFileSync)(logPath, "utf8").split(/\r?\n/).filter(Boolean);
+  for (const line of lines) {
+    const entry = parseJsonObject(line);
+    const payload = entry && typeof entry.payload === "object" && entry.payload !== null ? entry.payload : null;
+    if (!payload) continue;
+    if (payload.type === "function_call") {
+      const callId = typeof payload.call_id === "string" ? payload.call_id : "";
+      const name = typeof payload.name === "string" ? payload.name : "";
+      const namespace = typeof payload.namespace === "string" ? payload.namespace : "";
+      if (!callId || !name || !namespace.startsWith("mcp__")) continue;
+      const toolName = `${namespace}${name}`;
+      context.presenter.onToolUse(toolName, parseMaybeJson(payload.arguments), callId);
+      emittedToolIds.add(callId);
+      continue;
+    }
+    if (payload.type === "tool_search_call") {
+      const callId = typeof payload.call_id === "string" ? payload.call_id : "";
+      if (!callId) continue;
+      context.presenter.onToolUse("tool_search", payload.arguments ?? {}, callId);
+      emittedToolIds.add(callId);
+    }
+  }
+  if (emittedToolIds.size === 0) return;
+  for (const line of lines) {
+    const entry = parseJsonObject(line);
+    const payload = entry && typeof entry.payload === "object" && entry.payload !== null ? entry.payload : null;
+    if (!payload || payload.type !== "function_call_output" && payload.type !== "tool_search_output") continue;
+    const callId = typeof payload.call_id === "string" ? payload.call_id : "";
+    if (!emittedToolIds.has(callId)) continue;
+    try {
+      const result = payload.type === "tool_search_output" ? JSON.stringify(payload.tools ?? [], null, 2) : normalizeCodexMcpToolResult(payload.output);
+      context.presenter.onToolResult?.(callId, result);
+    } catch {
+      context.presenter.onToolResult?.(callId, String(payload.output ?? ""));
+    }
+  }
+}
+function kimiSessionId(cwd) {
+  let resolved = cwd;
+  try {
+    resolved = (0, import_fs2.realpathSync)(cwd);
+  } catch {
+  }
+  return (0, import_crypto.createHash)("md5").update(resolved).digest("hex");
+}
+function parseKimiStructuredLine(line, context, state) {
+  const presenter = context.presenter;
+  if (!state.runtimeSessionId) {
+    state.runtimeSessionId = kimiSessionId(context.cwd);
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(line);
+  } catch {
+    const text = line.trim();
+    if (text.length > 0) {
+      if (text.toLowerCase().includes("llm not set")) state.error = text;
+      void presenter.onLog(`[kimi_cli] ${line}`);
+    }
+    return;
+  }
+  const role = typeof parsed.role === "string" ? parsed.role : "";
+  const contentBlocks = Array.isArray(parsed.content) ? parsed.content : [];
+  const toolCalls = Array.isArray(parsed.tool_calls) ? parsed.tool_calls : [];
+  if (role === "assistant") {
+    const thinking = contentBlocks.filter((b) => b.type === "think" && typeof b.think === "string").map((b) => b.think).join("");
+    if (thinking) {
+      state.iterations = Math.max(state.iterations, 1);
+      void presenter.onThinking(thinking);
+    }
+    if (toolCalls.length > 0) {
+      state.iterations = Math.max(state.iterations, 1);
+      for (const tc of toolCalls) {
+        const fn = typeof tc.function === "object" && tc.function !== null ? tc.function : {};
+        const toolId = typeof tc.id === "string" ? tc.id : `kimi-tool-${Date.now()}`;
+        const toolName = typeof fn.name === "string" ? fn.name : "Tool";
+        let args = {};
+        if (typeof fn.arguments === "string") {
+          try {
+            args = JSON.parse(fn.arguments);
+          } catch {
+          }
+        } else if (typeof fn.arguments === "object" && fn.arguments !== null) {
+          args = fn.arguments;
+        }
+        void presenter.onToolUse(toolName, args, toolId);
       }
-      const stdoutRl = (0, import_readline.createInterface)({ input: child.stdout });
-      const stderrRl = (0, import_readline.createInterface)({ input: child.stderr });
+    } else {
+      const text = contentBlocks.filter((b) => b.type === "text" && typeof b.text === "string").map((b) => b.text).join("");
+      if (text) {
+        state.iterations = Math.max(state.iterations, 1);
+        state.summary += text;
+        void presenter.onAssistantText(text);
+      }
+    }
+    return;
+  }
+  if (role === "tool") {
+    const toolCallId = typeof parsed.tool_call_id === "string" ? parsed.tool_call_id : `kimi-tool-${Date.now()}`;
+    const allText = contentBlocks.filter((b) => b.type === "text" && typeof b.text === "string").map((b) => b.text);
+    const userText = allText.filter((t) => !t.startsWith("<system>")).join("\n");
+    void presenter.onToolResult?.(toolCallId, userText || allText.join("\n"));
+    return;
+  }
+}
+function buildPromptWithSystem(config, promptText) {
+  const parts2 = [
+    config.systemPrompt?.trim(),
+    config.systemPromptAppend?.trim(),
+    promptText.trim()
+  ].filter((value2) => Boolean(value2 && value2.length > 0));
+  return parts2.join("\n\n");
+}
+function buildPlanModePrefix(promptText) {
+  return [
+    "You are in plan-only mode.",
+    "Do not make code changes or execute write operations.",
+    "Focus on analysis, planning, and explaining the next steps.",
+    "",
+    promptText
+  ].join("\n");
+}
+function imageFileExtension(mimeType) {
+  const subtype = mimeType.split("/")[1]?.split(/[+;]/)[0]?.trim();
+  if (!subtype) return "png";
+  return subtype === "jpeg" ? "jpg" : subtype;
+}
+function createImageTempDirectory(cwd) {
+  const candidates = [
+    cwd ? (0, import_path2.join)(cwd, ".aiden-images-") : null,
+    (0, import_path2.join)((0, import_os2.tmpdir)(), "aiden-images-")
+  ].filter((value2) => Boolean(value2));
+  for (const candidate of candidates) {
+    try {
+      return (0, import_fs3.mkdtempSync)(candidate);
+    } catch {
+    }
+  }
+  return (0, import_fs3.mkdtempSync)((0, import_path2.join)((0, import_os2.tmpdir)(), "aiden-images-"));
+}
+function writeImagesToTempFiles(images, cwd) {
+  if (!images?.length) return { paths: [], files: [], cleanup: () => {
+  } };
+  const directory = createImageTempDirectory(cwd);
+  const paths = [];
+  const files = [];
+  for (const img of images) {
+    const ext = imageFileExtension(img.mimeType);
+    const filePath = (0, import_path2.join)(directory, `aiden-img-${img.id}.${ext}`);
+    (0, import_fs3.writeFileSync)(filePath, Buffer.from(img.data, "base64"));
+    paths.push(filePath);
+    files.push({
+      filename: img.filename,
+      mimeType: img.mimeType,
+      width: img.width,
+      height: img.height,
+      path: filePath
+    });
+  }
+  return {
+    paths,
+    files,
+    cleanup: () => {
+      try {
+        (0, import_fs3.rmSync)(directory, { recursive: true, force: true });
+      } catch {
+      }
+    }
+  };
+}
+function appendImagePathReferences(prompt, images) {
+  if (images.length === 0) return prompt;
+  const imageLines = images.map((img) => {
+    const dimensions = img.width > 0 && img.height > 0 ? `, ${img.width}x${img.height}` : "";
+    return `- ${img.filename} (${img.mimeType}${dimensions}): @${img.path} (path: ${img.path})`;
+  });
+  return [
+    prompt,
+    "Attached images are available as local files. Use the @path references below when this CLI supports file references, or read the plain paths with filesystem tools:",
+    ...imageLines
+  ].join("\n\n");
+}
+function buildPromptWithImagePathReferences(context, images) {
+  const base = buildPromptWithSystem(context.config, context.promptText);
+  const prompt = context.config.mode === "plan" ? buildPlanModePrefix(base) : base;
+  return appendImagePathReferences(prompt, images);
+}
+function formatCliSpawnError(command, error) {
+  if (error.code === "ENOENT") {
+    return new Error(
+      `CLI command not found: ${command}. Install it or configure this provider with the full executable path.`
+    );
+  }
+  return error;
+}
+function createGenericCliBackend(options) {
+  return {
+    kind: options.kind,
+    supportTier: options.supportTier,
+    async run(context) {
+      const presenter = context.presenter;
+      const state = {
+        process: null,
+        iterations: 0,
+        summary: "",
+        allowContinuation: options.allowContinuation ?? false
+      };
+      const prompt = options.augmentPrompt?.(context) ?? (context.config.mode === "plan" ? buildPlanModePrefix(buildPromptWithSystem(context.config, context.promptText)) : buildPromptWithSystem(context.config, context.promptText));
+      const args = options.buildArgs?.(context, prompt) ?? options.args.map((arg) => arg === "{{prompt}}" ? prompt : arg);
+      const child = spawnCli(options.command, args, context);
+      state.process = child;
+      context.onProcessSpawned?.(child);
+      const safeArgs = args.map(
+        (a, i) => i > 0 && args[i - 1] === "--system-prompt" ? `"<system-prompt ${a.length} chars>"` : a
+      );
+      console.info(`[${options.kind}] Spawning: ${options.command} ${safeArgs.join(" ")}`);
+      presenter.recordRawTranscript?.("system", `${options.command} ${args.join(" ")}`, {
+        backendKind: options.kind
+      });
+      child.stdin.on("error", (err) => {
+        if (err.code !== "EPIPE") {
+          console.error(`[${options.kind}] stdin error:`, err);
+        }
+      });
+      if (options.stdinWriter) {
+        options.stdinWriter(child.stdin, context);
+      } else if (options.promptViaStdin) {
+        child.stdin.write(prompt);
+        if (!options.keepStdinOpen) child.stdin.end();
+      } else if (!options.keepStdinOpen) {
+        child.stdin.end();
+      }
+      if (options.keepStdinOpen) {
+        state.stdin = child.stdin;
+      }
+      const stdoutRl = (0, import_readline.createInterface)({ input: child.stdout });
+      const stderrRl = (0, import_readline.createInterface)({ input: child.stderr });
       const stderrLines = [];
       stdoutRl.on("line", (line) => {
         presenter.recordRawTranscript?.("stdout", line);
@@ -5708,155 +5977,281 @@ function parseClaudeStructuredLine(line, context, state) {
       break;
   }
 }
-function parseCodexStructuredLine(line, context, state) {
-  const presenter = context.presenter;
-  let parsed = null;
-  try {
-    parsed = JSON.parse(line);
-  } catch {
-    void presenter.onLog(`[codex] ${line}`);
-    return;
-  }
-  const type = typeof parsed.type === "string" ? parsed.type : "";
-  if (!type) return;
-  if (typeof parsed.thread_id === "string") {
-    state.runtimeSessionId = parsed.thread_id;
-  }
-  const extractCodexErrorMessage = (value2) => {
-    if (typeof value2 !== "string") return "";
-    const trimmed = value2.trim();
-    if (!trimmed) return "";
-    try {
-      const parsedValue = JSON.parse(trimmed);
-      if (typeof parsedValue.detail === "string" && parsedValue.detail.trim().length > 0) {
-        return parsedValue.detail.trim();
-      }
-      if (typeof parsedValue.message === "string" && parsedValue.message.trim().length > 0) {
-        return parsedValue.message.trim();
+function buildClaudeModelArg(baseModel, selectedContextWindow) {
+  if (selectedContextWindow === "1m") return `${baseModel}[1m]`;
+  return baseModel;
+}
+function createClaudeCliBackend(command = "claude", defaultArgs = []) {
+  return {
+    kind: "claude_cli",
+    supportTier: "structured",
+    async run(context) {
+      const args = [
+        "--verbose",
+        "--output-format",
+        "stream-json",
+        "--input-format",
+        "stream-json",
+        "--permission-mode",
+        getClaudePermissionMode(context.config)
+      ];
+      const disallowedTools = getClaudeDisallowedTools(context.config);
+      if (disallowedTools.length > 0) {
+        args.push("--disallowedTools", disallowedTools.join(","));
       }
-    } catch {
-    }
-    return trimmed;
-  };
-  switch (type) {
-    case "thread.started":
-      break;
-    case "turn.started":
-      state.iterations += 1;
-      break;
-    case "session_configured":
-      if (typeof parsed.session_id === "string") {
-        state.runtimeSessionId = parsed.session_id;
+      const resumeId = context.config.runtimeSessionId?.trim() || context.config.providerSessionId?.trim();
+      if (!resumeId) {
+        if (context.config.systemPrompt?.trim()) {
+          args.push("--system-prompt", context.config.systemPrompt.trim());
+        }
+        if (context.config.systemPromptAppend?.trim()) {
+          args.push("--append-system-prompt", context.config.systemPromptAppend.trim());
+        }
       }
-      break;
-    case "task_started":
-      state.iterations += 1;
-      break;
-    case "item.started": {
-      const item = typeof parsed.item === "object" && parsed.item !== null ? parsed.item : null;
-      if (!item || item.type !== "command_execution" || typeof item.id !== "string") break;
-      const command = typeof item.command === "string" ? item.command : "";
-      void presenter.onToolUse("Bash", { command, cwd: context.cwd }, item.id);
-      break;
-    }
-    case "item.completed": {
-      const item = typeof parsed.item === "object" && parsed.item !== null ? parsed.item : null;
-      if (!item || typeof item.type !== "string") break;
-      if (item.type === "reasoning" && typeof item.text === "string") {
-        void presenter.onThinking(item.text);
-        break;
+      const baseModel = context.config.selectedModel?.trim();
+      if (baseModel) {
+        args.push("--model", buildClaudeModelArg(baseModel, context.config.selectedContextWindow));
       }
-      if (item.type === "agent_message" && typeof item.text === "string") {
-        state.summary += `${item.text}
-`;
-        void presenter.onAssistantText(item.text);
-        break;
+      const claudeEffort = context.config.selectedEffortLevel?.trim();
+      if (claudeEffort) {
+        args.push("--effort", claudeEffort);
       }
-      if (item.type === "command_execution" && typeof item.id === "string") {
-        const output = typeof item.aggregated_output === "string" ? item.aggregated_output : "";
-        const itemExitCode = typeof item.exit_code === "number" ? item.exit_code : null;
-        const resultText = output.trim().length > 0 ? output : itemExitCode === null ? "" : `Exit code: ${itemExitCode}`;
-        void presenter.onToolResult?.(item.id, resultText);
-        break;
+      if (resumeId) {
+        args.push("--resume", resumeId);
+        console.info("[claude_cli] Resuming session", { resumeId });
       }
-      break;
+      args.push("--chrome");
+      console.info("[claude_cli] Chrome flag added \u2014 final args:", args.join(" "));
+      args.push(...defaultArgs);
+      return createGenericCliBackend({
+        kind: "claude_cli",
+        supportTier: "structured",
+        command,
+        args,
+        parseStructuredLine: parseClaudeStructuredLine,
+        stdinWriter: (stdin, ctx) => {
+          const contentBlocks = [];
+          if (ctx.config.images?.length) {
+            for (const img of ctx.config.images) {
+              contentBlocks.push({
+                type: "image",
+                source: { type: "base64", media_type: img.mimeType, data: img.data }
+              });
+            }
+          }
+          const promptText = ctx.config.mode === "plan" ? buildPlanModePrefix(buildPromptWithSystem(ctx.config, ctx.promptText)) : buildPromptWithSystem(ctx.config, ctx.promptText);
+          if (promptText.trim()) {
+            contentBlocks.push({ type: "text", text: promptText });
+          }
+          console.info(`[claude_cli] stdinWriter: ${contentBlocks.length} content blocks (${ctx.config.images?.length ?? 0} images)`);
+          const message = JSON.stringify({
+            type: "user",
+            message: { role: "user", content: contentBlocks },
+            session_id: "default",
+            parent_tool_use_id: null
+          });
+          stdin.write(message + "\n");
+        },
+        keepStdinOpen: true,
+        allowContinuation: true,
+        continuationIdleMs: 10 * 60 * 1e3
+        // 10 minutes
+      }).run(context);
     }
-    case "agent_message_delta":
-    case "agent_message_content_delta": {
-      const delta = typeof parsed.delta === "string" ? parsed.delta : "";
-      if (!delta) return;
-      state.summary += delta;
-      void presenter.onAssistantText(delta);
-      break;
-    }
-    case "agent_reasoning_delta":
-    case "reasoning_content_delta":
-    case "agent_reasoning_raw_content_delta": {
-      const delta = typeof parsed.delta === "string" ? parsed.delta : "";
-      if (!delta) return;
-      void presenter.onThinking(delta);
-      break;
+  };
+}
+function createSupatestCliBackend(command = "supatest", defaultArgs = []) {
+  return {
+    kind: "supatest_cli",
+    supportTier: "structured",
+    async run(context) {
+      const args = [
+        "--cwd",
+        context.cwd,
+        "--output-format",
+        "stream-json",
+        "--input-format",
+        "stream-json",
+        "--permission-mode",
+        getClaudePermissionMode(context.config)
+      ];
+      const resumeId = context.config.runtimeSessionId?.trim() || context.config.providerSessionId?.trim();
+      if (!resumeId) {
+        if (context.config.systemPrompt?.trim()) {
+          args.push("--system-prompt", context.config.systemPrompt.trim());
+        }
+        if (context.config.systemPromptAppend?.trim()) {
+          args.push("--append-system-prompt", context.config.systemPromptAppend.trim());
+        }
+      }
+      const baseModel = context.config.selectedModel?.trim();
+      if (baseModel) {
+        args.push("--model", buildClaudeModelArg(baseModel, context.config.selectedContextWindow));
+      }
+      if (resumeId) {
+        args.push("--resume", resumeId);
+        console.info("[supatest_cli] Resuming session", { resumeId });
+      }
+      args.push(...defaultArgs);
+      return createGenericCliBackend({
+        kind: "supatest_cli",
+        supportTier: "structured",
+        command,
+        args,
+        parseStructuredLine: parseClaudeStructuredLine,
+        stdinWriter: (stdin, ctx) => {
+          const contentBlocks = [];
+          if (ctx.config.images?.length) {
+            for (const img of ctx.config.images) {
+              contentBlocks.push({
+                type: "image",
+                source: { type: "base64", media_type: img.mimeType, data: img.data }
+              });
+            }
+          }
+          const promptText = ctx.config.mode === "plan" ? buildPlanModePrefix(buildPromptWithSystem(ctx.config, ctx.promptText)) : buildPromptWithSystem(ctx.config, ctx.promptText);
+          if (promptText.trim()) {
+            contentBlocks.push({ type: "text", text: promptText });
+          }
+          const message = JSON.stringify({
+            type: "user",
+            message: { role: "user", content: contentBlocks },
+            session_id: "default",
+            parent_tool_use_id: null
+          });
+          stdin.write(message + "\n");
+        },
+        keepStdinOpen: true
+      }).run(context);
     }
-    case "exec_command_begin": {
-      const toolId = typeof parsed.call_id === "string" ? parsed.call_id : `exec-${Date.now()}`;
-      const command = Array.isArray(parsed.command) ? parsed.command.join(" ") : "";
-      const cwd = typeof parsed.cwd === "string" ? parsed.cwd : context.cwd;
-      void presenter.onToolUse("Bash", { command, cwd }, toolId);
-      break;
+  };
+}
+function shouldEnableKimiCliThinking(model) {
+  return model?.trim() === "kimi-k2.6-thinking";
+}
+function resolveKimiCliModelArg(model) {
+  const trimmed = model?.trim();
+  if (!trimmed) return void 0;
+  if (trimmed === "kimi-latest" || trimmed === "kimi-k2.5" || trimmed === "kimi-k2.6" || shouldEnableKimiCliThinking(trimmed)) {
+    return void 0;
+  }
+  if (trimmed.startsWith("claude-")) return void 0;
+  return trimmed;
+}
+function createKimiCliBackend(command = "kimi", defaultArgs = []) {
+  return {
+    kind: "kimi_cli",
+    supportTier: "structured",
+    async run(context) {
+      const { files: imageFiles, cleanup } = writeImagesToTempFiles(context.config.images, context.cwd);
+      try {
+        return await createGenericCliBackend({
+          kind: "kimi_cli",
+          supportTier: "structured",
+          command,
+          args: [],
+          buildArgs: (ctx, prompt) => {
+            const args = [
+              "--print",
+              "--output-format",
+              "stream-json",
+              "--work-dir",
+              ctx.cwd
+            ];
+            const resumeId = ctx.config.runtimeSessionId?.trim() || ctx.config.providerSessionId?.trim();
+            if (resumeId) args.push("--session", resumeId);
+            if (shouldEnableKimiCliThinking(ctx.config.selectedModel)) {
+              args.push("--thinking");
+            }
+            const model = resolveKimiCliModelArg(ctx.config.selectedModel);
+            if (model) args.push("--model", model);
+            return [...args, ...defaultArgs, "--prompt", prompt];
+          },
+          augmentPrompt: (ctx) => buildPromptWithImagePathReferences(ctx, imageFiles),
+          parseStructuredLine: parseKimiStructuredLine
+        }).run(context);
+      } finally {
+        cleanup();
+      }
     }
-    case "exec_command_end": {
-      const toolId = typeof parsed.call_id === "string" ? parsed.call_id : `exec-${Date.now()}`;
-      const output = typeof parsed.formatted_output === "string" ? parsed.formatted_output : typeof parsed.aggregated_output === "string" ? parsed.aggregated_output : "";
-      void presenter.onToolResult?.(toolId, output);
+  };
+}
+function buildGeminiToolResultText(parsed) {
+  const output = typeof parsed.output === "string" ? parsed.output : "";
+  if (output.trim().length > 0) return output;
+  const error = typeof parsed.error === "object" && parsed.error !== null ? parsed.error : null;
+  const message = typeof error?.message === "string" ? error.message.trim() : "";
+  const errorType = typeof error?.type === "string" ? error.type.trim() : "";
+  if (message && errorType) return `${errorType}: ${message}`;
+  if (message) return message;
+  const status = typeof parsed.status === "string" ? parsed.status.trim() : "";
+  return status || "Tool completed";
+}
+function parseGeminiStructuredLine(line, context, state) {
+  const presenter = context.presenter;
+  let parsed = null;
+  try {
+    parsed = JSON.parse(line);
+  } catch {
+    void presenter.onLog(`[gemini_cli] ${line}`);
+    return;
+  }
+  const type = typeof parsed.type === "string" ? parsed.type : "";
+  if (!type) return;
+  if (typeof parsed.session_id === "string") state.runtimeSessionId = parsed.session_id;
+  if (typeof parsed.model === "string") state.activeModel = parsed.model;
+  switch (type) {
+    case "init": {
+      const model = state.activeModel || context.config.selectedModel || "gemini";
+      void presenter.onLog(`[gemini_cli] Session initialized with ${model}`);
       break;
     }
-    case "mcp_tool_call_begin": {
-      const toolId = typeof parsed.call_id === "string" ? parsed.call_id : `mcp-${Date.now()}`;
-      const invocation = typeof parsed.invocation === "object" && parsed.invocation !== null ? parsed.invocation : {};
-      const tool = typeof invocation.tool_name === "string" ? invocation.tool_name : typeof invocation.tool === "string" ? invocation.tool : "MCP Tool";
-      void presenter.onToolUse(tool, invocation, toolId);
+    case "message": {
+      if (typeof parsed.role !== "string" || parsed.role !== "assistant") break;
+      const content = typeof parsed.content === "string" ? parsed.content : "";
+      if (!content) break;
+      state.iterations = Math.max(state.iterations, 1);
+      state.summary += content;
+      void presenter.onAssistantText(content);
       break;
     }
-    case "mcp_tool_call_end": {
-      const toolId = typeof parsed.call_id === "string" ? parsed.call_id : `mcp-${Date.now()}`;
-      void presenter.onToolResult?.(toolId, JSON.stringify(parsed.result ?? {}, null, 2));
+    case "tool_use": {
+      const toolName = typeof parsed.tool_name === "string" ? parsed.tool_name : "Gemini Tool";
+      const toolId = typeof parsed.tool_id === "string" ? parsed.tool_id : `gemini-tool-${Date.now()}`;
+      state.iterations = Math.max(state.iterations, 1);
+      void presenter.onToolUse(toolName, parsed.parameters ?? {}, toolId);
       break;
     }
-    case "token_count": {
-      const info = typeof parsed.info === "object" && parsed.info !== null ? parsed.info : {};
-      state.usage = {
-        model: typeof info.model === "string" ? info.model : "codex",
-        numTurns: Math.max(state.iterations, 1),
-        durationMs: 0,
-        inputTokens: typeof info.input_tokens === "number" ? info.input_tokens : 0,
-        outputTokens: typeof info.output_tokens === "number" ? info.output_tokens : 0,
-        cacheReadTokens: typeof info.cached_input_tokens === "number" ? info.cached_input_tokens : 0,
-        cacheCreationTokens: 0,
-        costUsd: typeof info.total_cost_usd === "number" ? info.total_cost_usd : 0
-      };
-      void presenter.onUsageUpdate?.({
-        model: state.usage.model,
-        inputTokens: state.usage.inputTokens,
-        outputTokens: state.usage.outputTokens,
-        cacheReadTokens: state.usage.cacheReadTokens,
-        cacheCreationTokens: state.usage.cacheCreationTokens
-      });
+    case "tool_result": {
+      const toolId = typeof parsed.tool_id === "string" ? parsed.tool_id : `gemini-tool-${Date.now()}`;
+      state.iterations = Math.max(state.iterations, 1);
+      void presenter.onToolResult?.(toolId, buildGeminiToolResultText(parsed));
       break;
     }
-    case "task_complete": {
-      const lastMessage = typeof parsed.last_agent_message === "string" ? parsed.last_agent_message : "";
-      if (lastMessage.length > 0) state.summary = lastMessage;
+    case "error": {
+      const errObj = typeof parsed.error === "object" && parsed.error !== null ? parsed.error : null;
+      const message = typeof parsed.message === "string" && parsed.message.trim() || errObj && typeof errObj.message === "string" && errObj.message.trim() || typeof parsed.error === "string" && parsed.error.trim() || typeof parsed.error_message === "string" && parsed.error_message.trim() || "";
+      const severity = typeof parsed.severity === "string" ? parsed.severity : "error";
+      if (message) {
+        if (severity === "error") {
+          void presenter.onError(message);
+          state.error = message;
+        } else {
+          void presenter.onLog(`[gemini_cli/${severity}] ${message}`);
+        }
+      }
       break;
     }
-    case "turn.completed": {
-      const usage = typeof parsed.usage === "object" && parsed.usage !== null ? parsed.usage : {};
+    case "result": {
+      const stats = typeof parsed.stats === "object" && parsed.stats !== null ? parsed.stats : {};
+      state.iterations = Math.max(state.iterations, 1);
       state.usage = {
-        model: typeof context.config.selectedModel === "string" && context.config.selectedModel.trim() ? context.config.selectedModel : "codex",
+        model: state.activeModel || (typeof context.config.selectedModel === "string" && context.config.selectedModel.trim() ? context.config.selectedModel : "gemini"),
         numTurns: Math.max(state.iterations, 1),
-        durationMs: 0,
-        inputTokens: typeof usage.input_tokens === "number" ? usage.input_tokens : 0,
-        outputTokens: typeof usage.output_tokens === "number" ? usage.output_tokens : 0,
-        cacheReadTokens: typeof usage.cached_input_tokens === "number" ? usage.cached_input_tokens : 0,
+        durationMs: typeof stats.duration_ms === "number" ? stats.duration_ms : 0,
+        inputTokens: typeof stats.input_tokens === "number" ? stats.input_tokens : typeof stats.input === "number" ? stats.input : 0,
+        outputTokens: typeof stats.output_tokens === "number" ? stats.output_tokens : 0,
+        cacheReadTokens: typeof stats.cached === "number" ? stats.cached : 0,
         cacheCreationTokens: 0,
         costUsd: 0
       };
@@ -5867,24 +6262,15 @@ function parseCodexStructuredLine(line, context, state) {
         cacheReadTokens: state.usage.cacheReadTokens,
         cacheCreationTokens: state.usage.cacheCreationTokens
       });
-      break;
-    }
-    case "error": {
-      const message = extractCodexErrorMessage(parsed.message) || extractCodexErrorMessage(parsed.error) || typeof parsed.detail === "string" && parsed.detail.trim() || "";
-      if (message) {
-        const normalizedMessage = normalizeCodexCliErrorMessage(message);
-        void presenter.onError(normalizedMessage);
-        state.error = normalizedMessage;
-      }
-      break;
-    }
-    case "turn.failed": {
-      const error = typeof parsed.error === "object" && parsed.error !== null ? parsed.error : {};
-      const message = extractCodexErrorMessage(error.message) || extractCodexErrorMessage(error.detail) || typeof parsed.message === "string" && parsed.message.trim() || "";
-      if (message) {
-        const normalizedMessage = normalizeCodexCliErrorMessage(message);
-        void presenter.onError(normalizedMessage);
-        state.error = normalizedMessage;
+      if (typeof parsed.status === "string" && parsed.status !== "success" && !state.error) {
+        const errObj = typeof parsed.error === "object" && parsed.error !== null ? parsed.error : null;
+        const errMsg = typeof parsed.error === "string" && parsed.error.trim() || errObj && typeof errObj.message === "string" && errObj.message.trim() || typeof parsed.error_message === "string" && parsed.error_message.trim() || typeof parsed.message === "string" && parsed.message.trim() || typeof parsed.result === "string" && parsed.result.trim() || parsed.status;
+        state.error = errMsg;
+        console.error("[gemini_cli] result status=", parsed.status, "error:", JSON.stringify({
+          error: parsed.error,
+          error_message: parsed.error_message,
+          message: parsed.message
+        }));
       }
       break;
     }
@@ -5892,109 +6278,36 @@ function parseCodexStructuredLine(line, context, state) {
       break;
   }
 }
-function parseJsonObject(value2) {
-  try {
-    const parsed = JSON.parse(value2);
-    return typeof parsed === "object" && parsed !== null ? parsed : null;
-  } catch {
-    return null;
-  }
-}
-function parseMaybeJson(value2) {
-  if (typeof value2 !== "string") return value2;
-  return parseJsonObject(value2) ?? value2;
-}
-function normalizeCodexMcpToolResult(output) {
-  if (typeof output !== "string") return JSON.stringify(output ?? {}, null, 2);
-  const outputMarker = "\nOutput:\n";
-  const raw = output.includes(outputMarker) ? output.slice(output.indexOf(outputMarker) + outputMarker.length).trim() : output.trim();
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch {
-    return raw;
-  }
-  if (Array.isArray(parsed)) {
-    const textBlocks = parsed.filter(
-      (entry) => typeof entry === "object" && entry !== null && "text" in entry
-    ).map((entry) => typeof entry.text === "string" ? entry.text : "").filter(Boolean);
-    if (textBlocks.length > 0) return textBlocks.join("\n");
-  }
-  return raw;
-}
-function findCodexSessionLog(runtimeSessionId, codexHome) {
-  if (!runtimeSessionId || !(0, import_fs.existsSync)(codexHome)) return null;
-  const root = (0, import_path.join)(codexHome, "sessions");
-  if (!(0, import_fs.existsSync)(root)) return null;
-  const matches = [];
-  const stack = [root];
-  while (stack.length > 0) {
-    const dir = stack.pop();
-    let entries;
-    try {
-      entries = (0, import_fs.readdirSync)(dir, { withFileTypes: true });
-    } catch {
-      continue;
-    }
-    for (const entry of entries) {
-      const path = (0, import_path.join)(dir, entry.name);
-      if (entry.isDirectory()) {
-        stack.push(path);
-      } else if (entry.isFile() && entry.name.includes(runtimeSessionId) && entry.name.endsWith(".jsonl")) {
-        try {
-          matches.push({ path, mtimeMs: (0, import_fs.statSync)(path).mtimeMs });
-        } catch {
-          matches.push({ path, mtimeMs: 0 });
-        }
+function createGeminiCliBackend(command = "gemini", defaultArgs = []) {
+  return {
+    kind: "gemini_cli",
+    supportTier: "structured",
+    async run(context) {
+      const { files: imageFiles, cleanup } = writeImagesToTempFiles(context.config.images, context.cwd);
+      try {
+        return await createGenericCliBackend({
+          kind: "gemini_cli",
+          supportTier: "structured",
+          command,
+          args: [],
+          buildArgs: (ctx) => {
+            const args = ["-p", "", "--output-format", "stream-json"];
+            const resumeId = ctx.config.runtimeSessionId?.trim() || ctx.config.providerSessionId?.trim();
+            const approvalMode = ctx.config.mode === "plan" || ctx.config.mode === "ask" || ctx.config.mode === "review" ? "plan" : "yolo";
+            args.push("--approval-mode", approvalMode);
+            if (resumeId) args.push("--resume", resumeId);
+            if (ctx.config.selectedModel?.trim()) args.push("--model", ctx.config.selectedModel.trim());
+            return [...args, ...defaultArgs];
+          },
+          promptViaStdin: true,
+          augmentPrompt: (ctx) => buildPromptWithImagePathReferences(ctx, imageFiles),
+          parseStructuredLine: parseGeminiStructuredLine
+        }).run(context);
+      } finally {
+        cleanup();
       }
     }
-  }
-  matches.sort((a, b) => b.mtimeMs - a.mtimeMs);
-  return matches[0]?.path ?? null;
-}
-async function replayCodexMcpToolEventsFromSessionLog(context, state) {
-  const runtimeSessionId = state.runtimeSessionId;
-  if (!runtimeSessionId) return;
-  const codexHome = context.env.CODEX_HOME || process.env.CODEX_HOME || (0, import_path.join)((0, import_os.homedir)(), ".codex");
-  const logPath = findCodexSessionLog(runtimeSessionId, codexHome);
-  if (!logPath) return;
-  const emittedToolIds = /* @__PURE__ */ new Set();
-  const lines = (0, import_fs.readFileSync)(logPath, "utf8").split(/\r?\n/).filter(Boolean);
-  for (const line of lines) {
-    const entry = parseJsonObject(line);
-    const payload = entry && typeof entry.payload === "object" && entry.payload !== null ? entry.payload : null;
-    if (!payload) continue;
-    if (payload.type === "function_call") {
-      const callId = typeof payload.call_id === "string" ? payload.call_id : "";
-      const name = typeof payload.name === "string" ? payload.name : "";
-      const namespace = typeof payload.namespace === "string" ? payload.namespace : "";
-      if (!callId || !name || !namespace.startsWith("mcp__")) continue;
-      const toolName = `${namespace}${name}`;
-      context.presenter.onToolUse(toolName, parseMaybeJson(payload.arguments), callId);
-      emittedToolIds.add(callId);
-      continue;
-    }
-    if (payload.type === "tool_search_call") {
-      const callId = typeof payload.call_id === "string" ? payload.call_id : "";
-      if (!callId) continue;
-      context.presenter.onToolUse("tool_search", payload.arguments ?? {}, callId);
-      emittedToolIds.add(callId);
-    }
-  }
-  if (emittedToolIds.size === 0) return;
-  for (const line of lines) {
-    const entry = parseJsonObject(line);
-    const payload = entry && typeof entry.payload === "object" && entry.payload !== null ? entry.payload : null;
-    if (!payload || payload.type !== "function_call_output" && payload.type !== "tool_search_output") continue;
-    const callId = typeof payload.call_id === "string" ? payload.call_id : "";
-    if (!emittedToolIds.has(callId)) continue;
-    try {
-      const result = payload.type === "tool_search_output" ? JSON.stringify(payload.tools ?? [], null, 2) : normalizeCodexMcpToolResult(payload.output);
-      context.presenter.onToolResult?.(callId, result);
-    } catch {
-      context.presenter.onToolResult?.(callId, String(payload.output ?? ""));
-    }
-  }
+  };
 }
 function extractCursorToolEntry(toolCall) {
   const [rawName, rawPayload] = Object.entries(toolCall)[0] ?? [];
@@ -6106,107 +6419,10 @@ function parseCursorStructuredLine(line, context, state) {
         state.error = resultText.trim() || "Cursor Agent run failed";
         void presenter.onError(state.error);
       }
-      break;
-    }
-    default:
-      break;
-  }
-}
-function buildGeminiToolResultText(parsed) {
-  const output = typeof parsed.output === "string" ? parsed.output : "";
-  if (output.trim().length > 0) return output;
-  const error = typeof parsed.error === "object" && parsed.error !== null ? parsed.error : null;
-  const message = typeof error?.message === "string" ? error.message.trim() : "";
-  const errorType = typeof error?.type === "string" ? error.type.trim() : "";
-  if (message && errorType) return `${errorType}: ${message}`;
-  if (message) return message;
-  const status = typeof parsed.status === "string" ? parsed.status.trim() : "";
-  return status || "Tool completed";
-}
-function parseGeminiStructuredLine(line, context, state) {
-  const presenter = context.presenter;
-  let parsed = null;
-  try {
-    parsed = JSON.parse(line);
-  } catch {
-    void presenter.onLog(`[gemini_cli] ${line}`);
-    return;
-  }
-  const type = typeof parsed.type === "string" ? parsed.type : "";
-  if (!type) return;
-  if (typeof parsed.session_id === "string") state.runtimeSessionId = parsed.session_id;
-  if (typeof parsed.model === "string") state.activeModel = parsed.model;
-  switch (type) {
-    case "init": {
-      const model = state.activeModel || context.config.selectedModel || "gemini";
-      void presenter.onLog(`[gemini_cli] Session initialized with ${model}`);
-      break;
-    }
-    case "message": {
-      if (typeof parsed.role !== "string" || parsed.role !== "assistant") break;
-      const content = typeof parsed.content === "string" ? parsed.content : "";
-      if (!content) break;
-      state.iterations = Math.max(state.iterations, 1);
-      state.summary += content;
-      void presenter.onAssistantText(content);
-      break;
-    }
-    case "tool_use": {
-      const toolName = typeof parsed.tool_name === "string" ? parsed.tool_name : "Gemini Tool";
-      const toolId = typeof parsed.tool_id === "string" ? parsed.tool_id : `gemini-tool-${Date.now()}`;
-      state.iterations = Math.max(state.iterations, 1);
-      void presenter.onToolUse(toolName, parsed.parameters ?? {}, toolId);
-      break;
-    }
-    case "tool_result": {
-      const toolId = typeof parsed.tool_id === "string" ? parsed.tool_id : `gemini-tool-${Date.now()}`;
-      state.iterations = Math.max(state.iterations, 1);
-      void presenter.onToolResult?.(toolId, buildGeminiToolResultText(parsed));
-      break;
-    }
-    case "error": {
-      const errObj = typeof parsed.error === "object" && parsed.error !== null ? parsed.error : null;
-      const message = typeof parsed.message === "string" && parsed.message.trim() || errObj && typeof errObj.message === "string" && errObj.message.trim() || typeof parsed.error === "string" && parsed.error.trim() || typeof parsed.error_message === "string" && parsed.error_message.trim() || "";
-      const severity = typeof parsed.severity === "string" ? parsed.severity : "error";
-      if (message) {
-        if (severity === "error") {
-          void presenter.onError(message);
-          state.error = message;
-        } else {
-          void presenter.onLog(`[gemini_cli/${severity}] ${message}`);
-        }
-      }
-      break;
-    }
-    case "result": {
-      const stats = typeof parsed.stats === "object" && parsed.stats !== null ? parsed.stats : {};
-      state.iterations = Math.max(state.iterations, 1);
-      state.usage = {
-        model: state.activeModel || (typeof context.config.selectedModel === "string" && context.config.selectedModel.trim() ? context.config.selectedModel : "gemini"),
-        numTurns: Math.max(state.iterations, 1),
-        durationMs: typeof stats.duration_ms === "number" ? stats.duration_ms : 0,
-        inputTokens: typeof stats.input_tokens === "number" ? stats.input_tokens : typeof stats.input === "number" ? stats.input : 0,
-        outputTokens: typeof stats.output_tokens === "number" ? stats.output_tokens : 0,
-        cacheReadTokens: typeof stats.cached === "number" ? stats.cached : 0,
-        cacheCreationTokens: 0,
-        costUsd: 0
-      };
-      void presenter.onUsageUpdate?.({
-        model: state.usage.model,
-        inputTokens: state.usage.inputTokens,
-        outputTokens: state.usage.outputTokens,
-        cacheReadTokens: state.usage.cacheReadTokens,
-        cacheCreationTokens: state.usage.cacheCreationTokens
-      });
-      if (typeof parsed.status === "string" && parsed.status !== "success" && !state.error) {
-        const errObj = typeof parsed.error === "object" && parsed.error !== null ? parsed.error : null;
-        const errMsg = typeof parsed.error === "string" && parsed.error.trim() || errObj && typeof errObj.message === "string" && errObj.message.trim() || typeof parsed.error_message === "string" && parsed.error_message.trim() || typeof parsed.message === "string" && parsed.message.trim() || typeof parsed.result === "string" && parsed.result.trim() || parsed.status;
-        state.error = errMsg;
-        console.error("[gemini_cli] result status=", parsed.status, "error:", JSON.stringify({
-          error: parsed.error,
-          error_message: parsed.error_message,
-          message: parsed.message
-        }));
+      state.resultReceived = true;
+      state.onResultReceived?.();
+      if (state.stdin && !state.stdin.destroyed) {
+        state.stdin.end();
       }
       break;
     }
@@ -6214,29 +6430,8 @@ function parseGeminiStructuredLine(line, context, state) {
       break;
   }
 }
-function shouldUseReadOnlyRuntimePermissions(config) {
-  if (isReadOnlyAgent(config.agentId)) return true;
-  switch (config.mode) {
-    case "plan":
-    case "ask":
-    case "review":
-      return true;
-    default:
-      return false;
-  }
-}
-function getClaudePermissionMode(config) {
-  switch (config.mode) {
-    case "plan":
-    case "ask":
-    case "review":
-      return "plan";
-    default:
-      return "bypassPermissions";
-  }
-}
-function getClaudeDisallowedTools(config) {
-  return isReadOnlyAgent(config.agentId) ? ["Edit", "Write", "MultiEdit", "NotebookEdit"] : [];
+function isCursorAgentCliModelId(model) {
+  return model === "auto" || /^composer-/.test(model) || /^gpt-\d/.test(model) || /^claude-\d/.test(model) || /^gemini-\d/.test(model) || /^grok-\d/.test(model) || /^kimi-/.test(model);
 }
 function shouldForceCursorAgent(config) {
   if (shouldUseReadOnlyRuntimePermissions(config)) return false;
@@ -6249,272 +6444,48 @@ function shouldForceCursorAgent(config) {
       return true;
   }
 }
-function writeImagesToTempFiles(images) {
-  if (!images?.length) return { paths: [], cleanup: () => {
-  } };
-  const paths = [];
-  for (const img of images) {
-    const ext = img.mimeType.split("/")[1]?.replace("jpeg", "jpg") ?? "png";
-    const filePath = (0, import_path.join)((0, import_os.tmpdir)(), `aiden-img-${img.id}.${ext}`);
-    (0, import_fs.writeFileSync)(filePath, Buffer.from(img.data, "base64"));
-    paths.push(filePath);
-  }
-  return {
-    paths,
-    cleanup: () => {
-      for (const p of paths) {
-        try {
-          (0, import_fs.rmSync)(p, { force: true });
-        } catch {
-        }
-      }
-    }
-  };
-}
-function buildClaudeModelArg(baseModel, selectedContextWindow) {
-  if (selectedContextWindow === "1m") return `${baseModel}[1m]`;
-  return baseModel;
-}
-function createClaudeCliBackend(command = "claude", defaultArgs = []) {
+function createCursorAgentCliBackend(command = "cursor-agent", defaultArgs = []) {
   return {
-    kind: "claude_cli",
+    kind: "cursor_agent_cli",
     supportTier: "structured",
     async run(context) {
-      const args = [
-        "--verbose",
-        "--output-format",
-        "stream-json",
-        "--input-format",
-        "stream-json",
-        "--permission-mode",
-        getClaudePermissionMode(context.config)
-      ];
-      const disallowedTools = getClaudeDisallowedTools(context.config);
-      if (disallowedTools.length > 0) {
-        args.push("--disallowedTools", disallowedTools.join(","));
-      }
-      const resumeId = context.config.runtimeSessionId?.trim() || context.config.providerSessionId?.trim();
-      if (!resumeId) {
-        if (context.config.systemPrompt?.trim()) {
-          args.push("--system-prompt", context.config.systemPrompt.trim());
-        }
-        if (context.config.systemPromptAppend?.trim()) {
-          args.push("--append-system-prompt", context.config.systemPromptAppend.trim());
-        }
-      }
-      const baseModel = context.config.selectedModel?.trim();
-      if (baseModel) {
-        args.push("--model", buildClaudeModelArg(baseModel, context.config.selectedContextWindow));
-      }
-      const claudeEffort = context.config.selectedEffortLevel?.trim();
-      if (claudeEffort) {
-        args.push("--effort", claudeEffort);
-      }
-      if (resumeId) {
-        args.push("--resume", resumeId);
-        console.info("[claude_cli] Resuming session", { resumeId });
-      }
-      args.push("--chrome");
-      console.info("[claude_cli] Chrome flag added \u2014 final args:", args.join(" "));
-      args.push(...defaultArgs);
-      return createGenericCliBackend({
-        kind: "claude_cli",
-        supportTier: "structured",
-        command,
-        args,
-        parseStructuredLine: parseClaudeStructuredLine,
-        stdinWriter: (stdin, ctx) => {
-          const contentBlocks = [];
-          if (ctx.config.images?.length) {
-            for (const img of ctx.config.images) {
-              contentBlocks.push({
-                type: "image",
-                source: { type: "base64", media_type: img.mimeType, data: img.data }
-              });
+      const { files: imageFiles, cleanup } = writeImagesToTempFiles(context.config.images, context.cwd);
+      try {
+        return await createGenericCliBackend({
+          kind: "cursor_agent_cli",
+          supportTier: "structured",
+          command,
+          args: [],
+          buildArgs: (ctx, prompt) => {
+            const args = [
+              "--print",
+              "--output-format",
+              "stream-json",
+              "--trust",
+              "--workspace",
+              ctx.cwd
+            ];
+            const resumeId = ctx.config.runtimeSessionId?.trim() || ctx.config.providerSessionId?.trim();
+            if (shouldForceCursorAgent(ctx.config)) args.push("--force");
+            if (ctx.config.mode === "plan" || ctx.config.mode === "review") {
+              args.push("--mode", "plan");
+            } else if (ctx.config.mode === "ask") {
+              args.push("--mode", "ask");
             }
-          }
-          const promptText = ctx.config.mode === "plan" ? buildPlanModePrefix(buildPromptWithSystem(ctx.config, ctx.promptText)) : buildPromptWithSystem(ctx.config, ctx.promptText);
-          if (promptText.trim()) {
-            contentBlocks.push({ type: "text", text: promptText });
-          }
-          console.info(`[claude_cli] stdinWriter: ${contentBlocks.length} content blocks (${ctx.config.images?.length ?? 0} images)`);
-          const message = JSON.stringify({
-            type: "user",
-            message: { role: "user", content: contentBlocks },
-            session_id: "default",
-            parent_tool_use_id: null
-          });
-          stdin.write(message + "\n");
-        },
-        keepStdinOpen: true,
-        allowContinuation: true,
-        continuationIdleMs: 10 * 60 * 1e3
-        // 10 minutes
-      }).run(context);
-    }
-  };
-}
-function kimiSessionId(cwd) {
-  let resolved = cwd;
-  try {
-    resolved = (0, import_fs.realpathSync)(cwd);
-  } catch {
-  }
-  return (0, import_crypto.createHash)("md5").update(resolved).digest("hex");
-}
-function shouldEnableKimiCliThinking(model) {
-  return model?.trim() === "kimi-k2.6-thinking";
-}
-function resolveKimiCliModelArg(model) {
-  const trimmed = model?.trim();
-  if (!trimmed) return void 0;
-  if (trimmed === "kimi-latest" || trimmed === "kimi-k2.5" || trimmed === "kimi-k2.6" || shouldEnableKimiCliThinking(trimmed)) {
-    return void 0;
-  }
-  if (trimmed.startsWith("claude-")) return void 0;
-  return trimmed;
-}
-function parseKimiStructuredLine(line, context, state) {
-  const presenter = context.presenter;
-  if (!state.runtimeSessionId) {
-    state.runtimeSessionId = kimiSessionId(context.cwd);
-  }
-  let parsed;
-  try {
-    parsed = JSON.parse(line);
-  } catch {
-    const text = line.trim();
-    if (text.length > 0) {
-      if (text.toLowerCase().includes("llm not set")) state.error = text;
-      void presenter.onLog(`[kimi_cli] ${line}`);
-    }
-    return;
-  }
-  const role = typeof parsed.role === "string" ? parsed.role : "";
-  const contentBlocks = Array.isArray(parsed.content) ? parsed.content : [];
-  const toolCalls = Array.isArray(parsed.tool_calls) ? parsed.tool_calls : [];
-  if (role === "assistant") {
-    const thinking = contentBlocks.filter((b) => b.type === "think" && typeof b.think === "string").map((b) => b.think).join("");
-    if (thinking) {
-      state.iterations = Math.max(state.iterations, 1);
-      void presenter.onThinking(thinking);
-    }
-    if (toolCalls.length > 0) {
-      state.iterations = Math.max(state.iterations, 1);
-      for (const tc of toolCalls) {
-        const fn = typeof tc.function === "object" && tc.function !== null ? tc.function : {};
-        const toolId = typeof tc.id === "string" ? tc.id : `kimi-tool-${Date.now()}`;
-        const toolName = typeof fn.name === "string" ? fn.name : "Tool";
-        let args = {};
-        if (typeof fn.arguments === "string") {
-          try {
-            args = JSON.parse(fn.arguments);
-          } catch {
-          }
-        } else if (typeof fn.arguments === "object" && fn.arguments !== null) {
-          args = fn.arguments;
-        }
-        void presenter.onToolUse(toolName, args, toolId);
-      }
-    } else {
-      const text = contentBlocks.filter((b) => b.type === "text" && typeof b.text === "string").map((b) => b.text).join("");
-      if (text) {
-        state.iterations = Math.max(state.iterations, 1);
-        state.summary += text;
-        void presenter.onAssistantText(text);
-      }
-    }
-    return;
-  }
-  if (role === "tool") {
-    const toolCallId = typeof parsed.tool_call_id === "string" ? parsed.tool_call_id : `kimi-tool-${Date.now()}`;
-    const allText = contentBlocks.filter((b) => b.type === "text" && typeof b.text === "string").map((b) => b.text);
-    const userText = allText.filter((t) => !t.startsWith("<system>")).join("\n");
-    void presenter.onToolResult?.(toolCallId, userText || allText.join("\n"));
-    return;
-  }
-}
-function createKimiCliBackend(command = "kimi", defaultArgs = []) {
-  return createGenericCliBackend({
-    kind: "kimi_cli",
-    supportTier: "structured",
-    command,
-    args: [],
-    buildArgs: (context, prompt) => {
-      const args = [
-        "--print",
-        "--output-format",
-        "stream-json",
-        "--work-dir",
-        context.cwd
-      ];
-      const resumeId = context.config.runtimeSessionId?.trim() || context.config.providerSessionId?.trim();
-      if (resumeId) args.push("--session", resumeId);
-      if (shouldEnableKimiCliThinking(context.config.selectedModel)) {
-        args.push("--thinking");
-      }
-      const model = resolveKimiCliModelArg(context.config.selectedModel);
-      if (model) args.push("--model", model);
-      return [...args, ...defaultArgs, "--prompt", prompt];
-    },
-    augmentPrompt: (context) => {
-      const base = buildPromptWithSystem(context.config, context.promptText);
-      return context.config.mode === "plan" ? buildPlanModePrefix(base) : base;
-    },
-    parseStructuredLine: parseKimiStructuredLine
-  });
-}
-function createGeminiCliBackend(command = "gemini", defaultArgs = []) {
-  return createGenericCliBackend({
-    kind: "gemini_cli",
-    supportTier: "structured",
-    command,
-    args: [],
-    buildArgs: (context) => {
-      const args = ["-p", "", "--output-format", "stream-json"];
-      const resumeId = context.config.runtimeSessionId?.trim() || context.config.providerSessionId?.trim();
-      const approvalMode = context.config.mode === "plan" || context.config.mode === "ask" || context.config.mode === "review" ? "plan" : "yolo";
-      args.push("--approval-mode", approvalMode);
-      if (resumeId) args.push("--resume", resumeId);
-      if (context.config.selectedModel?.trim()) args.push("--model", context.config.selectedModel.trim());
-      return [...args, ...defaultArgs];
-    },
-    promptViaStdin: true,
-    augmentPrompt: (context) => {
-      const basePrompt = buildPromptWithSystem(context.config, context.promptText);
-      return context.config.mode === "plan" ? buildPlanModePrefix(basePrompt) : basePrompt;
-    },
-    parseStructuredLine: parseGeminiStructuredLine
-  });
-}
-function isCursorAgentCliModelId(model) {
-  return model === "auto" || /^composer-/.test(model) || /^gpt-\d/.test(model) || /^claude-\d/.test(model) || /^gemini-\d/.test(model) || /^grok-\d/.test(model) || /^kimi-/.test(model);
-}
-function createCursorAgentCliBackend(command = "cursor-agent", defaultArgs = []) {
-  return createGenericCliBackend({
-    kind: "cursor_agent_cli",
-    supportTier: "structured",
-    command,
-    args: [],
-    buildArgs: (context, prompt) => {
-      const args = ["--print", "--output-format", "stream-json"];
-      const resumeId = context.config.runtimeSessionId?.trim() || context.config.providerSessionId?.trim();
-      if (shouldForceCursorAgent(context.config)) args.push("--force");
-      if (resumeId) args.push("--resume", resumeId);
-      const model = context.config.selectedModel?.trim();
-      if (model && isCursorAgentCliModelId(model)) args.push("--model", model);
-      return [...args, ...defaultArgs, prompt];
-    },
-    augmentPrompt: (context) => {
-      const base = buildPromptWithSystem(context.config, context.promptText);
-      return context.config.mode === "plan" ? buildPlanModePrefix(base) : base;
-    },
-    parseStructuredLine: parseCursorStructuredLine
-  });
-}
-function droidExecPermissionArgs(mode) {
-  if (mode === "plan" || mode === "ask" || mode === "review") return [];
-  return ["--auto", "high"];
+            if (resumeId) args.push("--resume", resumeId);
+            const model = ctx.config.selectedModel?.trim();
+            if (model && isCursorAgentCliModelId(model)) args.push("--model", model);
+            return [...args, ...defaultArgs, prompt];
+          },
+          keepStdinOpen: true,
+          augmentPrompt: (ctx) => buildPromptWithImagePathReferences(ctx, imageFiles),
+          parseStructuredLine: parseCursorStructuredLine
+        }).run(context);
+      } finally {
+        cleanup();
+      }
+    }
+  };
 }
 function parseDroidStructuredLine(line, context, state) {
   const presenter = context.presenter;
@@ -6596,33 +6567,45 @@ function parseDroidStructuredLine(line, context, state) {
       break;
   }
 }
+function droidExecPermissionArgs(mode) {
+  if (mode === "plan" || mode === "ask" || mode === "review") return [];
+  return ["--auto", "high"];
+}
 function createDroidCliBackend(command = "droid", defaultArgs = []) {
-  return createGenericCliBackend({
+  return {
     kind: "droid_cli",
     supportTier: "structured",
-    command,
-    args: [],
-    buildArgs: (context, prompt) => {
-      const args = [
-        "exec",
-        "--output-format",
-        "stream-json",
-        ...droidExecPermissionArgs(context.config.mode),
-        ...defaultArgs
-      ];
-      const resumeId = context.config.runtimeSessionId?.trim() || context.config.providerSessionId?.trim();
-      if (resumeId) args.push("--session-id", resumeId);
-      const model = context.config.selectedModel?.trim();
-      if (model) args.push("-m", model);
-      args.push(prompt);
-      return args;
-    },
-    augmentPrompt: (context) => {
-      const base = buildPromptWithSystem(context.config, context.promptText);
-      return context.config.mode === "plan" ? buildPlanModePrefix(base) : base;
-    },
-    parseStructuredLine: parseDroidStructuredLine
-  });
+    async run(context) {
+      const { files: imageFiles, cleanup } = writeImagesToTempFiles(context.config.images, context.cwd);
+      try {
+        return await createGenericCliBackend({
+          kind: "droid_cli",
+          supportTier: "structured",
+          command,
+          args: [],
+          buildArgs: (ctx, prompt) => {
+            const args = [
+              "exec",
+              "--output-format",
+              "stream-json",
+              ...droidExecPermissionArgs(ctx.config.mode),
+              ...defaultArgs
+            ];
+            const resumeId = ctx.config.runtimeSessionId?.trim() || ctx.config.providerSessionId?.trim();
+            if (resumeId) args.push("--session-id", resumeId);
+            const model = ctx.config.selectedModel?.trim();
+            if (model) args.push("-m", model);
+            args.push(prompt);
+            return args;
+          },
+          augmentPrompt: (ctx) => buildPromptWithImagePathReferences(ctx, imageFiles),
+          parseStructuredLine: parseDroidStructuredLine
+        }).run(context);
+      } finally {
+        cleanup();
+      }
+    }
+  };
 }
 function parseOpencodeStructuredLine(line, context, state) {
   const presenter = context.presenter;
@@ -6719,51 +6702,247 @@ function parseOpencodeStructuredLine(line, context, state) {
       break;
   }
 }
-function createOpencodeCliBackend(command = "opencode", defaultArgs = []) {
-  return {
-    kind: "opencode_cli",
-    supportTier: "structured",
-    async run(context) {
-      const { paths: imagePaths, cleanup } = writeImagesToTempFiles(context.config.images);
-      try {
-        return await createGenericCliBackend({
-          kind: "opencode_cli",
-          supportTier: "structured",
-          command,
-          args: [],
-          buildArgs: (ctx, prompt) => {
-            const args = ["run", "--format", "json"];
-            const resumeId = ctx.config.runtimeSessionId?.trim() || ctx.config.providerSessionId?.trim();
-            if (resumeId) args.push("--session", resumeId);
-            const model = ctx.config.selectedModel?.trim();
-            if (model && model.includes("/")) args.push("--model", model);
-            const fileArgs = imagePaths.flatMap((p) => ["--file", p]);
-            if (fileArgs.length > 0) {
-              return [...args, ...fileArgs, ...defaultArgs, "--", prompt];
-            }
-            return [...args, ...defaultArgs, prompt];
-          },
-          augmentPrompt: (ctx) => {
-            const base = buildPromptWithSystem(ctx.config, ctx.promptText);
-            return ctx.config.mode === "plan" ? buildPlanModePrefix(base) : base;
-          },
-          parseStructuredLine: parseOpencodeStructuredLine
-        }).run(context);
-      } finally {
-        cleanup();
-      }
-    }
-  };
-}
-function createGenericCliPassthroughBackend(command, defaultArgs = []) {
-  return createGenericCliBackend({
-    kind: "generic_cli",
-    supportTier: "text",
-    command,
-    args: defaultArgs,
-    promptViaStdin: true
-  });
-}
+function createOpencodeCliBackend(command = "opencode", defaultArgs = []) {
+  return {
+    kind: "opencode_cli",
+    supportTier: "structured",
+    async run(context) {
+      const { paths: imagePaths, cleanup } = writeImagesToTempFiles(context.config.images, context.cwd);
+      try {
+        return await createGenericCliBackend({
+          kind: "opencode_cli",
+          supportTier: "structured",
+          command,
+          args: [],
+          buildArgs: (ctx, prompt) => {
+            const args = ["run", "--format", "json"];
+            const resumeId = ctx.config.runtimeSessionId?.trim() || ctx.config.providerSessionId?.trim();
+            if (resumeId) args.push("--session", resumeId);
+            const model = ctx.config.selectedModel?.trim();
+            if (model && model.includes("/")) args.push("--model", model);
+            const fileArgs = imagePaths.flatMap((p) => ["--file", p]);
+            if (fileArgs.length > 0) {
+              return [...args, ...fileArgs, ...defaultArgs, "--", prompt];
+            }
+            return [...args, ...defaultArgs, prompt];
+          },
+          augmentPrompt: (ctx) => {
+            const base = buildPromptWithSystem(ctx.config, ctx.promptText);
+            return ctx.config.mode === "plan" ? buildPlanModePrefix(base) : base;
+          },
+          parseStructuredLine: parseOpencodeStructuredLine
+        }).run(context);
+      } finally {
+        cleanup();
+      }
+    }
+  };
+}
+function createGenericCliPassthroughBackend(command, defaultArgs = []) {
+  return {
+    kind: "generic_cli",
+    supportTier: "text",
+    async run(context) {
+      const { files: imageFiles, cleanup } = writeImagesToTempFiles(context.config.images, context.cwd);
+      try {
+        return await createGenericCliBackend({
+          kind: "generic_cli",
+          supportTier: "text",
+          command,
+          args: defaultArgs,
+          promptViaStdin: true,
+          augmentPrompt: (ctx) => buildPromptWithImagePathReferences(ctx, imageFiles)
+        }).run(context);
+      } finally {
+        cleanup();
+      }
+    }
+  };
+}
+function parseCodexStructuredLine(line, context, state) {
+  const presenter = context.presenter;
+  let parsed = null;
+  try {
+    parsed = JSON.parse(line);
+  } catch {
+    void presenter.onLog(`[codex] ${line}`);
+    return;
+  }
+  const type = typeof parsed.type === "string" ? parsed.type : "";
+  if (!type) return;
+  if (typeof parsed.thread_id === "string") {
+    state.runtimeSessionId = parsed.thread_id;
+  }
+  const extractCodexErrorMessage = (value2) => {
+    if (typeof value2 !== "string") return "";
+    const trimmed = value2.trim();
+    if (!trimmed) return "";
+    try {
+      const parsedValue = JSON.parse(trimmed);
+      if (typeof parsedValue.detail === "string" && parsedValue.detail.trim().length > 0) {
+        return parsedValue.detail.trim();
+      }
+      if (typeof parsedValue.message === "string" && parsedValue.message.trim().length > 0) {
+        return parsedValue.message.trim();
+      }
+    } catch {
+    }
+    return trimmed;
+  };
+  switch (type) {
+    case "thread.started":
+      break;
+    case "turn.started":
+      state.iterations += 1;
+      break;
+    case "session_configured":
+      if (typeof parsed.session_id === "string") {
+        state.runtimeSessionId = parsed.session_id;
+      }
+      break;
+    case "task_started":
+      state.iterations += 1;
+      break;
+    case "item.started": {
+      const item = typeof parsed.item === "object" && parsed.item !== null ? parsed.item : null;
+      if (!item || item.type !== "command_execution" || typeof item.id !== "string") break;
+      const command = typeof item.command === "string" ? item.command : "";
+      void presenter.onToolUse("Bash", { command, cwd: context.cwd }, item.id);
+      break;
+    }
+    case "item.completed": {
+      const item = typeof parsed.item === "object" && parsed.item !== null ? parsed.item : null;
+      if (!item || typeof item.type !== "string") break;
+      if (item.type === "reasoning" && typeof item.text === "string") {
+        void presenter.onThinking(item.text);
+        break;
+      }
+      if (item.type === "agent_message" && typeof item.text === "string") {
+        state.summary += `${item.text}
+`;
+        void presenter.onAssistantText(item.text);
+        break;
+      }
+      if (item.type === "command_execution" && typeof item.id === "string") {
+        const output = typeof item.aggregated_output === "string" ? item.aggregated_output : "";
+        const itemExitCode = typeof item.exit_code === "number" ? item.exit_code : null;
+        const resultText = output.trim().length > 0 ? output : itemExitCode === null ? "" : `Exit code: ${itemExitCode}`;
+        void presenter.onToolResult?.(item.id, resultText);
+        break;
+      }
+      break;
+    }
+    case "agent_message_delta":
+    case "agent_message_content_delta": {
+      const delta = typeof parsed.delta === "string" ? parsed.delta : "";
+      if (!delta) return;
+      state.summary += delta;
+      void presenter.onAssistantText(delta);
+      break;
+    }
+    case "agent_reasoning_delta":
+    case "reasoning_content_delta":
+    case "agent_reasoning_raw_content_delta": {
+      const delta = typeof parsed.delta === "string" ? parsed.delta : "";
+      if (!delta) return;
+      void presenter.onThinking(delta);
+      break;
+    }
+    case "exec_command_begin": {
+      const toolId = typeof parsed.call_id === "string" ? parsed.call_id : `exec-${Date.now()}`;
+      const command = Array.isArray(parsed.command) ? parsed.command.join(" ") : "";
+      const cwd = typeof parsed.cwd === "string" ? parsed.cwd : context.cwd;
+      void presenter.onToolUse("Bash", { command, cwd }, toolId);
+      break;
+    }
+    case "exec_command_end": {
+      const toolId = typeof parsed.call_id === "string" ? parsed.call_id : `exec-${Date.now()}`;
+      const output = typeof parsed.formatted_output === "string" ? parsed.formatted_output : typeof parsed.aggregated_output === "string" ? parsed.aggregated_output : "";
+      void presenter.onToolResult?.(toolId, output);
+      break;
+    }
+    case "mcp_tool_call_begin": {
+      const toolId = typeof parsed.call_id === "string" ? parsed.call_id : `mcp-${Date.now()}`;
+      const invocation = typeof parsed.invocation === "object" && parsed.invocation !== null ? parsed.invocation : {};
+      const tool = typeof invocation.tool_name === "string" ? invocation.tool_name : typeof invocation.tool === "string" ? invocation.tool : "MCP Tool";
+      void presenter.onToolUse(tool, invocation, toolId);
+      break;
+    }
+    case "mcp_tool_call_end": {
+      const toolId = typeof parsed.call_id === "string" ? parsed.call_id : `mcp-${Date.now()}`;
+      void presenter.onToolResult?.(toolId, JSON.stringify(parsed.result ?? {}, null, 2));
+      break;
+    }
+    case "token_count": {
+      const info = typeof parsed.info === "object" && parsed.info !== null ? parsed.info : {};
+      state.usage = {
+        model: typeof info.model === "string" ? info.model : "codex",
+        numTurns: Math.max(state.iterations, 1),
+        durationMs: 0,
+        inputTokens: typeof info.input_tokens === "number" ? info.input_tokens : 0,
+        outputTokens: typeof info.output_tokens === "number" ? info.output_tokens : 0,
+        cacheReadTokens: typeof info.cached_input_tokens === "number" ? info.cached_input_tokens : 0,
+        cacheCreationTokens: 0,
+        costUsd: typeof info.total_cost_usd === "number" ? info.total_cost_usd : 0
+      };
+      void presenter.onUsageUpdate?.({
+        model: state.usage.model,
+        inputTokens: state.usage.inputTokens,
+        outputTokens: state.usage.outputTokens,
+        cacheReadTokens: state.usage.cacheReadTokens,
+        cacheCreationTokens: state.usage.cacheCreationTokens
+      });
+      break;
+    }
+    case "task_complete": {
+      const lastMessage = typeof parsed.last_agent_message === "string" ? parsed.last_agent_message : "";
+      if (lastMessage.length > 0) state.summary = lastMessage;
+      break;
+    }
+    case "turn.completed": {
+      const usage = typeof parsed.usage === "object" && parsed.usage !== null ? parsed.usage : {};
+      state.usage = {
+        model: typeof context.config.selectedModel === "string" && context.config.selectedModel.trim() ? context.config.selectedModel : "codex",
+        numTurns: Math.max(state.iterations, 1),
+        durationMs: 0,
+        inputTokens: typeof usage.input_tokens === "number" ? usage.input_tokens : 0,
+        outputTokens: typeof usage.output_tokens === "number" ? usage.output_tokens : 0,
+        cacheReadTokens: typeof usage.cached_input_tokens === "number" ? usage.cached_input_tokens : 0,
+        cacheCreationTokens: 0,
+        costUsd: 0
+      };
+      void presenter.onUsageUpdate?.({
+        model: state.usage.model,
+        inputTokens: state.usage.inputTokens,
+        outputTokens: state.usage.outputTokens,
+        cacheReadTokens: state.usage.cacheReadTokens,
+        cacheCreationTokens: state.usage.cacheCreationTokens
+      });
+      break;
+    }
+    case "error": {
+      const message = extractCodexErrorMessage(parsed.message) || extractCodexErrorMessage(parsed.error) || typeof parsed.detail === "string" && parsed.detail.trim() || "";
+      if (message) {
+        const normalizedMessage = normalizeCodexCliErrorMessage(message);
+        void presenter.onError(normalizedMessage);
+        state.error = normalizedMessage;
+      }
+      break;
+    }
+    case "turn.failed": {
+      const error = typeof parsed.error === "object" && parsed.error !== null ? parsed.error : {};
+      const message = extractCodexErrorMessage(error.message) || extractCodexErrorMessage(error.detail) || typeof parsed.message === "string" && parsed.message.trim() || "";
+      if (message) {
+        const normalizedMessage = normalizeCodexCliErrorMessage(message);
+        void presenter.onError(normalizedMessage);
+        state.error = normalizedMessage;
+      }
+      break;
+    }
+    default:
+      break;
+  }
+}
 function buildCodexEffortArgs(selectedEffortLevel) {
   const level = selectedEffortLevel?.trim();
   if (!level) return [];
@@ -6774,7 +6953,7 @@ function createCodexRuntimeBackend(command = "codex", defaultArgs = []) {
     kind: "codex_app_server",
     supportTier: "structured",
     async run(context) {
-      const { paths: imagePaths, cleanup } = writeImagesToTempFiles(context.config.images);
+      const { paths: imagePaths, cleanup } = writeImagesToTempFiles(context.config.images, context.cwd);
       try {
         return await createGenericCliBackend({
           kind: "codex_app_server",
@@ -6785,7 +6964,7 @@ function createCodexRuntimeBackend(command = "codex", defaultArgs = []) {
             const resumeId = ctx.config.runtimeSessionId?.trim() || ctx.config.providerSessionId?.trim();
             const modelArgs = ctx.config.selectedModel?.trim() ? ["--model", ctx.config.selectedModel.trim()] : [];
             const effortArgs = buildCodexEffortArgs(ctx.config.selectedEffortLevel);
-            const permissionArgs = shouldUseReadOnlyRuntimePermissions(ctx.config) ? ["--ask-for-approval", "never", "--sandbox", "read-only"] : ["--dangerously-bypass-approvals-and-sandbox"];
+            const permissionArgs = ["--dangerously-bypass-approvals-and-sandbox"];
             const imageArgs = imagePaths.flatMap((p) => ["--image", p]);
             const baseArgs = resumeId ? [...permissionArgs, "exec", "resume", "--json", "--skip-git-repo-check", ...modelArgs, ...effortArgs, ...imageArgs, resumeId, "-"] : [...permissionArgs, "exec", "--json", "--skip-git-repo-check", ...modelArgs, ...effortArgs, ...imageArgs, "-"];
             return [...baseArgs, ...defaultArgs];
@@ -6881,51 +7060,67 @@ function parseCopilotStructuredLine(line, context, state) {
   }
 }
 function createCopilotCliBackend(command = "copilot", defaultArgs = []) {
-  return createGenericCliBackend({
+  return {
     kind: "copilot_cli",
     supportTier: "structured",
-    command,
-    args: [],
-    buildArgs: (context, prompt) => {
-      const args = [
-        "--autopilot",
-        "--yolo",
-        "--max-autopilot-continues",
-        "20",
-        "-s",
-        "--stream",
-        "on",
-        "--output-format",
-        "json",
-        "-p",
-        prompt
-      ];
-      if (context.config.selectedModel?.trim()) {
-        args.push("--model", context.config.selectedModel.trim());
+    async run(context) {
+      const { files: imageFiles, cleanup } = writeImagesToTempFiles(context.config.images, context.cwd);
+      try {
+        return await createGenericCliBackend({
+          kind: "copilot_cli",
+          supportTier: "structured",
+          command,
+          args: [],
+          buildArgs: (ctx, prompt) => {
+            const args = [
+              "--autopilot",
+              "--yolo",
+              "--max-autopilot-continues",
+              "20",
+              "-s",
+              "--stream",
+              "on",
+              "--output-format",
+              "json",
+              "-p",
+              prompt
+            ];
+            if (ctx.config.selectedModel?.trim()) {
+              args.push("--model", ctx.config.selectedModel.trim());
+            }
+            return [...args, ...defaultArgs];
+          },
+          augmentPrompt: (ctx) => buildPromptWithImagePathReferences(ctx, imageFiles),
+          parseStructuredLine: parseCopilotStructuredLine
+        }).run(context);
+      } finally {
+        cleanup();
       }
-      return [...args, ...defaultArgs];
-    },
-    parseStructuredLine: parseCopilotStructuredLine
-  });
+    }
+  };
 }
 var DEFAULT_MODEL = "claude-sonnet-4-6";
 var DROID_DEFAULT_MODEL = "claude-opus-4-7";
 function defaultSelectedModelForBackend(backendKind) {
   switch (backendKind) {
+    case "claude_cli":
+      return void 0;
     case "droid_cli":
       return DROID_DEFAULT_MODEL;
     case "copilot_cli":
       return "claude-sonnet-4.5";
     case "kimi_cli":
       return void 0;
+    case "supatest_cli":
+      return "medium";
     default:
       return DEFAULT_MODEL;
   }
 }
 function canonicalizePath(inputPath) {
   try {
-    const resolved = (0, import_path2.resolve)(inputPath);
-    return (0, import_fs2.existsSync)(resolved) ? (0, import_fs2.realpathSync)(resolved) : resolved;
+    const resolved = (0, import_path3.resolve)(inputPath);
+    return (0, import_fs4.existsSync)(resolved) ? (0, import_fs4.realpathSync)(resolved) : resolved;
   } catch {
     return null;
   }
@@ -6938,6 +7133,28 @@ function buildPromptWithFiles(task, files) {
 The user has attached the following files. You can read them using your available tools:
 ${fileList}`;
 }
+function buildTaskLifecyclePrompt(config) {
+  if (config.mode === "plan" || config.mode === "ask" || config.mode === "review") {
+    return void 0;
+  }
+  const taskId = config.taskId ?? config.taskMeta?.id;
+  if (!taskId) return void 0;
+  const statusLines = config.taskMeta?.statusOptions?.length ? [
+    "",
+    "Available task statuses for this task, in board order:",
+    ...config.taskMeta.statusOptions.map(
+      (status) => `- ${status.id}: ${status.label} (${status.group})`
+    )
+  ] : [];
+  return [
+    "## Task Lifecycle",
+    `This session is attached to taskId "${taskId}".`,
+    `Do not change the task status on your own. The user manages this task's status. Only change it by calling the Aiden MCP update_task tool when the user explicitly asks you to (for example: "move this to review" or "mark it done"). Do not update the status proactively as you move through research, implementation, testing, or review phases.`,
+    ...statusLines,
+    "",
+    "When the user asks you to change the status, use exact status IDs from the available statuses. Do not invent status IDs. If none of the available statuses clearly matches the request, ask which one they mean instead of guessing."
+  ].join("\n");
+}
 var BaseMachineAgent = class _BaseMachineAgent {
   static MAX_RETRIES = 2;
   static RETRY_BASE_DELAY_MS = 3e3;
@@ -7018,6 +7235,8 @@ var BaseMachineAgent = class _BaseMachineAgent {
       case "gemini_cli":
       case "opencode_cli":
       case "copilot_cli":
+      case "supatest_cli":
+      case "kimi_cli":
         return "structured";
       case "generic_cli":
       default:
@@ -7042,6 +7261,8 @@ var BaseMachineAgent = class _BaseMachineAgent {
 Prefer relative paths and keep your work scoped to this project.`
       );
     }
+    const lifecyclePrompt = buildTaskLifecyclePrompt(config);
+    if (lifecyclePrompt) systemPromptParts.push(lifecyclePrompt);
     const extra = this.buildExtraSystemPromptParts(config);
     systemPromptParts.push(...extra);
     return {
@@ -7056,9 +7277,9 @@ Prefer relative paths and keep your work scoped to this project.`
   }
   async runCliBackend(config, safeProjectPath) {
     const backendKind = this.resolveBackendKind(config);
-    const defaultCwd = (0, import_path2.join)((0, import_os2.homedir)(), "Documents", "aiden");
-    if (!(0, import_fs2.existsSync)(defaultCwd)) {
-      (0, import_fs2.mkdirSync)(defaultCwd, { recursive: true });
+    const defaultCwd = (0, import_path3.join)((0, import_os3.homedir)(), "Documents", "aiden");
+    if (!(0, import_fs4.existsSync)(defaultCwd)) {
+      (0, import_fs4.mkdirSync)(defaultCwd, { recursive: true });
     }
     let runtimeConfig = this.buildRuntimeConfig(config, safeProjectPath);
     const cwd = runtimeConfig.worktreePath || safeProjectPath || runtimeConfig.cwd || defaultCwd;
@@ -7066,7 +7287,7 @@ Prefer relative paths and keep your work scoped to this project.`
     const promptText = this.buildPromptText(runtimeConfig);
     const runtimeCommand = runtimeConfig.runtimeCommand || this.runtime.runtimeCommand;
     const runtimeArgs = runtimeConfig.runtimeArgs || this.runtime.runtimeArgs || [];
-    const backend = backendKind === "claude_cli" ? createClaudeCliBackend(runtimeCommand || "claude", runtimeArgs) : backendKind === "codex_app_server" ? createCodexRuntimeBackend(runtimeCommand || "codex", runtimeArgs) : backendKind === "copilot_cli" ? createCopilotCliBackend(runtimeCommand || "copilot", runtimeArgs) : backendKind === "cursor_agent_cli" ? createCursorAgentCliBackend(runtimeCommand || "cursor-agent", runtimeArgs) : backendKind === "gemini_cli" ? createGeminiCliBackend(runtimeCommand || "gemini", runtimeArgs) : backendKind === "droid_cli" ? createDroidCliBackend(runtimeCommand || "droid", runtimeArgs) : backendKind === "opencode_cli" ? createOpencodeCliBackend(runtimeCommand || "opencode", runtimeArgs) : backendKind === "kimi_cli" ? createKimiCliBackend(runtimeCommand || "kimi", runtimeArgs) : createGenericCliPassthroughBackend(runtimeCommand || "generic-cli", runtimeArgs);
+    const backend = backendKind === "claude_cli" ? createClaudeCliBackend(runtimeCommand || "claude", runtimeArgs) : backendKind === "codex_app_server" ? createCodexRuntimeBackend(runtimeCommand || "codex", runtimeArgs) : backendKind === "copilot_cli" ? createCopilotCliBackend(runtimeCommand || "copilot", runtimeArgs) : backendKind === "cursor_agent_cli" ? createCursorAgentCliBackend(runtimeCommand || "cursor-agent", runtimeArgs) : backendKind === "gemini_cli" ? createGeminiCliBackend(runtimeCommand || "gemini", runtimeArgs) : backendKind === "droid_cli" ? createDroidCliBackend(runtimeCommand || "droid", runtimeArgs) : backendKind === "opencode_cli" ? createOpencodeCliBackend(runtimeCommand || "opencode", runtimeArgs) : backendKind === "kimi_cli" ? createKimiCliBackend(runtimeCommand || "kimi", runtimeArgs) : backendKind === "supatest_cli" ? createSupatestCliBackend(runtimeCommand || "supatest", runtimeArgs) : createGenericCliPassthroughBackend(runtimeCommand || "generic-cli", runtimeArgs);
     let lastResult = null;
     for (let attempt = 0; attempt <= _BaseMachineAgent.MAX_RETRIES; attempt++) {
       if (this.abortController?.signal.aborted) break;
@@ -7162,7 +7383,7 @@ Prefer relative paths and keep your work scoped to this project.`
       const canonicalized = canonicalizePath(initialConfig.teamPath);
       if (canonicalized) safeProjectPath = canonicalized;
     }
-    if (safeProjectPath && !(0, import_fs2.existsSync)(safeProjectPath)) {
+    if (safeProjectPath && !(0, import_fs4.existsSync)(safeProjectPath)) {
       const message = `Local path no longer exists: "${safeProjectPath}". Please update the team's local path in team settings before running the agent.`;
       this.presenter.onError(message, true);
       const result = {
@@ -7207,8 +7428,9 @@ Prefer relative paths and keep your work scoped to this project.`
 var import_node_os2 = require("os");
 
 // src/cli-executable.ts
-var import_node_fs = require("fs");
 var import_node_child_process = require("child_process");
+var import_node_fs = require("fs");
+var import_node_child_process2 = require("child_process");
 var import_node_os = require("os");
 var import_node_path = require("path");
 var PROVIDER_CLI_COMMANDS = {
@@ -7219,7 +7441,8 @@ var PROVIDER_CLI_COMMANDS = {
   gemini_cli: { provider: "gemini_cli", command: "gemini", envVar: "AIDEN_GEMINI_PATH" },
   kimi_cli: { provider: "kimi_cli", command: "kimi", envVar: "AIDEN_KIMI_PATH" },
   opencode_cli: { provider: "opencode_cli", command: "opencode", envVar: "AIDEN_OPENCODE_PATH" },
-  droid_cli: { provider: "droid_cli", command: "droid", envVar: "AIDEN_DROID_PATH" }
+  droid_cli: { provider: "droid_cli", command: "droid", envVar: "AIDEN_DROID_PATH" },
+  supatest_cli: { provider: "supatest_cli", command: "supatest", envVar: "AIDEN_SUPATEST_PATH" }
 };
 var DISCOVERABLE_PROVIDER_KINDS = Object.keys(PROVIDER_CLI_COMMANDS);
 var PROVIDER_ALIASES = {
@@ -7236,11 +7459,50 @@ var BACKEND_CLI_COMMANDS = {
   gemini: "gemini",
   kimi_cli: "kimi",
   opencode_cli: "opencode",
-  droid_cli: "droid"
+  droid_cli: "droid",
+  supatest_cli: "supatest"
+};
+var CLI_COMMAND_ALIASES = {
+  kimi: ["kimi-cli"]
 };
 var resolvedCliCache = /* @__PURE__ */ new Map();
+var cachedLoginShellEnv = null;
+function parseEnvOutput(output) {
+  const loginEnv = {};
+  for (const line of output.split("\n")) {
+    if (!line.trim()) continue;
+    const eqIdx = line.indexOf("=");
+    if (eqIdx <= 0) continue;
+    const key = line.slice(0, eqIdx);
+    if (/\s/.test(key)) continue;
+    loginEnv[key] = line.slice(eqIdx + 1);
+  }
+  if (!loginEnv.HOME) loginEnv.HOME = process.env.HOME ?? (0, import_node_os.homedir)();
+  if (!loginEnv.SHELL) loginEnv.SHELL = process.env.SHELL ?? "/bin/zsh";
+  return loginEnv;
+}
+function loadLoginShellEnvironment() {
+  if (cachedLoginShellEnv) return cachedLoginShellEnv;
+  if ((0, import_node_os.platform)() === "win32") {
+    cachedLoginShellEnv = process.env;
+    return cachedLoginShellEnv;
+  }
+  try {
+    const shell = (process.env.SHELL || "/bin/bash").replace(/'/g, "'\\''");
+    const envOutput = (0, import_node_child_process.execSync)(`'${shell}' -ilc 'env'`, {
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "pipe"],
+      timeout: 5e3
+    });
+    cachedLoginShellEnv = parseEnvOutput(envOutput);
+  } catch {
+    cachedLoginShellEnv = process.env;
+  }
+  return cachedLoginShellEnv;
+}
 function getDaemonCliEnvironment() {
-  return augmentCliPath(process.env);
+  const base = (0, import_node_os.platform)() === "win32" ? process.env : loadLoginShellEnvironment();
+  return augmentCliPath(base);
 }
 function cacheResolvedCli(command, resolvedPath) {
   resolvedCliCache.set(command, resolvedPath);
@@ -7252,7 +7514,7 @@ function resolveViaWhere(command, env) {
   if ((0, import_node_os.platform)() !== "win32") return null;
   const whereExe = (0, import_node_path.join)(env.SystemRoot ?? process.env.SystemRoot ?? "C:\\Windows", "System32", "where.exe");
   if (!(0, import_node_fs.existsSync)(whereExe)) return null;
-  const result = (0, import_node_child_process.spawnSync)(whereExe, [command], {
+  const result = (0, import_node_child_process2.spawnSync)(whereExe, [command], {
     encoding: "utf8",
     env,
     windowsHide: true,
@@ -7266,26 +7528,6 @@ function resolveViaWhere(command, env) {
   }
   return null;
 }
-function runCliVersionProbe(executable, env, args = ["--version"]) {
-  const isWin = (0, import_node_os.platform)() === "win32";
-  if (isWin && /\.(cmd|bat)$/i.test(executable)) {
-    const comSpec = env.ComSpec ?? process.env.ComSpec ?? "cmd.exe";
-    return (0, import_node_child_process.spawnSync)(comSpec, ["/d", "/s", "/c", executable, ...args], {
-      encoding: "utf8",
-      timeout: 3e3,
-      env,
-      windowsHide: true
-    });
-  }
-  const useShell = isWin && !/[\\/]/.test(executable);
-  return (0, import_node_child_process.spawnSync)(executable, args, {
-    encoding: "utf8",
-    timeout: 3e3,
-    env,
-    shell: useShell,
-    windowsHide: isWin ? true : void 0
-  });
-}
 function pathSeparator() {
   return (0, import_node_os.platform)() === "win32" ? ";" : ":";
 }
@@ -7350,7 +7592,8 @@ function resolveCliExecutable(command, env = getDaemonCliEnvironment()) {
   const home = enriched.HOME || enriched.USERPROFILE || (0, import_node_os.homedir)();
   const isWin = (0, import_node_os.platform)() === "win32";
   const pathExt = enriched.PATHEXT ?? (isWin ? ".EXE;.CMD;.BAT;.COM" : "");
-  const names = isWin ? windowsCommandCandidates(trimmed, pathExt) : [trimmed];
+  const commandNames = [trimmed, ...CLI_COMMAND_ALIASES[trimmed] ?? []];
+  const names = commandNames.flatMap((name) => isWin ? windowsCommandCandidates(name, pathExt) : [name]);
   const candidates = [];
   for (const name of names) {
     if (name.includes("/") || name.includes("\\")) {
@@ -7425,10 +7668,12 @@ function resolveBackendRuntimeCommand(backendKind, env = getDaemonCliEnvironment
 var CoreAgent = class _CoreAgent extends BaseMachineAgent {
   childProcess = null;
   _aborted = false;
+  providerApiKey;
   /** How long to wait after SIGTERM before escalating to SIGKILL. */
   static SIGKILL_DELAY_MS = 3e3;
   constructor(presenter, runtime) {
     super(presenter, runtime);
+    this.providerApiKey = runtime.providerApiKey;
   }
   abort() {
     this._aborted = true;
@@ -7553,6 +7798,9 @@ var CoreAgent = class _CoreAgent extends BaseMachineAgent {
       if (value2 !== void 0) env[key] = value2;
     }
     const augmented = getDaemonCliEnvironment();
+    if (this.runtime.backendKind === "supatest_cli" && this.providerApiKey) {
+      augmented.SUPATEST_API_KEY = this.providerApiKey;
+    }
     if ((0, import_node_os2.platform)() !== "win32") {
       const home = augmented.HOME ?? "/home/user";
       const extraPaths = [`${home}/.local/node/bin`, `${home}/.local/bin`];
@@ -11387,7 +11635,7 @@ var WSClient = class {
 };
 
 // src/version.ts
-var AGENT_VERSION = "0.1.14";
+var AGENT_VERSION = "0.1.16";
 
 // src/sandbox.ts
 async function runSandbox(config) {
@@ -11403,6 +11651,8 @@ async function runSandbox(config) {
   let currentConversationId = config.sessionId;
   let currentTeamId = config.teamId;
   let currentUser = config.currentUser;
+  let currentTerminalContextRefs;
+  let currentTerminalSnapshots;
   console.info("[sandbox] Connecting to WS server", { wsUrl: config.wsUrl, sessionId: config.sessionId });
   const wsClient = new WSClient(
     config.wsUrl,
@@ -11484,6 +11734,8 @@ async function runSandbox(config) {
           teamId: currentTeamId,
           currentUser,
           workflowTools: currentWorkflowTools,
+          terminalContextRefs: currentTerminalContextRefs,
+          terminalSnapshots: currentTerminalSnapshots,
           images: currentImages.length > 0 ? currentImages.map((img) => ({
             id: img.id,
             data: img.data,
@@ -11524,8 +11776,8 @@ async function runSandbox(config) {
     if (nextPayload.agentPrompt !== void 0) {
       activeAgentPrompt = nextPayload.agentPrompt;
     }
-    if (nextPayload.selectedModel) {
-      activeModel = nextPayload.selectedModel;
+    if (nextPayload.selectedModel !== void 0) {
+      activeModel = nextPayload.selectedModel.trim() || void 0;
     }
     if (nextPayload.selectedContextWindow !== void 0) {
       activeContextWindow = nextPayload.selectedContextWindow;
@@ -11557,49 +11809,349 @@ async function runSandbox(config) {
     if (nextPayload.teamId !== void 0) {
       currentTeamId = nextPayload.teamId;
     }
+    if (nextPayload.terminalContextRefs !== void 0) {
+      currentTerminalContextRefs = nextPayload.terminalContextRefs;
+    }
+    if (nextPayload.terminalSnapshots !== void 0) {
+      currentTerminalSnapshots = nextPayload.terminalSnapshots;
+    }
   }
   presenter.setSuppressSessionLifecycle(false);
   wsClient.close();
 }
 
 // src/daemon.ts
-var import_node_fs2 = require("fs");
+var import_node_fs3 = require("fs");
 var import_node_http = __toESM(require("http"), 1);
 var import_node_crypto = require("crypto");
+var import_node_os4 = require("os");
+var import_node_path3 = require("path");
+
+// ../shared/dist/node/provider-limits.js
+var import_node_child_process3 = require("child_process");
+var import_node_fs2 = require("fs");
 var import_node_os3 = require("os");
 var import_node_path2 = require("path");
+var CACHE_TTL_MS = 6e4;
+var cachedLimits = null;
+function numericValue(value2) {
+  if (typeof value2 === "number" && Number.isFinite(value2))
+    return value2;
+  if (typeof value2 === "string" && value2.trim() && Number.isFinite(Number(value2))) {
+    return Number(value2);
+  }
+  return null;
+}
+function splitPath2(value2) {
+  return (value2 ?? "").split(import_node_path2.delimiter).filter(Boolean);
+}
+function isExecutableFile(path) {
+  try {
+    (0, import_node_fs2.accessSync)(path, import_node_fs2.constants.X_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function augmentCliPath2(env) {
+  const home = env.HOME || (0, import_node_os3.homedir)();
+  const extraPaths = [
+    (0, import_node_path2.join)(home, ".local", "bin"),
+    (0, import_node_path2.join)(home, ".local", "node", "bin"),
+    (0, import_node_path2.join)(home, ".bun", "bin"),
+    (0, import_node_path2.join)(home, ".cargo", "bin"),
+    "/opt/homebrew/bin",
+    "/usr/local/bin"
+  ];
+  const existing = new Set(splitPath2(env.PATH));
+  const missing = extraPaths.filter((path) => !existing.has(path));
+  if (missing.length === 0)
+    return env;
+  return {
+    ...env,
+    PATH: `${missing.join(import_node_path2.delimiter)}${import_node_path2.delimiter}${env.PATH ?? ""}`
+  };
+}
+function resolveExecutable(command, env, overrideEnvVar) {
+  const override = env[overrideEnvVar]?.trim();
+  if (override && isExecutableFile(override))
+    return override;
+  for (const dir of splitPath2(env.PATH)) {
+    const candidate = (0, import_node_path2.join)(dir, command);
+    if (isExecutableFile(candidate))
+      return candidate;
+  }
+  return null;
+}
+function limitLabel(windowMinutes, fallback) {
+  if (windowMinutes === 5 * 60)
+    return "5h";
+  if (windowMinutes === 7 * 24 * 60)
+    return "Weekly";
+  return fallback;
+}
+function windowFromUsedPercent(params) {
+  const usedPercent = Math.max(0, Math.min(100, params.usedPercent));
+  return {
+    label: limitLabel(params.windowMinutes, params.fallbackLabel),
+    remaining: Math.max(0, 100 - usedPercent),
+    limit: 100,
+    usedPercent,
+    ...params.windowMinutes !== null ? { windowMinutes: params.windowMinutes } : {},
+    ...params.resetAt ? { resetAt: params.resetAt } : {},
+    source: params.source
+  };
+}
+function codexWindow(raw, fallbackLabel) {
+  if (!raw)
+    return null;
+  const usedPercent = numericValue(raw.usedPercent);
+  if (usedPercent === null)
+    return null;
+  const windowMinutes = numericValue(raw.windowDurationMins);
+  const resetSeconds = numericValue(raw.resetsAt);
+  const resetAt = resetSeconds !== null ? new Date(resetSeconds * 1e3).toISOString() : null;
+  return windowFromUsedPercent({
+    usedPercent,
+    windowMinutes,
+    resetAt,
+    fallbackLabel,
+    source: "codex-cli-rpc"
+  });
+}
+function claudeWindow(raw, label, windowMinutes) {
+  if (!raw)
+    return null;
+  const usedPercent = numericValue(raw.utilization);
+  if (usedPercent === null)
+    return null;
+  const resetAt = typeof raw.resets_at === "string" && raw.resets_at.trim() ? raw.resets_at.trim() : null;
+  return windowFromUsedPercent({
+    usedPercent,
+    windowMinutes,
+    resetAt,
+    fallbackLabel: label,
+    source: "claude-oauth"
+  });
+}
+async function withTimeout(promise, timeoutMs, fallback) {
+  let timer;
+  try {
+    return await Promise.race([
+      promise,
+      new Promise((resolve2) => {
+        timer = setTimeout(() => resolve2(fallback), timeoutMs);
+      })
+    ]);
+  } finally {
+    if (timer)
+      clearTimeout(timer);
+  }
+}
+async function collectCodexLimits(env) {
+  const runtimeEnv = augmentCliPath2(env);
+  const codexCommand = resolveExecutable("codex", runtimeEnv, "AIDEN_CODEX_PATH");
+  if (!codexCommand)
+    return [];
+  return withTimeout(new Promise((resolve2) => {
+    const child = (0, import_node_child_process3.spawn)(codexCommand, ["-s", "read-only", "-a", "untrusted", "app-server"], {
+      env: runtimeEnv,
+      stdio: ["pipe", "pipe", "ignore"]
+    });
+    let nextId = 1;
+    let buffer = "";
+    const pending = /* @__PURE__ */ new Map();
+    const finish = (windows = []) => {
+      pending.clear();
+      if (!child.killed)
+        child.kill();
+      resolve2(windows);
+    };
+    const request = (method, params = {}) => {
+      const id = nextId++;
+      child.stdin.write(`${JSON.stringify({ id, method, params })}
+`);
+      return new Promise((requestResolve) => {
+        pending.set(id, requestResolve);
+      });
+    };
+    child.on("error", () => finish());
+    child.on("exit", () => finish());
+    child.stdout.on("data", (chunk) => {
+      buffer += chunk.toString("utf8");
+      const lines = buffer.split("\n");
+      buffer = lines.pop() ?? "";
+      for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed)
+          continue;
+        let message;
+        try {
+          message = JSON.parse(trimmed);
+        } catch {
+          continue;
+        }
+        const id = numericValue(message.id);
+        if (id === null)
+          continue;
+        const resolver = pending.get(id);
+        if (!resolver)
+          continue;
+        pending.delete(id);
+        resolver(message.error ? null : message.result);
+      }
+    });
+    void (async () => {
+      try {
+        await request("initialize", {
+          clientInfo: { name: "aiden", version: "runtime" }
+        });
+        child.stdin.write(`${JSON.stringify({ method: "initialized", params: {} })}
+`);
+        const result = await request("account/rateLimits/read");
+        const windows = [
+          codexWindow(result?.rateLimits?.primary, "Primary"),
+          codexWindow(result?.rateLimits?.secondary, "Weekly")
+        ].filter((window2) => Boolean(window2));
+        finish(windows);
+      } catch {
+        finish();
+      }
+    })();
+  }), 4e3, []);
+}
+function readClaudeCredentialsPayload() {
+  const path = (0, import_node_path2.join)((0, import_node_os3.homedir)(), ".claude", ".credentials.json");
+  if ((0, import_node_fs2.existsSync)(path)) {
+    try {
+      return JSON.parse((0, import_node_fs2.readFileSync)(path, "utf8"));
+    } catch {
+      return null;
+    }
+  }
+  if (process.platform !== "darwin")
+    return null;
+  try {
+    const raw = (0, import_node_child_process3.execFileSync)("security", ["find-generic-password", "-s", "Claude Code-credentials", "-w"], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+    if (!raw)
+      return null;
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+function readClaudeAccessToken() {
+  const parsed = readClaudeCredentialsPayload();
+  if (!parsed)
+    return null;
+  try {
+    const oauth = parsed.claudeAiOauth;
+    if (!oauth || typeof oauth.accessToken !== "string" || !oauth.accessToken.trim())
+      return null;
+    const expiresAt = numericValue(oauth.expiresAt);
+    if (expiresAt !== null && Date.now() >= expiresAt)
+      return null;
+    return oauth.accessToken.trim();
+  } catch {
+    return null;
+  }
+}
+async function collectClaudeLimits() {
+  const token = readClaudeAccessToken();
+  if (!token)
+    return [];
+  return withTimeout((async () => {
+    const response = await fetch("https://api.anthropic.com/api/oauth/usage", {
+      headers: {
+        accept: "application/json",
+        authorization: `Bearer ${token}`,
+        "anthropic-beta": "oauth-2025-04-20",
+        "user-agent": "claude-code/2.1.0"
+      }
+    });
+    if (!response.ok)
+      return [];
+    const body = await response.json();
+    return [
+      claudeWindow(body.five_hour, "5h", 5 * 60),
+      claudeWindow(body.seven_day, "Weekly", 7 * 24 * 60)
+    ].filter((window2) => Boolean(window2));
+  })().catch(() => []), 4e3, []);
+}
+async function collectLocalAgentProviderLimits(env = process.env) {
+  if (cachedLimits && Object.keys(cachedLimits.value).length > 0 && Date.now() - cachedLimits.collectedAt < CACHE_TTL_MS) {
+    return cachedLimits.value;
+  }
+  const [codex, claude] = await Promise.all([
+    collectCodexLimits(env),
+    collectClaudeLimits()
+  ]);
+  const limits = {};
+  if (codex.length > 0)
+    limits.codex_app_server = codex;
+  if (claude.length > 0)
+    limits.claude_cli = claude;
+  if (Object.keys(limits).length > 0) {
+    cachedLimits = { value: limits, collectedAt: Date.now() };
+  } else {
+    cachedLimits = null;
+  }
+  return limits;
+}
+
+// src/daemon.ts
 var PRODUCTION_API_URL = "https://api.aiden-platform.com";
 var PRODUCTION_WS_URL = "wss://ws.aiden-platform.com";
 var LOCAL_API_URL = "http://localhost:8400";
 var LOCAL_WS_URL = "ws://localhost:8401";
+async function probeLocalDaemonEndpoint(port, token, timeoutMs = 750) {
+  try {
+    const headers = {};
+    if (token) headers.authorization = `Bearer ${token}`;
+    const response = await fetch(`http://127.0.0.1:${port}/status`, {
+      headers,
+      signal: AbortSignal.timeout(timeoutMs)
+    });
+    if (response.status === 401) return { state: "listening_unauthorized" };
+    if (!response.ok) return { state: "absent" };
+    const body = await response.json();
+    if (!body.runtimeId) return { state: "absent" };
+    return { state: "running", status: body };
+  } catch {
+    return { state: "absent" };
+  }
+}
+function describeOccupiedLocalDaemon(port) {
+  return `local daemon API port ${port} is already in use. If Aiden desktop is open, it manages the daemon automatically. Quit Aiden desktop or stop the existing daemon before starting another.`;
+}
 function getConfigPath() {
-  return process.env.AIDEN_AGENT_CONFIG_PATH ?? (0, import_node_path2.join)((0, import_node_os3.homedir)(), ".aiden", "agent", "config.json");
+  return process.env.AIDEN_AGENT_CONFIG_PATH ?? (0, import_node_path3.join)((0, import_node_os4.homedir)(), ".aiden", "agent", "config.json");
 }
 function getEndpointDefaultsPath() {
-  return process.env.AIDEN_AGENT_ENDPOINTS_PATH ?? (0, import_node_path2.join)((0, import_node_path2.dirname)(getConfigPath()), "endpoints.json");
+  return process.env.AIDEN_AGENT_ENDPOINTS_PATH ?? (0, import_node_path3.join)((0, import_node_path3.dirname)(getConfigPath()), "endpoints.json");
 }
 function readConfig() {
   const configPath = getConfigPath();
-  if (!(0, import_node_fs2.existsSync)(configPath)) return {};
-  return JSON.parse((0, import_node_fs2.readFileSync)(configPath, "utf8"));
+  if (!(0, import_node_fs3.existsSync)(configPath)) return {};
+  return JSON.parse((0, import_node_fs3.readFileSync)(configPath, "utf8"));
 }
 function readEndpointDefaults() {
   const endpointsPath = getEndpointDefaultsPath();
-  if (!(0, import_node_fs2.existsSync)(endpointsPath)) return {};
+  if (!(0, import_node_fs3.existsSync)(endpointsPath)) return {};
   try {
-    return JSON.parse((0, import_node_fs2.readFileSync)(endpointsPath, "utf8"));
+    return JSON.parse((0, import_node_fs3.readFileSync)(endpointsPath, "utf8"));
   } catch {
     return {};
   }
 }
 function writeConfig(config) {
   const configPath = getConfigPath();
-  (0, import_node_fs2.mkdirSync)((0, import_node_path2.dirname)(configPath), { recursive: true, mode: 448 });
-  (0, import_node_fs2.writeFileSync)(configPath, JSON.stringify(config, null, 2), { mode: 384 });
+  (0, import_node_fs3.mkdirSync)((0, import_node_path3.dirname)(configPath), { recursive: true, mode: 448 });
+  (0, import_node_fs3.writeFileSync)(configPath, JSON.stringify(config, null, 2), { mode: 384 });
 }
 function removeConfig() {
   const configPath = getConfigPath();
-  if ((0, import_node_fs2.existsSync)(configPath)) (0, import_node_fs2.rmSync)(configPath, { force: true });
+  if ((0, import_node_fs3.existsSync)(configPath)) (0, import_node_fs3.rmSync)(configPath, { force: true });
 }
 function argValue(args, name) {
   const index = args.indexOf(name);
@@ -11629,50 +12181,81 @@ function isLocalEndpoint(url2) {
 function getLocalApiPort(args, stored) {
   const raw = argValue(args, "--local-api-port") ?? process.env.AIDEN_AGENT_LOCAL_API_PORT;
   if (raw) return Number.parseInt(raw, 10);
-  return stored.localApiPort ?? 47831;
+  const storedPort = stored.localApiPort;
+  if (storedPort && storedPort > 0) return storedPort;
+  return 47831;
 }
 function sleep(ms) {
   if (ms <= 0) return Promise.resolve();
   return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
-function commandVersion(command, args = ["--version"]) {
-  const env = getDaemonCliEnvironment();
-  const executable = resolveCliExecutable(command, env);
-  if (!executable) return void 0;
-  const result = runCliVersionProbe(executable, env, args);
-  if (result.error || result.status !== 0) return void 0;
-  return (result.stdout || result.stderr).split("\n")[0]?.trim() || void 0;
-}
-function commandVersionForProvider(provider) {
-  const env = getDaemonCliEnvironment();
-  const executable = resolveProviderCliCommand(provider, env);
-  if (!executable) return void 0;
-  const result = runCliVersionProbe(executable, env, ["--version"]);
-  if (result.error || result.status !== 0) return void 0;
-  return (result.stdout || result.stderr).split("\n")[0]?.trim() || void 0;
-}
 function normalizeBackendKind(backendKind) {
   if (backendKind === "codex") return "codex_app_server";
   return backendKind;
 }
 function discoverCapabilities() {
   const now = (/* @__PURE__ */ new Date()).toISOString();
+  const env = getDaemonCliEnvironment();
   return {
     agents: DISCOVERABLE_PROVIDER_KINDS.map((provider) => {
-      const version = commandVersionForProvider(provider);
+      const executable = resolveProviderCliCommand(provider, env);
       return {
         provider,
-        available: Boolean(version),
-        ...version ? { version } : {},
+        available: Boolean(executable),
         models: [],
         lastCheckedAt: now
       };
     }),
-    hasGit: Boolean(commandVersion("git")),
+    hasGit: Boolean(resolveCliExecutable("git", env)),
     hasTerminal: true,
     supportsFilesystem: true
   };
 }
+var USER_INTERRUPTED_RESULT = {
+  success: false,
+  summary: "Interrupted by user",
+  filesModified: [],
+  planFilesCreated: [],
+  iterations: 0,
+  error: "Interrupted by user"
+};
+function abortActiveAgent(entry) {
+  entry.presenter.onComplete(USER_INTERRUPTED_RESULT);
+  entry.agent.kill();
+}
+function collectRuntimeMetadata() {
+  const cpuList = (0, import_node_os4.cpus)();
+  const metadata = {
+    platform: (0, import_node_os4.platform)(),
+    arch: (0, import_node_os4.arch)(),
+    osVersion: (0, import_node_os4.release)(),
+    agentVersion: AGENT_VERSION,
+    memoryBytes: (0, import_node_os4.totalmem)(),
+    memoryFreeBytes: (0, import_node_os4.freemem)()
+  };
+  if (cpuList.length > 0) {
+    metadata.cpuModel = cpuList[0]?.model;
+    metadata.cpuCores = cpuList.length;
+  }
+  try {
+    const disk = (0, import_node_fs3.statfsSync)((0, import_node_os4.homedir)());
+    metadata.diskFreeBytes = disk.bavail * disk.bsize;
+    metadata.diskTotalBytes = disk.blocks * disk.bsize;
+  } catch {
+  }
+  return metadata;
+}
+async function collectRuntimeMetadataWithProviderLimits() {
+  const metadata = collectRuntimeMetadata();
+  try {
+    const agentProviderLimits = await collectLocalAgentProviderLimits(getDaemonCliEnvironment());
+    if (Object.keys(agentProviderLimits).length > 0) {
+      metadata.agentProviderLimits = agentProviderLimits;
+    }
+  } catch {
+  }
+  return metadata;
+}
 var RuntimePresenter = class {
   constructor(socket, conversationId, runId) {
     this.socket = socket;
@@ -11748,7 +12331,7 @@ async function setupDaemon(args) {
   const teamId = argValue(args, "--team") ?? process.env.AIDEN_TEAM_ID;
   const setupToken = argValue(args, "--setup-token") ?? process.env.AIDEN_RUNTIME_SETUP_TOKEN;
   const token = argValue(args, "--token") ?? process.env.AIDEN_SETUP_TOKEN;
-  const displayName = argValue(args, "--name") ?? (0, import_node_os3.hostname)();
+  const displayName = argValue(args, "--name") ?? (0, import_node_os4.hostname)();
   const legacyLocalMachineId = argValue(args, "--legacy-local-machine-id") ?? process.env.AIDEN_LEGACY_LOCAL_MACHINE_ID;
   const scope = argValue(args, "--scope") ?? process.env.AIDEN_RUNTIME_SCOPE ?? "team";
   if (scope !== "team" && scope !== "user") {
@@ -11769,7 +12352,7 @@ async function setupDaemon(args) {
       ...teamId ? { teamId } : {},
       ...setupToken ? { setupToken } : {},
       displayName,
-      hostname: (0, import_node_os3.hostname)(),
+      hostname: (0, import_node_os4.hostname)(),
       ...legacyLocalMachineId ? { legacyLocalMachineId } : {},
       runtimeKind: "machine",
       managementKind: "user_managed",
@@ -11778,11 +12361,7 @@ async function setupDaemon(args) {
       ownerType: scope,
       visibility: scope,
       capabilities: discoverCapabilities(),
-      metadata: {
-        platform: (0, import_node_os3.platform)(),
-        arch: (0, import_node_os3.arch)(),
-        agentVersion: AGENT_VERSION
-      }
+      metadata: await collectRuntimeMetadataWithProviderLimits()
     })
   });
   if (!response.ok) {
@@ -11804,20 +12383,16 @@ async function setupDaemon(args) {
 }
 async function loginWithDeviceCode(args) {
   const { apiUrl, wsUrl, endpointProfile } = resolveEndpoints(args);
-  const displayName = argValue(args, "--name") ?? (0, import_node_os3.hostname)();
+  const displayName = argValue(args, "--name") ?? (0, import_node_os4.hostname)();
   const maxPolls = Number.parseInt(argValue(args, "--max-polls") ?? "300", 10);
   const start = await fetch(`${apiUrl}/public/runtimes/device-authorizations`, {
     method: "POST",
     headers: { "content-type": "application/json" },
     body: JSON.stringify({
       displayName,
-      hostname: (0, import_node_os3.hostname)(),
+      hostname: (0, import_node_os4.hostname)(),
       capabilities: discoverCapabilities(),
-      metadata: {
-        platform: (0, import_node_os3.platform)(),
-        arch: (0, import_node_os3.arch)(),
-        agentVersion: AGENT_VERSION
-      }
+      metadata: await collectRuntimeMetadataWithProviderLimits()
     })
   });
   if (!start.ok) {
@@ -11865,8 +12440,9 @@ async function startDaemon(args) {
   if (!runtimeId || !runtimeToken || !wsUrl) {
     throw new Error("daemon requires runtimeId, runtime token, and wsUrl. Run setup first or pass --runtime-id/--token/--ws-url.");
   }
-  const capabilities = discoverCapabilities();
   const activeAgents = /* @__PURE__ */ new Map();
+  const currentCapabilities = () => discoverCapabilities();
+  const currentMetadata = () => collectRuntimeMetadataWithProviderLimits();
   const recentLogs = [];
   const pushLog = (message) => {
     recentLogs.push(`${(/* @__PURE__ */ new Date()).toISOString()} ${message}`);
@@ -11888,16 +12464,26 @@ async function startDaemon(args) {
     extraHeaders: { "ngrok-skip-browser-warning": "1" }
   });
   const heartbeat = setInterval(() => {
-    if (socket.connected) socket.emit("runtime.heartbeat", { capabilities });
+    if (!socket.connected) return;
+    void currentMetadata().then((metadata) => {
+      socket.emit("runtime.heartbeat", { capabilities: currentCapabilities(), metadata });
+    });
   }, 15e3);
   socket.on("connect", () => {
     pushLog(`connected runtime=${runtimeId}`);
     console.info("[aiden-agent] Daemon connected", { runtimeId, wsUrl, version: AGENT_VERSION });
-    socket.emit("runtime.hello", { capabilities });
+    void currentMetadata().then((metadata) => {
+      socket.emit("runtime.hello", { capabilities: currentCapabilities(), metadata });
+    });
   });
+  let lastConnectErrorLogAt = 0;
   socket.on("connect_error", (error) => {
     pushLog(`connect_error ${error.message}`);
-    console.warn("[aiden-agent] Daemon connection error:", error.message);
+    const now = Date.now();
+    if (now - lastConnectErrorLogAt < 5e3) return;
+    lastConnectErrorLogAt = now;
+    const wsHint = isLocalEndpoint(wsUrl) ? ` Nothing is listening at ${wsUrl}. For local dev run setup with --profile local and start the stack (WS on ws://localhost:8401).` : ` Verify wsUrl in ${getConfigPath()} and that you can reach ${wsUrl}.`;
+    console.warn("[aiden-agent] Daemon connection error:", `${error.message}.${wsHint}`);
   });
   socket.on("disconnect", (reason) => {
     pushLog(`disconnected ${reason}`);
@@ -11925,10 +12511,11 @@ async function startDaemon(args) {
     const presenter = new RuntimePresenter(socket, payload.conversationId, payload.runId);
     const agent = new CoreAgent(presenter, {
       backendKind,
-      runtimeCommand
+      runtimeCommand,
+      providerApiKey: payload.providerApiKey
     });
-    activeAgents.set(payload.runId, agent);
     const cwd = payload.projectPath ?? process.cwd();
+    activeAgents.set(payload.runId, { agent, presenter });
     void agent.run({
       task: payload.content,
       maxIterations: payload.maxIterations ?? 50,
@@ -11964,21 +12551,21 @@ async function startDaemon(args) {
   });
   socket.on("agent.abort", (payload) => {
     if (!payload?.runId) return;
-    const agent = activeAgents.get(payload.runId);
-    if (!agent) return;
-    agent.kill();
+    const entry = activeAgents.get(payload.runId);
+    if (!entry) return;
+    abortActiveAgent(entry);
     activeAgents.delete(payload.runId);
     pushLog(`aborted run=${payload.runId}`);
   });
   socket.on("agent.tool_response", (payload) => {
     if (!payload?.toolId || typeof payload.response !== "string") return;
-    const agents = payload.runId ? [activeAgents.get(payload.runId)] : [...activeAgents.values()];
+    const agents = payload.runId ? [activeAgents.get(payload.runId)?.agent] : [...activeAgents.values()].map((entry) => entry.agent);
     const delivered = agents.some((agent) => agent?.sendToolResponse(payload.toolId, payload.response) === true);
     if (!delivered) pushLog(`tool_response missed tool=${payload.toolId}`);
   });
   socket.on("agent.append_message", (payload) => {
     if (!payload?.runId || typeof payload.text !== "string") return;
-    const agent = activeAgents.get(payload.runId);
+    const agent = activeAgents.get(payload.runId)?.agent;
     const delivered = agent?.sendUserMessage(payload.text) === true;
     socket.emit(delivered ? "agent.accepted" : "agent.rejected", {
       runId: payload.runId,
@@ -12012,21 +12599,47 @@ async function startDaemon(args) {
       return;
     }
     if (req.method === "POST" && req.url === "/stop") {
-      for (const agent of activeAgents.values()) agent.kill();
+      for (const entry of activeAgents.values()) abortActiveAgent(entry);
       activeAgents.clear();
       res.writeHead(200, { "content-type": "application/json" }).end(JSON.stringify({ ok: true }));
       return;
     }
+    if (req.method === "POST" && req.url === "/shutdown") {
+      res.writeHead(200, { "content-type": "application/json" }).end(JSON.stringify({ ok: true }));
+      setImmediate(queueFullShutdown);
+      return;
+    }
     res.writeHead(404, { "content-type": "application/json" }).end(JSON.stringify({ error: "Not found" }));
   });
+  const occupiedProbe = await probeLocalDaemonEndpoint(localApiPort, localApiToken);
+  if (occupiedProbe.state === "running") {
+    clearInterval(heartbeat);
+    socket.disconnect();
+    throw new Error(
+      `${describeOccupiedLocalDaemon(localApiPort)} (runtime ${occupiedProbe.status.runtimeId})`
+    );
+  }
+  if (occupiedProbe.state === "listening_unauthorized") {
+    clearInterval(heartbeat);
+    socket.disconnect();
+    throw new Error(
+      `${describeOccupiedLocalDaemon(localApiPort)} The token in ${getConfigPath()} no longer matches the running daemon; quit Aiden desktop or run setup again.`
+    );
+  }
   await new Promise((resolve2, reject) => {
     const onError = (error) => {
       clearInterval(heartbeat);
       socket.disconnect();
       if (error.code === "EADDRINUSE") {
-        reject(new Error(
-          `local daemon API port ${localApiPort} is already in use. Another aiden-agent daemon may already be running; use \`aiden-agent status\` or stop the existing daemon before starting a new one.`
-        ));
+        void probeLocalDaemonEndpoint(localApiPort).then((probe) => {
+          if (probe.state !== "absent") {
+            reject(new Error(describeOccupiedLocalDaemon(localApiPort)));
+            return;
+          }
+          reject(new Error(
+            `local daemon API port ${localApiPort} is already in use by another process. Otherwise free the port or pass \`--local-api-port\` with a different value.`
+          ));
+        });
         return;
       }
       reject(error);
@@ -12046,8 +12659,8 @@ async function startDaemon(args) {
     if (stopped) return;
     stopped = true;
     clearInterval(heartbeat);
-    for (const agent of activeAgents.values()) {
-      agent.kill();
+    for (const entry of activeAgents.values()) {
+      abortActiveAgent(entry);
     }
     activeAgents.clear();
     socket.disconnect();
@@ -12055,13 +12668,74 @@ async function startDaemon(args) {
       localServer.close(() => resolve2());
     });
   };
-  return { runtimeId, wsUrl, localApiPort, localApiToken, stop };
+  const controller = {
+    runtimeId,
+    wsUrl,
+    localApiPort,
+    localApiToken,
+    stop
+  };
+  const queueFullShutdown = () => {
+    void stop().then(() => controller.whenExternallyStopped?.());
+  };
+  return controller;
+}
+async function stopDaemon(args) {
+  const stored = readConfig();
+  const localApiPort = getLocalApiPort(args, stored);
+  const localApiToken = stored.localApiToken;
+  if (!localApiToken) {
+    throw new Error("No local API token in config. Run setup or login first.");
+  }
+  const probe = await probeLocalDaemonEndpoint(localApiPort, localApiToken);
+  if (probe.state === "listening_unauthorized") {
+    throw new Error(
+      `Daemon is listening on port ${localApiPort} but rejected this config token. Quit Aiden desktop or rerun setup/login to refresh config.`
+    );
+  }
+  if (probe.state === "absent") {
+    console.info("[aiden-agent] No daemon listening", { port: localApiPort });
+    return;
+  }
+  const response = await fetch(`http://127.0.0.1:${localApiPort}/shutdown`, {
+    method: "POST",
+    headers: { authorization: `Bearer ${localApiToken}` },
+    signal: AbortSignal.timeout(5e3)
+  });
+  if (!response.ok) {
+    throw new Error(`Failed to stop daemon: HTTP ${response.status}`);
+  }
+  console.info("[aiden-agent] Daemon stopped", {
+    port: localApiPort,
+    runtimeId: probe.status.runtimeId
+  });
 }
 async function runDaemon(args) {
+  const stored = readConfig();
+  const localApiPort = getLocalApiPort(args, stored);
+  const localApiToken = stored.localApiToken;
+  const existingProbe = await probeLocalDaemonEndpoint(localApiPort, localApiToken);
+  if (existingProbe.state === "running") {
+    console.info("[aiden-agent] Daemon already running", {
+      port: localApiPort,
+      runtimeId: existingProbe.status.runtimeId,
+      connected: existingProbe.status.connected,
+      hint: "If Aiden desktop is open, it manages the daemon automatically."
+    });
+    return;
+  }
+  if (existingProbe.state === "listening_unauthorized") {
+    console.info("[aiden-agent] Daemon already running", {
+      port: localApiPort,
+      hint: "Aiden desktop is using a different local API token than config.json. Quit the desktop app or rerun setup if you need a fresh daemon."
+    });
+    return;
+  }
   const controller = await startDaemon(args);
   const shutdown = () => {
     void controller.stop().finally(() => process.exit(0));
   };
+  controller.whenExternallyStopped = shutdown;
   process.once("SIGINT", shutdown);
   process.once("SIGTERM", shutdown);
   await new Promise(() => {
@@ -12108,13 +12782,16 @@ function logoutDaemon() {
   removeConfig();
   console.info("[aiden-agent] Runtime config removed", { configPath: getConfigPath() });
 }
-function printStatus() {
+async function printStatus() {
   const config = readConfig();
   const configured = Boolean(config.runtimeId && config.runtimeToken && config.wsUrl);
   const warnings = [];
   if ((isLocalEndpoint(config.apiUrl) || isLocalEndpoint(config.wsUrl)) && config.endpointProfile !== "local") {
     warnings.push("Configured endpoint points at localhost. Use --profile local only for local development.");
   }
+  const localApiPort = config.localApiPort && config.localApiPort > 0 ? config.localApiPort : getLocalApiPort([], config);
+  const localDaemonProbe = config.localApiToken ? await probeLocalDaemonEndpoint(localApiPort, config.localApiToken) : { state: "absent" };
+  const localDaemonRunning = localDaemonProbe.state === "running";
   console.info(JSON.stringify({
     mode: "runtime",
     configured,
@@ -12123,9 +12800,10 @@ function printStatus() {
     wsUrl: config.wsUrl ?? null,
     endpointProfile: config.endpointProfile ?? null,
     localApiPort: config.localApiPort ?? null,
+    localDaemonRunning,
     hasLocalApiToken: Boolean(config.localApiToken),
     configPath: getConfigPath(),
-    note: configured ? "Durable runtime config is present. Start it with: aiden-agent daemon" : "No durable runtime configured. Cloud sandbox sessions are launched by Aiden with session env vars and do not appear in this local config.",
+    note: configured ? localDaemonRunning ? "Local daemon is running. Stop it with: aiden-agent stop" : "Durable runtime config is present. Start it with: aiden-agent daemon" : "No durable runtime configured. Cloud sandbox sessions are launched by Aiden with session env vars and do not appear in this local config.",
     warnings
   }, null, 2));
 }
@@ -12144,7 +12822,7 @@ async function printDoctor(args = []) {
         authorization: `Bearer ${config.runtimeToken}`,
         "content-type": "application/json"
       },
-      body: JSON.stringify({ capabilities })
+      body: JSON.stringify({ capabilities, metadata: await collectRuntimeMetadataWithProviderLimits() })
     });
     if (!response.ok) {
       syncError = `${response.status} ${await response.text()}`;
@@ -12177,6 +12855,7 @@ Commands:
   setup       Register this computer with a setup token from Aiden
   login       Register this computer through browser authorization
   daemon      Start the durable runtime daemon
+  stop        Stop the local daemon (or active runs only via the local API /stop)
   status      Show local runtime configuration without secrets
   doctor      Check local CLI capabilities
   logout      Remove local runtime configuration
@@ -12188,6 +12867,7 @@ Common flows:
   aiden-agent setup --setup-token <token>
   aiden-agent setup --setup-token <token> --scope user
   aiden-agent daemon
+  aiden-agent stop
 
 Local development:
   aiden-agent login --profile local
@@ -12274,8 +12954,12 @@ async function main() {
     await runDaemon(commandArgs);
     return;
   }
+  if (command === "stop") {
+    await stopDaemon(commandArgs);
+    return;
+  }
   if (command === "status") {
-    printStatus();
+    await printStatus();
     return;
   }
   if (command === "doctor") {