@sideboard-ai/core 0.1.85 → 0.1.87

package/dist/agents/cursor-runner.cjs

@@ -3,9 +3,9 @@
 
 // src/agents/cursor-runner.ts
 var import_sdk = require("@cursor/sdk");
-var import_node_fs3 = require("fs");
-var import_node_path4 = require("path");
-var import_node_readline = require("readline");
+var import_node_fs5 = require("fs");
+var import_node_path6 = require("path");
+var import_node_readline2 = require("readline");
 
 // src/hook/nested-electron-env.ts
 var NESTED_ELECTRON_ENV_PREFIXES = ["ELECTRON_", "CHROME_"];
@@ -25,22 +25,32 @@ var STRIP_NESTED_ELECTRON_THEN_EXEC = [
 ].join("; ");
 
 // src/store/paths.ts
-var import_node_path2 = require("path");
+var import_node_path4 = require("path");
 var import_node_os2 = require("os");
-var import_node_path3 = require("path");
-var import_node_fs2 = require("fs");
+var import_node_path5 = require("path");
+var import_node_fs4 = require("fs");
 
 // src/hook/settings.ts
-var import_node_fs = require("fs");
+var import_node_fs3 = require("fs");
 var import_node_os = require("os");
-var import_node_path = require("path");
+var import_node_path3 = require("path");
 var import_smol_toml = require("smol-toml");
 
+// src/hook/convention-setup.ts
+var import_node_fs = require("fs");
+var import_node_path = require("path");
+
+// src/hook/cursor-worktrees.ts
+var import_node_fs2 = require("fs");
+var import_node_path2 = require("path");
+var import_execa = require("execa");
+var import_node_readline = require("readline");
+
 // src/store/paths.ts
 function appDataDir() {
   const override = process.env.SIDEBOARD_APP_DATA?.trim();
-  const base = override ? override : process.platform === "darwin" ? (0, import_node_path3.join)((0, import_node_os2.homedir)(), "Library", "Application Support", "sideboard") : process.platform === "win32" ? (0, import_node_path3.join)(process.env.APPDATA ?? (0, import_node_path3.join)((0, import_node_os2.homedir)(), "AppData", "Roaming"), "sideboard") : (0, import_node_path3.join)((0, import_node_os2.homedir)(), ".local", "share", "sideboard");
-  (0, import_node_fs2.mkdirSync)(base, { recursive: true });
+  const base = override ? override : process.platform === "darwin" ? (0, import_node_path5.join)((0, import_node_os2.homedir)(), "Library", "Application Support", "sideboard") : process.platform === "win32" ? (0, import_node_path5.join)(process.env.APPDATA ?? (0, import_node_path5.join)((0, import_node_os2.homedir)(), "AppData", "Roaming"), "sideboard") : (0, import_node_path5.join)((0, import_node_os2.homedir)(), ".local", "share", "sideboard");
+  (0, import_node_fs4.mkdirSync)(base, { recursive: true });
   return base;
 }
 
@@ -69,6 +79,16 @@ function cursorSessionRecoveryMessage(err, agentId) {
   }
   return `Cursor session is unresumable (${detail}) \u2014 starting a new session`;
 }
