@substrat-run/model-providers 0.1.0

package/dist/qwen-cache.js

@@ -0,0 +1,118 @@
+/**
+ * Explicit context-cache markers for the qwen dialect (H4 follow-up).
+ *
+ * DashScope's cache is per-model: qwen3.8-max caches implicitly, but the flash
+ * tier caches ONLY when the request carries explicit Anthropic-style
+ * `cache_control: {type:'ephemeral'}` markers on CONTENT BLOCKS — verified
+ * against the token-plan gateway 2026-08-15: block-level markers cache ~99% of
+ * the prefix (creation billed at 125%, hits at 10%, 5-minute TTL, ≥1024-token
+ * blocks, max 4 markers/request); message-level markers are silently ignored,
+ * and `@ai-sdk/openai-compatible` can only emit message-level ones. So the
+ * markers are injected here, at the wire: a fetch wrapper rewrites each
+ * chat/completions body just-in-time.
+ *
+ * Placement is the same strategy `withMovingBreakpoint` runs for Claude —
+ * system prefix + the request's last message — and because the rewrite is
+ * stateless per request, the "moving" part comes free: each step marks its own
+ * tail, and the previous step's mark simply never existed on the wire again.
+ * Explicit markers are sent to ALL qwen models (max included): explicit read
+ * price (10%) undercuts the implicit discount, and the behavior is
+ * deterministic instead of best-effort.
+ *
+ * Worker-safe on purpose: both provider hosts (providers.ts, the node CLI, and
+ * providers-worker.ts, the hosted agent) wire this into `createOpenAICompatible`.
+ */
+const CACHE_CONTROL = { type: 'ephemeral' };
+/** DashScope allows 4 markers per request; one is reserved for the tail. */
+const MAX_SYSTEM_MARKERS = 3;
+/** Marks a message's content in block form. Returns null when it cannot carry
+ * a marker (no content — e.g. an assistant message that is only tool_calls). */
+function markMessage(m) {
+    if (typeof m.content === 'string') {
+        // DashScope rejects empty text blocks; an empty string cannot cache anyway.
+        if (m.content === '')
+            return null;
+        return {
+            ...m,
+            content: [{ type: 'text', text: m.content, cache_control: CACHE_CONTROL }],
+        };
+    }
+    if (Array.isArray(m.content) && m.content.length > 0) {
+        const blocks = m.content;
+        const last = blocks[blocks.length - 1];
+        if (typeof last !== 'object' || last === null)
+            return null;
+        return {
+            ...m,
+            content: [...blocks.slice(0, -1), { ...last, cache_control: CACHE_CONTROL }],
+        };
+    }
+    return null;
+}
+/**
+ * The body transform: marker on each system message (the cross-turn-stable
+ * prefix — the only part reusable between turns) and on the last markable
+ * message (the within-turn moving breakpoint — each tool-loop step re-reads
+ * everything before its own tail from cache). Non-chat bodies pass through
+ * untouched.
+ */
+export function withQwenCacheMarkers(body) {
+    const b = body;
+    if (b === null || typeof b !== 'object' || !Array.isArray(b.messages))
+        return body;
+    const messages = b.messages.slice();
+    // The moving tail marker first — it is the one that compounds. Walk back
+    // past messages that cannot carry a block (tool_calls-only assistants).
+    let tail = -1;
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (msg.role === 'system')
+            break; // nothing but prefix left — its own markers below
+        const marked = markMessage(msg);
+        if (marked) {
+            messages[i] = marked;
+            tail = i;
+            break;
+        }
+    }
+    let budget = MAX_SYSTEM_MARKERS;
+    for (let i = 0; i < messages.length && budget > 0; i++) {
+        const msg = messages[i];
+        if (msg.role !== 'system' || i === tail)
+            continue;
+        const marked = markMessage(msg);
+        if (marked) {
+            messages[i] = marked;
+            budget -= 1;
+        }
+    }
+    return { ...body, messages };
+}
+/**
+ * Fetch wrapper for the qwen provider: rewrites POST chat/completions bodies
+ * through `withQwenCacheMarkers`. Anything unexpected — non-chat URL, a
+ * Request-object body, unparseable JSON — passes through unchanged: a request
+ * without markers is merely uncached, never broken.
+ */
+export function qwenCacheFetch(inner) {
+    const base = inner ?? ((...args) => globalThis.fetch(...args));
+    // Typed via the fetch signature itself — this file compiles under both the
+    // node and workers tsconfigs, which disagree on the DOM lib types.
+    const wrapped = async (input, init) => {
+        const url = typeof input === 'string'
+            ? input
+            : (input.url ?? String(input));
+        if (!url.includes('/chat/completions') || typeof init?.body !== 'string') {
+            return base(input, init);
+        }
+        try {
+            const body = JSON.stringify(withQwenCacheMarkers(JSON.parse(init.body)));
+            return base(input, { ...init, body });
+        }
+        catch {
+            return base(input, init);
+        }
+    };
+    return wrapped;
+}
+//# sourceMappingURL=qwen-cache.js.map

