@sideboard-ai/core 0.1.44 → 0.1.46

package/dist/{chunk-V3S4NF5F.js → chunk-7DTJFP4D.js}

@@ -3,7 +3,7 @@ import {
   ensureWorkspace,
   removeWorkspace,
   syncWorkspacesFromThreads
-} from "./chunk-TXFJEXFB.js";
+} from "./chunk-SZAKJ4TR.js";
 import {
   GLOBAL_WORKSPACE_ID,
   createGlobalChat,
@@ -13,34 +13,44 @@ import {
   isGlobalThread,
   isOrchestratorThread,
   orchestratorSessionPoisonedByBuiltins
-} from "./chunk-I3PKMLFW.js";
+} from "./chunk-SPCU3MFY.js";
 import {
   coordinatorSystemPrompt,
   coordinatorTurnReminder,
   enrichWorkspacesWithGithub,
   ensureGlobalCoordinatorCwd
-} from "./chunk-JM2TVGNW.js";
+} from "./chunk-6NAPN2N5.js";
 import {
   PLAN_MODE_INSTRUCTION,
   allAdapters,
   getAdapter,
-  parseBrightsyCliLine
-} from "./chunk-XX26NCB6.js";
+  isSessionQuotaLimit,
+  listModelsForAgent,
+  parseBrightsyCliLine,
+  parseSessionQuotaResetAt,
+  resolveQuotaFallbackAgent
+} from "./chunk-TQK2OYPU.js";
+import {
+  assertOrchestratorCapableAgent
+} from "./chunk-GI7E5733.js";
 import {
   fallbackTurnFailDetail,
   formatTurnExitError,
+  humanizeAgentFailDetail,
   looksLikeAgentFailureMessage,
   pushTurnStderr,
   summarizeTurnStderr
-} from "./chunk-PU27NUO4.js";
+} from "./chunk-J5JTEJ5O.js";
 import {
   childEnvWithAppSettings,
   getLinearApiKey,
   isLinearConnected,
   loadAppSettings,
+  orchestrationQuotaFallbackAgent,
+  orchestrationQuotaOnLimit,
   resolveEffectiveIssueSource,
   updateAdvancedSettings
-} from "./chunk-FSIK442J.js";
+} from "./chunk-T5QQVXK3.js";
 import {
   allocateTeamName,
   allocateTeamSlug,
@@ -71,7 +81,7 @@ import {
   takenSlugsFromThread,
   threadDisplayLabel,
   worktreeNameFromPath
-} from "./chunk-7PCTK4WO.js";
+} from "./chunk-FV6FN6V5.js";
 import {
   appendMessage,
   createEmptyThread,
@@ -83,7 +93,7 @@ import {
   updateThread,
   withThreadLock,
   writeThread
-} from "./chunk-ENSD62HW.js";
+} from "./chunk-O6W3P7V3.js";
 import {
   loadRepoSettings,
   loadWorkspaceSettings,
@@ -459,11 +469,14 @@ async function spawnAgentTurn(thread, input, onEvent) {
       `Cannot spawn ${thread.agent}: thread ${thread.id} has no worktreePath`
     );
   }
-  const { isGlobalThread: isGlobalThread2 } = await import("./global-workspace-FU6UIPDY.js");
+  const { isGlobalThread: isGlobalThread2 } = await import("./global-workspace-XFOXEQCP.js");
   if (isGlobalThread2(thread)) {
-    const { ensureGlobalCoordinatorCwd: ensureGlobalCoordinatorCwd2 } = await import("./coordinator-prompt-I5YNS27B.js");
+    const { ensureGlobalCoordinatorCwd: ensureGlobalCoordinatorCwd2 } = await import("./coordinator-prompt-2XFYG3C5.js");
     ensureGlobalCoordinatorCwd2();
   }
