jeopi-cli 16.2.13 → 16.2.14

package/dist/types/config/keybindings.d.ts

@@ -1,362 +0,0 @@
-import { type Keybinding, type KeybindingsConfig, type KeyId, KeybindingsManager as TuiKeybindingsManager } from "jeopi-tui";
-/**
- * Application-level keybindings (coding agent specific).
- * Values are always `true` — used for declaration merging.
- */
-interface AppKeybindings {
-    "app.interrupt": true;
-    "app.clear": true;
-    "app.exit": true;
-    "app.suspend": true;
-    "app.display.reset": true;
-    "app.thinking.cycle": true;
-    "app.thinking.toggle": true;
-    "app.model.cycleForward": true;
-    "app.model.cycleBackward": true;
-    "app.model.select": true;
-    "app.model.selectTemporary": true;
-    "app.tools.expand": true;
-    "app.editor.external": true;
-    "app.message.followUp": true;
-    "app.retry": true;
-    "app.message.dequeue": true;
-    "app.clipboard.pasteImage": true;
-    "app.clipboard.pasteTextRaw": true;
-    "app.clipboard.copyLine": true;
-    "app.clipboard.copyPrompt": true;
-    "app.agents.hub": true;
-    "app.session.new": true;
-    "app.session.tree": true;
-    "app.session.fork": true;
-    "app.session.resume": true;
-    "app.session.observe": true;
-    "app.session.togglePath": true;
-    "app.session.toggleSort": true;
-    "app.session.rename": true;
-    "app.session.delete": true;
-    "app.session.deleteNoninvasive": true;
-    "app.tree.foldOrUp": true;
-    "app.tree.unfoldOrDown": true;
-    "app.plan.toggle": true;
-    "app.history.search": true;
-    "app.stt.toggle": true;
-}
-export type AppKeybinding = keyof AppKeybindings;
-declare module "jeopi-tui" {
-    interface Keybindings extends AppKeybindings {
-    }
-}
-/**
- * Resolve default image-paste shortcuts for the current terminal platform.
- */
-export declare function getDefaultPasteImageKeys(platform?: NodeJS.Platform): KeyId[];
-/**
- * All keybindings definitions: TUI + app-specific.
- */
-export declare const KEYBINDINGS: {
-    readonly "tui.editor.cursorUp": {
-        readonly defaultKeys: "up";
-        readonly description: "Move cursor up";
-    };
-    readonly "tui.editor.cursorDown": {
-        readonly defaultKeys: "down";
-        readonly description: "Move cursor down";
-    };
-    readonly "tui.editor.cursorLeft": {
-        readonly defaultKeys: ["left", "ctrl+b"];
-        readonly description: "Move cursor left";
-    };
-    readonly "tui.editor.cursorRight": {
-        readonly defaultKeys: ["right", "ctrl+f"];
-        readonly description: "Move cursor right";
-    };
-    readonly "tui.editor.cursorWordLeft": {
-        readonly defaultKeys: ["alt+left", "ctrl+left", "alt+b"];
-        readonly description: "Move cursor word left";
-    };
-    readonly "tui.editor.cursorWordRight": {
-        readonly defaultKeys: ["alt+right", "ctrl+right", "alt+f"];
-        readonly description: "Move cursor word right";
-    };
-    readonly "tui.editor.cursorLineStart": {
-        readonly defaultKeys: ["home", "ctrl+a"];
-        readonly description: "Move to line start";
-    };
-    readonly "tui.editor.cursorLineEnd": {
-        readonly defaultKeys: ["end", "ctrl+e"];
-        readonly description: "Move to line end";
-    };
-    readonly "tui.editor.jumpForward": {
-        readonly defaultKeys: "ctrl+]";
-        readonly description: "Jump forward to character";
-    };
-    readonly "tui.editor.jumpBackward": {
-        readonly defaultKeys: "ctrl+alt+]";
-        readonly description: "Jump backward to character";
-    };
-    readonly "tui.editor.pageUp": {
-        readonly defaultKeys: "pageUp";
-        readonly description: "Page up";
-    };
-    readonly "tui.editor.pageDown": {
-        readonly defaultKeys: "pageDown";
-        readonly description: "Page down";
-    };
-    readonly "tui.editor.deleteCharBackward": {
-        readonly defaultKeys: "backspace";
-        readonly description: "Delete character backward";
-    };
-    readonly "tui.editor.deleteCharForward": {
-        readonly defaultKeys: ["delete", "ctrl+d"];
-        readonly description: "Delete character forward";
-    };
-    readonly "tui.editor.deleteWordBackward": {
-        readonly defaultKeys: ["ctrl+w", "alt+backspace", "ctrl+backspace", "super+alt+backspace"];
-        readonly description: "Delete word backward";
-    };
-    readonly "tui.editor.deleteWordForward": {
-        readonly defaultKeys: ["alt+delete", "alt+d", "super+alt+delete", "super+alt+d"];
-        readonly description: "Delete word forward";
-    };
-    readonly "tui.editor.deleteToLineStart": {
-        readonly defaultKeys: "ctrl+u";
-        readonly description: "Delete to line start";
-    };
-    readonly "tui.editor.deleteToLineEnd": {
-        readonly defaultKeys: "ctrl+k";
-        readonly description: "Delete to line end";
-    };
-    readonly "tui.editor.yank": {
-        readonly defaultKeys: "ctrl+y";
-        readonly description: "Yank";
-    };
-    readonly "tui.editor.yankPop": {
-        readonly defaultKeys: "alt+y";
-        readonly description: "Yank pop";
-    };
-    readonly "tui.editor.undo": {
-        readonly defaultKeys: ["ctrl+-", "ctrl+_"];
-        readonly description: "Undo";
-    };
-    readonly "tui.input.newLine": {
-        readonly defaultKeys: ["shift+enter", "ctrl+j"];
-        readonly description: "Insert newline";
-    };
-    readonly "tui.input.submit": {
-        readonly defaultKeys: "enter";
-        readonly description: "Submit input";
-    };
-    readonly "tui.input.tab": {
-        readonly defaultKeys: "tab";
-        readonly description: "Tab / autocomplete";
-    };
-    readonly "tui.input.copy": {
-        readonly defaultKeys: "ctrl+c";
-        readonly description: "Copy selection";
-    };
-    readonly "tui.select.up": {
-        readonly defaultKeys: "up";
-        readonly description: "Move selection up";
-    };
-    readonly "tui.select.down": {
-        readonly defaultKeys: "down";
-        readonly description: "Move selection down";
-    };
-    readonly "tui.select.pageUp": {
-        readonly defaultKeys: "pageUp";
-        readonly description: "Selection page up";
-    };
-    readonly "tui.select.pageDown": {
-        readonly defaultKeys: "pageDown";
-        readonly description: "Selection page down";
-    };
-    readonly "tui.select.confirm": {
-        readonly defaultKeys: "enter";
-        readonly description: "Confirm selection";
-    };
-    readonly "tui.select.cancel": {
-        readonly defaultKeys: ["escape", "ctrl+c"];
-        readonly description: "Cancel selection";
-    };
-    readonly "app.interrupt": {
-        readonly defaultKeys: "escape";
-        readonly description: "Interrupt current operation";
-    };
-    readonly "app.clear": {
-        readonly defaultKeys: "ctrl+c";
-        readonly description: "Clear screen or cancel";
-    };
-    readonly "app.exit": {
-        readonly defaultKeys: "ctrl+d";
-        readonly description: "Exit application";
-    };
-    readonly "app.suspend": {
-        readonly defaultKeys: "ctrl+z";
-        readonly description: "Suspend application";
-    };
-    readonly "app.display.reset": {
-        readonly defaultKeys: "ctrl+l";
-        readonly description: "Reset terminal display";
-    };
-    readonly "app.thinking.cycle": {
-        readonly defaultKeys: "shift+tab";
-        readonly description: "Cycle thinking level";
-    };
-    readonly "app.thinking.toggle": {
-        readonly defaultKeys: "ctrl+t";
-        readonly description: "Toggle thinking mode";
-    };
-    readonly "app.model.cycleForward": {
-        readonly defaultKeys: "ctrl+p";
-        readonly description: "Cycle to next model";
-    };
-    readonly "app.model.cycleBackward": {
-        readonly defaultKeys: "shift+ctrl+p";
-        readonly description: "Cycle to previous model";
-    };
-    readonly "app.model.select": {
-        readonly defaultKeys: "alt+m";
-        readonly description: "Select model";
-    };
-    readonly "app.model.selectTemporary": {
-        readonly defaultKeys: "alt+p";
-        readonly description: "Select temporary model for current session";
-    };
-    readonly "app.tools.expand": {
-        readonly defaultKeys: "ctrl+o";
-        readonly description: "Expand tools";
-    };
-    readonly "app.editor.external": {
-        readonly defaultKeys: "ctrl+g";
-        readonly description: "Open external editor";
-    };
-    readonly "app.message.followUp": {
-        readonly defaultKeys: ["ctrl+q", "ctrl+enter"];
-        readonly description: "Send follow-up message";
-    };
-    readonly "app.retry": {
-        readonly defaultKeys: "alt+r";
-        readonly description: "Retry last failed assistant turn";
-    };
-    readonly "app.message.dequeue": {
-        readonly defaultKeys: "alt+up";
-        readonly description: "Dequeue message";
-    };
-    readonly "app.clipboard.pasteImage": {
-        readonly defaultKeys: KeyId[];
-        readonly description: "Paste image or text from clipboard";
-    };
-    readonly "app.clipboard.pasteTextRaw": {
-        readonly defaultKeys: ["ctrl+shift+v", "alt+shift+v"];
-        readonly description: "Paste text from clipboard as raw text (no collapse)";
-    };
-    readonly "app.clipboard.copyLine": {
-        readonly defaultKeys: "alt+shift+l";
-        readonly description: "Copy current line";
-    };
-    readonly "app.clipboard.copyPrompt": {
-        readonly defaultKeys: "alt+shift+c";
-        readonly description: "Copy prompt";
-    };
-    readonly "app.session.new": {
-        readonly defaultKeys: [];
-        readonly description: "Create new session";
-    };
-    readonly "app.session.tree": {
-        readonly defaultKeys: [];
-        readonly description: "Show session tree";
-    };
-    readonly "app.session.fork": {
-        readonly defaultKeys: [];
-        readonly description: "Fork session";
-    };
-    readonly "app.session.resume": {
-        readonly defaultKeys: [];
-        readonly description: "Resume session";
-    };
-    readonly "app.agents.hub": {
-        readonly defaultKeys: "alt+a";
-        readonly description: "Open the agent hub";
-    };
-    readonly "app.session.observe": {
-        readonly defaultKeys: "ctrl+s";
-        readonly description: "Open the agent hub";
-    };
-    readonly "app.session.togglePath": {
-        readonly defaultKeys: "ctrl+p";
-        readonly description: "Toggle session path display";
-    };
-    readonly "app.session.toggleSort": {
-        readonly defaultKeys: "ctrl+s";
-        readonly description: "Toggle session sort order";
-    };
-    readonly "app.session.rename": {
-        readonly defaultKeys: "ctrl+r";
-        readonly description: "Rename session";
-    };
-    readonly "app.session.delete": {
-        readonly defaultKeys: "ctrl+d";
-        readonly description: "Delete session";
-    };
-    readonly "app.session.deleteNoninvasive": {
-        readonly defaultKeys: "ctrl+backspace";
-        readonly description: "Delete session (non-invasive)";
-    };
-    readonly "app.tree.foldOrUp": {
-        readonly defaultKeys: ["ctrl+left", "alt+left"];
-        readonly description: "Fold or move up";
-    };
-    readonly "app.tree.unfoldOrDown": {
-        readonly defaultKeys: ["ctrl+right", "alt+right"];
-        readonly description: "Unfold or move down";
-    };
-    readonly "app.plan.toggle": {
-        readonly defaultKeys: "alt+shift+p";
-        readonly description: "Toggle plan mode";
-    };
-    readonly "app.history.search": {
-        readonly defaultKeys: "ctrl+r";
-        readonly description: "Search history";
-    };
-    readonly "app.stt.toggle": {
-        readonly defaultKeys: [];
-        readonly description: "Toggle speech-to-text (default gesture: hold Space)";
-    };
-};
-declare function migrateKeybindingsConfigFile(agentDir: string): void;
-/**
- * Manages all keybindings (app + TUI).
- * Extends the TUI KeybindingsManager with app-specific functionality.
- */
-export declare class KeybindingsManager extends TuiKeybindingsManager {
-    #private;
-    constructor(userBindings?: KeybindingsConfig, configPath?: string);
-    /**
-     * Create from config file at agentDir/keybindings.yml.
-     * Legacy keybindings.json is migrated to keybindings.yml on load.
-     */
-    static create(agentDir?: string): KeybindingsManager;
-    /**
-     * Create an in-memory keybindings manager without file persistence.
-     */
-    static inMemory(userBindings?: KeybindingsConfig): KeybindingsManager;
-    /**
-     * Reload keybindings from the config file.
-     */
-    reload(): void;
-    setUserBindings(userBindings: KeybindingsConfig): void;
-    getKeys(keybinding: Keybinding): KeyId[];
-    getResolvedBindings(): KeybindingsConfig;
-    /**
-     * Get the effective resolved bindings (defaults + user overrides).
-     */
-    getEffectiveConfig(): KeybindingsConfig;
-    /**
-     * Get display string for a keybinding (e.g., "ctrl+c/escape").
-     */
-    getDisplayString(keybinding: Keybinding): string;
-}
-export declare function formatKeyHint(key: KeyId): string;
-export declare function formatKeyHints(keys: KeyId | KeyId[]): string;
-export type { Keybinding, KeybindingsConfig, KeyId };
-export { migrateKeybindingsConfigFile };

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

