@sideboard-ai/core 0.1.175 → 0.1.177

package/dist/mcp/run-stdio.cjs

@@ -7844,7 +7844,7 @@ function ensureGlobalCoordinatorCwd(opts) {
     "When creating threads, pass `repoPath` from `list_workspaces` (or the path you just registered).",
     orchId ? `Pass parentThreadId="${orchId}" (or omit it). Never invent another parentThreadId.` : "Pass `parentThreadId` for children (this chat's id from the turn reminder).",
     "Omit `agent` / `model` on `create_thread`. Sideboard applies Settings \u2192 Default agent, model & effort. Do not pass your own agent or `agent=cursor` \u2014 those are ignored.",
-    "Never pass `agent=codex` when you yourself are Codex \u2014 nested Codex deadlocks on shared ~/.codex locks. Omit agent; Sideboard applies Account defaults (and coerces only that nested-Codex case).",
+    "Never pass `agent=codex` when you yourself are Codex \u2014 nested Codex can deadlock on shared ~/.codex locks. Omit agent; Sideboard applies Account defaults, and switches that nested-Codex case to Cursor only when a CURSOR_API_KEY is configured.",
     "Typical flow (Home board): list_board \u2192 create_thread (sourceType=ticket|pr|branch) \u2192 send_to_thread \u2192 wait_for_turn (loop while stillRunning) \u2192 ask_git create-draft \u2192 wait_for_turn. Merge only if the user explicitly asked (`ask_git` merge).",
     "Typical flow (branch / explicit source): list_workspaces \u2192 list_branches|list_prs|list_issues \u2192 create_thread \u2192 send_to_thread \u2192 wait_for_turn (loop while stillRunning) \u2192 ask_git create-draft.",
     "Typical flow (find work): list_workspaces \u2192 pick repo(s) matching account / project context \u2192 Sideboard list_issues / linear_* (tickets) or list_prs(queue=review) (reviews) \u2192 show the options. Never wait on Claude Linear MCP. Only create_thread + send_to_thread when they asked to start (e.g. \u201Cfind me work and start it\u201D) \u2014 then wait_for_turn (loop while stillRunning) \u2192 ask_git create-draft.",
@@ -7921,7 +7921,7 @@ var init_coordinator_prompt = __esm({
       "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 (appears on Home). Do not create a second worktree for a ticket, PR, or named branch that already has one \u2014 that call returns the live thread (alreadyStarted=true). Creating from the default branch still opens a new isolated worktree. Pass repoPath + parentThreadId; omit agent and model so Sideboard applies Settings \u2192 Default agent, model & effort (never pass your own agent or agent=cursor). If the repo has a setup script, Sideboard runs it in the background (does not block send_to_thread). Nested Codex (you are Codex and the child is Codex) deadlocks \u2014 omit agent; Sideboard coerces that case",
+      "- create_thread \u2014 create a worktree + chat from branch | pr | ticket (appears on Home). Do not create a second worktree for a ticket, PR, or named branch that already has one \u2014 that call returns the live thread (alreadyStarted=true). Creating from the default branch still opens a new isolated worktree. Pass repoPath + parentThreadId; omit agent and model so Sideboard applies Settings \u2192 Default agent, model & effort (never pass your own agent or agent=cursor). If the repo has a setup script, Sideboard runs it in the background (does not block send_to_thread). Nested Codex (you are Codex and the child would be Codex) can deadlock on ~/.codex locks \u2014 omit agent; Sideboard switches the child to Cursor when a CURSOR_API_KEY is set, otherwise keeps the Account default",
       "- start_board_card \u2014 same as create_thread for a ticket/PR/named branch (attaches issue text when resolvable). Then send_to_thread.",
       "- 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.",
@@ -7936,9 +7936,9 @@ var init_coordinator_prompt = __esm({
       "- get_diff \u2014 compact diff summary",
       "- get_pr_checks \u2014 snapshot of a worktree thread's PR checks (null = no PR). Use this to inspect status. If the user gave a goal, the worktree agent watches with `gh pr checks --watch` \u2014 do not poll for the human.",
       '- request_review \u2014 open a Review chat tab on a worktree thread (attaches .claude/skills/review/SKILL.md when present, else .context/review.md copied from .sideboard/review.md / stock; sends "Review changes in this workspace."); then wait_for_turn (loop while stillRunning) / get_turn_result on the returned id',
-      "- ask_git \u2014 commit & push, open a draft PR, resolve conflicts, or merge. When the worktree is clean, Sideboard pushes / opens the PR itself. When dirty, it queues the worktree agent \u2014 then wait_for_turn (loop while stillRunning). Prefer this over paraphrasing. If ask_git / get_thread lastError says the GraphQL/PR body is too long, the branch is already pushed \u2014 send_to_thread so the worktree agent runs `gh pr create --body-file` with a short description. Do not invent SSH or auth failures from that error. If the user gave a goal (Greptile 5/5, CI green), send_to_thread that goal so the worktree agent enters the watch-fix-push loop \u2014 do not tell the human to poll.",
+      "- ask_git \u2014 commit & push, open a draft PR, mark ready for review, resolve conflicts, or merge. When the worktree is clean, Sideboard pushes / opens the PR itself. When dirty, it queues the worktree agent \u2014 then wait_for_turn (loop while stillRunning). Prefer this over paraphrasing. If ask_git / get_thread lastError says the GraphQL/PR body is too long, the branch is already pushed \u2014 send_to_thread so the worktree agent runs `gh pr create --body-file` with a short description. Do not invent SSH or auth failures from that error. If the user gave a goal (Greptile 5/5, CI green), send_to_thread that goal so the worktree agent enters the watch-fix-push loop \u2014 do not tell the human to poll.",
       '- Merge (`ask_git` action=merge / send_to_thread "Merge PR.") only when the user explicitly asked to merge that PR. Do not merge because the work looks done, CI is green, or a typical flow includes it.',
-      '- Or send_to_thread with those exact phrases: "Commit and push.", "Commit, push, and open a draft PR.", "Merge the remote branch (main) into your branch and resolve conflicts. Then, commit and push your changes.", "Merge PR." (draft PRs: `gh pr create --draft -R <origin-owner/name>` using the workspace `github:` slug \u2014 never upstream). Never run git/gh from this orchestration cwd, and never merge the PR yourself.',
+      '- Or send_to_thread with those exact phrases: "Commit and push.", "Commit, push, and open a draft PR.", "Ready for review.", "Merge the remote branch (main) into your branch and resolve conflicts. Then, commit and push your changes.", "Merge PR." (draft PRs: `gh pr create --draft -R <origin-owner/name>` using the workspace `github:` slug \u2014 never upstream). Never run git/gh from this orchestration cwd, and never merge the PR yourself.',
       "Process guides:",
       "- Long child jobs (pack, test, deploy, anything that may run more than ~30s): workers always have `/long-running` (Sideboard product skill). Tell them to detach and wait; they may `stop_job` if it hangs or is doing the wrong thing; do not ask the human to poll.",
       "- Recurring multi-item / fan-out: if the child worktree has `.claude/skills/graph-engineering/SKILL.md`, tell the worker to follow it (`/graph-engineering`). Judge first; state on disk; grow the rulebook; do not patch three threads.",
@@ -11296,6 +11296,9 @@ function resolveCursorApiKey() {
   if (fromEnv) return fromEnv;
   return (loadAppSettings().environment.CURSOR_API_KEY || "").trim();
 }
+function isCursorApiKeyConfigured() {
+  return Boolean(resolveCursorApiKey());
+}
 async function listCursorModels() {
   const now = Date.now();
   if (cachedModels && now - cachedModels.at < MODEL_CACHE_MS) {
@@ -12468,6 +12471,8 @@ function agentGitPrompt(action, opts) {
       const named = base ? ` (${base})` : "";
       return `Merge the remote branch${named} into your branch and resolve conflicts. Then, commit and push your changes.`;
     }
+    case "ready-for-review":
+      return "Ready for review.";
     case "merge":
       return "Merge PR.";
   }
@@ -12482,6 +12487,8 @@ function gitActionExpansion(action, base) {
       return "Commit, push, then `gh pr create --web -R <origin-owner/name>`.";
     case "resolve-conflicts":
       return `Fetch the PR base${base ? ` (\`${base}\`)` : ""}, merge it into this branch, resolve conflicts carefully, then commit and push until the PR is mergeable.`;
+    case "ready-for-review":
+      return "This phrase is the explicit ask to mark this thread's draft pull request ready for review on GitHub (`gh pr ready -R <origin-owner/name>` or `gh pr ready`). Update title/body if the purpose drifted. Do not merge.";
     case "merge":
       return "This phrase is the explicit ask to merge this thread's open pull request on GitHub. If `gh stack view` shows a stack, use `gh stack merge`; otherwise `gh pr merge` (respect repo defaults / squash vs merge). Do not force-push main/master or merge locally into the main checkout.";
   }
@@ -12524,6 +12531,7 @@ var init_agent_git_actions = __esm({
       "create-draft",
       "create-web",
       "resolve-conflicts",
+      "ready-for-review",
       "merge"
     ];
     RESOLVE_CONFLICTS_RE = /^Merge the remote branch(?: \(([^)]+)\))? into your branch and resolve conflicts\. Then, commit and push your changes\.$/;
@@ -18114,7 +18122,7 @@ function formatWorktreeDirective(thread, opts) {
     );
   }
   lines.push(
-    '- Sideboard git buttons send short phrases ("Commit and push.", "Merge PR.", \u2026) with their meaning attached \u2014 act on them without asking for clarification. If the user gives a goal (Greptile 5/5, CI green, until checks pass), you get the watch-fix-push playbook with that request.'
+    '- Sideboard git buttons send short phrases ("Commit and push.", "Ready for review.", "Merge PR.", \u2026) with their meaning attached \u2014 act on them without asking for clarification. If the user gives a goal (Greptile 5/5, CI green, until checks pass), you get the watch-fix-push playbook with that request.'
   );
   lines.push("");
   lines.push(formatProcessGuideDirective({ worktreePath: thread.worktreePath }));
@@ -19163,6 +19171,7 @@ __export(orchestrator_exports, {
   Orchestrator: () => Orchestrator,
   getOrchestrator: () => getOrchestrator,
   isPidAlive: () => isPidAlive,
+  resolveSendFollowUp: () => resolveSendFollowUp,
   startOrchestration: () => startOrchestration,
   waitForPidExit: () => waitForPidExit
 });
@@ -19183,6 +19192,10 @@ async function waitForPidExit(pid, timeoutMs) {
   }
   return true;
 }
+function resolveSendFollowUp(thread, requested) {
+  if (requested === "steer" || requested === "queue") return requested;
+  return isOrchestratorThread(thread) ? followUpBehavior() : "queue";
+}
 function writeLiveStatus(threadId, status, lastError) {
   const latest = readThread(threadId);
   if (!latest || latest.status === "archived") return latest;
@@ -19775,13 +19788,13 @@ var init_orchestrator = __esm({
         if (thread.status === "archived") {
           throw new Error(`Thread is archived: ${thread.id}`);
         }
-        const followUp = opts?.followUp === "steer" ? "steer" : "queue";
         let shouldSteer = false;
         const sent = await withThreadLock(thread.id, async () => {
           const current = this.requireThread(thread.id);
           if (current.status === "archived") {
             throw new Error(`Thread is archived: ${thread.id}`);
           }
+          const followUp = resolveSendFollowUp(current, opts?.followUp);
           const queue = [...current.queue, prompt];
           this.crashContinued.delete(thread.id);
           this.jobContinueCount.delete(thread.id);
@@ -21106,7 +21119,7 @@ var init_orchestrator = __esm({
             "ask_git targets a worktree agent thread (not the orchestrator). Pass a child/worktree thread ref."
           );
         }
-        if (action === "merge" && !thread.prUrl) {
+        if ((action === "merge" || action === "ready-for-review") && !thread.prUrl) {
           throw new Error(
             "No pull request linked. Ask the worktree agent to open a draft PR first (ask_git create-draft)."
           );
@@ -24221,11 +24234,13 @@ async function getHomeBoardInputs(workspaces, opts) {
 init_home_board();
 
 // src/mcp/create-thread-agent.ts
+init_cursor();
 function resolveOrchCreateThreadOptions(input) {
   const { resolveNewThreadOptions: resolveNewThreadOptions2 } = input;
   const account = resolveNewThreadOptions2({});
   const requested = input.requestedAgent;
   const parent = input.parentAgent ?? void 0;
+  const cursorReady = input.cursorReady ?? isCursorApiKeyConfigured();
   let agent = account.agent;
   let ignoredAgent;
   let honorRequestedModel = false;
@@ -24240,7 +24255,7 @@ function resolveOrchCreateThreadOptions(input) {
     }
   }
   let coercedFrom;
-  if (agent === "codex" && parent === "codex") {
+  if (agent === "codex" && parent === "codex" && cursorReady) {
     coercedFrom = requested ?? "codex";
     agent = "cursor";
   }
@@ -24256,7 +24271,7 @@ function resolveOrchCreateThreadOptions(input) {
 }
 function orchCreateThreadAgentNote(input) {
   if (input.coercedFrom) {
-    return `Avoid nested Codex under a Codex orchestrator \u2014 used Account default agent=${input.agent}`;
+    return `Avoid nested Codex under a Codex orchestrator \u2014 used agent=${input.agent}`;
   }
   if (input.ignoredAgent) {
     return `Ignored agent=${input.ignoredAgent} \u2014 used Account default agent=${input.agent}`;
@@ -25026,11 +25041,11 @@ async function startMcpServer() {
     );
     server.tool(
       "ask_git",
-      "Commit & push, open a draft PR, resolve conflicts, or merge \u2014 same actions as the desktop git buttons. When the worktree is clean, Sideboard pushes / opens the PR itself (HTTPS via `gh` even when origin is SSH / Settings \u2192 Git is SSH). When dirty, queues the worktree agent to commit; then wait_for_turn (loop while stillRunning). Do not start a checks loop on a plain push \u2014 only if the user gave a goal (Greptile 5/5, CI green). Pass a worktree thread ref (not the orchestrator). action=merge only when the user explicitly asked to merge that PR. Do not run git or gh from the orchestration cwd. If this tool errors that the GraphQL/PR body is too long, the branch is already pushed \u2014 have the worktree agent retry `gh pr create --body-file` with a short description (GitHub limit 65,536 characters). Do not invent SSH/auth failures from that error.",
+      "Commit & push, open a draft PR, mark ready for review, resolve conflicts, or merge \u2014 same actions as the desktop git buttons. When the worktree is clean, Sideboard pushes / opens the PR itself (HTTPS via `gh` even when origin is SSH / Settings \u2192 Git is SSH). When dirty, queues the worktree agent to commit; then wait_for_turn (loop while stillRunning). Do not start a checks loop on a plain push \u2014 only if the user gave a goal (Greptile 5/5, CI green). Pass a worktree thread ref (not the orchestrator). action=ready-for-review and action=merge only when the user explicitly asked (or clicked the desktop button). Do not run git or gh from the orchestration cwd. If this tool errors that the GraphQL/PR body is too long, the branch is already pushed \u2014 have the worktree agent retry `gh pr create --body-file` with a short description (GitHub limit 65,536 characters). Do not invent SSH/auth failures from that error.",
       {
         ref: import_zod8.z.string().describe("Worktree thread id/ref"),
         action: import_zod8.z.enum(AGENT_GIT_ACTIONS).describe(
-          "commit-push | create-draft | create-web | resolve-conflicts | merge"
+          "commit-push | create-draft | create-web | resolve-conflicts | ready-for-review | merge"
         )
       },
       async ({ ref, action }) => {

package/dist/mcp/run-stdio.js

@@ -37,15 +37,16 @@ import {
   syncBoardPins,
   updateSchedule,
   waitForDetachedJob
-} from "../chunk-RCICB4OM.js";
+} from "../chunk-DJUDDKXM.js";
 import {
   applySystemCaEnv,
+  isCursorApiKeyConfigured,
   isInternalAgentStatusText,
   listModelsForAgent,
   materializeSystemCaBundle,
   sideboardMcpProfile,
   trustSystemCertificates
-} from "../chunk-ZXHV3NHY.js";
+} from "../chunk-W44EKPIR.js";
 import "../chunk-HVIEYTUK.js";
 import "../chunk-Y4MIXGPA.js";
 import {
@@ -70,7 +71,7 @@ import {
   GLOBAL_WORKSPACE_ID,
   isCloudCoordinatorThread,
   listWorkspaces
-} from "../chunk-TNOLCU5B.js";
+} from "../chunk-FJWQCZ74.js";
 import {
   canonicalizeRepoPath,
   formatGhLandError,
@@ -2872,6 +2873,7 @@ function resolveOrchCreateThreadOptions(input) {
   const account = resolveNewThreadOptions({});
   const requested = input.requestedAgent;
   const parent = input.parentAgent ?? void 0;
+  const cursorReady = input.cursorReady ?? isCursorApiKeyConfigured();
   let agent = account.agent;
   let ignoredAgent;
   let honorRequestedModel = false;
@@ -2886,7 +2888,7 @@ function resolveOrchCreateThreadOptions(input) {
     }
   }
   let coercedFrom;
-  if (agent === "codex" && parent === "codex") {
+  if (agent === "codex" && parent === "codex" && cursorReady) {
     coercedFrom = requested ?? "codex";
     agent = "cursor";
   }
@@ -2902,7 +2904,7 @@ function resolveOrchCreateThreadOptions(input) {
 }
 function orchCreateThreadAgentNote(input) {
   if (input.coercedFrom) {
-    return `Avoid nested Codex under a Codex orchestrator \u2014 used Account default agent=${input.agent}`;
+    return `Avoid nested Codex under a Codex orchestrator \u2014 used agent=${input.agent}`;
   }
   if (input.ignoredAgent) {
     return `Ignored agent=${input.ignoredAgent} \u2014 used Account default agent=${input.agent}`;
@@ -3672,11 +3674,11 @@ async function startMcpServer() {
     );
     server.tool(
       "ask_git",
-      "Commit & push, open a draft PR, resolve conflicts, or merge \u2014 same actions as the desktop git buttons. When the worktree is clean, Sideboard pushes / opens the PR itself (HTTPS via `gh` even when origin is SSH / Settings \u2192 Git is SSH). When dirty, queues the worktree agent to commit; then wait_for_turn (loop while stillRunning). Do not start a checks loop on a plain push \u2014 only if the user gave a goal (Greptile 5/5, CI green). Pass a worktree thread ref (not the orchestrator). action=merge only when the user explicitly asked to merge that PR. Do not run git or gh from the orchestration cwd. If this tool errors that the GraphQL/PR body is too long, the branch is already pushed \u2014 have the worktree agent retry `gh pr create --body-file` with a short description (GitHub limit 65,536 characters). Do not invent SSH/auth failures from that error.",
+      "Commit & push, open a draft PR, mark ready for review, resolve conflicts, or merge \u2014 same actions as the desktop git buttons. When the worktree is clean, Sideboard pushes / opens the PR itself (HTTPS via `gh` even when origin is SSH / Settings \u2192 Git is SSH). When dirty, queues the worktree agent to commit; then wait_for_turn (loop while stillRunning). Do not start a checks loop on a plain push \u2014 only if the user gave a goal (Greptile 5/5, CI green). Pass a worktree thread ref (not the orchestrator). action=ready-for-review and action=merge only when the user explicitly asked (or clicked the desktop button). Do not run git or gh from the orchestration cwd. If this tool errors that the GraphQL/PR body is too long, the branch is already pushed \u2014 have the worktree agent retry `gh pr create --body-file` with a short description (GitHub limit 65,536 characters). Do not invent SSH/auth failures from that error.",
       {
         ref: z8.string().describe("Worktree thread id/ref"),
         action: z8.enum(AGENT_GIT_ACTIONS).describe(
-          "commit-push | create-draft | create-web | resolve-conflicts | merge"
+          "commit-push | create-draft | create-web | resolve-conflicts | ready-for-review | merge"
         )
       },
       async ({ ref, action }) => {

package/dist/{orchestrator-PDEU75EE.js → orchestrator-FTGAFZMK.js}

@@ -3,12 +3,13 @@ import {
   Orchestrator,
   getOrchestrator,
   isPidAlive,
+  resolveSendFollowUp,
   startOrchestration,
   waitForPidExit
-} from "./chunk-JIWRBNSO.js";
+} from "./chunk-DVYRABZC.js";
 import "./chunk-DJU54RYW.js";
-import "./chunk-QTJ2ERA6.js";
-import "./chunk-NA7P3SZL.js";
+import "./chunk-NIB6BTC6.js";
+import "./chunk-3ZFGZ7RT.js";
 import "./chunk-7JIYKYLL.js";
 import "./chunk-6K64FJDD.js";
 import "./chunk-IEEAVWAP.js";
@@ -30,6 +31,7 @@ export {
   Orchestrator,
   getOrchestrator,
   isPidAlive,
+  resolveSendFollowUp,
   startOrchestration,
   waitForPidExit
 };

package/dist/{orchestrator-QSNGJ2ER.js → orchestrator-XAJ3LREM.js}

@@ -5,16 +5,17 @@ import {
   Orchestrator,
   getOrchestrator,
   isPidAlive,
+  resolveSendFollowUp,
   startOrchestration,
   waitForPidExit
-} from "./chunk-RCICB4OM.js";
-import "./chunk-ZXHV3NHY.js";
+} from "./chunk-DJUDDKXM.js";
+import "./chunk-W44EKPIR.js";
 import "./chunk-HVIEYTUK.js";
 import "./chunk-Y4MIXGPA.js";
 import "./chunk-VKQGAWHY.js";
 import "./chunk-JFOPOMK7.js";
 import "./chunk-OCQPTUR7.js";
-import "./chunk-TNOLCU5B.js";
+import "./chunk-FJWQCZ74.js";
 import "./chunk-7O53GXTA.js";
 import "./chunk-D6JWYJ4P.js";
 import "./chunk-LZQULFIT.js";
@@ -29,6 +30,7 @@ export {
   Orchestrator,
   getOrchestrator,
   isPidAlive,
+  resolveSendFollowUp,
   startOrchestration,
   waitForPidExit
 };

package/dist/{workspaces-P66DGCZE.js → workspaces-DR4UNOQC.js}

@@ -6,7 +6,7 @@ import {
   listWorkspaces,
   removeWorkspace,
   syncWorkspacesFromThreads
-} from "./chunk-TNOLCU5B.js";
+} from "./chunk-FJWQCZ74.js";
 import "./chunk-7O53GXTA.js";
 import "./chunk-D6JWYJ4P.js";
 import "./chunk-LZQULFIT.js";

package/dist/{workspaces-TEBTNS2M.js → workspaces-ULHYXM4Y.js}

@@ -4,7 +4,7 @@ import {
   listWorkspaces,
   removeWorkspace,
   syncWorkspacesFromThreads
-} from "./chunk-NA7P3SZL.js";
+} from "./chunk-3ZFGZ7RT.js";
 import "./chunk-7JIYKYLL.js";
 import "./chunk-6K64FJDD.js";
 import "./chunk-J7LQVLFQ.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sideboard-ai/core",
-  "version": "0.1.175",
+  "version": "0.1.177",
   "description": "Sideboard core — orchestration, agents, git worktrees, MCP server",
   "license": "Apache-2.0",
   "type": "module",