+  if (isOrchestratorThread(thread)) {
+    assertOrchestratorCapableAgent(thread.agent);
+  }
   const adapter = getAdapter(thread.agent);
   const cmd = await adapter.buildTurn(thread, input);
   if (cmd.cwd !== thread.worktreePath) {
@@ -2640,7 +2653,7 @@ async function createThread(input, onSetupLine) {
   return readThread(thread.id) ?? thread;
 }
 async function listLinearIssues(agent, repoPath) {
-  const { getAdapter: getAdapter2 } = await import("./agents-PP3URTSF.js");
+  const { getAdapter: getAdapter2 } = await import("./agents-6L6VENDT.js");
   await requireAgent(agent, { requireLinear: true });
   const adapter = getAdapter2(agent);
   if (!adapter.listLinearIssues) {
@@ -2712,6 +2725,10 @@ function createChatTab(input) {
   const binding = worktreeBindingFrom(from);
   const explicitTitle = input.title?.trim();
   const title = explicitTitle || allocateTeamName(takenTeamSlugsForChatTab(binding.worktreePath)).name;
+  const nextAgent = input.agent ?? from.agent;
+  if (isOrchestratorThread(from) || binding.sourceType === "orchestration") {
+    assertOrchestratorCapableAgent(nextAgent);
+  }
   const thread = createEmptyThread({
     title,
     // Chat-tab nicknames (soccer team or explicit) must stick. Post-turn
@@ -2719,7 +2736,7 @@ function createChatTab(input) {
     // shared worktree folder name (e.g. fork "Arsenal" → "Monaco").
     userSetTitle: true,
     ...binding,
-    agent: input.agent ?? from.agent,
+    agent: nextAgent,
     model: input.model !== void 0 ? input.model : input.agent && input.agent !== from.agent ? null : from.model,
     effort: input.effort !== void 0 ? input.effort : from.effort,
     fast: input.fast !== void 0 ? Boolean(input.fast) : from.fast,
@@ -2735,12 +2752,19 @@ function forkChatTab(input) {
   const from = requireThread(input.threadId);
   const slice = forkMessageSlice(from, input.throughIndex);
   const attachment = buildForkTranscriptAttachment(from.title || "Chat", slice);
-  return createChatTab({
+  const tab = createChatTab({
     fromThreadId: input.threadId,
     agent: input.agent ?? from.agent,
+    model: input.model,
     title: input.title?.trim() || void 0,
     attachments: [attachment]
   });
+  if (isOrchestratorThread(from) && tab.parentThreadId !== from.id) {
+    const next = { ...tab, parentThreadId: from.id };
+    writeThread(next);
+    return next;
+  }
+  return tab;
 }
 
 // src/threads/fork-worktree.ts
@@ -2751,16 +2775,28 @@ function requireThread2(idOrRef) {
 }
 async function forkThreadWorktree(input, onSetupLine) {
   const from = requireThread2(input.threadId);
+  if (isOrchestratorThread(from)) {
+    throw new Error(
+      "fork_worktree targets a worktree agent thread (not the orchestrator). Pass a child/worktree thread ref."
+    );
+  }
+  if (!from.branchName?.trim() || !from.repoPath?.trim()) {
+    throw new Error(
+      `Cannot fork worktree: thread ${from.id} has no branch/repo (need a real worktree chat).`
+    );
+  }
   const slice = forkMessageSlice(from, input.throughIndex);
   const attachment = buildForkTranscriptAttachment(from.title || "Chat", slice);
+  const nextAgent = input.agent ?? from.agent;
+  const nextModel = input.model !== void 0 ? input.model : input.agent && input.agent !== from.agent ? null : from.model;
   const thread = await createThread(
     {
       sourceType: "branch",
       sourceRef: from.branchName,
       repoPath: from.repoPath,
-      agent: input.agent ?? from.agent,
+      agent: nextAgent,
       autonomy: from.autonomy,
-      model: from.model,
+      model: nextModel,
       effort: from.effort,
       fast: from.fast,
       planMode: from.planMode,
@@ -2862,7 +2898,7 @@ async function adoptThread(input) {
     messages: input.messages ?? []
   });
   writeThread(thread);
-  const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-RSEDTBGJ.js");
+  const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-SRL2HZTB.js");
   await ensureWorkspace2(repoPath);
   return thread;
 }
@@ -3343,6 +3379,111 @@ async function requestReview(threadRef, send) {
 import { EventEmitter } from "events";
 import { existsSync as existsSync12 } from "fs";
 
+// src/orchestrator/quota-failover.ts
+import { randomUUID as randomUUID4 } from "crypto";
+function planOrchestrationQuotaFailover(thread, limitText, opts) {
+  if (!isOrchestratorThread(thread)) return null;
+  if (!isSessionQuotaLimit(limitText)) return null;
+  const onLimit = opts?.onLimit ?? orchestrationQuotaOnLimit();
+  const resumeAt = parseSessionQuotaResetAt(limitText, opts?.now);
+  if (thread.quotaContinuedFromId) {
+    if (resumeAt) {
+      return {
+        action: "wait_reset",
+        reason: "Already continued once; waiting for quota reset instead.",
+        limitText,
+        resumeAt
+      };
+    }
+    return {
+      action: "none",
+      reason: "Already continued once; no parseable reset time.",
+      limitText
+    };
+  }
+  if (onLimit === "wait_reset") {
+    if (!resumeAt) {
+      return {
+        action: "none",
+        reason: "wait_reset configured but reset time could not be parsed.",
+        limitText
+      };
+    }
+    return {
+      action: "wait_reset",
+      reason: "Settings: wait for quota reset.",
+      limitText,
+      resumeAt
+    };
+  }
+  const preferred = opts?.fallbackAgent ?? orchestrationQuotaFallbackAgent();
+  const fallbackAgent = resolveQuotaFallbackAgent(thread.agent, preferred);
+  return {
+    action: "switch_agent",
+    reason: `Continue on ${fallbackAgent} (Auto) after ${thread.agent} session limit.`,
+    limitText,
+    fallbackAgent
+  };
+}
+function buildQuotaHandoffAttachment(from, limitText, fallbackAgent) {
+  const children = listThreads({ includeArchived: false }).filter((t) => t.parentThreadId === from.id && t.status !== "archived").slice(0, 40).map(
+    (t) => `- ${t.title} \xB7 ${t.status} \xB7 ${t.agent} \xB7 sideboard://thread/${t.id}`
+  );
+  const recent = from.messages.slice(-8).map((m) => {
+    const role = m.role === "user" ? "User" : m.role === "agent" ? "Agent" : "Summary";
+    const text = m.text.trim().replace(/\s+/g, " ").slice(0, 280);
+    return text ? `- ${role}: ${text}` : null;
+  }).filter(Boolean);
+  const body = [
+    `# Orchestration handoff`,
+    "",
+    `Previous chat: ${from.title} (\`${from.id}\`) on **${from.agent}** hit a session/usage limit.`,
+    `Limit: ${limitText.trim()}`,
+    `Continuing on **${fallbackAgent}** with Auto model.`,
+    "",
+    `## Goal`,
+    from.sourceRef?.trim() || "(none)",
+    "",
+    `## Child threads`,
+    children.length ? children.join("\n") : "(none listed \u2014 call list_threads)",
+    "",
+    `## Recent turns (truncated)`,
+    recent.length ? recent.join("\n") : "(none)",
+    "",
+    `## Instructions`,
+    `- Continue fleet orchestration from this handoff.`,
+    `- Prefer Sideboard MCP (list_threads, get_thread, send_to_thread, \u2026) for live status.`,
+    `- Leave model Auto unless there is a specific reason to pin one.`,
+    `- Do not wait on the limited ${from.agent} account; keep going on ${fallbackAgent}.`
+  ].join("\n");
+  return {
+    id: randomUUID4(),
+    name: "Orchestration quota handoff.md",
+    kind: "transcript",
+    content: body
+  };
+}
+var QUOTA_CONTINUE_PROMPT = (fromAgent, fallback) => [
+  `${fromAgent} hit a session/usage limit. Continue this orchestration on ${fallback} using the attached handoff.`,
+  "Call list_threads for live fleet status, then proceed with the goal. Leave model Auto unless needed."
+].join(" ");
+var QUOTA_RESUME_PROMPT = "Session/usage limit window should have reset. Continue the orchestration from where you left off. Use list_threads for fleet status.";
+function createQuotaFailoverChat(from, fallbackAgent, limitText) {
+  const handoff = buildQuotaHandoffAttachment(from, limitText, fallbackAgent);
+  const tab = createChatTab({
+    fromThreadId: from.id,
+    agent: fallbackAgent,
+    model: null,
+    attachments: [handoff]
+  });
+  return updateThread(tab.id, {
+    parentThreadId: from.id,
+    quotaContinuedFromId: from.id,
+    sourceRef: from.sourceRef,
+    sourceType: "orchestration"
+  });
+}
+
 // src/threads/sync-branch.ts
 async function syncThreadBranchFromGit(threadId) {
   const thread = readThread(threadId);
@@ -3403,6 +3544,8 @@ var Orchestrator = class {
   haltDrain = /* @__PURE__ */ new Set();
   /** WIP snapshot SHA at the start of the latest agent turn (per thread). */
   turnBaselines = /* @__PURE__ */ new Map();
+  /** Timers for orchestration session-quota auto-resume. */
+  quotaResumeTimers = /* @__PURE__ */ new Map();
   maxConcurrent;
   runningCount = 0;
   constructor(opts) {
@@ -3471,7 +3614,7 @@ var Orchestrator = class {
           orphans: orphans.map((o) => ({ path: o.path, repoPath: o.repoPath }))
         });
       }
-      const { autoCleanupOrphansEnabled } = await import("./app-settings-ZKVZHJPQ.js");
+      const { autoCleanupOrphansEnabled } = await import("./app-settings-LZP632KI.js");
       if (autoCleanupOrphansEnabled() && shouldRunWorktreeCleanup() && orphans.length > 0) {
         await cleanupOrphanWorktrees({ repoPaths });
       }
@@ -3482,6 +3625,113 @@ var Orchestrator = class {
         void this.drainQueue(thread.id);
       }
     }
+    this.schedulePendingQuotaResumes();
+  }
+  clearQuotaResumeTimer(threadId) {
+    const timer = this.quotaResumeTimers.get(threadId);
+    if (timer) clearTimeout(timer);
+    this.quotaResumeTimers.delete(threadId);
+  }
+  /** Schedule (or fire) auto-retry after a provider session/usage limit reset. */
+  scheduleQuotaResume(threadId, resumeAt) {
+    this.clearQuotaResumeTimer(threadId);
+    updateThread(threadId, { quotaResumeAt: resumeAt.toISOString() });
+    const delay = Math.max(5e3, resumeAt.getTime() - Date.now());
+    const capped = Math.min(delay, 2147483647);
+    const timer = setTimeout(() => {
+      this.quotaResumeTimers.delete(threadId);
+      void this.resumeAfterQuotaWait(threadId);
+    }, capped);
+    this.quotaResumeTimers.set(threadId, timer);
+  }
+  schedulePendingQuotaResumes() {
+    for (const thread of listThreads({ includeArchived: false })) {
+      if (!thread.quotaResumeAt) continue;
+      const at = new Date(thread.quotaResumeAt);
+      if (Number.isNaN(at.getTime())) continue;
+      if (at.getTime() <= Date.now()) {
+        void this.resumeAfterQuotaWait(thread.id);
+      } else if (!this.quotaResumeTimers.has(thread.id)) {
+        this.scheduleQuotaResume(thread.id, at);
+      }
+    }
+  }
+  async resumeAfterQuotaWait(threadId) {
+    const thread = findThreadByRef(threadId);
+    if (!thread || thread.status === "archived") return;
+    this.clearQuotaResumeTimer(threadId);
+    try {
+      updateThread(threadId, { quotaResumeAt: null });
+    } catch {
+      return;
+    }
+    if (thread.status === "running" || this.activeTurns.has(threadId) || this.startingTurns.has(threadId)) {
+      return;
+    }
+    await this.send(threadId, QUOTA_RESUME_PROMPT);
+  }
+  /**
+   * Host-side continue when an orchestration chat hits a provider session/usage
+   * limit (not context size): switch agent (Auto) or wait until reset.
+   */
+  async maybeHandleOrchestrationQuotaFailover(threadId, limitText) {
+    const thread = findThreadByRef(threadId);
+    if (!thread) return;
+    const plan = planOrchestrationQuotaFailover(thread, limitText);
+    if (!plan || plan.action === "none") return;
+    if (plan.action === "wait_reset" && plan.resumeAt) {
+      this.haltDrain.add(threadId);
+      this.scheduleQuotaResume(threadId, plan.resumeAt);
+      setStatus(threadId, "idle", null);
+      appendMessage(threadId, {
+        role: "agent",
+        text: `Sideboard will auto-retry this orchestration around ${plan.resumeAt.toLocaleString()} when the session limit resets.`,
+        ts: (/* @__PURE__ */ new Date()).toISOString()
+      });
+      this.emit({
+        type: "quota_failover",
+        threadId,
+        action: "wait_reset",
+        message: plan.reason,
+        resumeAt: plan.resumeAt.toISOString()
+      });
+      this.emit({ type: "status_changed", threadId, status: "idle" });
+      return;
+    }
+    if (plan.action === "switch_agent" && plan.fallbackAgent) {
+      this.haltDrain.add(threadId);
+      const next = createQuotaFailoverChat(
+        thread,
+        plan.fallbackAgent,
+        plan.limitText
+      );
+      this.clearQuotaResumeTimer(threadId);
+      try {
+        updateThread(threadId, { quotaResumeAt: null });
+      } catch {
+      }
+      appendMessage(threadId, {
+        role: "agent",
+        text: `Session limit on ${thread.agent}. Sideboard continued on ${plan.fallbackAgent} (Auto) in [${next.title}](sideboard://thread/${next.id}).`,
+        ts: (/* @__PURE__ */ new Date()).toISOString()
+      });
+      this.emit({
+        type: "quota_failover",
+        threadId,
+        action: "switch_agent",
+        toThreadId: next.id,
+        message: plan.reason
+      });
+      this.emit({
+        type: "status_changed",
+        threadId: next.id,
+        status: next.status
+      });
+      await this.send(
+        next.id,
+        QUOTA_CONTINUE_PROMPT(thread.agent, plan.fallbackAgent)
+      );
+    }
   }
   getThreads(includeArchived = false) {
     return listThreads({ includeArchived });
@@ -3498,7 +3748,7 @@ var Orchestrator = class {
       });
     });
     this.emit({ type: "status_changed", threadId: thread.id, status: thread.status });
-    const { autoRunAfterSetupEnabled } = await import("./app-settings-ZKVZHJPQ.js");
+    const { autoRunAfterSetupEnabled } = await import("./app-settings-LZP632KI.js");
     if (autoRunAfterSetupEnabled()) {
       try {
         await this.startDev(thread.id);
@@ -3744,7 +3994,7 @@ var Orchestrator = class {
     });
     const artifactDirective = isBrightsy ? null : formatArtifactDirective();
     const settings = loadWorkspaceSettings(fresh.worktreePath, fresh.repoPath);
-    const { autoRenameBranchEnabled } = await import("./app-settings-ZKVZHJPQ.js");
+    const { autoRenameBranchEnabled } = await import("./app-settings-LZP632KI.js");
     const renameBranchDirective = !isBrightsy && !isOrchestration && autoRenameBranchEnabled() ? formatRenameBranchDirective(fresh, {
       customPrompt: settings?.prompts?.renameBranch
     }) : null;
@@ -3840,11 +4090,16 @@ var Orchestrator = class {
           }
         }
       }
-      const failureOnlyMessage = exitCode !== 0 && looksLikeAgentFailureMessage(assistantText) && !parts.some((p) => p.type === "tool" || p.type === "thinking");
-      if (!failureOnlyMessage && (assistantText || parts.length > 0)) {
+      const lastStderr = summarizeTurnStderr(stderrTail);
+      const detail = lastStderr || (exitCode !== 0 ? fallbackTurnFailDetail(assistantText) : "");
+      let chatText = assistantText;
+      if (exitCode !== 0 && !chatText && looksLikeAgentFailureMessage(detail)) {
+        chatText = humanizeAgentFailDetail(detail);
+      }
+      if (chatText || parts.length > 0) {
         appendMessage(threadId, {
           role: "agent",
-          text: assistantText,
+          text: chatText,
           parts: parts.length > 0 ? parts : void 0,
           durationMs: Math.max(0, Date.now() - turnStartedAt),
           usage,
@@ -3863,13 +4118,12 @@ var Orchestrator = class {
         this.emit({ type: "status_changed", threadId, status: "stopped" });
         this.emit({ type: "turn_finished", threadId, exitCode });
       } else {
-        const lastStderr = summarizeTurnStderr(stderrTail);
-        const detail = lastStderr || (exitCode !== 0 ? fallbackTurnFailDetail(assistantText) : "");
         const failDetail = formatTurnExitError(exitCode, detail);
+        const explainedInChat = exitCode !== 0 && Boolean(chatText) && (looksLikeAgentFailureMessage(chatText) || failDetail && chatText.includes(failDetail.replace(/^exit\s*\d+:\s*/i, "").trim()));
         setStatus(
           threadId,
           exitCode === 0 ? "idle" : "error",
-          exitCode === 0 ? null : failDetail
+          exitCode === 0 || explainedInChat ? null : failDetail
         );
         this.emit({
           type: "status_changed",
@@ -3877,6 +4131,10 @@ var Orchestrator = class {
           status: exitCode === 0 ? "idle" : "error"
         });
         this.emit({ type: "turn_finished", threadId, exitCode });
+        if (exitCode !== 0) {
+          const blob = [chatText, detail].filter(Boolean).join("\n");
+          void this.maybeHandleOrchestrationQuotaFailover(threadId, blob);
+        }
       }
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
@@ -3890,6 +4148,7 @@ var Orchestrator = class {
         this.emit({ type: "error", threadId, message });
         this.emit({ type: "status_changed", threadId, status: "error" });
         this.emit({ type: "turn_finished", threadId, exitCode: 1 });
+        void this.maybeHandleOrchestrationQuotaFailover(threadId, message);
       }
     } finally {
       this.startingTurns.delete(threadId);
@@ -4374,6 +4633,9 @@ var Orchestrator = class {
             `Cannot switch agent provider mid-chat (${thread.agent} \u2192 ${patch.agent}). Start a new chat tab instead.`
           );
         }
+        if (isOrchestratorThread(thread)) {
+          assertOrchestratorCapableAgent(patch.agent);
+        }
         next.agent = patch.agent;
         if (patch.agent !== "claude" && patch.model === void 0) next.model = null;
         next.sessionId = null;
@@ -4465,7 +4727,7 @@ var Orchestrator = class {
         await runArchiveScript(thread.repoPath, thread.worktreePath);
       } catch {
       }
-      const { deleteBranchOnPurgeEnabled } = await import("./app-settings-ZKVZHJPQ.js");
+      const { deleteBranchOnPurgeEnabled } = await import("./app-settings-LZP632KI.js");
       const deleteBranch = opts?.deleteBranch ?? deleteBranchOnPurgeEnabled();
       await removeWorktree(thread.repoPath, thread.worktreePath, {
         deleteBranch: deleteBranch ? thread.branchName : void 0
@@ -4484,7 +4746,7 @@ var Orchestrator = class {
       return setStatus(thread.id, "idle");
     }
     if (!existsSync12(thread.worktreePath)) {
-      const { createThreadWorktree: createThreadWorktree2 } = await import("./worktree-N4PRV4V3.js");
+      const { createThreadWorktree: createThreadWorktree2 } = await import("./worktree-TEDAJ57S.js");
       const { execa: execa6 } = await import("execa");
       const slug = thread.worktreePath.split("/").pop();
       const dest = thread.worktreePath;
@@ -4569,7 +4831,7 @@ async function startOrchestration(opts) {
     sourceRef: "default",
     ...createOpts
   }).catch(async () => {
-    const { resolveDefaultBranch: resolveDefaultBranch2, resolveRepoRoot: resolveRepoRoot2 } = await import("./worktree-N4PRV4V3.js");
+    const { resolveDefaultBranch: resolveDefaultBranch2, resolveRepoRoot: resolveRepoRoot2 } = await import("./worktree-TEDAJ57S.js");
     const repo = await resolveRepoRoot2(repoPath);
     const def = await resolveDefaultBranch2(repo);
     return createThread({
@@ -4579,7 +4841,7 @@ async function startOrchestration(opts) {
       repoPath: repo
     });
   });
-  const { updateThread: upd } = await import("./thread-store-EHROA3VZ.js");
+  const { updateThread: upd } = await import("./thread-store-OV2X6PYO.js");
   const updated = upd(thread.id, {
     sourceType: "orchestration",
     sourceRef: goal
@@ -5010,6 +5272,120 @@ async function startMcpServer() {
       }
     }
   );
+  const agentEnum = z.enum(["claude", "codex", "opencode", "brightsy", "cursor"]);
+  server.tool(
+    "list_models",
+    "List models for an agent. Prefer Auto: do not call this unless you have a reason to pin a specific model (user request, cost/latency, capability). Omit agent to list all.",
+    {
+      agent: agentEnum.optional().describe("Limit to one agent; omit for all")
+    },
+    async ({ agent }) => {
+      try {
+        const catalogs = await listModelsForAgent(agent);
+        return {
+          content: [{ type: "text", text: JSON.stringify(catalogs, null, 2) }]
+        };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: message }], isError: true };
+      }
+    }
+  );
+  server.tool(
+    "fork_worktree",
+    "Fork a worktree agent chat into a NEW git worktree + chat (desktop \u201CFork to new workspace\u201D). Seeds a transcript (through through_index, default all). Optional agent override. Leave model unset for Auto (default) \u2014 only pass model when you have a reason. Not for the orchestrator. Then send_to_thread / wait_for_turn on the returned id.",
+    {
+      ref: z.string().describe("Worktree thread id/ref to fork"),
+      through_index: z.number().optional().describe("Inclusive message index to include in the transcript (default: all)"),
+      agent: agentEnum.optional().describe("Agent for the forked chat (default: same as source)"),
+      model: z.string().nullable().optional().describe("Usually omit (Auto). Only set from list_models when you need a specific model"),
+      title: z.string().optional()
+    },
+    async ({ ref, through_index, agent, model, title }) => {
+      try {
+        const source = orch.getThread(ref);
+        if (source) await orch.reconcile(source.repoPath);
+        const thread = await orch.forkThreadWorktree({
+          threadId: ref,
+          throughIndex: through_index,
+          agent,
+          model,
+          title
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({
+                id: thread.id,
+                title: thread.title,
+                status: thread.status,
+                agent: thread.agent,
+                model: thread.model,
+                branchName: thread.branchName,
+                worktreePath: thread.worktreePath,
+                fromThreadId: source?.id ?? ref,
+                link: `sideboard://thread/${thread.id}`
+              })
+            }
+          ]
+        };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: message }], isError: true };
+      }
+    }
+  );
+  server.tool(
+    "fork_chat",
+    "Fork a chat into a NEW tab on the SAME workspace: worktree agent \u2192 same worktree tab; Global orchestration chat \u2192 new orchestration chat (same synthetic home). Seeds a transcript; optional agent override. Leave model unset for Auto unless you have a reason. Orchestration forks require an MCP-capable agent (claude, cursor, codex, opencode \u2014 not brightsy). Remote coordinators use this to continue an orchestration chat on another agent after session limits. Then send_to_thread / wait_for_turn on the returned id. Use fork_worktree only for worktree agents that need a new git worktree.",
+    {
+      ref: z.string().describe("Thread id/ref to fork (worktree agent or orchestration chat)"),
+      through_index: z.number().optional().describe("Inclusive message index to include in the transcript (default: all)"),
+      agent: agentEnum.optional().describe("Agent for the forked chat (default: same as source)"),
+      model: z.string().nullable().optional().describe("Usually omit (Auto). Only set from list_models when you need a specific model"),
+      title: z.string().optional()
+    },
+    async ({ ref, through_index, agent, model, title }) => {
+      try {
+        const source = orch.getThread(ref);
+        if (!source) {
+          return {
+            content: [{ type: "text", text: `Thread not found: ${ref}` }],
+            isError: true
+          };
+        }
+        const tab = orch.forkChatTab({
+          threadId: source.id,
+          throughIndex: through_index,
+          agent,
+          model,
+          title
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({
+                id: tab.id,
+                title: tab.title,
+                status: tab.status,
+                agent: tab.agent,
+                model: tab.model,
+                sourceType: tab.sourceType,
+                worktreePath: tab.worktreePath,
+                fromThreadId: source.id,
+                link: `sideboard://thread/${tab.id}`
+              })
+            }
+          ]
+        };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: message }], isError: true };
+      }
+    }
+  );
   server.tool(
     "run_dev_script",
     "Start a .sideboard/.conductor run script for a thread (default script if name omitted); returns port",

package/dist/{chunk-7PCTK4WO.js → chunk-FV6FN6V5.js}

@@ -1,6 +1,6 @@
 import {
   listThreads
-} from "./chunk-ENSD62HW.js";
+} from "./chunk-O6W3P7V3.js";
 import {
   worktreesRoot
 } from "./chunk-M37RITA6.js";