@@ -1,68 +0,0 @@
-/**
- * HTTP discovery protocols for configured and implicit providers — ollama,
- * llama.cpp, lm-studio, openai-models-list, and new-api/one-api-style proxies.
- * `ModelRegistry` owns the orchestration (status, state, caching) and calls
- * `discoverModelsByProviderType` with a `DiscoveryContext`; built-in provider
- * discovery lives in pi-catalog's provider-models.
- */
-import { type ApiKey, type FetchImpl } from "jeopi-ai";
-import type { Api, Model, RemoteCompactionConfig } from "jeopi-ai/types";
-import type { ModelSpec } from "jeopi-catalog/types";
-import type { ProviderDiscovery } from "./models-config-schema";
-export declare const DISCOVERY_DEFAULT_CONTEXT_WINDOW = 128000;
-export declare const DISCOVERY_DEFAULT_MAX_TOKENS = 32768;
-export declare function getImplicitOllamaBaseUrl(): string;
-export declare function getOllamaContextLengthOverride(): number | undefined;
-/** Routes discovered-model `maxTokens` defaults around Anthropic's 3× output divisor. */
-export declare function discoveryDefaultMaxTokens(api: Api | undefined): number;
-export interface DiscoveryProviderConfig {
-    provider: string;
-    api: Api;
-    baseUrl?: string;
-    headers?: Record<string, string>;
-    compat?: ModelSpec<Api>["compat"];
-    remoteCompaction?: RemoteCompactionConfig<Api>;
-    discovery: ProviderDiscovery;
-    optional?: boolean;
-}
-/** Registry-provided capabilities the protocol probes need; never the registry itself. */
-export interface DiscoveryContext {
-    /** Injected fetch implementation (tests stub this). */
-    fetch: FetchImpl;
-    /**
-     * Resolve a provider's bearer credential for `Authorization: Bearer …`.
-     * Returns undefined when no key is stored or it is a local/no-auth
-     * sentinel; otherwise an {@link ApiKey} whose resolver participates in the
-     * central force-refresh/rotate auth-retry policy on 401/usage-limit.
-     */
-    getBearerApiKeyResolver(provider: string): Promise<ApiKey | undefined>;
-}
-type LlamaCppDiscoveredModelRuntimeMetadata = {
-    contextWindow: number;
-    maxTokens: number;
-};
-export declare function discoverModelsByProviderType(providerConfig: DiscoveryProviderConfig, ctx: DiscoveryContext): Promise<Model<Api>[]>;
-export declare function discoverOllamaModels(providerConfig: DiscoveryProviderConfig, ctx: DiscoveryContext): Promise<Model<Api>[]>;
-export declare function discoverLlamaCppModels(providerConfig: DiscoveryProviderConfig, ctx: DiscoveryContext): Promise<Model<Api>[]>;
-export declare function discoverLlamaCppModelRuntimeMetadata(model: Pick<Model<Api>, "provider" | "id" | "baseUrl" | "headers">, ctx: DiscoveryContext): Promise<LlamaCppDiscoveredModelRuntimeMetadata | undefined>;
-export declare function discoverOpenAIModelsList(providerConfig: DiscoveryProviderConfig, ctx: DiscoveryContext): Promise<Model<Api>[]>;
-export declare function discoverLiteLLMModels(providerConfig: DiscoveryProviderConfig, ctx: DiscoveryContext): Promise<Model<Api>[]>;
-/**
- * Discover models from an Anthropic+OpenAI-compatible reseller proxy that
- * exposes both `/v1/messages` and `/v1/chat/completions`, advertising each
- * model's wire capabilities through `supported_endpoint_types` on
- * `GET /v1/models` (new-api / one-api-style proxies).
- *
- * Routing per model:
- *   supported_endpoint_types: ["anthropic", ...] -> api: "anthropic-messages"
- *   supported_endpoint_types: ["openai"]         -> api: "openai-completions"
- *   missing / neither                            -> provider-level api fallback
- *
- * Anthropic models share the same baseUrl; the Anthropic SDK strips a
- * trailing `/v1` itself before appending `/v1/messages`, so the discovery
- * URL (which ends in `/v1`) round-trips correctly.
- */
-export declare function discoverProxyModels(providerConfig: DiscoveryProviderConfig, ctx: DiscoveryContext): Promise<Model<Api>[]>;
-export declare function normalizeLiteLLMDiscoveryBaseUrl(baseUrl?: string): string;
-export declare function normalizeOpenAIModelsListBaseUrl(baseUrl?: string): string;
-export {};

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

