interface ConsoleLockPayload {
    readonly pid: number;
    readonly host: string;
    readonly port: number;
    readonly endpoint: string;
    readonly startedAt: number;
    readonly token: string;
    readonly version: string;
    readonly owner?: ConsoleOwnerMetadata;
}
interface ConsoleOwnerMetadata {
    readonly kind: "cli" | "desktop";
    readonly id: string;
    readonly protocolVersion: number;
}
interface ConsoleHealth {
    readonly ok: true;
    readonly pid: number;
    readonly host: string;
    readonly port: number;
    readonly portMode: "dynamic" | "static";
    readonly requestedPort: number | null;
    readonly effectivePort: number;
    readonly portHonored: boolean;
    readonly endpoint: string;
    readonly startedAt: number;
    readonly version: string;
    readonly channel?: "stable" | "local";
    readonly owner?: ConsoleOwnerMetadata;
    readonly workspaceCount: number;
}

/**
 * 브라우저 실행기가 실제로 떴는지에 대한 답. 실패를 삼키면 CLI가 "열었다"고 말한 뒤
 * 아무것도 뜨지 않는 화면만 남으므로, 이 결과는 호출자가 사용자에게 전할 사실이다.
 */
interface BrowserOpenResult {
    readonly opened: boolean;
    readonly reason?: string;
}
interface OpenBrowserDeps {
    readonly platform?: NodeJS.Platform;
    readonly spawnBrowser?: (command: string, args: readonly string[], options: {
        readonly detached: true;
        readonly stdio: "ignore";
        readonly windowsHide: true;
    }) => void | Promise<BrowserOpenResult>;
}

interface ConsoleProbeResult {
    readonly healthy: boolean;
    readonly lock: ConsoleLockPayload | null;
    readonly health?: ConsoleHealth;
    readonly error?: string;
}
interface ConsoleHealthDeps {
    readonly fetch?: typeof fetch;
}
declare function createConsoleHealthClient(deps?: ConsoleHealthDeps): {
    probe: (lock: ConsoleLockPayload | null) => Promise<ConsoleProbeResult>;
};

type ConsoleCliMode = "start" | "stop" | "restart" | "status" | "help";
interface ConsoleDaemonLifecycleDeps {
    readonly env?: NodeJS.ProcessEnv;
    readonly execPath?: string;
    readonly serverModulePath?: string;
    readonly spawnDetached?: (execPath: string, args: readonly string[], options: {
        readonly detached: true;
        readonly env: NodeJS.ProcessEnv;
        readonly stdio: "ignore";
        readonly windowsHide: true;
    }) => void;
    readonly sleep?: (ms: number) => Promise<void>;
    readonly health?: ReturnType<typeof createConsoleHealthClient>;
}
interface OpenFleetConsoleDeps {
    readonly lifecycle?: Pick<ReturnType<typeof createConsoleDaemonLifecycle>, "ensureDaemon" | "probe">;
    readonly openBrowser?: (url: string, deps?: OpenBrowserDeps) => void | Promise<BrowserOpenResult>;
}
interface OpenFleetConsoleResult {
    readonly url: string;
    /** 브라우저 실행기가 실제로 떴는지. 거짓이면 호출자가 주소를 사용자에게 직접 건네야 한다. */
    readonly browserOpened: boolean;
    readonly browserError?: string;
}
interface ConsoleStatusDeps {
    readonly lifecycle?: Pick<ReturnType<typeof createConsoleDaemonLifecycle>, "probe">;
}
interface ConsoleStopDeps {
    readonly lifecycle?: Pick<ReturnType<typeof createConsoleDaemonLifecycle>, "stop">;
}
type ConsoleHookCommand = {
    readonly command: "capture-session";
    readonly provider: "claude";
} | {
    readonly command: "turn-start";
} | {
    readonly command: "turn-end";
} | {
    readonly command: "background-report";
} | {
    readonly command: "background-spawn";
} | {
    readonly command: "background-stop";
} | {
    readonly command: "attention";
} | {
    readonly command: "auto-name";
};
interface ConsoleRestartDeps {
    readonly lifecycle?: Pick<ReturnType<typeof createConsoleDaemonLifecycle>, "stop" | "ensureDaemon" | "probe">;
    readonly openBrowser?: (url: string, deps?: OpenBrowserDeps) => void;
}
interface BuildConsoleHelpTextOptions {
    readonly env?: NodeJS.ProcessEnv;
    readonly isTTY?: boolean;
    readonly release?: string;
}
declare function parseConsoleCliMode(argv: readonly string[]): ConsoleCliMode;
declare function parseConsoleHookCommand(argv: readonly string[]): ConsoleHookCommand;
declare function buildConsoleHelpText(options?: BuildConsoleHelpTextOptions): string;
declare function createConsoleDaemonLifecycle(deps?: ConsoleDaemonLifecycleDeps): {
    ensureDaemon: () => Promise<string>;
    probe: () => Promise<{
        buildStale: boolean;
        healthy: boolean;
        lock: ConsoleLockPayload | null;
        health?: ConsoleHealth;
        error?: string;
    }>;
    runServer: () => Promise<void>;
    stop: () => Promise<void>;
};
declare function openFleetConsole(deps?: OpenFleetConsoleDeps): Promise<OpenFleetConsoleResult>;
declare function runConsoleStatus(deps?: ConsoleStatusDeps): Promise<string>;
declare function runConsoleStop(deps?: ConsoleStopDeps): Promise<string>;
declare function assertCliCanControlDaemon(payload: ConsoleLockPayload): void;
declare function isLockProcessAlive(pid: number): boolean;
declare function runConsoleRestart(deps?: ConsoleRestartDeps): Promise<OpenFleetConsoleResult>;
declare function main(): Promise<void>;

declare function isCliDirectRun(argv1: string | undefined, moduleUrl?: string): boolean;

export { type BuildConsoleHelpTextOptions, type ConsoleCliMode, type ConsoleDaemonLifecycleDeps, type ConsoleHookCommand, type ConsoleRestartDeps, type ConsoleStatusDeps, type ConsoleStopDeps, type OpenFleetConsoleDeps, type OpenFleetConsoleResult, assertCliCanControlDaemon, buildConsoleHelpText, createConsoleDaemonLifecycle, isCliDirectRun, isLockProcessAlive, main, openFleetConsole, parseConsoleCliMode, parseConsoleHookCommand, runConsoleRestart, runConsoleStatus, runConsoleStop };