@marcoscale98/pi-extensible-workflows 5.14.1-fork.1 → 5.19.1-fork.1

package/dist/src/host-view.js

@@ -1,12 +1,12 @@
 import { keyHint, truncateToVisualLines } from "@earendil-works/pi-coding-agent";
-import { truncateToWidth } from "@earendil-works/pi-tui";
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import { budgetUsage } from "./budget.js";
 import { formatCost, formatTokens } from "./background-widget.js";
-import { BUDGET_DIMENSIONS, HARD_TERMINAL_RUN_STATES, SETTLED_AGENT_STATES, WORKFLOW_AGENT_STALL_THRESHOLD_MS, sumAccounting } from "./types.js";
+import { BUDGET_DIMENSIONS, HARD_TERMINAL_RUN_STATES, SETTLED_AGENT_STATES, WORKFLOW_AGENT_STALL_THRESHOLD_MS, sumAccounting, zeroAccounting } from "./types.js";
 import { object, sanitizeDisplayText } from "./utils.js";
 import { WORKFLOW_PHASE_STATES, buildWorkflowPhaseModel, buildWorkflowPhaseTree, phaseAgentCounts, shellActivityFor, workflowPhaseTreeInitialExpanded, workflowPhaseTreePath, workflowPhaseTreeVisibleNodes, } from "./host-phases.js";
 export { SETTLED_AGENT_STATES } from "./types.js";
