pi-extensible-workflows 3.2.0 → 3.4.0

package/dist/src/index.d.ts

@@ -6,11 +6,12 @@ export * from "./registry.js";
 export * from "./execution.js";
 export * from "./host.js";
 export * from "./workflow-artifacts.js";
+export * from "./bundles.js";
 export { default } from "./host.js";
-export { acquireSessionLease, hasLiveSessionLease, projectSessionsDirectory, projectStorageKey, RunStore, runsDirectory, SessionLease, structuralPath } from "./persistence.js";
-export type { AwaitingCheckpoint, CompletedOperation, NativeSessionReference, PendingWorkflowDecision, PersistedOwnershipNode, PersistedRun, WorktreeReference } from "./persistence.js";
-export { FairAgentScheduler, WorkflowAgentExecutor } from "./agent-execution.js";
-export type { AgentAttempt, AgentBudgetHooks, AgentExecutionOptions, AgentExecutionResult, AgentExecutionRoot, AgentProgress, AgentProviderFailure, AgentProviderRecovery, AgentToolCallProgress, AgentSetup, AgentSetupContext, AgentSetupHook, NativeSession, RegisteredAgentSetupHook, SessionFactory, SessionInput } from "./agent-execution.js";
+export { acquireSessionLease, hasLiveSessionLease, listPersistedSessionIds, projectSessionsDirectory, projectStorageKey, RunStore, runsDirectory, SessionLease, structuralPath } from "./persistence.js";
+export type { AwaitingCheckpoint, CompletedOperation, PendingWorkflowDecision, PersistedOwnershipNode, PersistedRun, RunSummary, RunSummaryAgent, RunSummaryArtifacts, WorktreeReference } from "./persistence.js";
+export { FairAgentScheduler, WorkflowAgentExecutor, createLocalWorkflowAgentSession, localAgentTransport } from "./agent-execution.js";
+export type { AgentAttempt, AgentBudgetHooks, AgentExecutionOptions, AgentExecutionResult, AgentExecutionRoot, AgentProgress, AgentProviderFailure, AgentProviderRecovery, AgentToolCallProgress, AgentSetup, AgentSetupContext, AgentSetupHook, AgentTransport, AgentTransportContext, PreparedAgentSession, RegisteredAgentSetupHook, SessionInput, WorkflowAgentMessage, WorkflowAgentSession, WorkflowAgentSessionEvent, WorkflowAgentSessionReference, WorkflowAgentSessionState, WorkflowAgentSessionStats, WorkflowAgentTurnResult } from "./agent-execution.js";
 export { doctor, doctorExitCode, formatDoctorReport } from "./doctor.js";
 export type { DoctorDiagnostic, DoctorFunction, DoctorOptions, DoctorPiState, DoctorReport, DoctorRole, DoctorSeverity, DoctorTrust } from "./doctor.js";
 export { doctorCleanup, doctorCleanupExitCode, formatDoctorCleanupReport } from "./doctor-cleanup.js";

package/dist/src/index.js

@@ -6,8 +6,9 @@ export * from "./registry.js";
 export * from "./execution.js";
 export * from "./host.js";
 export * from "./workflow-artifacts.js";
+export * from "./bundles.js";
 export { default } from "./host.js";
-export { acquireSessionLease, hasLiveSessionLease, projectSessionsDirectory, projectStorageKey, RunStore, runsDirectory, SessionLease, structuralPath } from "./persistence.js";
-export { FairAgentScheduler, WorkflowAgentExecutor } from "./agent-execution.js";
+export { acquireSessionLease, hasLiveSessionLease, listPersistedSessionIds, projectSessionsDirectory, projectStorageKey, RunStore, runsDirectory, SessionLease, structuralPath } from "./persistence.js";
+export { FairAgentScheduler, WorkflowAgentExecutor, createLocalWorkflowAgentSession, localAgentTransport } from "./agent-execution.js";
 export { doctor, doctorExitCode, formatDoctorReport } from "./doctor.js";
 export { doctorCleanup, doctorCleanupExitCode, formatDoctorCleanupReport } from "./doctor-cleanup.js";

package/dist/src/persistence.d.ts

