@sideboard-ai/core 0.1.136 → 0.1.142

package/dist/index.js

@@ -1,6 +1,9 @@
 import {
   AGENT_GIT_ACTIONS,
   BOARD_COLUMN_DEFS,
+  BUNDLED_LONG_RUNNING_PATH,
+  BUNDLED_SKILL_PREFIX,
+  CHARS_PER_CONTEXT_TOKEN,
   CONTEXT_COMPACT_CHARS,
   CONTEXT_KEEP_RECENT_CHARS,
   CONTEXT_KEEP_RECENT_MESSAGES,
@@ -9,6 +12,9 @@ import {
   HOME_BOARD_AGENT_HINT,
   HOME_BOARD_CACHE_TTL_MS,
   LEGACY_REVIEW_REQUEST_PATH,
+  LONG_RUNNING_SKILL_COMMAND,
+  OPTIONAL_SERVICES,
+  OPTIONAL_SERVICE_IDS,
   Orchestrator,
   REPO_REVIEW_NAME,
   REPO_REVIEW_PATH,
@@ -26,6 +32,7 @@ import {
   allocatePort,
   allocatePortRange,
   applyCompaction,
+  applyForwardOccupancy,
   applyPromptCacheTtlEnv,
   applyThreadIntoMain,
   armSchedules,
@@ -44,7 +51,9 @@ import {
   computeNextRunAt,
   conductorDbPath,
   confirmLand,
+  connectOptionalService,
   connectSlackToken,
+  connectedOptionalServices,
   copyConfiguredFiles,
   createChatTab,
   createPrStack,
@@ -56,11 +65,13 @@ import {
   deleteSchedule,
   desktopHostPidPath,
   detectAgents,
+  disconnectOptionalService,
   disconnectSlackWorkspace,
   discoverSkills,
   ensureReviewRequestFile,
   ensureReviewSkillFile,
   estimateMessageChars,
+  estimateOccupancyTokens,
   estimateThreadChars,
   expandComposerPrompt,
   extractiveSummary,
@@ -76,7 +87,12 @@ import {
   forkThreadWorktree,
   formatAgentInstructions,
   formatArtifactDirective,
+  formatDetachedJobInvoke,
+  formatLongRunningDirective,
+  formatLongRunningReminder,
   formatMessagesAsTranscript,
+  formatOptionalServicesDirective,
+  formatOptionalServicesReminder,
   formatProcessGuideDirective,
   formatRenameBranchDirective,
   formatScheduleWhen,
@@ -88,6 +104,8 @@ import {
   formatUiReminder,
   formatWorktreeDirective,
   formatWorktreeReminder,
+  forwardContextUsage,
+  forwardOccupancyTokens,
   getDefaultRunScript,
   getDiff,
   getDiffSummary,
@@ -108,6 +126,7 @@ import {
   isCowboyThread,
   isDesktopHostAlive,
   isHomeBoardThread,
+  isOptionalServiceId,
   isPidAlive,
   isPrimaryCheckoutThread,
   isSlackExternalReplyPrompt,
@@ -125,8 +144,12 @@ import {
   listWorktreeFiles,
   loadAgentInstructions,
   maybeCompactContext,
+  normalizeServiceOrigin,
   openPrStackLayers,
   openStackLayer,
+  optionalServiceConnected,
+  optionalServiceSpec,
+  packagedDetachedJobPath,
   parseDurationMs,
   pendingSlackExternalReplies,
   pollSlackOutboundWatches,
@@ -144,6 +167,7 @@ import {
   requireAgent,
   requireSlackWorkspace,
   resolveConductorCursorAgentId,
+  resolveDetachedJobScript,
   resolveFilesToCopy,
   resolveReviewGuidelines,
   resolveScheduleThreadId,
@@ -172,16 +196,18 @@ import {
   syncBoardPins,
   takenTeamSlugsForChatTab,
   thisProcessShouldDrainAgentQueues,
+  threadHasCompactedContext,
   threadsSharingWorktree,
   updateSchedule,
   upsertSlackWorkspace,
+  verifyOptionalService,
   waitForPidExit,
   withAgentInstructions,
   worktreeBoardStatus,
   worktreeCleanupSettings,
   wrapReviewSkillMarkdown,
   writeWorktreeFile
-} from "./chunk-TIGKDMIA.js";
+} from "./chunk-FGOD5MQ4.js";
 import {
   BRIGHTSY_MCP_ALLOWED_TOOLS,
   CLAUDE_MODEL_CATALOG,
@@ -212,6 +238,7 @@ import {
   getAdapter,
   getAgentSetupInfo,
   installAgent,
+  installNpmGlobalPackage,
   isBrightsyConnected,
   isBrightsyNdjsonLine,
   isCursorAutoModel,
@@ -258,10 +285,11 @@ import {
   toolFilePath,
   totalTokens,
   visibleToolRowDetail,
+  whichOnPath,
   withEventParentId,
   withEventsParentId,
   writeInjectedMcpConfig
-} from "./chunk-CYM5DCHI.js";
+} from "./chunk-VHTIHOHE.js";
 import {
   brightsyMcpServerName,
   connectBrightsyTeam,
@@ -286,7 +314,7 @@ import {
   listWorkspaces,
   removeWorkspace,
   syncWorkspacesFromThreads
-} from "./chunk-MDCKV2NF.js";
+} from "./chunk-HC5N3BDL.js";
 import {
   CLOUD_COORDINATOR_BUSY_REPLY,
   CLOUD_COORDINATOR_STOPPED_REPLY,
@@ -321,7 +349,7 @@ import {
   stageAbsolutePathsAsAttachments,
   stageBuffersAsAttachments,
   takenTeamSlugsForOrchestration
-} from "./chunk-GSKRGF7B.js";
+} from "./chunk-R2W7A2UO.js";
 import {
   COORDINATOR_TOOL_PLAYBOOK,
   SLACK_REPLY_FORMATTING,
@@ -330,7 +358,7 @@ import {
   enrichWorkspacesWithGithub,
   ensureGlobalCoordinatorCwd,
   formatWorkspaceInventory
-} from "./chunk-IFZ4MOTN.js";
+} from "./chunk-UG5N7ET3.js";
 import {
   ABLETIME_MCP_PATH,
   DEFAULT_ABLETIME_HOST,
@@ -352,7 +380,7 @@ import {
   taskUrl,
   toAbleTimeIssueInfo,
   verifyAbleTimeConnection
-} from "./chunk-AT346U23.js";
+} from "./chunk-VZJVKQHH.js";
 import {
   formatFetchError,
   httpFetch,
@@ -378,7 +406,7 @@ import {
   preferredCursorCostCents,
   turnCostUsdFromCursorUsage,
   withMaxOldSpaceSize
-} from "./chunk-FSCQXMGI.js";
+} from "./chunk-WT5HSFOU.js";
 import {
   caffeinateHoldPath,
   getCaffeinateHold,
@@ -467,7 +495,7 @@ import {
   worktreeDisplayLabel,
   worktreeDisplayLabelForGroup,
   worktreeNameFromPath
-} from "./chunk-HQQNLDVC.js";
+} from "./chunk-O3JEC2UJ.js";
 import {
   ATTACHMENTS_DIR,
   LEGACY_ATTACHMENTS_DIR,
@@ -498,6 +526,7 @@ import {
   deleteBranchOnPurgeEnabled,
   disconnectAbleTimeConnection,
   disconnectLinearConnection,
+  emptyPublicIntegrations,
   ensureSlackDeviceIdentity,
   getAbleTimeAccessToken,
   getAbleTimeHost,
@@ -544,7 +573,7 @@ import {
   updateDefaultsSettings,
   updateIntegrationsSettings,
   updateOpencodeSettings
-} from "./chunk-GJBHOJCZ.js";
+} from "./chunk-I77RYPOH.js";
 import {
   stripNestedElectronEnv
 } from "./chunk-4TR3HZFT.js";
@@ -564,7 +593,7 @@ import {
   updateThread,
   withThreadLock,
   writeThread
-} from "./chunk-PM3C2J6K.js";
+} from "./chunk-TUGKX5BD.js";
 import {
   THINKING_EFFORTS,
   isThinkingEffort,
@@ -1388,6 +1417,42 @@ async function listIssues(repoPath) {
   };
 }
 
+// src/integrations/optional-cli.ts
+async function detectOptionalServiceClis() {
+  enrichPathWithNpmGlobalBin();
+  return Promise.all(
+    OPTIONAL_SERVICES.map(async (spec) => {
+      if (!spec.cli) {
+        return { id: spec.id, cli: null, installed: false, path: null };
+      }
+      const path2 = await whichOnPath(spec.cli);
+      return {
+        id: spec.id,
+        cli: spec.cli,
+        installed: Boolean(path2),
+        path: path2
+      };
+    })
+  );
+}
+async function installOptionalServiceCli(id) {
+  if (!isOptionalServiceId(id)) {
+    return { ok: false, message: "Unknown optional service" };
+  }
+  const spec = optionalServiceSpec(id);
+  if (!spec.cli || !spec.npmPackage) {
+    return {
+      ok: false,
+      message: `${spec.label} has no CLI to install. Use the HTTP API with the stored token.`
+    };
+  }
+  return installNpmGlobalPackage({
+    npmPackage: spec.npmPackage,
+    installCommand: `npm install -g ${spec.npmPackage}`,
+    cliBin: spec.cli
+  });
+}
+
 // src/composer/diff-comment.ts
 function lineRangeLabel(lines) {
   const nos = lines.map((l) => l.lineNo);
@@ -1627,6 +1692,27 @@ function mcpWaitFinishedHint(status) {
   return void 0;
 }
 
+// src/mcp/thread-visibility.ts
+function lastMessagePreview(messages, max = 160) {
+  if (!messages?.length) return null;
+  for (let i = messages.length - 1; i >= 0; i--) {
+    const text5 = messages[i]?.text?.trim();
+    if (!text5) continue;
+    const flat = text5.replace(/\s+/g, " ");
+    return flat.length > max ? `${flat.slice(0, max)}\u2026` : flat;
+  }
+  return null;
+}
+function childThreadRefs(parentId, threads) {
+  return threads.filter((t) => t.parentThreadId === parentId).map((t) => ({
+    id: t.id,
+    title: t.title,
+    status: t.status,
+    agent: t.agent,
+    lastText: lastMessagePreview(t.messages, 120)
+  }));
+}
+
 // src/mcp/slack-tools.ts
 import { z } from "zod";
 
@@ -1873,14 +1959,14 @@ function fail(err) {
 function registerSlackTools(server) {
   server.tool(
     "list_teams",
-    "List Slack workspaces connected in Sideboard Account settings. Each row is team_id + name. Pass team_id to slack_list_channels, slack_list_users, slack_search, slack_read, slack_post, and slack_replies.",
+    "List Slack workspaces connected in Settings \u2192 Remote. Each row is team_id + name. Pass team_id to slack_list_channels, slack_list_users, slack_search, slack_read, slack_post, and slack_replies.",
     {},
     async () => {
       const teams = listSlackWorkspaces();
       if (teams.length === 0) {
         return text({
           teams: [],
-          hint: "No Slack workspaces connected. Add one in Account \u2192 Slack workspaces (paste xoxb-/xoxp- or browser sign-in)."
+          hint: "No Slack workspaces connected. Add one in Settings \u2192 Remote \u2192 Slack (paste xoxb-/xoxp- or browser sign-in)."
         });
       }
       return text({
@@ -2901,7 +2987,7 @@ async function startMcpServer() {
     );
   }
   try {
-    const { maxConcurrentAgents: maxConcurrentAgents2 } = await import("./app-settings-U5RZKUXG.js");
+    const { maxConcurrentAgents: maxConcurrentAgents2 } = await import("./app-settings-WJDCJFSY.js");
     orch.setMaxConcurrent(maxConcurrentAgents2());
   } catch {
   }
@@ -2940,15 +3026,19 @@ async function startMcpServer() {
     );
     server.tool(
       "list_threads",
-      "List Sideboard threads across all workspaces (one summary line each \u2014 token-frugal). Each line ends with sideboard://thread/<id> \u2014 use that URL in markdown links so the UI can open the chat.",
+      "List Sideboard threads across all workspaces (one summary line each \u2014 token-frugal). Includes parent id, last message preview, and live progress so you can see worktree children. Each line ends with sideboard://thread/<id> \u2014 use that URL in markdown links so the UI can open the chat.",
       {},
       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 live = t.status === "running" || t.status === "queued" ? readTurnLive(t.id) : null;
+          const parent = t.parentThreadId ? `  parent:${t.parentThreadId.slice(0, 8)}` : "";
+          const preview = lastMessagePreview(t.messages, 80);
+          const previewBit = preview ? `  ${preview}` : "";
+          const err = t.lastError ? `  error:${t.lastError.replace(/\s+/g, " ").slice(0, 60)}` : "";
           const progress = live?.summary ? `  ${live.summary}` : "";
-          return `${t.id.slice(0, 8)}  ${t.status.padEnd(9)}  ${t.agent.padEnd(8)}  ${repo}  ${t.sourceType}:${t.sourceRef}  ${t.title}  sideboard://thread/${t.id}${t.devPort ? `  http://localhost:${t.devPort}` : ""}${progress}`;
+          return `${t.id.slice(0, 8)}  ${t.status.padEnd(9)}  ${t.agent.padEnd(8)}  ${repo}  ${t.sourceType}:${t.sourceRef}  ${t.title}${parent}${previewBit}${err}  sideboard://thread/${t.id}${t.devPort ? `  http://localhost:${t.devPort}` : ""}${progress}`;
         });
         return {
           content: [{ type: "text", text: lines.join("\n") || "(no threads)" }]
@@ -3002,7 +3092,7 @@ async function startMcpServer() {
     );
     server.tool(
       "get_thread",
-      "Get a compact thread summary by id/ref. While running, includes progress (last tool/thinking) and lastActivityAt. Includes usage (thread billed token + costUsd totals when providers reported cost) and lastTurnUsage.",
+      "Get a compact thread summary by id/ref. Includes last message preview, parentThreadId, and child worktree threads (status + lastText). While running, includes progress (last tool/thinking) and lastActivityAt. Includes usage (thread billed token + costUsd totals when providers reported cost) and lastTurnUsage.",
       { ref: z5.string() },
       async ({ ref }) => {
         const t = orch.getThread(ref);
@@ -3021,8 +3111,11 @@ async function startMcpServer() {
           branchName: t.branchName,
           worktreePath: t.worktreePath,
           sessionId: t.sessionId,
+          parentThreadId: t.parentThreadId,
+          children: childThreadRefs(t.id, orch.getThreads(false)),
           queueLength: t.queue.length,
           messageCount: t.messages.length,
+          lastText: lastMessagePreview(t.messages, 240),
           devPort: t.devPort,
           prUrl: t.prUrl,
           lastError: t.lastError ?? null,
@@ -3176,7 +3269,7 @@ async function startMcpServer() {
     registerAbleTimeTools(server);
     registerScheduleTools(server);
     const { getCaffeinateHold: getCaffeinateHold2, setCaffeinateHold: setCaffeinateHold2 } = await import("./caffeinate-hold-X3JNPR42.js");
-    const { resolveNewThreadOptions: resolveNewThreadOptions2, resolveThreadDefaults: resolveThreadDefaults2 } = await import("./app-settings-U5RZKUXG.js");
+    const { resolveNewThreadOptions: resolveNewThreadOptions2, resolveThreadDefaults: resolveThreadDefaults2 } = await import("./app-settings-WJDCJFSY.js");
     const accountDefaults = resolveThreadDefaults2();
     const accountDefaultsHint = `Account defaults: agent=${accountDefaults.agent}, model=${accountDefaults.model?.trim() || "Auto"}, effort=${accountDefaults.effort}`;
     server.tool(
@@ -3353,7 +3446,7 @@ async function startMcpServer() {
     );
     server.tool(
       "send_to_thread",
-      'Queue a prompt on a worktree thread chat (runs under concurrency cap). Use after create_thread to start or continue a conversation. For commit/push/PR, prefer ask_git (canonical desktop-button phrases). Send "Merge PR." / ask_git merge only when the user explicitly asked to merge. Set force_stop=true to interrupt an in-flight/queued turn (kill + clear queue) before queueing this prompt \u2014 use when the thread is mid-turn or has stale queued prompts you need to replace.',
+      'Queue a prompt on a worktree thread chat (runs under concurrency cap). Use after create_thread to start or continue a conversation. For commit/push/PR, prefer ask_git (canonical desktop-button phrases). Send "Merge PR." / ask_git merge only when the user explicitly asked to merge. force_stop=true kills the in-flight turn and clears the queue before this prompt \u2014 only when the current request is wrong and must be replaced. Do not force_stop to check in, resume after a halt notice, or because wait_for_turn returned stillRunning; that stops the child mid-thought. Call wait_for_turn again instead.',
       {
         ref: z5.string(),
         prompt: z5.string(),
@@ -3363,7 +3456,7 @@ async function startMcpServer() {
         if (force_stop) {
           const existing = orch.getThread(ref);
           if (existing) {
-            orch.stop(ref, { clearQueue: true });
+            orch.stop(ref, { clearQueue: true, notifyParent: false });
           }
         }
         const thread = await orch.send(ref, prompt);
@@ -4557,7 +4650,7 @@ function slackOAuthCredentials() {
   const clientSecret = process.env.SIDEBOARD_SLACK_CLIENT_SECRET?.trim() || settings.integrations.slackClientSecret?.trim() || "";
   if (!clientId) {
     throw new Error(
-      "Slack browser sign-in needs a Slack app Client ID (Account \u2192 Slack, or SIDEBOARD_SLACK_CLIENT_ID). You can still paste an xoxb- or xoxp- token."
+      "Slack browser sign-in needs a Slack app Client ID (Settings \u2192 Remote \u2192 Slack, or SIDEBOARD_SLACK_CLIENT_ID). You can still paste an xoxb- or xoxp- token."
     );
   }
   return { clientId, clientSecret: clientSecret || null };
@@ -6302,7 +6395,10 @@ export {
   ATTACHMENTS_DIR,
   BAKED_SLACK_RELAY_URL,
   BRIGHTSY_MCP_ALLOWED_TOOLS,
+  BUNDLED_LONG_RUNNING_PATH,
+  BUNDLED_SKILL_PREFIX,
   BrightsySideboardApi,
+  CHARS_PER_CONTEXT_TOKEN,
   CLAUDE_MODEL_CATALOG,
   CLOUD_COORDINATOR_BUSY_REPLY,
   CLOUD_COORDINATOR_STOPPED_REPLY,
@@ -6329,8 +6425,11 @@ export {
   LINEAR_OAUTH_PORT,
   LINEAR_OAUTH_REDIRECT,
   LINEAR_OAUTH_SCOPES,
+  LONG_RUNNING_SKILL_COMMAND,
   LinearOAuthCancelledError,
   MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS,
+  OPTIONAL_SERVICES,
+  OPTIONAL_SERVICE_IDS,
   ORCHESTRATOR_AGENT_KINDS,
   Orchestrator,
   PASTE_ATTACH_MIN_CHARS,
@@ -6385,6 +6484,7 @@ export {
   applyAgentRunnerHeapEnv,
   applyAppEnvironment,
   applyCompaction,
+  applyForwardOccupancy,
   applyGithubGitAuthEnv,
   applyPromptCacheTtlEnv,
   applyThreadIntoMain,
@@ -6448,7 +6548,9 @@ export {
   conductorDbPath,
   confirmLand,
   connectBrightsyTeam,
+  connectOptionalService,
   connectSlackToken,
+  connectedOptionalServices,
   contextTokens,
   coordinatorSystemPrompt,
   coordinatorTurnReminder,
@@ -6479,13 +6581,16 @@ export {
   detectAgents,
   detectGhStack,
   detectLocalMergeConflicts,
+  detectOptionalServiceClis,
   disconnectAbleTimeConnection,
   disconnectBrightsyTeam,
   disconnectLinear,
   disconnectLinearConnection,
+  disconnectOptionalService,
   disconnectSlackWorkspace,
   discoverSkills,
   dropCachedPrefixOnResume,
+  emptyPublicIntegrations,
   encodeBrightsyTarget,
   enrichPathWithNpmGlobalBin,
   enrichWorkspacesWithGithub,
@@ -6502,6 +6607,7 @@ export {
   ensureSlackDeviceIdentity,
   ensureWorkspace,
   estimateMessageChars,
+  estimateOccupancyTokens,
   estimateThreadChars,
   expandComposerPrompt,
   extractGhErrorDetail,
@@ -6525,12 +6631,17 @@ export {
   formatAgentInstructions,
   formatArtifactDirective,
   formatBrightsyFetchError,
+  formatDetachedJobInvoke,
   formatFetchError,
   formatGhLandError,
   formatGitAuthModeDirective,
   formatIpcInvokeError,
+  formatLongRunningDirective,
+  formatLongRunningReminder,
   formatMergePrError,
   formatMessagesAsTranscript,
+  formatOptionalServicesDirective,
+  formatOptionalServicesReminder,
   formatPlanQuestionAnswers,
   formatPlanQuestionsForChat,
   formatProcessGuideDirective,
@@ -6549,6 +6660,8 @@ export {
   formatWorkspaceInventory,
   formatWorktreeDirective,
   formatWorktreeReminder,
+  forwardContextUsage,
+  forwardOccupancyTokens,
   fromInclusiveInputUsage,
   getAbleTimeAccessToken,
   getAbleTimeHost,
@@ -6611,6 +6724,8 @@ export {
   initializeGitRepository,
   inspectGitWorktree,
   installAgent,
+  installNpmGlobalPackage,
+  installOptionalServiceCli,
   interruptSlackCoordinatorForInbound,
   invalidateThreadListCache,
   isAbleTimeConnected,
@@ -6634,6 +6749,7 @@ export {
   isIssueSourceConnected,
   isLinearConnected,
   isLinearOAuthCancelled,
+  isOptionalServiceId,
   isOrchestratorCapableAgent,
   isOrchestratorThread,
   isPidAlive,
@@ -6722,6 +6838,7 @@ export {
   nonInteractiveGitProcessEnv,
   normalizeAbleTimeHost,
   normalizeParseResult,
+  normalizeServiceOrigin,
   normalizeThinkingEffort,
   normalizeThread,
   normalizeTurnInput,
@@ -6730,11 +6847,14 @@ export {
   openPrStackLayers,
   openStackLayer,
   opencodeAdapter,
+  optionalServiceConnected,
+  optionalServiceSpec,
   orchestrationQuotaFallbackAgent,
   orchestrationQuotaOnLimit,
   orchestrationTitleNeedsSoccerNickname,
   orchestratorSessionPoisonedByBuiltins,
   originGhRepoEnv,
+  packagedDetachedJobPath,
   parseCursorRunnerLine,
   parseDurationMs,
   parseForceStopMessage,
@@ -6792,6 +6912,7 @@ export {
   resolveConductorCursorAgentId,
   resolveCursorModelId,
   resolveDefaultBranch,
+  resolveDetachedJobScript,
   resolveDiffBaseRef,
   resolveEffectiveIssueSource,
   resolveFilesToCopy,
@@ -6890,6 +7011,7 @@ export {
   thisProcessShouldDrainAgentQueues,
   threadDisplayLabel,
   threadFilePath,
+  threadHasCompactedContext,
   threadLivePath,
   threadLockPath,
   threadRequestsBrightsyMcp,
@@ -6919,9 +7041,11 @@ export {
   userCursorMcpConfigPath,
   validateLinearApiKey,
   verifyAbleTimeConnection,
+  verifyOptionalService,
   visibleToolRowDetail,
   waitForPidExit,
   warmGithubAgentAuth,
+  whichOnPath,
   withAgentInstructions,
   withEventParentId,
   withEventsParentId,