+function cursorSendOptions(mcpServers) {
+  const opts = { local: { force: true } };
+  if (mcpServers && typeof mcpServers === "object" && Object.keys(mcpServers).length > 0) {
+    opts.mcpServers = mcpServers;
+  }
+  return opts;
+}
+function withCursorLocalHangGuards(local) {
+  return { ...local, enableAgentRetries: false };
+}
 
 // src/agents/error-detail.ts
 function formatUnknownDetail(err) {
@@ -287,8 +307,8 @@ function modelSelection(model, opts) {
   return params.length > 0 ? { id, params } : { id };
 }
 function localAgentStore() {
-  const root = (0, import_node_path4.join)(appDataDir(), "cursor-sdk-store");
-  (0, import_node_fs3.mkdirSync)(root, { recursive: true });
+  const root = (0, import_node_path6.join)(appDataDir(), "cursor-sdk-store");
+  (0, import_node_fs5.mkdirSync)(root, { recursive: true });
   return new import_sdk.JsonlLocalAgentStore(root);
 }
 async function cancelStaleLocalRuns(agentId, opts) {
@@ -314,7 +334,7 @@ async function cancelStaleLocalRuns(agentId, opts) {
   return cancelled;
 }
 async function readStdinJson() {
-  const rl = (0, import_node_readline.createInterface)({ input: process.stdin, crlfDelay: Infinity });
+  const rl = (0, import_node_readline2.createInterface)({ input: process.stdin, crlfDelay: Infinity });
   const chunks = [];
   for await (const line of rl) {
     chunks.push(line);
@@ -347,7 +367,7 @@ async function main() {
   });
   const mode = req.planMode ? "plan" : "agent";
   const store = localAgentStore();
-  const local = { cwd: req.cwd, store };
+  const local = withCursorLocalHangGuards({ cwd: req.cwd, store });
   const mcpServers = req.mcpServers && Object.keys(req.mcpServers).length > 0 ? req.mcpServers : void 0;
   const createOpts = {
     apiKey,
@@ -379,7 +399,7 @@ async function main() {
     }
   }
   async function sendPrompt(agent) {
-    const sendOpts = mcpServers ? { mcpServers } : void 0;
+    const sendOpts = cursorSendOptions(mcpServers);
     try {
       return await agent.send(req.prompt, sendOpts);
     } catch (err) {
@@ -395,25 +415,53 @@ async function main() {
       return agent.send(req.prompt, sendOpts);
     }
   }
+  let liveRun = null;
+  let shuttingDown = false;
+  const cancelLiveRun = async () => {
+    const run = liveRun;
+    liveRun = null;
+    if (!run) return;
+    try {
+      await run.cancel();
+    } catch {
+    }
+  };
+  const onSignal = () => {
+    if (shuttingDown) return;
+    shuttingDown = true;
+    void Promise.race([
+      cancelLiveRun(),
+      new Promise((resolve) => {
+        setTimeout(resolve, 2e3);
+      })
+    ]).finally(() => process.exit(1));
+  };
+  process.once("SIGTERM", onSignal);
+  process.once("SIGINT", onSignal);
   async function runTurn(agent) {
     emit({ type: "session_id", data: agent.agentId });
     const run = await sendPrompt(agent);
-    for await (const msg of run.stream()) {
-      for (const event of cursorSdkMessageToEvents(msg)) {
-        emit(event);
+    liveRun = run;
+    try {
+      for await (const msg of run.stream()) {
+        for (const event of cursorSdkMessageToEvents(msg)) {
+          emit(event);
+        }
       }
+      const result = await run.wait();
+      if (result.status === "error") {
+        const detail = formatUnknownDetail(result.error);
+        emit({
+          type: "stderr",
+          data: detail ? `Cursor run failed (${result.id}): ${detail}` : `Cursor run failed (${result.id})`
+        });
+        return 2;
+      }
+      if (result.status === "cancelled") return 0;
+      return 0;
+    } finally {
+      liveRun = null;
     }
-    const result = await run.wait();
-    if (result.status === "error") {
-      const detail = formatUnknownDetail(result.error);
-      emit({
-        type: "stderr",
-        data: detail ? `Cursor run failed (${result.id}): ${detail}` : `Cursor run failed (${result.id})`
-      });
-      return 2;
-    }
-    if (result.status === "cancelled") return 0;
-    return 0;
   }
   try {
     let agent = await openAgent();

package/dist/agents/cursor-runner.js

@@ -8,7 +8,7 @@ import {
 } from "../chunk-5KLC2MWZ.js";
 import {
   appDataDir
-} from "../chunk-M37RITA6.js";
+} from "../chunk-B4R2VB2A.js";
 
 // src/agents/cursor-runner.ts
 import { Agent, CursorAgentError, JsonlLocalAgentStore } from "@cursor/sdk";
@@ -41,6 +41,16 @@ function cursorSessionRecoveryMessage(err, agentId) {
   }
   return `Cursor session is unresumable (${detail}) \u2014 starting a new session`;
 }
+function cursorSendOptions(mcpServers) {
+  const opts = { local: { force: true } };
+  if (mcpServers && typeof mcpServers === "object" && Object.keys(mcpServers).length > 0) {
+    opts.mcpServers = mcpServers;
+  }
+  return opts;
+}
+function withCursorLocalHangGuards(local) {
+  return { ...local, enableAgentRetries: false };
+}
 
 // src/agents/cursor-runner.ts
 dropNestedElectronEnvFromProcess();
@@ -123,7 +133,7 @@ async function main() {
   });
   const mode = req.planMode ? "plan" : "agent";
   const store = localAgentStore();
-  const local = { cwd: req.cwd, store };
+  const local = withCursorLocalHangGuards({ cwd: req.cwd, store });
   const mcpServers = req.mcpServers && Object.keys(req.mcpServers).length > 0 ? req.mcpServers : void 0;
   const createOpts = {
     apiKey,
@@ -155,7 +165,7 @@ async function main() {
     }
   }
   async function sendPrompt(agent) {
-    const sendOpts = mcpServers ? { mcpServers } : void 0;
+    const sendOpts = cursorSendOptions(mcpServers);
     try {
       return await agent.send(req.prompt, sendOpts);
     } catch (err) {
@@ -171,25 +181,53 @@ async function main() {
       return agent.send(req.prompt, sendOpts);
     }
   }
+  let liveRun = null;
+  let shuttingDown = false;
+  const cancelLiveRun = async () => {
+    const run = liveRun;
+    liveRun = null;
+    if (!run) return;
+    try {
+      await run.cancel();
+    } catch {
+    }
+  };
+  const onSignal = () => {
+    if (shuttingDown) return;
+    shuttingDown = true;
+    void Promise.race([
+      cancelLiveRun(),
+      new Promise((resolve) => {
+        setTimeout(resolve, 2e3);
+      })
+    ]).finally(() => process.exit(1));
+  };
+  process.once("SIGTERM", onSignal);
+  process.once("SIGINT", onSignal);
   async function runTurn(agent) {
     emit({ type: "session_id", data: agent.agentId });
     const run = await sendPrompt(agent);
-    for await (const msg of run.stream()) {
-      for (const event of cursorSdkMessageToEvents(msg)) {
-        emit(event);
+    liveRun = run;
+    try {
+      for await (const msg of run.stream()) {
+        for (const event of cursorSdkMessageToEvents(msg)) {
+          emit(event);
+        }
       }
+      const result = await run.wait();
+      if (result.status === "error") {
+        const detail = formatUnknownDetail(result.error);
+        emit({
+          type: "stderr",
+          data: detail ? `Cursor run failed (${result.id}): ${detail}` : `Cursor run failed (${result.id})`
+        });
+        return 2;
+      }
+      if (result.status === "cancelled") return 0;
+      return 0;
+    } finally {
+      liveRun = null;
     }
-    const result = await run.wait();
-    if (result.status === "error") {
-      const detail = formatUnknownDetail(result.error);
-      emit({
-        type: "stderr",
-        data: detail ? `Cursor run failed (${result.id}): ${detail}` : `Cursor run failed (${result.id})`
-      });
-      return 2;
-    }
-    if (result.status === "cancelled") return 0;
-    return 0;
   }
   try {
     let agent = await openAgent();

package/dist/{agents-YAYNNJWC.js → agents-V6PVSQYH.js}

@@ -28,27 +28,27 @@ import {
   resolveCursorModelId,
   resolveLoginCommand,
   resolveQuotaFallbackAgent
-} from "./chunk-WGI6KXKJ.js";
+} from "./chunk-U4GZKLIV.js";
 import {
   ORCHESTRATOR_AGENT_KINDS,
   assertOrchestratorCapableAgent,
   coerceOrchestratorAgent,
   isOrchestratorCapableAgent
-} from "./chunk-JTHWVYSD.js";
-import "./chunk-SH75CXJR.js";
-import "./chunk-HHTHF5BQ.js";
+} from "./chunk-4PTN2LED.js";
+import "./chunk-A7LONVNO.js";
+import "./chunk-QSLE4VEM.js";
 import {
   cursorSdkMessageToEvents,
   parseCursorRunnerLine
 } from "./chunk-CBJSPTBG.js";
-import "./chunk-KRAUS3RF.js";
+import "./chunk-L63LLCTX.js";
 import "./chunk-FKOIHGKV.js";
-import "./chunk-I3FRXL7J.js";
+import "./chunk-XY6XXMAK.js";
 import "./chunk-5KLC2MWZ.js";
 import "./chunk-JT7R45JB.js";
-import "./chunk-FWJYLBO6.js";
+import "./chunk-3WA37BRI.js";
 import "./chunk-77WWLBCI.js";
-import "./chunk-M37RITA6.js";
+import "./chunk-B4R2VB2A.js";
 import {
   conductorBundledBinDir,
   enrichPathWithNpmGlobalBin,

package/dist/{agents-FD77JUOP.js → agents-W5446HSV.js}

@@ -32,22 +32,22 @@ import {
   resolveCursorModelId,
   resolveLoginCommand,
   resolveQuotaFallbackAgent
-} from "./chunk-3CCRD6WS.js";
-import "./chunk-6K5VAPVR.js";
+} from "./chunk-QWNROSRB.js";
+import "./chunk-DKHGWYWR.js";
 import {
   ORCHESTRATOR_AGENT_KINDS,
   assertOrchestratorCapableAgent,
   coerceOrchestratorAgent,
   isOrchestratorCapableAgent
-} from "./chunk-6GKDYUTJ.js";
-import "./chunk-XVFV56JG.js";
-import "./chunk-6WQAYBVE.js";
+} from "./chunk-UVNXLTFB.js";
+import "./chunk-3MA6JH6G.js";
+import "./chunk-CY45C3GA.js";
 import "./chunk-B3SJXYIJ.js";
-import "./chunk-7FD7COKE.js";
-import "./chunk-AY53MPDE.js";
+import "./chunk-JOF3XIEM.js";
+import "./chunk-TC2KY5G7.js";
 import "./chunk-NSTQ6QKD.js";
 import "./chunk-KGZBYWZ3.js";
-import "./chunk-7MV3RXSC.js";
+import "./chunk-JL4SJ6V7.js";
 import {
   conductorBundledBinDir,
   enrichPathWithNpmGlobalBin,

package/dist/{app-settings-PEXK5VEX.js → app-settings-F36ISTCF.js}

@@ -54,10 +54,10 @@ import {
   updateDefaultsSettings,
   updateIntegrationsSettings,
   updateOpencodeSettings
-} from "./chunk-AY53MPDE.js";
+} from "./chunk-TC2KY5G7.js";
 import "./chunk-NSTQ6QKD.js";
 import "./chunk-KGZBYWZ3.js";
-import "./chunk-7MV3RXSC.js";
+import "./chunk-JL4SJ6V7.js";
 export {
   GITHUB_GIT_AUTH_MODES,
   HARNESS_ENV_KEYS,

package/dist/{app-settings-K6RFCRF6.js → app-settings-HFINR3XG.js}

@@ -52,11 +52,11 @@ import {
   updateDefaultsSettings,
   updateIntegrationsSettings,
   updateOpencodeSettings
-} from "./chunk-I3FRXL7J.js";
+} from "./chunk-XY6XXMAK.js";
 import "./chunk-5KLC2MWZ.js";
 import "./chunk-JT7R45JB.js";
 import "./chunk-77WWLBCI.js";
-import "./chunk-M37RITA6.js";
+import "./chunk-B4R2VB2A.js";
 export {
   GITHUB_GIT_AUTH_MODES,
   HARNESS_ENV_KEYS,

package/dist/{caffeinate-hold-EAZNWJBE.js → caffeinate-hold-I7SG6UQR.js}

@@ -5,9 +5,9 @@ import {
   releaseCaffeinateHoldForThread,
   setCaffeinateHold,
   setCaffeinateHoldHooks
-} from "./chunk-MFF2RE3I.js";
+} from "./chunk-NZPGMNFC.js";
 import "./chunk-JT7R45JB.js";
-import "./chunk-M37RITA6.js";
+import "./chunk-B4R2VB2A.js";
 export {
   caffeinateHoldPath,
   getCaffeinateHold,

package/dist/{caffeinate-hold-OHAUWOA6.js → caffeinate-hold-U3QJBV67.js}

@@ -7,9 +7,9 @@ import {
   releaseCaffeinateHoldForThread,
   setCaffeinateHold,
   setCaffeinateHoldHooks
-} from "./chunk-RV6DBEDQ.js";
+} from "./chunk-7KDBDMNC.js";
 import "./chunk-NSTQ6QKD.js";
-import "./chunk-7MV3RXSC.js";
+import "./chunk-JL4SJ6V7.js";
 export {
   caffeinateHoldPath,
   getCaffeinateHold,

package/dist/{chunk-XVFV56JG.js → chunk-3MA6JH6G.js}

@@ -2,14 +2,14 @@
 
 import {
   resolveGithubRepoSlug
-} from "./chunk-6WQAYBVE.js";
+} from "./chunk-CY45C3GA.js";
 import {
   resolveThreadDefaults
-} from "./chunk-AY53MPDE.js";
+} from "./chunk-TC2KY5G7.js";
 import {
   globalAgentCwd,
   sideboardReposDir
-} from "./chunk-7MV3RXSC.js";
+} from "./chunk-JL4SJ6V7.js";
 
 // src/orchestrator/coordinator-prompt.ts
 import { mkdirSync, readFileSync, writeFileSync } from "fs";
@@ -58,7 +58,7 @@ var COORDINATOR_TOOL_PLAYBOOK = [
   "Workspaces:",
   "- add_workspace / remove_workspace \u2014 register or unregister a git repo",
   "Worktree threads (chats):",
-  "- create_thread \u2014 create a worktree + chat from branch | pr | ticket; pass repoPath + parentThreadId; omit agent and model to use Sideboard Account defaults (Settings \u2192 Default agent, model & effort). If you are Codex, do not set agent=codex (nested Codex deadlocks)",
+  "- create_thread \u2014 create a worktree + chat from branch | pr | ticket; pass repoPath + parentThreadId; omit agent and model to use Sideboard Account defaults (Settings \u2192 Default agent, model & effort). If the repo has a setup script, Sideboard runs it in the background (does not block send_to_thread). If you are Codex, do not set agent=codex (nested Codex deadlocks)",
   "- fork_worktree \u2014 fork a worktree chat into a NEW git worktree + chat (transcript attached); optional agent; leave model unset (Auto) unless you have a reason. Not for orchestration chats.",
   "- fork_chat \u2014 fork a worktree chat (same worktree tab) OR a Global orchestration chat (new orchestration tab); optional agent; leave model unset (Auto) unless you have a reason. Remote coordinators: use this to continue another orchestration chat on a different agent after session limits.",
   "- send_to_thread \u2014 queue a prompt (start/continue a chat turn); pass force_stop: true to interrupt mid-turn / clear stale queued prompts before replacing with a new request",
@@ -66,7 +66,7 @@ var COORDINATOR_TOOL_PLAYBOOK = [
   "- stop_thread \u2014 force-stop: kill in-flight turn AND clear queued prompts (do not leave stale queue after an interrupt)",
   "- archive_thread / restore_thread \u2014 archive (tears down worktree when last tab) or restore",
   "Setup / run:",
-  "- run_setup \u2014 re-run worktree setup",
+  "- run_setup \u2014 re-run worktree setup (already runs automatically on create when a script exists)",
   "- list_run_scripts / run_dev_script / stop_dev_script \u2014 start/stop named run scripts",
   "Inspect / review / PRs:",
   "- get_diff \u2014 compact diff summary",

package/dist/{chunk-FWJYLBO6.js → chunk-3WA37BRI.js}

@@ -5,7 +5,7 @@ import {
   threadFilePath,
   threadLockPath,
   threadsDir
-} from "./chunk-M37RITA6.js";
+} from "./chunk-B4R2VB2A.js";
 
 // src/store/thread-store.ts
 import { randomUUID } from "crypto";

package/dist/{chunk-JTHWVYSD.js → chunk-4PTN2LED.js}

@@ -1,24 +1,24 @@
 import {
   ensureGlobalCoordinatorCwd
-} from "./chunk-SH75CXJR.js";
+} from "./chunk-A7LONVNO.js";
 import {
   allocateTeamName,
   takenSlugsFromThread,
   teamSlugFromName
-} from "./chunk-KRAUS3RF.js";
+} from "./chunk-L63LLCTX.js";
 import {
   resolveNewThreadOptions,
   resolveThreadDefaults
-} from "./chunk-I3FRXL7J.js";
+} from "./chunk-XY6XXMAK.js";
 import {
   createEmptyThread,
   listThreads,
   updateThread,
   writeThread
-} from "./chunk-FWJYLBO6.js";
+} from "./chunk-3WA37BRI.js";
 import {
   globalAgentCwd
-} from "./chunk-M37RITA6.js";
+} from "./chunk-B4R2VB2A.js";
 
 // src/brightsy/cloud-connect-constants.ts
 var CLOUD_ORCHESTRATOR_GOAL = "Cloud-connected Sideboard orchestrator";

