import type { SettingsNamespace, SettingsPathOp } from '@deepseek-ai/dsh-settings';
import { type Config, type ResolvedConfig } from './config.ts';
/**
 * Validate and brand one DSH settings namespace without requiring a newer runtime helper.
 * @param value - Candidate lowercase kebab-case namespace.
 * @returns The validated namespace.
 */
export declare function settingsNamespace(value: string): SettingsNamespace;
/** Persistent settings namespace owned by this plugin. */
export declare const VISION_MIX_SETTINGS_NAMESPACE: SettingsNamespace;
interface SettingsDescriptorLike {
    ns: string;
    revision: number;
}
interface SettingsAccess {
    readonly writable: boolean;
    describe(options?: {
        redactSecrets?: boolean;
    }): SettingsDescriptorLike[];
    mutate(ns: string, ops: readonly SettingsPathOp[], expectedRevision?: number): Promise<void>;
}
/** Routing configuration returned to the browser settings page. */
export interface VisionMixSettingsView {
    available: boolean;
    writable: boolean;
    revision: number;
    routing: ResolvedConfig;
}
/** One revision-fenced Web routing update. */
export interface RoutingSettingsUpdate {
    revision: number;
    routing: Config;
}
/** Host services used by the Web settings controller. */
export interface SettingsControllerDependencies {
    current(): ResolvedConfig;
    settings: SettingsAccess;
}
/** Build the model-reference-only settings operations used by the HTTP route. */
export declare function createSettingsController(dependencies: SettingsControllerDependencies): {
    describe(): VisionMixSettingsView;
    updateRouting(input: RoutingSettingsUpdate): Promise<void>;
};
export {};
//# sourceMappingURL=settings.d.ts.map