@marcoscale98/pi-extensible-workflows 5.14.1-fork.1 → 5.17.0-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`;
@@ -82,7 +82,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 +94,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 +104,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);
@@ -120,14 +168,15 @@ export function formatWorkflowProgress(run, spinner = "◇", styles = PLAIN_WORK
     if (shellActivity)
         lines.push(`  ${shellActivity}`);
     const byId = new Map(run.agents.map((agent) => [agent.id, agent]));
-    const renderAgents = (agents, offset, nested) => renderGroupedAgents(agents, ({ agent, index, depth }, grouped) => {
+    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, spinner);
         const indent = "  ".repeat((grouped ? 2 : 1) + depth);
         const activity = SETTLED_AGENT_STATES.has(agent.state) ? "" : formatAgentActivity(agent, spinner, styles, now);
         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 +190,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 +218,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,7 +482,11 @@ 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; },
@@ -588,7 +656,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 = {}) {
@@ -751,11 +819,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 +897,38 @@ 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 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.js

@@ -13,7 +13,8 @@ import { acquireSessionLease, isPersistedRun, listPersistedSessionIds, listRunId
 import { retainTerminalRuns } from "./retention.js";
 import { validateBudget, WorkflowBudgetRuntime } from "./budget.js";
 import { SerialLane, asWorkflowError, createLaunchSnapshot, errorCode, errorText, fail, isNodeError, jsonValue, mergeWorkflowExtensionSettings, modelAliasErrorName, modelCapability, object, parseModelReference, positiveInteger, sanitizeDisplayText, validateModelAliases } from "./utils.js";
-import { loadAgentDefinitions, loadProjectAgentDefinitions, loadSettings, preflight, resolveAgentResourcePolicy, resolveWorkflowSettings, validateCheckpoint, validateModelAliasAvailability, validateWorkflowLaunchWithRegistry, workflowProjectSettingsPath, workflowSettingsPath } from "./validation.js";
+import { loadSettings, preflight, resolveAgentResourcePolicy, resolveWorkflowSettings, validateCheckpoint, validateModelAliasAvailability, validateWorkflowLaunchWithRegistry, workflowProjectSettingsPath, workflowSettingsPath } from "./validation.js";
+import { loadAgentDefinitions, loadProjectAgentDefinitions } from "./roles.js";
 import { beginWorkflowExtensionLoading, loadingRegistry, resetWorkflowRegistryIfIdle, retainWorkflowRegistry } from "./registry.js";
 import { agentHandleTurnPath, agentIdentityPath, agentWorktree, encoded, executeShellCommand, persistActiveAgentAttempt, persistAgentAttempts, readShellResult, runWorkflow, shellIdentityPath } from "./execution.js";
 import backgroundWidget from "./background-widget.js";
@@ -22,7 +23,7 @@ import { createTrajectoryRunLoader, createTrajectoryRunMetadataLoader, createTra
 import { getTrajectoryHost } from "./trajectory-host-handle.js";
 import { getSubagentManager } from "./subagent-manager-handle.js";
 import { HARD_TERMINAL_RUN_STATES, LAUNCH_SNAPSHOT_IDENTITY_VERSION, WORKFLOW_BLOCKED_EVENT, WorkflowError, isContextFileScope, isExternallyEndedRunState, isHardTerminalRunState, roleNameOf } from "./types.js";
-import { SETTLED_AGENT_STATES, catalogResultValue, formatWorkflowCatalog, styledTextBlock, textBlock, workflowCatalogBlock, workflowControlCall, workflowControlResult, workflowProgressBlock, formatWorkflowProgress, } from "./host-view.js";
+import { SETTLED_AGENT_STATES, catalogResultValue, formatWorkflowCatalog, styledTextBlock, textBlock, workflowCatalogBlock, workflowControlCall, workflowControlResult, workflowProgressBlock, } from "./host-view.js";
 import { DELIVERY_LIMIT_BYTES, ForegroundDeliveryController, markWorkflowFailureDiagnostics, WORKFLOW_LOG_ENTRY, completionDescriptor, completionDeliveryFromStore, createWorkflowFailureDiagnostics, failureDiagnosticsFrom, formatWorkflowFailure, formatWorkflowFailureDelivery, formatWorkflowFailureDeliveryFallback, formatWorkflowFailureDiagnostics, isWorkflowFailureDiagnostics, serializeWorkflowFailureDiagnostics, utf8Prefix, } from "./host-delivery.js";
 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";
@@ -119,7 +120,9 @@ export const WORKFLOW_TOOL_PARAMETERS = Type.Object({
 export const WORKFLOW_STATUS_PARAMETERS = Type.Object({ runId: Type.String({ description: "Workflow run ID visible in the current project" }) }, { additionalProperties: false });
 export const WORKFLOW_RETRY_PARAMETERS = Type.Object({ runId: Type.String({ description: "Explicit failed workflow run ID" }), expectedState: Type.Optional(Type.String({ description: "Persisted source state observed before recovery" })), foreground: Type.Optional(Type.Boolean({ description: "Override the source launch mode for this recovery" })) });
 function workflowToolUpdate(run) {
-    return { content: [{ type: "text", text: formatWorkflowProgress(run) }], details: { runId: run.id, run } };
+    //NOTE: renderers read details.run; the partial text stays O(1) so high-frequency updates never format the whole tree.
+    const done = run.agents.filter((agent) => SETTLED_AGENT_STATES.has(agent.state)).length;
+    return { content: [{ type: "text", text: `Workflow: ${run.workflowName} (${String(done)}/${String(run.agents.length)} done) [${run.state}]` }], details: { runId: run.id, run } };
 }
 function agentWithProgress(agent, progress) {
     const next = { ...agent, accounting: progress.accounting, toolCalls: progress.toolCalls };
@@ -143,6 +146,7 @@ function deliver(pi, content) {
     pi.sendMessage({ customType: "workflow", content, display: true }, { deliverAs: "followUp", triggerTurn: true });
 }
 const WORKFLOW_WARNING_ENTRY = "workflow-warning";
+const PROGRESS_COALESCE_MS = 100;
 function deliverWarning(pi, content) {
     pi.appendEntry(WORKFLOW_WARNING_ENTRY, { message: content });
 }
@@ -406,7 +410,6 @@ export default function workflowExtension(pi, home, clipboard = copyToClipboard,
         const trusted = projectTrusted(context);
         const settings = resolveWorkflowSettings(cwd, trusted, workflowSettingsPath(extensionAgentDir)).effective.extensionSettings?.trajectory;
         const port = settings?.port;
-        const themes = settings?.themes ?? false;
         const loadRuns = createTrajectoryRunLoader(cwd, sessionId, home, overlayLiveRun);
         const loadSubagents = createTrajectorySubagentLoader(cwd, sessionId, extensionAgentDir, overlayLiveSubagent);
         const loadRunsMetadata = createTrajectoryRunMetadataLoader(cwd, sessionId, home, overlayLiveRun);
@@ -415,7 +418,7 @@ export default function workflowExtension(pi, home, clipboard = copyToClipboard,
             const live = liveSubagents.get(subagentId);
             return live?.status.sessionId === sessionId ? live.status.attemptDetails?.at(-1)?.session : undefined;
         });
-        return { cwd, sessionId, ...(port === undefined ? {} : { port }), themes, loadRuns, loadSubagents, loadMetadata: async () => ({ runs: await loadRunsMetadata(), subagents: await loadSubagentsMetadata() }), loadTranscript, handleAction: (request) => trajectoryAction(request, context) };
+        return { cwd, sessionId, ...(port === undefined ? {} : { port }), loadRuns, loadSubagents, loadMetadata: async () => ({ runs: await loadRunsMetadata(), subagents: await loadSubagentsMetadata() }), loadTranscript, handleAction: (request) => trajectoryAction(request, context) };
     };
     const withLiveActivities = (run) => liveAgents.overlay(run);
     /** Overlays the in-memory lifecycle state and budget usage of an active run onto its persisted record. */
@@ -619,25 +622,54 @@ export default function workflowExtension(pi, home, clipboard = copyToClipboard,
         const run = runs.get(runId);
         if (!run)
             throw new WorkflowError("INTERNAL_ERROR", `Unknown production run: ${runId}`);
+        const applyProgress = async (progress) => {
+            let runState;
+            if (progress.persist) {
+                runState = await persistRunState(run.store, run.metadata, (current) => current.agents.some((agent) => agent.id === id) ? { ...current, ...run.budget.snapshot(), agents: current.agents.map((agent) => agent.id === id ? agentWithProgress(agent, progress) : agent) } : current);
+            }
+            else {
+                const loaded = await run.store.loadStatus();
+                if (!loaded.agents.some((agent) => agent.id === id))
+                    return;
+                runState = { ...loaded, ...run.budget.snapshot(), agents: loaded.agents.map((agent) => agent.id === id ? agentWithProgress(agent, progress) : agent) };
+            }
+            if (!runState.agents.some((agent) => agent.id === id))
+                return;
+            liveAgents.setActivity(runId, id, progress.activity);
+            liveAgents.setEventTime(runId, id, progress.lastEventAt);
+            run.update?.(workflowToolUpdate(withLiveActivities(runState)));
+        };
+        // Display-only progress bursts coalesce to one trailing apply per window; persisted progress always applies immediately.
+        let deferred;
+        let deferredTimer;
+        let appliedAt = 0;
+        const cancelDeferredProgress = () => {
+            if (deferredTimer)
+                clearTimeout(deferredTimer);
+            deferredTimer = undefined;
+            deferred = undefined;
+        };
+        const onProgress = async (progress) => {
+            const now = Date.now();
+            if (progress.persist || (!deferredTimer && now - appliedAt >= PROGRESS_COALESCE_MS)) {
+                cancelDeferredProgress();
+                appliedAt = now;
+                await applyProgress(progress);
+                return;
+            }
+            deferred = progress;
+            deferredTimer ??= setTimeout(() => {
+                deferredTimer = undefined;
+                const next = deferred;
+                deferred = undefined;
+                if (!next)
+                    return;
+                appliedAt = Date.now();
+                void applyProgress(next).catch(() => undefined);
+            }, Math.max(0, PROGRESS_COALESCE_MS - (now - appliedAt))).unref();
+        };
         try {
             const budget = run.budget.forAgent(id);
-            const onProgress = async (progress) => {
-                let runState;
-                if (progress.persist) {
-                    runState = await persistRunState(run.store, run.metadata, (current) => current.agents.some((agent) => agent.id === id) ? { ...current, ...run.budget.snapshot(), agents: current.agents.map((agent) => agent.id === id ? agentWithProgress(agent, progress) : agent) } : current);
-                }
-                else {
-                    const loaded = await run.store.load();
-                    if (!loaded.run.agents.some((agent) => agent.id === id))
-                        return;
-                    runState = { ...loaded.run, ...run.budget.snapshot(), agents: loaded.run.agents.map((agent) => agent.id === id ? agentWithProgress(agent, progress) : agent) };
-                }
-                if (!runState.agents.some((agent) => agent.id === id))
-                    return;
-                liveAgents.setActivity(runId, id, progress.activity);
-                liveAgents.setEventTime(runId, id, progress.lastEventAt);
-                run.update?.(workflowToolUpdate(withLiveActivities(runState)));
-            };
             const onAttempt = async (attempt) => {
                 liveAgents.setSession(runId, id, attempt.liveSession);
                 liveAgents.setHandoff(runId, id, attempt);
@@ -654,6 +686,7 @@ export default function workflowExtension(pi, home, clipboard = copyToClipboard,
                 run.update?.(workflowToolUpdate(withLiveActivities(persisted)));
             };
             const result = await run.executor.execute(prompt, { label: options.label, workflowName: run.metadata.name, tuiIndex, tuiLabel: options.requestedLabel ?? options.label, agentNodeId: id, ...(options.extensionSettings === undefined ? {} : { inheritedExtensionSettings: options.extensionSettings }), onProgress, onAttempt, budget, ...(run.providerErrorRecovery ? { providerErrorRecovery: run.providerErrorRecovery } : {}), ...(parentId ? { parent: parentId, cwd: options.cwd, ...(options.worktreeOwner ? { worktreeOwner: options.worktreeOwner } : {}) } : options.worktreeOwner ? { worktreeOwner: options.worktreeOwner } : {}), ...(options.model ? { model: options.model } : {}), ...(options.role ? { role: options.role } : {}), ...(options.contextFiles ? { contextFiles: options.contextFiles } : {}), tools: options.tools, ...(options.skills ? { skills: options.skills } : {}), ...(options.extensions ? { extensions: options.extensions } : {}), effectiveTools: options.tools, ...(options.schema ? { schema: options.schema } : {}), ...(options.retries === undefined ? {} : { retries: options.retries }), ...(options.timeoutMs === undefined ? {} : { timeoutMs: options.timeoutMs }), ...(options.sessionPath ? { sessionPath: options.sessionPath } : {}), ...(options.agentOptions ? { agentOptions: options.agentOptions } : {}), ...(options.agentIdentity ? { agentIdentity: options.agentIdentity } : {}) }, signal, scheduler.toolsFor(id, (role, tools, model, inheritedTools, skills, extensions) => run.executor.resolve({ label: "child", workflowName: run.metadata.name, ...(model ? { model } : {}), ...(role ? { role } : {}), ...(tools !== undefined ? { tools } : {}), ...(skills !== undefined ? { skills } : {}), ...(extensions !== undefined ? { extensions } : {}) }, inheritedTools).tools), setSteer, () => { scheduler.cancelChildren(id); scheduler.retry(id); });
+            cancelDeferredProgress();
             const before = (await run.store.load()).run;
             await persistAgentAttempts(run.store, id, result.attempts);
             const completed = (await run.store.load()).run;
@@ -665,6 +698,7 @@ export default function workflowExtension(pi, home, clipboard = copyToClipboard,
             return result.value;
         }
         catch (error) {
+            cancelDeferredProgress();
             liveAgents.setSession(runId, id);
             const attempts = getAgentAttempts(error);
             if (attempts?.length) {
@@ -1484,8 +1518,7 @@ export default function workflowExtension(pi, home, clipboard = copyToClipboard,
                     state.workflowProgressComponent = workflowProgressBlock(currentProgress?.run ?? incoming, theme, currentProgress, async () => {
                         const active = runs.get(incoming.id);
                         const store = active?.store ?? new RunStore(incoming.cwd, incoming.sessionId, incoming.id, home);
-                        const loaded = await store.load();
-                        return withLiveActivities(loaded.run);
+                        return withLiveActivities(await store.loadStatus());
                     }, () => { if (state.workflowProgress === currentProgress)
                         requestRender(); }, undefined, state.workflowProgressFrozenAt);
                 }

package/dist/src/index.d.ts

@@ -6,12 +6,14 @@ export * from "./utils.js";
 export { canonicalPath, sameFilesystemPath } from "./paths.js";
 export * from "./budget.js";
 export * from "./validation.js";
+export * from "./roles.js";
 export * from "./registry.js";
 export * from "./execution.js";
 export * from "./host.js";
 export * from "./workflow-artifacts.js";
 export { formatCost } from "./background-widget.js";
-export { agentActionLabels, formatAgentDetail, navigatorAttentionSortByState, themeWorkflowProgressStyles, visibleStandaloneAgentAttemptActions } from "./host-view.js";
+export { agentActionLabels, formatAgentDetail, formatAgentError, formatNavigatorColumns, formatWorkflowRuntime, navigatorAttentionSortByState, PLAIN_WORKFLOW_PROGRESS_STYLES, progressStyleForState, runStateGlyph, themeWorkflowProgressStyles, visibleStandaloneAgentAttemptActions } from "./host-view.js";
+export { createInlineConfirm, workflowKeyLabel, workflowKeyMatches } from "./host-navigator.js";
 export type { AgentDetailPresentation, WorkflowProgressStyles } from "./host-view.js";
 export { default } from "./host.js";
 export { acquireSessionLease, hasLiveSessionLease, listPersistedSessionIds, projectSessionsDirectory, projectStorageKey, RunStore, runsDirectory, SessionLease, structuralPath } from "./persistence.js";