@oh-my-pi/pi-catalog 15.10.11

package/dist/types/model-thinking.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Thinking metadata: build-time derivation and runtime field-read helpers.
+ *
+ * Derivation (`resolveModelThinking`) runs exactly once per model — from
+ * `buildModel` for dynamic specs and from the catalog generator for bundled
+ * entries. Everything below the "runtime helpers" divider reads baked fields
+ * only: no id parsing, no host matching, no compat detection per request.
+ */
+import { Effort } from "./effort";
+import type { Api, CompatOf, Model, ModelSpec, ThinkingConfig } from "./types";
+/**
+ * Runtime helpers read baked metadata only, so they accept both pre-build
+ * specs and built models.
+ */
+type ApiModel<TApi extends Api = Api> = ModelSpec<TApi> | Model<TApi>;
+/**
+ * Effort → wire-value map for the 5-tier adaptive scale (Opus 4.7+ and
+ * Fable/Mythos 5 on the Messages API). User-facing efforts shift up one notch
+ * so the top tier reaches the genuine "max" and "high" lands on Anthropic's
+ * recommended "xhigh" coding/agentic default.
+ */
+export declare const ANTHROPIC_ADAPTIVE_EFFORT_MAP_5_TIER: Readonly<Partial<Record<Effort, string>>>;
+/**
+ * Effort → wire-value map for the legacy 4-tier adaptive scale (Opus 4.6,
+ * Sonnet 4.6+, and every adaptive model on Bedrock Converse). `low..high` pass
+ * through verbatim; there is no real "xhigh", so it aliases the top "max" tier.
+ */
+export declare const ANTHROPIC_ADAPTIVE_EFFORT_MAP_4_TIER: Readonly<Partial<Record<Effort, string>>>;
+/**
+ * Resolve the canonical thinking metadata for a spec. Called exactly once per
+ * model by `buildModel`, after compat resolution.
+ *
+ * - Non-reasoning models never carry thinking.
+ * - Models that reason natively but reject the wire effort param
+ *   (`compat.supportsReasoningEffort: false` on openai-responses*) carry no
+ *   thinking either: `reasoning: true, thinking: undefined` IS the encoding
+ *   for "thinks, but exposes no control surface".
+ * - Explicit spec thinking (generator-baked or user-authored) owns the
+ *   capability surface (`mode`, `efforts`, `defaultLevel`); the wire facts
+ *   (`effortMap`, `supportsDisplay`) are backfilled from identity when not
+ *   explicitly set, so configs never need to know Anthropic's tier tables.
+ * - Sparse specs go through full inference.
+ */
+export declare function resolveModelThinking<TApi extends Api>(spec: ModelSpec<TApi>, compat: CompatOf<TApi>): ThinkingConfig | undefined;
+/** Derive thinking from identity + resolved compat, ignoring any baked value. Generator-side entry. */
+export declare function deriveThinking<TApi extends Api>(spec: ModelSpec<TApi>, compat: CompatOf<TApi>): ThinkingConfig;
+/**
+ * Returns the supported thinking efforts declared on the model metadata.
+ * Empty for non-reasoning models and for reasoning models without a
+ * controllable effort surface (`thinking: undefined`).
+ */
+export declare function getSupportedEfforts<TApi extends Api>(model: ApiModel<TApi>): readonly Effort[];
+/**
+ * Clamps a requested thinking level against explicit model metadata.
+ *
+ * Non-reasoning models always resolve to `undefined`.
+ */
+export declare function clampThinkingLevelForModel<TApi extends Api>(model: ApiModel<TApi> | undefined, requested: Effort | undefined): Effort | undefined;
+export declare function requireSupportedEffort<TApi extends Api>(model: ApiModel<TApi>, effort: Effort): Effort;
+/** Maps a normalized thinking effort to Google's `thinkingLevel` enum values. */
+export declare function mapEffortToGoogleThinkingLevel(effort: Effort): "MINIMAL" | "LOW" | "MEDIUM" | "HIGH";
+/**
+ * Maps a normalized thinking effort to Anthropic adaptive effort values via
+ * the model's baked `thinking.effortMap` (identity for unmapped efforts).
+ */
+export declare function mapEffortToAnthropicAdaptiveEffort<TApi extends Api>(model: ApiModel<TApi>, effort: Effort): "low" | "medium" | "high" | "xhigh" | "max";
+export {};

