@ordewell/core 0.5.3 → 0.5.5

package/dist/plan-utils.js

@@ -21,14 +21,31 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var plan_utils_exports = {};
 __export(plan_utils_exports, {
   CHECKPOINT_TRUNCATE_LENGTH: () => CHECKPOINT_TRUNCATE_LENGTH,
+  EMPTY_CONVERSATION: () => EMPTY_CONVERSATION,
+  EMPTY_HOLD: () => EMPTY_HOLD,
+  NO_TURN: () => NO_TURN,
+  aheadOfDraft: () => aheadOfDraft,
   canMergeTasks: () => canMergeTasks,
   canSetDependencies: () => canSetDependencies,
   canSplitTask: () => canSplitTask,
   capConflictFiles: () => capConflictFiles,
   dependencyCandidates: () => dependencyCandidates,
   dependentsOf: () => dependentsOf,
+  drainNext: () => drainNext,
+  followTurn: () => followTurn,
+  fromTranscript: () => fromTranscript,
+  hasHiddenDetail: () => hasHiddenDetail,
+  holdPrompt: () => holdPrompt,
+  outputLines: () => outputLines,
+  outputPreview: () => outputPreview,
+  reduceConversation: () => reduceConversation,
+  stopTurn: () => stopTurn,
   summarizeToolCall: () => summarizeToolCall,
-  truncateCheckpointSummary: () => truncateCheckpointSummary
+  taskStartedNotice: () => taskStartedNotice,
+  toolHeadline: () => toolHeadline,
+  truncateCheckpointSummary: () => truncateCheckpointSummary,
+  unsendAll: () => unsendAll,
+  unsendLatest: () => unsendLatest
 });
 module.exports = __toCommonJS(plan_utils_exports);
 
@@ -105,9 +122,9 @@ function canSplitTask(tasks, taskId) {
 }
 
 // src/services/researchStepSummary.ts
