@substrat-run/model-providers 0.1.0

package/README.md

@@ -0,0 +1,31 @@
+# @substrat-run/model-providers
+
+The model-provider seam: one `provider:model` grammar, a table of providers, the
+hosting disclosure per provider, the generated rate card and the list-price math over
+it. Hosts differ only in *where credentials come from* and *how provider packages get
+loaded* — both are parameters. Cloudflare is one row, not the design (issue #1054).
+
+**Full documentation: https://substrat.net/reference/model-providers**
+
+## Usage
+
+```ts
+import { createAnthropic } from '@ai-sdk/anthropic';
+import { createModel, providerCatalog, listCostOfSteps } from '@substrat-run/model-providers';
+
+// A Worker: bindings in, statically imported factories in.
+const { model, label } = createModel('cloudflare:@cf/zai-org/glm-5.2', env, {
+  factories: { anthropic: createAnthropic },
+  hosted: true,
+  describeMissing: (v) => `${v} is not set as a worker secret`,
+});
+
+// What a picker shows — vendor, location, host, and whether this environment can run it.
+providerCatalog(env, { hosted: true, sent: 'Conversation text' });
+
+// List price from the AI SDK usage shape; margin is the caller's vocabulary.
+listCostOfSteps('anthropic:claude-opus-5', [{ inputTokens: 100_000, outputTokens: 10_000 }]);
+```
+
+The rate card is generated (`pnpm --filter @substrat-run/model-providers update-rate-card`)
+from models.dev × LiteLLM with a failing cross-check, and reviewed as a PR diff.

package/dist/catalog.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Where does this model actually run? — the disclosure, as data.
+ *
+ * D-53/D-54: the model provider is a subprocessor of whatever is sent to it, so
+ * a picker must say WHERE inference happens, not just which model. This turns a
+ * provider row + its effective endpoint into a human-readable hosting statement.
+ * Deliberately factual — vendor, place, host — not marketing.
+ */
+import { type ModelPair } from './model-pairs.js';
+import { type CredentialEnv } from './resolve.js';
+export interface HostingInfo {
+    /** Who operates the inference endpoint. */
+    readonly vendor: string;
+    /** Where, as precisely as the endpoint tells us. */
+    readonly location: string;
+    /** The hostname requests actually go to. */
+    readonly host: string;
+    /**
+     * True only when inference runs on this machine IN FACT — the row is declared local
+     * and its effective endpoint is loopback. Never inferred the other way.
+     */
+    readonly local: boolean;
+    /** The one sentence about what is sent — the host's own words. */
+    readonly dataNote: string;
+}
+export interface CatalogOptions {
+    /**
+     * What this host sends — 'Session code and chat', 'Conversation text and the
+     * knowledge base'. Rendered as "<sent> — sent to this provider." (number-neutral).
+     */
+    readonly sent?: string;
+    /** Exclude rows marked `local` (a hosted runtime cannot dial localhost). */
+    readonly hosted?: boolean;
+    /** Restrict to these providers — e.g. the direct rows a Worker statically wired. */
+    readonly only?: readonly string[];
+}
+export declare function hostingInfo(provider: string, env: CredentialEnv, options?: CatalogOptions): HostingInfo;
+export interface ProviderCatalogEntry {
+    readonly name: string;
+    readonly kind: 'direct' | 'compatible';
+    readonly hosting: HostingInfo;
+    /**
+     * `set` means THIS ENVIRONMENT CAN RUN THE ROW — the credential and, for an
+     * account-scoped endpoint such as Cloudflare's, the base URL too. A picker gates
+     * listing and selection on it, and a token with no endpoint can do neither, so
+     * "credential present but endpoint absent" must read as not set. `missing` names
+     * which variables, so the UI can say which one rather than blaming the key.
+     */
+    readonly credential: {
+        readonly envVar: string | null;
+        readonly set: boolean;
+        readonly missing: readonly string[];
+    };
+    /** True when models can be listed live from the endpoint. */
+    readonly listable: boolean;
+    readonly suggested: readonly string[];
+    /** The `<provider>:auto` pair, when one is declared (model-pairs.ts). */
+    readonly pair?: ModelPair;
+}
+/**
+ * The picker catalog: one entry per provider this host can run, with the
+ * disclosure intact and `credential.set` reflecting THIS environment.
+ */
+export declare function providerCatalog(env: CredentialEnv, options?: CatalogOptions): ProviderCatalogEntry[];
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG/D,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAEnE,MAAM,WAAW,WAAW;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC9B;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,oFAAoF;IACpF,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAQD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,OAAO,GAAE,cAAmB,GAAG,WAAW,CAoB3G;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IACpH,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,yEAAyE;IACzE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,GAAE,cAAmB,GAAG,oBAAoB,EAAE,CAkBxG"}

package/dist/catalog.js

@@ -0,0 +1,64 @@
+/**
+ * Where does this model actually run? — the disclosure, as data.
+ *
+ * D-53/D-54: the model provider is a subprocessor of whatever is sent to it, so
+ * a picker must say WHERE inference happens, not just which model. This turns a
+ * provider row + its effective endpoint into a human-readable hosting statement.
+ * Deliberately factual — vendor, place, host — not marketing.
+ */
+import { MODEL_PAIRS } from './model-pairs.js';
+import { PROVIDERS, providerRow } from './providers.js';
+import { hostOf, isLoopbackHost } from './host.js';
+import { credentialsFrom } from './resolve.js';
+function effectiveHost(name, row, env) {
+    const creds = credentialsFrom(name, env);
+    if (row.kind === 'direct')
+        return creds.baseUrl ? hostOf(creds.baseUrl) : row.defaultHost;
+    return creds.baseUrl ? hostOf(creds.baseUrl) : `(${row.baseUrlEnv} not set)`;
+}
+export function hostingInfo(provider, env, options = {}) {
+    const row = providerRow(provider);
+    const sent = `${options.sent ?? 'Inputs'} — sent to this provider.`;
+    if (!row)
+        return { vendor: provider, location: 'unknown', host: 'unknown', local: false, dataNote: sent };
+    const host = effectiveHost(provider, row, env);
+    const location = typeof row.hosting.location === 'function' ? row.hosting.location(host) : row.hosting.location;
+    // `hosting.local` says the row is local BY DEFAULT; the effective endpoint says
+    // whether it still is. Ollama's endpoint is overridable, so a row declared local can
+    // be pointed at a remote host — and the disclosure must follow the endpoint, not the
+    // declaration. The effective endpoint only ever TAKES the local claim away; it never
+    // grants one, so a `compat` row aimed at localhost still reads as sent (see
+    // `isLoopbackHost`).
+    const local = row.hosting.local === true && isLoopbackHost(host);
+    return {
+        vendor: row.hosting.vendor,
+        location,
+        host,
+        local,
+        dataNote: local ? `${options.sent ?? 'Inputs'} — never leaves this machine.` : sent,
+    };
+}
+/**
+ * The picker catalog: one entry per provider this host can run, with the
+ * disclosure intact and `credential.set` reflecting THIS environment.
+ */
+export function providerCatalog(env, options = {}) {
+    return Object.entries(PROVIDERS)
+        .filter(([name, row]) => !(options.hosted && row.hosting.local))
+        .filter(([name]) => !options.only || options.only.includes(name))
+        .map(([name, row]) => {
+        const envVar = row.envVar ?? null;
+        const creds = credentialsFrom(name, env);
+        const pair = MODEL_PAIRS[name];
+        return {
+            name,
+            kind: row.kind,
+            hosting: hostingInfo(name, env, options),
+            credential: { envVar, set: creds.missing.length === 0, missing: creds.missing },
+            listable: row.kind === 'compatible',
+            suggested: row.suggested ?? [],
+            ...(pair ? { pair } : {}),
+        };
+    });
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAkB,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAqB,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,eAAe,EAAsB,MAAM,cAAc,CAAC;AA8BnE,SAAS,aAAa,CAAC,IAAY,EAAE,GAAiB,EAAE,GAAkB;IACzE,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACzC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC;IAC1F,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,UAAU,WAAW,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,GAAkB,EAAE,OAAO,GAAmB,EAAE;IAC7F,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,GAAG,OAAO,CAAC,IAAI,IAAI,QAAQ,2BAA2B,CAAC;IACpE,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1G,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC;IAChH,gFAAgF;IAChF,qFAAqF;IACrF,qFAAqF;IACrF,qFAAqF;IACrF,4EAA4E;IAC5E,qBAAqB;IACrB,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,IAAI,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IACjE,OAAO;QACN,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM;QAC1B,QAAQ;QACR,IAAI;QACJ,KAAK;QACL,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,IAAI,QAAQ,+BAA+B,CAAC,CAAC,CAAC,IAAI;KACnF,CAAC;AACH,CAAC;AAqBD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAkB,EAAE,OAAO,GAAmB,EAAE;IAC/E,OAAO,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;SAC9B,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;SAC/D,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;SAChE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE;QACpB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC;QAClC,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAC/B,OAAO;YACN,IAAI;YACJ,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC;YACxC,UAAU,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE;YAC/E,QAAQ,EAAE,GAAG,CAAC,IAAI,KAAK,YAAY;YACnC,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;YAC9B,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/host.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Host helpers — the two questions the disclosure asks of an endpoint.
+ *
+ * Their own module because BOTH the provider table (a row whose location depends on
+ * where its endpoint points) and the catalog (which builds the disclosure) need them,
+ * and the table must not import the catalog that reads it.
+ */
+/** The host of a URL, or the string itself when it will not parse. */
+export declare function hostOf(url: string): string;
+/**
+ * Is a host loopback — this machine, and no other?
+ *
+ * Answers `true` only for a host it RECOGNISES as loopback. An unfamiliar name, an
+ * unparseable URL, `0.0.0.0`, a LAN address: all read as remote. That asymmetry is the
+ * point, and it is the direction a privacy claim must be wrong in — telling somebody
+ * their prompts stayed on their laptop when they went to a GPU box is a lie, while
+ * telling them a local endpoint might have been sent to overstates the exposure and
+ * costs them nothing.
+ */
+export declare function isLoopbackHost(host: string): boolean;
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sEAAsE;AACtE,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOpD"}

package/dist/host.js

@@ -0,0 +1,37 @@
+/**
+ * Host helpers — the two questions the disclosure asks of an endpoint.
+ *
+ * Their own module because BOTH the provider table (a row whose location depends on
+ * where its endpoint points) and the catalog (which builds the disclosure) need them,
+ * and the table must not import the catalog that reads it.
+ */
+/** The host of a URL, or the string itself when it will not parse. */
+export function hostOf(url) {
+    try {
+        return new URL(url).host;
+    }
+    catch {
+        return url;
+    }
+}
+/**
+ * Is a host loopback — this machine, and no other?
+ *
+ * Answers `true` only for a host it RECOGNISES as loopback. An unfamiliar name, an
+ * unparseable URL, `0.0.0.0`, a LAN address: all read as remote. That asymmetry is the
+ * point, and it is the direction a privacy claim must be wrong in — telling somebody
+ * their prompts stayed on their laptop when they went to a GPU box is a lie, while
+ * telling them a local endpoint might have been sent to overstates the exposure and
+ * costs them nothing.
+ */
+export function isLoopbackHost(host) {
+    // `new URL(...).host` carries the port; the name alone decides. IPv6 arrives
+    // bracketed (`[::1]:11434`), which the same strip handles.
+    const name = host.replace(/:\d+$/, '').toLowerCase();
+    if (name === 'localhost' || name.endsWith('.localhost'))
+        return true; // RFC 6761
+    if (name === '[::1]' || name === '::1')
+        return true;
+    return /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(name);
+}
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sEAAsE;AACtE,MAAM,UAAU,MAAM,CAAC,GAAW;IACjC,IAAI,CAAC;QACJ,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,GAAG,CAAC;IACZ,CAAC;AACF,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IAC1C,6EAA6E;IAC7E,2DAA2D;IAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACrD,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,WAAW;IACjF,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IACpD,OAAO,kCAAkC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @substrat-run/model-providers — the model-provider seam (#1054).
+ *
+ * One `provider:model` grammar, one table of providers, one disclosure per row,
+ * one generated rate card and the list-price math over it. Hosts differ only in
+ * where credentials come from and how direct-provider packages get loaded, and
+ * both of those are parameters. Cloudflare is one row.
+ */
+export { DEFAULT_PROVIDER, normalizeModelSpec, parseModelSpec, providerOf, type ModelSpec } from './spec.js';
+export { PROVIDERS, credentialEnvVar, knownProviders, providerRow, ollamaLocation, qwenLocation, type CompatibleProvider, type DirectProvider, type HostingSpec, type ProviderSpec, } from './providers.js';
+export { ProviderError, createModel, credentialsFrom, providerSpec, type CreateModelOptions, type CredentialEnv, type DirectFactories, type DirectFactory, type ProviderCredentials, type ResolvedModel, } from './resolve.js';
+export { listModels } from './list-models.js';
+export { hostOf, isLoopbackHost } from './host.js';
+export { requestHeadersFor, type RequestExtrasInput, type WireAttribution } from './request.js';
+export { hostingInfo, providerCatalog, type CatalogOptions, type HostingInfo, type ProviderCatalogEntry, } from './catalog.js';
+export { MODEL_PAIRS, pairFor, resolveAutoSpec, samplingFor, type ModelPair, type PairTier } from './model-pairs.js';
+export { listCostOf, listCostOfSteps, rateFor, type ModelRate, type RateTier, type StepTokens, } from './pricing.js';
+export { RATE_CARD, RATE_CARD_GENERATED_AT } from './rate-card.generated.js';
+export { errorFacts, explainProviderFailure, type ErrorFacts } from './provider-errors.js';
+export { qwenCacheFetch, withQwenCacheMarkers } from './qwen-cache.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAC7G,OAAO,EACN,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,cAAc,EACd,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,YAAY,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,aAAa,EACb,WAAW,EACX,eAAe,EACf,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAChG,OAAO,EACN,WAAW,EACX,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,oBAAoB,GACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrH,OAAO,EACN,UAAU,EACV,eAAe,EACf,OAAO,EACP,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,UAAU,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+/**
+ * @substrat-run/model-providers — the model-provider seam (#1054).
+ *
+ * One `provider:model` grammar, one table of providers, one disclosure per row,
+ * one generated rate card and the list-price math over it. Hosts differ only in
+ * where credentials come from and how direct-provider packages get loaded, and
+ * both of those are parameters. Cloudflare is one row.
+ */
+export { DEFAULT_PROVIDER, normalizeModelSpec, parseModelSpec, providerOf } from './spec.js';
+export { PROVIDERS, credentialEnvVar, knownProviders, providerRow, ollamaLocation, qwenLocation, } from './providers.js';
+export { ProviderError, createModel, credentialsFrom, providerSpec, } from './resolve.js';
+export { listModels } from './list-models.js';
+export { hostOf, isLoopbackHost } from './host.js';
+export { requestHeadersFor } from './request.js';
+export { hostingInfo, providerCatalog, } from './catalog.js';
+export { MODEL_PAIRS, pairFor, resolveAutoSpec, samplingFor } from './model-pairs.js';
+export { listCostOf, listCostOfSteps, rateFor, } from './pricing.js';
+export { RATE_CARD, RATE_CARD_GENERATED_AT } from './rate-card.generated.js';
+export { errorFacts, explainProviderFailure } from './provider-errors.js';
+export { qwenCacheFetch, withQwenCacheMarkers } from './qwen-cache.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,UAAU,EAAkB,MAAM,WAAW,CAAC;AAC7G,OAAO,EACN,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,cAAc,EACd,YAAY,GAKZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,aAAa,EACb,WAAW,EACX,eAAe,EACf,YAAY,GAOZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAiD,MAAM,cAAc,CAAC;AAChG,OAAO,EACN,WAAW,EACX,eAAe,GAIf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAiC,MAAM,kBAAkB,CAAC;AACrH,OAAO,EACN,UAAU,EACV,eAAe,EACf,OAAO,GAIP,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAmB,MAAM,sBAAsB,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/list-models.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Ask an OpenAI-compatible endpoint which models it actually serves.
+ *
+ * Worth having as a first-class affordance: a workspace or regional plan exposes
+ * its own model list, so a model id that is valid on one endpoint returns a bare
+ * "Model not exist." on another — with no hint of what would work instead.
+ *
+ * Direct providers are not listable here — see their own documentation.
+ */
+import { type CredentialEnv } from './resolve.js';
+export declare function listModels(provider: string, env: CredentialEnv): Promise<string[]>;
+//# sourceMappingURL=list-models.d.ts.map

package/dist/list-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-models.d.ts","sourceRoot":"","sources":["../src/list-models.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAgD,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAEhG,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAqBxF"}

package/dist/list-models.js

@@ -0,0 +1,57 @@
+/**
+ * Ask an OpenAI-compatible endpoint which models it actually serves.
+ *
+ * Worth having as a first-class affordance: a workspace or regional plan exposes
+ * its own model list, so a model id that is valid on one endpoint returns a bare
+ * "Model not exist." on another — with no hint of what would work instead.
+ *
+ * Direct providers are not listable here — see their own documentation.
+ */
+import { credentialsFrom, ProviderError, providerSpec } from './resolve.js';
+export async function listModels(provider, env) {
+    const row = providerSpec(provider);
+    if (row.kind !== 'compatible') {
+        throw new ProviderError(`listing models is only supported for OpenAI-compatible providers; ` +
+            `${provider} is a direct provider — see its own documentation.`);
+    }
+    const creds = credentialsFrom(provider, env);
+    if (!creds.baseUrl)
+        throw new ProviderError(`provider ${provider} needs ${row.baseUrlEnv} set.`);
+    const headers = creds.apiKey ? { Authorization: `Bearer ${creds.apiKey}` } : {};
+    if (row.catalog === 'cloudflare-catalog')
+        return listCloudflareCatalog(creds.baseUrl, headers);
+    const res = await fetch(`${creds.baseUrl.replace(/\/$/, '')}/models`, { headers });
+    if (!res.ok)
+        throw new ProviderError(`${creds.baseUrl}/models returned HTTP ${res.status}`);
+    const body = (await res.json());
+    return (body.data ?? [])
+        .map((m) => (typeof m.id === 'string' ? m.id : null))
+        .filter((id) => id !== null)
+        .sort();
+}
+/**
+ * Workers AI's OpenAI-compatible surface serves chat/completions and embeddings
+ * but NOT `GET /models` (405) — the catalog lives one level up, on the account
+ * API (`…/ai/v1` → `…/ai/models/search`), task-filtered server-side so the
+ * picker offers models that can run a text turn, not embeddings or speech. It
+ * lists Cloudflare's own `@cf/…` models only; partner-served `vendor/model` ids
+ * stay free-text. Paged defensively; the filtered catalog fits one page today.
+ */
+async function listCloudflareCatalog(baseUrl, headers) {
+    const root = baseUrl.replace(/\/$/, '').replace(/\/v1$/, '');
+    const names = [];
+    for (let page = 1; page <= 5; page++) {
+        const url = `${root}/models/search?task=${encodeURIComponent('Text Generation')}&per_page=100&page=${page}`;
+        const res = await fetch(url, { headers });
+        if (!res.ok)
+            throw new ProviderError(`${root}/models/search returned HTTP ${res.status}`);
+        const body = (await res.json());
+        const rows = body.result ?? [];
+        names.push(...rows.map((m) => (typeof m.name === 'string' ? m.name : null)).filter((n) => n !== null));
+        // The page boundary is the RAW page length: a filtered-out entry must not end the walk early.
+        if (rows.length < 100)
+            break;
+    }
+    return names.sort();
+}
+//# sourceMappingURL=list-models.js.map

package/dist/list-models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-models.js","sourceRoot":"","sources":["../src/list-models.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAsB,MAAM,cAAc,CAAC;AAEhG,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB,EAAE,GAAkB;IACpE,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAC/B,MAAM,IAAI,aAAa,CACtB,oEAAoE;YACnE,GAAG,QAAQ,oDAAoD,CAChE,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,MAAM,IAAI,aAAa,CAAC,YAAY,QAAQ,UAAU,GAAG,CAAC,UAAU,OAAO,CAAC,CAAC;IACjG,MAAM,OAAO,GAA2B,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAExG,IAAI,GAAG,CAAC,OAAO,KAAK,oBAAoB;QAAE,OAAO,qBAAqB,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAE/F,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACnF,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,aAAa,CAAC,GAAG,KAAK,CAAC,OAAO,yBAAyB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5F,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAuC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;SACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SACpD,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;SACzC,IAAI,EAAE,CAAC;AACV,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,qBAAqB,CAAC,OAAe,EAAE,OAA+B;IACpF,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,GAAG,IAAI,uBAAuB,kBAAkB,CAAC,iBAAiB,CAAC,sBAAsB,IAAI,EAAE,CAAC;QAC5G,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,aAAa,CAAC,GAAG,IAAI,gCAAgC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1F,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA2C,CAAC;QAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;QACpH,8FAA8F;QAC9F,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG;YAAE,MAAM;IAC9B,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACrB,CAAC"}

package/dist/model-pairs.d.ts

@@ -0,0 +1,38 @@
+export interface ModelPair {
+    /** Conversational turns — cheap. */
+    readonly fast: string;
+    /** The hard turns — the tier where models actually diverge. */
+    readonly strong: string;
+}
+export type PairTier = keyof ModelPair;
+/**
+ * Model ids are config, not architecture: the qwen ids were verified against
+ * the DashScope /models endpoint (2026-08-15) — update them here when the
+ * catalog moves, nothing else needs to change.
+ */
+export declare const MODEL_PAIRS: Readonly<Record<string, ModelPair>>;
+/**
+ * Sampling defaults per provider (builder-harness.md H4). Qwen's own
+ * recommendation — and opencode's shipped per-family table — is 0.55 for the
+ * qwen family; the SDK default (1.0) is measurably chattier and loopier on
+ * agentic runs. topP 0.8 is Qwen's published qwen3-coder setting; without
+ * nucleus truncation the family degenerates into single-token repetition loops
+ * mid-turn. Others: undefined — adaptive thinking dislikes a pinned
+ * temperature, and the SDK default is the provider's own.
+ */
+export declare function samplingFor(spec: string): {
+    temperature?: number;
+    topP?: number;
+};
+/** The `<provider>:auto` pair a spec names, or null for a concrete spec. */
+export declare function pairFor(spec: string): {
+    provider: string;
+    pair: ModelPair;
+} | null;
+/**
+ * `qwen:auto` + tier → a concrete spec; concrete specs pass through untouched.
+ * `<provider>:auto` for a provider with no declared pair also passes through —
+ * the provider's own "model not exist" error names the fix better than we can.
+ */
+export declare function resolveAutoSpec(spec: string, tier: PairTier): string;
+//# sourceMappingURL=model-pairs.d.ts.map

package/dist/model-pairs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-pairs.d.ts","sourceRoot":"","sources":["../src/model-pairs.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,SAAS;IACzB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAG3D,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAEjF;AAED,4EAA4E;AAC5E,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG,IAAI,CAKlF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAIpE"}

package/dist/model-pairs.js

@@ -0,0 +1,56 @@
+/**
+ * Auto model pairs — a provider-scoped {fast, strong} pair behind the spec
+ * `<provider>:auto`, resolved per tier at call time: conversational turns run
+ * the fast model, the hard agentic turns run the strong one.
+ *
+ * Pairs never cross a provider: the provider choice is a consent decision (the
+ * picker's D-53 disclosure — WHERE the data goes), so auto-routing must stay
+ * inside the provider the user picked. A mixed pair is a deliberate future
+ * feature gated on both credentials being configured — never an implicit
+ * fallback.
+ *
+ * Worker-safe on purpose: every host and every catalog import this, so the
+ * pair the picker SHOWS is the pair the turn loop RUNS.
+ */
+import { parseModelSpec } from './spec.js';
+/**
+ * Model ids are config, not architecture: the qwen ids were verified against
+ * the DashScope /models endpoint (2026-08-15) — update them here when the
+ * catalog moves, nothing else needs to change.
+ */
+export const MODEL_PAIRS = {
+    qwen: { fast: 'qwen3.6-flash', strong: 'qwen3.8-max' },
+    anthropic: { fast: 'claude-sonnet-5', strong: 'claude-opus-5' },
+};
+/**
+ * Sampling defaults per provider (builder-harness.md H4). Qwen's own
+ * recommendation — and opencode's shipped per-family table — is 0.55 for the
+ * qwen family; the SDK default (1.0) is measurably chattier and loopier on
+ * agentic runs. topP 0.8 is Qwen's published qwen3-coder setting; without
+ * nucleus truncation the family degenerates into single-token repetition loops
+ * mid-turn. Others: undefined — adaptive thinking dislikes a pinned
+ * temperature, and the SDK default is the provider's own.
+ */
+export function samplingFor(spec) {
+    return parseModelSpec(spec).provider === 'qwen' ? { temperature: 0.55, topP: 0.8 } : {};
+}
+/** The `<provider>:auto` pair a spec names, or null for a concrete spec. */
+export function pairFor(spec) {
+    const { provider, modelId } = parseModelSpec(spec);
+    if (modelId !== 'auto')
+        return null;
+    const pair = MODEL_PAIRS[provider];
+    return pair ? { provider, pair } : null;
+}
+/**
+ * `qwen:auto` + tier → a concrete spec; concrete specs pass through untouched.
+ * `<provider>:auto` for a provider with no declared pair also passes through —
+ * the provider's own "model not exist" error names the fix better than we can.
+ */
+export function resolveAutoSpec(spec, tier) {
+    const hit = pairFor(spec);
+    if (!hit)
+        return spec;
+    return `${hit.provider}:${hit.pair[tier]}`;
+}
+//# sourceMappingURL=model-pairs.js.map

package/dist/model-pairs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-pairs.js","sourceRoot":"","sources":["../src/model-pairs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAW3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAwC;IAC/D,IAAI,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE;IACtD,SAAS,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,eAAe,EAAE;CAC/D,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACvC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACzF,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,OAAO,CAAC,IAAY;IACnC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,IAAc;IAC3D,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,GAAG,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC5C,CAAC"}

package/dist/pricing.d.ts

@@ -0,0 +1,52 @@
+export interface RateTier {
+    /**
+     * Inclusive upper bound on the request's total input tokens for this tier;
+     * null = top (or only) tier. Tiers are ordered ascending.
+     */
+    readonly upToInputTokens: number | null;
+    /** Provider list price in USD per 1M tokens, decimal strings. */
+    readonly inputPer1M: string;
+    readonly outputPer1M: string;
+    /** null = provider publishes no cache pricing; that slice bills at input rate. */
+    readonly cacheReadPer1M: string | null;
+    readonly cacheWritePer1M: string | null;
+}
+export interface ModelRate {
+    readonly provider: string;
+    /** Longest-prefix match on the model id, so dated snapshots (`qwen3.8-max-2026-01-01`) price as their base model. */
+    readonly idPrefix: string;
+    readonly label: string;
+    /** Smallest context both catalogs agree on; null when neither reports one. */
+    readonly contextTokens: number | null;
+    readonly tiers: readonly RateTier[];
+    /** Where the numbers came from, for the audit trip back to the price page. */
+    readonly sources: readonly string[];
+}
+/**
+ * One provider request's token counts. `inputTokens` is the TOTAL input the
+ * provider reported, INCLUDING the cached slices — the AI SDK's usage shape —
+ * so the non-cached remainder is computed here, in one place.
+ */
+export interface StepTokens {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cachedInputTokens?: number;
+    readonly cacheWriteTokens?: number;
+}
+/** The card entry for a `provider:model`, by longest id prefix; null = unpriced. */
+export declare function rateFor(model: string): ModelRate | null;
+/**
+ * Price a turn from its per-request steps — the correct path (see header).
+ * USD list price as a decimal string; null when the model has no rate card
+ * entry — unpriced, never guessed.
+ */
+export declare function listCostOfSteps(model: string, steps: readonly StepTokens[]): string | null;
+/**
+ * Legacy totals path: ledger entries recorded before per-step usage carry only
+ * turn totals, with no step split and no cache breakdown. Priced as ONE
+ * pseudo-request — for a single-tier card this equals the per-step price
+ * exactly; for a tiered card it can only over-select the tier, so a read side
+ * uses recorded costs whenever they exist and falls back here only for old rows.
+ */
+export declare function listCostOf(model: string, inputTokens: number, outputTokens: number): string | null;
+//# sourceMappingURL=pricing.d.ts.map

package/dist/pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../src/pricing.ts"],"names":[],"mappings":"AAkCA,MAAM,WAAW,QAAQ;IACxB;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kFAAkF;IAClF,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qHAAqH;IACrH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,oFAAoF;AACpF,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CASvD;AAmBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,GAAG,IAAI,CAsB1F;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAElG"}