@sideboard-ai/core 0.1.252 → 0.1.254

package/dist/mcp/run-stdio.cjs

@@ -6275,6 +6275,7 @@ __export(worktree_exports, {
   resolveWorktreeStartPoint: () => resolveWorktreeStartPoint,
   slugify: () => slugify,
   suggestSlug: () => suggestSlug,
+  switchWorktreeBranch: () => switchWorktreeBranch,
   threadDisplayLabel: () => threadDisplayLabel,
   ticketSlugForBranch: () => ticketSlugForBranch,
   worktreeDisplayLabel: () => worktreeDisplayLabel,
@@ -6886,6 +6887,7 @@ function parsePrDetailsView(view) {
   const author = view.author ?? {};
   const comments = Array.isArray(view.comments) ? view.comments : [];
   const reviews = Array.isArray(view.reviews) ? view.reviews : [];
+  const commits = Array.isArray(view.commits) ? view.commits : [];
   const requested = {
     ids: reviewerIdentities(view.reviewRequests),
     users: humanReviewerLogins(view.reviewRequests),
@@ -6906,8 +6908,22 @@ function parsePrDetailsView(view) {
     additions: Number(view.additions ?? 0),
     deletions: Number(view.deletions ?? 0),
     changedFiles: Number(view.changedFiles ?? 0),
-    // Commits live in Changes; omit from GraphQL to save rate-limit points.
-    commits: [],
+    commits: commits.map((c) => {
+      const row = c;
+      const authors = Array.isArray(row.authors) ? row.authors.map((a) => {
+        const actor = a;
+        return {
+          login: actor.login?.trim() || actor.name?.trim() || "unknown",
+          name: actor.name ?? null
+        };
+      }) : [];
+      return {
+        oid: String(row.oid ?? ""),
+        messageHeadline: String(row.messageHeadline ?? ""),
+        committedDate: String(row.committedDate ?? ""),
+        authors
+      };
+    }),
     comments: comments.map((c) => {
       const row = c;
       const a = row.author ?? {};
@@ -7286,6 +7302,59 @@ async function createExistingBranchWorktree(opts) {
   await ensureWorktreeSideboardIgnored(worktreePath);
   return { branchName, worktreePath };
 }
+async function switchWorktreeBranch(opts) {
+  const branch = opts.branchName.trim().replace(/^origin\//, "");
+  if (!branch) throw new Error("branch name required");
+  const head = await git(["rev-parse", "--abbrev-ref", "HEAD"], opts.worktreePath, {
+    reject: false
+  });
+  if (head.stdout.trim() === branch) return branch;
+  const here = normalizeWorktreePath(opts.worktreePath);
+  const trees = await listWorktrees(opts.repoPath);
+  const taken = trees.find(
+    (w) => w.branch === branch && normalizeWorktreePath(w.path) !== here
+  );
+  if (taken?.path) {
+    throw new Error(`Branch ${branch} is already checked out at ${taken.path}`);
+  }
+  await withRepoGitLock(opts.repoPath, async () => {
+    const local = await git(
+      ["show-ref", "--verify", "--quiet", `refs/heads/${branch}`],
+      opts.worktreePath,
+      { reject: false }
+    );
+    if (local.exitCode === 0) {
+      const sw = await git(["switch", branch], opts.worktreePath, {
+        reject: false
+      });
+      if (sw.exitCode !== 0) {
+        throw new Error(
+          sw.stderr.trim() || sw.stdout.trim() || `Failed to switch to ${branch}`
+        );
+      }
+      return;
+    }
+    const remote = `origin/${branch}`;
+    const remoteOk = await git(["rev-parse", "--verify", "--quiet", remote], opts.repoPath, {
+      reject: false
+    });
+    if (remoteOk.exitCode === 0) {
+      const sw = await git(
+        ["switch", "-c", branch, "--track", remote],
+        opts.worktreePath,
+        { reject: false }
+      );
+      if (sw.exitCode !== 0) {
+        throw new Error(
+          sw.stderr.trim() || sw.stdout.trim() || `Failed to switch to ${branch}`
+        );
+      }
+      return;
+    }
+    throw new Error(`Unknown branch ${branch}`);
+  });
+  return branch;
+}
 async function removeWorktree(repoPath, worktreePath, opts) {
   await withRepoGitLock(repoPath, async () => {
     await git(["worktree", "remove", "--force", worktreePath], repoPath, {
@@ -7718,6 +7787,7 @@ var init_worktree = __esm({
       "additions",
       "deletions",
       "changedFiles",
+      "commits",
       "comments",
       "reviews",
       "assignees",
@@ -8399,7 +8469,7 @@ var init_coordinator_prompt = __esm({
       "- ask_user \u2014 composer multiple-choice only when blocked on a concrete choice (approach fork, which API, Save this context / Do not save). Never for hellos, check-ins, invented \u201Cwhat should we do?\u201D menus, or after a review \u2014 reply in chat. Explain options first, description on every option, then wait.",
       "- get_viewer_context / update_viewer_context \u2014 read or replace Settings \u2192 Agents (account) and Settings \u2192 Projects (per-repo) context. You can update a project: pass scope=project and repoPath from list_workspaces (this cwd is not a project). update_viewer_context requires confirmed=true after ask_user. Never write context unprompted.",
       "- set_caffeinate \u2014 keep this Mac awake across turns (macOS caffeinate). Turn on for Slack / away-from-keyboard work, overnight schedules, or when the user will be away. Turn OFF when they say they are done, wrapping up, going to sleep, or no longer need the machine awake. Closing this chat also releases it.",
-      "- list_schedules / create_schedule / update_schedule / delete_schedule / run_schedule \u2014 local jobs that send a prompt to an orchestration chat (threadId or self) or start a new Global chat (omit threadId). One-shot `at`, interval `every` (15m/1h/6h/1d), or 5-field `cron`. Recurring jobs without threadId open a new chat each run. Jobs fire only while Sideboard.app is running; sleep skips until wake. Overnight/unattended runs: ask the user to enable Settings \u2192 Advanced \u2192 Caffeinate while schedules are enabled, or call set_caffeinate.",
+      "- list_schedules / create_schedule / update_schedule / delete_schedule / run_schedule \u2014 local jobs that send a prompt to a chat (threadId or self) or start a new Global chat (omit threadId). One-shot `at`, interval `every` (15m/1h/6h/1d), or 5-field `cron`. Recurring jobs without threadId open a new chat each run. Worktree agents have the same tools (`threadId=self` continues that coding chat). Jobs fire only while Sideboard.app is running; sleep skips until wake. Creating or enabling a future job turns on Settings \u2192 Advanced \u2192 Caffeinate while schedules are enabled (or call set_caffeinate).",
       "Workspaces:",
       "- add_workspace / remove_workspace \u2014 register or unregister a git repo",
       "Worktree threads (chats):",
@@ -10152,7 +10222,12 @@ var init_injected_mcp = __esm({
       "mcp__sideboard__get_run_log",
       "mcp__sideboard__notify_orchestrator",
       "mcp__sideboard__get_viewer_context",
-      "mcp__sideboard__update_viewer_context"
+      "mcp__sideboard__update_viewer_context",
+      "mcp__sideboard__list_schedules",
+      "mcp__sideboard__create_schedule",
+      "mcp__sideboard__update_schedule",
+      "mcp__sideboard__delete_schedule",
+      "mcp__sideboard__run_schedule"
     ];
     SIDEBOARD_GITHUB_MCP_ALLOWED_TOOLS = ["mcp__sideboard__github_*"];
     SIDEBOARD_LINEAR_MCP_ALLOWED_TOOLS = ["mcp__sideboard__linear_*"];
@@ -10467,6 +10542,13 @@ function toolDescription(name, input) {
     return str2(input?.name) ? `Read ${str2(input?.name)} log` : "Read Dev log";
   }
   if (/notify_orchestrator$/i.test(name)) return "Notify orchestrator";
+  if (/list_schedules$/i.test(name)) return "List schedules";
+  if (/create_schedule$/i.test(name)) {
+    return str2(input?.name) ? `Schedule ${str2(input?.name)}` : "Create schedule";
+  }
+  if (/update_schedule$/i.test(name)) return "Update schedule";
+  if (/delete_schedule$/i.test(name)) return "Delete schedule";
+  if (/run_schedule$/i.test(name)) return "Run schedule";
   if (isSkillToolName(name)) {
     const cmd = skillCommandFromInput(input);
     return cmd ? `Using /${cmd}` : "Using skill";
@@ -21405,11 +21487,15 @@ function formatWorktreeDirective(thread, opts) {
   lines.push("");
   lines.push(formatDevAccessHint(opts?.activeRuns));
   lines.push("");
+  lines.push(
+    "Schedules: `create_schedule` / `list_schedules` (`at` / `every` / `cron`). `threadId=self` continues this chat; omit threadId for a new Global chat. Fires only while Sideboard.app is running. A future job turns on Settings \u2192 Advanced \u2192 Caffeinate while schedules are enabled."
+  );
+  lines.push("");
   lines.push(formatProcessGuideDirective({ worktreePath: thread.worktreePath }));
   return lines.join("\n");
 }
 function formatWorktreeReminder() {
-  return "Sideboard worktree: stay in this cwd for all file and git work. Push and open PRs against origin, never upstream. Do not edit the main repo checkout. If a goal is given (Greptile 5/5, CI green), watch-fix-push until it lands \u2014 do not watch after every push.";
+  return "Sideboard worktree: stay in this cwd for all file and git work. Push and open PRs against origin, never upstream. Do not edit the main repo checkout. If a goal is given (Greptile 5/5, CI green), watch-fix-push until it lands \u2014 do not watch after every push. Schedules: create_schedule (at / every / cron; threadId=self for this chat).";
 }
 function mentionsPrGoal(prompt) {
   return PR_GOAL_RE.test(prompt);
@@ -22036,7 +22122,7 @@ function resolveScheduleThreadId(raw, env = process.env) {
   const value = raw?.trim() || "";
   if (!value) return null;
   if (value.toLowerCase() === "self") {
-    return env.SIDEBOARD_ORCHESTRATOR_THREAD_ID?.trim() || null;
+    return env.SIDEBOARD_ORCHESTRATOR_THREAD_ID?.trim() || env.SIDEBOARD_THREAD_ID?.trim() || null;
   }
   return value;
 }
@@ -22164,6 +22250,17 @@ function buildTask(input, now) {
 function listSchedules() {
   return readAll2().sort((a, b) => a.nextRunAt.localeCompare(b.nextRunAt));
 }
+function scheduleNeedsCaffeinate(task, now = /* @__PURE__ */ new Date()) {
+  if (!task.enabled) return false;
+  const at = new Date(task.nextRunAt);
+  if (Number.isNaN(at.getTime())) return false;
+  return at.getTime() > now.getTime();
+}
+function ensureCaffeinateForFutureSchedule(task) {
+  if (!scheduleNeedsCaffeinate(task)) return;
+  if (caffeinateWhileSchedulesEnabled()) return;
+  updateAdvancedSettings({ caffeinateWhileSchedules: true });
+}
 function getSchedule(id) {
   const key = id.trim();
   if (!key) return null;
@@ -22176,6 +22273,7 @@ function createSchedule(input) {
   const rows = readAll2();
   rows.push(task);
   writeAll2(rows);
+  ensureCaffeinateForFutureSchedule(task);
   return task;
 }
 function updateSchedule(id, patch) {
@@ -22202,6 +22300,7 @@ function updateSchedule(id, patch) {
   };
   rows[idx] = next;
   writeAll2(rows);
+  ensureCaffeinateForFutureSchedule(next);
   return next;
 }
 function deleteSchedule(id) {
@@ -22242,6 +22341,7 @@ var init_schedules = __esm({
     init_orchestrator_capable();
     init_paths();
     init_private_file();
+    init_app_settings();
     DURATION_RE = /^(\d+)(s|m|h|d)$/i;
     UNIT_MS = {
       s: 1e3,
@@ -22278,19 +22378,9 @@ async function fireSchedule(id) {
   try {
     const deps = fireHooks ?? await defaultDeps();
     const prompt = formatScheduledPrompt(schedule.name, schedule.prompt);
-    if (schedule.threadId) {
-      const thread = deps.findThread(schedule.threadId);
-      if (!thread || thread.status === "archived") {
-        return recordScheduleRun(schedule.id, {
-          lastError: thread ? `Orchestration chat ${schedule.threadId} is archived` : `Orchestration chat not found: ${schedule.threadId}`
-        });
-      }
-      if (!isOrchestratorThread(thread)) {
-        return recordScheduleRun(schedule.id, {
-          lastError: `Thread ${schedule.threadId} is not an orchestration chat`
-        });
-      }
-      const sent = await deps.send(thread.id, prompt);
+    const target = schedule.threadId ? deps.findThread(schedule.threadId) : null;
+    if (target && target.status !== "archived") {
+      const sent = await deps.send(target.id, prompt);
       return recordScheduleRun(schedule.id, {
         lastThreadId: sent.id,
         lastError: null
@@ -22301,6 +22391,9 @@ async function fireSchedule(id) {
       agent: pickAgent(schedule),
       model: schedule.model
     });
+    if (schedule.threadId && schedule.when.kind !== "once") {
+      updateSchedule(schedule.id, { threadId: created.id });
+    }
     return recordScheduleRun(schedule.id, {
       lastThreadId: created.id,
       lastError: null
@@ -22369,7 +22462,6 @@ var init_schedule_runner = __esm({
     init_app_settings();
     init_schedules();
     init_thread_store();
-    init_global_workspace();
     SET_TIMEOUT_MAX = 2147483647;
     fireHooks = null;
     timers = /* @__PURE__ */ new Map();
@@ -25073,6 +25165,20 @@ var init_orchestrator = __esm({
         if (!next) throw new Error("Title cannot be empty");
         return updateThread(thread.id, { title: next, userSetTitle: true });
       }
+      async switchThreadBranch(threadRef, branchName) {
+        const thread = this.requireThread(threadRef);
+        this.assertNotGlobal(thread, "Switch branch");
+        if (thread.status === "running") {
+          throw new Error("Stop the agent before switching branches");
+        }
+        await switchWorktreeBranch({
+          repoPath: thread.repoPath,
+          worktreePath: thread.worktreePath,
+          branchName
+        });
+        await syncThreadBranchFromGit(thread.id);
+        return this.requireThread(thread.id);
+      }
       setAttachments(threadRef, attachments) {
         return updateThread(this.requireThread(threadRef).id, { attachments });
       }
@@ -29113,7 +29219,7 @@ function parseWhen(args) {
 function registerScheduleTools(server) {
   server.tool(
     "list_schedules",
-    "List local Sideboard schedules that trigger orchestration agents. Jobs fire only while Sideboard.app is running on this Mac (sleep skips until wake).",
+    "List local Sideboard schedules that trigger a chat when due. Jobs fire only while Sideboard.app is running on this Mac (sleep skips until wake).",
     {},
     async () => {
       try {
@@ -29125,7 +29231,7 @@ function registerScheduleTools(server) {
   );
   server.tool(
     "create_schedule",
-    "Create a local schedule that, when due, sends a prompt to an orchestration chat (threadId) or starts a new Global orchestration chat (omit threadId). Pass threadId=self to continue this coordinator. Exactly one of at (ISO datetime), every (15m/1h/6h/1d), or cron (5-field). Recurring jobs without threadId open a new chat each run. Overnight/unattended runs need Settings \u2192 Advanced \u2192 Caffeinate while schedules are enabled, or set_caffeinate. Sideboard.app must be running for the job to fire.",
+    "Create a local schedule that, when due, sends a prompt to an existing chat (threadId) or starts a new Global orchestration chat (omit threadId). Pass threadId=self to continue this chat. If that chat is missing or archived when the job fires, Sideboard starts a new Global chat (recurring jobs then continue that chat). Exactly one of at (ISO datetime), every (15m/1h/6h/1d), or cron (5-field). Recurring jobs without threadId open a new Global chat each run. Creating or enabling a future job turns on Settings \u2192 Advanced \u2192 Caffeinate while schedules are enabled so the Mac stays awake until due. Sideboard.app must be running for the job to fire.",
     {
       prompt: import_zod8.z.string().describe("User message / goal queued when the schedule fires"),
       name: import_zod8.z.string().optional(),
@@ -29134,7 +29240,7 @@ function registerScheduleTools(server) {
       cron: import_zod8.z.string().optional().describe("5-field cron expression"),
       tz: import_zod8.z.string().optional().describe("IANA timezone for cron (default: system)"),
       threadId: import_zod8.z.string().optional().describe(
-        'Existing orchestration chat id, or "self" for this coordinator. Omit to create a new Global chat on fire.'
+        'Existing chat id (orchestration or worktree), or "self" for this chat. Omit to create a new Global chat on fire.'
       ),
       agent: import_zod8.z.enum(["claude", "cursor", "codex", "opencode"]).optional().describe("Agent for a new Global chat (omit for Account default)"),
       model: import_zod8.z.string().optional()
@@ -29145,7 +29251,9 @@ function registerScheduleTools(server) {
         const threadId = resolveScheduleThreadId(args.threadId);
         if (args.threadId?.trim().toLowerCase() === "self" && !threadId) {
           return fail5(
-            new Error("threadId=self requires this turn to be an orchestration chat")
+            new Error(
+              "threadId=self needs this chat id (SIDEBOARD_THREAD_ID or SIDEBOARD_ORCHESTRATOR_THREAD_ID)"
+            )
           );
         }
         const schedule = createSchedule({
@@ -29159,7 +29267,7 @@ function registerScheduleTools(server) {
         });
         return text6({
           schedule,
-          hint: "Fires while Sideboard.app is running. Recurring jobs without threadId create a new orchestration chat each run. Overnight runs need Settings \u2192 Advanced \u2192 Caffeinate while schedules are enabled, or set_caffeinate."
+          hint: scheduleNeedsCaffeinate(schedule) ? "Fires while Sideboard.app is running. Recurring jobs without threadId create a new orchestration chat each run. Caffeinate while schedules are enabled is now on so the Mac can stay awake until this job is due." : "Fires while Sideboard.app is running. Recurring jobs without threadId create a new orchestration chat each run."
         });
       } catch (err) {
         return fail5(err);
@@ -29177,7 +29285,9 @@ function registerScheduleTools(server) {
       every: import_zod8.z.string().optional(),
       cron: import_zod8.z.string().optional(),
       tz: import_zod8.z.string().optional(),
-      threadId: import_zod8.z.string().optional().describe('Existing orchestration chat, "self", or empty string to create a new chat each run'),
+      threadId: import_zod8.z.string().optional().describe(
+        'Existing chat (orchestration or worktree), "self", or empty string to create a new Global chat each run'
+      ),
       agent: import_zod8.z.enum(["claude", "cursor", "codex", "opencode"]).optional(),
       model: import_zod8.z.string().optional(),
       enabled: import_zod8.z.boolean().optional()
@@ -29196,7 +29306,9 @@ function registerScheduleTools(server) {
           threadId = resolveScheduleThreadId(args.threadId);
           if (args.threadId.trim().toLowerCase() === "self" && !threadId) {
             return fail5(
-              new Error("threadId=self requires this turn to be an orchestration chat")
+              new Error(
+                "threadId=self needs this chat id (SIDEBOARD_THREAD_ID or SIDEBOARD_ORCHESTRATOR_THREAD_ID)"
+              )
             );
           }
         }
@@ -29230,7 +29342,7 @@ function registerScheduleTools(server) {
   );
   server.tool(
     "run_schedule",
-    "Fire a schedule now (does not wait for nextRunAt). Queues the prompt or starts a new Global chat. If Sideboard.app is running, the desktop drains the turn.",
+    "Fire a schedule now (does not wait for nextRunAt). Queues the prompt on the target chat or starts a new Global chat. If Sideboard.app is running, the desktop drains the turn.",
     { id: import_zod8.z.string() },
     async ({ id }) => {
       try {
@@ -30170,10 +30282,10 @@ async function startMcpServer() {
       }
     );
   }
+  registerScheduleTools(server);
   if (!worktreeProfile) {
     registerSlackTools(server);
     registerConnectedIssueVendorTools(server);
-    registerScheduleTools(server);
     const { getCaffeinateHold: getCaffeinateHold2, setCaffeinateHold: setCaffeinateHold2 } = await Promise.resolve().then(() => (init_caffeinate_hold(), caffeinate_hold_exports));
     const { resolveNewThreadOptions: resolveNewThreadOptions2, resolveThreadDefaults: resolveThreadDefaults2 } = await Promise.resolve().then(() => (init_app_settings(), app_settings_exports));
     const accountDefaults = resolveThreadDefaults2();

package/dist/mcp/run-stdio.js

@@ -43,13 +43,14 @@ import {
   readTurnLive,
   resolveOrchChildFollowUp,
   resolveScheduleThreadId,
+  scheduleNeedsCaffeinate,
   sliceRunLogOutput,
   stopDetachedJob,
   syncBoardPins,
   threadsSharingWorktree,
   updateSchedule,
   waitForDetachedJob
-} from "../chunk-AQQWP2TL.js";
+} from "../chunk-553IEH7O.js";
 import {
   PRESENT_PLAN_REQUIRES_PLAN_MODE,
   PRESENT_PLAN_TOOL_DESCRIPTION,
@@ -66,13 +67,13 @@ import {
   materializeSystemCaBundle,
   sideboardMcpProfile,
   trustSystemCertificates
-} from "../chunk-4DGYMF7H.js";
+} from "../chunk-F7ANS66U.js";
 import {
   GLOBAL_WORKSPACE_ID,
   isCloudCoordinatorThread,
   isOrchestratorThread,
   listWorkspaces
-} from "../chunk-6IP4FWMK.js";
+} from "../chunk-PJK24CN3.js";
 import "../chunk-XAISOBBG.js";
 import "../chunk-P2BSMNHB.js";
 import "../chunk-XIEDFRBP.js";
@@ -90,7 +91,7 @@ import {
   resolveListPrsOptions,
   resolveRepoRoot,
   warmGithubAgentAuth
-} from "../chunk-PV4KCI2S.js";
+} from "../chunk-HCNCZPDL.js";
 import "../chunk-D6JWYJ4P.js";
 import {
   appendMessage,
@@ -2367,7 +2368,7 @@ async function continueSourceThread(threadId, prompt) {
       await continueOnReply(threadId, prompt);
       return;
     }
-    const { getOrchestrator: getOrchestrator2 } = await import("../orchestrator-O3TVI7SN.js");
+    const { getOrchestrator: getOrchestrator2 } = await import("../orchestrator-VHJZEVGA.js");
     await getOrchestrator2().send(threadId, prompt);
   } catch {
   }
@@ -3912,7 +3913,7 @@ function parseWhen(args) {
 function registerScheduleTools(server) {
   server.tool(
     "list_schedules",
-    "List local Sideboard schedules that trigger orchestration agents. Jobs fire only while Sideboard.app is running on this Mac (sleep skips until wake).",
+    "List local Sideboard schedules that trigger a chat when due. Jobs fire only while Sideboard.app is running on this Mac (sleep skips until wake).",
     {},
     async () => {
       try {
@@ -3924,7 +3925,7 @@ function registerScheduleTools(server) {
   );
   server.tool(
     "create_schedule",
-    "Create a local schedule that, when due, sends a prompt to an orchestration chat (threadId) or starts a new Global orchestration chat (omit threadId). Pass threadId=self to continue this coordinator. Exactly one of at (ISO datetime), every (15m/1h/6h/1d), or cron (5-field). Recurring jobs without threadId open a new chat each run. Overnight/unattended runs need Settings \u2192 Advanced \u2192 Caffeinate while schedules are enabled, or set_caffeinate. Sideboard.app must be running for the job to fire.",
+    "Create a local schedule that, when due, sends a prompt to an existing chat (threadId) or starts a new Global orchestration chat (omit threadId). Pass threadId=self to continue this chat. If that chat is missing or archived when the job fires, Sideboard starts a new Global chat (recurring jobs then continue that chat). Exactly one of at (ISO datetime), every (15m/1h/6h/1d), or cron (5-field). Recurring jobs without threadId open a new Global chat each run. Creating or enabling a future job turns on Settings \u2192 Advanced \u2192 Caffeinate while schedules are enabled so the Mac stays awake until due. Sideboard.app must be running for the job to fire.",
     {
       prompt: z8.string().describe("User message / goal queued when the schedule fires"),
       name: z8.string().optional(),
@@ -3933,7 +3934,7 @@ function registerScheduleTools(server) {
       cron: z8.string().optional().describe("5-field cron expression"),
       tz: z8.string().optional().describe("IANA timezone for cron (default: system)"),
       threadId: z8.string().optional().describe(
-        'Existing orchestration chat id, or "self" for this coordinator. Omit to create a new Global chat on fire.'
+        'Existing chat id (orchestration or worktree), or "self" for this chat. Omit to create a new Global chat on fire.'
       ),
       agent: z8.enum(["claude", "cursor", "codex", "opencode"]).optional().describe("Agent for a new Global chat (omit for Account default)"),
       model: z8.string().optional()
@@ -3944,7 +3945,9 @@ function registerScheduleTools(server) {
         const threadId = resolveScheduleThreadId(args.threadId);
         if (args.threadId?.trim().toLowerCase() === "self" && !threadId) {
           return fail5(
-            new Error("threadId=self requires this turn to be an orchestration chat")
+            new Error(
+              "threadId=self needs this chat id (SIDEBOARD_THREAD_ID or SIDEBOARD_ORCHESTRATOR_THREAD_ID)"
+            )
           );
         }
         const schedule = createSchedule({
@@ -3958,7 +3961,7 @@ function registerScheduleTools(server) {
         });
         return text6({
           schedule,
-          hint: "Fires while Sideboard.app is running. Recurring jobs without threadId create a new orchestration chat each run. Overnight runs need Settings \u2192 Advanced \u2192 Caffeinate while schedules are enabled, or set_caffeinate."
+          hint: scheduleNeedsCaffeinate(schedule) ? "Fires while Sideboard.app is running. Recurring jobs without threadId create a new orchestration chat each run. Caffeinate while schedules are enabled is now on so the Mac can stay awake until this job is due." : "Fires while Sideboard.app is running. Recurring jobs without threadId create a new orchestration chat each run."
         });
       } catch (err) {
         return fail5(err);
@@ -3976,7 +3979,9 @@ function registerScheduleTools(server) {
       every: z8.string().optional(),
       cron: z8.string().optional(),
       tz: z8.string().optional(),
-      threadId: z8.string().optional().describe('Existing orchestration chat, "self", or empty string to create a new chat each run'),
+      threadId: z8.string().optional().describe(
+        'Existing chat (orchestration or worktree), "self", or empty string to create a new Global chat each run'
+      ),
       agent: z8.enum(["claude", "cursor", "codex", "opencode"]).optional(),
       model: z8.string().optional(),
       enabled: z8.boolean().optional()
@@ -3995,7 +4000,9 @@ function registerScheduleTools(server) {
           threadId = resolveScheduleThreadId(args.threadId);
           if (args.threadId.trim().toLowerCase() === "self" && !threadId) {
             return fail5(
-              new Error("threadId=self requires this turn to be an orchestration chat")
+              new Error(
+                "threadId=self needs this chat id (SIDEBOARD_THREAD_ID or SIDEBOARD_ORCHESTRATOR_THREAD_ID)"
+              )
             );
           }
         }
@@ -4029,7 +4036,7 @@ function registerScheduleTools(server) {
   );
   server.tool(
     "run_schedule",
-    "Fire a schedule now (does not wait for nextRunAt). Queues the prompt or starts a new Global chat. If Sideboard.app is running, the desktop drains the turn.",
+    "Fire a schedule now (does not wait for nextRunAt). Queues the prompt on the target chat or starts a new Global chat. If Sideboard.app is running, the desktop drains the turn.",
     { id: z8.string() },
     async ({ id }) => {
       try {
@@ -4954,10 +4961,10 @@ async function startMcpServer() {
       }
     );
   }
+  registerScheduleTools(server);
   if (!worktreeProfile) {
     registerSlackTools(server);
     registerConnectedIssueVendorTools(server);
-    registerScheduleTools(server);
     const { getCaffeinateHold, setCaffeinateHold } = await import("../caffeinate-hold-UAGLSGMM.js");
     const { resolveNewThreadOptions, resolveThreadDefaults } = await import("../app-settings-CLARFJUX.js");
     const accountDefaults = resolveThreadDefaults();

package/dist/{orchestrator-O3V4UH73.js → orchestrator-LWADJQTN.js}

@@ -9,11 +9,11 @@ import {
   resolveSendFollowUp,
   startOrchestration,
   waitForPidExit
-} from "./chunk-FKGVQKRX.js";
+} from "./chunk-Y7CS2WGJ.js";
 import "./chunk-PGPSIEMW.js";
-import "./chunk-BHPGORIY.js";
-import "./chunk-SJ3IUYG2.js";
-import "./chunk-NYXDZCMP.js";
+import "./chunk-R4DWUBOL.js";
+import "./chunk-BYRZS2S2.js";
+import "./chunk-63YSFXLT.js";
 import "./chunk-6K64FJDD.js";
 import "./chunk-2P4XKWV2.js";
 import "./chunk-5F4YFGHL.js";

package/dist/{orchestrator-O3TVI7SN.js → orchestrator-VHJZEVGA.js}

@@ -11,15 +11,15 @@ import {
   resolveSendFollowUp,
   startOrchestration,
   waitForPidExit
-} from "./chunk-AQQWP2TL.js";
+} from "./chunk-553IEH7O.js";
 import "./chunk-WDDUIGFK.js";
 import "./chunk-QN5DL2QO.js";
-import "./chunk-4DGYMF7H.js";
-import "./chunk-6IP4FWMK.js";
+import "./chunk-F7ANS66U.js";
+import "./chunk-PJK24CN3.js";
 import "./chunk-XAISOBBG.js";
 import "./chunk-P2BSMNHB.js";
 import "./chunk-VKQGAWHY.js";
-import "./chunk-PV4KCI2S.js";
+import "./chunk-HCNCZPDL.js";
 import "./chunk-D6JWYJ4P.js";
 import "./chunk-RJC2MKXN.js";
 import "./chunk-H547WSSZ.js";

package/dist/{workspaces-FUOZIR3V.js → workspaces-4KHEUPEX.js}

@@ -5,8 +5,8 @@ import {
   primaryCheckoutFromLinkedWorktree,
   removeWorkspace,
   syncWorkspacesFromThreads
-} from "./chunk-SJ3IUYG2.js";
-import "./chunk-NYXDZCMP.js";
+} from "./chunk-BYRZS2S2.js";
+import "./chunk-63YSFXLT.js";
 import "./chunk-6K64FJDD.js";
 import "./chunk-2P4XKWV2.js";
 import "./chunk-KJM3E3NF.js";

package/dist/{workspaces-V3PZRTY5.js → workspaces-IXZD7EC4.js}

@@ -7,8 +7,8 @@ import {
   primaryCheckoutFromLinkedWorktree,
   removeWorkspace,
   syncWorkspacesFromThreads
-} from "./chunk-6IP4FWMK.js";
-import "./chunk-PV4KCI2S.js";
+} from "./chunk-PJK24CN3.js";
+import "./chunk-HCNCZPDL.js";
 import "./chunk-D6JWYJ4P.js";
 import "./chunk-RJC2MKXN.js";
 import "./chunk-H547WSSZ.js";

package/dist/{worktree-UK62JCYF.js → worktree-DAAF64UU.js}

@@ -55,13 +55,14 @@ import {
   resolveWorktreeStartPoint,
   slugify,
   suggestSlug,
+  switchWorktreeBranch,
   threadDisplayLabel,
   ticketSlugForBranch,
   worktreeDisplayLabel,
   worktreeDisplayLabelForGroup,
   worktreeNameFromPath,
   worktreeSlugForTicket
-} from "./chunk-PV4KCI2S.js";
+} from "./chunk-HCNCZPDL.js";
 import "./chunk-D6JWYJ4P.js";
 import "./chunk-RJC2MKXN.js";
 import "./chunk-H547WSSZ.js";
@@ -128,6 +129,7 @@ export {
   resolveWorktreeStartPoint,
   slugify,
   suggestSlug,
+  switchWorktreeBranch,
   threadDisplayLabel,
   ticketSlugForBranch,
   worktreeDisplayLabel,

package/dist/{worktree-4DNK2CK6.js → worktree-S3FOMEQ2.js}

@@ -53,13 +53,14 @@ import {
   resolveWorktreeStartPoint,
   slugify,
   suggestSlug,
+  switchWorktreeBranch,
   threadDisplayLabel,
   ticketSlugForBranch,
   worktreeDisplayLabel,
   worktreeDisplayLabelForGroup,
   worktreeNameFromPath,
   worktreeSlugForTicket
-} from "./chunk-NYXDZCMP.js";
+} from "./chunk-63YSFXLT.js";
 import "./chunk-6K64FJDD.js";
 import "./chunk-2P4XKWV2.js";
 import "./chunk-KJM3E3NF.js";
@@ -126,6 +127,7 @@ export {
   resolveWorktreeStartPoint,
   slugify,
   suggestSlug,
+  switchWorktreeBranch,
   threadDisplayLabel,
   ticketSlugForBranch,
   worktreeDisplayLabel,

package/package.json

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