package/dist/qwen-cache.js.map

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

package/dist/rate-card.generated.d.ts

@@ -0,0 +1,16 @@
+/**
+ * GENERATED by scripts/update-rate-card.mjs — DO NOT EDIT.
+ *
+ * Regenerate: pnpm --filter @substrat-run/model-providers update-rate-card
+ * (review the diff — this file is the billing checkpoint, docs/architecture/builder/harness.md §2.2).
+ *
+ * Sources cross-checked at generation: models.dev api.json × LiteLLM
+ * model_prices_and_context_window.json (both MIT). Rates are provider LIST
+ * prices in USD per 1M tokens, decimal strings. Tier selection is
+ * all-or-nothing by the request's total input tokens (DashScope/Anthropic
+ * threshold semantics — the whole request bills at the tier it lands in).
+ */
+import type { ModelRate } from './pricing.js';
+export declare const RATE_CARD_GENERATED_AT = "2026-08-15";
+export declare const RATE_CARD: readonly ModelRate[];
+//# sourceMappingURL=rate-card.generated.d.ts.map

package/dist/rate-card.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-card.generated.d.ts","sourceRoot":"","sources":["../src/rate-card.generated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,eAAO,MAAM,sBAAsB,eAAe,CAAC;AAEnD,eAAO,MAAM,SAAS,EAAE,SAAS,SAAS,EA6EzC,CAAC"}

package/dist/rate-card.generated.js

@@ -0,0 +1,80 @@
+export const RATE_CARD_GENERATED_AT = '2026-08-15';
+export const RATE_CARD = [
+    {
+        "provider": "qwen",
+        "idPrefix": "qwen3.6-flash",
+        "label": "Qwen 3.6 Flash",
+        "contextTokens": 1000000,
+        "tiers": [
+            {
+                "upToInputTokens": null,
+                "inputPer1M": "0.1875",
+                "outputPer1M": "1.125",
+                "cacheReadPer1M": null,
+                "cacheWritePer1M": "0.234375"
+            }
+        ],
+        "sources": [
+            "models.dev:alibaba/qwen3.6-flash"
+        ]
+    },
+    {
+        "provider": "qwen",
+        "idPrefix": "qwen3.8-max",
+        "label": "Qwen 3.8 Max",
+        "contextTokens": 991808,
+        "tiers": [
+            {
+                "upToInputTokens": null,
+                "inputPer1M": "2",
+                "outputPer1M": "6",
+                "cacheReadPer1M": "0.25",
+                "cacheWritePer1M": "2.5"
+            }
+        ],
+        "sources": [
+            "models.dev:alibaba/qwen3.8-max",
+            "litellm:dashscope/qwen3.8-max",
+            "https://www.alibabacloud.com/help/en/model-studio/models"
+        ]
+    },
+    {
+        "provider": "anthropic",
+        "idPrefix": "claude-sonnet-5",
+        "label": "Claude Sonnet 5",
+        "contextTokens": 1000000,
+        "tiers": [
+            {
+                "upToInputTokens": null,
+                "inputPer1M": "2",
+                "outputPer1M": "10",
+                "cacheReadPer1M": "0.2",
+                "cacheWritePer1M": "2.5"
+            }
+        ],
+        "sources": [
+            "models.dev:anthropic/claude-sonnet-5",
+            "litellm:claude-sonnet-5"
+        ]
+    },
+    {
+        "provider": "anthropic",
+        "idPrefix": "claude-opus-5",
+        "label": "Claude Opus 5",
+        "contextTokens": 1000000,
+        "tiers": [
+            {
+                "upToInputTokens": null,
+                "inputPer1M": "5",
+                "outputPer1M": "25",
+                "cacheReadPer1M": "0.5",
+                "cacheWritePer1M": "6.25"
+            }
+        ],
+        "sources": [
+            "models.dev:anthropic/claude-opus-5",
+            "litellm:claude-opus-5"
+        ]
+    }
+];
+//# sourceMappingURL=rate-card.generated.js.map

