@sideboard-ai/core 0.1.135 → 0.1.139

package/dist/index.js

@@ -1,6 +1,7 @@
 import {
   AGENT_GIT_ACTIONS,
   BOARD_COLUMN_DEFS,
+  CHARS_PER_CONTEXT_TOKEN,
   CONTEXT_COMPACT_CHARS,
   CONTEXT_KEEP_RECENT_CHARS,
   CONTEXT_KEEP_RECENT_MESSAGES,
@@ -26,13 +27,11 @@ import {
   allocatePort,
   allocatePortRange,
   applyCompaction,
+  applyForwardOccupancy,
   applyPromptCacheTtlEnv,
   applyThreadIntoMain,
   armSchedules,
   assembleHomeBoard,
-  attachmentFromAbsolutePath,
-  attachmentsFromBuffers,
-  attachmentsFromWorktreePaths,
   boardPinIdentity,
   buildForkTranscriptAttachment,
   buildReviewRequestAttachment,
@@ -64,6 +63,7 @@ import {
   ensureReviewRequestFile,
   ensureReviewSkillFile,
   estimateMessageChars,
+  estimateOccupancyTokens,
   estimateThreadChars,
   expandComposerPrompt,
   extractiveSummary,
@@ -91,6 +91,7 @@ import {
   formatUiReminder,
   formatWorktreeDirective,
   formatWorktreeReminder,
+  forwardContextUsage,
   getDefaultRunScript,
   getDiff,
   getDiffSummary,
@@ -111,7 +112,6 @@ import {
   isCowboyThread,
   isDesktopHostAlive,
   isHomeBoardThread,
-  isImageFilePath,
   isPidAlive,
   isPrimaryCheckoutThread,
   isSlackExternalReplyPrompt,
@@ -170,14 +170,13 @@ import {
   splitForCompaction,
   stackAgentDefaultsFrom,
   stackIdFrom,
-  stageAbsolutePathsAsAttachments,
-  stageBuffersAsAttachments,
   startDevServer,
   startOrchestration,
   summarizeConversation,
   syncBoardPins,
   takenTeamSlugsForChatTab,
   thisProcessShouldDrainAgentQueues,
+  threadHasCompactedContext,
   threadsSharingWorktree,
   updateSchedule,
   upsertSlackWorkspace,
@@ -187,7 +186,7 @@ import {
   worktreeCleanupSettings,
   wrapReviewSkillMarkdown,
   writeWorktreeFile
-} from "./chunk-XIKEUCNC.js";
+} from "./chunk-ZCLHAOFR.js";
 import {
   BRIGHTSY_MCP_ALLOWED_TOOLS,
   CLAUDE_MODEL_CATALOG,
@@ -263,10 +262,11 @@ import {
   toolDetail,
   toolFilePath,
   totalTokens,
+  visibleToolRowDetail,
   withEventParentId,
   withEventsParentId,
   writeInjectedMcpConfig
-} from "./chunk-N62K3KXX.js";
+} from "./chunk-CDJISVKN.js";
 import {
   brightsyMcpServerName,
   connectBrightsyTeam,
@@ -291,7 +291,7 @@ import {
   listWorkspaces,
   removeWorkspace,
   syncWorkspacesFromThreads
-} from "./chunk-LOKXPQ4U.js";
+} from "./chunk-SSBM4GZX.js";
 import {
   CLOUD_COORDINATOR_BUSY_REPLY,
   CLOUD_COORDINATOR_STOPPED_REPLY,
@@ -301,6 +301,9 @@ import {
   ORCHESTRATOR_AGENT_KINDS,
   SIDEBOARD_FORCE_STOP,
   assertOrchestratorCapableAgent,
+  attachmentFromAbsolutePath,
+  attachmentsFromBuffers,
+  attachmentsFromWorktreePaths,
   coerceOrchestratorAgent,
   createGlobalChat,
   ensureCloudCoordinator,
@@ -310,6 +313,7 @@ import {
   isCloudCoordinatorThread,
   isGlobalRepoPath,
   isGlobalThread,
+  isImageFilePath,
   isOrchestratorCapableAgent,
   isOrchestratorThread,
   isSlackCoordinatorThread,
@@ -317,9 +321,12 @@ import {
   orchestrationTitleNeedsSoccerNickname,
   orchestratorSessionPoisonedByBuiltins,
   parseForceStopMessage,
+  persistPendingFileAttachments,
   slackCoordinatorSourceRef,
+  stageAbsolutePathsAsAttachments,
+  stageBuffersAsAttachments,
   takenTeamSlugsForOrchestration
-} from "./chunk-XUEI4GCF.js";
+} from "./chunk-E2RE7P2S.js";
 import {
   COORDINATOR_TOOL_PLAYBOOK,
   SLACK_REPLY_FORMATTING,
@@ -328,7 +335,7 @@ import {
   enrichWorkspacesWithGithub,
   ensureGlobalCoordinatorCwd,
   formatWorkspaceInventory
-} from "./chunk-57GIFU3X.js";
+} from "./chunk-7SYFWPOZ.js";
 import {
   ABLETIME_MCP_PATH,
   DEFAULT_ABLETIME_HOST,
@@ -465,7 +472,7 @@ import {
   worktreeDisplayLabel,
   worktreeDisplayLabelForGroup,
   worktreeNameFromPath
-} from "./chunk-HQQNLDVC.js";
+} from "./chunk-DKXZCIB2.js";
 import {
   ATTACHMENTS_DIR,
   LEGACY_ATTACHMENTS_DIR,
@@ -562,7 +569,7 @@ import {
   updateThread,
   withThreadLock,
   writeThread
-} from "./chunk-PM3C2J6K.js";
+} from "./chunk-TUGKX5BD.js";
 import {
   THINKING_EFFORTS,
   isThinkingEffort,
@@ -1550,8 +1557,12 @@ function latestPendingPlanQuestions(input) {
   if (last?.role === "agent") return extractPendingPlanQuestions(last.parts);
   return null;
 }
+var PLAN_QUESTION_ANSWERS_PREFIX = "Answers to your questions:";
+function isPlanQuestionAnswersMessage(text5) {
+  return text5.startsWith(PLAN_QUESTION_ANSWERS_PREFIX);
+}
 function formatPlanQuestionAnswers(questions, answers) {
-  const lines = ["Answers to your questions:"];
+  const lines = [PLAN_QUESTION_ANSWERS_PREFIX, ""];
   for (let i = 0; i < questions.length; i++) {
     const q = questions[i];
     const a = answers.find((x) => x.questionIndex === i);
@@ -1560,7 +1571,7 @@ function formatPlanQuestionAnswers(questions, answers) {
     if (a?.selected.length) parts.push(a.selected.join(", "));
     if (a?.other?.trim()) parts.push(a.other.trim());
     const body = parts.length ? parts.join(" \xB7 ") : "(no answer)";
-    lines.push(`${i + 1}. ${header}${q.question}`);
+    lines.push(`${i + 1}. ${header}${q.question}  `);
     lines.push(`   \u2192 ${body}`);
   }
   return lines.join("\n");
@@ -1611,6 +1622,36 @@ var MCP_WAIT_QUEUED_HINT = "Child is queued waiting for a concurrency slot \u201
 function mcpWaitStillRunningHint(status) {
   return status === "queued" ? MCP_WAIT_QUEUED_HINT : MCP_WAIT_STILL_RUNNING_HINT;
 }
+var MCP_WAIT_STOPPED_HINT = "Child was stopped before the turn finished. Do not treat this as success. send_to_thread to resume, or tell the user.";
+var MCP_WAIT_BROKEN_HINT = "Child worktree is broken (missing on disk). Tell the user \u2014 do not treat this as success.";
+var MCP_WAIT_ERROR_HINT = "Child turn failed. lastError/text is the failure \u2014 switch agent, tell the user, or retry. Do not treat empty text as success.";
+function mcpWaitFinishedHint(status) {
+  if (status === "stopped") return MCP_WAIT_STOPPED_HINT;
+  if (status === "broken") return MCP_WAIT_BROKEN_HINT;
+  if (status === "error") return MCP_WAIT_ERROR_HINT;
+  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";
@@ -2925,15 +2966,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)" }]
@@ -2987,7 +3032,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);
@@ -3006,8 +3051,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,
@@ -3338,7 +3386,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(),
@@ -3348,7 +3396,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);
@@ -3369,7 +3417,7 @@ async function startMcpServer() {
     );
     server.tool(
       "wait_for_turn",
-      "Wait until the thread finishes its current/queued turn, or return early with a live progress snapshot. MCP clients often kill tools around 60s, so this returns within 45s even while the child is still working. If stillRunning is true, progress is tools/thinking (or \u201Cqueued, waiting for a concurrency slot\u201D if it has not started). Call wait_for_turn again. Do not send a check-in prompt, force_stop, or assume a hang. On status error, lastError/text is the failure. When finished, usage is the last agent turn\u2019s tokens + costUsd (when the provider reported cost).",
+      "Wait until the thread finishes its current/queued turn, or return early with a live progress snapshot. MCP clients often kill tools around 60s, so this returns within 45s even while the child is still working. If stillRunning is true, progress is tools/thinking (or \u201Cqueued, waiting for a concurrency slot\u201D if it has not started). Call wait_for_turn again. Do not send a check-in prompt, force_stop, or assume a hang. On status error, lastError/text is the failure. On status stopped or broken, the child did not finish \u2014 resume with send_to_thread or tell the user; do not treat that as success. When finished, usage is the last agent turn\u2019s tokens + costUsd (when the provider reported cost).",
       {
         ref: z5.string(),
         timeoutMs: z5.number().optional()
@@ -3391,7 +3439,8 @@ async function startMcpServer() {
                 stillRunning: result.stillRunning,
                 progress: result.progress,
                 lastActivityAt: result.lastActivityAt,
-                hint: result.stillRunning ? mcpWaitStillRunningHint(result.status) : void 0
+                hint: result.stillRunning ? mcpWaitStillRunningHint(result.status) : mcpWaitFinishedHint(result.status),
+                incomplete: !result.stillRunning && Boolean(mcpWaitFinishedHint(result.status))
               })
             }
           ]
@@ -3410,7 +3459,8 @@ async function startMcpServer() {
               type: "text",
               text: JSON.stringify({
                 ...result,
-                hint: result.stillRunning ? mcpWaitStillRunningHint(result.status) : void 0
+                hint: result.stillRunning ? mcpWaitStillRunningHint(result.status) : mcpWaitFinishedHint(result.status),
+                incomplete: !result.stillRunning && Boolean(mcpWaitFinishedHint(result.status))
               })
             }
           ]
@@ -3434,7 +3484,7 @@ async function startMcpServer() {
         }
         const clearQueue = force !== false;
         const hadQueued = t.queue.length > 0;
-        const stopped = orch.stop(ref, { clearQueue });
+        const stopped = orch.stop(ref, { clearQueue, notifyParent: false });
         return {
           content: [
             {
@@ -6286,6 +6336,7 @@ export {
   BAKED_SLACK_RELAY_URL,
   BRIGHTSY_MCP_ALLOWED_TOOLS,
   BrightsySideboardApi,
+  CHARS_PER_CONTEXT_TOKEN,
   CLAUDE_MODEL_CATALOG,
   CLOUD_COORDINATOR_BUSY_REPLY,
   CLOUD_COORDINATOR_STOPPED_REPLY,
@@ -6321,6 +6372,7 @@ export {
   PLAN_FILE_NAME,
   PLAN_FILE_REL,
   PLAN_MODE_INSTRUCTION,
+  PLAN_QUESTION_ANSWERS_PREFIX,
   REPO_REVIEW_NAME,
   REPO_REVIEW_PATH,
   REVIEW_REQUEST_NAME,
@@ -6367,6 +6419,7 @@ export {
   applyAgentRunnerHeapEnv,
   applyAppEnvironment,
   applyCompaction,
+  applyForwardOccupancy,
   applyGithubGitAuthEnv,
   applyPromptCacheTtlEnv,
   applyThreadIntoMain,
@@ -6484,6 +6537,7 @@ export {
   ensureSlackDeviceIdentity,
   ensureWorkspace,
   estimateMessageChars,
+  estimateOccupancyTokens,
   estimateThreadChars,
   expandComposerPrompt,
   extractGhErrorDetail,
@@ -6531,6 +6585,7 @@ export {
   formatWorkspaceInventory,
   formatWorktreeDirective,
   formatWorktreeReminder,
+  forwardContextUsage,
   fromInclusiveInputUsage,
   getAbleTimeAccessToken,
   getAbleTimeHost,
@@ -6620,6 +6675,7 @@ export {
   isOrchestratorThread,
   isPidAlive,
   isPlaceholderBranch,
+  isPlanQuestionAnswersMessage,
   isPollWrapperToolName,
   isPrNotMergeableError,
   isPresentPlanToolName,
@@ -6730,6 +6786,7 @@ export {
   pastedTextStats,
   pendingSlackExternalReplies,
   permissionMode,
+  persistPendingFileAttachments,
   persistVaultKeyInKeychain,
   planFileAbs,
   planQuestionsSignature,
@@ -6870,6 +6927,7 @@ export {
   thisProcessShouldDrainAgentQueues,
   threadDisplayLabel,
   threadFilePath,
+  threadHasCompactedContext,
   threadLivePath,
   threadLockPath,
   threadRequestsBrightsyMcp,
@@ -6899,6 +6957,7 @@ export {
   userCursorMcpConfigPath,
   validateLinearApiKey,
   verifyAbleTimeConnection,
+  visibleToolRowDetail,
   waitForPidExit,
   warmGithubAgentAuth,
   withAgentInstructions,