-const PLAIN_WORKFLOW_PROGRESS_STYLES = { accent: (text) => text, success: (text) => text, error: (text) => text, warning: (text) => text, muted: (text) => text, dim: (text) => text, bold: (text) => text };
+export const PLAIN_WORKFLOW_PROGRESS_STYLES = { accent: (text) => text, success: (text) => text, error: (text) => text, warning: (text) => text, muted: (text) => text, dim: (text) => text, bold: (text) => text };
 function agentGroupKey(agent) { return JSON.stringify([agent.structuralPath ?? [], agent.parentBreadcrumb ?? null]); }
 function agentGroupLabel(agents) {
     const structural = agents[0]?.structuralPath ?? [];
@@ -42,7 +42,7 @@ function renderGroupedAgents(agents, render, allAgents = agents, groupLabel = (l
 }
 const RUN_STATE_GLYPH = { "not started": "○", queued: "○", pausing: "⏸", paused: "⏸", completed: "✓", failed: "✗", stopped: "✗", interrupted: "↯", budget_exhausted: "!", awaiting_input: "?" };
 const AGENT_STATE_GLYPH = { queued: "○", waiting_for_child: "…", paused: "⏸", retrying: "↻", completed: "✓", failed: "✗", cancelled: "✗" };
-function runStateGlyph(state, running) { return state === "running" ? running : RUN_STATE_GLYPH[state] ?? "◆"; }
+export function runStateGlyph(state, running) { return state === "running" ? running : RUN_STATE_GLYPH[state] ?? "◆"; }
 function agentStateGlyph(state, running) { return state === "running" ? running : AGENT_STATE_GLYPH[state] ?? "○"; }
 const PROGRESS_STATE_STYLE = { completed: "success", failed: "error", cancelled: "error", running: "accent", paused: "warning", pausing: "warning", interrupted: "warning", retrying: "accent", budget_exhausted: "warning", awaiting_input: "warning" };
 const WORKFLOW_ICON_STYLE = { completed: "success", failed: "error", stopped: "error", interrupted: "warning", budget_exhausted: "warning", awaiting_input: "warning", paused: "warning", pausing: "warning", running: "accent" };
@@ -51,10 +51,10 @@ function styleForState(map, state, styles) {
     const key = map[state] ?? "muted";
     return (text) => styles[key](text);
 }
-function progressStyleForState(state, styles) { return styleForState(PROGRESS_STATE_STYLE, state, styles); }
+export function progressStyleForState(state, styles) { return styleForState(PROGRESS_STATE_STYLE, state, styles); }
 function workflowIconStyle(state, styles) { return styleForState(WORKFLOW_ICON_STYLE, state, styles); }
 function phaseStyleForState(state, styles) { return styleForState(PHASE_STATE_STYLE, state, styles); }
-function formatWorkflowRuntime(durationMs) {
+export function formatWorkflowRuntime(durationMs) {
     const seconds = Math.max(0, Math.floor(durationMs / 1000));
     if (seconds < 60)
         return `${String(seconds)}s`;
@@ -74,6 +74,17 @@ function formatShellActivity(activeShells, startedAt, spinner, styles, now) {
     const timing = started && startedAt !== undefined && !Number.isNaN(started.getTime()) ? ` ${styles.dim(`started=${started.toISOString()} elapsed=${formatWorkflowRuntime(Math.max(0, now - startedAt))}`)}` : "";
     return `${styles.accent(spinner)} shell ${styles.accent("[running]")} ${styles.dim(`(${String(count)} active)`)}${timing}`;
 }
+function formatToolActivity(run, spinner, styles, now) {
+    const calls = run.activeTools ?? [];
+    if (!calls.length)
+        return undefined;
+    const counts = new Map();
+    for (const { name } of calls)
+        counts.set(name, (counts.get(name) ?? 0) + 1);
+    const names = [...counts].map(([name, count]) => count > 1 ? `${name} ×${String(count)}` : name).join(", ");
+    const elapsed = formatWorkflowRuntime(Math.max(0, now - Math.min(...calls.map(({ startedAt }) => startedAt))));
+    return `${styles.accent(spinner)} tools ${styles.accent("[running]")} ${sanitizeDisplayText(names)} ${styles.dim(`elapsed=${elapsed}`)}`;
+}
 function formatLogTimestamp(timestamp) {
     if (timestamp === undefined || !Number.isFinite(timestamp))
         return "--:--:--";
@@ -82,7 +93,7 @@ function formatLogTimestamp(timestamp) {
         return "--:--:--";
     return [date.getHours(), date.getMinutes(), date.getSeconds()].map((part) => String(part).padStart(2, "0")).join(":");
 }
-function workflowLogLines(run, styles, expanded, width, showHint = false) {
+function workflowLogLines(run, styles, expanded, width, showHint = false, tail = 5) {
     const events = (run.events ?? []).filter((event) => event.type === "log");
     if (!events.length)
         return [];
@@ -94,7 +105,7 @@ function workflowLogLines(run, styles, expanded, width, showHint = false) {
         const chunks = truncateToVisualLines(message, Number.MAX_SAFE_INTEGER, Math.max(1, width - 11), 0).visualLines;
         return chunks.map((chunk, chunkIndex) => `${chunkIndex === 0 ? prefix : indent}${chunk}`);
     }));
-    const visible = expanded ? visualLines : visualLines.slice(-5);
+    const visible = expanded ? visualLines : visualLines.slice(-tail);
     let hint = "";
     if (!expanded && showHint) {
         try {
@@ -104,7 +115,55 @@ function workflowLogLines(run, styles, expanded, width, showHint = false) {
     }
     return [expanded ? `  ${styles.muted("Logs")}` : `  ${styles.muted(`Logs${hint}`)}`, ...visible];
 }
-export function formatWorkflowProgress(run, spinner = "◇", styles = PLAIN_WORKFLOW_PROGRESS_STYLES, now = Date.now(), expanded = false, width, showHint = false) {
+const ACTIVE_AGENT_STATES = new Set(["running", "waiting_for_child", "retrying", "paused"]);
+const COMPACT_RECENT_SETTLED = 3;
+const COMPACT_LOG_LINES = 3;
+function expandHint() { try {
+    return ` (${keyHint("app.tools.expand", "to expand")})`;
+}
+catch {
+    return "";
+} }
+function agentEnd(agent) { return (agent.startedAt ?? 0) + (agent.durationMs ?? 0); }
+/** One line for a finished phase: outcome counts, wall time across its agents, tokens, and cost. */
+function phaseSummary(agents, styles) {
+    const count = (state) => agents.filter((agent) => agent.state === state).length;
+    const starts = agents.map((agent) => agent.startedAt).filter((value) => value !== undefined);
+    const span = starts.length ? Math.max(...agents.map(agentEnd)) - Math.min(...starts) : 0;
+    const accounting = sumAccounting(agents.map((agent) => agent.accounting ?? zeroAccounting()));
+    const failed = count("failed");
+    const parts = [`${String(count("completed"))} done`, ...(failed ? [styles.error(`${String(failed)} failed`)] : []), ...(count("cancelled") ? [`${String(count("cancelled"))} cancelled`] : []), ...(span > 0 ? [formatWorkflowRuntime(span)] : []), formatTokens(accounting.input + accounting.output), formatCost(accounting.cost)].filter(Boolean);
+    return styles.muted(parts.join(" · "));
+}
+/**
+ * Renders the run; with `maxLines`, a view taller than that limit switches to a compact one so the live block stays on screen.
+ * A block taller than the terminal pushes its changing header above the viewport, and pi-tui then clears and redraws the whole
+ * scrollback on every update, which snaps the reader back to the bottom.
+ */
+export function formatWorkflowProgress(run, spinner = "◇", styles = PLAIN_WORKFLOW_PROGRESS_STYLES, now = Date.now(), expanded = false, width, showHint = false, maxLines) {
+    const full = workflowProgressLines(run, spinner, styles, now, expanded, width, showHint);
+    if (expanded || maxLines === undefined || full.length <= maxLines)
+        return full.join("\n");
+    // Finished phases collapse to a summary line; the current one keeps failed, active, and the latest settled agents, in that priority.
+    const phases = run.phaseHistory?.length ? run.phaseHistory : run.phase ? [{ phase: run.phase, afterAgent: 0 }] : [];
+    const currentStart = Math.min(run.agents.length, phases.at(-1)?.afterAgent ?? 0);
+    const current = run.agents.slice(currentStart);
+    const recent = current.filter((agent) => SETTLED_AGENT_STATES.has(agent.state) && agent.state !== "failed").sort((left, right) => agentEnd(right) - agentEnd(left)).slice(0, COMPACT_RECENT_SETTLED);
+    const candidates = [...current.filter((agent) => agent.state === "failed"), ...current.filter((agent) => ACTIVE_AGENT_STATES.has(agent.state)), ...recent];
+    const render = (count) => workflowProgressLines(run, spinner, styles, now, false, width, showHint, new Set(candidates.slice(0, count)));
+    let low = 0;
+    let high = candidates.length;
+    while (low < high) {
+        const middle = Math.ceil((low + high) / 2);
+        if (render(middle).length <= maxLines)
+            low = middle;
+        else
+            high = middle - 1;
+    }
+    // NOTE: failures in finished phases always stay listed, so a run with more of them than maxLines still overflows.
+    return render(low).join("\n");
+}
+function workflowProgressLines(run, spinner, styles, now, expanded, width, showHint, shown) {
     const done = run.agents.filter((agent) => SETTLED_AGENT_STATES.has(agent.state)).length;
     const workflowIcon = runStateGlyph(run.state, spinner);
     const iconStyle = workflowIconStyle(run.state, styles);
@@ -119,15 +178,20 @@ export function formatWorkflowProgress(run, spinner = "◇", styles = PLAIN_WORK
     const shellActivity = scopedShells ? undefined : formatShellActivity(run.activeShells, run.activeShellStartedAt, spinner, styles, now);
     if (shellActivity)
         lines.push(`  ${shellActivity}`);
+    const toolActivity = formatToolActivity(run, spinner, styles, now);
+    if (toolActivity)
+        lines.push(`  ${toolActivity}`);
     const byId = new Map(run.agents.map((agent) => [agent.id, agent]));
-    const renderAgents = (agents, offset, nested) => renderGroupedAgents(agents, ({ agent, index, depth }, grouped) => {
-        const icon = agentStateGlyph(agent.state, spinner);
+    const position = new Map(run.agents.map((agent, index) => [agent, index]));
+    const renderAgents = (agents, nested) => renderGroupedAgents(agents, ({ agent, depth }, grouped) => {
+        const icon = agentStateGlyph(agent.state, "●");
         const indent = "  ".repeat((grouped ? 2 : 1) + depth);
-        const activity = SETTLED_AGENT_STATES.has(agent.state) ? "" : formatAgentActivity(agent, spinner, styles, now);
+        const idleSpinner = agent.state === "running" && !agentActivityLabel(agent) ? styles.accent(spinner) : "";
+        const activity = SETTLED_AGENT_STATES.has(agent.state) ? "" : [idleSpinner, formatAgentActivity(agent, spinner, styles, now)].filter(Boolean).join(" ");
         const name = grouped ? agent.label ?? agent.name : styledAgentBreadcrumb(agent, byId, styles);
         const state = progressStyleForState(agent.state, styles);
         const detail = expanded ? formatWorkflowAgentDetail(agent, now) : "";
-        return `${indent}#${String(offset + index + 1)} ${state(icon)} ${name} ${state(`[${agent.state}]`)}${activity ? ` ${activity}` : ""}${detail ? ` ${detail}` : ""}`;
+        return `${indent}#${String((position.get(agent) ?? 0) + 1)} ${state(icon)} ${name} ${state(`[${agent.state}]`)}${activity ? ` ${activity}` : ""}${detail ? ` ${detail}` : ""}`;
     }, run.agents, (label) => styles.muted(label)).map((line) => nested ? `  ${line}` : line);
     const phases = run.phaseHistory?.length ? run.phaseHistory : run.phase ? [{ phase: run.phase, afterAgent: 0 }] : [];
     if (scopedShells) {
@@ -141,10 +205,25 @@ export function formatWorkflowProgress(run, spinner = "◇", styles = PLAIN_WORK
     }
     let renderedAgents = 0;
     let nested = false;
+    // In compact mode (`shown` set) earlier segments list only their failures, and the current one only the shown agents plus a count of the rest.
+    const segment = (agents, closed) => {
+        if (!shown)
+            return renderAgents(agents, nested);
+        const listed = agents.filter((agent) => closed ? agent.state === "failed" : shown.has(agent));
+        const hidden = closed ? [] : agents.filter((agent) => !shown.has(agent));
+        const counts = [["queued", hidden.filter((agent) => !SETTLED_AGENT_STATES.has(agent.state) && !ACTIVE_AGENT_STATES.has(agent.state)).length], ["running", hidden.filter((agent) => ACTIVE_AGENT_STATES.has(agent.state)).length], ["done", hidden.filter((agent) => SETTLED_AGENT_STATES.has(agent.state)).length]];
+        const summary = counts.filter(([, count]) => count > 0).map(([label, count]) => `+${String(count)} ${label}`).join(" · ");
+        return [...renderAgents(listed, nested), ...(summary ? [`${nested ? "    " : "  "}${styles.muted(`… ${summary}${showHint ? expandHint() : ""}`)}`] : [])];
+    };
     for (const [phaseIndex, phase] of phases.entries()) {
         const boundary = Math.max(renderedAgents, Math.min(run.agents.length, phase.afterAgent));
-        lines.push(...renderAgents(run.agents.slice(renderedAgents, boundary), renderedAgents, nested));
-        lines.push(`  ${styles.muted(`[Phase: ${phase.phase}]`)}`);
+        const before = run.agents.slice(renderedAgents, boundary);
+        if (shown && !nested && before.length)
+            lines.push(`  ${phaseSummary(before, styles)}`);
+        lines.push(...segment(before, true));
+        const next = phases[phaseIndex + 1];
+        const phaseAgents = next ? run.agents.slice(boundary, Math.max(boundary, Math.min(run.agents.length, next.afterAgent))) : [];
+        lines.push(`  ${styles.muted(`[Phase: ${phase.phase}]`)}${shown && next ? ` ${phaseSummary(phaseAgents, styles)}` : ""}`);
         const phaseShell = scopedShells ? shellActivityFor(run, phaseIndex) : undefined;
         if (phaseShell) {
             const rendered = formatShellActivity(phaseShell.active, phaseShell.startedAt, spinner, styles, now);
@@ -154,9 +233,9 @@ export function formatWorkflowProgress(run, spinner = "◇", styles = PLAIN_WORK
         renderedAgents = boundary;
         nested = true;
     }
-    lines.push(...renderAgents(run.agents.slice(renderedAgents), renderedAgents, nested));
-    lines.push(...workflowLogLines(run, styles, expanded, width, showHint));
-    return lines.join("\n");
+    lines.push(...segment(run.agents.slice(renderedAgents), false));
+    lines.push(...workflowLogLines(run, styles, expanded, width, showHint, shown ? COMPACT_LOG_LINES : 5));
+    return lines;
 }
 const workflowSpinner = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 const WORKFLOW_PROGRESS_REFRESH_MS = 1_000;
@@ -418,14 +497,18 @@ export function workflowProgressBlock(run, theme, progress, refresh, invalidate,
             }
             previousState = displayed.state;
             const frame = displayed.state === "running" ? workflowSpinner[Math.floor(now / 80) % workflowSpinner.length] ?? "◇" : "◇";
-            const progressText = formatWorkflowProgress(displayed, frame, styles, now, expanded, width, true);
+            // pi-tui only patches rows that are still on screen; leave room below the block for the editor and footer.
+            // A finished or frozen block no longer changes, so it keeps the full list.
+            const rows = freezeAt === undefined && !terminal ? process.stdout.rows : undefined;
+            const maxLines = rows ? Math.max(6, rows - 10) - (prefix ? prefix.split("\n").length + 1 : 0) : undefined;
+            const progressText = formatWorkflowProgress(displayed, frame, styles, now, expanded, width, true, maxLines);
             return truncateWorkflowProgress(prefix ? `${prefix}\n\n${progressText}` : progressText, width);
         },
         setExpanded(value) { expanded = value; },
         invalidate() {
             const displayed = currentRun();
             const now = Date.now();
-            if (!progress || !refresh || displayed.state !== "running" || (!displayed.agents.some((agent) => agent.state === "running") && (displayed.activeShells ?? 0) <= 0))
+            if (!progress || !refresh || displayed.state !== "running" || (!displayed.agents.some((agent) => agent.state === "running") && (displayed.activeShells ?? 0) <= 0 && !displayed.activeTools?.length))
                 return;
             if (progress.refresh || now - progress.lastRefreshAt < WORKFLOW_PROGRESS_REFRESH_MS)
                 return;
@@ -538,7 +621,7 @@ export function formatStalledDuration(durationMs) {
     const remainingMinutes = minutes % 60;
     return `${String(hours)}h${remainingMinutes ? ` ${String(remainingMinutes)}m` : ""}`;
 }
-function stalledDuration(agent, now) {
+export function stalledDuration(agent, now) {
     if (agent.state !== "running" || agent.lastEventAt === undefined || !Number.isFinite(agent.lastEventAt))
         return undefined;
     const duration = now - agent.lastEventAt;
@@ -550,7 +633,7 @@ function elapsedDurationMs(agent, end) {
         return Math.max(0, agent.durationMs);
     return agent.startedAt === undefined || !Number.isFinite(agent.startedAt) ? undefined : Math.max(0, end - agent.startedAt);
 }
-function agentActivityLabel(agent) {
+export function agentActivityLabel(agent) {
     const activity = agent.activity;
     if (activity?.kind === "reasoning" || activity?.kind === "text") {
         const name = activity.kind === "reasoning" ? "reasoning" : "responding";
@@ -588,7 +671,7 @@ function formatAccounting(accounting) {
     const total = accounting.input + accounting.output + accounting.cacheRead + accounting.cacheWrite;
     return `${formatAccountingValue(total)} tok`;
 }
-function formatAgentError(error, styles = PLAIN_WORKFLOW_PROGRESS_STYLES) {
+export function formatAgentError(error, styles = PLAIN_WORKFLOW_PROGRESS_STYLES) {
     return styles.error(`Error: ${error.code}: ${error.message}`);
 }
 export function formatAgentDetail(agent, styles = PLAIN_WORKFLOW_PROGRESS_STYLES, now = Date.now(), options = {}) {
@@ -663,6 +746,9 @@ export function formatNavigatorDashboard(run, checkpoints, worktrees, now = Date
     const shellActivity = formatShellActivity(run.activeShells, run.activeShellStartedAt, "⠦", PLAIN_WORKFLOW_PROGRESS_STYLES, now);
     if (shellActivity)
         lines.push(`  ${shellActivity}`);
+    const toolActivity = formatToolActivity(run, "⠦", PLAIN_WORKFLOW_PROGRESS_STYLES, now);
+    if (toolActivity)
+        lines.push(`  ${toolActivity}`);
     if (run.error)
         lines.push(`Error: ${run.error.code}: ${run.error.message}`);
     if (run.events?.length)
@@ -708,6 +794,9 @@ export function formatNavigatorRun(loaded, checkpoints, worktrees, now = Date.no
     const shellActivity = formatShellActivity(run.activeShells, run.activeShellStartedAt, "⠦", PLAIN_WORKFLOW_PROGRESS_STYLES, now);
     if (shellActivity)
         lines.push(`  ${shellActivity}`);
+    const toolActivity = formatToolActivity(run, "⠦", PLAIN_WORKFLOW_PROGRESS_STYLES, now);
+    if (toolActivity)
+        lines.push(`  ${toolActivity}`);
     if (run.error)
         lines.push(`Run error: ${run.error.code}: ${run.error.message}`);
     if (run.events?.length)
@@ -751,11 +840,7 @@ export function formatWorkflowPhaseDashboard(run, snapshot, width, selection = {
     const model = buildWorkflowPhaseModel(run, snapshot);
     const tree = buildWorkflowPhaseTree(model);
     const expanded = selection.expandedNodeIds === undefined ? workflowPhaseTreeInitialExpanded(tree) : new Set(selection.expandedNodeIds);
-    const wrap = (text, limit = safeWidth) => truncateToVisualLines(text, Number.MAX_SAFE_INTEGER, Math.max(1, limit), 0).visualLines.map((line) => line.trimEnd());
-    // ponytail: ANSI-only width, good enough for the ASCII labels the tree renders
-    const ansiPattern = new RegExp(ANSI_SGR_SOURCE, "g");
-    const visibleLength = (text) => text.replace(ansiPattern, "").length;
-    const padTo = (text, limit) => `${text}${" ".repeat(Math.max(0, limit - visibleLength(text)))}`;
+    const wrap = (text) => wrapNavigatorLine(text, safeWidth);
     const phaseStyle = (state) => phaseStyleForState(state, styles);
     const phase = selection.phaseId ? model.phases.find((candidate) => candidate.id === selection.phaseId) : undefined;
     const selectedByAgent = selection.agentId ? tree.nodes.find((node) => node.kind === "agent" && node.agentId === selection.agentId && (!selection.phaseId || node.phaseId === selection.phaseId)) : undefined;
@@ -833,35 +918,41 @@ export function formatWorkflowPhaseDashboard(run, snapshot, width, selection = {
     const shellActivity = scopedShells ? undefined : formatShellActivity(run.activeShells, run.activeShellStartedAt, "⠦", styles, now);
     if (shellActivity)
         lines.push(`  ${shellActivity}`);
-    const renderTree = (limit) => [styles.bold("Tree"), ...(visibleNodes.length ? visibleNodes.flatMap((node) => wrap(treeLine(node), limit)) : [styles.muted("(empty)")])];
+    const toolActivity = formatToolActivity(run, "⠦", styles, now);
+    if (toolActivity)
+        lines.push(`  ${toolActivity}`);
     const actionRows = () => {
         const actions = selection.actions;
         if (!actions)
             return [];
         return ["", styles.bold(actions.title), ...actions.options.map((option, index) => `${index === actions.index ? "→ " : "  "}${index === actions.index ? styles.accent(option) : option}`)];
     };
-    const detailRows = () => [...details(selectedNode), ...actionRows()];
-    if (safeWidth >= 80) {
-        const sidebarWidth = Math.min(42, Math.max(24, Math.floor((safeWidth - 3) * 0.38)));
-        const detailWidth = Math.max(1, safeWidth - sidebarWidth - 3);
-        const sidebar = renderTree(sidebarWidth).flatMap((line) => wrap(line, sidebarWidth));
-        const detail = detailRows().flatMap((line) => wrap(line, detailWidth));
-        const rows = Math.max(sidebar.length, detail.length);
-        for (let index = 0; index < rows; index += 1)
-            lines.push(`${padTo(sidebar[index] ?? "", sidebarWidth)} | ${detail[index] ?? ""}`);
-    }
-    else if (selection.detailsOnly) {
-        lines.push(...detailRows().flatMap((line) => wrap(line)));
-    }
-    else {
-        lines.push(...renderTree(safeWidth));
-        if (!selection.treeOnly)
-            lines.push("", ...detailRows().flatMap((line) => wrap(line)));
-    }
+    const treeRows = [styles.bold("Tree"), ...(visibleNodes.length ? visibleNodes.map(treeLine) : [styles.muted("(empty)")])];
+    lines.push(...formatNavigatorColumns(treeRows, [...details(selectedNode), ...actionRows()], safeWidth, selection));
     if (model.unassignedAgents?.length && !tree.nodes.some((node) => node.phaseId === "unassigned"))
         lines.push(...wrap(styles.muted(`Unassigned agents: ${String(model.unassignedAgents.length)}`)));
     return lines.flatMap((line) => wrap(line));
 }
+function wrapNavigatorLine(text, width) {
+    return truncateToVisualLines(text, Number.MAX_SAFE_INTEGER, Math.max(1, width), 0).visualLines.map((line) => line.trimEnd());
+}
+/** The navigator layout: a sidebar beside details at 80 columns or wider, otherwise one of them (or both stacked). */
+export function formatNavigatorColumns(sidebar, detail, width, layout = {}) {
+    const safeWidth = Math.max(1, width);
+    if (safeWidth >= 80) {
+        const sidebarWidth = Math.min(42, Math.max(24, Math.floor((safeWidth - 3) * 0.38)));
+        const left = sidebar.flatMap((line) => wrapNavigatorLine(line, sidebarWidth));
+        const right = detail.flatMap((line) => wrapNavigatorLine(line, safeWidth - sidebarWidth - 3));
+        return Array.from({ length: Math.max(left.length, right.length) }, (_, index) => {
+            const cell = left[index] ?? "";
+            return `${cell}${" ".repeat(Math.max(0, sidebarWidth - visibleWidth(cell)))} | ${right[index] ?? ""}`;
+        });
+    }
+    if (layout.detailsOnly)
+        return detail.flatMap((line) => wrapNavigatorLine(line, safeWidth));
+    const left = sidebar.flatMap((line) => wrapNavigatorLine(line, safeWidth));
+    return layout.treeOnly ? left : [...left, ...detail.flatMap((line) => wrapNavigatorLine(line, safeWidth))];
+}
 export function formatCheckpointReview(checkpoint) {
     const context = JSON.stringify(checkpoint.context, null, 2);
     return [`Name: ${checkpoint.name}`, "Prompt:", checkpoint.prompt, context === "null" ? "Context: null" : "Context:", ...(context === "null" ? [] : [context])].join("\n");

package/dist/src/host.d.ts

@@ -2,7 +2,7 @@ import { Type } from "@earendil-works/pi-ai";
 import { copyToClipboard, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { type BackgroundWidgetAPI } from "./background-widget.js";
 import { type AgentTransport } from "./types.js";
-export type WorkflowExtensionAPI = Pick<ExtensionAPI, "appendEntry" | "getActiveTools" | "getThinkingLevel" | "on" | "registerCommand" | "registerTool" | "sendMessage"> & Pick<BackgroundWidgetAPI, "events" | "registerEntryRenderer" | "registerShortcut">;
+export type WorkflowExtensionAPI = Pick<ExtensionAPI, "appendEntry" | "getActiveTools" | "getThinkingLevel" | "on" | "registerCommand" | "registerTool" | "sendMessage"> & Partial<Pick<ExtensionAPI, "getAllTools">> & Pick<BackgroundWidgetAPI, "events" | "registerEntryRenderer" | "registerShortcut">;
 export { agentBreadcrumb, agentBreadcrumbParts, formatBudgetStatus, formatNavigatorDashboard, formatNavigatorRun, formatStalledDuration, formatWorkflowPhaseDashboard, formatWorkflowProgress, navigatorAttentionSort, truncateWorkflowProgress, } from "./host-view.js";
 export { buildWorkflowPhaseModel, buildWorkflowPhaseTree, navigateWorkflowPhaseTree, preserveWorkflowPhaseSelection, preserveWorkflowPhaseTreeSelection, workflowPhaseTreeInitialExpanded, workflowPhaseTreeVisibleNodes } from "./host-phases.js";
 export type { WorkflowPhaseAgentCounts, WorkflowPhaseModel, WorkflowPhaseSelection, WorkflowPhaseState, WorkflowPhaseTree, WorkflowPhaseTreeDirection, WorkflowPhaseTreeNode, WorkflowPhaseTreeNodeKind, WorkflowPhaseTreeSelection, WorkflowPhaseView, } from "./host-phases.js";
@@ -16,7 +16,7 @@ export declare function formatWorkflowPreview(args: {
     description?: unknown;
 }): string;
 export declare const WORKFLOW_TOOL_LABEL = "Workflow";
-export declare const WORKFLOW_TOOL_DESCRIPTION = "Run a deterministic JavaScript workflow with a named inline or file-backed parallel-to-summary path by default";
+export declare const WORKFLOW_TOOL_DESCRIPTION = "Run a deterministic JavaScript workflow with a named inline or file-backed parallel-to-summary path by default. Scripts call this session's tools as `await tools.<name>(args)`, outside withWorktree: a tool resolves to its text unless its description gives a `tools.<name>(args)` result shape, and failures reject";
 export declare const WORKFLOW_TOOL_PROMPT_SNIPPET = "Run a deterministic, resumable JavaScript workflow. Prefer a named inline script that fans out independent work with parallel(...), awaits the keyed results before interpolating them into one summarizing agent(...), and returns. Provide exactly one of script or scriptPath and a non-empty name. Registered catalog functions are available as globals inside the script; call them there, for example return await someFunction(args). Advanced controls include registered functions, outputSchema, budgets, checkpoints, worktrees, retry/resume, CLI export, and pipelines. Runs are in the background by default; completion arrives as a follow-up message. Set foreground: true when the caller must wait for the final value. Manage runs from the interactive /workflow picker; use workflow_status, workflow_resume, workflow_retry, workflow_stop, and workflow_respond for explicit tool controls. If a foreground call detaches before its result is accepted, its terminal success or failure is promoted to one follow-up message. Foreground results include the completed run ID. Recovery inherits the source launch mode; legacy snapshots without launchMode recover in the background. Set foreground: true or false on workflow_resume/workflow_retry to override it; foreground recovery waits for terminal value and run details, while background recovery returns immediately and delivers completion or failure as a follow-up. After failure follow-ups, especially CANCELLED or interrupted runs, call workflow_status({ runId }) before recovery or replacement work, then pass its state as expectedState to workflow_retry/workflow_resume so recovery cannot act on a state that changed. Recovery map: agent(..., { retries }) reruns one agent call in the same run for transient failures; workflow_retry({ runId, expectedState?, foreground? }) replays a failed run into a child; workflow_resume({ runId, expectedState?, budget?, foreground? }) continues a budget_exhausted run; parentRunId on a new launch only borrows named worktrees and never replays or resumes.";
 export declare const WORKFLOW_TOOL_PARAMETERS: Type.TObject<{
     name: Type.TString;