package/dist/rate-card.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-card.generated.js","sourceRoot":"","sources":["../src/rate-card.generated.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,sBAAsB,GAAG,YAAY,CAAC;AAEnD,MAAM,CAAC,MAAM,SAAS,GAAyB;IAC9C;QACC,UAAU,EAAE,MAAM;QAClB,UAAU,EAAE,eAAe;QAC3B,OAAO,EAAE,gBAAgB;QACzB,eAAe,EAAE,OAAO;QACxB,OAAO,EAAE;YACR;gBACC,iBAAiB,EAAE,IAAI;gBACvB,YAAY,EAAE,QAAQ;gBACtB,aAAa,EAAE,OAAO;gBACtB,gBAAgB,EAAE,IAAI;gBACtB,iBAAiB,EAAE,UAAU;aAC7B;SACD;QACD,SAAS,EAAE;YACV,kCAAkC;SAClC;KACD;IACD;QACC,UAAU,EAAE,MAAM;QAClB,UAAU,EAAE,aAAa;QACzB,OAAO,EAAE,cAAc;QACvB,eAAe,EAAE,MAAM;QACvB,OAAO,EAAE;YACR;gBACC,iBAAiB,EAAE,IAAI;gBACvB,YAAY,EAAE,GAAG;gBACjB,aAAa,EAAE,GAAG;gBAClB,gBAAgB,EAAE,MAAM;gBACxB,iBAAiB,EAAE,KAAK;aACxB;SACD;QACD,SAAS,EAAE;YACV,gCAAgC;YAChC,+BAA+B;YAC/B,0DAA0D;SAC1D;KACD;IACD;QACC,UAAU,EAAE,WAAW;QACvB,UAAU,EAAE,iBAAiB;QAC7B,OAAO,EAAE,iBAAiB;QAC1B,eAAe,EAAE,OAAO;QACxB,OAAO,EAAE;YACR;gBACC,iBAAiB,EAAE,IAAI;gBACvB,YAAY,EAAE,GAAG;gBACjB,aAAa,EAAE,IAAI;gBACnB,gBAAgB,EAAE,KAAK;gBACvB,iBAAiB,EAAE,KAAK;aACxB;SACD;QACD,SAAS,EAAE;YACV,sCAAsC;YACtC,yBAAyB;SACzB;KACD;IACD;QACC,UAAU,EAAE,WAAW;QACvB,UAAU,EAAE,eAAe;QAC3B,OAAO,EAAE,eAAe;QACxB,eAAe,EAAE,OAAO;QACxB,OAAO,EAAE;YACR;gBACC,iBAAiB,EAAE,IAAI;gBACvB,YAAY,EAAE,GAAG;gBACjB,aAAa,EAAE,IAAI;gBACnB,gBAAgB,EAAE,KAAK;gBACvB,iBAAiB,EAAE,MAAM;aACzB;SACD;QACD,SAAS,EAAE;YACV,oCAAoC;YACpC,uBAAuB;SACvB;KACD;CACD,CAAC"}

