@sideboard-ai/core 0.1.24 → 0.1.31

package/dist/mcp/run-stdio.cjs

@@ -4177,6 +4177,35 @@ var init_claude = __esm({
 });
 
 // src/agents/codex.ts
+async function listCodexModels() {
+  const now = Date.now();
+  if (cachedCodexModels && now - cachedCodexModels.at < CODEX_MODEL_CACHE_MS) {
+    return cachedCodexModels.models;
+  }
+  const which = await run("which", ["codex"], { reject: false });
+  if (which.exitCode !== 0) return FALLBACK_CODEX_MODELS;
+  const listed = await run("codex", ["debug", "models"], { reject: false });
+  if (listed.exitCode !== 0 || !listed.stdout.trim()) {
+    return cachedCodexModels?.models ?? FALLBACK_CODEX_MODELS;
+  }
+  try {
+    const parsed = JSON.parse(listed.stdout);
+    const rows = Array.isArray(parsed.models) ? parsed.models : [];
+    const preferred = rows.filter((m) => (m.visibility ?? "list") === "list");
+    const source = preferred.length > 0 ? preferred : rows;
+    const models = source.map((m) => ({
+      id: (m.slug || "").trim(),
+      displayName: (m.display_name || m.slug || "").trim(),
+      description: m.description,
+      priority: typeof m.priority === "number" ? m.priority : 999
+    })).filter((m) => m.id).sort((a, b) => a.priority - b.priority).map(({ id, displayName, description }) => ({ id, displayName, description }));
+    if (models.length === 0) return FALLBACK_CODEX_MODELS;
+    cachedCodexModels = { at: now, models };
+    return models;
+  } catch {
+    return cachedCodexModels?.models ?? FALLBACK_CODEX_MODELS;
+  }
+}
 function usageFromCodex(usage) {
   if (!usage) return null;
   const inputTokens = Number(usage.input_tokens ?? 0);
@@ -4200,7 +4229,7 @@ function codexConfigHasNetworkAccess() {
   }
   return false;
 }
