@sideboard-ai/core 0.1.277 → 0.1.279

package/dist/{chunk-SQOAFR2U.js → chunk-V5DMHB6Y.js}

@@ -1,4 +1,5 @@
 import {
+  SIDEBOARD_THREAD_ID_ENV,
   adjustBrightsyTurnExit,
   allAdapters,
   getAdapter,
@@ -7,7 +8,7 @@ import {
   parseSessionQuotaResetAt,
   planModeTurnInstruction,
   resolveQuotaFallbackAgent
-} from "./chunk-NIB2IZ6J.js";
+} from "./chunk-HNNS25SG.js";
 import {
   REVIEW_TAB_TITLE,
   applyWorktreePkgCacheEnv,
@@ -17,12 +18,14 @@ import {
   copyConfiguredFiles,
   createChatTab,
   deriveTaskState,
+  extractPendingPlanQuestions,
   forkChatTab,
   forkMessageSlice,
   formatReviewWriteGateDirective,
   formatReviewWriteGateReminder,
   getDefaultRunScript,
   getRunMode,
+  isAskUserToolName,
   isJobContinuePrompt,
   isReviewWriteGatedThread,
   isWorktreeRunProcessKey,
@@ -44,7 +47,7 @@ import {
   worktreeDevProcessKey,
   worktreeRunProcessKey,
   worktreeSetupProcessKey
-} from "./chunk-MGS5T2A3.js";
+} from "./chunk-HQXBBUQX.js";
 import {
   applyAgentEvent,
   clipAgentEventForPaint,
@@ -59,12 +62,13 @@ import {
   partsToAssistantText,
   stripBrightsyNdjsonNoise,
   toolDescription
-} from "./chunk-FAGK33E2.js";
+} from "./chunk-Y7JPL4WA.js";
 import {
   titleFromPrompt
 } from "./chunk-7H655NEW.js";
 import {
   extractPresentedPlan,
+  isPresentPlanToolName,
   readPlanFile,
   writePlanFile
 } from "./chunk-PGPSIEMW.js";
@@ -88,7 +92,7 @@ import {
   stageAbsolutePathsAsAttachments,
   stageBuffersAsAttachments,
   syncWorkspacesFromThreads
-} from "./chunk-A2G3ZBJS.js";
+} from "./chunk-SKSOCIJT.js";
 import {
   addPrStackLayer,
   agentNicknameFromWorktreePath,
@@ -162,7 +166,7 @@ import {
 import {
   applyAgentRunnerHeapEnv,
   packagedMcpDir
-} from "./chunk-FIBZEFKA.js";
+} from "./chunk-IFURHRAR.js";
 import {
   fallbackTurnFailDetail,
   formatAgentErrorContinuePrompt,
@@ -176,7 +180,7 @@ import {
   shouldRetryFailedAgentTurn,
   summarizeTurnStderr,
   turnFailChatText
-} from "./chunk-5N4Q46SG.js";
+} from "./chunk-K2S33ZCB.js";
 import {
   clearStaleIndexLocks,
   enrichPathWithNpmGlobalBin,
@@ -437,9 +441,9 @@ async function spawnAgentTurn(thread, input, onEvent) {
       `Cannot spawn ${thread.agent}: thread ${thread.id} has no worktreePath`
     );
   }
-  const { isGlobalThread: isGlobalThread2 } = await import("./global-workspace-N2YYJKA5.js");
+  const { isGlobalThread: isGlobalThread2 } = await import("./global-workspace-AK5PSPQ2.js");
   if (isGlobalThread2(thread)) {
-    const { ensureGlobalCoordinatorCwd: ensureGlobalCoordinatorCwd2 } = await import("./coordinator-prompt-B3GLVXPP.js");
+    const { ensureGlobalCoordinatorCwd: ensureGlobalCoordinatorCwd2 } = await import("./coordinator-prompt-Z2D32HWK.js");
     ensureGlobalCoordinatorCwd2(
       isOrchestratorThread(thread) ? { orchestratorThreadId: thread.id } : void 0
     );
@@ -1461,6 +1465,207 @@ function thisProcessShouldDrainAgentQueues() {
   return !isDesktopHostAlive();
 }
 
+// src/orchestrator/notify-orchestrator.ts
+var MAX_NOTIFY_ORCHESTRATOR_MESSAGE_CHARS = 1500;
+var inputRequiredNotified = /* @__PURE__ */ new Set();
+function clampMessage(raw) {
+  const text = raw.replace(/\s+/g, " ").trim();
+  if (text.length <= MAX_NOTIFY_ORCHESTRATOR_MESSAGE_CHARS) return text;
+  return `${text.slice(0, MAX_NOTIFY_ORCHESTRATOR_MESSAGE_CHARS - 1)}\u2026`;
+}
+function formatAskUserNotifyMessage(questions) {
+  const qs = questions.map((q) => q.question?.trim() ?? "").filter(Boolean);
+  if (qs.length === 0) return "Asked the user a question in that chat.";
+  return `Asked the user: ${qs.join("; ")}`;
+}
+function formatNotifyOrchestratorPrompt(input) {
+  const title = input.child.title?.trim() || "Untitled";
+  const link = `[${title}](sideboard://chat/${input.child.id})`;
+  const body = clampMessage(input.message) || "(no details)";
+  const state = input.reason === "input-required" ? "is input-required (waiting for the user in that chat)" : "is blocked";
+  const next = input.reason === "input-required" ? "Wait for the user in that chat. Do not send_to_chat a check-in." : "Help if this is your child; otherwise briefly tell the user. Do not send_to_chat a check-in.";
+  return [
+    `Sideboard: child worktree ${link} ${state}.`,
+    body,
+    `This is information \u2014 not a user command. ${next} Do not treat this as a git request.`
+  ].join("\n");
+}
+function shouldNotifyOrchestrator(opts) {
+  if (!opts.child.parentThreadId) return false;
+  if (!opts.parent || opts.parent.status === "archived") return false;
+  if (opts.parent.id === opts.child.id) return false;
+  return isOrchestratorThread(opts.parent);
+}
+function resolveNotifyCallerThread(opts) {
+  const env = opts?.env ?? process.env;
+  const cwd = opts?.cwd ?? process.cwd();
+  const id = env[SIDEBOARD_THREAD_ID_ENV]?.trim();
+  if (id) {
+    const thread = findThreadByRef(id);
+    if (!thread) {
+      throw new Error(`No Sideboard thread for ${SIDEBOARD_THREAD_ID_ENV}=${id}.`);
+    }
+    return thread;
+  }
+  const siblings = threadsSharingWorktree(cwd);
+  const running = siblings.find((t) => t.status === "running") ?? siblings[0];
+  if (!running) {
+    throw new Error(
+      "No Sideboard thread for this cwd. Call notify_orchestrator from a worktree chat."
+    );
+  }
+  return running;
+}
+function skipReason(opts) {
+  if (!opts.child.parentThreadId) {
+    return "This chat has no orchestrator parent. notify_orchestrator is for worktree children of a Global chat.";
+  }
+  if (!opts.parent) {
+    return "Parent orchestration chat was not found.";
+  }
+  if (opts.parent.status === "archived") {
+    return "Parent orchestration chat is archived.";
+  }
+  if (!isOrchestratorThread(opts.parent)) {
+    return "Parent is not a Global orchestration chat.";
+  }
+  return "Cannot notify orchestrator.";
+}
+async function notifyOrchestrator(input) {
+  const parent = input.child.parentThreadId ? readThread(input.child.parentThreadId) : null;
+  if (!shouldNotifyOrchestrator({ child: input.child, parent })) {
+    return { ok: false, error: skipReason({ child: input.child, parent }) };
+  }
+  const parentId = parent.id;
+  if (input.reason === "input-required") {
+    if (inputRequiredNotified.has(input.child.id)) {
+      return { ok: true, parentThreadId: parentId, deduped: true };
+    }
+    inputRequiredNotified.add(input.child.id);
+  }
+  const prompt = formatNotifyOrchestratorPrompt({
+    child: input.child,
+    reason: input.reason,
+    message: input.message
+  });
+  try {
+    await input.send(parentId, prompt, { followUp: "queue" });
+  } catch (err) {
+    if (input.reason === "input-required") {
+      inputRequiredNotified.delete(input.child.id);
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return { ok: false, error: message };
+  }
+  return { ok: true, parentThreadId: parentId };
+}
+
+// src/orchestrator/agent-block.ts
+var MAX_AGENT_BLOCK_REASON = 240;
+function clampBlockReason(raw) {
+  const text = raw.replace(/\s+/g, " ").trim();
+  if (!text) return "Waiting on a decision";
+  if (text.length <= MAX_AGENT_BLOCK_REASON) return text;
+  return `${text.slice(0, MAX_AGENT_BLOCK_REASON - 1)}\u2026`;
+}
+function makeAgentBlock(source, reason, at = (/* @__PURE__ */ new Date()).toISOString()) {
+  return { source, reason: clampBlockReason(reason), at };
+}
+function lastTopLevelTool(parts) {
+  if (!parts?.length) return null;
+  for (let i = parts.length - 1; i >= 0; i--) {
+    const part = parts[i];
+    if (part.type === "tool" && !part.parentId) return part;
+  }
+  return null;
+}
+function decisionBlockFromParts(parts, planMode, at = (/* @__PURE__ */ new Date()).toISOString()) {
+  const last = lastTopLevelTool(parts);
+  if (last?.type === "tool" && isAskUserToolName(last.name)) {
+    const pending = extractPendingPlanQuestions(parts);
+    const reason = pending ? formatAskUserNotifyMessage(pending.questions) : "Waiting for an answer in that chat.";
+    return makeAgentBlock("ask_user", reason, at);
+  }
+  if (!planMode || last?.type !== "tool") return null;
+  const exited = /exitplanmode/i.test(last.name ?? "");
+  if (!isPresentPlanToolName(last.name) && !exited) return null;
+  const presented = extractPresentedPlan(parts);
+  if (!presented && !exited) return null;
+  const title = presented?.title && presented.title !== "Plan" ? presented.title : "";
+  return makeAgentBlock(
+    "plan",
+    title ? `Waiting for plan approval: ${title}` : "Waiting for plan approval",
+    at
+  );
+}
+function agentBlockAfterTurn(input) {
+  if (input.failed) return null;
+  const decision = decisionBlockFromParts(input.parts, input.planMode);
+  if (decision) return decision;
+  if (input.existing && input.existing.source !== "reported" && lastTopLevelTool(input.parts)) {
+    return null;
+  }
+  return input.existing ?? null;
+}
+function clearAgentBlock(threadId) {
+  const thread = readThread(threadId);
+  if (!thread?.agentBlock) return;
+  updateThread(threadId, { agentBlock: null });
+}
+function writeAgentBlock(threadId, block) {
+  const thread = readThread(threadId);
+  if (!thread || thread.status === "archived") return;
+  updateThread(threadId, { agentBlock: block });
+}
+function settleAgentBlock(threadId, parts, failed) {
+  const thread = readThread(threadId);
+  if (!thread || thread.status === "archived") return;
+  const next = agentBlockAfterTurn({
+    existing: thread.agentBlock,
+    parts,
+    planMode: Boolean(thread.planMode),
+    failed
+  });
+  const prev = thread.agentBlock ?? null;
+  if (prev === next) return;
+  if (prev && next && prev.source === next.source && prev.reason === next.reason && prev.at === next.at) {
+    return;
+  }
+  updateThread(threadId, { agentBlock: next });
+}
+function chatBlockedSuffix(thread) {
+  const raw = thread.agentBlock?.reason;
+  if (!raw?.trim()) return "";
+  return `  blocked:${raw.replace(/\s+/g, " ").slice(0, 80)}`;
+}
+function agentBlockFields(thread) {
+  return {
+    blockedReason: thread.agentBlock?.reason ?? null,
+    blockedSource: thread.agentBlock?.source ?? null
+  };
+}
+function stampAskUserBlock(resolveCaller, questions) {
+  const asked = formatAskUserNotifyMessage(questions);
+  try {
+    writeAgentBlock(resolveCaller().id, makeAgentBlock("ask_user", asked));
+  } catch {
+  }
+  return asked;
+}
+function stampPlanBlock(threadId, title) {
+  const planTitle = title?.trim() || "Plan";
+  if (threadId) {
+    const reason = planTitle === "Plan" ? "Waiting for plan approval" : `Waiting for plan approval: ${planTitle}`;
+    writeAgentBlock(threadId, makeAgentBlock("plan", reason));
+  }
+  return planTitle;
+}
+function stampNotifyBlock(threadId, reason, message) {
+  const resolved = reason ?? "blocked";
+  writeAgentBlock(threadId, makeAgentBlock(resolved === "input-required" ? "ask_user" : "reported", message));
+  return resolved;
+}
+
 // src/orchestrator/child-halt.ts
 var HALT_STATUSES = /* @__PURE__ */ new Set(["stopped", "error", "broken"]);
 function isIncompleteChildStatus(status) {
@@ -1565,6 +1770,36 @@ async function requireAgent(agent, opts) {
   return status;
 }
 
+// src/board/agent-block-view.ts
+function worktreeBoardStatus(group) {
+  const order = ["running", "queued", "error", "broken"];
+  for (const status of order) {
+    if (group.some((t) => t.status === status)) return status;
+  }
+  return group[0]?.status ?? "idle";
+}
+function visibleAgentBlock(thread) {
+  if (thread.status === "archived" || thread.status === "error" || thread.status === "broken") {
+    return null;
+  }
+  const block = thread.agentBlock;
+  if (!block?.reason?.trim()) return null;
+  return block;
+}
+function worktreeAgentBlock(group) {
+  let best = null;
+  for (const thread of group) {
+    const block = visibleAgentBlock(thread);
+    if (!block) continue;
+    if (!best || block.at > best.at) best = block;
+  }
+  return best;
+}
+function threadCardBlockFields(group) {
+  const block = worktreeAgentBlock(group);
+  return block ? { blockedReason: block.reason, blockedSource: block.source } : null;
+}
+
 // src/board/home-board.ts
 var GLOBAL_WORKSPACE_ID = "__global__";
 function isHomeBoardThread(thread) {
@@ -1747,13 +1982,6 @@ function classifyWorktreeListBadges(group, viewerLogin = "", reviewLabel = "") {
     }
   ];
 }
-function worktreeBoardStatus(group) {
-  const order = ["running", "queued", "error", "broken"];
-  for (const status of order) {
-    if (group.some((t) => t.status === status)) return status;
-  }
-  return group[0]?.status ?? "idle";
-}
 function normalizeIssueKey(value) {
   return value.trim().toLowerCase().replace(/^#/, "");
 }
@@ -2109,7 +2337,8 @@ function toThreadCard(group) {
     repoPath: thread.repoPath,
     prUrl: withPr.prUrl,
     link: `sideboard://chat/${thread.id}`,
-    ...group.length > 1 ? { chatCount: group.length } : {}
+    ...group.length > 1 ? { chatCount: group.length } : {},
+    ...threadCardBlockFields(group) ?? {}
   };
 }
 function threadMatchesKind(thread, kind) {
@@ -2183,7 +2412,7 @@ function assembleHomeBoard(input) {
   }
   return { columns, hidden, totals };
 }
-var HOME_BOARD_AGENT_HINT = "Home is a Kanban of workspaces (one card per checkout; sibling chat tabs nest as inner cards). Do not create a second workspace for a ticket, PR, or named branch that already has a live checkout \u2014 create_workspace / start_board_card return that chat (alreadyStarted). Creating from the default branch still opens a new isolated workspace. Columns are the path to merge: New (no PR) \u2192 Draft (draft PR) \u2192 Review (open PR) \u2192 Merged. ownership=mine is PRs you authored (or WIP with no PR); ownership=reviewing is someone else's PR (or a review-requested checkout). Viewer login comes from gh, not a setting. Archive removes the card to Settings \u2192 History. Queued/running are activity on the card, not columns. Orchestration chats stay in the sidebar. Do not invent status.";
+var HOME_BOARD_AGENT_HINT = "Home is a Kanban of workspaces (one card per checkout; sibling chats on a card are separate agents). Do not create a second workspace for a ticket, PR, or named branch that already has a live checkout \u2014 create_workspace / start_board_card return that checkout (alreadyStarted) and its chats. Add another agent with fork_chat. Creating from the default branch still opens a new isolated workspace. Columns are the path to merge: New (no PR) \u2192 Draft (draft PR) \u2192 Review (open PR) \u2192 Merged. ownership=mine is PRs you authored (or WIP with no PR); ownership=reviewing is someone else's PR (or a review-requested checkout). Viewer login comes from gh, not a setting. Archive removes the card to Settings \u2192 History. Queued/running are activity on the card, not columns. blockedReason means an agent on that card is waiting on a person (the question, plan approval, or a reported block) \u2014 read it and do not send_to_chat a check-in. Orchestration chats stay in the sidebar. Do not invent status.";
 
 // src/threads/create.ts
 function persistCreateAttachments(worktreePath, attachments) {
@@ -2406,7 +2635,7 @@ async function createThread(input, _onSetupLine) {
   return readThread(thread.id) ?? thread;
 }
 async function listLinearIssues(agent, repoPath) {
-  const { getAdapter: getAdapter2 } = await import("./agents-2FOWVJCN.js");
+  const { getAdapter: getAdapter2 } = await import("./agents-DYCFLDNL.js");
   await requireAgent(agent, { requireLinear: true });
   const adapter = getAdapter2(agent);
   if (!adapter.listLinearIssues) {
@@ -2913,7 +3142,7 @@ async function adoptThread(input) {
     messages: input.messages ?? []
   });
   writeThread(thread);
-  const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-PBB6HY2D.js");
+  const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-UP6DQ3WL.js");
   await ensureWorkspace2(repoPath);
   const { ensureWorktreeSideboardIgnored } = await import("./worktree-exclude-RXZPTCNH.js");
   await ensureWorktreeSideboardIgnored(input.worktreePath);
@@ -5610,7 +5839,7 @@ function formatScheduledPrompt(name, prompt) {
 ${prompt}`;
 }
 async function defaultDeps() {
-  const { getOrchestrator: getOrchestrator2, startOrchestration: startOrchestration2 } = await import("./orchestrator-QMKVXVUR.js");
+  const { getOrchestrator: getOrchestrator2, startOrchestration: startOrchestration2 } = await import("./orchestrator-KY2KBBE2.js");
   const orch = getOrchestrator2();
   return {
     findThread: (id) => findThreadByRef(id),
@@ -6588,6 +6817,7 @@ var Orchestrator = class {
       const autoContinue = isJobContinuePrompt(promptText) || promptText.startsWith("The previous agent process ended before it finished.");
       const parked = takePendingTurnAttachments(thread);
       const sentAttachments = !autoContinue && parked.length > 0 ? parked : void 0;
+      if (!autoContinue) clearAgentBlock(threadId);
       appendMessage(threadId, {
         role: "user",
         text: promptText,
@@ -6993,6 +7223,7 @@ var Orchestrator = class {
       } else {
         await syncThreadBranchFromGit(threadId);
       }
+      settleAgentBlock(threadId, parts, exitCode !== 0 && !this.stoppedTurns.has(threadId));
       if (this.stoppedTurns.has(threadId)) {
         const stopped = writeLiveStatus(threadId, "stopped");
         if (stopped?.status === "stopped") {
@@ -7043,6 +7274,7 @@ var Orchestrator = class {
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
       await syncThreadBranchFromGit(threadId).catch(() => void 0);
+      settleAgentBlock(threadId, void 0, !this.stoppedTurns.has(threadId));
       if (this.stoppedTurns.has(threadId)) {
         const stopped = writeLiveStatus(threadId, "stopped");
         if (stopped?.status === "stopped") {
@@ -7758,6 +7990,7 @@ var Orchestrator = class {
       stillRunning,
       lastAgentParts: lastAgent?.parts
     });
+    const block = thread.agentBlock?.reason?.trim() ? thread.agentBlock : null;
     return {
       text,
       status: thread.status,
@@ -7771,7 +8004,9 @@ var Orchestrator = class {
         lastAgent?.ts,
         thread.updatedAt
       ]),
-      usage: stillRunning ? null : lastAgent?.usage ?? null
+      usage: stillRunning ? null : lastAgent?.usage ?? null,
+      blockedReason: block?.reason ?? null,
+      blockedSource: block?.source ?? null
     };
   }
   assertNotGlobal(thread, action) {
@@ -8298,7 +8533,7 @@ var Orchestrator = class {
     this.enforceHistoryRetention();
     if (thread.repoPath && !isGlobalRepoPath(thread.repoPath)) {
       try {
-        const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-PBB6HY2D.js");
+        const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-UP6DQ3WL.js");
         await ensureWorkspace2(thread.repoPath);
       } catch {
       }
@@ -8486,6 +8721,9 @@ async function startOrchestration(opts) {
 export {
   isUnclaimedRunScriptRequest,
   isAdoptableRunScriptRequest,
+  worktreeBoardStatus,
+  visibleAgentBlock,
+  worktreeAgentBlock,
   isHomeBoardThread,
   BOARD_COLUMN_DEFS,
   HOME_BOARD_CACHE_TTL_MS,
@@ -8494,7 +8732,6 @@ export {
   classifyWorktreeColumn,
   reviewLabelForRepo,
   classifyWorktreeListBadges,
-  worktreeBoardStatus,
   dedupeBoardIssues,
   issueNeedsWorkspacePick,
   isAccountWideIssueSource,
@@ -8556,6 +8793,16 @@ export {
   shouldRunHistoryCleanup,
   applyThreadIntoMain,
   cloneRepoIntoSideboard,
+  formatAskUserNotifyMessage,
+  formatNotifyOrchestratorPrompt,
+  shouldNotifyOrchestrator,
+  resolveNotifyCallerThread,
+  notifyOrchestrator,
+  chatBlockedSuffix,
+  agentBlockFields,
+  stampAskUserBlock,
+  stampPlanBlock,
+  stampNotifyBlock,
   detectAgents,
   requireAgent,
   createThread,

package/dist/{chunk-FAGK33E2.js → chunk-Y7JPL4WA.js}

@@ -1,6 +1,6 @@
 import {
   clipToolResultForStore
-} from "./chunk-5N4Q46SG.js";
+} from "./chunk-K2S33ZCB.js";
 
 // src/agents/message-parts.ts
 function asRecord(input) {

package/dist/{chunk-HOMZKYHF.js → chunk-YDXNCBA2.js}

@@ -5,13 +5,13 @@ import {
   compactSummaryPart,
   isInternalAgentStatusText,
   lastAssistantMessageText
-} from "./chunk-UKSJO36E.js";
+} from "./chunk-CPA43FBK.js";
 import {
   isCloudCoordinatorThread,
   isGlobalThread,
   isOrchestratorThread,
   isSlackCoordinatorThread
-} from "./chunk-QTZO4LPU.js";
+} from "./chunk-TZ5JHIYK.js";
 import {
   allocateTeamName,
   mergeAgentGitAuthEnv,
@@ -676,6 +676,17 @@ function threadsSharingWorktree(worktreePath) {
     (t) => Boolean(t.worktreePath) && sameWorktreePath(t.worktreePath, key) && t.status !== "archived"
   ).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
 }
+function workspaceAgentChatSummaries(worktreePath) {
+  if (!worktreePath) return [];
+  return threadsSharingWorktree(worktreePath).map((t) => ({
+    id: t.id,
+    title: t.title,
+    agent: t.agent,
+    status: t.status,
+    link: `sideboard://chat/${t.id}`,
+    ...t.agentBlock?.reason ? { blockedReason: t.agentBlock.reason, blockedSource: t.agentBlock.source } : {}
+  }));
+}
 function formatTranscriptMarkdown(title, messages) {
   const body = formatMessagesAsTranscript(messages, { tools: "full" });
   return [`# Transcript: ${title}`, "", `Forked ${(/* @__PURE__ */ new Date()).toISOString()}`, "", body].join("\n");
@@ -1166,6 +1177,78 @@ function jobTreeAlive(pid) {
   return jobAlive(pid) || processGroupAlive(pid);
 }
 
+// src/plan/ask-user.ts
+function planQuestionsSignature(questions) {
+  return questions.map((q) => {
+    const opts = q.options.map((o) => o.label).join("");
+    return `${q.question}${opts}`;
+  }).join("");
+}
+function asRecord(v) {
+  return v != null && typeof v === "object" && !Array.isArray(v) ? v : null;
+}
+function parseOptions(raw) {
+  if (!Array.isArray(raw)) return [];
+  const out = [];
+  for (const item of raw) {
+    if (typeof item === "string" && item.trim()) {
+      out.push({ label: item.trim() });
+      continue;
+    }
+    const o = asRecord(item);
+    if (!o) continue;
+    const label = typeof o.label === "string" ? o.label.trim() : typeof o.text === "string" ? o.text.trim() : typeof o.title === "string" ? o.title.trim() : "";
+    if (!label) continue;
+    const description = typeof o.description === "string" && o.description.trim() ? o.description.trim() : void 0;
+    out.push({ label, description });
+  }
+  return out;
+}
+function parseOneQuestion(raw) {
+  const o = asRecord(raw);
+  if (!o) return null;
+  const question = typeof o.question === "string" ? o.question.trim() : typeof o.text === "string" ? o.text.trim() : typeof o.prompt === "string" ? o.prompt.trim() : "";
+  if (!question) return null;
+  const options = parseOptions(o.options);
+  if (options.length < 1) return null;
+  const header = typeof o.header === "string" && o.header.trim() ? o.header.trim() : void 0;
+  const multiSelect = Boolean(o.multiSelect ?? o.multi_select);
+  return { question, header, multiSelect, options };
+}
+function parsePlanQuestionsInput(input) {
+  const root = asRecord(input);
+  if (!root) return [];
+  const list = Array.isArray(root.questions) ? root.questions : Array.isArray(root.question) ? root.question : root.question || root.prompt ? [root] : [];
+  const out = [];
+  for (const item of list) {
+    const q = parseOneQuestion(item);
+    if (q) out.push(q);
+  }
+  return out;
+}
+var ASK_USER_TOOL_RE = /^(AskUserQuestion|ask_user|mcp__sideboard__ask_user)$/i;
+function isAskUserToolName(name) {
+  if (!name) return false;
+  const base = name.replace(/^mcp__sideboard__/i, "");
+  return ASK_USER_TOOL_RE.test(name) || /^ask_user$/i.test(base);
+}
+function extractPendingPlanQuestions(parts) {
+  if (!parts?.length) return null;
+  for (let i = parts.length - 1; i >= 0; i--) {
+    const p = parts[i];
+    if (p.type !== "tool" || !isAskUserToolName(p.name)) continue;
+    const questions = parsePlanQuestionsInput(p.input);
+    if (!questions.length) continue;
+    return {
+      id: p.id || `ask-${i}`,
+      signature: planQuestionsSignature(questions),
+      questions,
+      source: p.name || "ask_user"
+    };
+  }
+  return null;
+}
+
 // src/orchestrator/task-state.ts
 function isIncompleteTaskState(state) {
   return state === "failed" || state === "canceled";
@@ -1173,13 +1256,12 @@ function isIncompleteTaskState(state) {
 function needsCoordinatorAction(state) {
   return isIncompleteTaskState(state) || state === "input-required";
 }
-var ASK_USER_TOOL = /(^|[_.:/])ask_user$/i;
 function endedOnAskUser(parts) {
   if (!parts?.length) return false;
   for (let i = parts.length - 1; i >= 0; i--) {
     const p = parts[i];
     if (p.type === "tool" && !p.parentId) {
-      return ASK_USER_TOOL.test(p.name);
+      return isAskUserToolName(p.name);
     }
   }
   return false;
@@ -1212,7 +1294,17 @@ var MCP_WAIT_STOPPED_HINT = "Child was stopped before the turn finished. Do not
 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.";
 var MCP_WAIT_INPUT_REQUIRED_HINT = "Child asked the user a question (ask_user). taskState is input-required. Wait for the user to answer in that chat \u2014 do not send_to_chat a check-in.";
-function mcpWaitTaskHint(taskState, status) {
+function mcpWaitTaskHint(taskState, status, blockedReason) {
+  const why = blockedReason?.trim();
+  if (why && taskState !== "failed" && taskState !== "canceled") {
+    if (taskState === "submitted" || taskState === "working") {
+      return `Child is blocked: ${why} It has not finished the turn. Do not send_to_chat a check-in.`;
+    }
+    if (taskState === "input-required") {
+      return `Child is blocked: ${why} Wait for the user in that chat \u2014 do not send_to_chat a check-in.`;
+    }
+    return `Child is blocked: ${why} Help if this is your child; otherwise tell the user. Do not send_to_chat a check-in.`;
+  }
   switch (taskState) {
     case "submitted":
       return MCP_WAIT_QUEUED_HINT;
@@ -1241,11 +1333,15 @@ function lastActivityAtForWait(stillRunning, liveUpdatedAt, fallbacks) {
   return null;
 }
 function waitForTurnToolResult(input) {
+  const blockedReason = input.blockedReason?.trim() ? input.blockedReason.trim() : null;
+  const waiting = Boolean(blockedReason) && !input.stillRunning && input.taskState !== "failed" && input.taskState !== "canceled";
   return {
     ...input,
     usage: input.usage ?? null,
-    hint: mcpWaitTaskHint(input.taskState, input.status),
-    incomplete: needsCoordinatorAction(input.taskState)
+    blockedReason,
+    blockedSource: blockedReason ? input.blockedSource ?? null : null,
+    hint: mcpWaitTaskHint(input.taskState, input.status, blockedReason),
+    incomplete: needsCoordinatorAction(input.taskState) || waiting
   };
 }
 
@@ -1577,7 +1673,7 @@ var PORT_RANGE_SIZE = 10;
 var RECLAIM_RETRY_DELAY_MS = 40;
 var RECLAIM_TRIES = 8;
 async function killReclaimable(ports, worktreePath, signal) {
-  const { killListenersOnPorts: killListenersOnPorts2, killStaleWorktreeListeners: killStaleWorktreeListeners2 } = await import("./conductor-YYQKZAND.js");
+  const { killListenersOnPorts: killListenersOnPorts2, killStaleWorktreeListeners: killStaleWorktreeListeners2 } = await import("./conductor-J6WDOXWM.js");
   if (worktreePath) killStaleWorktreeListeners2(ports, worktreePath, signal);
   else killListenersOnPorts2(ports);
 }
@@ -2210,6 +2306,8 @@ async function startDevServer(repoPath, worktreePath, onLine, opts) {
 }
 
 export {
+  isAskUserToolName,
+  extractPendingPlanQuestions,
   needsCoordinatorAction,
   deriveTaskState,
   mcpWaitForTurnTimeoutMs,
@@ -2227,6 +2325,7 @@ export {
   resolveWorktreeSetupLog,
   mergeWorktreeActiveRuns,
   threadsSharingWorktree,
+  workspaceAgentChatSummaries,
   forkMessageSlice,
   buildForkTranscriptAttachment,
   createChatTab,

package/dist/{conductor-YYQKZAND.js → conductor-J6WDOXWM.js}

@@ -33,9 +33,9 @@ import {
   tryReservePort,
   tryReservePorts,
   worktreeRunPortsPath
-} from "./chunk-HOMZKYHF.js";
-import "./chunk-UKSJO36E.js";
-import "./chunk-QTZO4LPU.js";
+} from "./chunk-YDXNCBA2.js";
+import "./chunk-CPA43FBK.js";
+import "./chunk-TZ5JHIYK.js";
 import "./chunk-K7MWJLR7.js";
 import "./chunk-N2WW62LF.js";
 import "./chunk-DD67JWTN.js";