@@ -1,9 +1,5 @@
-import type { BudgetApprovalRequest, JsonValue, LaunchSnapshot, RunRecord, WorkflowRunEvent } from "./types.js";
+import type { BudgetApprovalRequest, JsonValue, LaunchSnapshot, RunRecord, WorkflowBudgetUsage, WorkflowRunEvent } from "./types.js";
 import type { OwnershipRecord } from "./agent-execution.js";
-export interface NativeSessionReference {
-    sessionId: string;
-    sessionFile: string;
-}
 export interface EffectiveSystemPrompt {
     sessionId: string;
     attempt: number;
@@ -11,8 +7,41 @@ export interface EffectiveSystemPrompt {
     sha256: string;
     prompt: string;
 }
-export interface PersistedRun extends RunRecord {
-    nativeSessions: readonly NativeSessionReference[];
+export type PersistedRun = RunRecord;
+type LoadedPersistedRun = PersistedRun;
+export interface RunSummaryAgent {
+    id: string;
+    name: string;
+    label?: string;
+    state: string;
+    role?: string;
+    attempts: number;
+}
+export interface RunSummaryArtifacts {
+    runDirectory: string;
+    statePath: string;
+    journalPath: string;
+    snapshotPath: string;
+    workflowPath: string;
+    resultPath: string;
+    summaryPath: string;
+}
+export interface RunSummary {
+    schemaVersion: 1;
+    runId: string;
+    sessionId: string;
+    workflowName: string;
+    state: RunRecord["state"];
+    createdAt: string;
+    updatedAt: string;
+    terminalAt?: string;
+    usage: WorkflowBudgetUsage;
+    agents: readonly RunSummaryAgent[];
+    error?: RunRecord["error"];
+    failedAt?: string;
+    replayablePaths: readonly string[];
+    incompletePaths: readonly string[];
+    artifacts: RunSummaryArtifacts;
 }
 export interface CompletedOperation {
     path: string;
@@ -41,6 +70,7 @@ export interface BorrowedWorktreeBinding {
 export declare function projectStorageKey(cwd: string): string;
 export declare function projectSessionsDirectory(cwd: string, home?: string): string;
 export declare function runsDirectory(cwd: string, sessionId: string, home?: string): string;
+export declare function listPersistedSessionIds(cwd: string, home?: string): Promise<string[]>;
 export declare function hasLiveSessionLease(cwd: string, sessionId: string, home?: string): Promise<boolean>;
 export declare class SessionLease {
     #private;
@@ -63,6 +93,7 @@ export declare class RunStore {
     readonly directory: string;
     private journalWrite;
     private stateWrite;
+    private summaryWrite;
     private worktreeWrite;
     private borrowedWorktreeWrite;
     private snapshotWrite;
@@ -70,11 +101,14 @@ export declare class RunStore {
     private systemPromptWrite;
     constructor(cwd: string, sessionId: string, runId: string, home?: string);
     create(run: PersistedRun, snapshot: Readonly<LaunchSnapshot>): Promise<void>;
+    private refreshSummary;
+    private refreshSummaryBestEffort;
     isComplete(): Promise<boolean>;
     load(): Promise<{
-        run: PersistedRun;
+        run: LoadedPersistedRun;
         snapshot: Readonly<LaunchSnapshot>;
     }>;
+    loadSummary(): Promise<RunSummary>;
     saveState(run: PersistedRun): Promise<void>;
     updateState(update: (run: PersistedRun) => PersistedRun | Promise<PersistedRun>): Promise<PersistedRun>;
     saveSnapshot(snapshot: Readonly<LaunchSnapshot>): Promise<void>;
@@ -131,3 +165,4 @@ export declare class RunStore {
     saveResult(value: JsonValue): Promise<string>;
     delete(confirmed: boolean): Promise<void>;
 }
+export {};

package/dist/src/persistence.js

@@ -7,6 +7,16 @@ import { homedir } from "node:os";
 import { promisify } from "node:util";
 import { WorkflowError } from "./types.js";
 import { loadLaunchSnapshot } from "./utils.js";
+const TERMINAL_SUMMARY_STATES = new Set(["completed", "failed", "stopped"]);
+const EMPTY_USAGE = { tokens: 0, costUsd: 0, durationMs: 0, agentLaunches: 0 };
+function summaryArtifacts(directory) { return { runDirectory: directory, statePath: join(directory, "state.json"), journalPath: join(directory, "journal.json"), snapshotPath: join(directory, "snapshot.json"), workflowPath: join(directory, "workflow.js"), resultPath: join(directory, "result.json"), summaryPath: join(directory, "summary.json") }; }
+function summaryFromRun(run, directory, journal, previous, fallbackCreatedAt, now = new Date().toISOString()) {
+    const createdAt = typeof previous?.createdAt === "string" ? previous.createdAt : fallbackCreatedAt;
+    const failedAt = run.failedAt ?? run.error?.failedAt;
+    const replayablePaths = [...new Set([...(run.retry?.completedPaths ?? []), ...Object.keys(journal.completed)])];
+    const incompletePaths = [...new Set([...(run.retry?.incompletePaths ?? []), ...(failedAt ? [failedAt] : [])])];
+    return { schemaVersion: 1, runId: run.id, sessionId: run.sessionId, workflowName: run.workflowName, state: run.state, createdAt, updatedAt: now, ...(previous?.terminalAt || TERMINAL_SUMMARY_STATES.has(run.state) ? { terminalAt: previous?.terminalAt ?? now } : {}), usage: { ...EMPTY_USAGE, ...(run.usage ?? {}) }, agents: run.agents.map(({ id, name, label, state, role, attempts }) => ({ id, name, ...(label ? { label } : {}), state, ...(role ? { role } : {}), attempts })), ...(run.error ? { error: run.error } : {}), ...(failedAt ? { failedAt } : {}), replayablePaths, incompletePaths, artifacts: summaryArtifacts(directory) };
+}
 const execute = promisify(execFile);
 const gitIdentity = {
     GIT_AUTHOR_NAME: "pi-extensible-workflows", GIT_AUTHOR_EMAIL: "pi-extensible-workflows@localhost", GIT_COMMITTER_NAME: "pi-extensible-workflows", GIT_COMMITTER_EMAIL: "pi-extensible-workflows@localhost",
@@ -24,6 +34,17 @@ export function projectSessionsDirectory(cwd, home = homedir()) {
 export function runsDirectory(cwd, sessionId, home = homedir()) {
     return join(projectSessionsDirectory(cwd, home), safePart(sessionId), "runs");
 }
+export async function listPersistedSessionIds(cwd, home = homedir()) {
+    try {
+        const entries = await readdir(projectSessionsDirectory(cwd, home), { withFileTypes: true });
+        return entries.filter((entry) => entry.isDirectory() && !entry.name.startsWith(".")).map(({ name }) => name);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+}
 const SESSION_OWNER_FILE = "owner.json";
 const SESSION_OWNER_WRITE_GRACE_MS = 30_000;
 const RUN_CREATE_TEMP = /^\.([a-zA-Z0-9._-]+)\.(\d+)\.[0-9a-f-]+\.tmp$/;
@@ -236,6 +257,7 @@ export class RunStore {
     journalWrite = Promise.resolve();
     // ponytail: serializes one RunStore instance; cross-process run sharing remains unsupported.
     stateWrite = Promise.resolve();
+    summaryWrite = Promise.resolve();
     worktreeWrite = Promise.resolve();
     borrowedWorktreeWrite = Promise.resolve();
     snapshotWrite = Promise.resolve();
@@ -265,6 +287,7 @@ export class RunStore {
             await atomicJson(join(temporary, "borrowed-worktrees.json"), []);
             await atomicJson(join(temporary, "state.json"), run);
             await atomicJson(join(temporary, "system-prompts.json"), { version: 1, entries: [] });
+            await atomicJson(join(temporary, "summary.json"), summaryFromRun(run, this.directory, { completed: {} }, undefined, new Date().toISOString()));
             await rename(temporary, this.directory);
         }
         catch (error) {
@@ -272,6 +295,18 @@ export class RunStore {
             throw error;
         }
     }
+    async refreshSummary() {
+        const write = this.summaryWrite.then(async () => {
+            const run = await json(join(this.directory, "state.json"));
+            const journal = await json(join(this.directory, "journal.json"));
+            const previous = await json(join(this.directory, "summary.json")).catch(() => undefined);
+            const fallbackCreatedAt = await stat(join(this.directory, "state.json")).then((value) => new Date(value.mtimeMs).toISOString());
+            await atomicJson(join(this.directory, "summary.json"), summaryFromRun(run, this.directory, journal, previous, fallbackCreatedAt));
+        });
+        this.summaryWrite = write.catch(() => undefined);
+        await write;
+    }
+    refreshSummaryBestEffort() { void this.refreshSummary().catch(() => undefined); }
     async isComplete() {
         try {
             await Promise.all([access(join(this.directory, "snapshot.json")), access(join(this.directory, "journal.json")), access(join(this.directory, "ownership.json")), access(join(this.directory, "state.json"))]);
@@ -286,13 +321,30 @@ export class RunStore {
         const run = await json(join(this.directory, "state.json"));
         if (resolve(run.cwd) !== this.cwd || run.sessionId !== this.sessionId || run.id !== this.runId)
             throw new WorkflowError("RESUME_INCOMPATIBLE", "Persisted run belongs to another cwd or Pi session");
+        const persisted = run;
+        if (!Array.isArray(persisted.agentSessions) || Object.hasOwn(persisted, "nativeSessions"))
+            throw new WorkflowError("RESUME_INCOMPATIBLE", "Persisted run uses an unsupported agent session format");
         return { run, snapshot: loadLaunchSnapshot(await json(join(this.directory, "snapshot.json"))) };
     }
+    async loadSummary() {
+        await this.stateWrite;
+        await this.journalWrite;
+        await this.summaryWrite;
+        const run = await json(join(this.directory, "state.json"));
+        const journal = await json(join(this.directory, "journal.json"));
+        const previous = await json(join(this.directory, "summary.json")).catch(() => undefined);
+        const [stateStat, journalStat] = await Promise.all([stat(join(this.directory, "state.json")), stat(join(this.directory, "journal.json"))]);
+        const fallbackCreatedAt = new Date(stateStat.mtimeMs).toISOString();
+        const previousUpdatedAt = previous?.updatedAt === undefined ? Number.NaN : Date.parse(previous.updatedAt);
+        const updatedAt = new Date(Math.max(stateStat.mtimeMs, journalStat.mtimeMs, Number.isNaN(previousUpdatedAt) ? 0 : previousUpdatedAt)).toISOString();
+        return summaryFromRun(run, this.directory, journal, previous, fallbackCreatedAt, updatedAt);
+    }
     async saveState(run) {
         const write = this.stateWrite.then(async () => {
             if (resolve(run.cwd) !== this.cwd || run.sessionId !== this.sessionId || run.id !== this.runId)
                 throw new WorkflowError("INTERNAL_ERROR", "Run identity does not match its session-scoped store");
             await atomicJson(join(this.directory, "state.json"), run);
+            this.refreshSummaryBestEffort();
         });
         this.stateWrite = write.catch(() => undefined);
         await write;
@@ -307,6 +359,7 @@ export class RunStore {
             if (resolve(result.cwd) !== this.cwd || result.sessionId !== this.sessionId || result.id !== this.runId)
                 throw new WorkflowError("INTERNAL_ERROR", "Run identity does not match its session-scoped store");
             await atomicJson(join(this.directory, "state.json"), result);
+            this.refreshSummaryBestEffort();
         });
         this.stateWrite = write.catch(() => undefined);
         await write;
@@ -351,6 +404,7 @@ export class RunStore {
             journal.awaiting ??= {};
             result = await update(journal);
             await atomicJson(journalPath, journal);
+            this.refreshSummaryBestEffort();
         });
         this.journalWrite = write.catch(() => undefined);
         await write;

package/dist/src/registry.d.ts

@@ -1,4 +1,4 @@
-import type { JsonValue, RegisteredAgentSetupHook, WorkflowCatalog, WorkflowCatalogContext, WorkflowCatalogError, WorkflowCatalogFunction, WorkflowCatalogIndex, WorkflowCatalogModelAlias, WorkflowCatalogVariable, WorkflowExtension, WorkflowFunction, WorkflowFunctionContext, WorkflowJournal, WorkflowModelAlias, WorkflowModelAliasResolverContext, WorkflowRoleDirectoryRegistration, WorkflowVariable } from "./types.js";
+import type { AgentAttemptAction, JsonValue, RegisteredAgentSetupHook, WorkflowCatalog, WorkflowCatalogContext, WorkflowCatalogError, WorkflowCatalogFunction, WorkflowCatalogIndex, WorkflowCatalogModelAlias, WorkflowCatalogVariable, WorkflowExtension, WorkflowFunction, WorkflowFunctionContext, WorkflowJournal, WorkflowModelAlias, WorkflowModelAliasResolverContext, WorkflowRoleDirectoryRegistration, WorkflowVariable } from "./types.js";
 export declare class WorkflowRegistry {
     #private;
     get frozen(): boolean;
@@ -18,6 +18,7 @@ export declare class WorkflowRegistry {
         variable: WorkflowVariable;
     }[];
     agentSetupHooks(): readonly RegisteredAgentSetupHook[];
+    agentAttemptActions(): Readonly<Record<string, AgentAttemptAction>>;
     roleDirectories(): readonly string[];
     roleDirectoryRegistrations(): readonly WorkflowRoleDirectoryRegistration[];
     modelAliases(): readonly {
@@ -29,7 +30,7 @@ export declare class WorkflowRegistry {
     }[];
     resolveModelAliases(context: Readonly<WorkflowModelAliasResolverContext>, shadowed?: ReadonlySet<string>): Promise<Readonly<Record<string, string>>>;
 }
-export type WorkflowRegistryApi = Pick<WorkflowRegistry, "frozen" | "freeze" | "register" | "function" | "functions" | "catalog" | "catalogIndex" | "catalogDetail" | "globals" | "invokeFunction" | "variables" | "modelAliases" | "resolveModelAliases" | "agentSetupHooks" | "roleDirectories" | "roleDirectoryRegistrations">;
+export type WorkflowRegistryApi = Pick<WorkflowRegistry, "frozen" | "freeze" | "register" | "function" | "functions" | "catalog" | "catalogIndex" | "catalogDetail" | "globals" | "invokeFunction" | "variables" | "modelAliases" | "resolveModelAliases" | "agentSetupHooks" | "agentAttemptActions" | "roleDirectories" | "roleDirectoryRegistrations">;
 export declare function resetWorkflowRegistry(): void;
 export declare function beginWorkflowExtensionLoading(): void;
 export declare function loadingRegistry(): WorkflowRegistryApi;

package/dist/src/registry.js

@@ -29,6 +29,7 @@ export class WorkflowRegistry {
     #extensions = new Set();
     #globals = new Map();
     #hooks = new Map();
+    #agentAttemptActions = new Map();
     #roleDirectories = new Map();
     #modelAliases = new Map();
     #frozen = false;
@@ -39,18 +40,19 @@ export class WorkflowRegistry {
             fail("REGISTRY_FROZEN", "Workflow extension registration is closed after session_start");
         if (object(extension) && Object.prototype.hasOwnProperty.call(extension, "workflows"))
             fail("INVALID_METADATA", "Separate registered workflow definitions were removed; register a function with input and output schemas instead");
-        if (!object(extension) || Object.keys(extension).some((key) => !["version", "headline", "description", "functions", "variables", "modelAliases", "agentSetupHooks", "roleDirectories"].includes(key)) || typeof extension.version !== "string" || !SEMVER.test(extension.version) || typeof extension.headline !== "string" || !extension.headline.trim() || typeof extension.description !== "string" || !extension.description.trim())
+        if (!object(extension) || Object.keys(extension).some((key) => !["version", "headline", "description", "functions", "variables", "modelAliases", "agentSetupHooks", "agentAttemptActions", "roleDirectories"].includes(key)) || typeof extension.version !== "string" || !SEMVER.test(extension.version) || typeof extension.headline !== "string" || !extension.headline.trim() || typeof extension.description !== "string" || !extension.description.trim())
             fail("INVALID_METADATA", "Workflow extensions require a semantic version, headline, and description");
         const functions = extension.functions ?? {};
         const variables = extension.variables ?? {};
         const modelAliases = extension.modelAliases ?? {};
         const agentSetupHooks = extension.agentSetupHooks ?? {};
+        const agentAttemptActions = extension.agentAttemptActions ?? {};
         const roleDirectoryValues = extension.roleDirectories === undefined ? [] : extension.roleDirectories;
         if (!Array.isArray(roleDirectoryValues))
             fail("INVALID_METADATA", "Workflow extension roleDirectories must be an array");
         const roleDirectories = [...new Set(Array.from(roleDirectoryValues, (value) => normalizeRoleDirectory(value)))];
-        if (!object(functions) || !object(variables) || !object(modelAliases) || !object(agentSetupHooks) || (Object.keys(functions).length === 0 && Object.keys(variables).length === 0 && Object.keys(modelAliases).length === 0 && Object.keys(agentSetupHooks).length === 0 && roleDirectories.length === 0))
-            fail("INVALID_METADATA", "Workflow extensions require functions, variables, model aliases, agent setup hooks, or role directories");
+        if (!object(functions) || !object(variables) || !object(modelAliases) || !object(agentSetupHooks) || !object(agentAttemptActions) || (Object.keys(functions).length === 0 && Object.keys(variables).length === 0 && Object.keys(modelAliases).length === 0 && Object.keys(agentSetupHooks).length === 0 && Object.keys(agentAttemptActions).length === 0 && roleDirectories.length === 0))
+            fail("INVALID_METADATA", "Workflow extensions require functions, variables, model aliases, agent setup hooks, agent attempt actions, or role directories");
         const names = [...Object.keys(functions), ...Object.keys(variables)];
         if (new Set(names).size !== names.length)
             fail("GLOBAL_COLLISION", "Global name collision inside extension");
@@ -89,7 +91,13 @@ export class WorkflowRegistry {
             if (this.#hooks.has(name))
                 fail("DUPLICATE_NAME", `Agent setup hook already registered: ${name}`);
         }
-        const stored = deepFreeze({ ...extension, functions, variables, modelAliases, agentSetupHooks, ...(roleDirectories.length ? { roleDirectories } : {}) });
+        for (const [name, action] of Object.entries(agentAttemptActions)) {
+            if (!IDENTIFIER.test(name) || !object(action) || Object.keys(action).some((key) => !["label", "visible", "run"].includes(key)) || typeof action.label !== "string" || !action.label.trim() || typeof action.visible !== "function" || typeof action.run !== "function")
+                fail("INVALID_METADATA", `Invalid agent attempt action: ${name}`);
+            if (this.#agentAttemptActions.has(name))
+                fail("DUPLICATE_NAME", `Agent attempt action already registered: ${name}`);
+        }
+        const stored = deepFreeze({ ...extension, functions, variables, modelAliases, agentSetupHooks, agentAttemptActions, ...(roleDirectories.length ? { roleDirectories } : {}) });
         this.#extensions.add(stored);
         for (const directory of roleDirectories)
             if (!this.#roleDirectories.has(directory))
@@ -100,6 +108,8 @@ export class WorkflowRegistry {
             this.#modelAliases.set(name, { name, version: extension.version, headline: extension.headline, extensionDescription: extension.description, resolve: alias.resolve });
         for (const [name, hook] of Object.entries(agentSetupHooks))
             this.#hooks.set(name, { name, priority: hook.priority ?? 10, setup: hook.setup });
+        for (const [name, action] of Object.entries(agentAttemptActions))
+            this.#agentAttemptActions.set(name, action);
     }
     function(name) {
         if (!IDENTIFIER.test(name))
@@ -197,6 +207,7 @@ export class WorkflowRegistry {
     agentSetupHooks() {
         return [...this.#hooks.values()].sort((left, right) => left.priority - right.priority || (left.name < right.name ? -1 : left.name > right.name ? 1 : 0));
     }
+    agentAttemptActions() { return Object.freeze(Object.fromEntries(this.#agentAttemptActions.entries())); }
     roleDirectories() {
         return [...this.#roleDirectories.keys()];
     }
@@ -250,6 +261,7 @@ function createWorkflowRegistryApi(registry) {
         roleDirectories: () => registry.roleDirectories(),
         roleDirectoryRegistrations: () => registry.roleDirectoryRegistrations(),
         agentSetupHooks: () => registry.agentSetupHooks(),
+        agentAttemptActions: () => registry.agentAttemptActions(),
     };
 }
 function workflowRegistryHost() {

package/dist/src/session-inspector.d.ts

@@ -1,6 +1,6 @@
 import { type SessionEntry, type SessionInfo } from "@earendil-works/pi-coding-agent";
 import { type AgentSetupSummary, type ModelSpec, type StaticWorkflowCall } from "./index.js";
-import { type PersistedRun } from "./persistence.js";
+import { type PersistedRun, type RunSummary } from "./persistence.js";
 export interface ModelUsage {
     model: string;
     cost: number;
@@ -62,11 +62,21 @@ export interface InspectorViewState {
     selected: number;
     scroll: number;
 }
+export type InspectMode = "tui" | "json" | "summary";
+export interface PersistedSessionSummary {
+    schemaVersion: 1;
+    cwd: string;
+    sessionId: string;
+    runs: readonly RunSummary[];
+}
 export declare function transcriptLines(entries: readonly SessionEntry[]): string[];
 export declare function transcriptFileLines(path: string): string[];
 export declare function matchSession(query: string, sessions: readonly SessionInfo[]): SessionInfo;
 export declare function loadSessionReport(path: string, home?: string): Promise<SessionReport>;
 export declare function renderInspector(report: SessionReport, state: InspectorViewState, width?: number, height?: number, highlighter?: (script: string) => string[]): string[];
+export declare function loadPersistedSessionSummary(cwd: string, sessionId: string, home?: string, failedOnly?: boolean): Promise<PersistedSessionSummary>;
+export declare function loadPersistedSummaries(cwd: string, sessionId: string | undefined, home?: string, failedOnly?: boolean): Promise<readonly PersistedSessionSummary[]>;
+export declare function formatPersistedRunSummary(summary: RunSummary, sessionId?: string): string;
 export declare function showSessionInspector(report: SessionReport): Promise<void>;
 export declare function resolveSession(query: string, sessionDir?: string | undefined): Promise<SessionInfo>;
-export declare function runSessionInspector(sessionId?: string): Promise<void>;
+export declare function runSessionInspector(sessionId?: string, mode?: InspectMode, cwd?: string, home?: string, write?: (text: string) => void, failedOnly?: boolean): Promise<void>;

package/dist/src/session-inspector.js

@@ -5,7 +5,7 @@ import { createInterface } from "node:readline/promises";
 import { stdin, stdout } from "node:process";
 import { highlightCode, initTheme, SessionManager, truncateToVisualLines } from "@earendil-works/pi-coding-agent";
 import { formatBudgetStatus, inspectWorkflowScript } from "./index.js";
-import { listRunIds, RunStore } from "./persistence.js";
+import { listPersistedSessionIds, listRunIds, RunStore } from "./persistence.js";
 function text(content) {
     if (typeof content === "string")
         return content;
@@ -115,6 +115,13 @@ function readTranscript(path) {
         return undefined;
     }
 }
+function attemptTranscriptPath(attempt) {
+    const session = attempt.session;
+    if (!session || session.transport !== "local" || typeof session.locator !== "object" || session.locator === null || Array.isArray(session.locator))
+        return undefined;
+    const path = session.locator.sessionFile;
+    return typeof path === "string" && path ? path : undefined;
+}
 function resultRunId(result) {
     if (!result)
         return undefined;
@@ -161,33 +168,18 @@ async function agentReport(agent) {
     const fallbackThinking = agent.model.thinking;
     const attempts = [];
     for (const attempt of agent.attemptDetails ?? []) {
-        const log = readTranscript(attempt.sessionFile);
+        const setup = attempt.setup;
+        const path = attemptTranscriptPath(attempt);
+        const log = path ? readTranscript(path) : undefined;
         if (log) {
-            const model = log.model ?? fallbackModel;
+            const model = log.model ?? `${setup.model.provider}/${setup.model.model}`;
             const cost = log.cost;
-            attempts.push({
-                attempt: attempt.attempt,
-                prompt: log.prompt ?? "(transcript unavailable)",
-                model,
-                ...(log.thinking !== undefined ? { thinking: log.thinking } : {}),
-                cost,
-                models: log.models.length ? log.models : [{ model, cost }],
-                ...(attempt.error ? { error: `${attempt.error.code}: ${attempt.error.message}` } : {}),
-                ...(attempt.setup ? { setup: attempt.setup } : {}),
-            });
+            attempts.push({ attempt: attempt.attempt, prompt: log.prompt ?? "(transcript unavailable)", model, ...(log.thinking !== undefined ? { thinking: log.thinking } : {}), cost, models: log.models.length ? log.models : [{ model, cost }], ...(attempt.error ? { error: `${attempt.error.code}: ${attempt.error.message}` } : {}), setup });
             continue;
         }
+        const model = `${setup.model.provider}/${setup.model.model}`;
         const cost = attempt.accounting.cost;
-        attempts.push({
-            attempt: attempt.attempt,
-            prompt: "(transcript unavailable)",
-            model: fallbackModel,
-            ...(fallbackThinking !== undefined ? { thinking: fallbackThinking } : {}),
-            cost,
-            models: [{ model: fallbackModel, cost }],
-            ...(attempt.error ? { error: `${attempt.error.code}: ${attempt.error.message}` } : {}),
-            ...(attempt.setup ? { setup: attempt.setup } : {}),
-        });
+        attempts.push({ attempt: attempt.attempt, prompt: "(transcript unavailable)", model, ...(setup.model.thinking !== undefined ? { thinking: setup.model.thinking } : {}), cost, models: [{ model, cost }], ...(attempt.error ? { error: `${attempt.error.code}: ${attempt.error.message}` } : {}), setup });
     }
     if (!attempts.length) {
         const cost = agent.accounting?.cost ?? 0;
@@ -346,6 +338,28 @@ export function renderInspector(report, state, width = 80, height = 24, highligh
     const scroll = Math.max(0, Math.min(state.scroll, Math.max(0, fitted.length - room)));
     return [...header, ...fitted.slice(scroll, scroll + room), ...footer].slice(0, height);
 }
+export async function loadPersistedSessionSummary(cwd, sessionId, home = homedir(), failedOnly = false) {
+    const runs = [];
+    for (const runId of (await listRunIds(cwd, sessionId, home)).sort()) {
+        try {
+            const summary = await new RunStore(cwd, sessionId, runId, home).loadSummary();
+            if (!failedOnly || summary.state === "failed")
+                runs.push(summary);
+        }
+        catch { /* Ignore corrupt or concurrently removed runs. */ }
+    }
+    return { schemaVersion: 1, cwd, sessionId, runs };
+}
+export async function loadPersistedSummaries(cwd, sessionId, home = homedir(), failedOnly = false) {
+    const sessionIds = sessionId ? [sessionId] : (await listPersistedSessionIds(cwd, home)).sort();
+    const sessions = await Promise.all(sessionIds.map((id) => loadPersistedSessionSummary(cwd, id, home, failedOnly)));
+    return sessionId || !failedOnly ? sessions : sessions.filter((session) => session.runs.length > 0);
+}
+export function formatPersistedRunSummary(summary, sessionId = summary.sessionId) {
+    const counts = summary.agents.reduce((result, agent) => { result[agent.state] = (result[agent.state] ?? 0) + 1; return result; }, {});
+    const status = Object.entries(counts).map(([state, count]) => `${state}=${String(count)}`).join(", ") || "agents=0";
+    return `${sessionId} ${summary.runId} ${summary.workflowName} ${summary.state} ${status} updated=${summary.updatedAt}`;
+}
 function nextState(current, key, workflowCount) {
     if (current.view === "list") {
         if (key === "up")
@@ -410,7 +424,19 @@ async function askSessionId() {
 export async function resolveSession(query, sessionDir = process.env.PI_CODING_AGENT_SESSION_DIR) {
     return matchSession(query, await SessionManager.listAll(sessionDir));
 }
-export async function runSessionInspector(sessionId) {
+export async function runSessionInspector(sessionId, mode = "tui", cwd = process.cwd(), home = homedir(), write = (text) => { stdout.write(text); }, failedOnly = false) {
+    if (mode !== "tui") {
+        const sessions = await loadPersistedSummaries(cwd, sessionId?.trim() || undefined, home, failedOnly);
+        if (mode === "json") {
+            const value = sessionId?.trim() ? sessions[0] : undefined;
+            write(`${JSON.stringify(value ?? { schemaVersion: 1, cwd, sessions })}\n`);
+            return;
+        }
+        const emptyLabel = failedOnly ? "no failed runs" : "no persisted runs";
+        const lines = sessions.flatMap((session) => session.runs.length ? session.runs.map((run) => formatPersistedRunSummary(run, session.sessionId)) : [`${session.sessionId} (${emptyLabel})`]);
+        write(`${lines.length ? lines.join("\n") : failedOnly ? "No failed workflow runs." : "No persisted workflow runs."}\n`);
+        return;
+    }
     const query = sessionId?.trim() || await askSessionId();
     if (!query)
         throw new Error("Session ID is required.");