@sctg/cline-llms 3.84.0-beta.20260524130712

package/README.md

@@ -0,0 +1,227 @@
+# [experimental] @cline/llms
+
+`@cline/llms` is the model and provider layer for the Cline SDK. It gives
+you typed provider settings, model catalogs, shared gateway contracts, and
+AI SDK-backed handler creation for supported LLM backends.
+
+## What You Get
+
+- `@cline/llms/runtime` for declarative config and runtime registry creation
+- `@cline/llms/providers` for handler creation and provider settings/types
+- `@cline/llms/models` for model catalogs and query helpers
+- `@cline/llms` root exports for the gateway registry and shared llm contracts
+
+## Installation
+
+```bash
+npm install @cline/llms zod
+```
+
+## Quick Start
+
+```ts
+import { createHandler } from "@cline/llms";
+
+const handler = createHandler({
+	providerId: "anthropic",
+	apiKey: process.env.ANTHROPIC_API_KEY ?? "",
+	modelId: "claude-sonnet-4-6",
+});
+
+for await (const chunk of handler.createMessage("You are a concise assistant.", [
+	{ role: "user", content: [{ type: "text", text: "Say hello." }] },
+])) {
+	console.log(chunk);
+}
+```
+
+## Main APIs
+
+### Runtime
+
+Use `createLlmsRuntime(...)` when you want a small registry around:
+
+- configured providers and their default models
+- builtin provider discovery via `getBuiltInProviders()`
+- custom provider registration via `registerBuiltinProvider(...)`
+- handler creation for builtin or custom providers
+
+Preferred import:
+
+```ts
+import { createLlmsRuntime, defineLlmsConfig } from "@cline/llms/runtime";
+```
+
+### Providers
+
+Use `@cline/llms/providers` for:
+
+- `createHandler(...)` and `createHandlerAsync(...)`
+- `ProviderSettings` and `ProviderSettingsSchema`
+- `ProviderConfig`
+- `Message` and `ApiStreamChunk`
+
+Built-in providers are routed through the internal gateway registry and backed by
+AI SDK provider implementations. Shared gateway contracts are exported from both
+`@cline/llms` and `@cline/shared`.
+
+### Models
+
+Use `@cline/llms/models` when you need generated provider/model metadata for
+selection UIs, defaults, or validation.
+
+For generated catalog field semantics and token-limit behavior, see
+[`src/catalog/README.md`](./src/catalog/README.md).
+
+## Entry Points
+
+- `@cline/llms`: runtime-focused convenience entrypoint
+- `@cline/llms/node`: explicit Node/runtime entrypoint
+- `@cline/llms/browser`: browser-safe bundle
+- `@cline/llms/runtime`: focused runtime entrypoint
+- `@cline/llms/models`: model catalog/query entrypoint
+- `@cline/llms/providers`: provider handler/settings entrypoint
+
+## Related Packages
+
+- `@cline/agents`: agent loop and tool execution
+- `@cline/core`: stateful runtime assembly and provider settings storage
+
+## More Examples
+
+- Workspace overview: [README.md](https://github.com/cline/cline/blob/main/README.md)
+- API and architecture references: [DOC.md](https://github.com/cline/cline/blob/main/DOC.md), [ARCHITECTURE.md](https://github.com/cline/cline/blob/main/ARCHITECTURE.md)
+
+## Live Provider Smoke Test
+
+Use this for API-key-backed provider validation against real endpoints.
+
+1. Ensure provider keys are present in your environment (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GEMINI_API_KEY`, `CLINE_API_KEY`, etc.).
+2. Use the sample config at `packages/llms/src/tests/live-providers.example.json` as the providers list.
+3. Run:
+
+```bash
+LLMS_LIVE_TESTS=1 \
+LLMS_LIVE_PROVIDERS_PATH=/absolute/path/to/packages/llms/src/tests/live-providers.example.json \
+bun -F @cline/llms run test:live
+```
+
+Reasoning-focused live run (same command, different flags):
+
+```bash
+LLMS_LIVE_REASONING_TESTS=1 \
+LLMS_LIVE_REASONING_PROVIDERS_PATH=/absolute/path/to/packages/llms/src/tests/live-providers.reasoning.example.json \
+bun -F @cline/llms run test:live
+```
+
+Tool-use-focused live run (same command, different flags):
+
+```bash
+LLMS_LIVE_TOOL_TESTS=1 \
+LLMS_LIVE_TOOL_PROVIDERS_PATH=/absolute/path/to/packages/llms/src/tests/live-providers.tools.example.json \
+bun -F @cline/llms run test:live
+```
+
+Optional:
+
+- `LLMS_LIVE_PROVIDER_TIMEOUT_MS=120000` to increase per-provider timeout.
+- `LLMS_LIVE_PROVIDER_RETRIES=2` to retry transient upstream/provider failures per provider (total attempts = retries + 1).
+- `LLMS_LIVE_PROVIDER_CONCURRENCY=3` to run multiple provider entries in parallel. Defaults to `3`; lower it if you need stricter provider rate-limit behavior.
+- Point `LLMS_LIVE_PROVIDERS_PATH` to a custom file if you want a narrower provider set.
+- Point `LLMS_LIVE_REASONING_PROVIDERS_PATH` to a custom file for reasoning-enabled suites.
+- Point `LLMS_LIVE_TOOL_PROVIDERS_PATH` to a custom file for tool-use suites.
+- Use `apiKeyEnv`, `baseUrlEnv`, and `headersEnv` in a provider entry when a live config needs secrets without writing them to JSON.
+- When recording provider cassettes for committed replay tests, set `CLINE_VCR=record` and `CLINE_VCR_INCLUDE_REQUEST_BODY=1` so playback also verifies the sanitized request body contract.
+
+OpenAI Codex subscription live runs use the saved OAuth credentials from `~/.cline/data/settings/providers.json` after `cline auth --provider openai-codex`. Point the plain or reasoning suite at `packages/llms/src/tests/live-providers.openai-codex.example.json` or `packages/llms/src/tests/live-providers.openai-codex.reasoning.example.json`.
+
+Per-provider live assertions are configured in the JSON via `expectations`:
+
+- `requireUsage`: fail if no `usage` chunk is emitted (defaults to `true`; set to `false` to opt out).
+- `requireCacheReadTokens`: fail unless `cacheReadTokens > 0` (auto-runs at least 2 attempts with a long cache probe prompt if no prompt override is provided).
+- `minCacheReadTokens`: stricter cache floor check.
+- `requireReasoningChunk`: fail unless at least one reasoning chunk is emitted.
+- `requireNoReasoningChunk`: fail if any reasoning chunk is emitted.
+- `minInputTokens` / `minOutputTokens`: enforce lower bounds.
+- `requireToolCall`: fail unless at least one `tool_calls` chunk is emitted.
+
+In reasoning suites, set `requireReasoningSignal: true` to require either a reasoning chunk or `thoughtsTokenCount > 0` (provider-dependent; can be flaky on some endpoints).
+To check that disabling reasoning actually suppresses reasoning output across models, use `packages/llms/src/tests/live-providers.reasoning-disabled.example.json`; it covers direct and routed provider paths across `cline`, `openai`, `openrouter`, `anthropic`, `gemini`, `vercel-ai-gateway`, `zai`, and `deepseek` where model support exists, with `reasoning.enabled: false` and `requireNoReasoningChunk: true`.
+
+Common live failure classes:
+
+- `Overloaded`: provider/model capacity issue or transient upstream saturation.
+- `Insufficient Balance`: the provider account needs funds.
+- `Model Not Exist`: the model id is not available for that provider/account.
+- assertion failures such as `expected no reasoning chunks`: likely real SDK/provider-option behavior regressions.
+
+### Adding A Model To Live Tests
+
+Add a new entry under the `providers` object in either config file:
+
+- Cache/smoke suite: `packages/llms/src/tests/live-providers.example.json`
+- Reasoning suite: `packages/llms/src/tests/live-providers.reasoning.example.json`
+- Reasoning-disabled suite (asserts no reasoning chunks when reasoning is off): `packages/llms/src/tests/live-providers.reasoning-disabled.example.json`
+- Tool-use suite: `packages/llms/src/tests/live-providers.tools.example.json`
+
+Minimal smoke/cache entry:
+
+```json
+"my-openai-model": {
+  "settings": {
+    "provider": "openai",
+    "model": "gpt-5.4"
+  },
+  "expectations": {
+    "requireUsage": true
+  }
+}
+```
+
+Cache-asserted entry (auto-enforces multi-run cache probe):
+
+```json
+"my-cache-model": {
+  "settings": {
+    "provider": "openai",
+    "model": "gpt-5.4"
+  },
+  "expectations": {
+    "requireUsage": true,
+    "requireCacheReadTokens": true
+  }
+}
+```
+
+Reasoning entry:
+
+```json
+"my-reasoning-model": {
+  "settings": {
+    "provider": "anthropic",
+    "model": "claude-sonnet-4-6",
+    "reasoning": {
+      "effort": "high"
+    }
+  },
+  "expectations": {
+    "requireUsage": true,
+    "requireReasoningChunk": true
+  }
+}
+```
+
+Tool-use entry:
+
+```json
+"my-tools-model": {
+  "settings": {
+    "provider": "openai",
+    "model": "gpt-5.4"
+  },
+  "expectations": {
+    "requireUsage": true,
+    "requireToolCall": true
+  }
+}
+```

package/dist/catalog/catalog-live.d.ts

@@ -0,0 +1,36 @@
+import type { ModelInfo } from "./types";
+export interface ModelsDevModel {
+    name?: string;
+    tool_call?: boolean;
+    reasoning?: boolean;
+    structured_output?: boolean;
+    temperature?: boolean;
+    release_date?: string;
+    family?: string;
+    limit?: {
+        context?: number;
+        input?: number;
+        output?: number;
+    };
+    cost?: {
+        input?: number;
+        output?: number;
+        cache_read?: number;
+        cache_write?: number;
+    };
+    modalities?: {
+        input?: string[];
+    };
+    status?: string;
+}
+interface ModelsDevProviderPayload {
+    models?: Record<string, ModelsDevModel>;
+}
+export type ModelsDevPayload = Record<string, ModelsDevProviderPayload>;
+export type ModelsDevProviderKeyMap = Record<string, string>;
+export declare function sortModelsByReleaseDate(models: Record<string, ModelInfo>): Record<string, ModelInfo>;
+export declare function resolveMaxInputTokens(limit: ModelsDevModel["limit"] | undefined): number;
+export declare function normalizeModelsDevProviderModels(payload: ModelsDevPayload): Record<string, Record<string, ModelInfo>>;
+export declare function fetchModelsDevProviderModels(url: string, fetcher?: typeof fetch): Promise<Record<string, Record<string, ModelInfo>>>;
+export {};
+//# sourceMappingURL=catalog-live.d.ts.map

package/dist/catalog/catalog-live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-live.d.ts","sourceRoot":"","sources":["../../src/catalog/catalog-live.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,WAAW,cAAc;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,IAAI,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,UAAU,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,wBAAwB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACxC;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;AACxE,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAc7D,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAW3B;AA2CD,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,SAAS,GACxC,MAAM,CAOR;AA+BD,wBAAgB,gCAAgC,CAC/C,OAAO,EAAE,gBAAgB,GACvB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAyB3C;AAED,wBAAsB,4BAA4B,CACjD,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,OAAO,KAAa,GAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAUpD"}

package/dist/catalog/catalog.generated-access.d.ts

@@ -0,0 +1,5 @@
+import type { ModelInfo } from "./types";
+export declare function getGeneratedProviderModels(): Record<string, Record<string, ModelInfo>>;
+export declare function getGeneratedModelsVersion(): number;
+export declare function getGeneratedModelsForProvider(providerId: string): Record<string, ModelInfo>;
+//# sourceMappingURL=catalog.generated-access.d.ts.map

package/dist/catalog/catalog.generated-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.generated-access.d.ts","sourceRoot":"","sources":["../../src/catalog/catalog.generated-access.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAUzC,wBAAgB,0BAA0B,IAAI,MAAM,CACnD,MAAM,EACN,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CACzB,CAOA;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED,wBAAgB,6BAA6B,CAC5C,UAAU,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAU3B"}

package/dist/catalog/catalog.generated.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Auto-generated model catalog.
+ *
+ * Generated by: @cline/llms/scripts/generate-models.ts
+ *
+ * WARNING: DO NOT EDIT THIS FILE MANUALLY.
+ */
+import type { ModelInfo } from "@cline/shared";
+/**
+ * Model list auto-generated for built-in providers
+ * listed in @cline/llms/src/providers/provider-keys.ts
+ */
+export declare const GENERATED_PROVIDER_MODELS: {
+    version: number;
+    providers: Record<string, Record<string, ModelInfo>>;
+};
+//# sourceMappingURL=catalog.generated.d.ts.map

package/dist/catalog/catalog.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.generated.d.ts","sourceRoot":"","sources":["../../src/catalog/catalog.generated.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CA0utBrD,CAAC"}

package/dist/catalog/types.d.ts

@@ -0,0 +1,273 @@
+/**
+ * Model Schema Definitions
+ *
+ * Re-exports model info types from @cline/shared (canonical source)
+ * and defines provider-level schemas local to @cline/llms.
+ */
+import { z } from "zod";
+export { ApiFormat, ApiFormatSchema, type ModelCapability, ModelCapabilitySchema, type ModelInfo, ModelInfoSchema, type ModelMetadata, ModelMetadataSchema, type ModelPricing, ModelPricingSchema, type ModelStatus, ModelStatusSchema, type ThinkingConfig, ThinkingConfigSchema, } from "@cline/shared";
+import { ProviderCapabilitySchema } from "@cline/shared";
+export declare const ModelEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    info: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+        contextWindow: z.ZodOptional<z.ZodNumber>;
+        maxInputTokens: z.ZodOptional<z.ZodNumber>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            images: "images";
+            tools: "tools";
+            streaming: "streaming";
+            "prompt-cache": "prompt-cache";
+            reasoning: "reasoning";
+            "reasoning-effort": "reasoning-effort";
+            "computer-use": "computer-use";
+            "global-endpoint": "global-endpoint";
+            structured_output: "structured_output";
+            temperature: "temperature";
+            files: "files";
+        }>>>;
+        apiFormat: z.ZodOptional<z.ZodEnum<{
+            default: "default";
+            "openai-responses": "openai-responses";
+            r1: "r1";
+        }>>;
+        systemRole: z.ZodOptional<z.ZodEnum<{
+            system: "system";
+            developer: "developer";
+        }>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        pricing: z.ZodOptional<z.ZodObject<{
+            input: z.ZodOptional<z.ZodNumber>;
+            output: z.ZodOptional<z.ZodNumber>;
+            cacheWrite: z.ZodOptional<z.ZodNumber>;
+            cacheRead: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        thinkingConfig: z.ZodOptional<z.ZodObject<{
+            maxBudget: z.ZodOptional<z.ZodNumber>;
+            outputPrice: z.ZodOptional<z.ZodNumber>;
+            thinkingLevel: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                high: "high";
+            }>>;
+        }, z.core.$strip>>;
+        status: z.ZodOptional<z.ZodEnum<{
+            active: "active";
+            preview: "preview";
+            deprecated: "deprecated";
+            legacy: "legacy";
+        }>>;
+        deprecationNotice: z.ZodOptional<z.ZodString>;
+        replacedBy: z.ZodOptional<z.ZodString>;
+        releaseDate: z.ZodOptional<z.ZodString>;
+        deprecationDate: z.ZodOptional<z.ZodString>;
+        family: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodObject<{
+            reasoningDefaultOn: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$catchall<z.ZodUnknown>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ModelEntry = z.infer<typeof ModelEntrySchema>;
+export type ProviderCapability = z.infer<typeof ProviderCapabilitySchema>;
+export declare const ProviderProtocolSchema: z.ZodEnum<{
+    "openai-responses": "openai-responses";
+    anthropic: "anthropic";
+    gemini: "gemini";
+    "openai-chat": "openai-chat";
+    "openai-r1": "openai-r1";
+    "ai-sdk": "ai-sdk";
+}>;
+declare const ProviderClientSchema: z.ZodEnum<{
+    anthropic: "anthropic";
+    bedrock: "bedrock";
+    gemini: "gemini";
+    vertex: "vertex";
+    openai: "openai";
+    "openai-r1": "openai-r1";
+    "ai-sdk": "ai-sdk";
+    "ai-sdk-community": "ai-sdk-community";
+    "openai-compatible": "openai-compatible";
+    custom: "custom";
+    fetch: "fetch";
+}>;
+/**
+ * ProviderSource indicates how a provider was added to the system,
+ * which can be useful for determining trust level and whether to prompt the user for confirmation before using it.
+ * For example, providers with source "system" are built-in and can be trusted,
+ * while providers with source "file" were added by the user using a local JSON file,
+ * and providers with source "discovery" were found through network discovery.
+ */
+declare const ProviderSourceSchema: z.ZodEnum<{
+    system: "system";
+    file: "file";
+    discovery: "discovery";
+}>;
+export type ProviderClient = z.infer<typeof ProviderClientSchema>;
+export type ProviderProtocol = z.infer<typeof ProviderProtocolSchema>;
+export type ProviderSource = z.infer<typeof ProviderSourceSchema>;
+export declare const ProviderInfoSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    protocol: z.ZodOptional<z.ZodEnum<{
+        "openai-responses": "openai-responses";
+        anthropic: "anthropic";
+        gemini: "gemini";
+        "openai-chat": "openai-chat";
+        "openai-r1": "openai-r1";
+        "ai-sdk": "ai-sdk";
+    }>>;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    modelsSourceUrl: z.ZodOptional<z.ZodString>;
+    defaultModelId: z.ZodString;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        tools: "tools";
+        streaming: "streaming";
+        "prompt-cache": "prompt-cache";
+        reasoning: "reasoning";
+        "computer-use": "computer-use";
+        temperature: "temperature";
+        files: "files";
+        "provider-tools": "provider-tools";
+        oauth: "oauth";
+        vision: "vision";
+        "local-auth": "local-auth";
+        popular: "popular";
+    }>>>;
+    env: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    client: z.ZodEnum<{
+        anthropic: "anthropic";
+        bedrock: "bedrock";
+        gemini: "gemini";
+        vertex: "vertex";
+        openai: "openai";
+        "openai-r1": "openai-r1";
+        "ai-sdk": "ai-sdk";
+        "ai-sdk-community": "ai-sdk-community";
+        "openai-compatible": "openai-compatible";
+        custom: "custom";
+        fetch: "fetch";
+    }>;
+    source: z.ZodDefault<z.ZodEnum<{
+        system: "system";
+        file: "file";
+        discovery: "discovery";
+    }>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type ProviderInfo = z.infer<typeof ProviderInfoSchema>;
+export declare const ModelCollectionSchema: z.ZodObject<{
+    provider: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        protocol: z.ZodOptional<z.ZodEnum<{
+            "openai-responses": "openai-responses";
+            anthropic: "anthropic";
+            gemini: "gemini";
+            "openai-chat": "openai-chat";
+            "openai-r1": "openai-r1";
+            "ai-sdk": "ai-sdk";
+        }>>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        modelsSourceUrl: z.ZodOptional<z.ZodString>;
+        defaultModelId: z.ZodString;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            tools: "tools";
+            streaming: "streaming";
+            "prompt-cache": "prompt-cache";
+            reasoning: "reasoning";
+            "computer-use": "computer-use";
+            temperature: "temperature";
+            files: "files";
+            "provider-tools": "provider-tools";
+            oauth: "oauth";
+            vision: "vision";
+            "local-auth": "local-auth";
+            popular: "popular";
+        }>>>;
+        env: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        client: z.ZodEnum<{
+            anthropic: "anthropic";
+            bedrock: "bedrock";
+            gemini: "gemini";
+            vertex: "vertex";
+            openai: "openai";
+            "openai-r1": "openai-r1";
+            "ai-sdk": "ai-sdk";
+            "ai-sdk-community": "ai-sdk-community";
+            "openai-compatible": "openai-compatible";
+            custom: "custom";
+            fetch: "fetch";
+        }>;
+        source: z.ZodDefault<z.ZodEnum<{
+            system: "system";
+            file: "file";
+            discovery: "discovery";
+        }>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    models: z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+        contextWindow: z.ZodOptional<z.ZodNumber>;
+        maxInputTokens: z.ZodOptional<z.ZodNumber>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            images: "images";
+            tools: "tools";
+            streaming: "streaming";
+            "prompt-cache": "prompt-cache";
+            reasoning: "reasoning";
+            "reasoning-effort": "reasoning-effort";
+            "computer-use": "computer-use";
+            "global-endpoint": "global-endpoint";
+            structured_output: "structured_output";
+            temperature: "temperature";
+            files: "files";
+        }>>>;
+        apiFormat: z.ZodOptional<z.ZodEnum<{
+            default: "default";
+            "openai-responses": "openai-responses";
+            r1: "r1";
+        }>>;
+        systemRole: z.ZodOptional<z.ZodEnum<{
+            system: "system";
+            developer: "developer";
+        }>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        pricing: z.ZodOptional<z.ZodObject<{
+            input: z.ZodOptional<z.ZodNumber>;
+            output: z.ZodOptional<z.ZodNumber>;
+            cacheWrite: z.ZodOptional<z.ZodNumber>;
+            cacheRead: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        thinkingConfig: z.ZodOptional<z.ZodObject<{
+            maxBudget: z.ZodOptional<z.ZodNumber>;
+            outputPrice: z.ZodOptional<z.ZodNumber>;
+            thinkingLevel: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                high: "high";
+            }>>;
+        }, z.core.$strip>>;
+        status: z.ZodOptional<z.ZodEnum<{
+            active: "active";
+            preview: "preview";
+            deprecated: "deprecated";
+            legacy: "legacy";
+        }>>;
+        deprecationNotice: z.ZodOptional<z.ZodString>;
+        replacedBy: z.ZodOptional<z.ZodString>;
+        releaseDate: z.ZodOptional<z.ZodString>;
+        deprecationDate: z.ZodOptional<z.ZodString>;
+        family: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodObject<{
+            reasoningDefaultOn: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$catchall<z.ZodUnknown>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ModelCollection = z.infer<typeof ModelCollectionSchema>;
+//# sourceMappingURL=types.d.ts.map

package/dist/catalog/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/catalog/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACN,SAAS,EACT,eAAe,EACf,KAAK,eAAe,EACpB,qBAAqB,EACrB,KAAK,SAAS,EACd,eAAe,EACf,KAAK,aAAa,EAClB,mBAAmB,EACnB,KAAK,YAAY,EACjB,kBAAkB,EAClB,KAAK,WAAW,EAChB,iBAAiB,EACjB,KAAK,cAAc,EACnB,oBAAoB,GACpB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAmB,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAE1E,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,sBAAsB;;;;;;;EAOjC,CAAC;AAEH,QAAA,MAAM,oBAAoB;;;;;;;;;;;;EAYxB,CAAC;AAEH;;;;;;GAMG;AACH,QAAA,MAAM,oBAAoB;;;;EAA0C,CAAC;AAErE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAa7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/index.browser.d.ts

@@ -0,0 +1,6 @@
+export type { ModelCollection, ModelInfo, ModelInfo as CatalogModelInfo, ProviderCapability as CatalogProviderCapability, ProviderInfo, } from "./models";
+export { filterOpenAICodexModels, getAllProviders, getGeneratedModelsForProvider, getModelsForProvider, getProvider, getProviderCollection, getProviderCollectionSync, getProviderIds, hasProvider, MODEL_COLLECTIONS_BY_PROVIDER_ID, registerModel, registerProvider, resetRegistry, unregisterProvider, } from "./models";
+export { type ProviderUsageCostDisplay, resolveProviderUsageCostDisplay, shouldShowProviderUsageCost, } from "./providers/billing";
+export type { ProviderCapability, ProviderId, } from "./providers.browser";
+export { normalizeProviderId } from "./providers.browser";
+//# sourceMappingURL=index.browser.d.ts.map

package/dist/index.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,eAAe,EACf,SAAS,EACT,SAAS,IAAI,gBAAgB,EAC7B,kBAAkB,IAAI,yBAAyB,EAC/C,YAAY,GACZ,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,uBAAuB,EACvB,eAAe,EACf,6BAA6B,EAC7B,oBAAoB,EACpB,WAAW,EACX,qBAAqB,EACrB,yBAAyB,EACzB,cAAc,EACd,WAAW,EACX,gCAAgC,EAChC,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,kBAAkB,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,KAAK,wBAAwB,EAC7B,+BAA+B,EAC/B,2BAA2B,GAC3B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACX,kBAAkB,EAClB,UAAU,GACV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}