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

package/dist/src/background-widget.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Live workflow widget: a tree of the runs happening right now, drawn below the
+ * editor, and a durable receipt in the transcript once each one reaches a
+ * terminal state.
+ *
+ * The split is deliberate. The widget answers "what is happening" and holds
+ * nothing that has reached a final state — resumable interruptions remain visible.
+ * The transcript entry answers "what did that cost and who did it", and keeps the
+ * answer for the life of the session rather than for a minute.
+ *
+ * Run state arrives as workflow events; the numbers behind it (tokens, cost,
+ * per-agent accounting) live only in the run's state.json, so an event is a
+ * signal to re-read rather than the data itself. A slower rescan timer checks for
+ * changed state files without reparsing unchanged runs.
+ */
+import type { ExtensionAPI, Theme } from "@earendil-works/pi-coding-agent";
+export type BackgroundWidgetAPI = Pick<ExtensionAPI, "appendEntry" | "on"> & {
+    events?: {
+        on?: (name: string, handler: (event: unknown) => void) => () => void;
+        emit?: ExtensionAPI["events"]["emit"];
+    };
+    registerEntryRenderer?: ExtensionAPI["registerEntryRenderer"];
+    registerShortcut?: ExtensionAPI["registerShortcut"];
+};
+/**
+ * Overrides the switch above, for the tests that cover navigation.
+ *
+ * The behaviour is finished and tested; only its exposure is withheld. Letting
+ * the tests turn it on keeps that coverage alive rather than letting it rot
+ * while the feature waits.
+ */
+export declare const __navigationForTests: {
+    enabled: boolean;
+};
+interface ReceiptAgent {
+    id?: string;
+    parentId?: string;
+    name: string;
+    state: string;
+    model?: string;
+    role?: string;
+    requestedModel?: string;
+    tools?: readonly string[];
+    /** Accepted for rendering older receipt entries; new receipts persist granted tools. */
+    toolCalls?: number;
+    input: number;
+    output: number;
+    cacheRead: number;
+    costUsd: number;
+    durationMs: number;
+    attempts: number;
+}
+interface Receipt {
+    runId: string;
+    workflow: string;
+    state: string;
+    costUsd: number;
+    tokens: number;
+    durationMs: number;
+    phases: readonly string[];
+    phaseBoundaries: readonly number[];
+    agents: readonly ReceiptAgent[];
+    error?: string;
+}
+export declare function formatTokens(tokens: number | undefined): string;
+export declare function formatCost(cost: number | undefined): string;
+/** The receipt as transcript lines: the widget's tree, one level deeper. */
+export declare function renderReceipt(data: Receipt, expanded: boolean, theme: Theme): string[];
+export interface BackgroundWidgetController {
+    suspend(): void;
+    resume(): void;
+}
+export default function widget(pi: BackgroundWidgetAPI, enabled?: boolean): BackgroundWidgetController;
+export {};