language-models 2.1.3 → 2.4.0

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> language-models@2.1.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,33 @@
 # language-models
 
+## 2.4.0
+
+## 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

package/README.md

@@ -1,5 +1,7 @@
 # language-models
 
+![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.

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":"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"}

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"}

package/dist/policy.js

@@ -0,0 +1,246 @@
+/**
+ * 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 { resolve, get, list } from './models.js';
+import { ALIASES } from './aliases.js';
+// ============================================================================
+// Defaults & heuristics
+// ============================================================================
+/** Frontier labs — newer releases tend to be more capable. */
+const FRONTIER_PROVIDERS = new Set(['anthropic', 'openai', 'google']);
+/** Providers with batch APIs supported by ai-functions. */
+const BATCH_PROVIDERS = new Set(['anthropic', 'openai', 'google', 'amazon-bedrock', 'cloudflare']);
+/** Providers with flex (faster-than-batch) APIs. */
+const FLEX_PROVIDERS = new Set(['openai', 'amazon-bedrock']);
+/** Curated fallback seeds — picked one per frontier family. */
+const FRONTIER_FALLBACK = [
+    'anthropic/claude-sonnet-4.5',
+    'anthropic/claude-opus-4.5',
+    'openai/gpt-4o',
+    'google/gemini-2.5-pro',
+];
+/** Default retry policy — matches `ai-functions` `RetryPolicy` defaults. */
+export const DEFAULT_RETRY = {
+    maxRetries: 3,
+    baseDelay: 1000,
+    maxDelay: 30000,
+    multiplier: 2,
+    jitter: 0,
+    retryableCategories: ['network', 'rate_limit', 'server', 'unknown'],
+};
+/** Default circuit breaker — matches `ai-functions` defaults. */
+export const DEFAULT_CIRCUIT_BREAKER = {
+    failureThreshold: 5,
+    resetTimeout: 30000,
+    successThreshold: 1,
+};
+/**
+ * Default policy for an unknown model. Used when no catalog entry is found.
+ */
+export function defaultPolicy(modelId) {
+    const provider = modelId.includes('/') ? modelId.split('/')[0] : 'unknown';
+    return {
+        $type: 'ModelPolicy',
+        $id: modelId,
+        provider,
+        retry: { ...DEFAULT_RETRY },
+        circuitBreaker: { ...DEFAULT_CIRCUIT_BREAKER },
+        fallbackChain: [],
+        batchTier: ['immediate'],
+        errorMapping: {},
+    };
+}
+// ============================================================================
+// Derivation layer
+// ============================================================================
+/**
+ * Parse a price-per-token string to a number. Returns 0 on parse failure.
+ * Pricing comes through OpenRouter as a string (e.g. "0.000003").
+ */
+function parsePrice(p) {
+    if (!p)
+        return 0;
+    const n = Number(p);
+    return Number.isFinite(n) ? n : 0;
+}
+/**
+ * Extract a "family" key from a model id for fallback grouping.
+ * 'anthropic/claude-opus-4.5' → 'anthropic/claude'
+ * 'openai/gpt-4o-mini' → 'openai/gpt'
+ */
+function familyKey(id) {
+    const slash = id.indexOf('/');
+    if (slash < 0)
+        return id;
+    const provider = id.substring(0, slash);
+    const rest = id.substring(slash + 1).toLowerCase();
+    // Strip trailing version tags / size qualifiers
+    const family = rest
+        .replace(/[-_]?\d.*$/, '') // drop -4.5, -2.0, etc
+        .replace(/(opus|sonnet|haiku|mini|pro|flash|lite|maverick|instruct).*$/, '$1')
+        .replace(/-?(opus|sonnet|haiku|mini|pro|flash|lite|maverick|instruct)$/, '');
+    return `${provider}/${family || rest.split('-')[0]}`;
+}
+/**
+ * Derive the fallback chain for a model.
+ *
+ * Heuristics:
+ * 1. Prefer same-family siblings (e.g. sonnet → opus → haiku within Claude)
+ *    ordered by `created` (newer first), then by price descending (more
+ *    expensive within a family is usually more capable).
+ * 2. Then fall back to frontier-lab seeds, skipping the model itself and
+ *    anything from the same family already included.
+ * 3. Cap at 4 entries to keep latency bounded.
+ */
+function deriveFallbackChain(model, allModels) {
+    const chain = [];
+    const seen = new Set([model.id]);
+    const fam = familyKey(model.id);
+    // Step 1: same-family siblings, sorted newest-first then by price desc.
+    const siblings = allModels
+        .filter((m) => m.id !== model.id && familyKey(m.id) === fam)
+        .map((m) => ({
+        m,
+        created: m.created ?? 0,
+        price: parsePrice(m.pricing?.completion),
+    }))
+        .sort((a, b) => {
+        if (b.created !== a.created)
+            return b.created - a.created;
+        return b.price - a.price;
+    });
+    for (const { m } of siblings.slice(0, 2)) {
+        if (!seen.has(m.id)) {
+            chain.push(m.id);
+            seen.add(m.id);
+        }
+    }
+    // Step 2: frontier seeds.
+    for (const seed of FRONTIER_FALLBACK) {
+        if (chain.length >= 4)
+            break;
+        if (seen.has(seed))
+            continue;
+        if (familyKey(seed) === fam)
+            continue;
+        chain.push(seed);
+        seen.add(seed);
+    }
+    return chain;
+}
+/**
+ * Derive batch-tier eligibility from provider capability.
+ */
+function deriveBatchTiers(provider) {
+    const tiers = ['immediate'];
+    if (FLEX_PROVIDERS.has(provider))
+        tiers.push('flex');
+    if (BATCH_PROVIDERS.has(provider))
+        tiers.push('batch');
+    return tiers;
+}
+/**
+ * Derive the retry policy. Frontier providers get one extra attempt because
+ * their rate limits are typically more transient than long-tail providers.
+ */
+function deriveRetry(provider) {
+    if (FRONTIER_PROVIDERS.has(provider)) {
+        return { ...DEFAULT_RETRY, maxRetries: 4, jitter: 0.2 };
+    }
+    return { ...DEFAULT_RETRY };
+}
+/**
+ * Derive the circuit-breaker policy. Frontier providers get a higher
+ * failure threshold (more capacity) and a shorter reset timeout.
+ */
+function deriveCircuitBreaker(provider) {
+    if (FRONTIER_PROVIDERS.has(provider)) {
+        return { failureThreshold: 8, resetTimeout: 20000, successThreshold: 1 };
+    }
+    return { ...DEFAULT_CIRCUIT_BREAKER };
+}
+/**
+ * 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 function derivePolicy(model, allModels) {
+    const all = allModels ?? list();
+    const slash = model.id.indexOf('/');
+    const provider = slash > 0 ? model.id.substring(0, slash) : model.provider ?? 'unknown';
+    return {
+        $type: 'ModelPolicy',
+        $id: model.id,
+        provider,
+        retry: deriveRetry(provider),
+        circuitBreaker: deriveCircuitBreaker(provider),
+        fallbackChain: deriveFallbackChain(model, all),
+        batchTier: deriveBatchTiers(provider),
+        errorMapping: {},
+    };
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/** Per-process cache of derived policies, keyed by resolved model id. */
+const policyCache = new Map();
+/**
+ * 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 function policyFor(input) {
+    const id = resolve(input);
+    const cached = policyCache.get(id);
+    if (cached)
+        return cached;
+    const model = get(id);
+    const policy = model ? derivePolicy(model) : defaultPolicy(id);
+    policyCache.set(id, policy);
+    return policy;
+}
+/**
+ * Reset the policy cache. Useful for tests, or after the catalog is reloaded.
+ */
+export function resetPolicyCache() {
+    policyCache.clear();
+}
+/**
+ * List all known aliases. Convenience for tooling that wants to enumerate
+ * derived policies (e.g. a static snapshot generator).
+ */
+export function listAliases() {
+    return Object.keys(ALIASES);
+}
+//# sourceMappingURL=policy.js.map

package/dist/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"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"}

