@sayknow-cli/coding-agent 0.4.2 → 0.4.3

package/dist/types/config/model-profile-activation.d.ts

@@ -0,0 +1,85 @@
+import { ThinkingLevel } from "@sayknow-cli/agent-core";
+import type { Api, Model } from "@sayknow-cli/ai";
+import type { AgentSession } from "../session/agent-session";
+import { type ModelRegistry, type SkcModelAssignmentTargetId } from "./model-registry";
+import { type ModelSelectorValue } from "./model-selector-value";
+import type { Settings } from "./settings";
+type ModelProfileActivationSession = Pick<AgentSession, "model" | "thinkingLevel" | "sessionId" | "getConfiguredModelChain" | "setConfiguredModelChain"> & {
+    setModelTemporary?: AgentSession["setModelTemporary"];
+    setActiveModelProfile?: (name: string | undefined) => void;
+    getActiveModelProfile?: () => string | undefined;
+    getSessionDefaultModelSelector?: () => string | undefined;
+    recordResumeDefaultModel?: (selector: string) => void;
+    seedDefaultFallbackResolution?: (activeIndex: number, skips: Array<{
+        selector: string;
+        reason: string;
+    }>) => void;
+};
+export interface PrepareModelProfileActivationOptions {
+    session: ModelProfileActivationSession;
+    modelRegistry: Pick<ModelRegistry, "getModelProfile" | "getModelProfiles" | "getAvailableModelProfileNames" | "getApiKeyForProvider" | "getAll" | "resolveCanonicalModel" | "getCanonicalVariants" | "getCanonicalId">;
+    settings: Pick<Settings, "get">;
+    profileName: string;
+}
+export interface ApplyModelProfileActivationOptions {
+    persistDefault?: boolean;
+    thinkingLevelOverride?: ThinkingLevel;
+}
+export interface PreparedModelProfileActivation {
+    profileName: string;
+    session: ModelProfileActivationSession & {
+        setModelTemporary: AgentSession["setModelTemporary"];
+    };
+    settings: Pick<Settings, "get" | "override" | "set" | "flush">;
+    previousModel: Model<Api> | undefined;
+    previousThinkingLevel: ThinkingLevel | undefined;
+    previousAgentModelOverrides: Record<string, ModelSelectorValue>;
+    previousModelRoles: Record<string, ModelSelectorValue>;
+    previousDefaultChain: readonly string[] | undefined;
+    defaultModel: Model<Api> | undefined;
+    defaultThinkingLevel: ThinkingLevel | undefined;
+    /** Full configured default fallback chain with resolvable entries clamped. */
+    defaultChain: readonly string[];
+    /** Index of the authenticated default-chain entry selected for activation. */
+    defaultActiveIndex: number | undefined;
+    /** Resolution-time skips that occurred before selecting the default entry. */
+    defaultResolutionSkips: Array<{
+        selector: string;
+        reason: string;
+    }>;
+    modelRoles: Record<string, ModelSelectorValue>;
+    agentModelOverrides: Record<string, ModelSelectorValue>;
+    previousActiveModelProfile: string | undefined;
+    /**
+     * The session resume default ("provider/id") captured BEFORE activation —
+     * the model resume would restore prior to this profile. Snapshotted
+     * separately from `previousModel` (the live runtime model, which may be a
+     * transient switch) so a failed-activation rollback restores the correct
+     * resume default without promoting a transient model to it.
+     */
+    previousSessionDefaultModel: string | undefined;
+}
+export interface MaterializeModelProfileAssignmentOptions {
+    session: Pick<ModelProfileActivationSession, "model" | "thinkingLevel" | "getConfiguredModelChain" | "setActiveModelProfile" | "getActiveModelProfile">;
+    settings: Pick<Settings, "clearOverride" | "get" | "override" | "set" | "unset">;
+    role: SkcModelAssignmentTargetId;
+    selector: string;
+}
+export interface MaterializeModelProfileAssignmentsOptions {
+    session: Pick<ModelProfileActivationSession, "model" | "thinkingLevel" | "getConfiguredModelChain" | "setActiveModelProfile" | "getActiveModelProfile">;
+    settings: Pick<Settings, "clearOverride" | "get" | "override" | "set" | "unset">;
+    assignments: ReadonlyMap<SkcModelAssignmentTargetId, string> | Partial<Record<SkcModelAssignmentTargetId, string>>;
+}
+export declare function materializeActiveModelProfileAssignment(options: MaterializeModelProfileAssignmentOptions): boolean;
+export declare function materializeActiveModelProfileAssignments(options: MaterializeModelProfileAssignmentsOptions): boolean;
+export declare class ModelProfileCredentialError extends Error {
+    readonly profileLabel: string;
+    readonly providers: readonly string[];
+    constructor(profileLabel: string, providers: readonly string[]);
+}
+export declare function formatModelProfileCredentialError(profileLabel: string, providers: readonly string[]): string;
+export declare function resolveModelProfileName(profileName: string, profiles: ReadonlyMap<string, unknown>): string;
+export declare function prepareModelProfileActivation(options: PrepareModelProfileActivationOptions): Promise<PreparedModelProfileActivation>;
+export declare function applyPreparedModelProfileActivation(prepared: PreparedModelProfileActivation, options?: ApplyModelProfileActivationOptions): Promise<void>;
+export declare function activateModelProfile(options: PrepareModelProfileActivationOptions, applyOptions?: ApplyModelProfileActivationOptions): Promise<void>;
+export {};

