/**
 * Contract interface for LLM provider extensions.
 *
 * A single `LLMProviderRegistry` impl lives in the contract registry under
 * {@link LLMProviderRegistryName}. Each provider extension resolves the
 * registry in its `setup()` and calls `registry.register(provider)`.
 * Core consumers (model-registry, veryfront-cloud) resolve the registry
 * and dispatch on provider id parsed from `"provider/model"` strings.
 *
 * @module extensions/llm/llm-provider
 */
import type { EmbeddingRuntime, ModelRuntime } from "../../provider/types.js";
/** Config passed to any provider's create* method. */
export interface LLMProviderConfig {
    /** API credential — maps to OpenAI `apiKey`, Anthropic `authToken`, Google `apiKey` internally. */
    credential: string;
    /** Override the provider's base URL (e.g. Azure OpenAI, self-hosted gateway). */
    baseURL?: string;
    /** Override fetch (veryfront-cloud uses this to inject project auth headers). */
    fetch?: typeof fetch;
    /** Display name shown in errors + telemetry. Defaults to provider id. */
    name?: string;
    /** Provider-specific extras. */
    [key: string]: unknown;
}
/**
 * An LLM provider implementation. Extensions register one of these with the
 * {@link LLMProviderRegistry} during setup(). `createModel` is required;
 * `createEmbedding` and `createResponses` are optional and absent on
 * providers that don't support them.
 */
export interface LLMProvider {
    /** Stable id used in model strings: "openai" / "anthropic" / "google". */
    readonly id: string;
    createModel(modelId: string, config: LLMProviderConfig): ModelRuntime;
    createEmbedding?(modelId: string, config: LLMProviderConfig): EmbeddingRuntime;
    createResponses?(modelId: string, config: LLMProviderConfig): ModelRuntime;
}
/** Registry contract. Single impl created at bootstrap. */
export interface LLMProviderRegistry {
    register(provider: LLMProvider): void;
    unregister(id: string): void;
    get(id: string): LLMProvider | undefined;
    require(id: string): LLMProvider;
    list(): LLMProvider[];
    has(id: string): boolean;
}
/** Contract name used for `resolve()` / `provide()`. */
export declare const LLMProviderRegistryName: "LLMProviderRegistry";
//# sourceMappingURL=llm-provider.d.ts.map