@sideboard-ai/core 0.1.228 → 0.1.230

package/dist/{chunk-72XUASTH.js → chunk-HZLZ34FK.js}

@@ -24,7 +24,7 @@ import {
   resolveQuotaFallbackAgent,
   stripBrightsyNdjsonNoise,
   toolDescription
-} from "./chunk-VUW3VKLW.js";
+} from "./chunk-FA4CPYCY.js";
 import {
   SLACK_REPLY_FORMATTING,
   addWorkspace,
@@ -47,7 +47,7 @@ import {
   stageAbsolutePathsAsAttachments,
   stageBuffersAsAttachments,
   syncWorkspacesFromThreads
-} from "./chunk-N2VST3NL.js";
+} from "./chunk-HZFLKVGC.js";
 import {
   addPrStackLayer,
   allocateTeamName,
@@ -96,7 +96,7 @@ import {
   worktreeDisplayLabelForGroup,
   worktreeNameFromPath,
   worktreeSlugForTicket
-} from "./chunk-KTZESHYH.js";
+} from "./chunk-N5TX66CD.js";
 import {
   ATTACHMENTS_DIR,
   DETACHED_JOBS_DIR,
@@ -163,7 +163,7 @@ import {
   updateAdvancedSettings,
   usageOnLimit,
   writeSecureJson
-} from "./chunk-EWHJNJHV.js";
+} from "./chunk-I5NC7DWO.js";
 import {
   examplePrefixedBranch,
   sanitizeGitBranchPrefix
@@ -185,7 +185,7 @@ import {
   updateThread,
   withThreadLock,
   writeThread
-} from "./chunk-3IMSQNTS.js";
+} from "./chunk-4VGCG2HV.js";
 import {
   appDataDir,
   findConventionSetup,
@@ -482,7 +482,7 @@ async function continueSourceThread(threadId, prompt) {
       await continueOnReply(threadId, prompt);
       return;
     }
-    const { getOrchestrator: getOrchestrator2 } = await import("./orchestrator-QUJORSTA.js");
+    const { getOrchestrator: getOrchestrator2 } = await import("./orchestrator-ZT3SJVKF.js");
     await getOrchestrator2().send(threadId, prompt);
   } catch {
   }
@@ -742,6 +742,7 @@ async function pollSlackOutboundWatches(opts) {
 }
 
 // src/orchestrator/orchestrator.ts
+import { randomUUID as randomUUID5 } from "crypto";
 import { existsSync as existsSync19 } from "fs";
 
 // src/agents/spawn.ts
@@ -900,9 +901,9 @@ async function spawnAgentTurn(thread, input, onEvent) {
       `Cannot spawn ${thread.agent}: thread ${thread.id} has no worktreePath`
     );
   }
