import { type PiLaunchCommand } from "./pi-command.js";
import { type PreparedReviewRuntime } from "./pi-extension-discovery.js";
import { type PiConfiguredModel } from "./pi-model-selection.js";
export declare const PI_NOT_FOUND_ERROR: string;
export declare const PI_NO_MODELS_ERROR: string;
export declare const PI_MODELS_CONFIG_INVALID_ERROR: string;
export declare function piConfigSandboxError(agentDir: string, evidence: string): string;
export interface PiConfigAccess {
    readonly status: "accessible" | "missing" | "denied";
    readonly errorCode?: string;
}
export type PiConfigAccessProbe = (agentDir: string) => Promise<PiConfigAccess>;
export interface PiProbeResult {
    readonly exitCode: number | null;
    readonly stdout: string;
    readonly stderr: string;
    readonly errorCode?: string;
}
export type PiProbeRunner = (args: readonly string[], signal?: AbortSignal) => Promise<PiProbeResult>;
export interface PiReadiness {
    readonly ready: boolean;
    readonly version?: string;
    readonly modelCount: number;
    readonly resolvedModel?: string;
    readonly models?: readonly PiConfiguredModel[];
    readonly warning?: string;
    readonly errors: readonly string[];
}
export interface PiReadinessOptions {
    readonly extensions?: boolean;
    readonly preparedRuntime?: PreparedReviewRuntime;
    readonly command?: PiLaunchCommand;
    readonly configAccessProbe?: PiConfigAccessProbe;
    readonly environment?: Readonly<NodeJS.ProcessEnv>;
    readonly executable?: string;
    readonly runner?: PiProbeRunner;
    readonly requestedModel?: string;
    readonly signal?: AbortSignal;
    readonly timeoutMs?: number;
}
export declare class PiReadinessError extends Error {
    readonly preserveCliMessage: boolean;
    constructor(message: string, preserveCliMessage?: boolean);
}
export declare function piReadinessEnvironment(environment: Readonly<NodeJS.ProcessEnv>): NodeJS.ProcessEnv;
/**
 * Environment for controller-side review runtime preparation. It never reaches the sandboxed
 * actor; it keeps the caller's Pi session directory so private storage can be excluded.
 */
export declare function reviewRuntimeEnvironment(environment: Readonly<NodeJS.ProcessEnv>): NodeJS.ProcessEnv;
export declare function probePiConfigAccess(agentDir: string): Promise<PiConfigAccess>;
export declare function checkPiReadiness(options?: PiReadinessOptions): Promise<PiReadiness>;
export declare function assertPiReady(options?: PiReadinessOptions): Promise<PiReadiness>;
//# sourceMappingURL=pi-readiness.d.ts.map