/**
 * Host capability probes for non-interactive / sandboxed environments.
 *
 * When the CLI runs inside an AI agent sandbox (Claude Code, Codex, Cursor),
 * the keyring, home directory, network, or browser may be unavailable.
 * These helpers detect that situation and emit a single actionable warning
 * per session instead of letting opaque EPERM errors confuse the agent.
 */
export type HostCapability = 'home-fs' | 'keychain' | 'network' | 'browser-launch' | 'localhost-bind';
export type HostOperation = 'read' | 'write' | 'delete' | 'connect' | 'open' | 'listen';
export interface HostCapabilityDetails {
    operation?: HostOperation;
    target?: string;
    label?: string;
}
export interface ProbeFailure extends HostCapabilityDetails {
    capability: HostCapability;
    detail: string;
}
export interface ProbeResult {
    ok: boolean;
    failures: ProbeFailure[];
}
export declare function formatHostProbeFailure(failure: ProbeFailure): string;
export declare function runHostProbe(): Promise<ProbeResult>;
export declare function warnIfSandboxed(): Promise<void>;
export declare function observeHostFailure(capability: HostCapability, error: unknown, details?: HostCapabilityDetails): void;
export declare function _resetProbeState(): void;