import { type DashboardOpenResult } from "./dashboard-herdr.ts";
import type { HerdrExec } from "../executors/herdr-cli.ts";
export type DashboardPromptChoice = "not-now" | "never";
export declare function dashboardPreferencePath(agentDir: string): string;
export interface DashboardHandshakeUI {
    select(title: string, choices: string[]): Promise<string | undefined>;
    notify(message: string, level?: "info" | "warning" | "error"): void;
}
export interface DashboardHandshakeInput {
    mode: string;
    env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
    pid?: number;
    exec?: HerdrExec;
    cwd: string;
    ledgerPath?: string;
    pluginRoot: string;
    preferencePath: string;
    paneStatePath: string;
    ui: DashboardHandshakeUI;
}
export type DashboardHandshakeOutcome = "not-applicable" | "suppressed" | "already-installed" | "installed" | "deferred" | "failed";
export declare function offerDashboardHandshake(input: DashboardHandshakeInput): Promise<DashboardHandshakeOutcome>;
export interface DashboardCommandInput {
    env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
    pid?: number;
    exec?: HerdrExec;
    cwd: string;
    ledgerPath?: string;
    pluginRoot: string;
    paneStatePath: string;
}
export type DashboardCommandResult = DashboardOpenResult | {
    kind: "fallback";
    frame: string;
    visibleBesideCaller: false;
};
export declare function openDashboardCommand(input: DashboardCommandInput): Promise<DashboardCommandResult>;
export declare function defaultDashboardPaths(agentDir: string): {
    preferencePath: string;
    paneStatePath: string;
};
//# sourceMappingURL=dashboard-handshake.d.ts.map