pi-extensible-workflows 2.0.0 → 3.1.0

package/dist/src/index.d.ts

@@ -1,637 +1,16 @@
-import { Type } from "@earendil-works/pi-ai";
-import { copyToClipboard, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { type AgentActivity, type AgentAccounting, type AgentAttempt, type AgentBudgetHooks, type AgentDefinition, type AgentSetupHook, type RegisteredAgentSetupHook, type SessionFactory } from "./agent-execution.js";
-import { RunStore } from "./persistence.js";
-import type { AwaitingCheckpoint, PersistedRun, WorktreeReference } from "./persistence.js";
-export declare const RUN_STATES: readonly ["queued", "running", "pausing", "paused", "awaiting_input", "completed", "failed", "stopped", "interrupted", "budget_exhausted"];
-export declare const AGENT_STATES: readonly ["queued", "running", "waiting_for_child", "paused", "retrying", "completed", "failed", "cancelled"];
-export declare const WORKFLOW_CALL_KINDS: readonly ["agent", "conversation", "parallel", "pipeline", "checkpoint", "phase", "withWorktree", "shell"];
-export type WorkflowCallKind = (typeof WORKFLOW_CALL_KINDS)[number];
-export declare const WORKFLOW_RUN_STARTED_EVENT = "workflow:run-started";
-export declare const WORKFLOW_RUN_RESUMED_EVENT = "workflow:run-resumed";
-export declare const WORKFLOW_RUN_STATE_CHANGED_EVENT = "workflow:run-state-changed";
-export declare const WORKFLOW_RUN_COMPLETED_EVENT = "workflow:run-completed";
-export declare const WORKFLOW_RUN_FAILED_EVENT = "workflow:run-failed";
-export declare const WORKFLOW_AGENT_STATE_CHANGED_EVENT = "workflow:agent-state-changed";
-export declare const WORKFLOW_PHASE_CHANGED_EVENT = "workflow:phase-changed";
-export declare const WORKFLOW_CHECKPOINT_STATE_CHANGED_EVENT = "workflow:checkpoint-state-changed";
-export declare const WORKFLOW_BUDGET_EVENT = "workflow:budget-event";
-export declare const WORKFLOW_WORKTREE_CREATED_EVENT = "workflow:worktree-created";
-export declare const ERROR_CODES: readonly ["CONFIG_ERROR", "INVALID_SETTINGS", "INVALID_SYNTAX", "INVALID_METADATA", "DUPLICATE_NAME", "INVALID_SCHEMA", "UNKNOWN_MODEL", "UNKNOWN_TOOL", "UNKNOWN_AGENT_TYPE", "RUN_OWNED", "REGISTRY_FROZEN", "GLOBAL_COLLISION", "MISSING_WORKFLOW", "RPC_LIMIT_EXCEEDED", "SHELL_FAILED", "AGENT_TIMEOUT", "AGENT_FAILED", "RESULT_INVALID", "CANCELLED", "WORKER_UNRESPONSIVE", "WORKTREE_FAILED", "RESUME_INCOMPATIBLE", "BUDGET_EXHAUSTED", "INTERNAL_ERROR"];
-export type RunState = (typeof RUN_STATES)[number];
-export type AgentState = (typeof AGENT_STATES)[number];
-export type WorkflowErrorCode = (typeof ERROR_CODES)[number];
-export type JsonValue = null | boolean | number | string | JsonValue[] | {
-    [key: string]: JsonValue;
-};
-export type JsonSchema = {
-    [key: string]: JsonValue;
-};
-export interface ShellOptions {
-    timeoutMs?: number;
-    env?: Record<string, string>;
-}
-export interface ShellResult {
-    exitCode: number | null;
-    stdout: string;
-    stderr: string;
-}
-export type BudgetDimension = "tokens" | "costUsd" | "durationMs" | "agentLaunches";
-export interface BudgetLimits {
-    soft?: number;
-    hard?: number;
-}
-export type WorkflowBudget = Partial<Record<BudgetDimension, BudgetLimits>>;
-export type WorkflowBudgetPatch = Partial<Record<BudgetDimension, BudgetLimits | {
-    soft?: number | null;
-    hard?: number | null;
-} | null>>;
-export interface WorkflowBudgetUsage {
-    tokens: number;
-    costUsd: number;
-    durationMs: number;
-    agentLaunches: number;
-}
-export type BudgetEventType = "soft_crossed" | "hard_overrun" | "hard_exhausted" | "adjustment_requested" | "adjustment_approved" | "adjustment_rejected";
-export interface BudgetEvent {
-    type: BudgetEventType;
-    budgetVersion: number;
-    dimensions: readonly BudgetDimension[];
-    usage: WorkflowBudgetUsage;
-    limits: WorkflowBudget;
-    at: number;
-    proposalId?: string;
-    previous?: WorkflowBudget;
-    proposed?: WorkflowBudget;
-}
-export interface BudgetApprovalRequest {
-    kind: "budget";
-    proposalId: string;
-    runId: string;
-    consumed: WorkflowBudgetUsage;
-    previous: WorkflowBudget;
-    proposed: WorkflowBudget;
-    budgetVersion: number;
-}
-export interface WorkflowErrorShape {
-    code: WorkflowErrorCode;
-    message: string;
-}
-export interface WorkflowEventBase {
-    runId: string;
-    sessionId: string;
-    workflowName: string;
-    cwd: string;
-    runDirectory: string;
-    timestamp: number;
-}
-export type WorkflowRunStartedEvent = WorkflowEventBase;
-export type WorkflowRunResumedEvent = WorkflowEventBase;
-export interface WorkflowRunStateChangedEvent extends WorkflowEventBase {
-    previousState: RunState;
-    state: RunState;
-    reason?: string;
-    errorCode?: WorkflowErrorCode;
-}
-export interface WorkflowRunCompletedEvent extends WorkflowEventBase {
-    resultPath: string;
-}
-export interface WorkflowRunFailedEvent extends WorkflowEventBase {
-    error: WorkflowErrorShape;
-}
-export interface WorkflowAgentStateChangedEvent extends WorkflowEventBase {
-    agentId: string;
-    displayLabel: string;
-    role?: string;
-    structuralPath: readonly string[];
-    parentId?: string;
-    parentBreadcrumb?: string;
-    worktreeOwner?: string;
-    previousState?: AgentState;
-    state: AgentState;
-    attempt: number;
-}
-export interface WorkflowPhaseChangedEvent extends WorkflowEventBase {
-    previousPhase?: string;
-    phase: string;
-}
-export type WorkflowCheckpointState = "awaiting" | "approved" | "rejected";
-export interface WorkflowCheckpointStateChangedEvent extends WorkflowEventBase {
-    name: string;
-    state: WorkflowCheckpointState;
-}
-export interface WorkflowBudgetEvent extends WorkflowEventBase {
-    type: BudgetEventType;
-    budgetVersion: number;
-    dimensions: readonly BudgetDimension[];
-    usage: WorkflowBudgetUsage;
-    limits: WorkflowBudget;
-    proposalId?: string;
-    previous?: WorkflowBudget;
-    proposed?: WorkflowBudget;
-}
-export interface ModelSpec {
-    provider: string;
-    model: string;
-    thinking?: "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
-}
-export interface WorkflowMetadata {
-    name: string;
-    description?: string;
-}
-export interface WorkflowSettings {
-    concurrency: number;
-    modelAliases?: Readonly<Record<string, string>>;
-    disabledAgentResources?: Readonly<AgentResourceExclusions>;
-}
-export interface AgentResourceExclusions {
-    skills: readonly string[];
-    extensions: readonly string[];
-}
-export interface AgentResourcePolicy {
-    globalSettingsPath: string;
-    projectSettingsPath: string;
-    projectTrusted: boolean;
-    global: AgentResourceExclusions;
-    project: AgentResourceExclusions;
-    effective: AgentResourceExclusions;
-    unmatchedSkills: string[];
-    unmatchedExtensions: string[];
-}
-export interface AgentSetupSummary {
-    hookNames: readonly string[];
-    model: ModelSpec;
-    tools: readonly string[];
-    cwd: string;
-    disabledAgentResources?: {
-        skills: readonly string[];
-        extensions: readonly string[];
-        unmatchedSkills: readonly string[];
-        unmatchedExtensions: readonly string[];
-    };
-}
-export interface AgentAttemptSummary {
-    attempt: number;
-    sessionId: string;
-    sessionFile: string;
-    error?: {
-        code: string;
-        message: string;
-    };
-    accounting: {
-        input: number;
-        output: number;
-        cacheRead: number;
-        cacheWrite: number;
-        cost: number;
-    };
-    setup?: AgentSetupSummary;
-}
-export interface WorkflowWorktreeCreatedEvent extends WorkflowEventBase {
-    owner: string;
-    branch: string;
-    path: string;
-    base: string;
-}
-export interface WorkflowWorktreeReference {
-    readonly path: string;
-    readonly branch: string;
-}
-export interface AgentRecord {
-    id: string;
-    name: string;
-    label?: string;
-    path: string;
-    state: AgentState;
-    parentId?: string;
-    structuralPath?: readonly string[];
-    parentBreadcrumb?: string;
-    worktreeOwner?: string;
-    role?: string;
-    requestedModel?: string;
-    model: ModelSpec;
-    tools: readonly string[];
-    attempts: number;
-    attemptDetails?: readonly AgentAttemptSummary[];
-    accounting?: {
-        input: number;
-        output: number;
-        cacheRead: number;
-        cacheWrite: number;
-        cost: number;
-    };
-    toolCalls?: readonly {
-        id: string;
-        name: string;
-        state: "running" | "completed" | "failed";
-    }[];
-    activity?: AgentActivity | undefined;
-}
-export interface WorkflowRunEvent {
-    type: string;
-    message: string;
-}
-export interface RunRecord {
-    id: string;
-    workflowName: string;
-    cwd: string;
-    sessionId: string;
-    state: RunState;
-    parentRunId?: string;
-    phase?: string;
-    agents: readonly AgentRecord[];
-    error?: WorkflowErrorShape;
-    budget?: WorkflowBudget;
-    budgetVersion?: number;
-    usage?: WorkflowBudgetUsage;
-    budgetEvents?: readonly BudgetEvent[];
-    events?: readonly WorkflowRunEvent[];
-}
-export declare const LAUNCH_SNAPSHOT_IDENTITY_VERSION = 4;
-export interface LaunchSnapshot {
-    identityVersion?: number;
-    launchKind?: "inline" | "function";
-    functionName?: string;
-    script: string;
-    args: JsonValue;
-    metadata: WorkflowMetadata;
-    settings: WorkflowSettings;
-    budget?: WorkflowBudget;
-    settingsPath?: string;
-    modelAliases?: Readonly<Record<string, string>>;
-    models: readonly string[];
-    tools: readonly string[];
-    agentTypes: readonly string[];
-    roles?: Readonly<Record<string, AgentDefinition>>;
-    projectRoles?: readonly string[];
-    schemas: readonly JsonSchema[];
-}
-export interface PreflightCapabilities {
-    models: ReadonlySet<string>;
-    tools: ReadonlySet<string>;
-    agentTypes: ReadonlySet<string>;
-    modelAliases?: Readonly<Record<string, string>>;
-    knownModels?: ReadonlySet<string>;
-    settingsPath?: string;
-    skipModelAvailability?: boolean;
-}
-export interface PreflightResult {
-    metadata: WorkflowMetadata;
-    referenced: {
-        phases: readonly string[];
-        models: readonly string[];
-        tools: readonly string[];
-        agentTypes: readonly string[];
-    };
-    schemas: readonly JsonSchema[];
-    dynamicAgentRoles: boolean;
-}
-export interface WorkflowOrchestrationContext {
-    agent: (...args: readonly unknown[]) => Promise<JsonValue>;
-    shell: (command: string, options?: ShellOptions) => Promise<ShellResult>;
-    prompt: (template: string, values: Readonly<Record<string, JsonValue>>) => string;
-    parallel: (...args: readonly unknown[]) => Promise<JsonValue>;
-    pipeline: (...args: readonly unknown[]) => Promise<JsonValue>;
-    withWorktree: {
-        (callback: WorkflowWorktreeCallback): Promise<JsonValue>;
-        (name: string, callback: WorkflowWorktreeCallback): Promise<JsonValue>;
-    };
-    checkpoint: (...args: readonly unknown[]) => Promise<boolean>;
-    phase: (name: string) => void;
-    log: (message: string) => void;
-}
-export interface WorkflowRunContext {
-    cwd: string;
-    sessionId: string;
-    runId: string;
-    workflow: Readonly<WorkflowMetadata>;
-    args: JsonValue;
-    signal: AbortSignal;
-}
-export interface WorkflowFunctionContext extends WorkflowOrchestrationContext {
-    run: Readonly<WorkflowRunContext>;
-    invoke: (name: string, input: Readonly<Record<string, JsonValue>>) => Promise<JsonValue>;
-}
-export type WorkflowWorktreeCallback = (reference: Readonly<WorkflowWorktreeReference>) => JsonValue | Promise<JsonValue>;
-export interface WorkflowFunction {
-    description: string;
-    input: JsonSchema;
-    output: JsonSchema;
-    run: (input: Readonly<Record<string, JsonValue>>, context: Readonly<WorkflowFunctionContext>) => Promise<JsonValue> | JsonValue;
-}
-export interface WorkflowVariable {
-    description: string;
-    schema: JsonSchema;
-    resolve: (run: Readonly<WorkflowRunContext>) => Promise<JsonValue> | JsonValue;
-}
-export interface WorkflowExtension {
-    version: string;
-    headline: string;
-    description: string;
-    functions?: Readonly<Record<string, WorkflowFunction>>;
-    variables?: Readonly<Record<string, WorkflowVariable>>;
-    agentSetupHooks?: Readonly<Record<string, AgentSetupHook>>;
-}
-export interface WorkflowJournal {
-    get(path: string): JsonValue | undefined;
-    put(path: string, value: JsonValue): void;
-}
-export declare class WorkflowError extends Error {
-    readonly code: WorkflowErrorCode;
-    constructor(code: WorkflowErrorCode, message: string);
-}
-export interface WorkflowFailureAgent {
-    id: string;
-    label?: string;
-    role?: string;
-    structuralPath: readonly string[];
-    attempt: number;
-    sessionId?: string;
-    sessionFile?: string;
-}
-export interface WorkflowSiblingAgent {
-    id: string;
-    label?: string;
-    role?: string;
-    structuralPath: readonly string[];
-}
-export interface WorkflowFailureDiagnostics {
-    runId: string;
-    workflowName: string;
-    state: RunState;
-    failedAt: string | null;
-    error: WorkflowErrorShape;
-    failedAgent?: WorkflowFailureAgent;
-    completedSiblingAgents?: readonly WorkflowSiblingAgent[];
-    completedSiblingPaths: readonly (readonly string[])[];
-    artifacts: {
-        runDirectory: string;
-        statePath: string;
-        journalPath: string;
-    };
-}
-export declare function formatWorkflowFailure(error: unknown): string;
-export declare class RunLifecycle {
-    #private;
-    private readonly changed?;
-    constructor(state?: RunState, changed?: ((state: RunState, previousState: RunState, reason?: string) => void | Promise<void>) | undefined);
-    get state(): RunState;
-    enter(): Promise<void>;
-    leave(): Promise<void>;
-    enterAwaitingInput(): Promise<void>;
-    resolveAwaitingInput(): Promise<void>;
-    pause(): Promise<void>;
-    resume(): Promise<void>;
-    providerPause(): Promise<void>;
-    terminal(state: "completed" | "failed" | "stopped" | "interrupted" | "budget_exhausted", reason?: string): Promise<void>;
-}
-export declare const DEFAULT_SETTINGS: Readonly<WorkflowSettings>;
-declare function object(value: unknown): value is Record<string, unknown>;
-export { object as isObject };
-export declare function validateBudget(value: unknown): WorkflowBudget | undefined;
-export declare function validateBudgetPatch(value: unknown): WorkflowBudgetPatch;
-export declare class WorkflowBudgetRuntime {
-    #private;
-    readonly budget: WorkflowBudget | undefined;
-    readonly version: number;
-    constructor(budget: WorkflowBudget | undefined, version?: number, usage?: Partial<WorkflowBudgetUsage>, events?: readonly BudgetEvent[], options?: {
-        now?: () => number;
-        onChange?: () => void;
-        active?: boolean;
-    });
-    get usage(): WorkflowBudgetUsage;
-    get events(): readonly BudgetEvent[];
-    get hardExhausted(): boolean;
-    checkAgentLaunch(): void;
-    beforeAttempt(): void;
-    beforeTurn(): void;
-    afterTurn(accounting: AgentAccounting, final: boolean): void;
-    instruction(agentId?: string): string | undefined;
-    forAgent(agentId: string): AgentBudgetHooks;
-    transition(state: RunState): void;
-    recordEvent(event: BudgetEvent): void;
-    snapshot(): {
-        usage: WorkflowBudgetUsage;
-        budgetEvents: readonly BudgetEvent[];
-    };
-}
-export declare function mergeBudget(budget: WorkflowBudget | undefined, patch: WorkflowBudgetPatch): WorkflowBudget | undefined;
-export declare function budgetRelaxed(previous: WorkflowBudget | undefined, next: WorkflowBudget | undefined): boolean;
-export declare function exhaustedBudgetDimensions(budget: WorkflowBudget | undefined, usage: WorkflowBudgetUsage): BudgetDimension[];
-export declare function resumeBudgetAllowed(budget: WorkflowBudget | undefined, usage: WorkflowBudgetUsage): boolean;
-export declare function parseModelReference(value: string): ModelSpec;
-export declare function validateModelAliases(value: unknown, settingsPath?: string): Readonly<Record<string, string>>;
-export declare function resolveModelReference(value: string, aliases?: Readonly<Record<string, string>>, knownModels?: ReadonlySet<string>, settingsPath?: string): ModelSpec;
-export interface CheckpointInput {
-    name: string;
-    prompt: string;
-    context: JsonValue;
-}
-export declare function validateCheckpoint(value: unknown): CheckpointInput;
-export declare function workflowSettingsPath(agentDir?: string): string;
-export declare function workflowProjectSettingsPath(cwd: string): string;
-export declare function mergeAgentResourceExclusions(...values: (AgentResourceExclusions | undefined)[]): AgentResourceExclusions;
-export declare function loadSettings(path?: string): Readonly<WorkflowSettings>;
-export declare function resolveAgentResourcePolicy(cwd: string, projectTrusted: boolean, globalSettingsPath?: string): AgentResourcePolicy;
-export declare function saveModelAliases(path?: string, aliases?: Readonly<Record<string, string>>): void;
-export declare function parseRoleMarkdown(content: string, strict?: boolean, rolePath?: string): AgentDefinition;
-export declare function workflowRoleDirectories(agentDir?: string): readonly string[];
-export declare function loadAgentDefinitions(cwd: string, agentDir?: string, projectTrusted?: boolean): Readonly<Record<string, AgentDefinition>>;
-export type StaticWorkflowExecution = "parallel" | "sequential";
-export interface StaticWorkflowScope {
-    kind: "parallel" | "pipeline";
-    name: string | null;
-    key: string | null;
-}
-export interface StaticWorkflowCall {
-    kind: WorkflowCallKind;
-    start: number;
-    end: number;
-    name: string | null;
-    prompt: string | null;
-    model: string | null;
-    label?: string | null;
-    role: string | null;
-    retries?: number | null;
-    outputSchema?: JsonSchema | null;
-    options?: Readonly<Record<string, JsonValue>> | null;
-    optionKeys?: readonly string[];
-    execution?: StaticWorkflowExecution;
-    structure?: readonly StaticWorkflowScope[];
-}
-export declare function inspectWorkflowScript(script: string): StaticWorkflowCall[];
-export interface WorkflowCatalogFunction {
-    name: string;
-    version: string;
-    headline: string;
-    extensionDescription: string;
-    description: string;
-    input: JsonSchema;
-    output: JsonSchema;
-}
-export interface WorkflowCatalogVariable {
-    name: string;
-    version: string;
-    headline: string;
-    extensionDescription: string;
-    description: string;
-    schema: JsonSchema;
-}
-export interface WorkflowCatalog {
-    functions: readonly WorkflowCatalogFunction[];
-    variables: readonly WorkflowCatalogVariable[];
-    modelAliases?: Readonly<Record<string, string>>;
-}
-export interface WorkflowCatalogIndexFunction {
-    name: string;
-    description: string;
-    input: JsonSchema;
-}
-export interface WorkflowCatalogIndexVariable {
-    name: string;
-    description: string;
-    schema: JsonSchema;
-}
-export interface WorkflowCatalogIndex {
-    functions: readonly WorkflowCatalogIndexFunction[];
-    variables: readonly WorkflowCatalogIndexVariable[];
-    modelAliases?: Readonly<Record<string, string>>;
-}
-export interface WorkflowCatalogError {
-    error: {
-        code: "NOT_FOUND";
-        name: string;
-        message: string;
-    };
-}
-export declare class WorkflowRegistry {
-    #private;
-    get frozen(): boolean;
-    freeze(): void;
-    register(extension: WorkflowExtension): void;
-    function(name: string): WorkflowFunction;
-    functions(): Readonly<Record<string, WorkflowFunction>>;
-    catalog(): WorkflowCatalog;
-    catalogIndex(): WorkflowCatalogIndex;
-    catalogDetail(name: string): WorkflowCatalogFunction | WorkflowCatalogVariable | WorkflowCatalogError;
-    globals(): Readonly<Record<string, {
-        name: string;
-    }>>;
-    invokeFunction(name: string, input: unknown, context: Readonly<WorkflowFunctionContext>, path: string, journal: WorkflowJournal): Promise<JsonValue>;
-    variables(): readonly {
-        name: string;
-        variable: WorkflowVariable;
-    }[];
-    agentSetupHooks(): readonly RegisteredAgentSetupHook[];
-}
-export declare function registerWorkflowExtension(extension: WorkflowExtension): void;
-export declare function workflowCatalog(): WorkflowCatalog;
-export declare function workflowCatalogIndex(): WorkflowCatalogIndex;
-export declare function workflowCatalogDetail(name: string): WorkflowCatalogFunction | WorkflowCatalogVariable | WorkflowCatalogError;
-export declare function registeredWorkflowFunctions(): Readonly<Record<string, WorkflowFunction>>;
-export declare function formatWorkflowPreview(args: {
-    script?: unknown;
-    workflow?: unknown;
-    name?: unknown;
-    description?: unknown;
-}): string;
-export declare const WORKFLOW_TOOL_LABEL = "Workflow";
-export declare const WORKFLOW_TOOL_DESCRIPTION = "Run a deterministic JavaScript workflow";
-export declare const WORKFLOW_TOOL_PROMPT_SNIPPET = "Run a deterministic, resumable JavaScript workflow that orchestrates subagents. Inline scripts require a name; registered functions use their function name. Runs in the background by default; completion arrives as a follow-up message. Foreground results include the completed run ID, and parentRunId reuses matching named worktrees from a terminal run.";
-export declare const WORKFLOW_TOOL_PARAMETERS: Type.TObject<{
-    name: Type.TOptional<Type.TString>;
-    description: Type.TOptional<Type.TString>;
-    script: Type.TOptional<Type.TString>;
-    workflow: Type.TOptional<Type.TString>;
-    args: Type.TOptional<Type.TUnknown>;
-    foreground: Type.TOptional<Type.TBoolean>;
-    concurrency: Type.TOptional<Type.TInteger>;
-    budget: Type.TOptional<Type.TUnknown>;
-    parentRunId: Type.TOptional<Type.TString>;
-}>;
-export declare function preflight(script: string, capabilities: PreflightCapabilities, schemas?: readonly unknown[], metadata?: WorkflowMetadata): PreflightResult;
-export interface WorkflowValidationParameters {
-    name?: string;
-    description?: string;
-    script?: string;
-    workflow?: string;
-    args?: unknown;
-}
-export interface WorkflowValidationContext {
-    cwd: string;
-    projectTrusted: boolean;
-    availableModels: ReadonlySet<string>;
-    rootTools: ReadonlySet<string>;
-    modelAliases?: Readonly<Record<string, string>>;
-    knownModels?: ReadonlySet<string>;
-    settingsPath?: string;
-    agentDir?: string;
-}
-export interface ValidatedWorkflowLaunch {
-    script: string;
-    checked: PreflightResult;
-    agentDefinitions: Readonly<Record<string, AgentDefinition>>;
-    projectAgentDefinitions: Readonly<Record<string, AgentDefinition>>;
-    roleNames: readonly string[];
-    functionName?: string;
-}
-export declare function validateWorkflowLaunch(params: WorkflowValidationParameters, context: WorkflowValidationContext): ValidatedWorkflowLaunch;
-type LaunchSnapshotInput = Omit<LaunchSnapshot, "identityVersion"> & {
-    identityVersion?: number;
-};
-export declare function createLaunchSnapshot(input: LaunchSnapshotInput): Readonly<LaunchSnapshot>;
-export declare function loadLaunchSnapshot(input: LaunchSnapshot): Readonly<LaunchSnapshot>;
-export declare const RPC_LIMIT_BYTES: number;
-export declare const HEARTBEAT_TIMEOUT_MS = 5000;
-export interface AgentIdentity {
-    structuralPath: readonly string[];
-    callSite: string;
-    occurrence: number;
-    parentBreadcrumb?: string;
-    worktreeOwner?: string;
-    conversation?: {
-        name: string;
-        turn: number;
-    };
-}
-export interface ShellIdentity {
-    structuralPath: readonly string[];
-    callSite: string;
-    occurrence: number;
-    worktreeOwner?: string;
-}
-export interface WorkflowBridge {
-    agent?: (prompt: string, options: Readonly<Record<string, JsonValue>>, signal: AbortSignal, identity: AgentIdentity) => Promise<JsonValue>;
-    shell?: (command: string, options: ShellOptions, signal: AbortSignal, identity: ShellIdentity) => Promise<ShellResult>;
-    checkpoint?: (input: Readonly<Record<string, JsonValue>>, signal: AbortSignal) => boolean | Promise<boolean>;
-    function?: (name: string, input: Readonly<Record<string, JsonValue>>, path: string, signal: AbortSignal, worktreeOwner?: string, structuralPath?: readonly string[]) => Promise<JsonValue>;
-    worktree?: (owner: string, signal: AbortSignal) => Promise<Readonly<WorkflowWorktreeReference>>;
-    functions?: Readonly<Record<string, {
-        name: string;
-    }>>;
-    variables?: Readonly<Record<string, JsonValue>>;
-    phase?: (name: string) => void | Promise<void>;
-    log?: (message: string) => void | Promise<void>;
-}
-export interface WorkflowExecution {
-    result: Promise<JsonValue>;
-    cancel: () => void;
-}
-export declare function runWorkflow(script: string, args?: JsonValue, bridge?: WorkflowBridge, signal?: AbortSignal): WorkflowExecution;
-export declare function persistActiveAgentAttempt(store: RunStore, id: string, active: Pick<AgentAttempt, "attempt" | "sessionId" | "sessionFile" | "setup">): Promise<void>;
-export declare function persistAgentAttempts(store: RunStore, id: string, attempts: readonly AgentAttempt[]): Promise<void>;
-export declare function formatWorkflowProgress(run: PersistedRun, spinner?: string): string;
-export declare function formatBudgetStatus(run: Pick<PersistedRun, "budget" | "budgetVersion" | "usage" | "budgetEvents">): string[];
-export declare function formatNavigatorDashboard(run: PersistedRun, checkpoints: readonly AwaitingCheckpoint[], worktrees: readonly WorktreeReference[]): string;
-export declare function formatNavigatorRun(loaded: {
-    run: PersistedRun;
-    snapshot: Readonly<LaunchSnapshot>;
-}, checkpoints: readonly AwaitingCheckpoint[], _worktrees: readonly WorktreeReference[]): string;
-export declare function formatWorkflowFailureDiagnostics(diagnostic: WorkflowFailureDiagnostics): string;
-export default function workflowExtension(pi: ExtensionAPI, home?: string, clipboard?: typeof copyToClipboard, createSession?: SessionFactory, agentDir?: string): void;
-export { acquireSessionLease, projectStorageKey, RunStore, runsDirectory, SessionLease, structuralPath } from "./persistence.js";
-export type { AwaitingCheckpoint, CompletedOperation, ConversationHead, NativeSessionReference, PendingWorkflowDecision, PersistedConversation, PersistedOwnershipNode, PersistedRun, WorktreeReference } from "./persistence.js";
+export * from "./types.js";
+export * from "./utils.js";
+export * from "./budget.js";
+export * from "./validation.js";
+export * from "./registry.js";
+export * from "./execution.js";
+export * from "./host.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 { AgentAccounting, AgentAttempt, AgentBudgetHooks, AgentDefinition, AgentExecutionOptions, AgentExecutionResult, AgentExecutionRoot, AgentProgress, AgentProviderFailure, AgentProviderRecovery, AgentSetup, AgentSetupContext, AgentSetupHook, AgentToolCallProgress, RegisteredAgentSetupHook, SessionInput } 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 { 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";
+export type { CleanupFailure, CleanupRunResult, CleanupSessionReport, DoctorCleanupOptions, DoctorCleanupReport } from "./doctor-cleanup.js";