-var import_node_fs11, import_node_os7, import_node_path11, CODEX_PROMPT_ARG_MAX, codexAdapter;
+var import_node_fs11, import_node_os7, import_node_path11, CODEX_PROMPT_ARG_MAX, FALLBACK_CODEX_MODELS, cachedCodexModels, CODEX_MODEL_CACHE_MS, codexAdapter;
 var init_codex = __esm({
   "src/agents/codex.ts"() {
     "use strict";
@@ -4211,6 +4240,15 @@ var init_codex = __esm({
     init_turn_input();
     init_types();
     CODEX_PROMPT_ARG_MAX = 2e5;
+    FALLBACK_CODEX_MODELS = [
+      { id: "gpt-5.6-sol", displayName: "GPT-5.6 Sol" },
+      { id: "gpt-5.6-terra", displayName: "GPT-5.6 Terra" },
+      { id: "gpt-5.6-luna", displayName: "GPT-5.6 Luna" },
+      { id: "gpt-5.5", displayName: "GPT-5.5" },
+      { id: "gpt-5.2", displayName: "GPT-5.2" }
+    ];
+    cachedCodexModels = null;
+    CODEX_MODEL_CACHE_MS = 5 * 60 * 1e3;
     codexAdapter = {
       kind: "codex",
       async detect() {
@@ -4256,6 +4294,7 @@ var init_codex = __esm({
           );
         }
         const mode = permissionMode(thread);
+        const model = thread.model?.trim();
         const args = [
           "exec",
           ...sessionId ? ["resume", sessionId] : [],
@@ -4266,7 +4305,8 @@ var init_codex = __esm({
           "--sandbox",
           mode.codexSandbox,
           "--ask-for-approval",
-          "never"
+          "never",
+          ...model ? ["--model", model] : []
         ];
         return {
           file: "codex",
@@ -4447,6 +4487,35 @@ function resolveCursorApiKey() {
   if (fromEnv) return fromEnv;
   return (loadAppSettings().environment.CURSOR_API_KEY || "").trim();
 }
+function isCursorAutoModel(model) {
+  const id = (model ?? "").trim().toLowerCase();
+  return !id || id === "default" || id === "auto";
+}
+function resolveCursorModelId(model) {
+  if (isCursorAutoModel(model)) return "default";
+  return model.trim();
+}
+async function listCursorModels() {
+  const now = Date.now();
+  if (cachedModels && now - cachedModels.at < MODEL_CACHE_MS) {
+    return cachedModels.models;
+  }
+  const apiKey = resolveCursorApiKey();
+  if (!apiKey) return FALLBACK_CURSOR_MODELS;
+  try {
+    const listed = await import_sdk.Cursor.models.list({ apiKey });
+    const models = listed.map((m) => ({
+      id: m.id,
+      displayName: m.displayName || m.id,
+      description: m.description
+    })).filter((m) => Boolean(m.id));
+    if (models.length === 0) return FALLBACK_CURSOR_MODELS;
+    cachedModels = { at: now, models };
+    return models;
+  } catch {
+    return cachedModels?.models ?? FALLBACK_CURSOR_MODELS;
+  }
+}
 function entryDir() {
   const cjsDir = typeof __dirname !== "undefined" ? __dirname : "";
   if (cjsDir) return cjsDir;
@@ -4478,7 +4547,7 @@ function cursorRunnerPath() {
   }
   return candidates[0];
 }
-var import_node_fs12, import_node_module2, import_node_path12, import_node_url2, import_sdk, import_meta2, cursorAdapter;
+var import_node_fs12, import_node_module2, import_node_path12, import_node_url2, import_sdk, import_meta2, FALLBACK_CURSOR_MODELS, cachedModels, MODEL_CACHE_MS, cursorAdapter;
 var init_cursor = __esm({
   "src/agents/cursor.ts"() {
     "use strict";
@@ -4493,6 +4562,13 @@ var init_cursor = __esm({
     init_turn_input();
     init_cursor_events();
     import_meta2 = {};
+    FALLBACK_CURSOR_MODELS = [
+      { id: "default", displayName: "Auto" },
+      { id: "composer-2.5", displayName: "Composer 2.5" },
+      { id: "composer-2", displayName: "Composer 2" }
+    ];
+    cachedModels = null;
+    MODEL_CACHE_MS = 5 * 60 * 1e3;
     cursorAdapter = {
       kind: "cursor",
       async detect() {
@@ -4543,12 +4619,16 @@ var init_cursor = __esm({
         };
         const runner = cursorRunnerPath();
         const isTs = runner.endsWith(".ts");
+        const whichNode = await run("which", ["node"], { reject: false });
+        const nodeBin = whichNode.exitCode === 0 && whichNode.stdout.trim() ? whichNode.stdout.trim() : null;
+        const file = nodeBin || process.execPath;
         return {
-          file: process.execPath,
+          file,
           args: isTs ? ["--import", "tsx", runner] : [runner],
           cwd: thread.worktreePath,
           stdin: JSON.stringify(req),
           env: {
+            ...nodeBin ? {} : { ELECTRON_RUN_AS_NODE: "1" },
             ...apiKey ? { CURSOR_API_KEY: apiKey } : {}
           }
         };
@@ -4573,6 +4653,46 @@ var init_cursor = __esm({
 });
 
 // src/agents/opencode.ts
+function displayNameFromOpencodeId(id) {
+  const slash = id.indexOf("/");
+  if (slash <= 0) return id;
+  const provider = id.slice(0, slash);
+  const name = id.slice(slash + 1);
+  return `${provider} \xB7 ${name}`;
+}
+function sortOpencodeModelIds(ids) {
+  return [...ids].sort((a, b) => {
+    const aLatest = /latest|~/.test(a) ? 0 : 1;
+    const bLatest = /latest|~/.test(b) ? 0 : 1;
+    if (aLatest !== bLatest) return aLatest - bLatest;
+    const aOc = a.startsWith("opencode/") ? 0 : 1;
+    const bOc = b.startsWith("opencode/") ? 0 : 1;
+    if (aOc !== bOc) return aOc - bOc;
+    return a.localeCompare(b);
+  });
+}
+async function listOpencodeModels() {
+  const now = Date.now();
+  if (cachedOpencodeModels && now - cachedOpencodeModels.at < OPENCODE_MODEL_CACHE_MS) {
+    return cachedOpencodeModels.models;
+  }
+  const which = await run("which", ["opencode"], { reject: false });
+  if (which.exitCode !== 0) return FALLBACK_OPENCODE_MODELS;
+  const listed = await run("opencode", ["models"], { reject: false });
+  if (listed.exitCode !== 0 || !listed.stdout.trim()) {
+    return cachedOpencodeModels?.models ?? FALLBACK_OPENCODE_MODELS;
+  }
+  const ids = listed.stdout.split("\n").map((l) => l.trim()).filter((l) => /^[\w.~@+-]+\/[\w.~@+/-]+$/.test(l));
+  const unique = [...new Set(ids)];
+  if (unique.length === 0) return FALLBACK_OPENCODE_MODELS;
+  const OPENCODE_PICKER_LIMIT = 60;
+  const models = sortOpencodeModelIds(unique).slice(0, OPENCODE_PICKER_LIMIT).map((id) => ({
+    id,
+    displayName: displayNameFromOpencodeId(id)
+  }));
+  cachedOpencodeModels = { at: now, models };
+  return models;
+}
 function usageFromOpencode(tokens) {
   if (!tokens) return null;
   const inputTokens = Number(tokens.input ?? 0);
@@ -4585,13 +4705,26 @@ function usageFromOpencode(tokens) {
     cacheWriteTokens: tokens.cache?.write ? Number(tokens.cache.write) : void 0
   };
 }
-var opencodeAdapter;
+var FALLBACK_OPENCODE_MODELS, cachedOpencodeModels, OPENCODE_MODEL_CACHE_MS, opencodeAdapter;
 var init_opencode = __esm({
   "src/agents/opencode.ts"() {
     "use strict";
     init_run();
     init_turn_input();
     init_types();
+    FALLBACK_OPENCODE_MODELS = [
+      { id: "opencode/big-pickle", displayName: "opencode \xB7 big-pickle" },
+      {
+        id: "openrouter/~anthropic/claude-sonnet-latest",
+        displayName: "openrouter \xB7 claude-sonnet-latest"
+      },
+      {
+        id: "openrouter/~openai/gpt-latest",
+        displayName: "openrouter \xB7 gpt-latest"
+      }
+    ];
+    cachedOpencodeModels = null;
+    OPENCODE_MODEL_CACHE_MS = 5 * 60 * 1e3;
     opencodeAdapter = {
       kind: "opencode",
       async detect() {
@@ -4623,6 +4756,7 @@ var init_opencode = __esm({
         const prompt = flattenTurnInput(input);
         const sessionId = await this.resolveSessionId(thread.worktreePath, thread.sessionId);
         const mode = permissionMode(thread);
+        const model = thread.model?.trim();
         const args = [
           "run",
           "--dir",
@@ -4633,6 +4767,9 @@ var init_opencode = __esm({
         if (sessionId) {
           args.push("--session", sessionId);
         }
+        if (model) {
+          args.push("--model", model);
+        }
         return {
           file: "opencode",
           args,
@@ -4760,6 +4897,183 @@ var init_opencode = __esm({
   }
 });
 
+// src/agents/install.ts
+function getAgentSetupInfo(agent) {
+  return SETUP[agent];
+}
+function listAgentSetupInfo() {
+  return Object.values(SETUP);
+}
+async function openInSystemTerminal(command) {
+  ensureAgentPath();
+  const trimmed = command.trim();
+  if (!trimmed) throw new Error("Command is empty");
+  if (process.platform === "darwin") {
+    const escaped = trimmed.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+    const script = `tell application "Terminal" to do script "${escaped}"`;
+    const result = await run("osascript", ["-e", script], { reject: false });
+    if (result.exitCode !== 0) {
+      throw new Error(result.stderr.trim() || result.stdout.trim() || "Failed to open Terminal");
+    }
+    await run("osascript", ["-e", 'tell application "Terminal" to activate'], {
+      reject: false
+    });
+    return;
+  }
+  if (process.platform === "win32") {
+    const result = await run(
+      "cmd.exe",
+      ["/c", "start", "cmd.exe", "/k", trimmed],
+      { reject: false }
+    );
+    if (result.exitCode !== 0) {
+      throw new Error(result.stderr.trim() || result.stdout.trim() || "Failed to open cmd");
+    }
+    return;
+  }
+  const candidates = [
+    { file: "gnome-terminal", args: ["--", "bash", "-lc", `${trimmed}; exec bash`] },
+    { file: "x-terminal-emulator", args: ["-e", "bash", "-lc", `${trimmed}; exec bash`] },
+    { file: "konsole", args: ["-e", "bash", "-lc", `${trimmed}; exec bash`] },
+    { file: "xterm", args: ["-e", "bash", "-lc", `${trimmed}; exec bash`] }
+  ];
+  for (const c of candidates) {
+    const which = await run("which", [c.file], { reject: false });
+    if (which.exitCode !== 0 || !which.stdout.trim()) continue;
+    const result = await run(c.file, c.args, { reject: false });
+    if (result.exitCode === 0) return;
+  }
+  throw new Error(
+    `No terminal found to run: ${trimmed}. Install gnome-terminal (or similar), or run the command manually.`
+  );
+}
+async function installAgent(agent) {
+  const info = getAgentSetupInfo(agent);
+  if (info.kind === "bundled-sdk" || info.kind === "api-key") {
+    return {
+      ok: true,
+      message: info.summary
+    };
+  }
+  if (!info.installCommand) {
+    return { ok: false, message: `No install command for ${agent}` };
+  }
+  if (/curl\s| \|\s*bash/.test(info.installCommand) || !info.npmPackage) {
+    await openInSystemTerminal(info.installCommand);
+    return {
+      ok: true,
+      openedTerminal: true,
+      command: info.installCommand,
+      message: `Opened Terminal to run: ${info.installCommand}`
+    };
+  }
+  ensureAgentPath();
+  const result = await run("npm", ["install", "-g", info.npmPackage], { reject: false });
+  const ok = result.exitCode === 0;
+  if (!ok) {
+    try {
+      await openInSystemTerminal(info.installCommand);
+      return {
+        ok: false,
+        openedTerminal: true,
+        command: info.installCommand,
+        exitCode: result.exitCode,
+        stdout: result.stdout,
+        stderr: result.stderr,
+        message: `npm install failed (exit ${result.exitCode}). Opened Terminal with: ${info.installCommand}`
+      };
+    } catch {
+      return {
+        ok: false,
+        command: info.installCommand,
+        exitCode: result.exitCode,
+        stdout: result.stdout,
+        stderr: result.stderr,
+        message: result.stderr.trim() || result.stdout.trim() || `npm install failed (exit ${result.exitCode})`
+      };
+    }
+  }
+  return {
+    ok: true,
+    command: info.installCommand,
+    exitCode: 0,
+    stdout: result.stdout,
+    stderr: result.stderr,
+    message: `Installed ${info.npmPackage}`
+  };
+}
+async function loginAgent(agent) {
+  const info = getAgentSetupInfo(agent);
+  if (!info.loginCommand) {
+    return {
+      ok: true,
+      message: info.kind === "bundled-sdk" || info.kind === "api-key" ? info.summary : `No login command for ${agent}`
+    };
+  }
+  await openInSystemTerminal(info.loginCommand);
+  return {
+    ok: true,
+    openedTerminal: true,
+    command: info.loginCommand,
+    message: `Opened Terminal to run: ${info.loginCommand}`
+  };
+}
+var SETUP;
+var init_install = __esm({
+  "src/agents/install.ts"() {
+    "use strict";
+    init_run();
+    init_path();
+    SETUP = {
+      claude: {
+        agent: "claude",
+        kind: "cli",
+        summary: "Install the Claude Code CLI, then complete login in a terminal.",
+        docsUrl: "https://code.claude.com/docs/en/install",
+        installCommand: "npm install -g @anthropic-ai/claude-code",
+        loginCommand: "claude auth login",
+        npmPackage: "@anthropic-ai/claude-code"
+      },
+      codex: {
+        agent: "codex",
+        kind: "cli",
+        summary: "Install the Codex CLI, then run login in a terminal.",
+        docsUrl: "https://github.com/openai/codex",
+        installCommand: "npm install -g @openai/codex",
+        loginCommand: "codex login",
+        npmPackage: "@openai/codex"
+      },
+      opencode: {
+        agent: "opencode",
+        kind: "cli",
+        summary: "Install OpenCode (curl installer or npm), then authenticate providers.",
+        docsUrl: "https://opencode.ai/docs",
+        // Prefer the official installer; npm package name is opencode-ai.
+        installCommand: "curl -fsSL https://opencode.ai/install | bash",
+        loginCommand: "opencode auth login",
+        npmPackage: "opencode-ai@latest"
+      },
+      cursor: {
+        agent: "cursor",
+        kind: "bundled-sdk",
+        summary: "No CLI install \u2014 Sideboard ships the Cursor SDK. Add a CURSOR_API_KEY from the Cursor dashboard.",
+        docsUrl: "https://cursor.com/dashboard/integrations",
+        installCommand: null,
+        loginCommand: null
+      },
+      brightsy: {
+        agent: "brightsy",
+        kind: "cli",
+        summary: "Install the Brightsy CLI, then run `brightsy login`.",
+        docsUrl: "https://www.npmjs.com/package/@brightsy/cli",
+        installCommand: "npm install -g @brightsy/cli",
+        loginCommand: "brightsy login",
+        npmPackage: "@brightsy/cli"
+      }
+    };
+  }
+});
+
 // src/agents/index.ts
 var agents_exports = {};
 __export(agents_exports, {
@@ -4774,10 +5088,20 @@ __export(agents_exports, {
   encodeBrightsyTarget: () => encodeBrightsyTarget,
   ensureAgentPath: () => ensureAgentPath,
   getAdapter: () => getAdapter,
+  getAgentSetupInfo: () => getAgentSetupInfo,
+  installAgent: () => installAgent,
+  isCursorAutoModel: () => isCursorAutoModel,
+  listAgentSetupInfo: () => listAgentSetupInfo,
   listBrightsyChatTargets: () => listBrightsyChatTargets,
+  listCodexModels: () => listCodexModels,
+  listCursorModels: () => listCursorModels,
+  listOpencodeModels: () => listOpencodeModels,
+  loginAgent: () => loginAgent,
+  openInSystemTerminal: () => openInSystemTerminal,
   opencodeAdapter: () => opencodeAdapter,
   parseCursorRunnerLine: () => parseCursorRunnerLine,
-  permissionMode: () => permissionMode
+  permissionMode: () => permissionMode,
+  resolveCursorModelId: () => resolveCursorModelId
 });
 function getAdapter(kind) {
   return adapters[kind];
@@ -4801,8 +5125,10 @@ var init_agents = __esm({
     init_codex();
     init_cursor();
     init_cursor_events();
+    init_cursor();
     init_opencode();
     init_path();
+    init_install();
     adapters = {
       claude: claudeAdapter,
       codex: codexAdapter,
@@ -4936,11 +5262,11 @@ var init_workspaces = __esm({
 var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
 var import_zod = require("zod");
-var import_node_path22 = require("path");
+var import_node_path23 = require("path");
 
 // src/orchestrator/orchestrator.ts
 var import_node_events = require("events");
-var import_node_fs23 = require("fs");
+var import_node_fs24 = require("fs");
 
 // src/agents/spawn.ts
 var import_node_readline = require("readline");
@@ -6310,10 +6636,10 @@ function createChatTab(input) {
     userSetTitle: true,
     ...binding,
     agent: input.agent ?? from.agent,
-    model: input.agent && input.agent !== from.agent ? null : from.model,
+    model: input.model !== void 0 ? input.model : input.agent && input.agent !== from.agent ? null : from.model,
     fast: from.fast,
     planMode: from.planMode,
-    autonomy: from.autonomy,
+    autonomy: input.autonomy ?? from.autonomy,
     attachments: input.attachments ?? [],
     status: "idle"
   });
@@ -6350,12 +6676,16 @@ async function forkThreadWorktree(input, onSetupLine) {
       repoPath: from.repoPath,
       agent: input.agent ?? from.agent,
       autonomy: from.autonomy,
+      model: from.model,
+      fast: from.fast,
+      planMode: from.planMode,
       title: input.title?.trim() || void 0,
-      parentThreadId: from.id
+      parentThreadId: from.id,
+      attachments: [attachment]
     },
     onSetupLine
   );
-  return updateThread(thread.id, { attachments: [attachment] });
+  return thread;
 }
 
 // src/threads/adopt.ts
@@ -7513,6 +7843,9 @@ function expandComposerPrompt(worktreePath, prompt, opts) {
     parts.push("");
     parts.push(`## Attachment: ${att.name}`);
     parts.push(`Kind: ${att.kind}`);
+    if (att.path) {
+      parts.push(`Path in worktree: \`${att.path}\``);
+    }
     parts.push("");
     parts.push(att.content);
   }
@@ -7555,9 +7888,198 @@ function expandComposerPrompt(worktreePath, prompt, opts) {
   };
 }
 
-// src/agents/instructions.ts
+// src/composer/stage-files.ts
 var import_node_fs22 = require("fs");
 var import_node_path21 = require("path");
+var import_node_crypto3 = require("crypto");
+var IMAGE_EXTENSIONS2 = /* @__PURE__ */ new Set([
+  "png",
+  "jpg",
+  "jpeg",
+  "gif",
+  "webp",
+  "svg",
+  "bmp",
+  "ico"
+]);
+var IMAGE_MIME_BY_EXT = {
+  png: "image/png",
+  jpg: "image/jpeg",
+  jpeg: "image/jpeg",
+  gif: "image/gif",
+  webp: "image/webp",
+  svg: "image/svg+xml",
+  bmp: "image/bmp",
+  ico: "image/x-icon"
+};
+var ATTACHMENTS_DIR = ".sideboard/attachments";
+var ATTACHMENTS_GITIGNORE = `# Sideboard review / composer attachments (local only)
+*
+!.gitignore
+`;
+var MAX_INLINE_BYTES = 4e5;
+var MAX_PREVIEW_BYTES = 5e6;
+function fileExtension(filePath) {
+  const base = (0, import_node_path21.basename)(filePath).toLowerCase();
+  return base.includes(".") ? base.split(".").pop() || "" : "";
+}
+function isImageFilePath(filePath) {
+  return IMAGE_EXTENSIONS2.has(fileExtension(filePath));
+}
+function imageMimeType(filePath) {
+  return IMAGE_MIME_BY_EXT[fileExtension(filePath)] || "image/png";
+}
+function ensureAttachmentsDir(worktreePath) {
+  const dir = (0, import_node_path21.join)(worktreePath, ATTACHMENTS_DIR);
+  (0, import_node_fs22.mkdirSync)(dir, { recursive: true });
+  const gi = (0, import_node_path21.join)(dir, ".gitignore");
+  if (!(0, import_node_fs22.existsSync)(gi)) {
+    (0, import_node_fs22.writeFileSync)(gi, ATTACHMENTS_GITIGNORE, "utf8");
+  }
+  return dir;
+}
+function uniqueAttachmentName(dir, originalName) {
+  const safe = originalName.replace(/[/\\]/g, "_") || "file";
+  if (!(0, import_node_fs22.existsSync)((0, import_node_path21.join)(dir, safe))) return safe;
+  const ext = (0, import_node_path21.extname)(safe);
+  const stem = ext ? safe.slice(0, -ext.length) : safe;
+  for (let i = 1; i < 1e4; i++) {
+    const candidate = `${stem}-${i}${ext}`;
+    if (!(0, import_node_fs22.existsSync)((0, import_node_path21.join)(dir, candidate))) return candidate;
+  }
+  return `${stem}-${(0, import_node_crypto3.randomUUID)()}${ext}`;
+}
+function previewDataUrlFromBuf(filePath, buf) {
+  if (!isImageFilePath(filePath)) return void 0;
+  if (buf.length > MAX_PREVIEW_BYTES) return void 0;
+  return `data:${imageMimeType(filePath)};base64,${buf.toString("base64")}`;
+}
+function attachmentFromBuffer(name, buf, opts) {
+  const previewDataUrl = previewDataUrlFromBuf(name, buf);
+  if (isImageFilePath(name)) {
+    const pathHint = opts.path ? `\`${opts.path}\`` : opts.sourceLabel || name;
+    return {
+      id: (0, import_node_crypto3.randomUUID)(),
+      name,
+      kind: "file",
+      path: opts.path,
+      previewDataUrl,
+      content: [
+        `Image attached: ${pathHint}`,
+        opts.path ? `Use the Read tool on \`${opts.path}\` to view this image.` : "The image is shown in the composer; copy it into the worktree if you need to inspect pixels."
+      ].join("\n")
+    };
+  }
+  if (buf.length > MAX_INLINE_BYTES) {
+    return {
+      id: (0, import_node_crypto3.randomUUID)(),
+      name,
+      kind: "file",
+      path: opts.path,
+      content: opts.path ? `(file too large to attach inline: \`${opts.path}\`, ${buf.length} bytes \u2014 use the Read tool)` : `(file too large to attach inline: ${opts.sourceLabel || name}, ${buf.length} bytes)`
+    };
+  }
+  if (buf.includes(0)) {
+    return {
+      id: (0, import_node_crypto3.randomUUID)(),
+      name,
+      kind: "file",
+      path: opts.path,
+      content: opts.path ? `(binary file at \`${opts.path}\` \u2014 use tools to inspect)` : `(binary file attached by path only: ${opts.sourceLabel || name})`
+    };
+  }
+  return {
+    id: (0, import_node_crypto3.randomUUID)(),
+    name,
+    kind: "file",
+    path: opts.path,
+    content: buf.toString("utf8")
+  };
+}
+function stageAbsolutePathsAsAttachments(worktreePath, absolutePaths) {
+  if (absolutePaths.length === 0) return [];
+  const dir = ensureAttachmentsDir(worktreePath);
+  const out = [];
+  for (const abs of absolutePaths) {
+    const originalName = (0, import_node_path21.basename)(abs);
+    try {
+      const st = (0, import_node_fs22.statSync)(abs);
+      if (!st.isFile()) continue;
+      const name = uniqueAttachmentName(dir, originalName);
+      const destAbs = (0, import_node_path21.join)(dir, name);
+      (0, import_node_fs22.copyFileSync)(abs, destAbs);
+      const rel = `${ATTACHMENTS_DIR}/${name}`;
+      const buf = (0, import_node_fs22.readFileSync)(destAbs);
+      out.push(attachmentFromBuffer(name, buf, { path: rel, sourceLabel: abs }));
+    } catch (err) {
+      out.push({
+        id: (0, import_node_crypto3.randomUUID)(),
+        name: originalName,
+        kind: "file",
+        content: `(could not attach ${abs}: ${err instanceof Error ? err.message : String(err)})`
+      });
+    }
+  }
+  return out;
+}
+function stageBuffersAsAttachments(worktreePath, buffers) {
+  if (buffers.length === 0) return [];
+  const dir = ensureAttachmentsDir(worktreePath);
+  const out = [];
+  for (const item of buffers) {
+    const originalName = (item.name || "file").replace(/[/\\]/g, "_") || "file";
+    try {
+      const buf = Buffer.from(item.dataBase64, "base64");
+      const name = uniqueAttachmentName(dir, originalName);
+      const destAbs = (0, import_node_path21.join)(dir, name);
+      (0, import_node_fs22.writeFileSync)(destAbs, buf);
+      const rel = `${ATTACHMENTS_DIR}/${name}`;
+      out.push(attachmentFromBuffer(name, buf, { path: rel }));
+    } catch (err) {
+      out.push({
+        id: (0, import_node_crypto3.randomUUID)(),
+        name: originalName,
+        kind: "file",
+        content: `(could not attach ${originalName}: ${err instanceof Error ? err.message : String(err)})`
+      });
+    }
+  }
+  return out;
+}
+function attachmentsFromWorktreePaths(worktreePath, relativePaths) {
+  const out = [];
+  for (const rel of relativePaths) {
+    if (!rel || rel.includes("..") || rel.startsWith("/")) {
+      out.push({
+        id: (0, import_node_crypto3.randomUUID)(),
+        name: (0, import_node_path21.basename)(rel) || "file",
+        kind: "file",
+        content: `(invalid path: ${rel})`
+      });
+      continue;
+    }
+    const name = (0, import_node_path21.basename)(rel);
+    try {
+      const abs = (0, import_node_path21.join)(worktreePath, rel);
+      const st = (0, import_node_fs22.statSync)(abs);
+      if (!st.isFile()) continue;
+      const buf = (0, import_node_fs22.readFileSync)(abs);
+      out.push(attachmentFromBuffer(name, buf, { path: rel, sourceLabel: abs }));
+    } catch (err) {
+      out.push({
+        id: (0, import_node_crypto3.randomUUID)(),
+        name,
+        kind: "file",
+        content: `(could not read ${rel}: ${err instanceof Error ? err.message : String(err)})`
+      });
+    }
+  }
+  return out;
+}
+
+// src/agents/instructions.ts
+var import_node_fs23 = require("fs");
+var import_node_path22 = require("path");
 init_worktree_labels();
 function normPath2(p) {
   return p.replace(/\/+$/, "");
@@ -7671,11 +8193,11 @@ function loadAgentInstructions(worktreePath, agent) {
   const out = [];
   for (const rel of candidates) {
     if (seen.has(rel)) continue;
-    const abs = (0, import_node_path21.join)(worktreePath, rel);
-    if (!(0, import_node_fs22.existsSync)(abs)) continue;
+    const abs = (0, import_node_path22.join)(worktreePath, rel);
+    if (!(0, import_node_fs23.existsSync)(abs)) continue;
     try {
-      if (!(0, import_node_fs22.statSync)(abs).isFile()) continue;
-      let content = (0, import_node_fs22.readFileSync)(abs, "utf8");
+      if (!(0, import_node_fs23.statSync)(abs).isFile()) continue;
+      let content = (0, import_node_fs23.readFileSync)(abs, "utf8");
       if (!content.trim()) continue;
       if (content.length > MAX_CHARS_PER_FILE) {
         content = `${content.slice(0, MAX_CHARS_PER_FILE)}
@@ -7801,7 +8323,7 @@ var Orchestrator = class {
         }
         continue;
       }
-      if (!(0, import_node_fs23.existsSync)(thread.worktreePath)) {
+      if (!(0, import_node_fs24.existsSync)(thread.worktreePath)) {
         setStatus(thread.id, "broken", "Worktree missing on disk");
         this.emit({ type: "status_changed", threadId: thread.id, status: "broken" });
         continue;
@@ -8054,6 +8576,7 @@ var Orchestrator = class {
       ...fresh.agent === "claude" && fresh.sessionId ? [] : [instructions, seed]
     ].filter(Boolean).join("\n\n---\n\n");
     try {
+      let lastStderr = "";
       const handle = await spawnAgentTurn(
         fresh,
         { cachedPrefix, prompt: agentPrompt },
@@ -8062,6 +8585,9 @@ var Orchestrator = class {
           if (event.type === "session_id") {
             updateThread(threadId, { sessionId: event.data });
           }
+          if (event.type === "stderr" && typeof event.data === "string" && event.data.trim()) {
+            lastStderr = event.data.trim();
+          }
         }
       );
       this.activeTurns.set(threadId, handle);
@@ -8107,7 +8633,12 @@ var Orchestrator = class {
         this.emit({ type: "status_changed", threadId, status: "stopped" });
         this.emit({ type: "turn_finished", threadId, exitCode: result.exitCode });
       } else {
-        setStatus(threadId, result.exitCode === 0 ? "idle" : "error", result.exitCode === 0 ? null : `exit ${result.exitCode}`);
+        const failDetail = lastStderr ? `exit ${result.exitCode}: ${lastStderr.slice(0, 500)}` : `exit ${result.exitCode}`;
+        setStatus(
+          threadId,
+          result.exitCode === 0 ? "idle" : "error",
+          result.exitCode === 0 ? null : failDetail
+        );
         this.emit({
           type: "status_changed",
           threadId,
@@ -8581,9 +9112,16 @@ var Orchestrator = class {
     if (patch.planMode !== void 0) next.planMode = patch.planMode;
     if (patch.model !== void 0) next.model = patch.model;
     if (patch.agent !== void 0) {
-      next.agent = patch.agent;
-      if (patch.agent !== "claude" && patch.model === void 0) next.model = null;
-      next.sessionId = null;
+      if (patch.agent !== thread.agent) {
+        if (thread.messages.length > 0) {
+          throw new Error(
+            `Cannot switch agent provider mid-chat (${thread.agent} \u2192 ${patch.agent}). Start a new chat tab instead.`
+          );
+        }
+        next.agent = patch.agent;
+        if (patch.agent !== "claude" && patch.model === void 0) next.model = null;
+        next.sessionId = null;
+      }
     }
     return updateThread(thread.id, next);
   }
@@ -8613,6 +9151,23 @@ var Orchestrator = class {
   setAttachments(threadRef, attachments) {
     return updateThread(this.requireThread(threadRef).id, { attachments });
   }
+  /**
+   * Stage OS / worktree files into composer attachments (copies external files
+   * into `.sideboard/attachments/` so agents can Read images and binaries).
+   */
+  attachComposerFiles(threadRef, opts) {
+    const thread = this.requireThread(threadRef);
+    const fromAbs = stageAbsolutePathsAsAttachments(
+      thread.worktreePath,
+      opts.absolutePaths ?? []
+    );
+    const fromRel = attachmentsFromWorktreePaths(
+      thread.worktreePath,
+      opts.relativePaths ?? []
+    );
+    const fromBuf = stageBuffersAsAttachments(thread.worktreePath, opts.buffers ?? []);
+    return [...fromAbs, ...fromRel, ...fromBuf];
+  }
   listWorktreeChats(threadRef) {
     const thread = this.requireThread(threadRef);
     return threadsSharingWorktree(thread.worktreePath);
@@ -8672,7 +9227,7 @@ var Orchestrator = class {
       updateThread(thread.id, { worktreePath: globalAgentCwd2() });
       return setStatus(thread.id, "idle");
     }
-    if (!(0, import_node_fs23.existsSync)(thread.worktreePath)) {
+    if (!(0, import_node_fs24.existsSync)(thread.worktreePath)) {
       const { createThreadWorktree: createThreadWorktree2 } = await Promise.resolve().then(() => (init_worktree(), worktree_exports));
       const { execa: execa7 } = await import("execa");
       const slug = thread.worktreePath.split("/").pop();
@@ -8890,7 +9445,7 @@ async function startMcpServer() {
     async () => {
       const threads = orch.getThreads(true);
       const lines = threads.map((t) => {
-        const repo = t.repoPath === GLOBAL_WORKSPACE_ID ? "Orchestration" : (0, import_node_path22.basename)(t.repoPath) || t.repoPath;
+        const repo = t.repoPath === GLOBAL_WORKSPACE_ID ? "Orchestration" : (0, import_node_path23.basename)(t.repoPath) || t.repoPath;
         return `${t.id.slice(0, 8)}  ${t.status.padEnd(9)}  ${t.agent.padEnd(8)}  ${repo}  ${t.sourceType}:${t.sourceRef}  ${t.title}  sideboard://thread/${t.id}${t.devPort ? `  http://localhost:${t.devPort}` : ""}`;
       });
       return {