package/dist/pricing/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * language-models / pricing — canonical LLM model pricing table.
+ *
+ * Consume via the subpath export:
+ *
+ *   import { PRICING_TABLE, priceFor, type ModelPricing } from 'language-models/pricing'
+ *
+ * (Equivalent symbols are also re-exported from the package root —
+ * `import { priceFor } from 'language-models'` works too.)
+ *
+ * Rates are sourced from public Vertex / Bedrock / AI Studio list prices.
+ * `priceFor()` throws on unknown slug/tier rather than returning a silent
+ * zero (per BYOK_GATEWAY_LIES discipline: loud failure beats silent
+ * downgrade).
+ */
+export type { HasPricingArgs, ModelPricing, PriceForArgs, PriceForResult, PricingTier, Provider, RateBlock, } from './types.js';
+export { PRICING_TABLE } from './table.js';
+export { priceFor, listSlugs, hasPricing, rowsForSlug } from './lookup.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pricing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,YAAY,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,WAAW,EACX,QAAQ,EACR,SAAS,GACV,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA"}

package/dist/pricing/index.js

@@ -0,0 +1,18 @@
+/**
+ * language-models / pricing — canonical LLM model pricing table.
+ *
+ * Consume via the subpath export:
+ *
+ *   import { PRICING_TABLE, priceFor, type ModelPricing } from 'language-models/pricing'
+ *
+ * (Equivalent symbols are also re-exported from the package root —
+ * `import { priceFor } from 'language-models'` works too.)
+ *
+ * Rates are sourced from public Vertex / Bedrock / AI Studio list prices.
+ * `priceFor()` throws on unknown slug/tier rather than returning a silent
+ * zero (per BYOK_GATEWAY_LIES discipline: loud failure beats silent
+ * downgrade).
+ */
+export { PRICING_TABLE } from './table.js';
+export { priceFor, listSlugs, hasPricing, rowsForSlug } from './lookup.js';
+//# sourceMappingURL=index.js.map

