ai-lcr 0.6.3 → 0.6.4

package/CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to `ai-lcr` are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/), and the project adheres to
 [Semantic Versioning](https://semver.org/).
 
+## [0.6.4] — 2026-06-16
+
+DX improvements that eliminate per-project boilerplate for consumers.
+
+### Added
+
+- **`DEFAULT_PROVIDERS`** — canonical URL + env-var-name for common providers
+  (openrouter, deepinfra, tokenmart, deepseek, kunavo, runware, fal). Import
+  instead of redeclaring in every app; a URL change propagates on `npm update`.
+- **`createEnvSink(dispatch)`** — reads `LCR_INGEST_URL` / `LCR_PROJECT` /
+  `LCR_INGEST_KEY` from env and returns a ready-to-use `onCall` handler (or
+  `undefined` when unset). Replaces the identical 30-line `sink.ts` every
+  consumer was copy-pasting. Pass `after` from `next/server` as `dispatch`.
+- **`AnyLanguageModel`** — duck-typed model interface on `ProviderEntry` so
+  consumers no longer need `as` casts when their `@ai-sdk/provider` version
+  differs from ai-lcr's. Runtime behavior unchanged.
+
 ## [0.6.3] — 2026-06-11
 
 Caching — both kinds, each off by default and each a pure config flag with no

package/dist/index.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  DEFAULT_PROVIDERS: () => DEFAULT_PROVIDERS,
   DEFAULT_REFERENCE: () => DEFAULT_REFERENCE,
   MEDIA_PRICING: () => MEDIA_PRICING,
   MODEL_PRICES: () => MODEL_PRICES,
@@ -29,6 +30,7 @@ __export(index_exports, {
   classifyError: () => classifyError,
   classifyErrorKind: () => classifyErrorKind,
   comparePrices: () => comparePrices,
+  createEnvSink: () => createEnvSink,
   createFalMediaAdapter: () => createFalMediaAdapter,
   createHttpSink: () => createHttpSink,
   createKunavoMediaAdapter: () => createKunavoMediaAdapter,
@@ -905,6 +907,30 @@ function createHttpSink(options) {
   };
 }
 
+// src/env-sink.ts
+function createEnvSink(dispatch) {
+  const base = process.env.LCR_INGEST_URL?.replace(/\/+$/, "");
+  if (!base) return void 0;
+  return createHttpSink({
+    url: `${base}/api/ingest`,
+    headers: process.env.LCR_INGEST_KEY ? { authorization: `Bearer ${process.env.LCR_INGEST_KEY}` } : void 0,
+    project: process.env.LCR_PROJECT ?? process.env.SITE_KEY,
+    dispatch,
+    onError: (err) => console.error("[lcr] ingest POST failed:", err)
+  });
+}
+
+// src/providers.ts
+var DEFAULT_PROVIDERS = {
+  openrouter: { baseURL: "https://openrouter.ai/api/v1", apiKeyEnv: "OPENROUTER_API_KEY" },
+  deepinfra: { baseURL: "https://api.deepinfra.com/v1/openai", apiKeyEnv: "DEEPINFRA_API_KEY" },
+  tokenmart: { baseURL: "https://model.service-inference.ai/v1", apiKeyEnv: "INFERENCE_API_KEY" },
+  deepseek: { baseURL: "https://api.deepseek.com", apiKeyEnv: "DEEPSEEK_API_KEY" },
+  kunavo: { baseURL: "https://api.kunavo.com/v1", apiKeyEnv: "KUNAVO_API_KEY" },
+  runware: { baseURL: "https://api.runware.ai/v1", apiKeyEnv: "RUNWARE_API_KEY" },
+  fal: { baseURL: "https://queue.fal.run", apiKeyEnv: "FAL_KEY" }
+};
+
 // src/text-prices.ts
 var MODEL_PRICES = {
   "chatgpt-4o-latest": { input: 5, output: 15 },
@@ -2259,6 +2285,7 @@ function createLCR(config) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DEFAULT_PROVIDERS,
   DEFAULT_REFERENCE,
   MEDIA_PRICING,
   MODEL_PRICES,
@@ -2268,6 +2295,7 @@ function createLCR(config) {
   classifyError,
   classifyErrorKind,
   comparePrices,
+  createEnvSink,
   createFalMediaAdapter,
   createHttpSink,
   createKunavoMediaAdapter,

package/dist/index.d.cts

@@ -472,6 +472,62 @@ interface HttpSinkOptions {
  */
 declare function createHttpSink(options: HttpSinkOptions): (record: CallRecord) => void;
 
+/**
+ * Build an `onCall` sink from env vars, or return undefined when
+ * `LCR_INGEST_URL` is not set.
+ *
+ * Env vars read:
+ *   - `LCR_INGEST_URL`  — dashboard origin (required for the sink to activate)
+ *   - `LCR_PROJECT`     — project tag; falls back to `SITE_KEY` (freeart compat)
+ *   - `LCR_INGEST_KEY`  — optional Bearer token
+ */
+declare function createEnvSink(dispatch: (task: () => void | Promise<void>) => void): ((record: CallRecord) => void) | undefined;
+
+/**
+ * Default provider configs — the URLs + env var names that every portfolio app
+ * copy-pastes. Import these instead of redeclaring them per project.
+ *
+ * Adding a provider here (or changing a URL) propagates to every consumer on
+ * the next `npm update ai-lcr` — no per-app code change.
+ */
+interface ProviderConfig {
+    /** Base URL for the OpenAI-compatible endpoint (no trailing `/v1` unless required). */
+    baseURL: string;
+    /** Name of the env var that holds the API key. */
+    apiKeyEnv: string;
+}
+declare const DEFAULT_PROVIDERS: {
+    readonly openrouter: {
+        readonly baseURL: "https://openrouter.ai/api/v1";
+        readonly apiKeyEnv: "OPENROUTER_API_KEY";
+    };
+    readonly deepinfra: {
+        readonly baseURL: "https://api.deepinfra.com/v1/openai";
+        readonly apiKeyEnv: "DEEPINFRA_API_KEY";
+    };
+    readonly tokenmart: {
+        readonly baseURL: "https://model.service-inference.ai/v1";
+        readonly apiKeyEnv: "INFERENCE_API_KEY";
+    };
+    readonly deepseek: {
+        readonly baseURL: "https://api.deepseek.com";
+        readonly apiKeyEnv: "DEEPSEEK_API_KEY";
+    };
+    readonly kunavo: {
+        readonly baseURL: "https://api.kunavo.com/v1";
+        readonly apiKeyEnv: "KUNAVO_API_KEY";
+    };
+    readonly runware: {
+        readonly baseURL: "https://api.runware.ai/v1";
+        readonly apiKeyEnv: "RUNWARE_API_KEY";
+    };
+    readonly fal: {
+        readonly baseURL: "https://queue.fal.run";
+        readonly apiKeyEnv: "FAL_KEY";
+    };
+};
+type DefaultProviderId = keyof typeof DEFAULT_PROVIDERS;
+
 declare const MODEL_PRICES: Record<string, ProviderCost>;
 
 /**
@@ -997,13 +1053,28 @@ declare function createFalMediaAdapter(config: FalMediaConfig): MediaAdapter;
  * a bundled price table for zero-config cheapest-first ordering.
  */
 
+/**
+ * Any object with the `doGenerate` + `doStream` shape — accepts LanguageModelV3
+ * from any version of `@ai-sdk/provider` so consumers don't need a cast when
+ * their transitive `@ai-sdk/provider` version differs from ai-lcr's.
+ */
+type AnyLanguageModel = {
+    doGenerate: (...args: any[]) => any;
+    doStream: (...args: any[]) => any;
+    provider: string;
+    modelId: string;
+};
 /**
  * A provider for a model: either a bare AI SDK model (e.g.
  * `createOpenAICompatible(...)("id")`), or that model wrapped with price/label
  * metadata to unlock cost accounting and cheapest-first auto-sorting.
+ *
+ * `model` accepts any AI SDK language model — both LanguageModelV3 and
+ * compatible shapes from other `@ai-sdk/provider` versions — so consumers
+ * never need an `as` cast at the boundary.
  */
-type ProviderEntry = LanguageModelV3 | {
-    model: LanguageModelV3;
+type ProviderEntry = AnyLanguageModel | {
+    model: AnyLanguageModel;
     /** USD per 1M tokens. Enables `onCost` and `autoSort`. */
     cost?: ProviderCost;
     /** Label used in cost events / logs. Defaults to the model's provider id. */
@@ -1128,4 +1199,4 @@ type LCRRouter = (modelName: string) => LanguageModelV3;
  */
 declare function createLCR(config: LCRConfig): LCRRouter;
 
-export { type BillableContext, type CacheOptions, type CacheStore, type CachedCall, type CachedMeta, type CallRecord, type CooldownOptions, type CostEvent, DEFAULT_REFERENCE, type ErrorKind, type FormatOptions, type HttpSinkOptions, type LCRConfig, type LCRRouter, MEDIA_PRICING, MODEL_PRICES, type MediaAdapter, type MediaCostEvent, type MediaGenerateRequest, type MediaGenerateResult, type MediaJobHandle, type MediaJobStatus, type MediaLCR, type MediaLCRConfig, type MediaModality, type MediaModelDef, type MediaOutput, type MediaPollResult, type MediaPricing, type MediaRegistry, type MediaRoute, type MediaRunResult, type MediaStatusRequest, type MediaStatusResult, type MediaSubmitOptions, type MediaSubmitRequest, type MediaSubmitResult, type MediaUnit, type MediaUsage, type MemoryCacheOptions, OFFICIAL_PRICES, type PriceComparisonRow, type PromptCacheOptions, type ProviderCost, type ProviderEntry, type RankedRoute, type ReferenceSpec, type RouteAttempt, billableUnits, cheapestRoute, classifyError, classifyErrorKind, comparePrices, createFalMediaAdapter, createHttpSink, createKunavoMediaAdapter, createLCR, createMediaLCR, createMemoryCacheStore, createRunwareMediaAdapter, durationFromInput, formatCallRecord, getModelPrice, isAbortError, isNetworkError, isRetryableError, normalizedCents, priceCents, rankRoutes, referenceMegapixels, shouldFailover };
+export { type AnyLanguageModel, type BillableContext, type CacheOptions, type CacheStore, type CachedCall, type CachedMeta, type CallRecord, type CooldownOptions, type CostEvent, DEFAULT_PROVIDERS, DEFAULT_REFERENCE, type DefaultProviderId, type ErrorKind, type FormatOptions, type HttpSinkOptions, type LCRConfig, type LCRRouter, MEDIA_PRICING, MODEL_PRICES, type MediaAdapter, type MediaCostEvent, type MediaGenerateRequest, type MediaGenerateResult, type MediaJobHandle, type MediaJobStatus, type MediaLCR, type MediaLCRConfig, type MediaModality, type MediaModelDef, type MediaOutput, type MediaPollResult, type MediaPricing, type MediaRegistry, type MediaRoute, type MediaRunResult, type MediaStatusRequest, type MediaStatusResult, type MediaSubmitOptions, type MediaSubmitRequest, type MediaSubmitResult, type MediaUnit, type MediaUsage, type MemoryCacheOptions, OFFICIAL_PRICES, type PriceComparisonRow, type PromptCacheOptions, type ProviderConfig, type ProviderCost, type ProviderEntry, type RankedRoute, type ReferenceSpec, type RouteAttempt, billableUnits, cheapestRoute, classifyError, classifyErrorKind, comparePrices, createEnvSink, createFalMediaAdapter, createHttpSink, createKunavoMediaAdapter, createLCR, createMediaLCR, createMemoryCacheStore, createRunwareMediaAdapter, durationFromInput, formatCallRecord, getModelPrice, isAbortError, isNetworkError, isRetryableError, normalizedCents, priceCents, rankRoutes, referenceMegapixels, shouldFailover };

package/dist/index.d.ts

@@ -472,6 +472,62 @@ interface HttpSinkOptions {
  */
 declare function createHttpSink(options: HttpSinkOptions): (record: CallRecord) => void;
 
+/**
+ * Build an `onCall` sink from env vars, or return undefined when
+ * `LCR_INGEST_URL` is not set.
+ *
+ * Env vars read:
+ *   - `LCR_INGEST_URL`  — dashboard origin (required for the sink to activate)
+ *   - `LCR_PROJECT`     — project tag; falls back to `SITE_KEY` (freeart compat)
+ *   - `LCR_INGEST_KEY`  — optional Bearer token
+ */
+declare function createEnvSink(dispatch: (task: () => void | Promise<void>) => void): ((record: CallRecord) => void) | undefined;
+
+/**
+ * Default provider configs — the URLs + env var names that every portfolio app
+ * copy-pastes. Import these instead of redeclaring them per project.
+ *
+ * Adding a provider here (or changing a URL) propagates to every consumer on
+ * the next `npm update ai-lcr` — no per-app code change.
+ */
+interface ProviderConfig {
+    /** Base URL for the OpenAI-compatible endpoint (no trailing `/v1` unless required). */
+    baseURL: string;
+    /** Name of the env var that holds the API key. */
+    apiKeyEnv: string;
+}
+declare const DEFAULT_PROVIDERS: {
+    readonly openrouter: {
+        readonly baseURL: "https://openrouter.ai/api/v1";
+        readonly apiKeyEnv: "OPENROUTER_API_KEY";
+    };
+    readonly deepinfra: {
+        readonly baseURL: "https://api.deepinfra.com/v1/openai";
+        readonly apiKeyEnv: "DEEPINFRA_API_KEY";
+    };
+    readonly tokenmart: {
+        readonly baseURL: "https://model.service-inference.ai/v1";
+        readonly apiKeyEnv: "INFERENCE_API_KEY";
+    };
+    readonly deepseek: {
+        readonly baseURL: "https://api.deepseek.com";
+        readonly apiKeyEnv: "DEEPSEEK_API_KEY";
+    };
+    readonly kunavo: {
+        readonly baseURL: "https://api.kunavo.com/v1";
+        readonly apiKeyEnv: "KUNAVO_API_KEY";
+    };
+    readonly runware: {
+        readonly baseURL: "https://api.runware.ai/v1";
+        readonly apiKeyEnv: "RUNWARE_API_KEY";
+    };
+    readonly fal: {
+        readonly baseURL: "https://queue.fal.run";
+        readonly apiKeyEnv: "FAL_KEY";
+    };
+};
+type DefaultProviderId = keyof typeof DEFAULT_PROVIDERS;
+
 declare const MODEL_PRICES: Record<string, ProviderCost>;
 
 /**
@@ -997,13 +1053,28 @@ declare function createFalMediaAdapter(config: FalMediaConfig): MediaAdapter;
  * a bundled price table for zero-config cheapest-first ordering.
  */
 
+/**
+ * Any object with the `doGenerate` + `doStream` shape — accepts LanguageModelV3
+ * from any version of `@ai-sdk/provider` so consumers don't need a cast when
+ * their transitive `@ai-sdk/provider` version differs from ai-lcr's.
+ */
+type AnyLanguageModel = {
+    doGenerate: (...args: any[]) => any;
+    doStream: (...args: any[]) => any;
+    provider: string;
+    modelId: string;
+};
 /**
  * A provider for a model: either a bare AI SDK model (e.g.
  * `createOpenAICompatible(...)("id")`), or that model wrapped with price/label
  * metadata to unlock cost accounting and cheapest-first auto-sorting.
+ *
+ * `model` accepts any AI SDK language model — both LanguageModelV3 and
+ * compatible shapes from other `@ai-sdk/provider` versions — so consumers
+ * never need an `as` cast at the boundary.
  */
-type ProviderEntry = LanguageModelV3 | {
-    model: LanguageModelV3;
+type ProviderEntry = AnyLanguageModel | {
+    model: AnyLanguageModel;
     /** USD per 1M tokens. Enables `onCost` and `autoSort`. */
     cost?: ProviderCost;
     /** Label used in cost events / logs. Defaults to the model's provider id. */
@@ -1128,4 +1199,4 @@ type LCRRouter = (modelName: string) => LanguageModelV3;
  */
 declare function createLCR(config: LCRConfig): LCRRouter;
 
-export { type BillableContext, type CacheOptions, type CacheStore, type CachedCall, type CachedMeta, type CallRecord, type CooldownOptions, type CostEvent, DEFAULT_REFERENCE, type ErrorKind, type FormatOptions, type HttpSinkOptions, type LCRConfig, type LCRRouter, MEDIA_PRICING, MODEL_PRICES, type MediaAdapter, type MediaCostEvent, type MediaGenerateRequest, type MediaGenerateResult, type MediaJobHandle, type MediaJobStatus, type MediaLCR, type MediaLCRConfig, type MediaModality, type MediaModelDef, type MediaOutput, type MediaPollResult, type MediaPricing, type MediaRegistry, type MediaRoute, type MediaRunResult, type MediaStatusRequest, type MediaStatusResult, type MediaSubmitOptions, type MediaSubmitRequest, type MediaSubmitResult, type MediaUnit, type MediaUsage, type MemoryCacheOptions, OFFICIAL_PRICES, type PriceComparisonRow, type PromptCacheOptions, type ProviderCost, type ProviderEntry, type RankedRoute, type ReferenceSpec, type RouteAttempt, billableUnits, cheapestRoute, classifyError, classifyErrorKind, comparePrices, createFalMediaAdapter, createHttpSink, createKunavoMediaAdapter, createLCR, createMediaLCR, createMemoryCacheStore, createRunwareMediaAdapter, durationFromInput, formatCallRecord, getModelPrice, isAbortError, isNetworkError, isRetryableError, normalizedCents, priceCents, rankRoutes, referenceMegapixels, shouldFailover };
+export { type AnyLanguageModel, type BillableContext, type CacheOptions, type CacheStore, type CachedCall, type CachedMeta, type CallRecord, type CooldownOptions, type CostEvent, DEFAULT_PROVIDERS, DEFAULT_REFERENCE, type DefaultProviderId, type ErrorKind, type FormatOptions, type HttpSinkOptions, type LCRConfig, type LCRRouter, MEDIA_PRICING, MODEL_PRICES, type MediaAdapter, type MediaCostEvent, type MediaGenerateRequest, type MediaGenerateResult, type MediaJobHandle, type MediaJobStatus, type MediaLCR, type MediaLCRConfig, type MediaModality, type MediaModelDef, type MediaOutput, type MediaPollResult, type MediaPricing, type MediaRegistry, type MediaRoute, type MediaRunResult, type MediaStatusRequest, type MediaStatusResult, type MediaSubmitOptions, type MediaSubmitRequest, type MediaSubmitResult, type MediaUnit, type MediaUsage, type MemoryCacheOptions, OFFICIAL_PRICES, type PriceComparisonRow, type PromptCacheOptions, type ProviderConfig, type ProviderCost, type ProviderEntry, type RankedRoute, type ReferenceSpec, type RouteAttempt, billableUnits, cheapestRoute, classifyError, classifyErrorKind, comparePrices, createEnvSink, createFalMediaAdapter, createHttpSink, createKunavoMediaAdapter, createLCR, createMediaLCR, createMemoryCacheStore, createRunwareMediaAdapter, durationFromInput, formatCallRecord, getModelPrice, isAbortError, isNetworkError, isRetryableError, normalizedCents, priceCents, rankRoutes, referenceMegapixels, shouldFailover };

package/dist/index.js

@@ -853,6 +853,30 @@ function createHttpSink(options) {
   };
 }
 
+// src/env-sink.ts
+function createEnvSink(dispatch) {
+  const base = process.env.LCR_INGEST_URL?.replace(/\/+$/, "");
+  if (!base) return void 0;
+  return createHttpSink({
+    url: `${base}/api/ingest`,
+    headers: process.env.LCR_INGEST_KEY ? { authorization: `Bearer ${process.env.LCR_INGEST_KEY}` } : void 0,
+    project: process.env.LCR_PROJECT ?? process.env.SITE_KEY,
+    dispatch,
+    onError: (err) => console.error("[lcr] ingest POST failed:", err)
+  });
+}
+
+// src/providers.ts
+var DEFAULT_PROVIDERS = {
+  openrouter: { baseURL: "https://openrouter.ai/api/v1", apiKeyEnv: "OPENROUTER_API_KEY" },
+  deepinfra: { baseURL: "https://api.deepinfra.com/v1/openai", apiKeyEnv: "DEEPINFRA_API_KEY" },
+  tokenmart: { baseURL: "https://model.service-inference.ai/v1", apiKeyEnv: "INFERENCE_API_KEY" },
+  deepseek: { baseURL: "https://api.deepseek.com", apiKeyEnv: "DEEPSEEK_API_KEY" },
+  kunavo: { baseURL: "https://api.kunavo.com/v1", apiKeyEnv: "KUNAVO_API_KEY" },
+  runware: { baseURL: "https://api.runware.ai/v1", apiKeyEnv: "RUNWARE_API_KEY" },
+  fal: { baseURL: "https://queue.fal.run", apiKeyEnv: "FAL_KEY" }
+};
+
 // src/text-prices.ts
 var MODEL_PRICES = {
   "chatgpt-4o-latest": { input: 5, output: 15 },
@@ -2206,6 +2230,7 @@ function createLCR(config) {
   };
 }
 export {
+  DEFAULT_PROVIDERS,
   DEFAULT_REFERENCE,
   MEDIA_PRICING,
   MODEL_PRICES,
@@ -2215,6 +2240,7 @@ export {
   classifyError,
   classifyErrorKind,
   comparePrices,
+  createEnvSink,
   createFalMediaAdapter,
   createHttpSink,
   createKunavoMediaAdapter,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-lcr",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "description": "Least Cost Routing for LLMs — route every model call to the cheapest available provider, fall back automatically, and track real cost. Built for the Vercel AI SDK.",
   "keywords": [
     "ai",