package/dist/types/models.d.ts

@@ -0,0 +1,12 @@
+import MODELS from "./models.json";
+import type { Api, KnownProvider, Model, Usage } from "./types";
+export type GeneratedProvider = keyof typeof MODELS;
+export declare function getBundledModel<TApi extends Api = Api>(provider: GeneratedProvider, modelId: string): Model<TApi>;
+export declare function getBundledProviders(): KnownProvider[];
+export declare function getBundledModels(provider: GeneratedProvider): Model<Api>[];
+export declare function calculateCost<TApi extends Api>(model: Model<TApi>, usage: Usage): Usage["cost"];
+/**
+ * Check if two models are equal by comparing both their id and provider.
+ * Returns false if either model is null or undefined.
+ */
+export declare function modelsAreEqual<TApi extends Api>(a: Model<TApi> | null | undefined, b: Model<TApi> | null | undefined): boolean;

package/dist/types/provider-models/bundled-references.d.ts

@@ -0,0 +1,11 @@
+import { getBundledModels } from "../models";
+import type { Api, Model, ModelSpec } from "../types";
+/**
+ * Project a built `Model` back to spec stage: `compat` becomes the verbatim
+ * sparse override record (`compatConfig`), never the resolved view. Discovery
+ * mappers spread these references into the specs they hand to the model
+ * manager, which rebuilds via `buildModel`.
+ */
+export declare function toModelSpec<TApi extends Api>(model: Model<TApi>): ModelSpec<TApi>;
+export declare function createBundledReferenceMap<TApi extends Api>(provider: Parameters<typeof getBundledModels>[0]): Map<string, ModelSpec<TApi>>;
+export declare function createReferenceResolver<TApi extends Api>(providerRefs: Map<string, ModelSpec<TApi>>): (modelId: string) => ModelSpec<TApi> | undefined;

package/dist/types/provider-models/descriptor-types.d.ts

@@ -0,0 +1,74 @@
+import type { ModelManagerOptions } from "../model-manager";
+import type { Api, FetchImpl } from "../types";
+/** Config passed to a provider's runtime model-manager factory. */
+export type ModelManagerConfig = {
+    apiKey?: string;
+    baseUrl?: string;
+    fetch?: FetchImpl;
+};
+/** Catalog discovery configuration for providers that support endpoint-based model listing. */
+export interface CatalogDiscoveryConfig {
+    /** Human-readable name for log messages. */
+    label: string;
+    /**
+     * Environment variables to check for API keys during catalog generation.
+     * Defaults to the entry-level `envVars` when omitted.
+     */
+    envVars?: readonly string[];
+    /** OAuth provider for credential refresh during catalog generation. */
+    oauthProvider?: string;
+    /** When true, catalog discovery proceeds even without credentials. */
+    allowUnauthenticated?: boolean;
+}
+/** Unified provider descriptor used by both runtime discovery and catalog generation. */
+export interface ProviderDescriptor {
+    providerId: string;
+    createModelManagerOptions(config: ModelManagerConfig): ModelManagerOptions<Api>;
+    /** Preferred model ID when no explicit selection is made. */
+    defaultModel: string;
+    /** When true, the runtime creates a model manager even without a valid API key (e.g. ollama). */
+    allowUnauthenticated?: boolean;
+    /** When true, successful runtime discovery replaces bundled provider models instead of merging fallback-only IDs. */
+    dynamicModelsAuthoritative?: boolean;
+    /** Catalog discovery configuration. Only providers with this field participate in generate-models.ts. */
+    catalogDiscovery?: CatalogDiscoveryConfig;
+}
+/** A provider descriptor that has catalog discovery configured. */
+export type CatalogProviderDescriptor = ProviderDescriptor & {
+    catalogDiscovery: CatalogDiscoveryConfig;
+};
+/** Type guard for descriptors with catalog discovery. */
+export declare function isCatalogDescriptor(d: ProviderDescriptor): d is CatalogProviderDescriptor;
+/** Whether catalog discovery may run without provider credentials. */
+export declare function allowsUnauthenticatedCatalogDiscovery(descriptor: CatalogProviderDescriptor): boolean;
+/**
+ * One model provider's catalog-side description. The auth half of a provider
+ * (env keys, OAuth login/refresh flows) lives in `@oh-my-pi/pi-ai`'s registry;
+ * the catalog table below is the single source of truth for ids, default
+ * models, and discovery wiring.
+ *
+ * - Every entry is a member of `KnownProvider`.
+ * - `createModelManagerOptions` present (and not `specialModelManager`) ⇒
+ *   appears in `PROVIDER_DESCRIPTORS` for runtime model discovery.
+ * - `catalogDiscovery` present ⇒ participates in `generate-models.ts`.
+ */
+export interface ProviderCatalogEntry {
+    readonly id: string;
+    /** Preferred model ID when no explicit selection is made. */
+    readonly defaultModel: string;
+    /** Environment variables consulted (in order) for the provider's runtime API-key env fallback. */
+    readonly envVars?: readonly string[];
+    /** Runtime model-manager factory. Omitted for catalog-only providers. */
+    readonly createModelManagerOptions?: (config: ModelManagerConfig) => ModelManagerOptions<Api>;
+    /** When true, the runtime creates a model manager even without a valid API key. */
+    readonly allowUnauthenticated?: boolean;
+    /** When true, successful runtime discovery replaces bundled provider models. */
+    readonly dynamicModelsAuthoritative?: boolean;
+    /** Catalog discovery configuration for generate-models.ts. */
+    readonly catalogDiscovery?: CatalogDiscoveryConfig;
+    /**
+     * Built bespoke by the coding-agent runtime (OAuth-token-driven managers);
+     * excluded from `PROVIDER_DESCRIPTORS` even though models are discoverable.
+     */
+    readonly specialModelManager?: boolean;
+}