-function ellipsize(text, max) {
-  const oneLine = text.replace(/\s+/g, " ").trim();
-  return oneLine.length > max ? `${oneLine.slice(0, max)}\u2026` : oneLine;
+function ellipsize(text2, max) {
+  const oneLine2 = text2.replace(/\s+/g, " ").trim();
+  return oneLine2.length > max ? `${oneLine2.slice(0, max)}\u2026` : oneLine2;
 }
 function summarizeToolCall(tool, argsJson, toolLabel) {
   const display = toolLabel?.trim() || tool;
@@ -124,8 +141,8 @@ function summarizeToolCall(tool, argsJson, toolLabel) {
     try {
       const args = JSON.parse(argsJson);
       const prompt = typeof args.prompt === "string" ? args.prompt : "";
-      const oneLine = prompt.replace(/\s+/g, " ").trim();
-      return `spawn: "${oneLine.slice(0, 60)}${oneLine.length > 60 ? "\u2026" : ""}"`;
+      const oneLine2 = prompt.replace(/\s+/g, " ").trim();
+      return `spawn: "${oneLine2.slice(0, 60)}${oneLine2.length > 60 ? "\u2026" : ""}"`;
     } catch {
       return "spawn_research_agent";
     }
@@ -177,16 +194,660 @@ function truncateCheckpointSummary(summary) {
 function capConflictFiles(files, max = 5) {
   return files.length <= max ? files.join(", ") : `${files.slice(0, max).join(", ")}, +${files.length - max} more`;
 }
+
+// src/models/Usage.ts
+function isMeasured(totals) {
+  return totals.inputTokens !== void 0 || totals.outputTokens !== void 0 || totals.cachedInputTokens !== void 0 || Object.keys(totals.reportedCost ?? {}).length > 0;
+}
+function usageLine(usage) {
+  const contextFill = plannerContextFill(usage);
+  return {
+    totals: usage.totals,
+    ...usage.bySubagent ? { bySubagent: usage.bySubagent } : {},
+    ...contextFill ? { contextFill } : {}
+  };
+}
+function plannerContextFill(usage) {
+  if (usage.lastPromptTokens === void 0 || usage.contextWindow === void 0 || usage.contextWindow <= 0) return void 0;
+  return { usedTokens: usage.lastPromptTokens, windowTokens: usage.contextWindow };
+}
+
+// src/services/terminalRender.ts
+var ANSI_OR_CTRL_RE = /\x1b\[[0-9;?]*[A-Za-z]|\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)?|\x1b[()][AB012]|\x1b[=>]|[\x00-\x08\x0b-\x1f\x7f]/g;
+
+// src/conversation/format.ts
+var DISPLAY_NAMES = {
+  read_file: "Read",
+  read_files: "Read",
+  list_dir: "List",
+  glob: "Glob",
+  grep: "Grep",
+  find_symbol: "Symbol",
+  bash: "Bash",
+  fetch: "Fetch",
+  web_search: "WebSearch",
+  spawn_research_agent: "Agent"
+};
+var HINT_FIELDS = ["file_path", "filePath", "path", "url", "pattern", "query", "command", "description", "prompt"];
+function parseArgs(args) {
+  try {
+    const parsed = JSON.parse(args);
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function oneLine(text2) {
+  return text2.replace(/\s+/g, " ").trim();
+}
+function firstLineOf(command) {
+  const lines = command.trim().split(/\r?\n/);
+  const more = lines.length - 1;
+  return more > 0 ? `${lines[0]} \u2026 +${more} line${more === 1 ? "" : "s"}` : lines[0];
+}
+function text(value) {
+  return typeof value === "string" ? value : "";
+}
+function searchArg(pattern, path, include = "") {
+  return `${pattern}${path ? ` in ${path}` : ""}${include ? ` (${include})` : ""}`;
+}
+function hintArg(args) {
+  for (const field of HINT_FIELDS) {
+    const value = text(args[field]);
+    if (value) return field === "command" ? firstLineOf(value) : oneLine(value);
+  }
+  const firstText = Object.values(args).find((v) => typeof v === "string" && v.trim() !== "");
+  return firstText ? oneLine(firstText) : "";
+}
+function keyArgOf(tool, args) {
+  switch (tool) {
+    case "bash":
+      return firstLineOf(text(args.command));
+    case "read_file":
+    case "list_dir":
+      return text(args.path);
+    case "read_files":
+      return Array.isArray(args.paths) ? args.paths.map(String).join(", ") : "";
+    case "glob":
+      return searchArg(text(args.pattern), text(args.path));
+    case "grep":
+      return searchArg(text(args.pattern), text(args.path), text(args.include));
+    case "find_symbol":
+      return `${text(args.symbol)}${text(args.language) ? ` [${text(args.language)}]` : ""}`;
+    case "fetch":
+      return text(args.url);
+    case "web_search":
+      return oneLine(text(args.query));
+    case "spawn_research_agent":
+      return oneLine(text(args.prompt));
+    default:
+      return hintArg(args);
+  }
+}
+function toolHeadline(tool, args, toolLabel) {
+  const name = toolLabel?.trim() || DISPLAY_NAMES[tool] || tool;
+  const parsed = parseArgs(args);
+  return { name, keyArg: parsed ? keyArgOf(tool, parsed) : oneLine(args) };
+}
+function outputLines(output) {
+  const lines = output.replace(/\r\n?/g, "\n").replace(ANSI_OR_CTRL_RE, "").split("\n");
+  while (lines.length > 0 && lines[lines.length - 1].trim() === "") lines.pop();
+  return lines;
+}
+function outputPreview(output, maxLines) {
+  const lines = outputLines(output);
+  const shown = lines.slice(0, Math.max(0, maxLines));
+  return { lines: shown, hiddenLineCount: lines.length - shown.length };
+}
+
+// src/conversation/records.ts
+function settledMessage(id, role, text2, turnId) {
+  return { type: "message", id, role, text: text2, streaming: false, ...turnId ? { turnId } : {} };
+}
+function subagentBlock(id, { toolCallId, model, usage, turnId, ...fields }) {
+  return {
+    type: "subagent",
+    id,
+    ...fields,
+    ...toolCallId ? { toolCallId } : {},
+    ...model ? { model } : {},
+    ...usage ? { usage } : {},
+    ...turnId ? { turnId } : {}
+  };
+}
+function usageBlock(id, { totals, bySubagent, contextFill }) {
+  return { type: "usage", id, totals, ...bySubagent ? { bySubagent } : {}, ...contextFill ? { contextFill } : {} };
+}
+var STATUS_OF_OUTCOME = {
+  success: "ok",
+  failure: "error",
+  refused: "denied",
+  denied: "denied",
+  not_executed: "interrupted"
+};
+function settledTool(call, step) {
+  return { ...call, status: STATUS_OF_OUTCOME[step.outcome], outcome: step.outcome, output: step.result, outputLineCount: outputLines(step.result).length };
+}
+function pendingTool(id, { tool, toolLabel, args, toolCallId, turnId }) {
+  return {
+    type: "tool",
+    id,
+    tool,
+    headline: toolHeadline(tool, args, toolLabel),
+    args,
+    status: "pending",
+    output: "",
+    outputLineCount: 0,
+    ...toolCallId ? { toolCallId } : {},
+    ...toolLabel ? { toolLabel } : {},
+    ...turnId ? { turnId } : {}
+  };
+}
+function toolFromStep(id, step, turnId) {
+  return settledTool(pendingTool(id, { ...step, turnId }), step);
+}
+function planMarker(content) {
+  const count = /(\d+) tasks?\b/.exec(content);
+  return { status: content.startsWith("Plan updated") ? "updated" : "generated", ...count ? { taskCount: Number(count[1]) } : {} };
+}
+
+// src/conversation/reduce.ts
+var EMPTY_CONVERSATION = { blocks: [], nextId: 1 };
+function findLastIndex(items, match) {
+  for (let i = items.length - 1; i >= 0; i--) if (match(items[i])) return i;
+  return -1;
+}
+function replaceAt(items, index, item) {
+  const next = items.slice();
+  next[index] = item;
+  return next;
+}
+function insertTop(blocks, block) {
+  const last = blocks[blocks.length - 1];
+  return last?.type === "usage" ? [...blocks.slice(0, -1), block, last] : [...blocks, block];
+}
+function append(view, make) {
+  return { ...view, blocks: insertTop(view.blocks, make(`b${view.nextId}`)), nextId: view.nextId + 1 };
+}
+function subagentAt(view, lane) {
+  const block = view.blocks[lane];
+  if (block.type !== "subagent") throw new Error(`block ${lane} is not a subagent`);
+  return block;
+}
+function laneBlocks(view, lane) {
+  return lane === null ? view.blocks : subagentAt(view, lane).children;
+}
+function setChildren(view, lane, children) {
+  return { ...view, blocks: replaceAt(view.blocks, lane, { ...subagentAt(view, lane), children }) };
+}
+function laneReplace(view, lane, index, block) {
+  if (lane === null) return { ...view, blocks: replaceAt(view.blocks, index, block) };
+  return setChildren(view, lane, replaceAt(subagentAt(view, lane).children, index, block));
+}
+function laneAppend(view, lane, make) {
+  if (lane === null) return append(view, make);
+  const children = [...subagentAt(view, lane).children, make(`b${view.nextId}`)];
+  return { ...setChildren(view, lane, children), nextId: view.nextId + 1 };
+}
+function isStreaming(block) {
+  return (block.type === "message" || block.type === "thinking") && block.streaming;
+}
+function sealed(block) {
+  return isStreaming(block) ? { ...block, streaming: false } : block;
+}
+function sealLane(view, lane, keep) {
+  const blocks = laneBlocks(view, lane);
+  if (!blocks.some((b, i) => i !== keep && isStreaming(b))) return view;
+  if (lane === null) return { ...view, blocks: view.blocks.map((b, i) => i === keep ? b : sealed(b)) };
+  return setChildren(view, lane, subagentAt(view, lane).children.map((b, i) => i === keep ? b : sealed(b)));
+}
+function appendOutput(view, lane, make) {
+  const next = laneAppend(view, lane, make);
+  return sealLane(next, lane, findLastIndex(laneBlocks(next, lane), (b) => b.type !== "usage"));
+}
+function isUnsettledSegment(block, turnId) {
+  return block.type === "message" && block.turnId === turnId && block.segmentId !== void 0;
+}
+function isBuildingPlan(block, turnId) {
+  return block.type === "plan" && block.status === "building" && block.turnId === turnId;
+}
+function finalSegmentIndex(blocks, turnId, pastPlan = false) {
+  for (let i = blocks.length - 1; i >= 0; i--) {
+    const block = blocks[i];
+    if (block.type === "usage" || block.type === "thinking" || block.type === "approval" || pastPlan && block.type === "plan") continue;
+    if (block.turnId !== turnId) continue;
+    return isUnsettledSegment(block, turnId) ? i : -1;
+  }
+  return -1;
+}
+function openTurn(view, turnId, prompt) {
+  const i = findLastIndex(view.blocks, (b) => b.type === "message" && b.role === "user");
+  const sent = view.blocks[i];
+  if (sent?.type === "message" && sent.turnId === void 0 && sent.text === prompt) {
+    return { ...view, blocks: replaceAt(view.blocks, i, { ...sent, turnId }) };
+  }
+  return append(view, (id) => settledMessage(id, "user", prompt, turnId));
+}
+function streamText(view, { turnId, segmentId, text: text2 }) {
+  const i = findLastIndex(view.blocks, (b) => isUnsettledSegment(b, turnId) && b.segmentId === segmentId);
+  const segment = view.blocks[i];
+  if (segment?.type === "message") {
+    return sealLane(laneReplace(view, null, i, { ...segment, text: segment.text + text2, streaming: true }), null, i);
+  }
+  return appendOutput(view, null, (id) => ({ type: "message", id, role: "planner", text: text2, streaming: true, turnId, segmentId }));
+}
+function dropBuildingPlan(view, turnId, segmentId) {
+  const blocks = view.blocks.filter((b) => !(isBuildingPlan(b, turnId) && (segmentId === void 0 || b.segmentId === segmentId)));
+  return blocks.length === view.blocks.length ? view : { ...view, blocks };
+}
+function settleReply(view, { content, turnId }) {
+  if (turnId !== void 0) {
+    const i = finalSegmentIndex(view.blocks, turnId);
+    if (i >= 0) {
+      return dropBuildingPlan({ ...view, blocks: replaceAt(view.blocks, i, settledMessage(view.blocks[i].id, "planner", content, turnId)) }, turnId);
+    }
+  }
+  return append(dropBuildingPlan(view, turnId), (id) => settledMessage(id, "planner", content, turnId));
+}
+function retractText(view, { turnId, segmentId }) {
+  const blocks = view.blocks.filter((b) => !(isUnsettledSegment(b, turnId) && (segmentId === void 0 || b.segmentId === segmentId)));
+  return dropBuildingPlan(blocks.length === view.blocks.length ? view : { ...view, blocks }, turnId, segmentId);
+}
+function subagentLane(view, subagentId, turnId) {
+  const existing = findLastIndex(view.blocks, (b) => b.type === "subagent" && b.subagentId === subagentId);
+  if (existing >= 0) return [view, existing];
+  const spawn = findLastIndex(view.blocks, (b) => b.type === "tool" && (b.spawns === subagentId || b.toolCallId === subagentId));
+  const call = view.blocks[spawn];
+  if (call?.type === "tool") {
+    const block = subagentBlock(call.id, {
+      subagentId,
+      brief: call.headline.keyArg,
+      status: "running",
+      children: [],
+      digest: "",
+      toolCallId: call.toolCallId,
+      turnId: call.turnId
+    });
+    return [{ ...view, blocks: replaceAt(view.blocks, spawn, block) }, spawn];
+  }
+  const next = append(view, (id) => subagentBlock(id, { subagentId, brief: "", status: "running", children: [], digest: "", turnId }));
+  return [next, findLastIndex(next.blocks, (b) => b.type === "subagent" && b.subagentId === subagentId)];
+}
+function updateSubagent(view, subagentId, turnId, update) {
+  const [next, lane] = subagentLane(view, subagentId, turnId);
+  return { ...next, blocks: replaceAt(next.blocks, lane, update(subagentAt(next, lane))) };
+}
+function startSubagent(view, { subagentId, brief, model, turnId }) {
+  return updateSubagent(view, subagentId, turnId, (block) => ({ ...block, ...brief ? { brief } : {}, ...model ? { model } : {} }));
+}
+function finishSubagent(view, { subagentId, outcome, digest, usage, turnId }) {
+  return updateSubagent(view, subagentId, turnId, (block) => ({
+    ...block,
+    status: outcome,
+    digest,
+    children: block.children.map(sealed),
+    ...usage ? { usage } : {}
+  }));
+}
+function think(view, text2, turnId, segmentId, subagentId) {
+  const [placed, lane] = subagentId ? subagentLane(view, subagentId, turnId) : [view, null];
+  const blocks = laneBlocks(placed, lane);
+  const lastIndex = findLastIndex(blocks, (b) => b.type !== "usage");
+  const last = blocks[lastIndex];
+  if (last?.type === "thinking" && last.streaming && last.segmentId === segmentId) {
+    return laneReplace(placed, lane, lastIndex, { ...last, text: last.text + text2 });
+  }
+  return appendOutput(placed, lane, (id) => ({
+    type: "thinking",
+    id,
+    text: text2,
+    streaming: true,
+    ...turnId ? { turnId } : {},
+    ...segmentId ? { segmentId } : {},
+    ...subagentId ? { subagentId } : {}
+  }));
+}
+function announceTool(view, call) {
+  const spawns = call.tool === "spawn_research_agent" ? call.subagentId : void 0;
+  const [placed, lane] = call.subagentId && !spawns ? subagentLane(view, call.subagentId, call.turnId) : [view, null];
+  return appendOutput(placed, lane, (id) => ({ ...pendingTool(id, call), ...spawns ? { spawns } : {} }));
+}
+function isPendingCallOf(block, step) {
+  if (block.type !== "tool" || block.status !== "pending") return false;
+  return step.toolCallId ? block.toolCallId === step.toolCallId : block.toolCallId === void 0 && block.tool === step.tool;
+}
+function settleTool(view, { step, turnId }) {
+  const [placed, lane] = step.subagentId ? subagentLane(view, step.subagentId, turnId) : [view, null];
+  const blocks = laneBlocks(placed, lane);
+  const i = findLastIndex(blocks, (b) => isPendingCallOf(b, step));
+  const pending = blocks[i];
+  if (pending?.type === "tool") return laneReplace(placed, lane, i, settledTool(pending, step));
+  if (lane === null && step.toolCallId && blocks.some((b) => b.type === "subagent" && b.toolCallId === step.toolCallId)) return view;
+  return laneAppend(placed, lane, (id) => toolFromStep(id, step, turnId));
+}
+function streamPlan(view, { token, turnId, segmentId }) {
+  const i = findLastIndex(view.blocks, (b) => isBuildingPlan(b, turnId));
+  const building = view.blocks[i];
+  if (building?.type === "plan" && building.segmentId === segmentId) {
+    return { ...view, blocks: replaceAt(view.blocks, i, { ...building, text: building.text + token }) };
+  }
+  return append(dropBuildingPlan(view, turnId), (id) => ({
+    type: "plan",
+    id,
+    status: "building",
+    text: token,
+    ...turnId ? { turnId } : {},
+    ...segmentId ? { segmentId } : {}
+  }));
+}
+function markPlan(view, content, turnId) {
+  const marker = planMarker(content);
+  const i = findLastIndex(view.blocks, (b) => isBuildingPlan(b, turnId));
+  const building = view.blocks[i];
+  if (building?.type === "plan") {
+    const settled = { type: "plan", id: building.id, ...marker, text: "", ...building.turnId ? { turnId: building.turnId } : {} };
+    return { ...view, blocks: replaceAt(view.blocks, i, settled) };
+  }
+  return append(view, (id) => ({ type: "plan", id, text: "", ...marker }));
+}
+function requestApproval(view, { id: approvalId, kind, subject, scope, detail, turnId }) {
+  return append(view, (id) => ({
+    type: "approval",
+    id,
+    approvalId,
+    kind,
+    subject,
+    scope,
+    status: "pending",
+    ...detail ? { detail } : {},
+    ...turnId ? { turnId } : {}
+  }));
+}
+function settleApproval(view, { id, granted }) {
+  const i = findLastIndex(view.blocks, (b) => b.type === "approval" && b.approvalId === id);
+  const request = view.blocks[i];
+  if (request?.type !== "approval") return view;
+  return { ...view, blocks: replaceAt(view.blocks, i, { ...request, status: granted ? "granted" : "denied", decidedBy: "asked" }) };
+}
+function decideApproval(view, { kind, subject, scope, detail, granted, source }) {
+  return append(view, (id) => ({
+    type: "approval",
+    id,
+    kind,
+    subject,
+    scope,
+    status: granted ? "granted" : "denied",
+    decidedBy: source,
+    ...detail ? { detail } : {}
+  }));
+}
+function reportUsage(view, message) {
+  if (!isMeasured(message.totals)) return view;
+  const last = view.blocks[view.blocks.length - 1];
+  const line = usageBlock(last?.type === "usage" ? last.id : `b${view.nextId}`, message);
+  if (last?.type === "usage") return { ...view, blocks: replaceAt(view.blocks, view.blocks.length - 1, line) };
+  return { ...view, blocks: [...view.blocks, line], nextId: view.nextId + 1 };
+}
+function closeBlock(block, interrupted) {
+  return interrupted && block.type === "tool" && block.status === "pending" ? { ...block, status: "interrupted" } : sealed(block);
+}
+function closeSubagent(block, cut) {
+  const children = block.children.map((c) => closeBlock(c, cut !== null));
+  const status = cut && block.status === "running" ? cut : block.status;
+  return status === block.status && children.every((c, i) => c === block.children[i]) ? block : { ...block, status, children };
+}
+function endTurn(view, { turnId, outcome }) {
+  let next = dropBuildingPlan(view, turnId);
+  const planText = outcome === "plan" ? finalSegmentIndex(next.blocks, turnId, true) : -1;
+  if (planText >= 0) next = { ...next, blocks: next.blocks.filter((_, i) => i !== planText) };
+  const cut = outcome === "stopped" ? "stopped" : outcome === "error" ? "failed" : null;
+  const blocks = next.blocks.map((b) => b.type === "subagent" ? closeSubagent(b, cut) : closeBlock(b, cut !== null));
+  return blocks.every((b, i) => b === next.blocks[i]) ? next : { ...next, blocks };
+}
+function markCompaction(view, summary) {
+  const i = findLastIndex(view.blocks, (b) => b.type === "message" && b.role === "planner" && b.turnId === void 0 && b.text === summary);
+  const announced = view.blocks[i];
+  if (announced?.type === "message") return { ...view, blocks: replaceAt(view.blocks, i, { ...announced, role: "system" }) };
+  return append(view, (id) => settledMessage(id, "system", summary));
+}
+function syncTranscript(view, { plan, turnId }) {
+  const history = plan.conversationHistory ?? [];
+  const committed = findLastIndex(history, (e) => e.kind === "plan_generated");
+  let next = view;
+  let latest = view.transcriptAt;
+  for (const [i, entry] of history.entries()) {
+    const isNew = view.transcriptAt === void 0 || entry.timestamp > view.transcriptAt;
+    if (isNew && entry.kind === "plan_generated") next = markPlan(next, entry.content, i === committed ? turnId : void 0);
+    if (isNew && entry.kind === "system") next = append(next, (id) => settledMessage(id, "system", entry.content));
+    if (isNew && entry.kind === "compaction") next = markCompaction(next, entry.content);
+    if (latest === void 0 || entry.timestamp > latest) latest = entry.timestamp;
+  }
+  return next === view && latest === view.transcriptAt ? view : { ...next, transcriptAt: latest };
+}
+function reduceConversation(view, input) {
+  switch (input.type) {
+    case "local_entry":
+      return append(view, (id) => settledMessage(id, input.role, input.text));
+    case "planner_turn_started":
+      return input.prompt === void 0 ? view : openTurn(view, input.turnId, input.prompt);
+    case "planner_text_delta":
+      return streamText(view, input);
+    case "planner_message":
+      return settleReply(view, input);
+    case "planner_text_retracted":
+      return retractText(view, input);
+    case "planner_thinking_delta":
+      return think(view, input.text, input.turnId, input.segmentId, input.subagentId);
+    case "research_step":
+      return announceTool(view, input);
+    case "research_step_done":
+      return settleTool(view, input);
+    case "subagent_started":
+      return startSubagent(view, input);
+    case "subagent_finished":
+      return finishSubagent(view, input);
+    case "plan_token":
+      return streamPlan(view, input);
+    case "plan_generated":
+      return syncTranscript(view, input);
+    case "planner_turn_ended":
+      return endTurn(view, input);
+    case "approval_request":
+      return requestApproval(view, input);
+    case "approval_settled":
+      return settleApproval(view, input);
+    case "approval_decided":
+      return decideApproval(view, input);
+    case "planner_usage":
+      return reportUsage(view, input);
+    default:
+      return view;
+  }
+}
+
+// src/conversation/transcript.ts
+var USER = 0;
+var RESEARCH = 1;
+var SETTLED = 2;
+function fromEntry(entry) {
+  if (entry.kind === "plan_generated") return (id) => ({ type: "plan", id: id(), text: "", ...planMarker(entry.content) });
+  const role = entry.kind === "system" || entry.kind === "compaction" ? "system" : entry.role === "user" ? "user" : "planner";
+  return (id) => settledMessage(id(), role, entry.content);
+}
+function spawnBrief(step) {
+  try {
+    const args = JSON.parse(step.args);
+    const prompt = args && typeof args === "object" ? args.prompt : void 0;
+    return typeof prompt === "string" ? prompt.trim() : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function spawnedBy(step, unclaimed) {
+  const byId = unclaimed.find((e) => e.subagentId === step.toolCallId);
+  if (byId) return byId;
+  if (step.tool !== "spawn_research_agent") return void 0;
+  const brief = spawnBrief(step);
+  return brief === void 0 ? void 0 : unclaimed.find((e) => e.brief === brief);
+}
+function research(log) {
+  const subagents = log.filter((e) => "type" in e && e.type === "subagent");
+  const ownSubagent = new Set(subagents.map((e) => e.subagentId));
+  const unclaimed = [...subagents];
+  const spawnCall = /* @__PURE__ */ new Map();
+  const placed = [];
+  for (const entry of log) {
+    if ("type" in entry) {
+      if (entry.type === "system") placed.push({ at: entry.timestamp, rank: RESEARCH, build: (id) => settledMessage(id(), "system", entry.content) });
+      continue;
+    }
+    if (entry.subagentId && ownSubagent.has(entry.subagentId)) continue;
+    const spawned = spawnedBy(entry, unclaimed);
+    if (spawned) {
+      unclaimed.splice(unclaimed.indexOf(spawned), 1);
+      spawnCall.set(spawned.subagentId, entry.toolCallId);
+      continue;
+    }
+    placed.push({ at: entry.timestamp, rank: RESEARCH, build: (id) => toolFromStep(id(), entry) });
+  }
+  for (const entry of subagents) {
+    const toolCallId = spawnCall.get(entry.subagentId);
+    const steps = log.filter((e) => !("type" in e) && e.subagentId === entry.subagentId);
+    placed.push({
+      at: entry.timestamp,
+      rank: RESEARCH,
+      build: (id) => subagentBlock(id(), {
+        subagentId: entry.subagentId,
+        brief: entry.brief,
+        status: entry.outcome,
+        digest: entry.digest,
+        children: steps.map((step) => toolFromStep(id(), step)),
+        toolCallId,
+        model: entry.model,
+        usage: entry.usage
+      })
+    });
+  }
+  return placed;
+}
+function fromTranscript(conversationHistory, researchLog, plannerUsage) {
+  const history = conversationHistory ?? [];
+  const compacted = history[0]?.kind === "compaction" ? history[0] : void 0;
+  const kept = compacted ? history.slice(1) : history;
+  const cutoff = compacted ? kept[0]?.timestamp ?? compacted.timestamp : "";
+  const placed = [
+    ...kept.map((entry) => ({ at: entry.timestamp, rank: entry.role === "user" && !entry.kind ? USER : SETTLED, build: fromEntry(entry) })),
+    ...research(researchLog ?? []).filter((item) => item.at >= cutoff)
+  ];
+  placed.sort((a, b) => a.at < b.at ? -1 : a.at > b.at ? 1 : a.rank - b.rank);
+  if (compacted) placed.unshift({ at: "", rank: SETTLED, build: fromEntry(compacted) });
+  let nextId = 1;
+  const id = () => `b${nextId++}`;
+  const blocks = placed.map((item) => item.build(id));
+  if (plannerUsage && isMeasured(plannerUsage.totals)) blocks.push(usageBlock(id(), usageLine(plannerUsage)));
+  const transcriptAt = history.reduce((latest, e) => latest === void 0 || e.timestamp > latest ? e.timestamp : latest, void 0);
+  return { blocks, nextId, ...transcriptAt ? { transcriptAt } : {} };
+}
+
+// src/conversation/promptHold.ts
+var EMPTY_HOLD = [];
+function holdPrompt(hold, text2) {
+  return [...hold, text2];
+}
+function drainNext(hold) {
+  const [text2, ...rest] = hold;
+  return text2 === void 0 ? void 0 : { text: text2, rest };
+}
+function unsendLatest(hold) {
+  if (hold.length === 0) return void 0;
+  return { text: hold[hold.length - 1], rest: hold.slice(0, -1) };
+}
+function unsendAll(hold) {
+  if (hold.length === 0) return void 0;
+  return { text: hold.join("\n"), rest: EMPTY_HOLD };
+}
+function aheadOfDraft(text2, draft) {
+  return draft ? `${text2}
+${draft}` : text2;
+}
+
+// src/conversation/turnGate.ts
+var NO_TURN = { open: null, stopped: null };
+var TURN_STREAM = /* @__PURE__ */ new Set([
+  "planner_text_delta",
+  "planner_thinking_delta",
+  "planner_text_retracted",
+  "planner_message",
+  "plan_token",
+  "research_step",
+  "research_step_done",
+  "subagent_started",
+  "subagent_finished",
+  "planner_turn_ended"
+]);
+function cutOff(gate, input) {
+  if (gate.stopped === null || !TURN_STREAM.has(input.type)) return false;
+  const turnId = "turnId" in input ? input.turnId : void 0;
+  return turnId === void 0 || turnId === gate.stopped;
+}
+function withGate(live, gate) {
+  return gate.open === live.gate.open && gate.stopped === live.gate.stopped ? live : { ...live, gate };
+}
+function followTurn(view, gate, input) {
+  const live = { view, gate };
+  if (input.type === "planner_turn_started") {
+    return withGate({ view: reduceConversation(view, input), gate }, { open: input.turnId, stopped: null });
+  }
+  if (cutOff(gate, input)) {
+    return input.type === "planner_turn_ended" ? withGate(live, { ...gate, stopped: null }) : live;
+  }
+  const next = { view: reduceConversation(view, input), gate };
+  return input.type === "planner_turn_ended" && input.turnId === gate.open ? withGate(next, { ...gate, open: null }) : next;
+}
+function stopTurn(view, gate) {
+  if (gate.open === null) return { view, gate };
+  return {
+    view: reduceConversation(view, { type: "planner_turn_ended", turnId: gate.open, outcome: "stopped" }),
+    gate: { open: null, stopped: gate.open }
+  };
+}
+
+// src/conversation/detail.ts
+function hasHiddenDetail(blocks) {
+  return blocks.some((b) => b.type === "thinking" || b.type === "tool" || b.type === "subagent");
+}
+
+// src/conversation/notices.ts
+function taskStartedNotice(title, runner) {
+  return runner ? `Started "${title}" \xB7 ${runner}` : `Started "${title}"`;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CHECKPOINT_TRUNCATE_LENGTH,
+  EMPTY_CONVERSATION,
+  EMPTY_HOLD,
+  NO_TURN,
+  aheadOfDraft,
   canMergeTasks,
   canSetDependencies,
   canSplitTask,
   capConflictFiles,
   dependencyCandidates,
   dependentsOf,
+  drainNext,
+  followTurn,
+  fromTranscript,
+  hasHiddenDetail,
+  holdPrompt,
+  outputLines,
+  outputPreview,
+  reduceConversation,
+  stopTurn,
   summarizeToolCall,
-  truncateCheckpointSummary
+  taskStartedNotice,
+  toolHeadline,
+  truncateCheckpointSummary,
+  unsendAll,
+  unsendLatest
 });
 //# sourceMappingURL=plan-utils.js.map