package/dist/request.d.ts

@@ -0,0 +1,10 @@
+import type { CredentialEnv } from './resolve.js';
+/** Attribution as the wire takes it — flat, five keys, scalar values. */
+export type WireAttribution = Readonly<Record<string, string | number | boolean>>;
+export interface RequestExtrasInput {
+    readonly attribution: WireAttribution;
+    readonly env: CredentialEnv;
+}
+/** The per-request headers a row wants, or none. Pure. */
+export declare function requestHeadersFor(provider: string, input: RequestExtrasInput): Record<string, string>;
+//# sourceMappingURL=request.d.ts.map

package/dist/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,yEAAyE;AACzE,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;AAElF,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;CAC5B;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBrG"}

package/dist/request.js

@@ -0,0 +1,44 @@
+/**
+ * Per-request extras, by row — what a host attaches to one call beyond the prompt.
+ *
+ * The only consumer today is Cloudflare's AI Gateway, whose extras are all headers:
+ *
+ *   - `cf-aig-metadata`            the call's attribution, as JSON. The gateway keeps at
+ *                                  most FIVE keys, which is why `ModelAttribution` is
+ *                                  fixed at five — a sixth would drop silently here.
+ *   - `cf-aig-collect-log-payload` `false`: the gateway logs token counts, model, cost
+ *                                  and duration but never the prompt or the answer. The
+ *                                  D-54 subprocessor promise, made true on the wire.
+ *   - `cf-aig-gateway-id`          which gateway, when the platform has named one
+ *                                  (`CLOUDFLARE_AI_GATEWAY_ID`); absent, the account's
+ *                                  default gateway serves the request.
+ *
+ * What is deliberately NOT here: a spend limit. That is gateway configuration keyed on
+ * the same metadata (per tenant, per day), set by the operator and enforced by the
+ * gateway — a second guard beneath the host's own budget policy, never the only one.
+ *
+ * A row with no `request` kind sends nothing extra, and the host never learns which
+ * case it was in.
+ */
+import { providerRow } from './providers.js';
+/** The per-request headers a row wants, or none. Pure. */
+export function requestHeadersFor(provider, input) {
+    const row = providerRow(provider);
+    if (!row || row.kind !== 'compatible' || !row.request)
+        return {};
+    switch (row.request) {
+        case 'cloudflare-gateway': {
+            const keys = Object.keys(input.attribution);
+            if (keys.length > 5) {
+                throw new RangeError(`AI Gateway keeps five metadata keys; ${keys.length} were given (${keys.join(', ')})`);
+            }
+            const gateway = input.env['CLOUDFLARE_AI_GATEWAY_ID'];
+            return {
+                'cf-aig-metadata': JSON.stringify(input.attribution),
+                'cf-aig-collect-log-payload': 'false',
+                ...(gateway ? { 'cf-aig-gateway-id': gateway } : {}),
+            };
+        }
+    }
+}
+//# sourceMappingURL=request.js.map

package/dist/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAW7C,0DAA0D;AAC1D,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,KAAyB;IAC5E,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,GAAG,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACjE,QAAQ,GAAG,CAAC,OAAO,EAAE,CAAC;QACrB,KAAK,oBAAoB,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC5C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,IAAI,UAAU,CACnB,wCAAwC,IAAI,CAAC,MAAM,gBAAgB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACrF,CAAC;YACH,CAAC;YACD,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;YACtD,OAAO;gBACN,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC;gBACpD,4BAA4B,EAAE,OAAO;gBACrC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpD,CAAC;QACH,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/resolve.d.ts