package/dist/types/provider-models/descriptors.d.ts

@@ -0,0 +1,384 @@
+/**
+ * The provider catalog table: one entry per chat-model provider, carrying the
+ * catalog half of what used to live in `@oh-my-pi/pi-ai`'s registry definitions
+ * (default model, runtime model-manager factory, discovery wiring). The auth
+ * half (env keys, OAuth login/refresh) stays in the pi-ai registry, which
+ * type-checks itself against `KnownProvider` from this table.
+ */
+import type { ModelManagerConfig, ProviderCatalogEntry, ProviderDescriptor } from "./descriptor-types";
+export declare const CATALOG_PROVIDERS: readonly [{
+    readonly id: "aimlapi";
+    readonly defaultModel: "gpt-4o";
+    readonly envVars: readonly ["AIMLAPI_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly dynamicModelsAuthoritative: true;
+    readonly catalogDiscovery: {
+        readonly label: "AIML API";
+    };
+}, {
+    readonly id: "alibaba-coding-plan";
+    readonly defaultModel: "qwen3.5-plus";
+    readonly envVars: readonly ["ALIBABA_CODING_PLAN_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "Alibaba Coding Plan";
+    };
+}, {
+    readonly id: "amazon-bedrock";
+    readonly defaultModel: "us.anthropic.claude-opus-4-6-v1";
+}, {
+    readonly id: "anthropic";
+    readonly defaultModel: "claude-opus-4-6";
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"anthropic-messages", unknown>;
+}, {
+    readonly id: "cerebras";
+    readonly defaultModel: "zai-glm-4.6";
+    readonly envVars: readonly ["CEREBRAS_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "Cerebras";
+    };
+}, {
+    readonly id: "cloudflare-ai-gateway";
+    readonly defaultModel: "claude-sonnet-4-5";
+    readonly envVars: readonly ["CLOUDFLARE_AI_GATEWAY_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"anthropic-messages", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "Cloudflare AI Gateway";
+    };
+}, {
+    readonly id: "cursor";
+    readonly defaultModel: "claude-sonnet-4-6";
+    readonly envVars: readonly ["CURSOR_ACCESS_TOKEN"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"cursor-agent", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "Cursor";
+        readonly envVars: readonly ["CURSOR_API_KEY"];
+        readonly oauthProvider: "cursor";
+    };
+}, {
+    readonly id: "deepseek";
+    readonly defaultModel: "deepseek-v4-pro";
+    readonly envVars: readonly ["DEEPSEEK_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "DeepSeek";
+    };
+}, {
+    readonly id: "firepass";
+    readonly defaultModel: "kimi-k2.6-turbo";
+    readonly envVars: readonly ["FIREPASS_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+}, {
+    readonly id: "fireworks";
+    readonly defaultModel: "kimi-k2.6";
+    readonly envVars: readonly ["FIREWORKS_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "Fireworks";
+    };
+}, {
+    readonly id: "github-copilot";
+    readonly defaultModel: "gpt-4o";
+    readonly envVars: readonly ["COPILOT_GITHUB_TOKEN"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<import("..").Api, unknown>;
+}, {
+    readonly id: "gitlab-duo";
+    readonly defaultModel: "duo-chat-sonnet-4-5";
+    readonly envVars: readonly ["GITLAB_TOKEN"];
+}, {
+    readonly id: "google";
+    readonly defaultModel: "gemini-2.5-pro";
+    readonly envVars: readonly ["GEMINI_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"google-generative-ai", unknown>;
+}, {
+    readonly id: "google-antigravity";
+    readonly defaultModel: "gemini-3-pro-high";
+    readonly specialModelManager: true;
+}, {
+    readonly id: "google-gemini-cli";
+    readonly defaultModel: "gemini-2.5-pro";
+    readonly specialModelManager: true;
+}, {
+    readonly id: "google-vertex";
+    readonly defaultModel: "gemini-3-pro-preview";
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<import("..").Api, unknown>;
+    readonly allowUnauthenticated: true;
+}, {
+    readonly id: "groq";
+    readonly defaultModel: "openai/gpt-oss-120b";
+    readonly envVars: readonly ["GROQ_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+}, {
+    readonly id: "huggingface";
+    readonly defaultModel: "deepseek-ai/DeepSeek-R1";
+    readonly envVars: readonly ["HUGGINGFACE_HUB_TOKEN", "HF_TOKEN"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "Hugging Face";
+    };
+}, {
+    readonly id: "kilo";
+    readonly defaultModel: "anthropic/claude-sonnet-4.5";
+    readonly envVars: readonly ["KILO_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "Kilo Gateway";
+        readonly allowUnauthenticated: true;
+    };
+}, {
+    readonly id: "kimi-code";
+    readonly defaultModel: "kimi-k2.5";
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "Kimi Code";
+        readonly envVars: readonly ["KIMI_API_KEY"];
+    };
+}, {
+    readonly id: "litellm";
+    readonly defaultModel: "claude-opus-4-6";
+    readonly envVars: readonly ["LITELLM_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "LiteLLM";
+        readonly allowUnauthenticated: true;
+    };
+}, {
+    readonly id: "lm-studio";
+    readonly defaultModel: "llama-3-8b";
+    readonly envVars: readonly ["LM_STUDIO_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly allowUnauthenticated: true;
+}, {
+    readonly id: "minimax";
+    readonly defaultModel: "MiniMax-M2.5";
+    readonly envVars: readonly ["MINIMAX_API_KEY"];
+}, {
+    readonly id: "minimax-code";
+    readonly defaultModel: "MiniMax-M2.5";
+    readonly envVars: readonly ["MINIMAX_CODE_API_KEY"];
+}, {
+    readonly id: "minimax-code-cn";
+    readonly defaultModel: "MiniMax-M2.5";
+    readonly envVars: readonly ["MINIMAX_CODE_CN_API_KEY"];
+}, {
+    readonly id: "mistral";
+    readonly defaultModel: "devstral-medium-latest";
+    readonly envVars: readonly ["MISTRAL_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+}, {
+    readonly id: "moonshot";
+    readonly defaultModel: "kimi-k2.5";
+    readonly envVars: readonly ["MOONSHOT_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "Moonshot";
+    };
+}, {
+    readonly id: "nanogpt";
+    readonly defaultModel: "openai/gpt-5.4";
+    readonly envVars: readonly ["NANO_GPT_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "NanoGPT";
+    };
+}, {
+    readonly id: "nvidia";
+    readonly defaultModel: "nvidia/llama-3.1-nemotron-70b-instruct";
+    readonly envVars: readonly ["NVIDIA_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "NVIDIA";
+    };
+}, {
+    readonly id: "ollama";
+    readonly defaultModel: "gpt-oss:20b";
+    readonly envVars: readonly ["OLLAMA_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-responses", unknown>;
+    readonly allowUnauthenticated: true;
+}, {
+    readonly id: "ollama-cloud";
+    readonly defaultModel: "gpt-oss:120b";
+    readonly envVars: readonly ["OLLAMA_CLOUD_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"ollama-chat", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "Ollama Cloud";
+        readonly oauthProvider: "ollama-cloud";
+    };
+}, {
+    readonly id: "openai";
+    readonly defaultModel: "gpt-5.4";
+    readonly envVars: readonly ["OPENAI_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-responses", unknown>;
+}, {
+    readonly id: "openai-codex";
+    readonly defaultModel: "gpt-5.4";
+    readonly envVars: readonly ["OPENAI_CODEX_OAUTH_TOKEN"];
+    readonly specialModelManager: true;
+}, {
+    readonly id: "opencode-go";
+    readonly defaultModel: "kimi-k2.5";
+    readonly envVars: readonly ["OPENCODE_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<import("..").Api, unknown>;
+}, {
+    readonly id: "opencode-zen";
+    readonly defaultModel: "claude-sonnet-4-6";
+    readonly envVars: readonly ["OPENCODE_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<import("..").Api, unknown>;
+}, {
+    readonly id: "openrouter";
+    readonly defaultModel: "openai/gpt-5.4";
+    readonly envVars: readonly ["OPENROUTER_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "OpenRouter";
+        readonly allowUnauthenticated: true;
+    };
+}, {
+    readonly id: "qianfan";
+    readonly defaultModel: "deepseek-v3.2";
+    readonly envVars: readonly ["QIANFAN_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "Qianfan";
+    };
+}, {
+    readonly id: "qwen-portal";
+    readonly defaultModel: "coder-model";
+    readonly envVars: readonly ["QWEN_OAUTH_TOKEN", "QWEN_PORTAL_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "Qwen Portal";
+        readonly oauthProvider: "qwen-portal";
+    };
+}, {
+    readonly id: "synthetic";
+    readonly defaultModel: "hf:zai-org/GLM-5.1";
+    readonly envVars: readonly ["SYNTHETIC_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly dynamicModelsAuthoritative: true;
+    readonly catalogDiscovery: {
+        readonly label: "Synthetic";
+    };
+}, {
+    readonly id: "together";
+    readonly defaultModel: "moonshotai/Kimi-K2.5";
+    readonly envVars: readonly ["TOGETHER_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "Together";
+    };
+}, {
+    readonly id: "venice";
+    readonly defaultModel: "llama-3.3-70b";
+    readonly envVars: readonly ["VENICE_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "Venice";
+        readonly allowUnauthenticated: true;
+    };
+}, {
+    readonly id: "vercel-ai-gateway";
+    readonly defaultModel: "anthropic/claude-sonnet-4-6";
+    readonly envVars: readonly ["AI_GATEWAY_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"anthropic-messages", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "Vercel AI Gateway";
+        readonly envVars: readonly ["VERCEL_AI_GATEWAY_API_KEY"];
+        readonly allowUnauthenticated: true;
+    };
+}, {
+    readonly id: "vllm";
+    readonly defaultModel: "gpt-oss-20b";
+    readonly envVars: readonly ["VLLM_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "vLLM";
+        readonly allowUnauthenticated: true;
+    };
+}, {
+    readonly id: "wafer-pass";
+    readonly defaultModel: "GLM-5.1";
+    readonly envVars: readonly ["WAFER_PASS_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "Wafer Pass";
+        readonly oauthProvider: "wafer-pass";
+    };
+}, {
+    readonly id: "wafer-serverless";
+    readonly defaultModel: "GLM-5.1";
+    readonly envVars: readonly ["WAFER_SERVERLESS_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "Wafer Serverless";
+        readonly oauthProvider: "wafer-serverless";
+    };
+}, {
+    readonly id: "xai";
+    readonly defaultModel: "grok-4-fast-non-reasoning";
+    readonly envVars: readonly ["XAI_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+}, {
+    readonly id: "xai-oauth";
+    readonly defaultModel: "grok-4.3";
+    readonly envVars: readonly ["XAI_OAUTH_TOKEN", "XAI_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-responses", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "xAI Grok OAuth (SuperGrok)";
+        readonly oauthProvider: "xai-oauth";
+    };
+}, {
+    readonly id: "xiaomi";
+    readonly defaultModel: "mimo-v2-flash";
+    readonly envVars: readonly ["XIAOMI_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "Xiaomi";
+    };
+}, {
+    readonly id: "xiaomi-token-plan-ams";
+    readonly defaultModel: "mimo-v2.5";
+    readonly envVars: readonly ["XIAOMI_TOKEN_PLAN_AMS_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+}, {
+    readonly id: "xiaomi-token-plan-cn";
+    readonly defaultModel: "mimo-v2.5";
+    readonly envVars: readonly ["XIAOMI_TOKEN_PLAN_CN_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+}, {
+    readonly id: "xiaomi-token-plan-sgp";
+    readonly defaultModel: "mimo-v2.5";
+    readonly envVars: readonly ["XIAOMI_TOKEN_PLAN_SGP_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+}, {
+    readonly id: "zai";
+    readonly defaultModel: "glm-5.1";
+    readonly envVars: readonly ["ZAI_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"anthropic-messages", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "zAI";
+    };
+}, {
+    readonly id: "zenmux";
+    readonly defaultModel: "anthropic/claude-opus-4.6";
+    readonly envVars: readonly ["ZENMUX_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<import("..").Api, unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "ZenMux";
+    };
+}, {
+    readonly id: "zhipu-coding-plan";
+    readonly defaultModel: "glm-5.1";
+    readonly envVars: readonly ["ZHIPU_API_KEY"];
+    readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"openai-completions", unknown>;
+    readonly catalogDiscovery: {
+        readonly label: "Zhipu Coding Plan";
+    };
+}];
+/** Chat-model providers — every entry in the catalog table. */
+export type KnownProvider = (typeof CATALOG_PROVIDERS)[number]["id"];
+export declare const PROVIDER_DESCRIPTORS: readonly ProviderDescriptor[];
+/** Default model IDs for all known providers, derived from the catalog table. */
+export declare const DEFAULT_MODEL_PER_PROVIDER: Record<KnownProvider, string>;
+export declare function getCatalogProviderEntry(id: string): ProviderCatalogEntry | undefined;

package/dist/types/provider-models/discovery-constants.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Fallback context-window / max-output-token values for models discovered
+ * without limit metadata.
+ *
+ * Kept in a dependency-free leaf module (rather than `openai-compat.ts`) so the
+ * model-discovery helpers in `utils/discovery/*` can import them without pulling
+ * the package root barrel (`@oh-my-pi/pi-ai`) into the model-manager init graph,
+ * which would otherwise form an import cycle through the provider registry.
+ */
+export declare const UNK_CONTEXT_WINDOW = 222222;
+export declare const UNK_MAX_TOKENS = 8888;

package/dist/types/provider-models/google.d.ts

@@ -0,0 +1,27 @@
+import type { ModelManagerOptions } from "../model-manager";
+import type { FetchImpl } from "../types";
+export interface GoogleModelManagerConfig {
+    apiKey?: string;
+    fetch?: FetchImpl;
+}
+export interface GoogleVertexModelManagerConfig {
+    apiKey?: string;
+    project?: string;
+    location?: string;
+    signal?: AbortSignal;
+    fetch?: FetchImpl;
+}
+export interface GoogleAntigravityModelManagerConfig {
+    oauthToken?: string;
+    endpoint?: string;
+    fetch?: FetchImpl;
+}
+export interface GoogleGeminiCliModelManagerConfig {
+    oauthToken?: string;
+    endpoint?: string;
+    fetch?: FetchImpl;
+}
+export declare function googleModelManagerOptions(config?: GoogleModelManagerConfig): ModelManagerOptions<"google-generative-ai">;
+export declare function googleVertexModelManagerOptions(_config?: GoogleVertexModelManagerConfig): ModelManagerOptions;
+export declare function googleAntigravityModelManagerOptions(config?: GoogleAntigravityModelManagerConfig): ModelManagerOptions<"google-gemini-cli">;
+export declare function googleGeminiCliModelManagerOptions(config?: GoogleGeminiCliModelManagerConfig): ModelManagerOptions<"google-gemini-cli">;

package/dist/types/provider-models/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./descriptor-types";
+export * from "./descriptors";
+export * from "./google";
+export * from "./ollama";
+export * from "./openai-compat";
+export * from "./special";

package/dist/types/provider-models/ollama.d.ts

@@ -0,0 +1,9 @@
+import type { ModelManagerOptions } from "../model-manager";
+import type { FetchImpl } from "../types";
+export interface OllamaCloudModelManagerConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    fetch?: FetchImpl;
+}
+export declare function normalizeOllamaCloudBaseUrl(baseUrl?: string): string;
+export declare function ollamaCloudModelManagerOptions(config?: OllamaCloudModelManagerConfig): ModelManagerOptions<"ollama-chat">;