import { type ExtensionUIContext, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
import { RunStore, type PersistedRun } from "./persistence.js";
import { type WorkflowRegistryApi } from "./registry.js";
import { type WorkflowRecoveryContext, type createWorkflowRecovery } from "./host-recovery.js";
import { type WorkflowRunRecord } from "./host-runtime.js";
import { type TrajectoryPublisherProvider } from "./trajectory-host-handle.js";
import { type HardTerminalRunState, type JsonValue, type LaunchSnapshot, type LiveSessionHandoff, type PreparedAgentSession, type WorkflowAgentSession } from "./types.js";
type UiSelect = (title: string, options: string[]) => Promise<string | undefined>;
type UiInput = (title: string, placeholder?: string) => Promise<string | undefined>;
type UiSetStatus = (key: string, text?: string) => void;
type UiCustom = ExtensionUIContext["custom"];
type NavigatorStoredRun = {
    store: RunStore;
    loaded: {
        run: PersistedRun;
        snapshot: Readonly<LaunchSnapshot>;
    };
    resolvedAt: number | undefined;
};
type NavigatorRunDependencies = ReadonlyMap<string, readonly string[]>;
type ManualDeletionPlan = {
    ordered: readonly NavigatorStoredRun[];
    skipped: readonly {
        entry: NavigatorStoredRun;
        dependentIds: readonly string[];
    }[];
};
export declare function manualDeletionPlan(entries: readonly NavigatorStoredRun[], state: "completed" | "failed", dependencies: NavigatorRunDependencies): ManualDeletionPlan;
export type UiHostCapabilities = {
    select?: UiSelect;
    input?: UiInput;
    setStatus?: UiSetStatus;
    custom?: UiCustom;
};
type ReportBlocked = (active: boolean, label?: string) => void;
export declare function uiHostCapabilities(ui: unknown): UiHostCapabilities | undefined;
export type WorkflowNavigatorDependencies = {
    pi: Pick<ExtensionAPI, "registerCommand">;
    home: string | undefined;
    clipboard: (value: string) => Promise<void>;
    extensionAgentDir: string;
    runs: Map<string, WorkflowRunRecord>;
    terminalRunStates: Map<string, HardTerminalRunState>;
    hardTerminalRunStates: ReadonlySet<string>;
    ensureSessionLease: (cwd: string, sessionId: string) => Promise<void>;
    answerCheckpoint: (runId: string, name: string, approved: boolean, silent?: boolean) => Promise<boolean>;
    recovery: ReturnType<typeof createWorkflowRecovery>;
    stopWorkflowRun: (runId: string) => Promise<{
        runId: string;
        state: string;
        stopped: boolean;
        reason?: "unknown_run" | "already_terminal";
    }>;
    moveForegroundToBackground: (runId: string) => Promise<{
        runId: string;
        state: "running";
        detached: true;
    }>;
    isForegroundAttached: (runId: string) => boolean;
    liveAgents: {
        get(runId: string, agentId: string): Readonly<{
            session?: WorkflowAgentSession;
            prepared?: Readonly<PreparedAgentSession>;
            handoff?: LiveSessionHandoff;
        }> | undefined;
        overlay(run: PersistedRun): PersistedRun;
    };
    registry: WorkflowRegistryApi;
    projectTrusted: (context: unknown) => boolean;
    resumeHostContext: (context: unknown) => WorkflowRecoveryContext;
    resumeSelectedWorkflow: (runId: string, foreground: boolean, context: unknown, budgetPatch?: unknown) => Promise<{
        workflowName: string;
        state: "running" | "completed" | "awaiting_approval";
        attached: boolean;
        value?: JsonValue;
    }>;
    reportBlocked?: ReportBlocked;
    setNavigatorOpen?: (open: boolean) => void;
    trajectoryProvider: TrajectoryPublisherProvider;
    coordinateRunMutation?: <T>(task: () => Promise<T>) => Promise<T>;
};
export declare function registerWorkflowNavigator(deps: WorkflowNavigatorDependencies): void;
export {};