@@ -0,0 +1,62 @@
+import type { LanguageModel } from 'ai';
+import { type ProviderSpec } from './providers.js';
+export declare class ProviderError extends Error {
+    constructor(message: string);
+}
+/** A credential environment — `process.env`, a Worker's bindings, or a test's literal. */
+export type CredentialEnv = Readonly<Record<string, string | undefined>>;
+/** What a provider row resolves to against one environment. */
+export interface ProviderCredentials {
+    readonly apiKey?: string;
+    /** Effective endpoint (compatible rows) or override (direct rows); '' when unset and required. */
+    readonly baseUrl: string;
+    /** Which env var supplied the endpoint, or 'default'. */
+    readonly baseUrlSource: 'default' | string;
+    /** Env vars the row needs and the environment does not carry. */
+    readonly missing: readonly string[];
+}
+/**
+ * Read a provider's credential and endpoint from an environment — pure, no
+ * process access, so a Worker and the CLI resolve identically from their own
+ * sources.
+ */
+export declare function credentialsFrom(provider: string, env: CredentialEnv): ProviderCredentials;
+/** The `createX` shape every AI SDK direct provider exports. */
+export type DirectFactory = (config: {
+    apiKey?: string;
+    baseURL?: string;
+}) => (modelId: string) => LanguageModel;
+/** Direct-provider factories keyed by provider name — `{ anthropic: createAnthropic }`. */
+export type DirectFactories = Readonly<Record<string, DirectFactory | undefined>>;
+export interface ResolvedModel {
+    readonly model: LanguageModel;
+    /** `provider/modelId` — the label ledgers and banners show. */
+    readonly label: string;
+    readonly provider: string;
+    readonly modelId: string;
+    /**
+     * The endpoint this model will actually call, and which env var chose it.
+     * Surfaced because a silently-ignored base-URL override is otherwise
+     * invisible until a request fails — and then it looks like a bad key.
+     */
+    readonly endpoint?: string;
+    readonly endpointSource?: 'default' | string;
+}
+export interface CreateModelOptions {
+    /** Direct-provider factories the host loaded. A direct row with no factory here is refused. */
+    readonly factories?: DirectFactories;
+    /**
+     * Turns a missing env var into the host's own advice ("set it in .env" vs
+     * "set it as a worker secret"). Default names the variable and stops.
+     */
+    readonly describeMissing?: (envVar: string, provider: string) => string;
+    /** Refuse rows marked `local` — a hosted runtime cannot dial localhost. */
+    readonly hosted?: boolean;
+}
+/**
+ * Build the model. Every refusal is a `ProviderError` with the next step in it.
+ */
+export declare function createModel(spec: string, env: CredentialEnv, options?: CreateModelOptions): ResolvedModel;
+/** The row for a provider, or a ProviderError naming the known ones. */
+export declare function providerSpec(provider: string): ProviderSpec;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI3E,qBAAa,aAAc,SAAQ,KAAK;IACvC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD;AAED,0FAA0F;AAC1F,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAEzE,+DAA+D;AAC/D,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kGAAkG;IAClG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,QAAQ,CAAC,aAAa,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3C,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,mBAAmB,CAyBzF;AAED,gEAAgE;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,CAAC,OAAO,EAAE,MAAM,KAAK,aAAa,CAAC;AAElH,2FAA2F;AAC3F,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC,CAAC,CAAC;AAElF,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAC7C;AAED,MAAM,WAAW,kBAAkB;IAClC,+FAA+F;IAC/F,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IACxE,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,OAAO,GAAE,kBAAuB,GAAG,aAAa,CAuD7G;AASD,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAI3D"}

package/dist/resolve.js

