@sideboard-ai/core 0.1.227 → 0.1.229

package/dist/mcp/run-stdio.cjs

@@ -3787,12 +3787,14 @@ var init_issue_source_labels = __esm({
 // src/store/app-settings.ts
 var app_settings_exports = {};
 __export(app_settings_exports, {
+  AGENT_DONE_SOUNDS: () => AGENT_DONE_SOUNDS,
   FOLLOW_UP_BEHAVIORS: () => FOLLOW_UP_BEHAVIORS,
   GITHUB_GIT_AUTH_MODES: () => GITHUB_GIT_AUTH_MODES,
   HARNESS_ENV_KEYS: () => HARNESS_ENV_KEYS,
   ISSUE_SOURCE_LABELS: () => ISSUE_SOURCE_LABELS,
   PROFILE_NOTES_MAX: () => PROFILE_NOTES_MAX,
   USAGE_ON_LIMIT_VALUES: () => USAGE_ON_LIMIT_VALUES,
+  agentDoneSound: () => agentDoneSound,
   appSettingsPath: () => appSettingsPath,
   applyAppEnvironment: () => applyAppEnvironment,
   autoArchiveOnMergeEnabled: () => autoArchiveOnMergeEnabled,
@@ -3840,6 +3842,7 @@ __export(app_settings_exports, {
   historyMaxCount: () => historyMaxCount,
   historyMaxDays: () => historyMaxDays,
   isAbleTimeConnected: () => isAbleTimeConnected,
+  isAgentDoneSound: () => isAgentDoneSound,
   isIssueSourceConnected: () => isIssueSourceConnected,
   isLinearConnected: () => isLinearConnected,
   isUsageOnLimit: () => isUsageOnLimit,
@@ -3881,6 +3884,9 @@ __export(app_settings_exports, {
   usageOnLimit: () => usageOnLimit,
   writeViewerContext: () => writeViewerContext
 });
+function isAgentDoneSound(value) {
+  return AGENT_DONE_SOUNDS.includes(value);
+}
 function emptyPublicIntegrations() {
   return {
     hasLinearApiKey: false,
@@ -4311,6 +4317,13 @@ function normalizeAdvanced(raw) {
   if (source.followUpBehavior === "queue" || source.followUpBehavior === "steer") {
     out.followUpBehavior = source.followUpBehavior;
   }
+  if (isAgentDoneSound(source.agentDoneSound)) {
+    out.agentDoneSound = source.agentDoneSound;
+  }
+  if (typeof source.agentDoneCustomSoundName === "string") {
+    const name = source.agentDoneCustomSoundName.trim();
+    if (name) out.agentDoneCustomSoundName = name.slice(0, 200);
+  }
   return out;
 }
 function normalizeSettings(raw) {
@@ -5221,6 +5234,16 @@ function updateAdvancedSettings(patch) {
   if (patch.followUpBehavior === "queue" || patch.followUpBehavior === "steer") {
     advanced.followUpBehavior = patch.followUpBehavior;
   }
+  if (isAgentDoneSound(patch.agentDoneSound)) {
+    advanced.agentDoneSound = patch.agentDoneSound;
+  }
+  if (patch.agentDoneCustomSoundName === null || patch.agentDoneCustomSoundName === "") {
+    delete advanced.agentDoneCustomSoundName;
+  } else if (typeof patch.agentDoneCustomSoundName === "string") {
+    const name = patch.agentDoneCustomSoundName.trim();
+    if (name) advanced.agentDoneCustomSoundName = name.slice(0, 200);
+    else delete advanced.agentDoneCustomSoundName;
+  }
   return saveAppSettings({ ...current, advanced });
 }
 function autoRenameBranchEnabled(settings = loadAppSettings()) {
@@ -5288,6 +5311,9 @@ function orchestrationQuotaFallbackAgent(settings = loadAppSettings()) {
 function followUpBehavior(settings = loadAppSettings()) {
   return settings.advanced.followUpBehavior === "queue" ? "queue" : "steer";
 }
+function agentDoneSound(settings = loadAppSettings()) {
+  return isAgentDoneSound(settings.advanced.agentDoneSound) ? settings.advanced.agentDoneSound : "none";
+}
 function maxConcurrentAgents(settings = loadAppSettings()) {
   const n = settings.advanced.maxConcurrent;
   if (typeof n === "number" && Number.isFinite(n)) {
@@ -5375,7 +5401,7 @@ function childEnvWithAppSettings(extra) {
 function harnessEnvKey(harness) {
   return HARNESS_ENV_KEYS[harness];
 }
-var import_node_crypto3, import_node_fs15, import_node_os5, import_node_path18, HARNESS_ENV_KEYS, DEFAULT_AGENTS, GITHUB_GIT_AUTH_MODES, FOLLOW_UP_BEHAVIORS, CLOUD_CONNECT_AGENTS, ISSUE_SOURCES, GIT_AUTH_MODES, EMPTY_SETTINGS, CONFIRM_ACCOUNT, CONFIRM_PROJECT, DEFAULT_CLI_BIN;
+var import_node_crypto3, import_node_fs15, import_node_os5, import_node_path18, HARNESS_ENV_KEYS, DEFAULT_AGENTS, GITHUB_GIT_AUTH_MODES, FOLLOW_UP_BEHAVIORS, AGENT_DONE_SOUNDS, CLOUD_CONNECT_AGENTS, ISSUE_SOURCES, GIT_AUTH_MODES, EMPTY_SETTINGS, CONFIRM_ACCOUNT, CONFIRM_PROJECT, DEFAULT_CLI_BIN;
 var init_app_settings = __esm({
   "src/store/app-settings.ts"() {
     "use strict";
@@ -5412,6 +5438,18 @@ var init_app_settings = __esm({
     ]);
     GITHUB_GIT_AUTH_MODES = ["auto", "gh", "ssh", "token"];
     FOLLOW_UP_BEHAVIORS = ["steer", "queue"];
+    AGENT_DONE_SOUNDS = [
+      "none",
+      "goal",
+      "bell",
+      "level",
+      "coin",
+      "fanfare",
+      "magic",
+      "rooster",
+      "whistle",
+      "custom"
+    ];
     CLOUD_CONNECT_AGENTS = /* @__PURE__ */ new Set([
       "claude",
       "codex",
@@ -10242,6 +10280,9 @@ var init_injected_mcp = __esm({
       "mcp__sideboard__present_plan",
       "mcp__sideboard__wait_for_job",
       "mcp__sideboard__stop_job",
+      "mcp__sideboard__list_run_scripts",
+      "mcp__sideboard__run_dev_script",
+      "mcp__sideboard__stop_dev_script",
       "mcp__sideboard__get_viewer_context",
       "mcp__sideboard__update_viewer_context"
     ];
@@ -10451,6 +10492,13 @@ function toolDescription(name, input) {
   if (/stop_job$/i.test(name)) {
     return str2(input?.id) ? `Stop ${str2(input?.id)}` : "Stop job";
   }
+  if (/list_run_scripts$/i.test(name)) return "List run scripts";
+  if (/run_dev_script$/i.test(name)) {
+    return str2(input?.name) ? `Start ${str2(input?.name)}` : "Start Dev script";
+  }
+  if (/stop_dev_script$/i.test(name)) {
+    return str2(input?.name) ? `Stop ${str2(input?.name)}` : "Stop Dev script";
+  }
   if (isSubagentToolName(name)) {
     const desc = str2(input?.description);
     const sub = asRecord(input?.subagentType);
@@ -14630,61 +14678,92 @@ function getRunScript(worktreePath, repoPath, name) {
 function getRunMode(worktreePath, repoPath) {
   return loadWorkspaceSettings(worktreePath, repoPath)?.runMode ?? "concurrent";
 }
-async function allocatePort() {
+async function reservePort() {
   return new Promise((resolve, reject) => {
     const server = (0, import_node_net.createServer)();
+    let released = false;
+    const release = () => new Promise((res) => {
+      if (released) {
+        res();
+        return;
+      }
+      released = true;
+      server.close(() => res());
+    });
     server.listen(0, "127.0.0.1", () => {
       const addr = server.address();
       if (!addr || typeof addr === "string") {
-        server.close();
-        reject(new Error("Failed to allocate port"));
+        void release().then(() => reject(new Error("Failed to allocate port")));
         return;
       }
-      const port = addr.port;
-      server.close((err) => err ? reject(err) : resolve(port));
+      resolve({ port: addr.port, release });
     });
     server.on("error", reject);
   });
 }
-async function allocatePortRange(size = PORT_RANGE_SIZE) {
-  const base = await allocatePort();
-  const ports = [base];
-  for (let i = 1; i < size; i++) {
-    const candidate = base + i;
-    const free = await new Promise((resolve) => {
-      const server = (0, import_node_net.createServer)();
-      server.once("error", () => resolve(false));
-      server.listen(candidate, "127.0.0.1", () => {
-        server.close(() => resolve(true));
-      });
+async function tryReservePort(port) {
+  return new Promise((resolve) => {
+    const server = (0, import_node_net.createServer)();
+    let released = false;
+    const release = () => new Promise((res) => {
+      if (released) {
+        res();
+        return;
+      }
+      released = true;
+      server.close(() => res());
     });
-    if (free) {
-      ports.push(candidate);
-    } else {
-      ports.push(await allocatePort());
+    server.once("error", () => resolve(null));
+    server.listen(port, "127.0.0.1", () => {
+      resolve({ port, release });
+    });
+  });
+}
+async function reservePortRange(size = PORT_RANGE_SIZE) {
+  const held = [await reservePort()];
+  const base = held[0].port;
+  try {
+    for (let i = 1; i < size; i++) {
+      const candidate = base + i;
+      const next = await tryReservePort(candidate);
+      if (next) {
+        held.push(next);
+      } else {
+        held.push(await reservePort());
+      }
     }
+    return held;
+  } catch (err) {
+    await Promise.all(held.map((h) => h.release()));
+    throw err;
   }
-  return ports;
 }
 async function startDevServer(repoPath, worktreePath, onLine, opts) {
   const script = getRunScript(worktreePath, repoPath, opts?.scriptName);
   if (!script) return null;
-  const ports = await allocatePortRange(PORT_RANGE_SIZE);
-  const handle = await spawnWorkspaceScript(script.command, {
-    worktreePath,
-    repoPath,
-    ports,
-    defaultBranch: opts?.defaultBranch,
-    onLine
-  });
-  return {
-    pid: handle.pid,
-    port: ports[0],
-    ports,
-    scriptName: script.name,
-    kill: handle.kill,
-    done: handle.done
-  };
+  const held = await reservePortRange(PORT_RANGE_SIZE);
+  const ports = held.map((h) => h.port);
+  try {
+    await Promise.all(held.map((h) => h.release()));
+    const handle = await spawnWorkspaceScript(script.command, {
+      worktreePath,
+      repoPath,
+      ports,
+      defaultBranch: opts?.defaultBranch,
+      onLine
+    });
+    return {
+      pid: handle.pid,
+      port: ports[0],
+      ports,
+      scriptName: script.name,
+      kill: handle.kill,
+      done: handle.done
+    };
+  } catch (err) {
+    await Promise.all(held.map((h) => h.release()));
+    throw err;
+  }
 }
 var import_node_fs37, import_node_child_process4, import_node_net, import_node_path39, import_execa4, import_node_readline3, PORT_RANGE_SIZE, cachedLoginEnv;
 var init_conductor = __esm({
@@ -20498,12 +20577,13 @@ function formatLongRunningDirective(opts) {
     "- Loop Sideboard MCP `wait_for_job` (returns in ~45s). The desktop opens a `type=log` pane from wait/stop (and shell detached-job JSON) automatically \u2014 you may still `present_artifact` with `artifact_id=<id>` for a custom title. stillRunning \u2192 wait again. Shell fallback: the same helper with `wait <id>`.",
     "- Hanging, no useful output, or the wrong thing \u2192 `stop_job` (or the helper with `stop <id>`). Do not stop a pack/test/deploy that is clearly making progress.",
     "- Stay in the loop until stillRunning is false (or you stopped it). ok \u2192 finish the task. failed / stopped \u2192 read the log, fix or narrow the command, start once.",
-    "State: `.context/.sideboard/detached-jobs/<id>/` (local scratch). Full guide: `/long-running` (always available)."
+    "State: `.context/.sideboard/detached-jobs/<id>/` (local scratch). Full guide: `/long-running` (always available).",
+    "Project Dev / run scripts (`.sideboard` `[scripts.run.*]`, same as the desktop Dev button): use MCP `list_run_scripts` / `run_dev_script` / `stop_dev_script` \u2014 logs and Stop live in the thread UI. Do not detached-job or shell-spawn that same command."
   ].join("\n");
 }
 function formatLongRunningReminder(opts) {
   const invoke = formatDetachedJobInvoke(opts?.scriptPath);
-  return `Long jobs: \`${invoke} start <id> -- <cmd>\`, loop wait_for_job (or detached-job wait). The log pane updates from wait JSON; present_artifact type=log is optional. stop_job if hanging or wrong. Do not say you will let the user know later \u2014 stay in the turn.`;
+  return `Long jobs: \`${invoke} start <id> -- <cmd>\`, loop wait_for_job (or detached-job wait). The log pane updates from wait JSON; present_artifact type=log is optional. stop_job if hanging or wrong. Do not say you will let the user know later \u2014 stay in the turn. Project Dev button: list_run_scripts / run_dev_script / stop_dev_script (UI-connected \u2014 not detached-job).`;
 }
 function formatArtifactDirective() {
   return [
@@ -20515,7 +20595,7 @@ function formatArtifactDirective() {
   ].join("\n");
 }
 function formatUiReminder() {
-  return "Sideboard UI: markdown table is enough to read data; present_schema if they ask to edit/filter (even after markdown); present_files for the file manager. html fence or present_artifact, not both for the same document. type=log appends (same artifact_id, new lines only). ask_user only for a real multiple-choice (not hellos, \u201Cwhat next?\u201D, or after a review) \u2014 reply in chat. Do not say artifacts/CMS UI are unavailable.";
+  return "Sideboard UI: markdown table is enough to read data; present_schema if they ask to edit/filter (even after markdown); present_files for the file manager. html fence or present_artifact, not both for the same document. type=log appends (same artifact_id, new lines only). ask_user only for a real multiple-choice (not hellos, \u201Cwhat next?\u201D, or after a review) \u2014 reply in chat. Do not say artifacts/CMS UI are unavailable. Dev / preview: run_dev_script (same as the Dev button); stop_dev_script to stop.";
 }
 var import_node_fs50, import_node_path49, PR_GOAL_RE, GITHUB_TICKET_REF, KEYED_TICKET_REF;
 var init_instructions = __esm({
@@ -21662,6 +21742,8 @@ var init_orchestrator = __esm({
       /** Auto-continues after a worktree turn ended while a detached job still runs. */
       jobContinueCount = /* @__PURE__ */ new Map();
       jobContinueNudged = /* @__PURE__ */ new Set();
+      /** In-flight startDev per worktree run key — agent MCP + UI Start must not double-spawn. */
+      startingDev = /* @__PURE__ */ new Map();
       maxConcurrent;
       runningCount = 0;
       constructor(opts) {
@@ -22879,9 +22961,20 @@ var init_orchestrator = __esm({
             "No run script found for this worktree. Add [scripts.run.*] in the worktree\u2019s .sideboard/settings.toml or .conductor/settings.toml (or settings.local.toml on the main repo)."
           );
         }
+        const runKey = worktreeRunProcessKey(thread.worktreePath, resolvedName);
+        const inFlight = this.startingDev.get(runKey);
+        if (inFlight) return inFlight;
+        const start = this.startDevUnlocked(thread, resolvedName, scriptName, scripts, runKey);
+        this.startingDev.set(runKey, start);
+        try {
+          return await start;
+        } finally {
+          this.startingDev.delete(runKey);
+        }
+      }
+      async startDevUnlocked(thread, resolvedName, scriptName, scripts, runKey) {
         const siblings = threadsSharingWorktree(thread.worktreePath);
         const shared = mergeWorktreeActiveRuns(siblings);
-        const runKey = worktreeRunProcessKey(thread.worktreePath, resolvedName);
         const existing = this.processes.get(runKey) ?? siblings.map((t) => this.processes.get(`${t.id}:run:${resolvedName}`)).find(Boolean);
         const active = shared.activeRuns.find((r) => r.scriptName === resolvedName);
         if (existing && active) {
@@ -22893,6 +22986,14 @@ var init_orchestrator = __esm({
             return { port: shared.devPort, scriptName: resolvedName, ports: [shared.devPort] };
           }
         }
+        if (active && !existing) {
+          killListenersOnPorts(collectActiveRunPorts([active]));
+          this.syncWorktreeRuns(
+            thread.worktreePath,
+            shared.activeRuns.filter((r) => r.scriptName !== resolvedName),
+            shared.devPort === active.port ? null : shared.devPort
+          );
+        }
         const mode = getRunMode(thread.worktreePath, thread.repoPath);
         if (mode === "nonconcurrent") {
           const here = normalizeWorktreePath(thread.worktreePath);
@@ -22941,6 +23042,7 @@ var init_orchestrator = __esm({
             kill: handle.kill
           });
         }
+        const latestShared = mergeWorktreeActiveRuns(threadsSharingWorktree(thread.worktreePath));
         const run2 = {
           scriptName: resolvedName,
           port: handle.port,
@@ -22948,13 +23050,13 @@ var init_orchestrator = __esm({
           startedAt
         };
         const nextRuns = [
-          ...shared.activeRuns.filter((r) => r.scriptName !== resolvedName),
+          ...latestShared.activeRuns.filter((r) => r.scriptName !== resolvedName),
           run2
         ];
         this.syncWorktreeRuns(
           thread.worktreePath,
           nextRuns,
-          isDefault ? handle.port : shared.devPort
+          isDefault ? handle.port : latestShared.devPort
         );
         this.emit({
           type: "dev_server_started",
@@ -25677,6 +25779,23 @@ function mcpArchiveBlockedReason(thread) {
 
 // src/mcp/server.ts
 init_profile();
+
+// src/mcp/run-script-ref.ts
+init_chat_tabs();
+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/server.ts
 init_wait_for_turn();
 init_wait_for_job();
 init_message_parts();
@@ -28108,13 +28227,73 @@ 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: import_zod9.z.string().describe("Detached job id (same kebab-case id passed to detached-job.cjs start)"),
-      reason: import_zod9.z.string().optional().describe("Why you are stopping (hanging, no progress, wrong output, already have the error)")
+      reason: import_zod9.z.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: import_zod9.z.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: import_zod9.z.string().optional().describe("Thread id. Omit on a worktree turn (uses cwd)."),
+      name: import_zod9.z.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: import_zod9.z.string().optional().describe("Thread id. Omit on a worktree turn (uses cwd)."),
+      name: import_zod9.z.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);
@@ -28593,45 +28772,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: import_zod9.z.string(),
-        name: import_zod9.z.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: import_zod9.z.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: import_zod9.z.string(),
-        name: import_zod9.z.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.",