import type { AgentModelConfig, Config } from '../../config/schema.js';
export type ToolModelConfig = {
    primary?: string;
    fallbacks?: string[];
    timeoutMs?: number;
    autoProviderFallback?: boolean;
};
export type ImageModelResolutionSource = 'explicit' | 'auto-role' | 'auto-provider' | 'none';
export type ResolvedImageModelConfig = ToolModelConfig & {
    source: ImageModelResolutionSource;
    roleId?: string;
    roleDescription?: string;
};
export declare function hasToolModelConfig(model: ToolModelConfig | undefined): boolean;
export declare function resolveDefaultModelRef(cfg?: Config): {
    provider: string;
    model: string;
};
export declare function coerceToolModelConfig(model?: AgentModelConfig): ToolModelConfig;
export declare function resolveConfiguredImageModelConfig(params: {
    cfg?: Config;
    agentId?: string;
}): ToolModelConfig;
export declare function buildToolModelConfigFromCandidates(params: {
    explicit: ToolModelConfig;
    candidates: Array<string | null | undefined>;
    source?: ImageModelResolutionSource;
}): ResolvedImageModelConfig | null;
/**
 * Effective image understanding model inferred from configured providers.
 */
export declare function resolveEffectiveImageModelConfig(params: {
    cfg?: Config;
    agentId?: string;
}): ResolvedImageModelConfig | null;
export declare function resolveImageModelConfigForTool(params: {
    cfg?: Config;
    agentId?: string;
}): ResolvedImageModelConfig | null;