package/dist/types/config/model-profiles.d.ts

@@ -0,0 +1,45 @@
+import type { SkcModelAssignmentTargetId } from "./model-registry";
+import { type ModelSelectorValue } from "./model-selector-value";
+import type { ModelsConfig } from "./models-config-schema";
+export type ModelProfileRole = SkcModelAssignmentTargetId;
+export interface ModelProfileDefinition {
+    name: string;
+    requiredProviders: string[];
+    displayName?: string;
+    /**
+     * Optional groups of providers that are interchangeable fallbacks.
+     * Each group is an array of provider ids where at least one must be
+     * authenticated. Providers NOT in any group are treated as strict
+     * requirements (all must be authenticated).
+     *
+     * Example: `[["xiaomi", "xiaomi-token-plan-sgp", "xiaomi-token-plan-ams", "xiaomi-token-plan-cn"]]`
+     * means any single xiaomi credential satisfies the group.
+     */
+    alternativeProviderGroups?: readonly (readonly string[])[];
+    modelMapping: Partial<Record<ModelProfileRole, ModelSelectorValue>>;
+    source: "builtin" | "user";
+}
+export interface ResolvedProfileBinding {
+    defaultSelector?: ModelSelectorValue;
+    modelRoles: Record<string, ModelSelectorValue>;
+    agentModelOverrides: Partial<Record<Exclude<ModelProfileRole, "default">, ModelSelectorValue>>;
+}
+export declare function deriveModelProfileMappedProviders(definition: Pick<ModelProfileDefinition, "modelMapping">): string[];
+/**
+ * Return the providers explicitly declared as hard prerequisites.
+ * Model mappings may reference fallback providers, but those references are
+ * resolution-time candidates rather than activation requirements.
+ */
+export declare function aggregateModelProfileRequiredProviders(requiredProviders: readonly string[], _definition: Pick<ModelProfileDefinition, "modelMapping">): string[];
+export declare const BUILTIN_MODEL_PROFILES: readonly ModelProfileDefinition[];
+export interface ModelProfilePresentation {
+    displayName: string;
+    providerGroup: string;
+}
+export declare function getModelProfilePresentation(profile: string | Pick<ModelProfileDefinition, "name" | "displayName">): ModelProfilePresentation;
+export declare function formatModelProfileDisplayLabel(profile: Pick<ModelProfileDefinition, "name" | "displayName">): string;
+export declare function groupModelProfilesForPresetLanding(profiles: ReadonlyMap<string, ModelProfileDefinition>): Map<string, ModelProfileDefinition[]>;
+export declare function recommendModelProfileForProvider(providerId: string, profiles: ReadonlyMap<string, ModelProfileDefinition>): ModelProfileDefinition | undefined;
+export declare function mergeModelProfiles(userProfiles?: ModelsConfig["profiles"]): Map<string, ModelProfileDefinition>;
+export declare function resolveProfileBindings(definition: ModelProfileDefinition): ResolvedProfileBinding;
+export declare function formatAvailableProfileNames(profiles: ReadonlyMap<string, ModelProfileDefinition>): string;