-  const { isGlobalThread: isGlobalThread2 } = await import("./global-workspace-3FDAUNN2.js");
+  const { isGlobalThread: isGlobalThread2 } = await import("./global-workspace-4SPANNJT.js");
   if (isGlobalThread2(thread)) {
-    const { ensureGlobalCoordinatorCwd: ensureGlobalCoordinatorCwd2 } = await import("./coordinator-prompt-JLMQVORO.js");
+    const { ensureGlobalCoordinatorCwd: ensureGlobalCoordinatorCwd2 } = await import("./coordinator-prompt-DFXYTM6D.js");
     ensureGlobalCoordinatorCwd2(
       isOrchestratorThread(thread) ? { orchestratorThreadId: thread.id } : void 0
     );
@@ -2981,6 +2982,11 @@ async function cloneRepoIntoSideboard(opts) {
   return { repoPath, workspace };
 }
 
+// src/types/thread.ts
+function isUnclaimedRunScriptRequest(req) {
+  return Boolean(req && !req.claimedAt && !req.fulfilledAt && !req.error);
+}
+
 // src/store/desktop-host.ts
 import { readFileSync as readFileSync6, unlinkSync, writeFileSync as writeFileSync3 } from "fs";
 import { join as join11 } from "path";
@@ -4086,7 +4092,7 @@ async function createThread(input, _onSetupLine) {
   });
   await requireAgent(resolved.agent);
   if (input.cowboy) {
-    const { cowboyModeEnabled } = await import("./app-settings-V2BBCX2H.js");
+    const { cowboyModeEnabled } = await import("./app-settings-UXWCPDEA.js");
     if (!cowboyModeEnabled()) {
       throw new Error(
         "Cowboy mode is off. Enable it in Settings \u2192 Advanced."
@@ -4144,7 +4150,7 @@ async function createThread(input, _onSetupLine) {
   let sourceIsFork = false;
   if (!input.cowboy && sourceType === "branch" && (!sourceRef || sourceRef === "HEAD" || sourceRef === "default")) {
     if (isAbleTimeConnected() && getIssueSource() === "abletime") {
-      const { ensureAbleTimeTask, issueAttachmentForAbleTimeTask } = await import("./abletime-D6773P33.js");
+      const { ensureAbleTimeTask, issueAttachmentForAbleTimeTask } = await import("./abletime-BGVOCEOU.js");
       const task = await ensureAbleTimeTask({
         title: title?.trim() || "Untitled work",
         description: input.prompt?.trim() || void 0
@@ -4246,7 +4252,7 @@ async function createThread(input, _onSetupLine) {
   return readThread(thread.id) ?? thread;
 }
 async function listLinearIssues(agent, repoPath) {
-  const { getAdapter: getAdapter2 } = await import("./agents-QQ77D7VT.js");
+  const { getAdapter: getAdapter2 } = await import("./agents-TCTEAK6M.js");
   await requireAgent(agent, { requireLinear: true });
   const adapter = getAdapter2(agent);
   if (!adapter.listLinearIssues) {
@@ -4719,7 +4725,7 @@ async function adoptThread(input) {
     messages: input.messages ?? []
   });
   writeThread(thread);
-  const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-76W7IEKR.js");
+  const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-73Y7IJY2.js");
   await ensureWorkspace2(repoPath);
   const { ensureWorktreeSideboardIgnored: ensureWorktreeSideboardIgnored2 } = await import("./worktree-exclude-L32WEBX6.js");
   await ensureWorktreeSideboardIgnored2(input.worktreePath);
@@ -6812,12 +6818,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 [
@@ -6829,7 +6836,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.";
 }
 
 // src/review/review-write-gate.ts
@@ -7400,7 +7407,7 @@ function formatScheduledPrompt(name, prompt) {
 ${prompt}`;
 }
 async function defaultDeps() {
-  const { getOrchestrator: getOrchestrator2, startOrchestration: startOrchestration2 } = await import("./orchestrator-QUJORSTA.js");
+  const { getOrchestrator: getOrchestrator2, startOrchestration: startOrchestration2 } = await import("./orchestrator-ZT3SJVKF.js");
   const orch = getOrchestrator2();
   return {
     findThread: (id) => findThreadByRef(id),
@@ -7505,6 +7512,7 @@ function armSchedules() {
 
 // src/orchestrator/orchestrator.ts
 var LIVE_TURN_SPAWN_GRACE_MS = 15e3;
+var RUN_SCRIPT_DESKTOP_ADOPT_MS = 2e4;
 function isPidAlive(pid) {
   if (!Number.isFinite(pid) || pid <= 0) return false;
   try {
@@ -7583,6 +7591,11 @@ var Orchestrator = class {
   jobContinueNudged = /* @__PURE__ */ new Set();
   /** In-flight startDev per worktree run key — agent MCP + UI Start must not double-spawn. */
   startingDev = /* @__PURE__ */ new Map();
+  /**
+   * MCP/CLI poll budget while Electron main adopts `runScriptRequest`.
+   * Tests shorten this so a missing desktop does not wait 20s.
+   */
+  runScriptAdoptTimeoutMs = RUN_SCRIPT_DESKTOP_ADOPT_MS;
   maxConcurrent;
   runningCount = 0;
   constructor(opts) {
@@ -7717,7 +7730,7 @@ var Orchestrator = class {
           orphans: orphans.map((o) => ({ path: o.path, repoPath: o.repoPath }))
         });
       }
-      const { autoCleanupOrphansEnabled } = await import("./app-settings-V2BBCX2H.js");
+      const { autoCleanupOrphansEnabled } = await import("./app-settings-UXWCPDEA.js");
       if (autoCleanupOrphansEnabled() && shouldRunWorktreeCleanup() && orphans.length > 0) {
         await cleanupOrphanWorktrees({ repoPaths });
       }
@@ -7752,6 +7765,58 @@ var Orchestrator = class {
         this.armDrain(thread.id);
       }
     }
+    this.adoptPersistedRunScripts();
+  }
+  /**
+   * Adopt run-script start/stop persisted by MCP/CLI while this process owns
+   * live children (desktop host). Spawning in stdio leaves the Run tab on
+   * "Starting…" with no logs — `run_output` never reaches the renderer.
+   */
+  adoptPersistedRunScripts() {
+    if (!this.shouldOwnRunScripts()) return;
+    for (const thread of listThreads()) {
+      if (thread.status === "archived") continue;
+      const req = thread.runScriptRequest;
+      if (!isUnclaimedRunScriptRequest(req) || !req) continue;
+      const claimedAt = (/* @__PURE__ */ new Date()).toISOString();
+      const claimed = { ...req, claimedAt };
+      updateThread(thread.id, { runScriptRequest: claimed });
+      void this.applyRunScriptRequest(thread.id, claimed);
+    }
+  }
+  async applyRunScriptRequest(threadId, req) {
+    try {
+      if (req.op === "start") {
+        await this.startDev(threadId, req.scriptName ?? void 0);
+      } else {
+        await this.stopDev(threadId, req.scriptName ?? void 0);
+      }
+      const latest = readThread(threadId);
+      const current = latest?.runScriptRequest;
+      if (current?.requestId === req.requestId && !current.error) {
+        updateThread(threadId, {
+          runScriptRequest: {
+            ...current,
+            fulfilledAt: (/* @__PURE__ */ new Date()).toISOString()
+          }
+        });
+      }
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      const latest = readThread(threadId);
+      const current = latest?.runScriptRequest;
+      if (!current || current.requestId !== req.requestId) return;
+      updateThread(threadId, {
+        runScriptRequest: { ...current, error: message }
+      });
+    }
+  }
+  /**
+   * Same rule as agent-queue drain: MCP stdio must not own Electron children
+   * while Sideboard.app is alive.
+   */
+  shouldOwnRunScripts() {
+    return thisProcessShouldDrainAgentQueues();
   }
   /**
    * Mid-session: a worktree can sit at `running` after the agent process dies
@@ -8004,7 +8069,7 @@ var Orchestrator = class {
     }
     await setup;
     if (skipSetup) return;
-    const { autoRunAfterSetupEnabled } = await import("./app-settings-V2BBCX2H.js");
+    const { autoRunAfterSetupEnabled } = await import("./app-settings-UXWCPDEA.js");
     if (autoRunAfterSetupEnabled()) {
       try {
         await this.startDev(threadId);
@@ -8360,7 +8425,7 @@ var Orchestrator = class {
       }
       const isBrightsy = fresh.agent === "brightsy";
       const isOrchestration = isOrchestratorThread(fresh);
-      const { autoRenameBranchEnabled, getGithubGitAuthMode, gitBranchPrefixSetting } = await import("./app-settings-V2BBCX2H.js");
+      const { autoRenameBranchEnabled, getGithubGitAuthMode, gitBranchPrefixSetting } = await import("./app-settings-UXWCPDEA.js");
       const gitAuthMode = getGithubGitAuthMode();
       const worktreeDirective = isBrightsy || isOrchestration ? null : formatWorktreeDirective(fresh, {
         githubSlug: await withTimeout(
@@ -8800,6 +8865,13 @@ var Orchestrator = class {
         "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)."
       );
     }
+    if (!this.shouldOwnRunScripts()) {
+      const result = await this.requestDesktopRunScript(thread, "start", resolvedName);
+      if (!result) {
+        throw new Error("Desktop did not return a run script port.");
+      }
+      return result;
+    }
     const runKey = worktreeRunProcessKey(thread.worktreePath, resolvedName);
     const inFlight = this.startingDev.get(runKey);
     if (inFlight) return inFlight;
@@ -8922,8 +8994,65 @@ var Orchestrator = class {
     });
     return { port: handle.port, scriptName: resolvedName, ports: handle.ports };
   }
-  stopDev(threadRef, scriptName) {
+  /**
+   * Persist a run-script intent for the desktop host (MCP/CLI while the board
+   * is alive). Polls until Electron main adopts and fulfills it.
+   */
+  async requestDesktopRunScript(thread, op, scriptName) {
+    const latest = readThread(thread.id) ?? thread;
+    const pending = latest.runScriptRequest;
+    const claimedAt = pending?.claimedAt;
+    const staleClaim = typeof claimedAt === "string" && Date.now() - Date.parse(claimedAt) > this.runScriptAdoptTimeoutMs;
+    const sameIntent = pending && pending.op === op && (pending.scriptName ?? null) === (scriptName ?? null) && !pending.error && !pending.fulfilledAt && !staleClaim;
+    const request = sameIntent ? pending : {
+      op,
+      scriptName: scriptName ?? null,
+      requestId: randomUUID5(),
+      requestedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    if (!sameIntent) {
+      updateThread(thread.id, { runScriptRequest: request });
+    }
+    return this.waitForDesktopRunScript(thread.id, request, op, scriptName);
+  }
+  async waitForDesktopRunScript(threadId, request, op, scriptName) {
+    const deadline = Date.now() + this.runScriptAdoptTimeoutMs;
+    while (Date.now() < deadline) {
+      const latest = readThread(threadId);
+      if (!latest) {
+        throw new Error("Thread disappeared while waiting for the desktop run script.");
+      }
+      const req = latest.runScriptRequest;
+      if (req?.requestId === request.requestId && req.error) {
+        throw new Error(req.error);
+      }
+      const shared = mergeWorktreeActiveRuns(threadsSharingWorktree(latest.worktreePath));
+      const run2 = scriptName ? shared.activeRuns.find((r) => r.scriptName === scriptName) : shared.activeRuns[0];
+      const fulfilled = req?.requestId === request.requestId && Boolean(req.fulfilledAt);
+      const requestGone = !req || req.requestId !== request.requestId;
+      if (op === "start") {
+        if (run2 && (fulfilled || requestGone || run2.startedAt >= request.requestedAt)) {
+          return { port: run2.port, scriptName: run2.scriptName, ports: run2.ports };
+        }
+        if (fulfilled && !run2) {
+          throw new Error("Desktop reported the run script started, but it is not active.");
+        }
+      } else {
+        const gone = scriptName ? !run2 : shared.activeRuns.length === 0;
+        if (fulfilled || gone) return null;
+      }
+      await new Promise((r) => setTimeout(r, 40));
+    }
+    throw new Error(
+      op === "start" ? "Desktop did not start the run script in time. Is Sideboard.app running this worktree?" : "Desktop did not stop the run script in time."
+    );
+  }
+  async stopDev(threadRef, scriptName) {
     const thread = this.requireThread(threadRef);
+    if (!this.shouldOwnRunScripts()) {
+      await this.requestDesktopRunScript(thread, "stop", scriptName);
+      return;
+    }
     const siblings = threadsSharingWorktree(thread.worktreePath);
     const shared = mergeWorktreeActiveRuns(siblings);
     if (scriptName) {
@@ -9504,7 +9633,7 @@ var Orchestrator = class {
     if (!titled.userSetTitle && meta.title && titled.title !== meta.title) {
       updateThread(thread.id, { title: meta.title });
     }
-    const { autoArchiveOnMergeEnabled } = await import("./app-settings-V2BBCX2H.js");
+    const { autoArchiveOnMergeEnabled } = await import("./app-settings-UXWCPDEA.js");
     const latest = this.requireThread(thread.id);
     if (!shouldAutoArchiveOnPrMerge({
       previousPrState: prevState || null,
@@ -9786,7 +9915,7 @@ var Orchestrator = class {
     this.enforceHistoryRetention();
     if (thread.repoPath && !isGlobalRepoPath(thread.repoPath)) {
       try {
-        const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-76W7IEKR.js");
+        const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-73Y7IJY2.js");
         await ensureWorkspace2(thread.repoPath);
       } catch {
       }
@@ -9813,7 +9942,7 @@ var Orchestrator = class {
           await runArchiveScript(thread.repoPath, thread.worktreePath);
         } catch {
         }
-        const { deleteBranchOnPurgeEnabled } = await import("./app-settings-V2BBCX2H.js");
+        const { deleteBranchOnPurgeEnabled } = await import("./app-settings-UXWCPDEA.js");
         const deleteBranch = opts?.deleteBranch ?? deleteBranchOnPurgeEnabled();
         await removeWorktree(thread.repoPath, thread.worktreePath, {
           deleteBranch: deleteBranch ? thread.branchName : void 0
@@ -9840,7 +9969,7 @@ var Orchestrator = class {
           `Cowboy checkout missing: ${thread.worktreePath}. Re-add the project folder, then restore.`
         );
       }
-      const { createThreadWorktree: createThreadWorktree2 } = await import("./worktree-7V67XTEO.js");
+      const { createThreadWorktree: createThreadWorktree2 } = await import("./worktree-36VEFUJN.js");
       const slug = thread.worktreePath.split("/").pop();
       const dest = thread.worktreePath;
       await withRepoGitLock(thread.repoPath, async () => {
@@ -9950,7 +10079,7 @@ async function startOrchestration(opts) {
     sourceRef: "default",
     ...createOpts
   }).catch(async () => {
-    const { resolveDefaultBranch: resolveDefaultBranch2, resolveRepoRoot: resolveRepoRoot2 } = await import("./worktree-7V67XTEO.js");
+    const { resolveDefaultBranch: resolveDefaultBranch2, resolveRepoRoot: resolveRepoRoot2 } = await import("./worktree-36VEFUJN.js");
     const repo = await resolveRepoRoot2(repoPath);
     const def = await resolveDefaultBranch2(repo);
     return orch.createThread({
@@ -9960,7 +10089,7 @@ async function startOrchestration(opts) {
       repoPath: repo
     });
   });
-  const { updateThread: upd } = await import("./thread-store-N6WQIWZ4.js");
+  const { updateThread: upd } = await import("./thread-store-IKJD4EOK.js");
   const updated = upd(thread.id, {
     sourceType: "orchestration",
     sourceRef: goal
@@ -9972,6 +10101,7 @@ async function startOrchestration(opts) {
 }
 
 export {
+  isUnclaimedRunScriptRequest,
   isHomeBoardThread,
   BOARD_COLUMN_DEFS,
   HOME_BOARD_CACHE_TTL_MS,
@@ -10220,6 +10350,7 @@ export {
   formatOptionalServicesDirective,
   formatOptionalServicesReminder,
   LIVE_TURN_SPAWN_GRACE_MS,
+  RUN_SCRIPT_DESKTOP_ADOPT_MS,
   isPidAlive,
   waitForPidExit,
   resolveSendFollowUp,

package/dist/{chunk-EWHJNJHV.js → chunk-I5NC7DWO.js}

@@ -568,6 +568,21 @@ var DEFAULT_AGENTS = /* @__PURE__ */ new Set([
 ]);
 var GITHUB_GIT_AUTH_MODES = ["auto", "gh", "ssh", "token"];
 var FOLLOW_UP_BEHAVIORS = ["steer", "queue"];
+var AGENT_DONE_SOUNDS = [
+  "none",
+  "goal",
+  "bell",
+  "level",
+  "coin",
+  "fanfare",
+  "magic",
+  "rooster",
+  "whistle",
+  "custom"
+];
+function isAgentDoneSound(value) {
+  return AGENT_DONE_SOUNDS.includes(value);
+}
 function emptyPublicIntegrations() {
   return {
     hasLinearApiKey: false,
@@ -1006,6 +1021,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) {
@@ -1929,6 +1951,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()) {
@@ -1996,6 +2028,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)) {
@@ -2140,6 +2175,8 @@ export {
   HARNESS_ENV_KEYS,
   GITHUB_GIT_AUTH_MODES,
   FOLLOW_UP_BEHAVIORS,
+  AGENT_DONE_SOUNDS,
+  isAgentDoneSound,
   emptyPublicIntegrations,
   toPublicAppSettings,
   appSettingsPath,
@@ -2208,6 +2245,7 @@ export {
   orchestrationQuotaOnLimit,
   orchestrationQuotaFallbackAgent,
   followUpBehavior,
+  agentDoneSound,
   maxConcurrentAgents,
   resolveClaudeExecutable,
   resolveAgentExecutable,