@@ -0,0 +1,121 @@
+/**
+ * `provider:model` + credentials → a `LanguageModel`, with the host deciding
+ * WHERE credentials come from and HOW provider packages are loaded.
+ *
+ * Two hosts exist today and they differ on exactly those two axes: the builder
+ * CLI reads `process.env` and imports provider packages dynamically; a Worker
+ * reads its bindings and can only import statically. So the resolver takes the
+ * credential environment as a plain record and the direct-provider factories as
+ * a map — the table (providers.ts) says which env var and which factory NAME,
+ * the host supplies the values. Nothing here touches `process`.
+ *
+ * Compatible providers need no injection: `@ai-sdk/openai-compatible` is a
+ * dependency of this package, imported statically, and safe everywhere.
+ */
+import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
+import { PROVIDERS, providerRow } from './providers.js';
+import { qwenCacheFetch } from './qwen-cache.js';
+import { parseModelSpec } from './spec.js';
+export class ProviderError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ProviderError';
+    }
+}
+/**
+ * Read a provider's credential and endpoint from an environment — pure, no
+ * process access, so a Worker and the CLI resolve identically from their own
+ * sources.
+ */
+export function credentialsFrom(provider, env) {
+    const spec = providerRow(provider);
+    if (!spec)
+        throw unknownProvider(provider);
+    const missing = [];
+    const apiKey = spec.envVar ? env[spec.envVar] : undefined;
+    if (spec.envVar && !apiKey)
+        missing.push(spec.envVar);
+    if (spec.kind === 'direct') {
+        const override = spec.baseUrlEnv ? env[spec.baseUrlEnv] : undefined;
+        return {
+            ...(apiKey ? { apiKey } : {}),
+            baseUrl: override ?? '',
+            baseUrlSource: override && spec.baseUrlEnv ? spec.baseUrlEnv : 'default',
+            missing,
+        };
+    }
+    const override = env[spec.baseUrlEnv];
+    const baseUrl = override ?? spec.baseUrl;
+    if (!baseUrl)
+        missing.push(spec.baseUrlEnv);
+    return {
+        ...(apiKey ? { apiKey } : {}),
+        baseUrl,
+        baseUrlSource: override ? spec.baseUrlEnv : 'default',
+        missing,
+    };
+}
+/**
+ * Build the model. Every refusal is a `ProviderError` with the next step in it.
+ */
+export function createModel(spec, env, options = {}) {
+    const { provider, modelId } = parseModelSpec(spec);
+    const row = providerRow(provider);
+    if (!row)
+        throw unknownProvider(provider);
+    if (!modelId)
+        throw new ProviderError(`no model id in ${JSON.stringify(spec)}`);
+    if (options.hosted && row.hosting.local) {
+        throw new ProviderError(`${provider} is local-machine inference — it does not exist on a hosted runtime. Use a local host for local models.`);
+    }
+    const creds = credentialsFrom(provider, env);
+    if (creds.missing.length) {
+        const describe = options.describeMissing ?? ((v) => `${v} is not set.`);
+        throw new ProviderError(`provider ${provider} is not configured.\n` + creds.missing.map((v) => `  ${describe(v, provider)}`).join('\n'));
+    }
+    const label = `${provider}/${modelId}`;
+    if (row.kind === 'direct') {
+        const create = options.factories?.[provider];
+        if (!create) {
+            throw new ProviderError(`provider ${provider} needs ${row.pkg} (${row.createFactory}) loaded by the host — it is not wired here.`);
+        }
+        const built = create({
+            ...(creds.apiKey ? { apiKey: creds.apiKey } : {}),
+            ...(creds.baseUrl ? { baseURL: creds.baseUrl } : {}),
+        });
+        return {
+            model: built(modelId),
+            label,
+            provider,
+            modelId,
+            ...(creds.baseUrl ? { endpoint: creds.baseUrl, endpointSource: creds.baseUrlSource } : {}),
+        };
+    }
+    const factory = createOpenAICompatible({
+        name: provider,
+        baseURL: creds.baseUrl,
+        // Local runtimes ignore this but the client still wants a value.
+        apiKey: creds.apiKey ?? 'local',
+        ...(row.wire === 'qwen-cache' ? { fetch: qwenCacheFetch() } : {}),
+    });
+    return {
+        model: factory(modelId),
+        label,
+        provider,
+        modelId,
+        endpoint: creds.baseUrl,
+        endpointSource: creds.baseUrlSource,
+    };
+}
+function unknownProvider(provider) {
+    return new ProviderError(`unknown provider ${JSON.stringify(provider)}. Known: ${Object.keys(PROVIDERS).join(', ')}\n` +
+        `  Use provider:model, e.g. anthropic:claude-opus-5 — or provider:auto for a declared pair`);
+}
+/** The row for a provider, or a ProviderError naming the known ones. */
+export function providerSpec(provider) {
+    const row = providerRow(provider);
+    if (!row)
+        throw unknownProvider(provider);
+    return row;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

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

package/dist/spec.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The `provider:model` grammar — the one string every host, picker, ledger and
+ * rate-card lookup agrees on.
+ *
+ * `anthropic:claude-opus-5`, `cloudflare:@cf/zai-org/glm-5.2`, `scaleway:…`. A
+ * bare id with no colon is an Anthropic model, because that is the default
+ * provider — and the default lives HERE, once, so `claude-opus-5` and
+ * `anthropic:claude-opus-5` land on one meter rather than two.
+ */
+export declare const DEFAULT_PROVIDER = "anthropic";
+export interface ModelSpec {
+    readonly provider: string;
+    readonly modelId: string;
+}
+/** Split a spec; the provider defaults, the model id may be empty (callers refuse that). */
+export declare function parseModelSpec(spec: string): ModelSpec;
+/** `provider:modelId` with the default provider made explicit. */
+export declare function normalizeModelSpec(spec: string): string;
+/** The provider half alone — for error messages and per-provider lookups. */
+export declare function providerOf(spec: string): string;
+//# sourceMappingURL=spec.d.ts.map

package/dist/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../src/spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAE5C,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAItD;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/spec.js

@@ -0,0 +1,27 @@
+/**
+ * The `provider:model` grammar — the one string every host, picker, ledger and
+ * rate-card lookup agrees on.
+ *
+ * `anthropic:claude-opus-5`, `cloudflare:@cf/zai-org/glm-5.2`, `scaleway:…`. A
+ * bare id with no colon is an Anthropic model, because that is the default
+ * provider — and the default lives HERE, once, so `claude-opus-5` and
+ * `anthropic:claude-opus-5` land on one meter rather than two.
+ */
+export const DEFAULT_PROVIDER = 'anthropic';
+/** Split a spec; the provider defaults, the model id may be empty (callers refuse that). */
+export function parseModelSpec(spec) {
+    const idx = spec.indexOf(':');
+    if (idx === -1)
+        return { provider: DEFAULT_PROVIDER, modelId: spec };
+    return { provider: spec.slice(0, idx), modelId: spec.slice(idx + 1) };
+}
+/** `provider:modelId` with the default provider made explicit. */
+export function normalizeModelSpec(spec) {
+    const { provider, modelId } = parseModelSpec(spec);
+    return `${provider}:${modelId}`;
+}
+/** The provider half alone — for error messages and per-provider lookups. */
+export function providerOf(spec) {
+    return parseModelSpec(spec).provider;
+}
+//# sourceMappingURL=spec.js.map

package/dist/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../src/spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAO5C,4FAA4F;AAC5F,MAAM,UAAU,cAAc,CAAC,IAAY;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACrE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC9C,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACnD,OAAO,GAAG,QAAQ,IAAI,OAAO,EAAE,CAAC;AACjC,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,UAAU,CAAC,IAAY;IACtC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC;AACtC,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@substrat-run/model-providers",
+  "version": "0.1.0",
+  "description": "The model-provider seam: one `provider:model` grammar, a table of providers (Anthropic, OpenAI, Google, Mistral, Qwen, Cloudflare, Scaleway, Ollama, any OpenAI-compatible endpoint), the hosting disclosure per provider, the generated rate card and the list-price math over it. Cloudflare is one row, not the design (#1054).",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/substrat-run/substrat.git",
+    "directory": "packages/model-providers"
+  },
+  "homepage": "https://substrat.net/reference/model-providers",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "update-rate-card": "node scripts/update-rate-card.mjs"
+  },
+  "dependencies": {
+    "@ai-sdk/openai-compatible": "3.0.30",
+    "@substrat-run/contracts": "workspace:^",
+    "ai": "7.0.62"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.0",
+    "vitest": "catalog:"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}