export declare const PLAN_MARKER = "@plan:PLAN-20260126-SETTINGS-SEPARATION.P05";
export type SettingCategory = 'model-behavior' | 'provider-config' | 'cli-behavior' | 'model-param' | 'custom-header';
export interface ValidationResult {
    success: boolean;
    value?: unknown;
    message?: string;
}
export interface SettingSpec {
    key: string;
    aliases?: readonly string[];
    category: SettingCategory;
    providers?: readonly string[];
    description: string;
    hint?: string;
    type: 'boolean' | 'number' | 'string' | 'enum' | 'json' | 'string-array';
    enumValues?: readonly string[];
    validate?: (value: unknown) => ValidationResult;
    parse?: (raw: string) => unknown;
    normalize?: (value: unknown) => unknown;
    default?: unknown;
    persistToProfile: boolean;
    completionOptions?: ReadonlyArray<{
        value: string;
        description?: string;
    }>;
}
export interface SeparatedSettings {
    cliSettings: Record<string, unknown>;
    modelBehavior: Record<string, unknown>;
    modelParams: Record<string, unknown>;
    customHeaders: Record<string, string>;
}
export declare const SETTINGS_REGISTRY: readonly SettingSpec[];
export declare function resolveAlias(key: string): string;
export declare function getSettingSpec(key: string): SettingSpec | undefined;
export declare function normalizeSetting(key: string, value: unknown): unknown;
export declare function separateSettings(mixed: Record<string, unknown>, providerName?: string): SeparatedSettings;
export declare function validateSetting(key: string, value: unknown): ValidationResult;
export declare function parseSetting(key: string, raw: string): unknown;
export declare function getProfilePersistableKeys(): string[];
export declare function getSettingHelp(): Record<string, string>;
export declare function getCompletionOptions(): ReadonlyArray<{
    key: string;
    options?: ReadonlyArray<{
        value: string;
        description?: string;
    }>;
}>;
export declare function getAllSettingKeys(): string[];
export declare function getValidationHelp(key: string): string | undefined;
export declare function getAutocompleteSuggestions(key: string): ReadonlyArray<{
    value: string;
    description?: string;
}> | undefined;
export declare function getProtectedSettingKeys(): string[];
export declare function getProviderConfigKeys(): string[];
export interface DirectSettingSpec {
    value: string;
    hint: string;
    description?: string;
    options?: ReadonlyArray<{
        value: string;
        description?: string;
    }>;
}
export declare function getDirectSettingSpecs(): DirectSettingSpec[];