language-models 2.1.1 → 2.3.0

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> language-models@2.0.3 build /Users/nathanclevenger/projects/primitives.org.ai/packages/language-models
+> language-models@2.3.0 build /Users/nathanclevenger/projects/primitives.org.ai/packages/language-models
 > tsc -p tsconfig.json && cp -r data dist/
 

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # language-models
 
+## 2.3.0
+
+### Minor Changes
+
+- 2787830: Fold llm-pricing primitive into language-models (consolidate accidentally-scoped @primitives/llm-pricing).
+
+  The canonical LLM model pricing table (rates, tiers, context-tier breakpoints, `priceFor()` cost computation) now lives inside `language-models` under `src/pricing/`. Two ways to import:
+
+  - Subpath: `import { priceFor, PRICING_TABLE } from 'language-models/pricing'`
+  - Root: `import { priceFor, PRICING_TABLE } from 'language-models'` (re-exported for convenience)
+
+  The standalone `@primitives/llm-pricing` package is removed — it was accidentally scoped under `@primitives/`, an npm scope we do not own, and was always intended to live alongside the model catalog.
+
+## 2.2.0
+
+### Minor Changes
+
+- Add `ModelPolicy` MDXLD type and per-model policy derivation layer
+  (aip-70mk). `policyFor(alias)` returns derived retry, circuit-breaker,
+  fallback-chain, and batch-tier data for any catalog model. Heuristics
+  encode "frontier providers retry more aggressively", "same-family
+  siblings fall back first, sorted by recency then price", and
+  "OpenAI/Bedrock are flex-eligible". `ai-functions` reads policy via
+  `RetryPolicy.forModel`, `CircuitBreaker.forModel`,
+  `FallbackChain.forModel`.
+
+## 2.1.3
+
+### Patch Changes
+
+- Documentation and testing improvements
+  - Add deterministic AI testing suite with self-validating patterns
+  - Apply StoryBrand narrative to all package READMEs
+  - Update TESTING.md with four principles of deterministic AI testing
+  - Fix duplicate examples package name conflict
+
 ## 2.1.1
 
 ## 2.0.3

package/README.md

@@ -1,79 +1,142 @@
 # language-models
 
