@sideboard-ai/core 0.1.38 → 0.1.41

package/dist/index.cjs

@@ -801,6 +801,7 @@ function normalizeThread(raw) {
     planMode: Boolean(raw.planMode),
     autonomy: raw.autonomy ?? "default",
     lastError: raw.lastError ?? null,
+    agentPid: raw.agentPid ?? null,
     attachments: Array.isArray(raw.attachments) ? raw.attachments : [],
     prTitle: raw.prTitle ?? null,
     userSetTitle: Boolean(raw.userSetTitle),
@@ -836,7 +837,8 @@ function createEmptyThread(partial) {
     worktreePath: partial.worktreePath,
     repoPath: partial.repoPath,
     agent: partial.agent,
-    lastError: null
+    lastError: null,
+    agentPid: null
   };
 }
 async function withThreadLock(id, fn) {
@@ -5857,6 +5859,53 @@ var init_agents = __esm({
   }
 });
 
+// src/agents/cursor-recover.ts
+var cursor_recover_exports = {};
+__export(cursor_recover_exports, {
+  recoverFinishedCursorRun: () => recoverFinishedCursorRun
+});
+function recoverFinishedCursorRun(opts) {
+  const agentId = opts.agentId.trim();
+  if (!agentId) return null;
+  const runsPath = (0, import_node_path23.join)(appDataDir(), "cursor-sdk-store", "runs.ndjson");
+  if (!(0, import_node_fs24.existsSync)(runsPath)) return null;
+  try {
+    const lines = (0, import_node_fs24.readFileSync)(runsPath, "utf8").split("\n");
+    let best = null;
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      let row;
+      try {
+        row = JSON.parse(trimmed);
+      } catch {
+        continue;
+      }
+      if (row.agentId !== agentId) continue;
+      if (row.status !== "finished") continue;
+      if (typeof row.result !== "string" || !row.result.trim()) continue;
+      const endedAt = typeof row.endedAt === "number" ? row.endedAt : 0;
+      const createdAt = typeof row.createdAt === "number" ? row.createdAt : 0;
+      if (createdAt < opts.startedAfterMs && endedAt < opts.startedAfterMs) continue;
+      if (!best || endedAt >= best.endedAt) {
+        best = { runId: row.runId || "", result: row.result.trim(), endedAt };
+      }
+    }
+    return best;
+  } catch {
+    return null;
+  }
+}
+var import_node_fs24, import_node_path23;
+var init_cursor_recover = __esm({
+  "src/agents/cursor-recover.ts"() {
+    "use strict";
+    import_node_fs24 = require("fs");
+    import_node_path23 = require("path");
+    init_paths();
+  }
+});
+
 // src/threads/title.ts
 var title_exports = {};
 __export(title_exports, {
@@ -5907,6 +5956,8 @@ __export(index_exports, {
   HARNESS_ENV_KEYS: () => HARNESS_ENV_KEYS,
   MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS: () => MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS,
   Orchestrator: () => Orchestrator,
+  PASTE_ATTACH_MIN_CHARS: () => PASTE_ATTACH_MIN_CHARS,
+  PASTE_ATTACH_MIN_LINES: () => PASTE_ATTACH_MIN_LINES,
   PLAN_MODE_INSTRUCTION: () => PLAN_MODE_INSTRUCTION,
   SIDEBOARD_FORCE_STOP: () => SIDEBOARD_FORCE_STOP,
   SIDEBOARD_MCP_ALLOWED_TOOLS: () => SIDEBOARD_MCP_ALLOWED_TOOLS,
@@ -5941,6 +5992,7 @@ __export(index_exports, {
   buildClaudeStreamJsonUserMessage: () => buildClaudeStreamJsonUserMessage,
   buildDiffCommentAttachment: () => buildDiffCommentAttachment,
   buildForkTranscriptAttachment: () => buildForkTranscriptAttachment,
+  buildPastedTextAttachment: () => buildPastedTextAttachment,
   buildSessionSeed: () => buildSessionSeed,
   buildWorkspaceScriptEnv: () => buildWorkspaceScriptEnv,
   caffeinateWhileCloudConnectEnabled: () => caffeinateWhileCloudConnectEnabled,
@@ -6057,6 +6109,7 @@ __export(index_exports, {
   isImageFilePath: () => isImageFilePath,
   isLinearConnected: () => isLinearConnected,
   isOrchestratorThread: () => isOrchestratorThread,
+  isPidAlive: () => isPidAlive,
   isPlaceholderBranch: () => isPlaceholderBranch,
   listAgentSetupInfo: () => listAgentSetupInfo,
   listBranchCommits: () => listBranchCommits,
@@ -6094,6 +6147,7 @@ __export(index_exports, {
   mcpAuthWarnings: () => mcpAuthWarnings,
   mergePr: () => mergePr,
   mergeUsage: () => mergeUsage,
+  nextPastedTextName: () => nextPastedTextName,
   normalizeParseResult: () => normalizeParseResult,
   normalizeThread: () => normalizeThread,
   normalizeTurnInput: () => normalizeTurnInput,
@@ -6108,6 +6162,7 @@ __export(index_exports, {
   parseGithubSlugFromRemoteUrl: () => parseGithubSlugFromRemoteUrl,
   parseMcpList: () => parseMcpList,
   partsToAssistantText: () => partsToAssistantText,
+  pastedTextStats: () => pastedTextStats,
   permissionMode: () => permissionMode,
   previewLand: () => previewLand,
   pushBranch: () => pushBranch,
@@ -6143,6 +6198,7 @@ __export(index_exports, {
   saveAppSettings: () => saveAppSettings,
   setStatus: () => setStatus,
   settingsSourceLabel: () => settingsSourceLabel,
+  shouldAttachPastedText: () => shouldAttachPastedText,
   shouldCompactContext: () => shouldCompactContext,
   shouldRunWorktreeCleanup: () => shouldRunWorktreeCleanup,
   sideboardHomeDir: () => sideboardHomeDir,
@@ -6479,12 +6535,20 @@ function diffFromInput(input) {
 }
 function parseDiffStat(result) {
   if (!result) return {};
-  const plus = result.match(/\+(\d+)/);
-  const minus = result.match(/-(\d+)/);
-  if (plus || minus) {
+  const paired = result.match(/\+(\d+)\s+-(\d+)/);
+  if (paired) {
+    return {
+      additions: Number(paired[1]),
+      deletions: Number(paired[2])
+    };
+  }
+  const verbose = result.match(
+    /(\d+)\s+insertions?(?:,\s*(\d+)\s+deletions?)?/i
+  );
+  if (verbose) {
     return {
-      additions: plus ? Number(plus[1]) : void 0,
-      deletions: minus ? Number(minus[1]) : void 0
+      additions: Number(verbose[1]),
+      deletions: verbose[2] != null ? Number(verbose[2]) : void 0
     };
   }
   return {};
@@ -6556,8 +6620,8 @@ function applyAgentEvent(parts, event) {
         ...p,
         status: event.isError ? "error" : "done",
         result: event.content,
-        additions: fromResult.additions ?? p.additions,
-        deletions: fromResult.deletions ?? p.deletions
+        ...fromResult.additions != null ? { additions: fromResult.additions } : {},
+        ...fromResult.deletions != null ? { deletions: fromResult.deletions } : {}
       };
     });
     return next;
@@ -8323,6 +8387,42 @@ function attachmentsFromWorktreePaths(worktreePath, relativePaths) {
   return out;
 }
 
+// src/composer/pasted-text.ts
+var import_node_crypto3 = require("crypto");
+var PASTE_ATTACH_MIN_CHARS = 1200;
+var PASTE_ATTACH_MIN_LINES = 15;
+var PASTED_NAME_RE = /^Pasted text #(\d+)\.txt$/i;
+var PASTED_NAME_ALT_RE = /^pasted-(\d+)\.txt$/i;
+function pastedTextStats(text) {
+  const chars = text.length;
+  if (chars === 0) return { chars: 0, lines: 0 };
+  const lines = text.split(/\r\n|\r|\n/).length;
+  return { chars, lines };
+}
+function shouldAttachPastedText(text) {
+  const trimmed = text.trim();
+  if (!trimmed) return false;
+  const { chars, lines } = pastedTextStats(text);
+  return chars >= PASTE_ATTACH_MIN_CHARS || lines >= PASTE_ATTACH_MIN_LINES;
+}
+function nextPastedTextName(existing) {
+  let max = 0;
+  for (const a of existing) {
+    const m = PASTED_NAME_RE.exec(a.name) ?? PASTED_NAME_ALT_RE.exec(a.name);
+    if (m?.[1]) max = Math.max(max, Number(m[1]));
+  }
+  return `Pasted text #${max + 1}.txt`;
+}
+function buildPastedTextAttachment(text, opts) {
+  return {
+    id: opts?.id ?? (0, import_node_crypto3.randomUUID)(),
+    name: opts?.name ?? "Pasted text #1.txt",
+    kind: "file",
+    path: opts?.path,
+    content: text
+  };
+}
+
 // src/composer/summarize.ts
 init_run();
 init_path();
@@ -8851,7 +8951,7 @@ async function listLinearIssues(agent, repoPath) {
 }
 
 // src/threads/chat-tabs.ts
-var import_node_crypto3 = require("crypto");
+var import_node_crypto4 = require("crypto");
 init_teams();
 init_worktree_labels();
 init_global_workspace();
@@ -8907,7 +9007,7 @@ function forkMessageSlice(from, throughIndex) {
 function buildForkTranscriptAttachment(baseTitle, messages) {
   const title = baseTitle || "Chat";
   return {
-    id: (0, import_node_crypto3.randomUUID)(),
+    id: (0, import_node_crypto4.randomUUID)(),
     name: `Transcript of ${title}.md`,
     kind: "transcript",
     content: formatTranscriptMarkdown(title, messages)
@@ -9262,7 +9362,7 @@ async function importConductorWorkspaceAsync(workspaceId) {
 
 // src/orchestrator/orchestrator.ts
 var import_node_events = require("events");
-var import_node_fs24 = require("fs");
+var import_node_fs25 = require("fs");
 init_error_detail();
 init_agents();
 init_worktree();
@@ -9546,6 +9646,15 @@ async function syncThreadBranchFromGit(threadId) {
 init_workspaces();
 init_global_workspace();
 init_coordinator_prompt();
+function isPidAlive(pid) {
+  if (!Number.isFinite(pid) || pid <= 0) return false;
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
 var Orchestrator = class {
   events = new import_node_events.EventEmitter();
   processes = /* @__PURE__ */ new Map();
@@ -9582,8 +9691,18 @@ var Orchestrator = class {
   isStaleRunningThread(threadId, status) {
     return status === "running" && !this.activeTurns.has(threadId) && !this.startingTurns.has(threadId);
   }
+  /**
+   * Cross-process guard: another Sideboard process (MCP stdio) may call reconcile
+   * while the desktop still owns a live agent child. Never reclaim those.
+   */
+  shouldReclaimRunningThread(thread) {
+    if (!this.isStaleRunningThread(thread.id, thread.status)) return false;
+    const pid = thread.agentPid;
+    if (typeof pid === "number" && pid > 0 && isPidAlive(pid)) return false;
+    return true;
+  }
   async reconcile(repoPath, opts) {
-    const reclaimStaleTurns = opts?.reclaimStaleTurns !== false;
+    const reclaimStaleTurns = opts?.reclaimStaleTurns === true;
     healOrchestrationSoccerTitles();
     for (const thread of listThreads({ includeArchived: true })) {
       if (thread.status === "archived") continue;
@@ -9599,18 +9718,18 @@ var Orchestrator = class {
         if (Object.keys(heal).length) {
           updateThread(thread.id, heal);
         }
-        if (reclaimStaleTurns && this.isStaleRunningThread(thread.id, thread.status)) {
+        if (reclaimStaleTurns && this.shouldReclaimRunningThread(thread)) {
           setStatus(thread.id, "stopped", "Process died (reconciled on startup)");
           this.emit({ type: "status_changed", threadId: thread.id, status: "stopped" });
         }
         continue;
       }
-      if (!(0, import_node_fs24.existsSync)(thread.worktreePath)) {
+      if (!(0, import_node_fs25.existsSync)(thread.worktreePath)) {
         setStatus(thread.id, "broken", "Worktree missing on disk");
         this.emit({ type: "status_changed", threadId: thread.id, status: "broken" });
         continue;
       }
-      if (reclaimStaleTurns && this.isStaleRunningThread(thread.id, thread.status)) {
+      if (reclaimStaleTurns && this.shouldReclaimRunningThread(thread)) {
         setStatus(thread.id, "stopped", "Process died (reconciled on startup)");
         this.emit({ type: "status_changed", threadId: thread.id, status: "stopped" });
       }
@@ -9792,6 +9911,11 @@ var Orchestrator = class {
           await new Promise((r) => setTimeout(r, 100));
           continue;
         }
+        const livePid = thread.agentPid;
+        if (typeof livePid === "number" && livePid > 0 && isPidAlive(livePid)) {
+          await new Promise((r) => setTimeout(r, 200));
+          continue;
+        }
         const prompt = thread.queue[0];
         const remaining = thread.queue.slice(1);
         updateThread(threadId, { queue: remaining });
@@ -9935,10 +10059,18 @@ var Orchestrator = class {
           if (event.type === "stderr" && typeof event.data === "string") {
             pushTurnStderr(stderrTail, event.data);
           }
+          const live = readThread(threadId);
+          if (live?.lastError?.includes("reconciled on startup") && (this.activeTurns.has(threadId) || this.startingTurns.has(threadId))) {
+            setStatus(threadId, "running");
+            this.emit({ type: "status_changed", threadId, status: "running" });
+          }
         }
       );
       this.activeTurns.set(threadId, handle);
       this.startingTurns.delete(threadId);
+      if (typeof handle.pid === "number" && handle.pid > 0) {
+        updateThread(threadId, { agentPid: handle.pid });
+      }
       if (this.stoppedTurns.has(threadId)) {
         handle.kill();
       } else {
@@ -9958,20 +10090,41 @@ var Orchestrator = class {
       if (result.sessionId) {
         updateThread(threadId, { sessionId: result.sessionId });
       }
-      const assistantText = result.assistantText.trim();
-      const failureOnlyMessage = result.exitCode !== 0 && looksLikeAgentFailureMessage(assistantText) && !result.parts.some((p) => p.type === "tool" || p.type === "thinking");
-      if (!failureOnlyMessage && (assistantText || result.parts.length > 0)) {
+      let assistantText = result.assistantText.trim();
+      let parts = result.parts;
+      let usage = result.usage ?? void 0;
+      let exitCode = result.exitCode;
+      if (this.requireThread(threadId).agent === "cursor" && exitCode !== 0 && !assistantText && parts.length === 0) {
+        const sessionId = result.sessionId || this.requireThread(threadId).sessionId || "";
+        if (sessionId) {
+          const { recoverFinishedCursorRun: recoverFinishedCursorRun2 } = await Promise.resolve().then(() => (init_cursor_recover(), cursor_recover_exports));
+          for (let i = 0; i < 8; i++) {
+            const recovered = recoverFinishedCursorRun2({
+              agentId: sessionId,
+              startedAfterMs: turnStartedAt - 5e3
+            });
+            if (recovered?.result) {
+              assistantText = recovered.result;
+              exitCode = 0;
+              break;
+            }
+            await new Promise((r) => setTimeout(r, 500));
+          }
+        }
+      }
+      const failureOnlyMessage = exitCode !== 0 && looksLikeAgentFailureMessage(assistantText) && !parts.some((p) => p.type === "tool" || p.type === "thinking");
+      if (!failureOnlyMessage && (assistantText || parts.length > 0)) {
         appendMessage(threadId, {
           role: "agent",
           text: assistantText,
-          parts: result.parts.length > 0 ? result.parts : void 0,
+          parts: parts.length > 0 ? parts : void 0,
           durationMs: Math.max(0, Date.now() - turnStartedAt),
-          usage: result.usage ?? void 0,
+          usage,
           ts: (/* @__PURE__ */ new Date()).toISOString()
         });
       }
       const afterTurn = this.requireThread(threadId);
-      if (afterTurn.planMode && afterTurn.agent === "claude" && result.parts.some(
+      if (afterTurn.planMode && afterTurn.agent === "claude" && parts.some(
         (p) => p.type === "tool" && /exitplanmode/i.test(p.name)
       )) {
         updateThread(threadId, { sessionId: null });
@@ -9980,22 +10133,22 @@ var Orchestrator = class {
       if (this.stoppedTurns.has(threadId)) {
         setStatus(threadId, "stopped");
         this.emit({ type: "status_changed", threadId, status: "stopped" });
-        this.emit({ type: "turn_finished", threadId, exitCode: result.exitCode });
+        this.emit({ type: "turn_finished", threadId, exitCode });
       } else {
         const lastStderr = summarizeTurnStderr(stderrTail);
-        const detail = lastStderr || (result.exitCode !== 0 ? fallbackTurnFailDetail(assistantText) : "");
-        const failDetail = formatTurnExitError(result.exitCode, detail);
+        const detail = lastStderr || (exitCode !== 0 ? fallbackTurnFailDetail(assistantText) : "");
+        const failDetail = formatTurnExitError(exitCode, detail);
         setStatus(
           threadId,
-          result.exitCode === 0 ? "idle" : "error",
-          result.exitCode === 0 ? null : failDetail
+          exitCode === 0 ? "idle" : "error",
+          exitCode === 0 ? null : failDetail
         );
         this.emit({
           type: "status_changed",
           threadId,
-          status: result.exitCode === 0 ? "idle" : "error"
+          status: exitCode === 0 ? "idle" : "error"
         });
-        this.emit({ type: "turn_finished", threadId, exitCode: result.exitCode });
+        this.emit({ type: "turn_finished", threadId, exitCode });
       }
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
@@ -10016,6 +10169,10 @@ var Orchestrator = class {
       this.processes.delete(`${threadId}:agent`);
       this.stoppedTurns.delete(threadId);
       this.runningCount = Math.max(0, this.runningCount - 1);
+      try {
+        updateThread(threadId, { agentPid: null });
+      } catch {
+      }
     }
   }
   /**
@@ -10588,7 +10745,7 @@ var Orchestrator = class {
       updateThread(thread.id, { worktreePath: globalAgentCwd2() });
       return setStatus(thread.id, "idle");
     }
-    if (!(0, import_node_fs24.existsSync)(thread.worktreePath)) {
+    if (!(0, import_node_fs25.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();
@@ -10700,7 +10857,7 @@ init_coordinator_prompt();
 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_path23 = require("path");
+var import_node_path24 = require("path");
 init_worktree();
 init_global_workspace();
 
@@ -10748,7 +10905,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_path23.basename)(t.repoPath) || t.repoPath;
+        const repo = t.repoPath === GLOBAL_WORKSPACE_ID ? "Orchestration" : (0, import_node_path24.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 {
@@ -11631,6 +11788,8 @@ init_injected_mcp();
   HARNESS_ENV_KEYS,
   MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS,
   Orchestrator,
+  PASTE_ATTACH_MIN_CHARS,
+  PASTE_ATTACH_MIN_LINES,
   PLAN_MODE_INSTRUCTION,
   SIDEBOARD_FORCE_STOP,
   SIDEBOARD_MCP_ALLOWED_TOOLS,
@@ -11665,6 +11824,7 @@ init_injected_mcp();
   buildClaudeStreamJsonUserMessage,
   buildDiffCommentAttachment,
   buildForkTranscriptAttachment,
+  buildPastedTextAttachment,
   buildSessionSeed,
   buildWorkspaceScriptEnv,
   caffeinateWhileCloudConnectEnabled,
@@ -11781,6 +11941,7 @@ init_injected_mcp();
   isImageFilePath,
   isLinearConnected,
   isOrchestratorThread,
+  isPidAlive,
   isPlaceholderBranch,
   listAgentSetupInfo,
   listBranchCommits,
@@ -11818,6 +11979,7 @@ init_injected_mcp();
   mcpAuthWarnings,
   mergePr,
   mergeUsage,
+  nextPastedTextName,
   normalizeParseResult,
   normalizeThread,
   normalizeTurnInput,
@@ -11832,6 +11994,7 @@ init_injected_mcp();
   parseGithubSlugFromRemoteUrl,
   parseMcpList,
   partsToAssistantText,
+  pastedTextStats,
   permissionMode,
   previewLand,
   pushBranch,
@@ -11867,6 +12030,7 @@ init_injected_mcp();
   saveAppSettings,
   setStatus,
   settingsSourceLabel,
+  shouldAttachPastedText,
   shouldCompactContext,
   shouldRunWorktreeCleanup,
   sideboardHomeDir,

package/dist/index.d.cts

@@ -92,6 +92,11 @@ interface Thread {
     /** Pending composer attachments (forked transcripts, etc.). */
     attachments: ThreadAttachment[];
     lastError?: string | null;
+    /**
+     * OS pid of the in-flight agent child while status is `running`.
+     * Used so other processes (MCP) do not reclaim a live turn as dead.
+     */
+    agentPid?: number | null;
 }
 interface CreateChatTabInput {
     /** Existing thread in the worktree to clone workspace metadata from. */
@@ -1637,6 +1642,33 @@ declare function attachmentsFromBuffers(buffers: ComposerFileBuffer[]): ThreadAt
  */
 declare function attachmentsFromWorktreePaths(worktreePath: string, relativePaths: string[]): ThreadAttachment[];
 
+/** Paste this large → attach as a doc chip instead of flooding the composer. */
+declare const PASTE_ATTACH_MIN_CHARS = 1200;
+/** Or this many lines (whichever hits first). */
+declare const PASTE_ATTACH_MIN_LINES = 15;
+declare function pastedTextStats(text: string): {
+    chars: number;
+    lines: number;
+};
+/**
+ * True when clipboard text is large enough that Claude-style doc attachment
+ * is preferable to dumping it into the message input.
+ */
+declare function shouldAttachPastedText(text: string): boolean;
+/** Next `Pasted text #N.txt` name given existing composer attachments. */
+declare function nextPastedTextName(existing: Array<{
+    name: string;
+}>): string;
+/**
+ * Build a file-kind attachment for a large paste. Content is expanded into the
+ * agent prompt via `expandComposerPrompt` like other composer attachments.
+ */
+declare function buildPastedTextAttachment(text: string, opts?: {
+    name?: string;
+    id?: string;
+    path?: string;
+}): ThreadAttachment;
+
 interface SummarizeResult {
     summary: string;
     method: 'claude' | 'extractive';
@@ -1787,6 +1819,9 @@ declare function applyThreadIntoMain(thread: Pick<Thread, 'repoPath' | 'worktree
     targetBranch?: string;
 }): Promise<ApplyIntoMainResult>;
 
+/** True when `kill(pid, 0)` succeeds (process exists and is signalable). */
+declare function isPidAlive(pid: number): boolean;
+
 declare class Orchestrator {
     readonly events: EventEmitter<[never]>;
     private readonly processes;
@@ -1816,11 +1851,17 @@ declare class Orchestrator {
     private emit;
     /** True when disk says running but this process is not actually turning. */
     private isStaleRunningThread;
+    /**
+     * Cross-process guard: another Sideboard process (MCP stdio) may call reconcile
+     * while the desktop still owns a live agent child. Never reclaim those.
+     */
+    private shouldReclaimRunningThread;
     reconcile(repoPath?: string, opts?: {
         /**
-         * When true (default), mark disk-status `running` threads with no in-process
-         * turn as stopped. Must stay false in Sideboard MCP subprocesses — they do
-         * not own agent turns, so every live parent turn looks "dead".
+         * When true, mark disk-status `running` threads with no in-process turn
+         * (and no live agentPid) as stopped. Default false — MCP/CLI helpers must
+         * not reclaim turns owned by the desktop orchestrator. Pass true only on
+         * real app/CLI startup recovery.
          */
         reclaimStaleTurns?: boolean;
     }): Promise<void>;
@@ -2636,4 +2677,4 @@ declare function writeInjectedMcpConfig(opts: {
     includeBrightsy?: boolean;
 }): Promise<string | null>;
 
-export { type ActiveRun, type AdoptInput, type AdvancedAppSettings, type AgentAdapter, type AgentEvent, type AgentInstructionFile, type AgentKind, type AgentModelInfo, type AgentSetupActionResult, type AgentSetupInfo, type AgentSetupKind, type AgentStatus, type AgentTurnInput, type AnthropicCacheControl, type AppSettings, type ApplyIntoMainResult, type AttachCommand, type Autonomy, BRIGHTSY_MCP_ALLOWED_TOOLS, type BranchInfo, type BrightsyAccount, type BrightsyChatTarget, type BrightsyChatTargets, type BrightsyCloudConnectAgent, type BrightsyHarnessSettings, type BrightsySession, BrightsySideboardApi, type BrightsyTeamTargets, CLOUD_COORDINATOR_BUSY_REPLY, CLOUD_COORDINATOR_STOPPED_REPLY, CLOUD_COORDINATOR_TIMEOUT_REPLY, CLOUD_ORCHESTRATOR_GOAL, CONTEXT_COMPACT_CHARS, CONTEXT_KEEP_RECENT_CHARS, CONTEXT_KEEP_RECENT_MESSAGES, CONTEXT_MIN_MESSAGES, COORDINATOR_TOOL_PLAYBOOK, type ClaudeHarnessSettings, type CleanupOrphansResult, type CloudConnectAgent, type CloudConnectOptions, type CloudConnectStatus, type CompactResult, type CompactThresholds, type ComposerFileBuffer, type ConductorSettings, type ConductorWorkspace, type ConnectedBrightsyTeamInfo, type CreateChatTabInput, type CreateGlobalChatOpts, type CreateThreadInput, type CreateWorktreeResult, type CursorModelInfo, type CursorSdkStreamMessage, type CursorTurnRequest, type CursorWorktreesConfig, type DefaultsAppSettings, type DevServerHandle, type DiffCommentInput, type DiffCommentLine, type DiffCommit, type DiffFile, type DiffResult, type DiffScope, type DiffScopeStat, type ExpandResult, FAMOUS_SOCCER_TEAMS, type ForkChatTabInput, type ForkThreadWorktreeInput, type FormatGhLandErrorOptions, GLOBAL_WORKSPACE_ID, type GetDiffOptions, type GitHubStatus, type GitWorktreeStatus, HARNESS_ENV_KEYS, type HarnessId, type IntegrationsSettings, type IpcApi, type IssueInfo, type IssueSource, type LandPreview, type LandResult, type ListIssuesResult, MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS, type McpServerStatus, type MessagePart, Orchestrator, type OrchestratorEvent, type OrchestratorRuntime, type OrphanWorktree, PLAN_MODE_INSTRUCTION, type PrActor, type PrCheckRun, type PrCommentInfo, type PrCommitInfo, type PrDetails, type PrInfo, type PrMeta, type PrReviewInfo, type RepoSettings, type RepoSetupInfo, type RunMode, type RunScript, SIDEBOARD_FORCE_STOP, SIDEBOARD_MCP_ALLOWED_TOOLS, type ScriptHandle, type SkillInfo, type SourceType, type SpawnTurnHandle, type SummarizeResult, type TeamName, type Thread, type ThreadAttachment, type ThreadMessage, type ThreadOptionsPatch, type ThreadStatus, type TokenUsage, type TranscriptToolDetail, type TurnCommand, type Workspace, type WorkspaceInventoryEntry, type WorkspaceScriptEnvOpts, addWorkspace, adoptThread, allAdapters, allocatePort, allocatePortRange, allocateTeamName, allocateTeamSlug, appDataDir, appSettingsPath, appendMessage, applyAgentEvent, applyAppEnvironment, applyCompaction, applyThreadIntoMain, attachmentFromAbsolutePath, attachmentsFromBuffers, attachmentsFromWorktreePaths, autoCleanupOrphansEnabled, autoRenameBranchEnabled, autoRunAfterSetupEnabled, branchDisplayLabel, brightsyAdapter, brightsyCloudConnectAgent, brightsyCloudConnectEnabled, brightsyConfigPath, brightsyMcpAllowedTools, brightsyMcpServerName, buildCachedUserContent, buildClaudeStreamJsonUserMessage, buildDiffCommentAttachment, buildForkTranscriptAttachment, buildSessionSeed, buildWorkspaceScriptEnv, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, captureLoginEnv, captureTurnBaseline, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, collectTakenTeamSlugs, commitAll, conductorDbPath, confirmLand, connectBrightsyTeam, coordinatorSystemPrompt, coordinatorTurnReminder, copyConfiguredFiles, countCacheControlBlocks, createChatTab, createEmptyThread, createGlobalChat, createOrUpdatePr, createThread, createThreadWorktree, currentBranch, cursorAdapter, cursorSdkMessageToEvents, decodeBrightsyTarget, deleteBranchOnPurgeEnabled, deleteThreadRecord, detectAgents, detectLocalMergeConflicts, disconnectBrightsyTeam, discoverSkills, encodeBrightsyTarget, enrichWorkspacesWithGithub, ensureAgentPath, ensureCloudCoordinator, ensureGhPreferOrigin, ensureGlobalCoordinatorCwd, ensureWorkspace, estimateMessageChars, estimateThreadChars, expandComposerPrompt, extractGhErrorDetail, extractiveSummary, fetchPrHead, finalizeParts, findInvalidCacheControlTtlOrder, findOrphanWorktrees, findThreadByRef, flattenTurnInput, forkChatTab, forkMessageSlice, forkThreadWorktree, formatAgentInstructions, formatArtifactDirective, formatBrightsyFetchError, formatGhLandError, formatIpcInvokeError, formatMessagesAsTranscript, formatRateLimitResetHint, formatRenameBranchDirective, formatTranscriptMarkdown, formatWorkspaceInventory, formatWorktreeDirective, getAdapter, getAgentSetupInfo, getBrightsySession, getDefaultAgent, getDefaultModel, getDefaultRunScript, getDiff, getDiffSummary, getGitHubStatus, getIssueSource, getLinearApiKey, getOrchestrator, getPr, getPrChecks, getPrDetails, getPrMeta, getRepoSetupInfo, getRunMode, getRunScript, gh, ghHeadRef, ghRepoSelectArgs, git, globalAgentCwd, harnessEnvKey, hasConductorHook, hasCursorWorktreeSetup, hasRepoHook, hasWorkspaceHook, healOrchestrationSoccerTitles, importConductorWorkspace, importConductorWorkspaceAsync, initializeGitRepository, inspectGitWorktree, installAgent, isBrightsyConnected, isBrightsyNdjsonLine, isCloudCoordinatorThread, isCursorAutoModel, isDirty, isGhRateLimitError, isGlobalRepoPath, isGlobalThread, isImageFilePath, isLinearConnected, isOrchestratorThread, isPlaceholderBranch, listAgentSetupInfo, listBranchCommits, listBranches, listBrightsyAccounts, listBrightsyChatTargets, listCodexModels, listConductorWorkspaces, listConnectedBrightsyTeams, listCursorModels, listGitHubIssues, listGlobalThreads, listIssues, listLinearIssues, listLinearIssuesDirect, listOpencodeModels, listPrs, listRunScripts, listThreads, listWorkspaces, listWorktreeFiles, listWorktrees, loadAgentInstructions, loadAppSettings, loadBrightsyConfig, loadConductorSettings, loadRepoSettings, loadWorkspaceSettings, locksDir, loginAgent, lookupSoccerTeam, maxConcurrentAgents, maybeCompactContext, mcpAllowTools, mcpAuthWarnings, mergePr, mergeUsage, normalizeParseResult, normalizeThread, normalizeTurnInput, normalizeWorktreePath, openInSystemTerminal, opencodeAdapter, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGithubSlugFromRemoteUrl, parseMcpList, partsToAssistantText, permissionMode, previewLand, pushBranch, readSkillBody, readThread, readWorktreeFile, readWorktreeFileForUpload, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requireAgent, resolveClaudeExecutable, resolveConductorCursorAgentId, resolveCursorModelId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGithubRepoSlug, resolvePrSelector, resolveRepoRoot, resolveThreadDefaults, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldCompactContext, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardReposDir, sideboardWorkspacesDir, slugify, spawnAgentTurn, splitForCompaction, stageAbsolutePathsAsAttachments, stageBuffersAsAttachments, startDevServer, startMcpServer, startOrchestration, stripBrightsyNdjsonNoise, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, threadDisplayLabel, threadFilePath, threadLockPath, threadsDir, threadsSharingWorktree, toolDescription, toolDetail, toolFilePath, totalTokens, updateAdvancedSettings, updateAppEnvironment, updateBrightsySettings, updateClaudeSettings, updateDefaultsSettings, updateIntegrationsSettings, updateThread, validateLinearApiKey, withAgentInstructions, withThreadLock, workspaceSettingsSourceLabel, worktreeCleanupSettings, worktreeDisplayLabel, worktreeDisplayLabelForGroup, worktreeNameFromPath, worktreesRoot, writeInjectedMcpConfig, writeThread, writeWorktreeFile };
+export { type ActiveRun, type AdoptInput, type AdvancedAppSettings, type AgentAdapter, type AgentEvent, type AgentInstructionFile, type AgentKind, type AgentModelInfo, type AgentSetupActionResult, type AgentSetupInfo, type AgentSetupKind, type AgentStatus, type AgentTurnInput, type AnthropicCacheControl, type AppSettings, type ApplyIntoMainResult, type AttachCommand, type Autonomy, BRIGHTSY_MCP_ALLOWED_TOOLS, type BranchInfo, type BrightsyAccount, type BrightsyChatTarget, type BrightsyChatTargets, type BrightsyCloudConnectAgent, type BrightsyHarnessSettings, type BrightsySession, BrightsySideboardApi, type BrightsyTeamTargets, CLOUD_COORDINATOR_BUSY_REPLY, CLOUD_COORDINATOR_STOPPED_REPLY, CLOUD_COORDINATOR_TIMEOUT_REPLY, CLOUD_ORCHESTRATOR_GOAL, CONTEXT_COMPACT_CHARS, CONTEXT_KEEP_RECENT_CHARS, CONTEXT_KEEP_RECENT_MESSAGES, CONTEXT_MIN_MESSAGES, COORDINATOR_TOOL_PLAYBOOK, type ClaudeHarnessSettings, type CleanupOrphansResult, type CloudConnectAgent, type CloudConnectOptions, type CloudConnectStatus, type CompactResult, type CompactThresholds, type ComposerFileBuffer, type ConductorSettings, type ConductorWorkspace, type ConnectedBrightsyTeamInfo, type CreateChatTabInput, type CreateGlobalChatOpts, type CreateThreadInput, type CreateWorktreeResult, type CursorModelInfo, type CursorSdkStreamMessage, type CursorTurnRequest, type CursorWorktreesConfig, type DefaultsAppSettings, type DevServerHandle, type DiffCommentInput, type DiffCommentLine, type DiffCommit, type DiffFile, type DiffResult, type DiffScope, type DiffScopeStat, type ExpandResult, FAMOUS_SOCCER_TEAMS, type ForkChatTabInput, type ForkThreadWorktreeInput, type FormatGhLandErrorOptions, GLOBAL_WORKSPACE_ID, type GetDiffOptions, type GitHubStatus, type GitWorktreeStatus, HARNESS_ENV_KEYS, type HarnessId, type IntegrationsSettings, type IpcApi, type IssueInfo, type IssueSource, type LandPreview, type LandResult, type ListIssuesResult, MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS, type McpServerStatus, type MessagePart, Orchestrator, type OrchestratorEvent, type OrchestratorRuntime, type OrphanWorktree, PASTE_ATTACH_MIN_CHARS, PASTE_ATTACH_MIN_LINES, PLAN_MODE_INSTRUCTION, type PrActor, type PrCheckRun, type PrCommentInfo, type PrCommitInfo, type PrDetails, type PrInfo, type PrMeta, type PrReviewInfo, type RepoSettings, type RepoSetupInfo, type RunMode, type RunScript, SIDEBOARD_FORCE_STOP, SIDEBOARD_MCP_ALLOWED_TOOLS, type ScriptHandle, type SkillInfo, type SourceType, type SpawnTurnHandle, type SummarizeResult, type TeamName, type Thread, type ThreadAttachment, type ThreadMessage, type ThreadOptionsPatch, type ThreadStatus, type TokenUsage, type TranscriptToolDetail, type TurnCommand, type Workspace, type WorkspaceInventoryEntry, type WorkspaceScriptEnvOpts, addWorkspace, adoptThread, allAdapters, allocatePort, allocatePortRange, allocateTeamName, allocateTeamSlug, appDataDir, appSettingsPath, appendMessage, applyAgentEvent, applyAppEnvironment, applyCompaction, applyThreadIntoMain, attachmentFromAbsolutePath, attachmentsFromBuffers, attachmentsFromWorktreePaths, autoCleanupOrphansEnabled, autoRenameBranchEnabled, autoRunAfterSetupEnabled, branchDisplayLabel, brightsyAdapter, brightsyCloudConnectAgent, brightsyCloudConnectEnabled, brightsyConfigPath, brightsyMcpAllowedTools, brightsyMcpServerName, buildCachedUserContent, buildClaudeStreamJsonUserMessage, buildDiffCommentAttachment, buildForkTranscriptAttachment, buildPastedTextAttachment, buildSessionSeed, buildWorkspaceScriptEnv, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, captureLoginEnv, captureTurnBaseline, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, collectTakenTeamSlugs, commitAll, conductorDbPath, confirmLand, connectBrightsyTeam, coordinatorSystemPrompt, coordinatorTurnReminder, copyConfiguredFiles, countCacheControlBlocks, createChatTab, createEmptyThread, createGlobalChat, createOrUpdatePr, createThread, createThreadWorktree, currentBranch, cursorAdapter, cursorSdkMessageToEvents, decodeBrightsyTarget, deleteBranchOnPurgeEnabled, deleteThreadRecord, detectAgents, detectLocalMergeConflicts, disconnectBrightsyTeam, discoverSkills, encodeBrightsyTarget, enrichWorkspacesWithGithub, ensureAgentPath, ensureCloudCoordinator, ensureGhPreferOrigin, ensureGlobalCoordinatorCwd, ensureWorkspace, estimateMessageChars, estimateThreadChars, expandComposerPrompt, extractGhErrorDetail, extractiveSummary, fetchPrHead, finalizeParts, findInvalidCacheControlTtlOrder, findOrphanWorktrees, findThreadByRef, flattenTurnInput, forkChatTab, forkMessageSlice, forkThreadWorktree, formatAgentInstructions, formatArtifactDirective, formatBrightsyFetchError, formatGhLandError, formatIpcInvokeError, formatMessagesAsTranscript, formatRateLimitResetHint, formatRenameBranchDirective, formatTranscriptMarkdown, formatWorkspaceInventory, formatWorktreeDirective, getAdapter, getAgentSetupInfo, getBrightsySession, getDefaultAgent, getDefaultModel, getDefaultRunScript, getDiff, getDiffSummary, getGitHubStatus, getIssueSource, getLinearApiKey, getOrchestrator, getPr, getPrChecks, getPrDetails, getPrMeta, getRepoSetupInfo, getRunMode, getRunScript, gh, ghHeadRef, ghRepoSelectArgs, git, globalAgentCwd, harnessEnvKey, hasConductorHook, hasCursorWorktreeSetup, hasRepoHook, hasWorkspaceHook, healOrchestrationSoccerTitles, importConductorWorkspace, importConductorWorkspaceAsync, initializeGitRepository, inspectGitWorktree, installAgent, isBrightsyConnected, isBrightsyNdjsonLine, isCloudCoordinatorThread, isCursorAutoModel, isDirty, isGhRateLimitError, isGlobalRepoPath, isGlobalThread, isImageFilePath, isLinearConnected, isOrchestratorThread, isPidAlive, isPlaceholderBranch, listAgentSetupInfo, listBranchCommits, listBranches, listBrightsyAccounts, listBrightsyChatTargets, listCodexModels, listConductorWorkspaces, listConnectedBrightsyTeams, listCursorModels, listGitHubIssues, listGlobalThreads, listIssues, listLinearIssues, listLinearIssuesDirect, listOpencodeModels, listPrs, listRunScripts, listThreads, listWorkspaces, listWorktreeFiles, listWorktrees, loadAgentInstructions, loadAppSettings, loadBrightsyConfig, loadConductorSettings, loadRepoSettings, loadWorkspaceSettings, locksDir, loginAgent, lookupSoccerTeam, maxConcurrentAgents, maybeCompactContext, mcpAllowTools, mcpAuthWarnings, mergePr, mergeUsage, nextPastedTextName, normalizeParseResult, normalizeThread, normalizeTurnInput, normalizeWorktreePath, openInSystemTerminal, opencodeAdapter, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGithubSlugFromRemoteUrl, parseMcpList, partsToAssistantText, pastedTextStats, permissionMode, previewLand, pushBranch, readSkillBody, readThread, readWorktreeFile, readWorktreeFileForUpload, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requireAgent, resolveClaudeExecutable, resolveConductorCursorAgentId, resolveCursorModelId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGithubRepoSlug, resolvePrSelector, resolveRepoRoot, resolveThreadDefaults, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldAttachPastedText, shouldCompactContext, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardReposDir, sideboardWorkspacesDir, slugify, spawnAgentTurn, splitForCompaction, stageAbsolutePathsAsAttachments, stageBuffersAsAttachments, startDevServer, startMcpServer, startOrchestration, stripBrightsyNdjsonNoise, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, threadDisplayLabel, threadFilePath, threadLockPath, threadsDir, threadsSharingWorktree, toolDescription, toolDetail, toolFilePath, totalTokens, updateAdvancedSettings, updateAppEnvironment, updateBrightsySettings, updateClaudeSettings, updateDefaultsSettings, updateIntegrationsSettings, updateThread, validateLinearApiKey, withAgentInstructions, withThreadLock, workspaceSettingsSourceLabel, worktreeCleanupSettings, worktreeDisplayLabel, worktreeDisplayLabelForGroup, worktreeNameFromPath, worktreesRoot, writeInjectedMcpConfig, writeThread, writeWorktreeFile };