export interface OfficeCliManifest {
    schemaVersion: 1;
    name: "officecli";
    package: string;
    version: string;
    packageSpec: string;
    registry: string;
    license: string;
    source: string;
    managedTarget: string;
    shimPath: string;
    install: {
        command: "npm";
        args: string[];
        effects: string[];
    };
    environment: {
        OFFICECLI_SKIP_UPDATE: "1";
    };
    upgradePolicy: "exact-pin-only";
}
export type OfficeCliReadinessStatus = "ready" | "missing" | "drift" | "invalid";
export interface OfficeCliReadiness {
    status: OfficeCliReadinessStatus;
    target: string;
    shim: string;
    expectedVersion: string;
    observedVersion?: string;
    reason?: string;
    recovery: string;
}
export interface OfficeCliInstallSummary {
    status: "planned" | "skipped" | "preserved" | "installed" | "failed";
    package: string;
    expectedVersion: string;
    observedVersion?: string;
    target: string;
    shim: string;
    command: string;
    argv: string[];
    effects: string[];
    reason?: string;
    recovery: string;
    exitCode?: number | null;
}
export interface OfficeCliInstallOptions {
    ailiHome: string;
    opencodeHome: string;
    dryRun: boolean;
    enabled?: boolean;
    skip?: boolean;
}
export declare function loadOfficeCliManifest(ailiHome: string): Promise<OfficeCliManifest>;
export declare function managedOfficeCliTarget(home?: string): string;
export declare function inspectOfficeCli(ailiHome: string): Promise<OfficeCliReadiness>;
export declare function runOfficeCliInstall(options: OfficeCliInstallOptions): Promise<OfficeCliInstallSummary>;