@@ -1,251 +0,0 @@
-import type { Api, Context, Model, ModelSpec, RemoteCompactionConfig, SimpleStreamOptions, ThinkingConfig } from "jeopi-ai/types";
-import type { AssistantMessageEventStream } from "jeopi-ai/utils/event-stream";
-import { type ModelRefreshStrategy } from "jeopi-catalog/model-manager";
-import type { ApiKeyResolver, FetchImpl } from "jeopi-ai";
-import type { OAuthCredentials, OAuthLoginCallbacks } from "jeopi-ai/oauth/types";
-import type { AuthStorage } from "../session/auth-storage";
-import { type ApiKeyResolverModel, type ApiKeyResolverOptions } from "./api-key-resolver";
-import type { ConfigError } from "./config-file";
-export declare const kNoAuth = "N/A";
-export declare function isAuthenticated(apiKey: string | undefined | null): apiKey is string;
-/** Provider override config (baseUrl, headers, apiKey, compat, transport) without custom models */
-interface ProviderOverride {
-    baseUrl?: string;
-    headers?: Record<string, string>;
-    apiKey?: string;
-    authHeader?: boolean;
-    compat?: ModelSpec<Api>["compat"];
-    remoteCompaction?: RemoteCompactionConfig<Api>;
-    transport?: Model<Api>["transport"];
-}
-/**
- * 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`)
- *
- * `transport` resolution priority:
- *   1. `providerOverride.transport` (e.g. `pi-native` for auth-gateway users)
- *   2. `existing.transport` (carried over from boot-time override application)
- *   3. `model.transport` (rarely set — discovery defaults omit it)
- *
- * 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.
- * Without explicit transport propagation, an openrouter (or any) entry
- * marked `transport: pi-native` in models.yml silently reverts to the
- * default openai-completions transport after the background catalog
- * refresh — so the first `/model` switch after boot hits the raw OpenAI
- * chat-completions URL instead of the gateway's `/v1/pi/stream` (#2555).
- * 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" | "remoteCompaction" | "transport">): 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;
-}
-/**
- * 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
-     *
-     * Sync constructor — eagerly loads bundled + cached models so tests and
-     * synchronous callers see a fully-populated registry immediately. Production
-     * boot paths SHOULD prefer {@link ModelRegistry.create} so the YAML/JSONC
-     * migration step lands off the event loop's hot path before the first
-     * `tryLoad()` runs.
-     */
-    constructor(authStorage: AuthStorage, modelsPath?: string, options?: {
-        fetch?: FetchImpl;
-    });
-    /**
-     * 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>;
-    /**
-     * Refresh dynamic metadata that can appear only after a local model loads.
-     */
-    refreshSelectedModelMetadata(model: Model<Api>): Promise<Model<Api>>;
-    /**
-     * Discover models for providers registered at runtime via `fetchDynamicModels`
-     * (extension providers). Merges the discovered catalog into the existing model
-     * set without reloading static models, so dynamically-discovered models from
-     * other providers are preserved. No-op when no runtime providers are registered.
-     *
-     * Drives the same SQLite model cache as built-in providers, so the default
-     * `online-if-uncached` strategy fetches at most once per cache TTL (24 h).
-     */
-    refreshRuntimeProviders(strategy?: ModelRefreshStrategy): Promise<void>;
-    /**
-     * Get any error from loading models.json (undefined if no error).
-     */
-    getError(): ConfigError | undefined;
-    /**
-     * Get all models (built-in + custom).
-     * If models.json had errors, returns only built-in models.
-     */
-    getAll(): Model<Api>[];
-    /**
-     * 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/pi-coding-agent` 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.
-     *
-     * Side-effect-free and synchronous: a command-backed key (`!cmd`) counts as
-     * configured by its presence alone — the program is NOT executed — and OAuth
-     * tokens are NOT refreshed (`authStorage.hasAuth`). This is what keeps the
-     * model-switch pre-flight off the event loop's hot path; the real key
-     * (command execution + OAuth refresh) is resolved lazily per request via
-     * {@link ModelRegistry.resolver}.
-     */
-    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;
-    /**
-     * Get API key for a model.
-     */
-    getApiKey(model: Model<Api>, sessionId?: string): Promise<string | undefined>;
-    /**
-     * Get API key for a provider (e.g., "openai").
-     *
-     * `options.forceRefresh` powers step (b) of the auth-retry policy — it
-     * re-mints the session-sticky OAuth token even when the cached copy still
-     * looks valid. `options.signal` is threaded into any broker-bound refresh.
-     */
-    getApiKeyForProvider(provider: string, sessionId?: string, options?: {
-        baseUrl?: string;
-        modelId?: string;
-        forceRefresh?: boolean;
-        signal?: AbortSignal;
-    }): Promise<string | undefined>;
-    /**
-     * Build an {@link ApiKeyResolver} implementing the central a/b/c auth-retry
-     * policy. Accepts a provider id with options, or a model with an optional
-     * session id (`resolver(model, sessionId)`) which derives `baseUrl`/`modelId`
-     * from the model. Callers that need the initial key for a guard can call
-     * `resolveApiKeyOnce(resolver)`.
-     */
-    resolver(provider: string, options?: ApiKeyResolverOptions): ApiKeyResolver;
-    resolver(model: ApiKeyResolverModel, sessionId?: string): ApiKeyResolver;
-    /**
-     * Check if a model is using OAuth credentials (subscription).
-     */
-    isUsingOAuth(model: Model<Api>): boolean;
-    /**
-     * 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;
-    /**
-     * Clear all cooldown suppressions recorded via {@link suppressSelector}.
-     * Used to reset retry-fallback cooldown state without a full {@link refresh}.
-     */
-    clearSuppressedSelectors(): void;
-}
-/**
- * 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?: ModelSpec<Api>["compat"];
-    remoteCompaction?: RemoteCompactionConfig<Api>;
-    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>[];
-    };
-    /**
-     * Async factory that fetches the live model list from the provider endpoint.
-     * When present, the result is run through the same SQLite model-cache as
-     * built-in providers (keyed by provider name, default 24 h TTL).
-     * The factory receives the resolved API key (undefined when unauthenticated).
-     */
-    fetchDynamicModels?: (apiKey: string | undefined) => Promise<readonly NonNullable<ProviderConfigInput["models"]>[number][]>;
-    models?: Array<{
-        id: string;
-        name: string;
-        api?: Api;
-        baseUrl?: string;
-        reasoning: boolean;
-        thinking?: ThinkingConfig;
-        input: ("text" | "image")[];
-        supportsTools?: boolean;
-        cost: {
-            input: number;
-            output: number;
-            cacheRead: number;
-            cacheWrite: number;
-        };
-        contextWindow: number;
-        maxTokens: number;
-        headers?: Record<string, string>;
-        compat?: ModelSpec<Api>["compat"];
-        contextPromotionTarget?: string;
-        compactionModel?: string;
-        remoteCompaction?: RemoteCompactionConfig<Api>;
-        premiumMultiplier?: number;
-    }>;
-}
-export {};