package/dist/pricing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pricing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAYH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA"}

package/dist/pricing/lookup.d.ts

@@ -0,0 +1,46 @@
+/**
+ * language-models / pricing — lookup helpers.
+ *
+ * The single source of truth for cost computation across the Phase-2
+ * three-repo cascade. Throws on unknown slug/tier (per BYOK_GATEWAY_LIES
+ * memory: silent zero is the lying-gateway pattern; loud failure beats
+ * silent downgrade).
+ */
+import type { HasPricingArgs, ModelPricing, PriceForArgs, PriceForResult } from './types.js';
+/**
+ * Compute USD cost for a known generation. Throws on:
+ * - unknown slug (no rows for the slug at all)
+ * - unknown/unmodeled tier for the slug (no row for the (slug, tier) pair)
+ * - negative token counts (programming error — fail loud)
+ *
+ * Honors `contextTierBreakpoint` when present: if `inputTokens >=
+ * breakpoint`, the entire request is billed at `contextTierAbove` rates
+ * (matches Google's published billing model — the rate switches once the
+ * input crosses 200K, applied to the full request).
+ *
+ * `cachedInputTokens` is billed at `cachedInputPer1M` when defined,
+ * falling back to the regular input rate otherwise. Cached tokens are
+ * SUBTRACTED from `inputTokens` to compute the non-cached portion — i.e.
+ * `inputTokens` is the TOTAL input including any cached tokens.
+ */
+export declare function priceFor(args: PriceForArgs): PriceForResult;
+/**
+ * Returns the unique set of slugs in the table. Useful for adapters that
+ * want to validate caller-supplied model ids before dispatching.
+ */
+export declare function listSlugs(): readonly string[];
+/**
+ * Returns true if pricing exists for the given (slug, tier). Use this
+ * when you need a non-throwing existence check before calling
+ * `priceFor()` (e.g. a metering middleware that wants to fall back to
+ * "unknown cost" telemetry rather than throwing on a not-yet-registered
+ * model).
+ */
+export declare function hasPricing(args: HasPricingArgs): boolean;
+/**
+ * Returns all pricing rows for a slug, across all tiers. Useful for
+ * tooling that wants to display "this model has standard + batch tiers"
+ * in a UI.
+ */
+export declare function rowsForSlug(slug: string): readonly ModelPricing[];
+//# sourceMappingURL=lookup.d.ts.map

package/dist/pricing/lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../src/pricing/lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,cAAc,EAEf,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CAoC3D;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,SAAS,MAAM,EAAE,CAI7C;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAExD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAEjE"}