export interface HostSettingsIdentity {
    provider: "pcc";
    configPath: string;
}
export interface HostSettingsOptions {
    /** Use the host Pi SDK's getAgentDir(), never a project directory. */
    agentDir: string;
    /** Host Pi model registry's available catalog. */
    models: {
        provider: string;
        modelId: string;
    }[];
    patch?: Record<string, unknown>;
    /** Required for writes; echo the identity from the last read. */
    identity?: HostSettingsIdentity;
}
/** Read or patch persisted global voice settings without starting Pi or voice. */
export declare function hostSettings(options: HostSettingsOptions): Promise<{
    config: {
        model: "codex-live-1.1" | "realtime-2.1" | "realtime-2.1-mini";
        apiProvider: string;
        realtimeVoice: "alloy" | "ash" | "ballad" | "cedar" | "coral" | "echo" | "marin" | "sage" | "shimmer" | "verse";
        realtimeAlternateVoice: "alloy" | "ash" | "ballad" | "cedar" | "coral" | "echo" | "marin" | "sage" | "shimmer" | "verse";
        v3Voice: "arbor" | "breeze" | "cove" | "ember" | "juniper" | "maple" | "sol" | "spruce" | "vale";
        v3AlternateVoice: "arbor" | "breeze" | "cove" | "ember" | "juniper" | "maple" | "sol" | "spruce" | "vale";
        contextModel: import("./adapter/activation/config-contract.ts").VoiceContextModel | null;
        contextReasoning: "high" | "low" | "max" | "medium" | "minimal" | "off" | "xhigh";
        taskDelegationModel: string;
        taskDelegationReasoning: "high" | "low" | "max" | "medium" | "minimal" | "off" | "xhigh";
    };
    voices: readonly ["juniper", "maple", "spruce", "ember", "vale", "breeze", "arbor", "sol", "cove"];
    voiceModels: readonly ["codex-live-1.1", "realtime-2.1", "realtime-2.1-mini"];
    webSearchAvailable: boolean | null;
    realtimeVoices: readonly ["alloy", "ash", "ballad", "coral", "echo", "sage", "shimmer", "verse", "marin", "cedar"];
    contextModels: {
        provider: string;
        modelId: string;
    }[];
    contextReasoningLevels: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
    scope: "Global";
    identity: HostSettingsIdentity;
}>;