/**
 * Why an agent runtime cannot start without the user acting first.
 *
 * - `root_user` / `first_run_setup`: Claude Code as root, or a runtime whose
 *   first-run screens (theme, terms) only the user may complete.
 * - `api_key_required`: a runtime Crewly runs only on an API key
 *   (Antigravity CLI) and no key is available.
 * - `account_login_refused`: the runtime asked for an account (OAuth)
 *   sign-in Crewly must not use (Antigravity CLI, by Google's policy).
 * - `settings_unreadable`: Crewly could not put the runtime's own settings
 *   into the state it needs (Antigravity's API-key provider).
 * - `auth_required`: the runtime asks the user to sign in (e.g. Gemini with
 *   no key and no Google login).
 * - `runtime_not_installed`: the runtime's CLI is not on the session's PATH.
 */
export type RuntimeStartupBlockedReason = 'root_user' | 'first_run_setup' | 'api_key_required' | 'account_login_refused' | 'settings_unreadable' | 'auth_required' | 'runtime_not_installed';
/**
 * Thrown when an agent runtime cannot start until the user does something:
 * for example Claude Code as root, a Claude Code that was never set up, or
 * an Antigravity CLI without a Gemini API key.
 * Retrying cannot help, so the start-up fallback chain and the orchestrator
 * auto-start stop on it and surface {@link RuntimeStartupBlockedError.message}
 * to the user unchanged.
 */
export declare class RuntimeStartupBlockedError extends Error {
    readonly reason: RuntimeStartupBlockedReason;
    /** Stable machine-readable code. */
    readonly code: string;
    /**
     * @param reason - Which blocking condition was hit
     * @param message - Actionable, user-facing explanation
     */
    constructor(reason: RuntimeStartupBlockedReason, message: string);
}
/**
 * Type guard for {@link RuntimeStartupBlockedError}, also matching errors that
 * crossed a module boundary as plain Errors carrying the code.
 *
 * @param err - Anything caught
 * @returns True when the error means "start-up is blocked, do not retry"
 */
export declare function isRuntimeStartupBlockedError(err: unknown): err is RuntimeStartupBlockedError;
/**
 * Whether terminal output shows the shell failing to find `binary`.
 *
 * Covers the wording of the shells an agent PTY runs: bash
 * (`bash: claude: command not found`), zsh (`zsh: command not found: claude`)
 * and dash/sh (`sh: 1: claude: not found`). The runtimes' own error patterns
 * only listed the zsh form, so on a bash login shell (Linux) a missing CLI
 * waited out the whole readiness timeout and every retry.
 *
 * @param output - Terminal output captured from the session
 * @param binary - The CLI command, e.g. `claude`
 * @returns True when the shell reported the command as missing
 */
export declare function isRuntimeCliMissing(output: string, binary: string): boolean;
/**
 * Build the blocked error for a runtime whose CLI is missing, or null when the
 * runtime has no CLI binary (e.g. the in-process Crewly Agent) or the output
 * does not show it missing. Text inside a runtime UI (e.g. a resumed
 * transcript) is ignored.
 *
 * @param output - Terminal output captured from the session
 * @param runtimeType - The runtime being started
 * @returns The error to throw, or null
 */
export declare function detectRuntimeCliMissing(output: string, runtimeType: string): RuntimeStartupBlockedError | null;
//# sourceMappingURL=runtime-startup-blocked.error.d.ts.map