@sideboard-ai/core 0.1.227 → 0.1.229

package/dist/index.js

@@ -20,7 +20,7 @@ import {
   parseAbleTimeOAuthCallbackUrl,
   resolveAbleTimeOAuthHost,
   startAbleTimeOAuth
-} from "./chunk-3NWUHXU3.js";
+} from "./chunk-C774RJJA.js";
 import {
   ableTimeDependencyTarget,
   commentAbleTimeTask,
@@ -38,8 +38,8 @@ import {
   toAbleTimeIssueInfo,
   updateAbleTimeTask,
   verifyAbleTimeConnection
-} from "./chunk-SOGGKYFV.js";
-import "./chunk-RRW2XWAY.js";
+} from "./chunk-SWNEA5OZ.js";
+import "./chunk-P6ZM5QJW.js";
 import {
   ABLETIME_MCP_PATH,
   ABLETIME_MCP_PM_PATH,
@@ -60,7 +60,7 @@ import {
   normalizeAbleTimeCredential,
   normalizeAbleTimeHost,
   rewriteAbleTimeError
-} from "./chunk-646I442S.js";
+} from "./chunk-MVLXDYN5.js";
 import {
   AGENT_GIT_ACTIONS,
   BOARD_COLUMN_DEFS,
@@ -268,6 +268,8 @@ import {
   requestReview,
   requireAgent,
   requireSlackWorkspace,
+  reservePort,
+  reservePortRange,
   resolveConductorCursorAgentId,
   resolveCreateFirstPrompt,
   resolveDetachedJobScript,
@@ -319,7 +321,7 @@ import {
   worktreeCleanupSettings,
   wrapReviewSkillMarkdown,
   writeWorktreeFile
-} from "./chunk-I2HOATRJ.js";
+} from "./chunk-UHT6OS7V.js";
 import {
   LEGACY_PLAN_FILE_REL,
   PLAN_FILE_NAME,
@@ -436,7 +438,7 @@ import {
   withEventParentId,
   withEventsParentId,
   writeInjectedMcpConfig
-} from "./chunk-VUW3VKLW.js";
+} from "./chunk-LULHFLPU.js";
 import {
   CLOUD_COORDINATOR_BUSY_REPLY,
   CLOUD_COORDINATOR_STOPPED_REPLY,
@@ -480,7 +482,7 @@ import {
   stageBuffersAsAttachments,
   syncWorkspacesFromThreads,
   takenTeamSlugsForOrchestration
-} from "./chunk-N2VST3NL.js";
+} from "./chunk-7YKXBFQE.js";
 import {
   FAMOUS_SOCCER_TEAMS,
   GITHUB_PR_BODY_MAX_CHARS,
@@ -578,7 +580,7 @@ import {
   worktreeDisplayLabelForGroup,
   worktreeNameFromPath,
   worktreeSlugForTicket
-} from "./chunk-KTZESHYH.js";
+} from "./chunk-AMMRFFB7.js";
 import {
   ATTACHMENTS_DIR,
   CLI_DIR,
@@ -631,6 +633,7 @@ import {
   withMaxOldSpaceSize
 } from "./chunk-TQBUXKIB.js";
 import {
+  AGENT_DONE_SOUNDS,
   FOLLOW_UP_BEHAVIORS,
   GITHUB_GIT_AUTH_MODES,
   HARNESS_ENV_KEYS,
@@ -644,6 +647,7 @@ import {
   ORCHESTRATOR_AGENT_KINDS,
   PROFILE_NOTES_MAX,
   USAGE_ON_LIMIT_VALUES,
+  agentDoneSound,
   appSettingsPath,
   applyAppEnvironment,
   applyTurnUsage,
@@ -698,6 +702,7 @@ import {
   historyMaxCount,
   historyMaxDays,
   isAbleTimeConnected,
+  isAgentDoneSound,
   isHistoryRetentionStub,
   isIssueSourceConnected,
   isLinearConnected,
@@ -751,7 +756,7 @@ import {
   updateProjectProfileSettings,
   usageOnLimit,
   writeViewerContext
-} from "./chunk-EWHJNJHV.js";
+} from "./chunk-I5NC7DWO.js";
 import {
   examplePrefixedBranch,
   resolveGitBranchPrefix,
@@ -838,6 +843,92 @@ import {
   stripNestedElectronEnv
 } from "./chunk-4TR3HZFT.js";
 
+// src/store/agent-done-sound.ts
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, unlinkSync } from "fs";
+import { basename, extname, join } from "path";
+var AGENT_DONE_CUSTOM_SOUND_MAX_BYTES = 5 * 1024 * 1024;
+var AUDIO_EXT_MIME = {
+  ".mp3": "audio/mpeg",
+  ".wav": "audio/wav",
+  ".ogg": "audio/ogg",
+  ".m4a": "audio/mp4",
+  ".aac": "audio/aac",
+  ".caf": "audio/x-caf",
+  ".flac": "audio/flac"
+};
+var AGENT_DONE_CUSTOM_SOUND_EXTENSIONS = Object.keys(AUDIO_EXT_MIME);
+function agentDoneSoundsDir() {
+  const dir = join(appDataDir(), "sounds");
+  mkdirSync(dir, { recursive: true });
+  return dir;
+}
+function normalizeExt(ext) {
+  const e = ext.trim().toLowerCase();
+  return e.startsWith(".") ? e : `.${e}`;
+}
+function agentDoneCustomSoundMime(extOrPath) {
+  const ext = normalizeExt(extname(extOrPath) || extOrPath);
+  return AUDIO_EXT_MIME[ext] ?? null;
+}
+function findAgentDoneCustomSoundPath() {
+  const dir = agentDoneSoundsDir();
+  for (const name of readdirSync(dir)) {
+    if (!name.startsWith("agent-done.")) continue;
+    const full = join(dir, name);
+    if (existsSync(full) && agentDoneCustomSoundMime(name)) return full;
+  }
+  return null;
+}
+function clearAgentDoneCustomSoundFile() {
+  const dir = agentDoneSoundsDir();
+  for (const name of readdirSync(dir)) {
+    if (!name.startsWith("agent-done.")) continue;
+    try {
+      unlinkSync(join(dir, name));
+    } catch {
+    }
+  }
+}
+function importAgentDoneCustomSound(sourcePath) {
+  const trimmed = sourcePath.trim();
+  if (!trimmed || !existsSync(trimmed)) {
+    throw new Error("Sound file not found");
+  }
+  const ext = normalizeExt(extname(trimmed));
+  const mime = AUDIO_EXT_MIME[ext];
+  if (!mime) {
+    throw new Error(
+      `Unsupported audio type (use ${AGENT_DONE_CUSTOM_SOUND_EXTENSIONS.join(", ")})`
+    );
+  }
+  const data = readFileSync(trimmed);
+  if (data.byteLength === 0) throw new Error("Sound file is empty");
+  if (data.byteLength > AGENT_DONE_CUSTOM_SOUND_MAX_BYTES) {
+    throw new Error("Sound file is too large (max 5 MB)");
+  }
+  clearAgentDoneCustomSoundFile();
+  const dest = join(agentDoneSoundsDir(), `agent-done${ext}`);
+  copyFileSync(trimmed, dest);
+  return {
+    name: basename(trimmed),
+    path: dest,
+    mime
+  };
+}
+function readAgentDoneCustomSound(displayName) {
+  const path2 = findAgentDoneCustomSoundPath();
+  if (!path2) return null;
+  const mime = agentDoneCustomSoundMime(path2);
+  if (!mime) return null;
+  const data = readFileSync(path2);
+  if (data.byteLength === 0) return null;
+  return {
+    name: displayName?.trim() || basename(path2),
+    mime,
+    dataBase64: data.toString("base64")
+  };
+}
+
 // src/store/thread-list.ts
 var LIST_PREVIEW_MAX = 480;
 function slimThreadForUiList(thread) {
@@ -3159,7 +3250,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z as z9 } from "zod";
 import { randomUUID as randomUUID3 } from "crypto";
-import { basename } from "path";
+import { basename as basename2 } from "path";
 
 // src/mcp/archive-guard.ts
 function mcpArchiveBlockedReason(thread) {
@@ -3169,6 +3260,20 @@ function mcpArchiveBlockedReason(thread) {
   return null;
 }
 
+// src/mcp/run-script-ref.ts
+function resolveRunScriptThreadRef(ref) {
+  const explicit = ref?.trim();
+  if (explicit) return explicit;
+  const siblings = threadsSharingWorktree(process.cwd());
+  const thread = siblings[0];
+  if (!thread) {
+    throw new Error(
+      "No Sideboard thread for this cwd. Pass ref (thread id), or call from a worktree chat."
+    );
+  }
+  return thread.id;
+}
+
 // src/mcp/thread-visibility.ts
 function lastMessagePreview(messages, max = 160) {
   if (!messages?.length) return null;
@@ -4840,23 +4945,23 @@ function registerScheduleTools(server) {
 }
 
 // src/board/load-home-board.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, unlinkSync as unlinkSync2, writeFileSync as writeFileSync2 } from "fs";
-import { join as join2 } from "path";
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync3, unlinkSync as unlinkSync3, writeFileSync as writeFileSync2 } from "fs";
+import { join as join3 } from "path";
 
 // src/board/board-pins.ts
 import { randomUUID as randomUUID2 } from "crypto";
-import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "fs";
-import { join } from "path";
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, unlinkSync as unlinkSync2, writeFileSync } from "fs";
+import { join as join2 } from "path";
 var FILE = "home-board-pins.json";
 var VERSION = 1;
 function pinsFile() {
-  return join(appDataDir(), FILE);
+  return join2(appDataDir(), FILE);
 }
 function readDisk() {
   const path2 = pinsFile();
-  if (!existsSync(path2)) return [];
+  if (!existsSync2(path2)) return [];
   try {
-    const raw = JSON.parse(readFileSync(path2, "utf8"));
+    const raw = JSON.parse(readFileSync2(path2, "utf8"));
     if (raw?.version !== VERSION || !Array.isArray(raw.items)) return [];
     return raw.items.filter((item) => item?.id && item.kind && item.ref);
   } catch {
@@ -4864,7 +4969,7 @@ function readDisk() {
   }
 }
 function writeDisk(items) {
-  mkdirSync(appDataDir(), { recursive: true });
+  mkdirSync2(appDataDir(), { recursive: true });
   writeFileSync(pinsFile(), JSON.stringify({ version: VERSION, items }, null, 2), "utf8");
 }
 function listBoardPins() {
@@ -4917,7 +5022,7 @@ function replaceBoardPins(items) {
 }
 function clearBoardPins() {
   try {
-    unlinkSync(pinsFile());
+    unlinkSync2(pinsFile());
   } catch {
   }
 }
@@ -4933,7 +5038,7 @@ function homeBoardWorkspaceKey(workspaces) {
   return workspaces.map((w) => w.path).filter(Boolean).sort().join("\n");
 }
 function cacheFile() {
-  return join2(appDataDir(), "home-board-cache.json");
+  return join3(appDataDir(), "home-board-cache.json");
 }
 function emptyInputs() {
   return {
@@ -4959,9 +5064,9 @@ function shouldCacheHomeBoardInputs(inputs) {
 }
 function readDiskCache() {
   const path2 = cacheFile();
-  if (!existsSync2(path2)) return null;
+  if (!existsSync3(path2)) return null;
   try {
-    const raw = JSON.parse(readFileSync2(path2, "utf8"));
+    const raw = JSON.parse(readFileSync3(path2, "utf8"));
     if (raw?.version !== CACHE_VERSION || typeof raw.fetchedAt !== "number") {
       return null;
     }
@@ -4975,14 +5080,14 @@ function readDiskCache() {
 }
 function writeDiskCache(entry) {
   try {
-    mkdirSync2(appDataDir(), { recursive: true });
+    mkdirSync3(appDataDir(), { recursive: true });
     writeFileSync2(cacheFile(), JSON.stringify(entry), "utf8");
   } catch {
   }
 }
 function deleteDiskCache() {
   try {
-    unlinkSync2(cacheFile());
+    unlinkSync3(cacheFile());
   } catch {
   }
 }
@@ -5273,7 +5378,7 @@ async function startMcpServer() {
     );
   }
   try {
-    const { maxConcurrentAgents: maxConcurrentAgents2 } = await import("./app-settings-V2BBCX2H.js");
+    const { maxConcurrentAgents: maxConcurrentAgents2 } = await import("./app-settings-UXWCPDEA.js");
     orch.setMaxConcurrent(maxConcurrentAgents2());
   } catch {
   }
@@ -5328,7 +5433,7 @@ async function startMcpServer() {
       async () => {
         const threads = orch.getThreads(true);
         const lines = threads.map((t) => {
-          const repo = t.repoPath === GLOBAL_WORKSPACE_ID ? "Orchestration" : basename(t.repoPath) || t.repoPath;
+          const repo = t.repoPath === GLOBAL_WORKSPACE_ID ? "Orchestration" : basename2(t.repoPath) || t.repoPath;
           const live = orch.threadLooksLive(t) ? readTurnLive(t.id) : null;
           const parent = t.parentThreadId ? `  parent:${t.parentThreadId.slice(0, 8)}` : "";
           const preview = lastMessagePreview(t.messages, 80);
@@ -5576,19 +5681,79 @@ async function startMcpServer() {
     "Stop a detached job you started with detached-job.cjs when it is hanging, producing no useful output, buffering forever, or doing the wrong thing (wrong project, infinite watch, huge dump). Do not stop a pack/test/deploy that is clearly making progress. The type=log pane updates to status=failed with the last delta. Then decide the next step.",
     {
       id: z9.string().describe("Detached job id (same kebab-case id passed to detached-job.cjs start)"),
-      reason: z9.string().optional().describe("Why you are stopping (hanging, no progress, wrong output, already have the error)")
+      reason: z9.string().optional().describe("Why you are stopping (hanging, no progress, wrong output, already have the answer)")
     },
     async ({ id, reason }) => {
       const result = await stopDetachedJob(process.cwd(), id, { reason });
       return mcpJson(result);
     }
   );
+  server.tool(
+    "list_run_scripts",
+    "List .sideboard/.conductor run scripts for this thread (same menu as the desktop Dev button) and which are active. Worktree turns may omit ref (uses cwd).",
+    {
+      ref: z9.string().optional().describe("Thread id. Omit on a worktree turn (uses cwd).")
+    },
+    async ({ ref }) => {
+      try {
+        const threadRef = resolveRunScriptThreadRef(ref);
+        const scripts = orch.listThreadRunScripts(threadRef);
+        const active = orch.getActiveRuns(threadRef);
+        return mcpJson({ scripts, active, ref: threadRef });
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: message }], isError: true };
+      }
+    }
+  );
+  server.tool(
+    "run_dev_script",
+    "Start a .sideboard/.conductor run script (same as the desktop Dev / play button). Logs and Stop appear in the thread UI \u2014 do not detached-job or shell-spawn the same command. Returns the allocated port. Worktree turns may omit ref (uses cwd). Omit name for the default script.",
+    {
+      ref: z9.string().optional().describe("Thread id. Omit on a worktree turn (uses cwd)."),
+      name: z9.string().optional().describe("Script name from list_run_scripts (default script if omitted).")
+    },
+    async ({ ref, name }) => {
+      try {
+        const threadRef = resolveRunScriptThreadRef(ref);
+        const result = await orch.startDev(threadRef, name);
+        return mcpJson({
+          port: result.port,
+          scriptName: result.scriptName,
+          ports: result.ports,
+          url: `http://localhost:${result.port}`,
+          ref: threadRef
+        });
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: message }], isError: true };
+      }
+    }
+  );
+  server.tool(
+    "stop_dev_script",
+    "Stop a run script started with run_dev_script or the desktop Dev button (same as UI Stop). Omit name to stop all scripts on this worktree. Worktree turns may omit ref (uses cwd).",
+    {
+      ref: z9.string().optional().describe("Thread id. Omit on a worktree turn (uses cwd)."),
+      name: z9.string().optional().describe("Script name to stop; omit to stop all active scripts.")
+    },
+    async ({ ref, name }) => {
+      try {
+        const threadRef = resolveRunScriptThreadRef(ref);
+        orch.stopDev(threadRef, name);
+        return mcpJson({ ok: true, ref: threadRef, stopped: name ?? "all" });
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: message }], isError: true };
+      }
+    }
+  );
   if (!worktreeProfile) {
     registerSlackTools(server);
     registerConnectedIssueVendorTools(server);
     registerScheduleTools(server);
     const { getCaffeinateHold: getCaffeinateHold2, setCaffeinateHold: setCaffeinateHold2 } = await import("./caffeinate-hold-22VFDPSO.js");
-    const { resolveNewThreadOptions: resolveNewThreadOptions2, resolveThreadDefaults: resolveThreadDefaults2 } = await import("./app-settings-V2BBCX2H.js");
+    const { resolveNewThreadOptions: resolveNewThreadOptions2, resolveThreadDefaults: resolveThreadDefaults2 } = await import("./app-settings-UXWCPDEA.js");
     const accountDefaults = resolveThreadDefaults2();
     const accountDefaultsHint = `Account defaults: agent=${accountDefaults.agent}, model=${accountDefaults.model?.trim() || "Auto"}, effort=${accountDefaults.effort}`;
     server.tool(
@@ -6061,45 +6226,6 @@ async function startMcpServer() {
         }
       }
     );
-    server.tool(
-      "run_dev_script",
-      "Start a .sideboard/.conductor run script for a thread (default script if name omitted); returns port",
-      {
-        ref: z9.string(),
-        name: z9.string().optional()
-      },
-      async ({ ref, name }) => {
-        const result = await orch.startDev(ref, name);
-        return mcpJson({
-          port: result.port,
-          scriptName: result.scriptName,
-          ports: result.ports,
-          url: `http://localhost:${result.port}`
-        });
-      }
-    );
-    server.tool(
-      "list_run_scripts",
-      "List named run scripts available for a thread",
-      { ref: z9.string() },
-      async ({ ref }) => {
-        const scripts = orch.listThreadRunScripts(ref);
-        const active = orch.getActiveRuns(ref);
-        return mcpJson({ scripts, active });
-      }
-    );
-    server.tool(
-      "stop_dev_script",
-      "Stop a running script for a thread (all scripts if name omitted)",
-      {
-        ref: z9.string(),
-        name: z9.string().optional()
-      },
-      async ({ ref, name }) => {
-        orch.stopDev(ref, name);
-        return { content: [{ type: "text", text: "ok" }] };
-      }
-    );
     server.tool(
       "run_setup",
       "Re-run workspace setup (Sideboard/Conductor settings, .cursor/worktrees.json, or script/setup). New worktrees already run this automatically.",
@@ -8587,6 +8713,9 @@ export {
   ABLETIME_ORG_KEY_PREFIX,
   ABLETIME_PAT_PREFIX,
   ABLETIME_PM_TOOL_NAMES,
+  AGENT_DONE_CUSTOM_SOUND_EXTENSIONS,
+  AGENT_DONE_CUSTOM_SOUND_MAX_BYTES,
+  AGENT_DONE_SOUNDS,
   AGENT_GIT_ACTIONS,
   AGENT_RUNNER_MAX_OLD_SPACE_MB,
   ATTACHMENTS_DIR,
@@ -8709,6 +8838,9 @@ export {
   addStackLayerFromThread,
   addWorkspace,
   adoptThread,
+  agentDoneCustomSoundMime,
+  agentDoneSound,
+  agentDoneSoundsDir,
   agentGitPrompt,
   alignQueueAttachments,
   allAdapters,
@@ -8787,6 +8919,7 @@ export {
   claudeUserSettingsPath,
   cleanupArchivedHistory,
   cleanupOrphanWorktrees,
+  clearAgentDoneCustomSoundFile,
   clearBoardPins,
   clearHomeBoardCache,
   clipAgentEventForPaint,
@@ -8889,6 +9022,7 @@ export {
   fetchOriginForWorktree,
   fetchPrHead,
   finalizeParts,
+  findAgentDoneCustomSoundPath,
   findConventionSetup,
   findInvalidCacheControlTtlOrder,
   findLastBrightsyContextSummary,
@@ -9023,6 +9157,7 @@ export {
   historyMaxDays,
   hottestClaudeWindow,
   httpFetch,
+  importAgentDoneCustomSound,
   importConductorWorkspace,
   importConductorWorkspaceAsync,
   initPrStack,
@@ -9038,6 +9173,7 @@ export {
   isAbleTimeConnected,
   isAbleTimeOAuthCancelled,
   isAbleTimeRejectedCredential,
+  isAgentDoneSound,
   isAskUserToolName,
   isBrightsyConnected,
   isBrightsyNdjsonLine,
@@ -9229,6 +9365,7 @@ export {
   primaryCheckoutFromLinkedWorktree,
   promptMentionsBrightsy,
   pushBranch,
+  readAgentDoneCustomSound,
   readExistingReviewRequestFile,
   readKeychainVaultKey,
   readPlanFile,
@@ -9255,6 +9392,8 @@ export {
   requestOccupancy,
   requestReview,
   requireAgent,
+  reservePort,
+  reservePortRange,
   resetGhStackDetectCache,
   resetGithubAgentTokenMemo,
   resolveAbleTimeOAuthHost,