-Model listing and resolution for LLM providers. Fetches models from OpenRouter and resolves aliases to full model IDs.
+![Stability: Experimental](https://img.shields.io/badge/stability-experimental-red)
+
+**Stop memorizing model IDs. Start shipping.**
+
+You're building AI-powered applications, but every provider has different naming conventions. Is it `claude-opus-4-5-20251101` or `anthropic/claude-opus-4.5`? Was it `gpt-4o` or `openai/gpt-4o`? You shouldn't have to care.
+
+## The Problem
+
+```typescript
+// Without language-models: fragile, provider-specific, constantly breaking
+const model = 'anthropic/claude-3-opus-20240229' // Wait, is this still current?
+const model = 'claude-opus-4-5-20251101'         // Or was it this format?
+const model = 'anthropic/claude-opus-4.5'        // Which one does OpenRouter want?
+```
+
+## The Solution
+
+```typescript
+// With language-models: simple, memorable, always resolves correctly
+import { resolve } from 'language-models'
+
+resolve('opus')   // 'anthropic/claude-opus-4.5'
+resolve('sonnet') // 'anthropic/claude-sonnet-4.5'
+resolve('gpt')    // 'openai/gpt-4o'
+resolve('llama')  // 'meta-llama/llama-4-maverick'
+```
 
 ## Quick Start
 
+**1. Install**
+```bash
+npm install language-models
+```
+
+**2. Import**
 ```typescript
 import { resolve, list, search } from 'language-models'
+```
 
-// Resolve aliases to full model IDs
-resolve('opus')        // 'anthropic/claude-opus-4.5'
-resolve('gpt-4o')      // 'openai/gpt-4o'
-resolve('llama-70b')   // 'meta-llama/llama-3.3-70b-instruct'
-resolve('mistral')     // 'mistralai/mistral-large-2411'
-
-// List all available models
-const models = list()
+**3. Use**
+```typescript
+// Resolve human-friendly aliases to full model IDs
+const modelId = resolve('opus')
 
-// Search models
+// Search across 200+ models
 const claudeModels = search('claude')
+
+// Get full model catalog with pricing and context info
+const allModels = list()
 ```
 
-## API
+## API Reference
 
 ### `resolve(input: string): string`
 
-Resolve an alias or partial name to a full model ID.
+Resolve an alias or partial name to a full OpenRouter model ID.
 
 ```typescript
 resolve('opus')                      // 'anthropic/claude-opus-4.5'
 resolve('sonnet')                    // 'anthropic/claude-sonnet-4.5'
 resolve('gpt')                       // 'openai/gpt-4o'
 resolve('llama')                     // 'meta-llama/llama-4-maverick'
-resolve('anthropic/claude-opus-4.5') // 'anthropic/claude-opus-4.5' (pass-through)
+resolve('anthropic/claude-opus-4.5') // Pass-through for full IDs
+```
+
+### `resolveWithProvider(input: string): ResolvedModel`
+
+Get full routing information including provider details for direct SDK access.
+
+```typescript
+const info = resolveWithProvider('opus')
+// {
+//   id: 'anthropic/claude-opus-4.5',
+//   provider: 'anthropic',
+//   providerModelId: 'claude-opus-4-5-20251101',
+//   supportsDirectRouting: true,
+//   model: { name, pricing, context_length, ... }
+// }
 ```
 
 ### `list(): ModelInfo[]`
 
-List all available models from OpenRouter.
+Get the complete model catalog with pricing, context lengths, and capabilities.
 
 ### `get(id: string): ModelInfo | undefined`
 
-Get a model by exact ID.
+Fetch a specific model by exact ID.
 
 ### `search(query: string): ModelInfo[]`
 
-Search models by ID or name.
-
-## Available Aliases
-
-| Alias | Model ID |
-|-------|----------|
-| `opus` | anthropic/claude-opus-4.5 |
-| `sonnet` | anthropic/claude-sonnet-4.5 |
-| `haiku` | anthropic/claude-haiku-4.5 |
-| `claude` | anthropic/claude-sonnet-4.5 |
-| `gpt`, `gpt-4o`, `4o` | openai/gpt-4o |
-| `o1`, `o3`, `o3-mini` | openai/o1, openai/o3, openai/o3-mini |
-| `gemini`, `flash` | google/gemini-2.5-flash |
-| `gemini-pro` | google/gemini-2.5-pro |
-| `llama`, `llama-4` | meta-llama/llama-4-maverick |
-| `llama-70b` | meta-llama/llama-3.3-70b-instruct |
-| `mistral` | mistralai/mistral-large-2411 |
-| `codestral` | mistralai/codestral-2501 |
-| `deepseek` | deepseek/deepseek-chat |
-| `r1` | deepseek/deepseek-r1 |
-| `qwen` | qwen/qwen3-235b-a22b |
-| `grok` | x-ai/grok-3 |
-| `sonar` | perplexity/sonar-pro |
-
-## Updating Models
-
-Fetch the latest models from OpenRouter:
+Find models matching a search query across IDs and names.
+
+## Supported Aliases
+
+| You type | You get |
+|----------|---------|
+| `opus` | `anthropic/claude-opus-4.5` |
+| `sonnet` | `anthropic/claude-sonnet-4.5` |
+| `haiku` | `anthropic/claude-haiku-4.5` |
+| `gpt`, `gpt-4o`, `4o` | `openai/gpt-4o` |
+| `o1`, `o3`, `o3-mini` | `openai/o1`, `openai/o3`, `openai/o3-mini` |
+| `gemini`, `flash` | `google/gemini-2.5-flash` |
+| `gemini-pro` | `google/gemini-2.5-pro` |
+| `llama`, `llama-4` | `meta-llama/llama-4-maverick` |
+| `llama-70b` | `meta-llama/llama-3.3-70b-instruct` |
+| `mistral` | `mistralai/mistral-large-2411` |
+| `codestral` | `mistralai/codestral-2501` |
+| `deepseek` | `deepseek/deepseek-chat` |
+| `r1` | `deepseek/deepseek-r1` |
+| `qwen` | `qwen/qwen3-235b-a22b` |
+| `grok` | `x-ai/grok-3` |
+| `sonar` | `perplexity/sonar-pro` |
+
+## Direct Provider Routing
+
+For providers that support direct SDK access (Anthropic, OpenAI, Google), use `resolveWithProvider` to get the native model ID:
+
+```typescript
+import { resolveWithProvider, DIRECT_PROVIDERS } from 'language-models'
+
+const { provider, providerModelId, supportsDirectRouting } = resolveWithProvider('opus')
+
+if (supportsDirectRouting) {
+  // Use native SDK with providerModelId
+} else {
+  // Route through OpenRouter
+}
+```
+
+## Updating the Model Catalog
 
 ```bash
 pnpm fetch-models
 ```
 
-This updates `data/models.json` with all available models.
+Fetches the latest models from OpenRouter and updates `data/models.json`.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -5,6 +5,8 @@
  *
  * @packageDocumentation
  */
-export { resolve, resolveWithProvider, list, get, search, DIRECT_PROVIDERS, type ModelInfo, type ProviderEndpoint, type ResolvedModel, type DirectProvider } from './models.js';
+export { resolve, resolveWithProvider, list, get, search, DIRECT_PROVIDERS, type ModelInfo, type ProviderEndpoint, type ResolvedModel, type DirectProvider, } from './models.js';
 export { ALIASES } from './aliases.js';
+export { policyFor, derivePolicy, defaultPolicy, resetPolicyCache, listAliases, DEFAULT_RETRY, DEFAULT_CIRCUIT_BREAKER, type ModelPolicy, type RetryPolicyData, type CircuitBreakerPolicyData, type BatchTier, type ErrorCategoryName, type ErrorMapping, } from './policy.js';
+export { PRICING_TABLE, priceFor, listSlugs, hasPricing, rowsForSlug, type ModelPricing, type PricingTier, type Provider, type RateBlock, type PriceForArgs, type PriceForResult, type HasPricingArgs, } from './pricing/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,OAAO,EACP,mBAAmB,EACnB,IAAI,EACJ,GAAG,EACH,MAAM,EACN,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,OAAO,EACP,mBAAmB,EACnB,IAAI,EACJ,GAAG,EACH,MAAM,EACN,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAOtC,OAAO,EACL,SAAS,EACT,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,uBAAuB,EACvB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAA;AAOpB,OAAO,EACL,aAAa,EACb,QAAQ,EACR,SAAS,EACT,UAAU,EACV,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -5,6 +5,18 @@
  *
  * @packageDocumentation
  */
-export { resolve, resolveWithProvider, list, get, search, DIRECT_PROVIDERS } from './models.js';
+export { resolve, resolveWithProvider, list, get, search, DIRECT_PROVIDERS, } from './models.js';
 export { ALIASES } from './aliases.js';
+// Per-model resilience and tier policy data.
+// The runtime *machinery* (RetryPolicy, CircuitBreaker, FallbackChain) lives
+// in `ai-functions`; the *data* (which categories are retryable, which models
+// to fall back to, which batch tiers are eligible) lives here alongside the
+// catalog because it's a per-model concern.
+export { policyFor, derivePolicy, defaultPolicy, resetPolicyCache, listAliases, DEFAULT_RETRY, DEFAULT_CIRCUIT_BREAKER, } from './policy.js';
+// =============================================================================
+// Pricing (consolidated from former @primitives/llm-pricing — see
+// `./pricing/` for the source. Also re-exported under the subpath
+// `language-models/pricing` for surgical imports.)
+// =============================================================================
+export { PRICING_TABLE, priceFor, listSlugs, hasPricing, rowsForSlug, } from './pricing/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,OAAO,EACP,mBAAmB,EACnB,IAAI,EACJ,GAAG,EACH,MAAM,EACN,gBAAgB,EAKjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,OAAO,EACP,mBAAmB,EACnB,IAAI,EACJ,GAAG,EACH,MAAM,EACN,gBAAgB,GAKjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,6CAA6C;AAC7C,6EAA6E;AAC7E,8EAA8E;AAC9E,4EAA4E;AAC5E,4CAA4C;AAC5C,OAAO,EACL,SAAS,EACT,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,uBAAuB,GAOxB,MAAM,aAAa,CAAA;AAEpB,gFAAgF;AAChF,kEAAkE;AAClE,kEAAkE;AAClE,mDAAmD;AACnD,gFAAgF;AAChF,OAAO,EACL,aAAa,EACb,QAAQ,EACR,SAAS,EACT,UAAU,EACV,WAAW,GAQZ,MAAM,oBAAoB,CAAA"}

package/dist/models.d.ts

@@ -64,7 +64,7 @@ export declare function resolve(input: string): string;
  * These providers have special capabilities like MCP, extended thinking, etc.
  */
 export declare const DIRECT_PROVIDERS: readonly ["openai", "anthropic", "google"];
-export type DirectProvider = typeof DIRECT_PROVIDERS[number];
+export type DirectProvider = (typeof DIRECT_PROVIDERS)[number];
 /**
  * Result of resolving a model with provider routing info
  */

package/dist/models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAA;IACf,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAA;QACd,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;IACD,YAAY,CAAC,EAAE;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,gBAAgB,EAAE,MAAM,EAAE,CAAA;QAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAA;KAC5B,CAAA;IACD,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CAC5B;AAeD;;GAEG;AACH,wBAAgB,IAAI,IAAI,SAAS,EAAE,CAElC;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAErD;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,CAMjD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAwB7C;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,4CAA6C,CAAA;AAC1E,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAA;AAE5D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAA;IACV,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,wDAAwD;IACxD,qBAAqB,EAAE,OAAO,CAAA;IAC9B,mCAAmC;IACnC,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAiBhE"}
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAA;IACf,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAA;QACd,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;IACD,YAAY,CAAC,EAAE;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,gBAAgB,EAAE,MAAM,EAAE,CAAA;QAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAA;KAC5B,CAAA;IACD,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CAC5B;AAeD;;GAEG;AACH,wBAAgB,IAAI,IAAI,SAAS,EAAE,CAElC;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAErD;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,CAKjD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAwB7C;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,4CAA6C,CAAA;AAC1E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAA;IACV,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,wDAAwD;IACxD,qBAAqB,EAAE,OAAO,CAAA;IAC9B,mCAAmC;IACnC,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAchE"}

package/dist/models.js

@@ -27,7 +27,7 @@ export function list() {
  * Get a model by exact ID
  */
 export function get(id) {
-    return loadModels().find(m => m.id === id);
+    return loadModels().find((m) => m.id === id);
 }
 /**
  * Search models by query string
@@ -35,8 +35,7 @@ export function get(id) {
  */
 export function search(query) {
     const q = query.toLowerCase();
-    return loadModels().filter(m => m.id.toLowerCase().includes(q) ||
-        m.name.toLowerCase().includes(q));
+    return loadModels().filter((m) => m.id.toLowerCase().includes(q) || m.name.toLowerCase().includes(q));
 }
 /**
  * Resolve a model alias or partial name to a full model ID
@@ -98,12 +97,11 @@ export function resolveWithProvider(input) {
     const slashIndex = id.indexOf('/');
     const provider = slashIndex > 0 ? id.substring(0, slashIndex) : 'unknown';
     const supportsDirectRouting = DIRECT_PROVIDERS.includes(provider);
-    return {
-        id,
-        provider,
-        providerModelId: model?.provider_model_id,
-        supportsDirectRouting,
-        model
-    };
+    const result = { id, provider, supportsDirectRouting };
+    if (model)
+        result.model = model;
+    if (model?.provider_model_id)
+        result.providerModelId = model.provider_model_id;
+    return result;
 }
 //# sourceMappingURL=models.js.map

package/dist/models.js.map

@@ -1 +1 @@
-{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAkC9C,wBAAwB;AACxB,IAAI,WAAW,GAAuB,IAAI,CAAA;AAE1C,SAAS,UAAU;IACjB,IAAI,WAAW;QAAE,OAAO,WAAW,CAAA;IACnC,IAAI,CAAC;QACH,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;QAC5C,OAAO,WAAY,CAAA;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI;IAClB,OAAO,UAAU,EAAE,CAAA;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAAC,EAAU;IAC5B,OAAO,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAA;IAC7B,OAAO,UAAU,EAAE,CAAC,MAAM,CACxB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAC1E,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAA;IAE7C,sBAAsB;IACtB,IAAI,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC,UAAU,CAAC,CAAA;IAC5B,CAAC;IAED,yCAAyC;IACzC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,mCAAmC;QACnC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAA;QACxB,OAAO,KAAK,EAAE,EAAE,IAAI,KAAK,CAAA;IAC3B,CAAC;IAED,4BAA4B;IAC5B,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,CAAA;IAClC,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAC7B,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC,EAAE,CAAA;IACtB,CAAC;IAED,gCAAgC;IAChC,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAU,CAAA;AAmB1E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IACzB,MAAM,KAAK,GAAG,GAAG,CAAC,EAAE,CAAC,CAAA;IAErB,gFAAgF;IAChF,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAClC,MAAM,QAAQ,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAEzE,MAAM,qBAAqB,GAAI,gBAAsC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAExF,MAAM,MAAM,GAAkB,EAAE,EAAE,EAAE,QAAQ,EAAE,qBAAqB,EAAE,CAAA;IACrE,IAAI,KAAK;QAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAA;IAC/B,IAAI,KAAK,EAAE,iBAAiB;QAAE,MAAM,CAAC,eAAe,GAAG,KAAK,CAAC,iBAAiB,CAAA;IAC9E,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/policy.d.ts

@@ -0,0 +1,127 @@
+/**
+ * ModelPolicy - per-model resilience and tier policy data
+ *
+ * `language-models` owns model identity (alias resolution, capability lookup).
+ * Resilience policy (retry, circuit breaker, fallback chain, batch tier) is
+ * a per-model concern that belongs alongside the catalog data — but the
+ * runtime *machinery* that applies the policy lives in `ai-functions`.
+ *
+ * This module provides:
+ * - `ModelPolicy` MDXLD type (`$type: 'ModelPolicy'`)
+ * - `policyFor(alias)` - resolve an alias and return its derived policy
+ * - `derivePolicy(model, alias?)` - inference layer that turns OpenRouter raw
+ *   data into a policy by applying heuristics (newest frontier model is best,
+ *   price within a family is inversely correlated with capability, etc.)
+ *
+ * Source of truth: OpenRouter raw catalog (data/models.json) + heuristics.
+ * Strategy: runtime derivation, cached. A static snapshot generator could be
+ * added later (see `derivePolicy` — it's pure, so you can pre-compute it).
+ *
+ * @packageDocumentation
+ */
+import { type ModelInfo } from './models.js';
+/**
+ * Error category taxonomy. Mirrors `ai-functions`'s `ErrorCategory` enum by
+ * string value — we don't import it (circular), but the strings line up.
+ */
+export type ErrorCategoryName = 'network' | 'rate_limit' | 'invalid_input' | 'authentication' | 'server' | 'context_length' | 'unknown';
+/**
+ * Retry classification: which error categories are retryable for this model,
+ * plus backoff parameters.
+ */
+export interface RetryPolicyData {
+    maxRetries: number;
+    baseDelay: number;
+    maxDelay: number;
+    multiplier: number;
+    jitter: number;
+    /** Categories that should trigger a retry */
+    retryableCategories: ErrorCategoryName[];
+}
+/**
+ * Circuit-breaker policy data (per-model state keys come from the alias).
+ */
+export interface CircuitBreakerPolicyData {
+    failureThreshold: number;
+    resetTimeout: number;
+    successThreshold: number;
+}
+/**
+ * Tiers a model is eligible for.
+ *
+ * - `immediate`: synchronous online inference (always available)
+ * - `flex`: faster-than-batch processing (~minutes, ~50% discount)
+ *   — only OpenAI/Bedrock currently
+ * - `batch`: batch API processing (~hours, ~50% discount)
+ *   — OpenAI/Anthropic/Google/Bedrock/Cloudflare
+ */
+export type BatchTier = 'immediate' | 'flex' | 'batch';
+/**
+ * Provider-specific HTTP status code → ErrorCategory mapping.
+ * Empty here by default — `ai-functions/retry.ts#classifyError` handles the
+ * common cases. Override per-model if a provider has unusual error codes.
+ */
+export type ErrorMapping = Record<number, ErrorCategoryName>;
+/**
+ * MDXLD-shaped per-model resilience and tier policy.
+ *
+ * `$type: 'ModelPolicy'`, `$id` is the resolved model id (e.g.
+ * `'anthropic/claude-opus-4.5'`).
+ */
+export interface ModelPolicy {
+    $type: 'ModelPolicy';
+    $id: string;
+    /** Provider slug (e.g. 'anthropic') */
+    provider: string;
+    retry: RetryPolicyData;
+    circuitBreaker: CircuitBreakerPolicyData;
+    /** Ordered list of model ids to try after this one fails */
+    fallbackChain: string[];
+    /** Tiers this model is eligible for */
+    batchTier: BatchTier[];
+    /** Provider-specific HTTP code → category overrides */
+    errorMapping: ErrorMapping;
+}
+/** Default retry policy — matches `ai-functions` `RetryPolicy` defaults. */
+export declare const DEFAULT_RETRY: RetryPolicyData;
+/** Default circuit breaker — matches `ai-functions` defaults. */
+export declare const DEFAULT_CIRCUIT_BREAKER: CircuitBreakerPolicyData;
+/**
+ * Default policy for an unknown model. Used when no catalog entry is found.
+ */
+export declare function defaultPolicy(modelId: string): ModelPolicy;
+/**
+ * Derivation layer — turn a `ModelInfo` (from OpenRouter raw data) into a
+ * `ModelPolicy` by applying heuristics.
+ *
+ * Pure function; safe to call at build time to pre-compute a static snapshot.
+ *
+ * @param model - The catalog entry for the model.
+ * @param allModels - The full catalog, used for sibling lookup. Optional;
+ *   defaults to `list()`.
+ */
+export declare function derivePolicy(model: ModelInfo, allModels?: ModelInfo[]): ModelPolicy;
+/**
+ * Resolve an alias (or full model id) and return its policy.
+ *
+ * Falls back to `defaultPolicy(id)` if the model is not in the catalog —
+ * callers always get a usable policy.
+ *
+ * @example
+ * ```ts
+ * const p = policyFor('sonnet')
+ * // p.fallbackChain → ['anthropic/claude-opus-4.5', 'openai/gpt-4o', ...]
+ * // p.batchTier     → ['immediate', 'batch']
+ * ```
+ */
+export declare function policyFor(input: string): ModelPolicy;
+/**
+ * Reset the policy cache. Useful for tests, or after the catalog is reloaded.
+ */
+export declare function resetPolicyCache(): void;
+/**
+ * List all known aliases. Convenience for tooling that wants to enumerate
+ * derived policies (e.g. a static snapshot generator).
+ */
+export declare function listAliases(): string[];
+//# sourceMappingURL=policy.d.ts.map

package/dist/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAA;AAOhE;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,YAAY,GACZ,eAAe,GACf,gBAAgB,GAChB,QAAQ,GACR,gBAAgB,GAChB,SAAS,CAAA;AAEb;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,6CAA6C;IAC7C,mBAAmB,EAAE,iBAAiB,EAAE,CAAA;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,EAAE,MAAM,CAAA;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAA;AAEtD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,aAAa,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,eAAe,CAAA;IACtB,cAAc,EAAE,wBAAwB,CAAA;IACxC,4DAA4D;IAC5D,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,uCAAuC;IACvC,SAAS,EAAE,SAAS,EAAE,CAAA;IACtB,uDAAuD;IACvD,YAAY,EAAE,YAAY,CAAA;CAC3B;AAuBD,4EAA4E;AAC5E,eAAO,MAAM,aAAa,EAAE,eAO3B,CAAA;AAED,iEAAiE;AACjE,eAAO,MAAM,uBAAuB,EAAE,wBAIrC,CAAA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAY1D;AAkHD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,WAAW,CAenF;AASD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CASpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC"}