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

package/dist/subagents/src/view.d.ts

@@ -1,4 +1,4 @@
-import type { AgentToolResult, ExtensionContext, Theme } from "@earendil-works/pi-coding-agent";
+import type { AgentToolResult, ExtensionAPI, ExtensionContext, Theme } from "@earendil-works/pi-coding-agent";
 import type { SubagentRunRequest, SubagentStatus } from "./contracts.js";
 type SubagentRenderArgs = Partial<SubagentRunRequest> & {
     id?: string;
@@ -37,13 +37,35 @@ export declare function renderSubagentResult(result: AgentToolResult<unknown>, o
     render(width: number): string[];
     invalidate(): void;
 };
-export declare function createSubagentBackgroundWidget(): {
+type SubagentReceipt = {
+    readonly id: string;
+    readonly label: string;
+    readonly state: string;
+    readonly model?: string;
+    readonly role?: string;
+    readonly tools?: readonly string[];
+    readonly input: number;
+    readonly output: number;
+    readonly cacheRead: number;
+    readonly costUsd: number;
+    readonly durationMs: number;
+    readonly attempts: number;
+    readonly error?: string;
+};
+/** The transcript line a finished background run leaves behind, in the shape of the workflow receipt. */
+export declare function renderSubagentReceipt(data: SubagentReceipt, expanded: boolean, theme: Theme): string[];
+type ReceiptHost = {
+    appendEntry?: (customType: string, data: SubagentReceipt) => void;
+    registerEntryRenderer?: ExtensionAPI["registerEntryRenderer"];
+};
+export declare function createSubagentBackgroundWidget(host?: ReceiptHost): {
     start(next: ExtensionContext): void;
     update(status: Readonly<SubagentStatus>, request: Readonly<SubagentRunRequest>): void;
     dispose(): void;
 };
 export declare function renderSubagentInspectCall(args: {
     id?: string;
+    scope?: string;
 }, theme: Theme): {
     render(width: number): string[];
     invalidate(): void;

package/dist/subagents/src/view.js

@@ -1,16 +1,12 @@
 import { truncateToWidth } from "@earendil-works/pi-tui";
-import { formatCost, formatStalledDuration, sanitizeDisplayText, WORKFLOW_AGENT_STALL_THRESHOLD_MS } from "../../src/index.js";
+import { formatCost, formatStalledDuration, formatWorkflowRuntime, sanitizeDisplayText, WORKFLOW_AGENT_STALL_THRESHOLD_MS } from "../../src/index.js";
+import { agentActivityLabel, stalledDuration, textBlock } from "../../src/host-view.js";
+import { drawFrame, formatElapsed, formatTokens, mark, QUIET_MS, REPAINT_MS } from "../../src/background-widget.js";
 const SPINNER = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 const TERMINAL_STATES = new Set(["completed", "failed", "stopped"]);
 const MAX_INSPECT_VALUE_CHARS = 4000;
 const MAX_INSPECT_TOOL_CALLS = 32;
 const MAX_BACKGROUND_WIDGET_ROWS = 10;
-function textBlock(text) {
-    return {
-        render(width) { return text.split("\n").map((line) => truncateToWidth(line, Math.max(1, width), "…")); },
-        invalidate() { },
-    };
-}
 function roleName(value) {
     if (typeof value === "string")
         return value.trim() || undefined;
@@ -59,20 +55,6 @@ function statusValue(value) {
         return undefined;
     return value;
 }
-function runtime(startedAt, finishedAt, now) {
-    if (startedAt === undefined)
-        return "";
-    const seconds = Math.max(0, Math.floor(((finishedAt ?? now) - startedAt) / 1000));
-    if (seconds < 60)
-        return `${String(seconds)}s`;
-    const minutes = Math.floor(seconds / 60);
-    const remainingSeconds = seconds % 60;
-    if (minutes < 60)
-        return `${String(minutes)}m${remainingSeconds ? ` ${String(remainingSeconds)}s` : ""}`;
-    const hours = Math.floor(minutes / 60);
-    const remainingMinutes = minutes % 60;
-    return `${String(hours)}h${remainingMinutes ? ` ${String(remainingMinutes)}m` : ""}`;
-}
 function stateGlyph(state, spinner) {
     if (state === "running")
         return spinner;
@@ -83,32 +65,14 @@ function stateColor(state) {
         return "accent";
     return state === "completed" ? "success" : "error";
 }
-function activity(status) {
-    if (status.state !== "running")
-        return undefined;
-    const current = status.progress?.activity;
-    if (current?.kind === "reasoning" || current?.kind === "text") {
-        const name = current.kind === "reasoning" ? "reasoning" : "responding";
-        const text = sanitizeDisplayText(current.text);
-        return text && text !== name ? `${name} · ${text}` : name;
-    }
-    if (current?.kind === "tool")
-        return sanitizeDisplayText(current.text);
-    return sanitizeDisplayText([...(status.progress?.toolCalls ?? [])].reverse().find(({ state }) => state === "running")?.name ?? "");
-}
-function stalledDuration(status, now) {
-    const lastEventAt = status.progress?.lastEventAt;
-    if (status.state !== "running" || lastEventAt === undefined || !Number.isFinite(lastEventAt))
-        return undefined;
-    const duration = now - lastEventAt;
-    return duration >= WORKFLOW_AGENT_STALL_THRESHOLD_MS ? duration : undefined;
-}
-function accounting(status) {
+/** Tokens and cost as the workflow header shows them. */
+function usageStats(status) {
     const value = status.progress?.accounting;
-    if (!value)
-        return undefined;
-    const total = value.input + value.output + value.cacheRead + value.cacheWrite;
-    return `tokens=${String(total)} cost=${formatCost(value.cost) || "$0.00"}`;
+    return value ? [formatTokens(value.input + value.output), formatCost(value.cost)].filter(Boolean).join(" · ") : "";
+}
+function modelName(status) {
+    const model = status.progress?.state?.model ?? status.attemptDetails?.at(-1)?.setup.model;
+    return model ? `${model.model}${model.thinking ? `:${model.thinking}` : ""}` : "";
 }
 function timestamp(value) {
     if (value === undefined || !Number.isFinite(value) || value < 0)
@@ -129,15 +93,16 @@ function boundedValue(value) {
 }
 function formatSubagentProgress(status, args, theme, spinner, now, expanded) {
     const color = stateColor(status.state);
-    const elapsed = runtime(status.startedAt, status.finishedAt, now);
+    const elapsed = status.startedAt === undefined ? "" : formatWorkflowRuntime((status.finishedAt ?? now) - status.startedAt);
     const metadata = requestMetadata(args, args.id === undefined);
+    const stats = usageStats(status);
     const lines = [
-        `${theme.fg(color, stateGlyph(status.state, spinner))} ${theme.bold(theme.fg("accent", `Subagent: ${label({ ...args, id: status.id })}`))} ${theme.fg(color, `[${status.state}]`)}${metadata ? ` ${theme.fg("dim", metadata)}` : ""}${elapsed ? ` runtime=${elapsed}` : ""}`,
+        `${theme.fg(color, stateGlyph(status.state, "●"))} ${theme.bold(theme.fg("accent", `Subagent: ${label({ ...args, id: status.id })}`))} ${theme.fg(color, `[${status.state}]`)}${metadata ? ` ${theme.fg("dim", metadata)}` : ""}${stats ? ` ${stats}` : ""}${elapsed ? ` runtime=${elapsed}` : ""}`,
     ];
-    const current = activity(status);
-    const stalled = stalledDuration(status, now);
-    if (current)
-        lines.push(`  ${theme.fg("accent", spinner)} ${theme.fg("dim", current)}${stalled === undefined ? "" : ` ${theme.fg("warning", `- stalled? ${formatStalledDuration(stalled)}`)}`}`);
+    const current = status.state === "running" ? agentActivityLabel(status.progress ?? {}) : undefined;
+    const stalled = stalledDuration({ ...status.progress, state: status.state }, now);
+    if (current || status.state === "running")
+        lines.push(`  ${theme.fg("accent", spinner)}${current ? ` ${theme.fg("dim", current)}` : ""}${stalled === undefined ? "" : ` ${theme.fg("warning", `- stalled? ${formatStalledDuration(stalled)}`)}`}`);
     else if (stalled !== undefined)
         lines.push(`  ${theme.fg("warning", `stalled? ${formatStalledDuration(stalled)}`)}`);
     if (status.error)
@@ -147,9 +112,6 @@ function formatSubagentProgress(status, args, theme, spinner, now, expanded) {
         const model = status.progress?.state?.model;
         if (model)
             lines.push(`  ${theme.fg("dim", `model=${model.provider}/${model.model}${model.thinking ? `:${model.thinking}` : ""}`)}`);
-        const usage = accounting(status);
-        if (usage)
-            lines.push(`  ${theme.fg("dim", usage)}`);
         if (status.worktree)
             lines.push(`  ${theme.fg("dim", `worktree=${status.worktree.path} branch=${status.worktree.branch}`)}`);
     }
@@ -221,7 +183,7 @@ export function subagentProgressBlock(status, args, theme, freezeAt) {
             const now = TERMINAL_STATES.has(current.state) ? frozenAt : Date.now();
             if (!TERMINAL_STATES.has(current.state))
                 frozenAt = now;
-            const frame = SPINNER[Math.floor(now / 80) % SPINNER.length] ?? "◇";
+            const frame = SPINNER[Math.floor(now / REPAINT_MS) % SPINNER.length] ?? "◇";
             return formatSubagentProgress(current, args, currentTheme, frame, now, expanded).split("\n").map((line) => truncateToWidth(line, Math.max(1, width), "…"));
         },
         invalidate() { },
@@ -237,7 +199,7 @@ export function renderSubagentResult(result, options, theme, context) {
         state.subagentStatus = state.subagentStatus?.id === incoming.id ? { ...state.subagentStatus, ...incoming } : incoming;
     const status = state.subagentStatus;
     if (status?.state === "running" && options.isPartial && !state.subagentSpinner) {
-        state.subagentSpinner = setInterval(() => { context.invalidate(); }, 80);
+        state.subagentSpinner = setInterval(() => { context.invalidate(); }, REPAINT_MS);
         state.subagentSpinner.unref();
     }
     else if ((!options.isPartial || status?.state !== "running") && state.subagentSpinner) {
@@ -263,9 +225,75 @@ export function renderSubagentResult(result, options, theme, context) {
     component.setExpanded(options.expanded);
     return component;
 }
-export function createSubagentBackgroundWidget() {
+/** One run as a workflow agent row: a quiet or stalled warning on the left, model and figures against the right rule. */
+function widgetRow({ status, request }, now, paint) {
+    const lastEventAt = status.progress?.lastEventAt;
+    const silent = lastEventAt === undefined || !Number.isFinite(lastEventAt) || now - lastEventAt < QUIET_MS ? undefined : now - lastEventAt;
+    const role = silent !== undefined && silent >= WORKFLOW_AGENT_STALL_THRESHOLD_MS ? "error" : "warning";
+    const icon = silent === undefined ? mark(status.state, now, paint) : paint(role, "⚠");
+    const warning = silent === undefined ? "" : `  ${paint(role, `${role === "error" ? "stalled" : "quiet"} ${formatElapsed(silent)}`)}`;
+    const accounting = status.progress?.accounting;
+    const attempts = status.attempts ?? 1;
+    const right = [
+        modelName(status),
+        formatTokens(accounting === undefined ? undefined : accounting.input + accounting.output),
+        formatCost(accounting?.cost),
+        status.startedAt === undefined ? "" : formatElapsed(now - status.startedAt),
+        attempts > 1 ? `attempt ${String(attempts)}` : "",
+    ].filter(Boolean).join(" · ");
+    return { text: `${icon} ${sanitizeDisplayText(label({ ...request, id: status.id }))}${warning}`, right };
+}
+const RECEIPT_ENTRY_TYPE = "piewf-subagent-receipt";
+function receiptFor(status, request) {
+    const accounting = status.progress?.accounting;
+    const model = modelName(status);
+    const role = roleName(request.role);
+    const tools = status.progress?.state?.tools ?? status.attemptDetails?.at(-1)?.setup.tools;
+    return {
+        id: status.id,
+        label: label({ ...request, id: status.id }),
+        state: status.state,
+        ...(model ? { model } : {}),
+        ...(role === undefined ? {} : { role }),
+        ...(tools === undefined ? {} : { tools: [...tools] }),
+        input: accounting?.input ?? 0,
+        output: accounting?.output ?? 0,
+        cacheRead: accounting?.cacheRead ?? 0,
+        costUsd: accounting?.cost ?? 0,
+        durationMs: status.startedAt === undefined ? 0 : Math.max(0, (status.finishedAt ?? Date.now()) - status.startedAt),
+        attempts: status.attempts ?? 1,
+        ...(status.error === undefined ? {} : { error: `${status.error.code}: ${status.error.message}` }),
+    };
+}
+/** The transcript line a finished background run leaves behind, in the shape of the workflow receipt. */
+export function renderSubagentReceipt(data, expanded, theme) {
+    const glyph = data.state === "completed" ? theme.fg("success", "✓") : data.state === "failed" ? theme.fg("error", "✗") : theme.fg("muted", "·");
+    const headline = [formatTokens(data.input + data.output), formatCost(data.costUsd) || "$0.00", formatElapsed(data.durationMs), data.state].filter(Boolean).join(" · ");
+    const lines = [`${glyph} ${theme.bold(sanitizeDisplayText(data.label))} ${theme.fg("muted", headline)}`];
+    if (!expanded)
+        return lines;
+    const meta = [data.model ?? "", data.role ? `role ${data.role}` : "", data.attempts > 1 ? `${String(data.attempts)} attempts` : "", data.tools?.join(" ") ?? ""].filter(Boolean);
+    if (meta.length > 0)
+        lines.push(theme.fg("muted", `   ${meta.join(" · ")}`));
+    const split = [data.input ? `in ${formatTokens(data.input)}` : "", data.output ? `out ${formatTokens(data.output)}` : "", data.cacheRead ? `cache ${formatTokens(data.cacheRead)}` : ""].filter(Boolean);
+    if (split.length > 0)
+        lines.push(theme.fg("muted", `   ${split.join(" · ")}`));
+    if (data.error !== undefined)
+        lines.push(theme.fg("error", `   ${sanitizeDisplayText(data.error)}`));
+    lines.push(theme.fg("muted", `   run ${data.id}`));
+    return lines;
+}
+export function createSubagentBackgroundWidget(host = {}) {
     const key = "piewf-subagents-background";
     const runs = new Map();
+    const receipted = new Set();
+    host.registerEntryRenderer?.(RECEIPT_ENTRY_TYPE, (entry, options, theme) => {
+        if (!entry.data)
+            return undefined;
+        const lines = renderSubagentReceipt(entry.data, options.expanded, theme);
+        // Pi treats an over-wide line as fatal, and an error message has no bound.
+        return { render: (width) => lines.map((line) => truncateToWidth(line, Math.max(1, width), "…")), invalidate() { } };
+    });
     let context;
     let requestRender;
     let timer;
@@ -298,31 +326,20 @@ export function createSubagentBackgroundWidget() {
                 return {
                     render(width) {
                         const now = Date.now();
-                        const frame = SPINNER[Math.floor(now / 80) % SPINNER.length] ?? "◇";
-                        const title = theme.bold(theme.fg("accent", `Subagents (${String(runs.size)} running)`));
-                        const blocks = [...runs.values()].map(({ status, request }) => formatSubagentProgress(status, request, theme, frame, now, false).split("\n"));
-                        const allRunsFit = blocks.reduce((rows, block) => rows + block.length, 1) <= MAX_BACKGROUND_WIDGET_ROWS;
-                        const runRowBudget = allRunsFit ? MAX_BACKGROUND_WIDGET_ROWS - 1 : MAX_BACKGROUND_WIDGET_ROWS - 2;
-                        const lines = [title];
-                        let runRows = 0;
-                        let displayedRuns = 0;
-                        for (const block of blocks) {
-                            if (runRows + block.length > runRowBudget)
-                                break;
-                            lines.push(...block);
-                            runRows += block.length;
-                            displayedRuns += 1;
-                        }
-                        const hiddenRuns = blocks.length - displayedRuns;
-                        if (hiddenRuns > 0)
-                            lines.push(`… ${String(hiddenRuns)} more`);
-                        return lines.map((line) => truncateToWidth(line, Math.max(1, width), "…"));
+                        const paintRole = (role, text) => theme.fg(role, text);
+                        // One row per run, so the default concurrency of eight fills the frame exactly.
+                        // ponytail: no Alt+O scrolling as in the workflow widget; add it if runs routinely exceed the frame.
+                        const budget = MAX_BACKGROUND_WIDGET_ROWS - 2;
+                        const rows = [...runs.values()].map((run) => widgetRow(run, now, paintRole));
+                        const body = rows.length <= budget ? rows : [...rows.slice(0, budget - 1), { text: theme.fg("muted", `… ${String(rows.length - budget + 1)} more`) }];
+                        const title = runs.size === 1 ? "Subagent" : `Subagents · ${String(runs.size)} runs`;
+                        return drawFrame(title, "", body, width, paintRole, (text) => theme.fg("accent", text)).map((line) => truncateToWidth(line, Math.max(1, width), ""));
                     },
                     invalidate() { },
                 };
             }, { placement: "belowEditor" });
             showing = true;
-            timer = setInterval(() => { requestRender?.(); }, 80);
+            timer = setInterval(() => { requestRender?.(); }, REPAINT_MS);
             timer.unref();
         }
         catch {
@@ -333,13 +350,23 @@ export function createSubagentBackgroundWidget() {
         start(next) {
             hide();
             runs.clear();
+            receipted.clear();
             context = next.mode === "tui" ? next : undefined;
         },
         update(status, request) {
             if (request.mode !== "background" || context === undefined)
                 return;
-            if (TERMINAL_STATES.has(status.state))
+            if (TERMINAL_STATES.has(status.state)) {
                 runs.delete(status.id);
+                // A foreground run already has its tool block; a background one leaves a receipt, once, like a workflow run.
+                if (!receipted.has(status.id)) {
+                    receipted.add(status.id);
+                    try {
+                        host.appendEntry?.(RECEIPT_ENTRY_TYPE, receiptFor(status, request));
+                    }
+                    catch { /* A receipt is display-only. */ }
+                }
+            }
             else
                 runs.set(status.id, { status, request });
             paint();
@@ -353,7 +380,7 @@ export function createSubagentBackgroundWidget() {
 }
 export function renderSubagentInspectCall(args, theme) {
     const title = theme.fg("toolTitle", theme.bold("subagents_inspect"));
-    return textBlock(args.id ? `${title} ${theme.fg("accent", args.id)}` : `${title} ${theme.fg("muted", "all")}`);
+    return textBlock(args.id ? `${title} ${theme.fg("accent", args.id)}` : `${title} ${theme.fg("muted", args.scope === "all" ? "all" : "session")}`);
 }
 export function renderSubagentInspectResult(result, options, theme, args) {
     const status = statusValue(result.details);