package/dist/types/config/model-registry.d.ts

@@ -0,0 +1,473 @@
+import { type Api, type AssistantMessageEventStream, type AuthCredentialSelector, type CacheRetention, type Context, type Model, type ModelRefreshStrategy, type ModelRequestTransform, type SimpleStreamOptions, type ThinkingConfig } from "@sayknow-cli/ai";
+import type { OAuthCredentials, OAuthLoginCallbacks } from "@sayknow-cli/ai/utils/oauth/types";
+import { type ThemeColor } from "../modes/theme/theme";
+import type { AuthStorage } from "../session/auth-storage";
+import type { ActiveSearchModelContext, WebSearchMode } from "../web/search/types";
+import { type ConfigError, ConfigFile } from "./config-file";
+import { type CanonicalModelIndex, type CanonicalModelRecord, type CanonicalModelVariant, type ModelEquivalenceConfig } from "./model-equivalence";
+import { type ModelProfileDefinition } from "./model-profiles";
+import { type ModelProfileConfig } from "./models-config-schema";
+import { type Settings } from "./settings";
+export type { CanonicalModelIndex, CanonicalModelRecord, CanonicalModelVariant, ModelEquivalenceConfig };
+export declare const kNoAuth = "N/A";
+export declare function isAuthenticated(apiKey: string | undefined | null): apiKey is string;
+export type ModelRole = "default";
+export interface ModelRoleInfo {
+    tag?: string;
+    name: string;
+    color?: ThemeColor;
+}
+export declare const MODEL_ROLES: Record<ModelRole, ModelRoleInfo>;
+export declare const MODEL_ROLE_IDS: ModelRole[];
+export declare const MODEL_PROFILE_NAME_PATTERN: RegExp;
+export declare const MODEL_PROFILE_NAME_PATTERN_DESCRIPTION = "lowercase letters, numbers, dots, underscores, or hyphens";
+export type SkcModelAssignmentTargetId = "default" | "executor" | "architect" | "planner" | "critic";
+export interface SkcModelAssignmentTargetInfo extends ModelRoleInfo {
+    id: SkcModelAssignmentTargetId;
+    settingsPath: "modelRoles" | "task.agentModelOverrides";
+}
+export declare const SKC_MODEL_ASSIGNMENT_TARGET_IDS: SkcModelAssignmentTargetId[];
+export declare const SKC_MODEL_ASSIGNMENT_TARGETS: Record<SkcModelAssignmentTargetId, SkcModelAssignmentTargetInfo>;
+/** Alias for ModelRoleInfo - used for both built-in and custom roles */
+export type RoleInfo = ModelRoleInfo;
+/**
+ * Return the canonical set of known roles for selector/carousel UI.
+ *
+ * Built-ins always come first. Configured cycle order, model assignments, and
+ * tag metadata can introduce additional custom roles without requiring duplicate
+ * entries across settings.
+ */
+export declare function getKnownRoleIds(settings: Settings): string[];
+/**
+ * Get role info for a role name (built-in or custom).
+ * Configured metadata overrides built-in defaults when present.
+ */
+export declare function getRoleInfo(role: string, settings: Settings): RoleInfo;
+export declare const ModelsConfigFile: ConfigFile<{
+    providers?: Record<string, {
+        baseUrl?: string | undefined;
+        apiKey?: string | undefined;
+        apiKeyEnv?: string | undefined;
+        api?: "google-gemini-cli" | "google-vertex" | "openai-completions" | "openai-responses" | "openai-codex-responses" | "azure-openai-responses" | "anthropic-messages" | "bedrock-converse-stream" | "google-generative-ai" | "ollama-chat" | "cursor-agent" | undefined;
+        headers?: Record<string, string> | undefined;
+        compat?: {
+            supportsStore?: boolean | undefined;
+            supportsDeveloperRole?: boolean | undefined;
+            sendSessionHeaders?: boolean | undefined;
+            supportsMultipleSystemMessages?: boolean | undefined;
+            supportsReasoningEffort?: boolean | undefined;
+            reasoningEffortMap?: {
+                minimal?: string | undefined;
+                low?: string | undefined;
+                medium?: string | undefined;
+                high?: string | undefined;
+                xhigh?: string | undefined;
+                max?: string | undefined;
+            } | undefined;
+            maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
+            supportsUsageInStreaming?: boolean | undefined;
+            requiresToolResultName?: boolean | undefined;
+            requiresMistralToolIds?: boolean | undefined;
+            requiresAssistantAfterToolResult?: boolean | undefined;
+            requiresThinkingAsText?: boolean | undefined;
+            reasoningContentField?: "reasoning_content" | "reasoning" | "reasoning_text" | undefined;
+            requiresReasoningContentForToolCalls?: boolean | undefined;
+            allowsSyntheticReasoningContentForToolCalls?: boolean | undefined;
+            requiresAssistantContentForToolCalls?: boolean | undefined;
+            supportsToolChoice?: boolean | undefined;
+            supportsForcedToolChoice?: boolean | undefined;
+            toolChoiceSupport?: "none" | "auto" | "required" | "named" | undefined;
+            disableReasoningOnForcedToolChoice?: boolean | undefined;
+            disableReasoningOnToolChoice?: boolean | undefined;
+            thinkingFormat?: "openai" | "openrouter" | "zai" | "qwen" | "qwen-chat-template" | undefined;
+            openRouterRouting?: {
+                only?: string[] | undefined;
+                order?: string[] | undefined;
+            } | undefined;
+            vercelGatewayRouting?: {
+                only?: string[] | undefined;
+                order?: string[] | undefined;
+            } | undefined;
+            extraBody?: Record<string, unknown> | undefined;
+            supportsStrictMode?: boolean | undefined;
+            toolStrictMode?: "none" | "all_strict" | undefined;
+        } | undefined;
+        webSearch?: "auto" | "on" | "off" | undefined;
+        authHeader?: boolean | undefined;
+        auth?: "none" | "apiKey" | "oauth" | undefined;
+        discovery?: {
+            type: "ollama" | "lm-studio" | "llama.cpp" | "openai-models-list";
+        } | undefined;
+        requestTransform?: {
+            profile?: "openai-proxy" | undefined;
+            stripHeaders?: string[] | undefined;
+            setHeaders?: Record<string, string | null> | undefined;
+            extraBody?: Record<string, unknown> | undefined;
+        } | undefined;
+        models?: {
+            id: string;
+            name?: string | undefined;
+            api?: "google-gemini-cli" | "google-vertex" | "openai-completions" | "openai-responses" | "openai-codex-responses" | "azure-openai-responses" | "anthropic-messages" | "bedrock-converse-stream" | "google-generative-ai" | "ollama-chat" | "cursor-agent" | undefined;
+            baseUrl?: string | undefined;
+            reasoning?: boolean | undefined;
+            thinking?: {
+                minLevel: "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
+                maxLevel: "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
+                mode: "effort" | "budget" | "google-level" | "anthropic-adaptive" | "anthropic-budget-effort";
+                defaultLevel?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+                levels?: ("minimal" | "low" | "medium" | "high" | "xhigh" | "max")[] | undefined;
+            } | undefined;
+            input?: ("text" | "image")[] | undefined;
+            output?: ("text" | "image")[] | undefined;
+            cost?: {
+                input: number;
+                output: number;
+                cacheRead: number;
+                cacheWrite: number;
+            } | undefined;
+            premiumMultiplier?: number | undefined;
+            contextWindow?: number | undefined;
+            maxTokens?: number | undefined;
+            headers?: Record<string, string> | undefined;
+            compat?: {
+                supportsStore?: boolean | undefined;
+                supportsDeveloperRole?: boolean | undefined;
+                sendSessionHeaders?: boolean | undefined;
+                supportsMultipleSystemMessages?: boolean | undefined;
+                supportsReasoningEffort?: boolean | undefined;
+                reasoningEffortMap?: {
+                    minimal?: string | undefined;
+                    low?: string | undefined;
+                    medium?: string | undefined;
+                    high?: string | undefined;
+                    xhigh?: string | undefined;
+                    max?: string | undefined;
+                } | undefined;
+                maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
+                supportsUsageInStreaming?: boolean | undefined;
+                requiresToolResultName?: boolean | undefined;
+                requiresMistralToolIds?: boolean | undefined;
+                requiresAssistantAfterToolResult?: boolean | undefined;
+                requiresThinkingAsText?: boolean | undefined;
+                reasoningContentField?: "reasoning_content" | "reasoning" | "reasoning_text" | undefined;
+                requiresReasoningContentForToolCalls?: boolean | undefined;
+                allowsSyntheticReasoningContentForToolCalls?: boolean | undefined;
+                requiresAssistantContentForToolCalls?: boolean | undefined;
+                supportsToolChoice?: boolean | undefined;
+                supportsForcedToolChoice?: boolean | undefined;
+                toolChoiceSupport?: "none" | "auto" | "required" | "named" | undefined;
+                disableReasoningOnForcedToolChoice?: boolean | undefined;
+                disableReasoningOnToolChoice?: boolean | undefined;
+                thinkingFormat?: "openai" | "openrouter" | "zai" | "qwen" | "qwen-chat-template" | undefined;
+                openRouterRouting?: {
+                    only?: string[] | undefined;
+                    order?: string[] | undefined;
+                } | undefined;
+                vercelGatewayRouting?: {
+                    only?: string[] | undefined;
+                    order?: string[] | undefined;
+                } | undefined;
+                extraBody?: Record<string, unknown> | undefined;
+                supportsStrictMode?: boolean | undefined;
+                toolStrictMode?: "none" | "all_strict" | undefined;
+            } | undefined;
+            contextPromotionTarget?: string | undefined;
+            wireModelId?: string | undefined;
+            requestTransform?: {
+                profile?: "openai-proxy" | undefined;
+                stripHeaders?: string[] | undefined;
+                setHeaders?: Record<string, string | null> | undefined;
+                extraBody?: Record<string, unknown> | undefined;
+            } | undefined;
+            cacheRetention?: "none" | "short" | "long" | undefined;
+        }[] | undefined;
+        modelOverrides?: Record<string, {
+            name?: string | undefined;
+            reasoning?: boolean | undefined;
+            thinking?: {
+                minLevel: "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
+                maxLevel: "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
+                mode: "effort" | "budget" | "google-level" | "anthropic-adaptive" | "anthropic-budget-effort";
+                defaultLevel?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+                levels?: ("minimal" | "low" | "medium" | "high" | "xhigh" | "max")[] | undefined;
+            } | undefined;
+            input?: ("text" | "image")[] | undefined;
+            output?: ("text" | "image")[] | undefined;
+            cost?: {
+                input?: number | undefined;
+                output?: number | undefined;
+                cacheRead?: number | undefined;
+                cacheWrite?: number | undefined;
+            } | undefined;
+            premiumMultiplier?: number | undefined;
+            contextWindow?: number | undefined;
+            maxTokens?: number | undefined;
+            headers?: Record<string, string> | undefined;
+            compat?: {
+                supportsStore?: boolean | undefined;
+                supportsDeveloperRole?: boolean | undefined;
+                sendSessionHeaders?: boolean | undefined;
+                supportsMultipleSystemMessages?: boolean | undefined;
+                supportsReasoningEffort?: boolean | undefined;
+                reasoningEffortMap?: {
+                    minimal?: string | undefined;
+                    low?: string | undefined;
+                    medium?: string | undefined;
+                    high?: string | undefined;
+                    xhigh?: string | undefined;
+                    max?: string | undefined;
+                } | undefined;
+                maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
+                supportsUsageInStreaming?: boolean | undefined;
+                requiresToolResultName?: boolean | undefined;
+                requiresMistralToolIds?: boolean | undefined;
+                requiresAssistantAfterToolResult?: boolean | undefined;
+                requiresThinkingAsText?: boolean | undefined;
+                reasoningContentField?: "reasoning_content" | "reasoning" | "reasoning_text" | undefined;
+                requiresReasoningContentForToolCalls?: boolean | undefined;
+                allowsSyntheticReasoningContentForToolCalls?: boolean | undefined;
+                requiresAssistantContentForToolCalls?: boolean | undefined;
+                supportsToolChoice?: boolean | undefined;
+                supportsForcedToolChoice?: boolean | undefined;
+                toolChoiceSupport?: "none" | "auto" | "required" | "named" | undefined;
+                disableReasoningOnForcedToolChoice?: boolean | undefined;
+                disableReasoningOnToolChoice?: boolean | undefined;
+                thinkingFormat?: "openai" | "openrouter" | "zai" | "qwen" | "qwen-chat-template" | undefined;
+                openRouterRouting?: {
+                    only?: string[] | undefined;
+                    order?: string[] | undefined;
+                } | undefined;
+                vercelGatewayRouting?: {
+                    only?: string[] | undefined;
+                    order?: string[] | undefined;
+                } | undefined;
+                extraBody?: Record<string, unknown> | undefined;
+                supportsStrictMode?: boolean | undefined;
+                toolStrictMode?: "none" | "all_strict" | undefined;
+            } | undefined;
+            contextPromotionTarget?: string | undefined;
+            wireModelId?: string | undefined;
+            requestTransform?: {
+                profile?: "openai-proxy" | undefined;
+                stripHeaders?: string[] | undefined;
+                setHeaders?: Record<string, string | null> | undefined;
+                extraBody?: Record<string, unknown> | undefined;
+            } | undefined;
+            cacheRetention?: "none" | "short" | "long" | undefined;
+        }> | undefined;
+        disableStrictTools?: boolean | undefined;
+        transport?: "pi-native" | undefined;
+        cacheRetention?: "none" | "short" | "long" | undefined;
+        openaiCompat?: {
+            baseUrl: string;
+            apiKey?: string | undefined;
+            apiKeyEnv?: string | undefined;
+        } | undefined;
+    }> | undefined;
+    modelBindings?: {
+        modelRoles?: Record<string, string | string[]> | undefined;
+        agentModelOverrides?: Record<string, string | string[]> | undefined;
+    } | undefined;
+    equivalence?: {
+        overrides?: Record<string, string> | undefined;
+        exclude?: string[] | undefined;
+    } | undefined;
+    profiles?: Record<string, {
+        required_providers: string[];
+        model_mapping: Partial<Record<"default" | "executor" | "architect" | "planner" | "critic", string | string[]>>;
+        display_name?: string | undefined;
+    }> | undefined;
+}>;
+/** Provider override config (baseUrl, headers, apiKey, compat, transport) without custom models */
+interface ProviderOverride {
+    baseUrl?: string;
+    headers?: Record<string, string>;
+    apiKey?: string;
+    authHeader?: boolean;
+    compat?: Model<Api>["compat"];
+    transport?: Model<Api>["transport"];
+    requestTransform?: ModelRequestTransform;
+    cacheRetention?: CacheRetention;
+}
+/**
+ * Merge a freshly discovered model with the matching bundled/configured entry
+ * (or a runtime provider override when no bundled entry exists).
+ *
+ * `baseUrl` resolution priority:
+ *   1. User-set `providerOverride.baseUrl` (explicit override in models.json)
+ *   2. Discovered baseUrl (xiaomi `tp-` token-plan keys resolve to
+ *      `token-plan-sgp.xiaomimimo.com` at discovery time)
+ *   3. Existing bundled baseUrl (the host baked into `models.json`)
+ *
+ * Without (1), the user's override would lose to discovery; without (2)
+ * preferred over (3), the bundled `api.xiaomimimo.com` would shadow the
+ * tp- token-plan host and produce 401s on the first stream call.
+ * See `xiaomi-tp-discovery-merge.test.ts` and the `refresh()` baseUrl-override
+ * regression in `model-registry.test.ts`.
+ */
+export declare function mergeDiscoveredModel<TApi extends Api>(model: Model<TApi>, existing: Model<Api> | undefined, providerOverride?: Pick<ProviderOverride, "baseUrl" | "headers" | "transport" | "requestTransform" | "cacheRetention">): Model<TApi>;
+export type ProviderDiscoveryStatus = "idle" | "ok" | "empty" | "cached" | "unavailable" | "unauthenticated";
+export interface ProviderDiscoveryState {
+    provider: string;
+    status: ProviderDiscoveryStatus;
+    optional: boolean;
+    stale: boolean;
+    fetchedAt?: number;
+    models: string[];
+    error?: string;
+}
+export interface CanonicalModelQueryOptions {
+    availableOnly?: boolean;
+    candidates?: readonly Model<Api>[];
+}
+/**
+ * Model registry - loads and manages models, resolves API keys via AuthStorage.
+ */
+export declare class ModelRegistry {
+    #private;
+    readonly authStorage: AuthStorage;
+    /**
+     * @param authStorage - Auth storage for API key resolution
+     */
+    constructor(authStorage: AuthStorage, modelsPath?: string);
+    /**
+     * Reload models from disk (built-in + custom from models.json).
+     */
+    refresh(strategy?: ModelRefreshStrategy): Promise<void>;
+    refreshInBackground(strategy?: ModelRefreshStrategy): void;
+    refreshProvider(providerId: string, strategy?: ModelRefreshStrategy): Promise<void>;
+    /**
+     * Get any error from loading models.json (undefined if no error).
+     */
+    getError(): ConfigError | undefined;
+    getModelProfiles(): Map<string, ModelProfileDefinition>;
+    getModelProfile(name: string): ModelProfileDefinition | undefined;
+    getAvailableModelProfileNames(): string[];
+    saveCustomModelProfile(name: string, definition: ModelProfileConfig): Promise<ModelProfileDefinition>;
+    renameCustomModelProfile(name: string, displayName: string): Promise<ModelProfileDefinition>;
+    deleteCustomModelProfile(name: string): Promise<ModelProfileConfig>;
+    applyConfiguredModelBindings(targetSettings: Settings): void;
+    /**
+     * Get all models (built-in + custom).
+     * If models.json had errors, returns only built-in models.
+     */
+    getAll(): Model<Api>[];
+    getCanonicalModels(options?: CanonicalModelQueryOptions): CanonicalModelRecord[];
+    getCanonicalVariants(canonicalId: string, options?: CanonicalModelQueryOptions): CanonicalModelVariant[];
+    resolveCanonicalModel(canonicalId: string, options?: CanonicalModelQueryOptions): Model<Api> | undefined;
+    getCanonicalId(model: Model<Api>): string | undefined;
+    /**
+     * Get only models that have auth configured.
+     * This is a fast check that doesn't refresh OAuth tokens.
+     */
+    getAvailable(): Model<Api>[];
+    /**
+     * Check whether auth is configured for a model's provider.
+     *
+     * Mirrors the upstream `@mariozechner/sayknow-cli` API surface so that
+     * external plugins/extensions and downstream wrappers (e.g. subagent launch
+     * paths that pre-flight auth before model resolution) can probe a model
+     * without resolving an API key. Returns true for keyless providers as well
+     * as providers with stored credentials. See issue #993.
+     */
+    hasConfiguredAuth(model: Model<Api>): boolean;
+    getDiscoverableProviders(): string[];
+    getProviderDiscoveryState(provider: string): ProviderDiscoveryState | undefined;
+    /**
+     * Find a model by provider and ID.
+     */
+    find(provider: string, modelId: string): Model<Api> | undefined;
+    /**
+     * Get the base URL associated with a provider, if any model defines one.
+     */
+    getProviderBaseUrl(provider: string): string | undefined;
+    getProviderWebSearchMode(provider: string): WebSearchMode | undefined;
+    getActiveSearchModelContext(model: Model<Api>): ActiveSearchModelContext;
+    /**
+     * Get API key for a model.
+     */
+    getApiKey(model: Model<Api>, sessionId?: string, options?: {
+        credentialSelector?: AuthCredentialSelector;
+    }): Promise<string | undefined>;
+    /**
+     * Get API key for a provider (e.g., "openai").
+     */
+    getApiKeyForProvider(provider: string, sessionId?: string, baseUrl?: string, options?: {
+        credentialSelector?: AuthCredentialSelector;
+    }): Promise<string | undefined>;
+    /**
+     * Check if a model is using OAuth credentials (subscription).
+     */
+    isUsingOAuth(model: Model<Api>): boolean;
+    getSessionCredentialType(provider: string, sessionId?: string): "api_key" | "oauth" | undefined;
+    /**
+     * Remove custom API/OAuth registrations for a specific extension source.
+     */
+    clearSourceRegistrations(sourceId: string): void;
+    /**
+     * Remove registrations for extension sources that are no longer active.
+     */
+    syncExtensionSources(activeSourceIds: string[]): void;
+    /**
+     * Register a provider dynamically (from extensions).
+     *
+     * If provider has models: replaces all existing models for this provider.
+     * If provider has only baseUrl/headers: overrides existing models' URLs.
+     * If provider has streamSimple: registers a custom API streaming function.
+     * If provider has oauth: registers OAuth provider for /login support.
+     */
+    registerProvider(providerName: string, config: ProviderConfigInput, sourceId?: string): void;
+    /**
+     * Suppress a specific model selector (e.g., "provider/id") until a specific timestamp.
+     */
+    suppressSelector(selector: string, untilMs: number): void;
+    /**
+     * Check if a model selector is currently suppressed due to rate limits.
+     */
+    isSelectorSuppressed(selector: string): boolean;
+}
+/**
+ * Input type for registerProvider API (from extensions).
+ */
+export interface ProviderConfigInput {
+    baseUrl?: string;
+    apiKey?: string;
+    api?: Api;
+    streamSimple?: (model: Model<Api>, context: Context, options?: SimpleStreamOptions) => AssistantMessageEventStream;
+    headers?: Record<string, string>;
+    compat?: Model<Api>["compat"];
+    requestTransform?: ModelRequestTransform;
+    authHeader?: boolean;
+    /** Streaming transport override — see {@link Model.transport}. */
+    transport?: Model<Api>["transport"];
+    oauth?: {
+        name: string;
+        login(callbacks: OAuthLoginCallbacks): Promise<OAuthCredentials | string>;
+        refreshToken?(credentials: OAuthCredentials): Promise<OAuthCredentials>;
+        getApiKey?(credentials: OAuthCredentials): string;
+        modifyModels?(models: Model<Api>[], credentials: OAuthCredentials): Model<Api>[];
+    };
+    models?: Array<{
+        id: string;
+        name: string;
+        api?: Api;
+        baseUrl?: string;
+        reasoning: boolean;
+        thinking?: ThinkingConfig;
+        input: ("text" | "image")[];
+        cost: {
+            input: number;
+            output: number;
+            cacheRead: number;
+            cacheWrite: number;
+        };
+        contextWindow: number;
+        maxTokens: number;
+        headers?: Record<string, string>;
+        compat?: Model<Api>["compat"];
+        requestTransform?: ModelRequestTransform;
+        wireModelId?: string;
+        contextPromotionTarget?: string;
+        premiumMultiplier?: number;
+    }>;
+}