package/dist/{chunk-RV6DBEDQ.js → chunk-7KDBDMNC.js}

@@ -5,7 +5,7 @@ import {
 } from "./chunk-NSTQ6QKD.js";
 import {
   appDataDir
-} from "./chunk-7MV3RXSC.js";
+} from "./chunk-JL4SJ6V7.js";
 
 // src/store/caffeinate-hold.ts
 import { spawn } from "child_process";

package/dist/{chunk-SH75CXJR.js → chunk-A7LONVNO.js}

@@ -1,13 +1,13 @@
 import {
   resolveGithubRepoSlug
-} from "./chunk-KRAUS3RF.js";
+} from "./chunk-L63LLCTX.js";
 import {
   resolveThreadDefaults
-} from "./chunk-I3FRXL7J.js";
+} from "./chunk-XY6XXMAK.js";
 import {
   globalAgentCwd,
   sideboardReposDir
-} from "./chunk-M37RITA6.js";
+} from "./chunk-B4R2VB2A.js";
 
 // src/orchestrator/coordinator-prompt.ts
 import { mkdirSync, readFileSync, writeFileSync } from "fs";
@@ -56,7 +56,7 @@ var COORDINATOR_TOOL_PLAYBOOK = [
   "Workspaces:",
   "- add_workspace / remove_workspace \u2014 register or unregister a git repo",
   "Worktree threads (chats):",
-  "- create_thread \u2014 create a worktree + chat from branch | pr | ticket; pass repoPath + parentThreadId; omit agent and model to use Sideboard Account defaults (Settings \u2192 Default agent, model & effort). If you are Codex, do not set agent=codex (nested Codex deadlocks)",
+  "- create_thread \u2014 create a worktree + chat from branch | pr | ticket; pass repoPath + parentThreadId; omit agent and model to use Sideboard Account defaults (Settings \u2192 Default agent, model & effort). If the repo has a setup script, Sideboard runs it in the background (does not block send_to_thread). If you are Codex, do not set agent=codex (nested Codex deadlocks)",
   "- fork_worktree \u2014 fork a worktree chat into a NEW git worktree + chat (transcript attached); optional agent; leave model unset (Auto) unless you have a reason. Not for orchestration chats.",
   "- fork_chat \u2014 fork a worktree chat (same worktree tab) OR a Global orchestration chat (new orchestration tab); optional agent; leave model unset (Auto) unless you have a reason. Remote coordinators: use this to continue another orchestration chat on a different agent after session limits.",
   "- send_to_thread \u2014 queue a prompt (start/continue a chat turn); pass force_stop: true to interrupt mid-turn / clear stale queued prompts before replacing with a new request",
@@ -64,7 +64,7 @@ var COORDINATOR_TOOL_PLAYBOOK = [
   "- stop_thread \u2014 force-stop: kill in-flight turn AND clear queued prompts (do not leave stale queue after an interrupt)",
   "- archive_thread / restore_thread \u2014 archive (tears down worktree when last tab) or restore",
   "Setup / run:",
-  "- run_setup \u2014 re-run worktree setup",
+  "- run_setup \u2014 re-run worktree setup (already runs automatically on create when a script exists)",
   "- list_run_scripts / run_dev_script / stop_dev_script \u2014 start/stop named run scripts",
   "Inspect / review / PRs:",
   "- get_diff \u2014 compact diff summary",