import type { ResolvedCodexConfig } from "./types.js";
export type CodexShortcutTarget = "run" | "app" | "both";
export type CodexShortcutScope = "auto" | "system" | "user";
export interface CodexShortcutOptions {
    target?: CodexShortcutTarget;
    scope?: CodexShortcutScope;
    workspace?: string;
    account?: string;
    selectAccount?: boolean;
    server?: string;
    insecurePoc?: boolean;
    registryUrl?: string;
    cliWrapper?: boolean;
    force?: boolean;
    rootDirectory?: string;
    /** Runtime capture overrides used by embedders and cross-platform contract tests. */
    runtime?: {
        platform?: NodeJS.Platform;
        env?: NodeJS.ProcessEnv;
        homeDirectory?: string;
        nodeExecutable?: string;
        npmExecutable?: string | null;
        wrapperEntrypoint?: string | null;
        wrapperVersion?: string;
    };
}
export interface CodexShortcutArtifact {
    kind: "cli" | "command" | "application" | "launcher" | "manifest";
    path: string;
}
export interface CodexShortcutResult {
    action: "installed" | "removed";
    platform: NodeJS.Platform;
    scope: "system" | "user";
    commandDirectory: string;
    pathReady: boolean;
    pathHint?: string;
    artifacts: CodexShortcutArtifact[];
}
export declare function installCodexShortcuts(config: ResolvedCodexConfig, options?: CodexShortcutOptions): Promise<CodexShortcutResult>;
export declare function removeCodexShortcuts(config: ResolvedCodexConfig, options?: CodexShortcutOptions): Promise<CodexShortcutResult>;