import { type TakeHoistedCliInstall } from './cli-install.js';
import { type ConnectCheckpoint, requireCommandSupport, type AgentClient, type ConnectRunState, type ConnectTelemetry, type SupportedCommand } from './connect-runtime.js';
import type { WalkthroughOutcome } from './connect-clients.js';
export interface NativeConnectOptions {
    apiKey?: string;
    mcpUrl: string;
    launch: boolean;
    attemptId?: string;
    /** Headless: refuse rather than fall back to an unfinishable browser sign-in. */
    keyAuthOnly?: boolean;
    /** Headless --all: bounds sign-in spawns and bars interactive CLI login. */
    authTimeoutMs?: number;
    /** Internal only: false leaves the global npm tree untouched. */
    cliInstall?: boolean;
    /** Set by `--all`: the CLI install already ran once, upfront. */
    hoistedCliInstall?: TakeHoistedCliInstall;
    /** Lets `--all` warn in its summary instead of all-green. */
    onPostInstallFailed?: () => void;
    /** Inherit subprocess stdio instead of replaying it only on failure. */
    verbose?: boolean;
    /** Set by `--all`: repeated outro lines print once, after the summary. */
    deferOutro?: (line: string) => void;
    /** Targeted connects only: --all keeps its per-harness failed row. */
    fallbackWhenMissing?: boolean;
}
export declare function requireKeylessMcp(mcpUrl: string): Promise<void>;
/** Undefined means the rescue ran; the caller returns immediately. */
export declare function requireSupportOrRescue(client: SupportedCommand, connectClient: AgentClient, state: ConnectRunState, telemetry: ConnectTelemetry, options: {
    apiKey?: string;
    verbose?: boolean;
    fallbackWhenMissing?: boolean;
}): Promise<ReturnType<typeof requireCommandSupport> | undefined>;
/** Consumes the `--all` hoist when present; installs inline otherwise. */
export declare function runCliInstallStep(options: NativeConnectOptions, telemetry: ConnectTelemetry): void;
export declare function walkthroughPhase(outcome: WalkthroughOutcome): ConnectCheckpoint;
export declare function finishSetupHint(connectClient: AgentClient): string;
/** Warn + report post_install_failed; interrupts are abandonment, not failure. */
export declare function trackPostInstallFailure(displayName: string, state: ConnectRunState, telemetry: ConnectTelemetry, error: unknown): void;