@wrenautomation/models 0.0.0-stage → 0.1.0

package/dist/providers.d.ts

@@ -0,0 +1,66 @@
+import { type RotateOptions } from "./keys.js";
+import type { Model } from "./types.js";
+/** Short names for the current Claude models. A full id passes through. */
+export declare const ANTHROPIC_MODELS: Readonly<Record<string, string>>;
+export declare const anthropicModelId: (name: string) => string;
+export interface VendorOptions {
+    key: string | readonly string[];
+    /** A model id or, on Anthropic, a short name. */
+    model?: string;
+    rotate?: RotateOptions;
+    limitMs?: number;
+    /** For tests: the wire. */
+    fetch?: typeof fetch;
+}
+/** Claude on Wren's own key. Default Haiku 5.5. */
+export declare function anthropic(o: VendorOptions): Model;
+/** Gemini on the free key ring. It takes every part kind, YouTube URLs as video included. */
+export declare function gemini(o: VendorOptions): Model;
+/** Cohere's own API on the free key ring: text and images. */
+export declare function cohere(o: VendorOptions): Model;
+/** OpenAI-compatible vendors: base URL, default model, and whether Wren's keys there are free. */
+export declare const COMPATIBLE: {
+    readonly groq: {
+        readonly baseURL: "https://api.groq.com/openai/v1";
+        readonly model: "openai/gpt-oss-120b";
+        readonly free: () => boolean;
+    };
+    readonly openrouter: {
+        readonly baseURL: "https://openrouter.ai/api/v1";
+        readonly model: "google/gemma-4-31b-it:free";
+        readonly free: (m: string) => boolean;
+    };
+    readonly mistral: {
+        readonly baseURL: "https://api.mistral.ai/v1";
+        readonly model: "mistral-small-latest";
+        readonly free: () => boolean;
+    };
+    readonly cerebras: {
+        readonly baseURL: "https://api.cerebras.ai/v1";
+        readonly model: "gpt-oss-120b";
+        readonly free: () => boolean;
+    };
+    readonly openai: {
+        readonly baseURL: "https://api.openai.com/v1";
+        readonly model: "gpt-5-mini";
+        readonly free: () => boolean;
+    };
+};
+export type CompatibleVendor = keyof typeof COMPATIBLE;
+export declare const isCompatible: (v: string) => v is CompatibleVendor;
+export declare function compatible(vendor: CompatibleVendor, o: VendorOptions): Model;
+/** The gateway's Gemini spends output tokens thinking first: 400 asked came back as 27 chars. */
+export declare const GATEWAY_THINKING = 4096;
+/** `<url>/v1`; a URL given with its `/v1` is not doubled. */
+export declare const gatewayBase: (url: string) => string;
+/**
+ * Wren's LLM gateway (llm.wrenautomation.com): it holds the free keys and one ledger. Its model is
+ * an alias (`free`, `cohere`) or `<vendor>/<model>`. `free` costs 0.
+ */
+export declare function gateway(o: {
+    url: string;
+    token: string;
+    model?: string;
+    limitMs?: number;
+    fetch?: typeof fetch;
+}): Model;

package/dist/providers.js

@@ -0,0 +1,122 @@
+/**
+ * The vendors. Each maker returns a `Model`; a list of keys returns one rotating over them.
+ * Free key rings (Cohere, Gemini, Groq, OpenRouter's `:free` models, the gateway's `free` alias)
+ * cost 0 and keep their list price; the rest are priced from the table.
+ */
+import { createAnthropic } from "@ai-sdk/anthropic";
+import { createCohere } from "@ai-sdk/cohere";
+import { createGoogle } from "@ai-sdk/google";
+import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
+import { rotating } from "./keys.js";
+import { TEXT_ONLY } from "./model.js";
+import { sdkModel } from "./sdk.js";
+const kinds = (...k) => new Set(k);
+const keyList = (key) => (typeof key === "string" ? [key] : key);
+const ring = (keys, make, o, vendor) => {
+    if (!keys.length)
+        throw new Error(`${vendor} needs at least one key`);
+    return rotating(keys.map(make), o);
+};
+/** Short names for the current Claude models. A full id passes through. */
+export const ANTHROPIC_MODELS = {
+    haiku: "claude-haiku-5-5",
+    sonnet: "claude-sonnet-5-5",
+    opus: "claude-opus-5-5",
+};
+export const anthropicModelId = (name) => ANTHROPIC_MODELS[name] ?? name;
+const wire = (o) => (o.fetch ? { fetch: o.fetch } : {});
+/** Claude on Wren's own key. Default Haiku 5.5. */
+export function anthropic(o) {
+    const modelId = anthropicModelId(o.model ?? "haiku");
+    return ring(keyList(o.key), (apiKey) => sdkModel({
+        provider: "anthropic",
+        modelId,
+        model: createAnthropic({ apiKey, ...wire(o) })(modelId),
+        takes: kinds("text", "image", "pdf"),
+        ...(o.limitMs ? { limitMs: o.limitMs } : {}),
+    }), o.rotate, "anthropic");
+}
+/** Gemini on the free key ring. It takes every part kind, YouTube URLs as video included. */
+export function gemini(o) {
+    const modelId = o.model ?? "gemini-3.5-flash";
+    return ring(keyList(o.key), (apiKey) => sdkModel({
+        provider: "google",
+        modelId,
+        model: createGoogle({ apiKey, ...wire(o) })(modelId),
+        takes: kinds("text", "image", "video", "audio", "pdf"),
+        free: true,
+        ...(o.limitMs ? { limitMs: o.limitMs } : {}),
+    }), o.rotate, "gemini");
+}
+/** Cohere's own API on the free key ring: text and images. */
+export function cohere(o) {
+    const modelId = o.model ?? "command-a-03-2025";
+    return ring(keyList(o.key), (apiKey) => sdkModel({
+        provider: "cohere",
+        modelId,
+        model: createCohere({ apiKey, ...wire(o) })(modelId),
+        takes: modelId.includes("vision") ? kinds("text", "image") : TEXT_ONLY,
+        free: true,
+        ...(o.limitMs ? { limitMs: o.limitMs } : {}),
+    }), o.rotate, "cohere");
+}
+/** OpenAI-compatible vendors: base URL, default model, and whether Wren's keys there are free. */
+export const COMPATIBLE = {
+    groq: {
+        baseURL: "https://api.groq.com/openai/v1",
+        model: "openai/gpt-oss-120b",
+        free: () => true,
+    },
+    openrouter: {
+        baseURL: "https://openrouter.ai/api/v1",
+        model: "google/gemma-4-31b-it:free",
+        free: (m) => m.endsWith(":free"),
+    },
+    mistral: {
+        baseURL: "https://api.mistral.ai/v1",
+        model: "mistral-small-latest",
+        free: () => false,
+    },
+    cerebras: { baseURL: "https://api.cerebras.ai/v1", model: "gpt-oss-120b", free: () => false },
+    openai: { baseURL: "https://api.openai.com/v1", model: "gpt-5-mini", free: () => false },
+};
+export const isCompatible = (v) => Object.hasOwn(COMPATIBLE, v);
+export function compatible(vendor, o) {
+    const spec = COMPATIBLE[vendor];
+    const modelId = o.model ?? spec.model;
+    return ring(keyList(o.key), (apiKey) => sdkModel({
+        provider: vendor,
+        modelId,
+        model: createOpenAICompatible({ name: vendor, baseURL: spec.baseURL, apiKey, ...wire(o) })(modelId),
+        takes: TEXT_ONLY,
+        free: spec.free(modelId),
+        ...(o.limitMs ? { limitMs: o.limitMs } : {}),
+    }), o.rotate, vendor);
+}
+/** The gateway's Gemini spends output tokens thinking first: 400 asked came back as 27 chars. */
+export const GATEWAY_THINKING = 4096;
+/** `<url>/v1`; a URL given with its `/v1` is not doubled. */
+export const gatewayBase = (url) => `${url.replace(/\/$/, "").replace(/\/v1$/, "")}/v1`;
+/**
+ * Wren's LLM gateway (llm.wrenautomation.com): it holds the free keys and one ledger. Its model is
+ * an alias (`free`, `cohere`) or `<vendor>/<model>`. `free` costs 0.
+ */
+export function gateway(o) {
+    const modelId = o.model ?? "free";
+    return sdkModel({
+        provider: "gateway",
+        modelId,
+        model: createOpenAICompatible({
+            name: "gateway",
+            baseURL: gatewayBase(o.url),
+            apiKey: o.token,
+            ...wire(o),
+        })(modelId),
+        takes: TEXT_ONLY,
+        thinking: GATEWAY_THINKING,
+        free: modelId === "free",
+        priceId: modelId.slice(modelId.indexOf("/") + 1),
+        ...(o.limitMs ? { limitMs: o.limitMs } : {}),
+    });
+}
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAsB,QAAQ,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGpC,MAAM,KAAK,GAAG,CAAC,GAAG,CAAa,EAAyB,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;AACtE,MAAM,OAAO,GAAG,CAAC,GAA+B,EAAE,EAAE,CAAC,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAE7F,MAAM,IAAI,GAAG,CACX,IAAuB,EACvB,IAA4B,EAC5B,CAA4B,EAC5B,MAAc,EACP,EAAE;IACT,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,yBAAyB,CAAC,CAAC;IACtE,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,gBAAgB,GAAqC;IAChE,KAAK,EAAE,kBAAkB;IACzB,MAAM,EAAE,mBAAmB;IAC3B,IAAI,EAAE,iBAAiB;CACxB,CAAC;AACF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AAYzF,MAAM,IAAI,GAAG,CAAC,CAA2B,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAElF,mDAAmD;AACnD,MAAM,UAAU,SAAS,CAAC,CAAgB;IACxC,MAAM,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC;IACrD,OAAO,IAAI,CACT,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACd,CAAC,MAAM,EAAE,EAAE,CACT,QAAQ,CAAC;QACP,QAAQ,EAAE,WAAW;QACrB,OAAO;QACP,KAAK,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;QACvD,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;QACpC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC,EACJ,CAAC,CAAC,MAAM,EACR,WAAW,CACZ,CAAC;AACJ,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,MAAM,CAAC,CAAgB;IACrC,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,IAAI,kBAAkB,CAAC;IAC9C,OAAO,IAAI,CACT,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACd,CAAC,MAAM,EAAE,EAAE,CACT,QAAQ,CAAC;QACP,QAAQ,EAAE,QAAQ;QAClB,OAAO;QACP,KAAK,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;QACpD,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC;QACtD,IAAI,EAAE,IAAI;QACV,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC,EACJ,CAAC,CAAC,MAAM,EACR,QAAQ,CACT,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,MAAM,CAAC,CAAgB;IACrC,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,IAAI,mBAAmB,CAAC;IAC/C,OAAO,IAAI,CACT,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACd,CAAC,MAAM,EAAE,EAAE,CACT,QAAQ,CAAC;QACP,QAAQ,EAAE,QAAQ;QAClB,OAAO;QACP,KAAK,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;QACpD,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;QACtE,IAAI,EAAE,IAAI;QACV,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC,EACJ,CAAC,CAAC,MAAM,EACR,QAAQ,CACT,CAAC;AACJ,CAAC;AAED,kGAAkG;AAClG,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE;QACJ,OAAO,EAAE,gCAAgC;QACzC,KAAK,EAAE,qBAAqB;QAC5B,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI;KACjB;IACD,UAAU,EAAE;QACV,OAAO,EAAE,8BAA8B;QACvC,KAAK,EAAE,4BAA4B;QACnC,IAAI,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;KACzC;IACD,OAAO,EAAE;QACP,OAAO,EAAE,2BAA2B;QACpC,KAAK,EAAE,sBAAsB;QAC7B,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK;KAClB;IACD,QAAQ,EAAE,EAAE,OAAO,EAAE,4BAA4B,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE;IAC7F,MAAM,EAAE,EAAE,OAAO,EAAE,2BAA2B,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE;CAChF,CAAC;AAGX,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAS,EAAyB,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;AAE/F,MAAM,UAAU,UAAU,CAAC,MAAwB,EAAE,CAAgB;IACnE,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC;IACtC,OAAO,IAAI,CACT,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACd,CAAC,MAAM,EAAE,EAAE,CACT,QAAQ,CAAC;QACP,QAAQ,EAAE,MAAM;QAChB,OAAO;QACP,KAAK,EAAE,sBAAsB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CACxF,OAAO,CACR;QACD,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;QACxB,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC,EACJ,CAAC,CAAC,MAAM,EACR,MAAM,CACP,CAAC;AACJ,CAAC;AAED,iGAAiG;AACjG,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC,6DAA6D;AAC7D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC;AAEhG;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,CAMvB;IACC,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC;IAClC,OAAO,QAAQ,CAAC;QACd,QAAQ,EAAE,SAAS;QACnB,OAAO;QACP,KAAK,EAAE,sBAAsB,CAAC;YAC5B,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC;YAC3B,MAAM,EAAE,CAAC,CAAC,KAAK;YACf,GAAG,IAAI,CAAC,CAAC,CAAC;SACX,CAAC,CAAC,OAAO,CAAC;QACX,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,gBAAgB;QAC1B,IAAI,EAAE,OAAO,KAAK,MAAM;QACxB,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChD,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC,CAAC;AACL,CAAC"}

package/dist/sdk.d.ts

@@ -0,0 +1,27 @@
+/**
+ * One AI SDK language model as a `Model`. The SDK speaks each vendor's wire; this maps our
+ * request in and the reply, tokens, price and errors out. The SDK's own retries are off: the
+ * caller (a runner, a key ring) owns trying again.
+ */
+import { type LanguageModel } from "ai";
+import type { Model, PartKind } from "./types.js";
+/** The ceiling when a request names none. A long extract with quotes passed 4096 on a live run. */
+export declare const DEFAULT_MAX_TOKENS = 8192;
+/** One call, wall clock: a long draft takes a minute or two. */
+export declare const CALL_LIMIT_MS: number;
+export interface SdkModelOptions {
+    /** The vendor (`anthropic`, `groq`, `gateway`). */
+    provider: string;
+    /** The vendor's model id. */
+    modelId: string;
+    model: LanguageModel;
+    takes: ReadonlySet<PartKind>;
+    /** Tokens added to every ceiling for a model that thinks inside its output budget. */
+    thinking?: number;
+    /** A free key: the reply costs 0 and keeps its list price. */
+    free?: boolean;
+    /** The id the price table knows, when it is not `modelId`. */
+    priceId?: string;
+    limitMs?: number;
+}
+export declare function sdkModel(o: SdkModelOptions): Model;

package/dist/sdk.js

@@ -0,0 +1,153 @@
+/**
+ * One AI SDK language model as a `Model`. The SDK speaks each vendor's wire; this maps our
+ * request in and the reply, tokens, price and errors out. The SDK's own retries are off: the
+ * caller (a runner, a key ring) owns trying again.
+ */
+import { APICallError, generateText, } from "ai";
+import { Cut, statusError, Transient, transport } from "./errors.js";
+import { modelOf } from "./model.js";
+import { wellFormed } from "./parse.js";
+import { priced } from "./prices.js";
+/** The ceiling when a request names none. A long extract with quotes passed 4096 on a live run. */
+export const DEFAULT_MAX_TOKENS = 8192;
+/** The least a call may answer in: a lower cap only cuts an answer off. */
+const FLOOR_TOKENS = 2048;
+/** One call, wall clock: a long draft takes a minute or two. */
+export const CALL_LIMIT_MS = 5 * 60_000;
+const GEMINI_LEVEL = {
+    low: "low",
+    medium: "medium",
+    high: "high",
+    xhigh: "high",
+    max: "high",
+};
+function effortOptions(provider, effort) {
+    if (!effort)
+        return {};
+    if (provider === "anthropic")
+        return { providerOptions: { anthropic: { effort } } };
+    if (provider === "google")
+        return {
+            providerOptions: { google: { thinkingConfig: { thinkingLevel: GEMINI_LEVEL[effort] } } },
+        };
+    return {};
+}
+function contentOf(parts) {
+    return parts.map((p) => {
+        switch (p.type) {
+            case "text":
+                return { type: "text", text: wellFormed(p.text) };
+            case "image":
+                return { type: "image", image: p.data, mediaType: p.mediaType };
+            case "pdf":
+                return { type: "file", data: p.data, mediaType: "application/pdf" };
+            default:
+                return { type: "file", data: p.data, mediaType: p.mediaType };
+        }
+    });
+}
+/** System and prompt in the SDK's shape. On Anthropic the system carries a cache breakpoint. */
+function input(provider, req) {
+    const body = typeof req.prompt === "string"
+        ? { prompt: wellFormed(req.prompt) }
+        : { messages: [{ role: "user", content: contentOf(req.prompt) }] };
+    if (!req.system)
+        return body;
+    if (provider !== "anthropic")
+        return { system: wellFormed(req.system), ...body };
+    return {
+        system: {
+            role: "system",
+            content: wellFormed(req.system),
+            providerOptions: { anthropic: { cacheControl: { type: "ephemeral" } } },
+        },
+        ...body,
+    };
+}
+function failure(what, err, signal) {
+    if (signal?.aborted)
+        return err;
+    if (APICallError.isInstance(err)) {
+        if (err.statusCode === undefined)
+            return transport(what, err);
+        const detail = err.message.slice(0, 300);
+        return statusError(`${what}: HTTP ${err.statusCode} ${detail}`, err.statusCode, err.responseHeaders?.["retry-after"]);
+    }
+    if (err instanceof Error && (err.name === "TimeoutError" || err.name === "AbortError"))
+        return new Transient(`${what}: no answer in time`, { cause: err });
+    if (err instanceof TypeError)
+        return transport(what, err);
+    return err;
+}
+export function sdkModel(o) {
+    const id = o.provider === "anthropic" ? o.modelId : `${o.provider}:${o.modelId}`;
+    const limitMs = o.limitMs ?? CALL_LIMIT_MS;
+    return modelOf({
+        id,
+        provider: o.provider,
+        takes: o.takes,
+        async complete(req) {
+            const started = performance.now();
+            const timeout = AbortSignal.timeout(limitMs);
+            const abortSignal = req.signal ? AbortSignal.any([req.signal, timeout]) : timeout;
+            let result;
+            try {
+                result = await generateText({
+                    model: o.model,
+                    ...input(o.provider, req),
+                    maxOutputTokens: Math.max(req.maxTokens ?? DEFAULT_MAX_TOKENS, FLOOR_TOKENS) + (o.thinking ?? 0),
+                    ...effortOptions(o.provider, req.effort),
+                    maxRetries: 0,
+                    abortSignal,
+                });
+            }
+            catch (err) {
+                throw failure(id, err, req.signal);
+            }
+            const u = result.usage;
+            const tokens = {};
+            if (u.inputTokens !== undefined)
+                tokens.input = u.inputTokens;
+            if (u.outputTokens !== undefined)
+                tokens.output = u.outputTokens;
+            if (u.inputTokenDetails?.cacheReadTokens)
+                tokens.cacheRead = u.inputTokenDetails.cacheReadTokens;
+            if (u.inputTokenDetails?.cacheWriteTokens)
+                tokens.cacheWrite = u.inputTokenDetails.cacheWriteTokens;
+            const usage = priced(o.priceId ?? o.modelId, tokens, { free: o.free ?? false });
+            const stop = result.rawFinishReason ?? result.finishReason;
+            if (result.finishReason === "length")
+                throw new Cut(`${id} stopped at its output cap (${stop})`, result.text, usage);
+            if (!result.text)
+                throw new Error(`${id}: no text in the reply (stop ${stop})`);
+            return {
+                text: result.text,
+                usage,
+                model: result.response.modelId || o.modelId,
+                stop,
+                ms: Math.round(performance.now() - started),
+                raw: {
+                    provider: o.provider,
+                    model: o.modelId,
+                    stop_reason: stop,
+                    finish_reason_unified: result.finishReason,
+                    usage: {
+                        input_tokens: u.inputTokens ?? null,
+                        output_tokens: u.outputTokens ?? null,
+                        reasoning_tokens: u.outputTokenDetails?.reasoningTokens ?? null,
+                        cache_read_tokens: u.inputTokenDetails?.cacheReadTokens ?? null,
+                        cache_write_tokens: u.inputTokenDetails?.cacheWriteTokens ?? null,
+                    },
+                    response: {
+                        id: result.response.id,
+                        model_id: result.response.modelId,
+                        timestamp: result.response.timestamp.toISOString(),
+                    },
+                    provider_metadata: result.providerMetadata ?? null,
+                    warnings: result.warnings ?? [],
+                },
+            };
+        },
+    });
+}
+//# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

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

package/dist/spec.d.ts

@@ -0,0 +1,11 @@
+import { type EnvMap, type RotateOptions } from "./keys.js";
+import type { Model } from "./types.js";
+export declare const SPEC_NAMES: readonly ["fake", "claude-code", "anthropic", "gateway", "gemini", "cohere", "command", ...string[]];
+/**
+ * Keys come from the environment by vendor (`ANTHROPIC_API_KEY`, `GROQ_API_KEY_1`...); the
+ * gateway reads `WREN_LLM_GATEWAY_URL` and `WREN_LLM_GATEWAY_TOKEN`. `rotate` sets how a key ring
+ * waits when every key is busy.
+ */
+export declare function modelFromSpec(spec: string, env?: EnvMap, o?: {
+    rotate?: RotateOptions;
+}): Model;

package/dist/spec.js

@@ -0,0 +1,70 @@
+/**
+ * A model from one string and the environment, for a CLI flag or a setting (Node only: it can
+ * start `claude -p`). Grammar: `fake` | `claude-code[:model]` | `anthropic[:haiku|sonnet|opus|id]` |
+ * `gateway[:alias]` | `gemini[:id]` | `cohere[:id]` | `<groq|openrouter|mistral|cerebras|openai>[:id]` |
+ * `command:<shell command>` (the prompt on stdin, the answer on stdout).
+ */
+import { claudeCode, commandModel } from "./command.js";
+import { fakeModel } from "./fake.js";
+import { fleetKeys } from "./keys.js";
+import { anthropic, COMPATIBLE, cohere, compatible, gateway, gemini, isCompatible, } from "./providers.js";
+export const SPEC_NAMES = [
+    "fake",
+    "claude-code",
+    "anthropic",
+    "gateway",
+    "gemini",
+    "cohere",
+    "command",
+    ...Object.keys(COMPATIBLE),
+];
+const keysFor = (env, vendor) => {
+    const keys = fleetKeys(env, vendor);
+    if (keys.length)
+        return keys;
+    const upper = vendor.toUpperCase();
+    throw new Error(`${vendor} needs ${upper}_API_KEY, or NUM_${upper} and ${upper}_API_KEY_1..N`);
+};
+/**
+ * Keys come from the environment by vendor (`ANTHROPIC_API_KEY`, `GROQ_API_KEY_1`...); the
+ * gateway reads `WREN_LLM_GATEWAY_URL` and `WREN_LLM_GATEWAY_TOKEN`. `rotate` sets how a key ring
+ * waits when every key is busy.
+ */
+export function modelFromSpec(spec, env = process.env, o = {}) {
+    const at = spec.indexOf(":");
+    const name = at < 0 ? spec : spec.slice(0, at);
+    const rest = at < 0 ? undefined : spec.slice(at + 1) || undefined;
+    const vendor = (v) => ({
+        key: keysFor(env, v),
+        ...(rest ? { model: rest } : {}),
+        ...(o.rotate ? { rotate: o.rotate } : {}),
+    });
+    switch (name) {
+        case "fake":
+            return fakeModel();
+        case "command":
+            if (!rest)
+                throw new Error("command needs the command after `command:`");
+            return commandModel(rest);
+        case "claude-code":
+            return claudeCode(rest);
+        case "anthropic":
+            return anthropic(vendor("anthropic"));
+        case "gemini":
+            return gemini(vendor("gemini"));
+        case "cohere":
+            return cohere(vendor("cohere"));
+        case "gateway": {
+            const url = env.WREN_LLM_GATEWAY_URL;
+            const token = env.WREN_LLM_GATEWAY_TOKEN;
+            if (!url || !token)
+                throw new Error("gateway needs WREN_LLM_GATEWAY_URL and WREN_LLM_GATEWAY_TOKEN");
+            return gateway({ url, token, ...(rest ? { model: rest } : {}) });
+        }
+        default:
+            if (isCompatible(name))
+                return compatible(name, vendor(name));
+            throw new Error(`unknown model '${spec}'; expected one of ${SPEC_NAMES.join(", ")} [:model]`);
+    }
+}
+//# 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;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAe,SAAS,EAAsB,MAAM,WAAW,CAAC;AACvE,OAAO,EACL,SAAS,EACT,UAAU,EACV,MAAM,EACN,UAAU,EACV,OAAO,EACP,MAAM,EACN,YAAY,GACb,MAAM,gBAAgB,CAAC;AAGxB,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,MAAM;IACN,aAAa;IACb,WAAW;IACX,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;CAClB,CAAC;AAEX,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,MAAc,EAAY,EAAE;IACxD,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACpC,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,UAAU,KAAK,oBAAoB,KAAK,QAAQ,KAAK,eAAe,CAAC,CAAC;AACjG,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,MAAc,OAAO,CAAC,GAAG,EACzB,IAAgC,EAAE;IAElC,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC;IAClE,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC;QAC7B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACpB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAC,CAAC;IACH,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,OAAO,SAAS,EAAE,CAAC;QACrB,KAAK,SAAS;YACZ,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;YACzE,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5B,KAAK,aAAa;YAChB,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1B,KAAK,WAAW;YACd,OAAO,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;QACxC,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAClC,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAClC,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,GAAG,GAAG,GAAG,CAAC,oBAAoB,CAAC;YACrC,MAAM,KAAK,GAAG,GAAG,CAAC,sBAAsB,CAAC;YACzC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK;gBAChB,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;YACnF,OAAO,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC;QACD;YACE,IAAI,YAAY,CAAC,IAAI,CAAC;gBAAE,OAAO,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,sBAAsB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAClG,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * The one shape every model call has. A prompt is a string or a list of parts; a reply is text,
+ * tokens, USD and why it stopped. `ask` parses the reply to a zod shape. raven's and falcon's
+ * `Model` (`id` plus `ask(prompt, shape)`) are met by structure: a `Model` from here is one.
+ */
+import type { ZodType } from "zod";
+/** What a part holds: bytes (base64 or raw) or a URL the vendor fetches itself. */
+export type Source = Uint8Array | string | URL;
+export type Part = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    data: Source;
+    mediaType: string;
+} | {
+    type: "video";
+    data: Source;
+    mediaType: string;
+} | {
+    type: "audio";
+    data: Source;
+    mediaType: string;
+} | {
+    type: "pdf";
+    data: Source;
+};
+export type PartKind = Part["type"];
+/** How hard a model thinks. Anthropic and Gemini read it; others ignore it. */
+export type Effort = "low" | "medium" | "high" | "xhigh" | "max";
+export interface Request {
+    prompt: string | readonly Part[];
+    /** The standing instructions. On Anthropic it carries a cache breakpoint. */
+    system?: string;
+    /** A ceiling against a runaway answer, never the length: the prompt says how long. */
+    maxTokens?: number;
+    effort?: Effort;
+    /** What the call is for (`triage`, `drafts`). No vendor sees it; meters group by it. */
+    purpose?: string;
+    signal?: AbortSignal;
+}
+export interface Usage {
+    /** Every input token, cache reads and writes included. */
+    input?: number;
+    output?: number;
+    /** Of `input`: read from the vendor's prompt cache. */
+    cacheRead?: number;
+    /** Of `input`: written to the cache (5 minutes unless `cacheWrite1h` says). */
+    cacheWrite?: number;
+    /** Of `cacheWrite`: the share that lives 1 hour. */
+    cacheWrite1h?: number;
+    /** What the call cost. 0 on a free key; absent only when the model has no price. */
+    usd?: number;
+    /** The call ran on a free tier: `usd` is 0 and `listUsd` is what it would cost. */
+    free?: boolean;
+    listUsd?: number;
+}
+export interface Reply {
+    text: string;
+    usage: Usage;
+    /** The model that answered, as the vendor names it. */
+    model: string;
+    /** The vendor's own stop reason (`end_turn`, `max_tokens`, `STOP`, `length`). */
+    stop: string | undefined;
+    /** Wall-clock milliseconds for the round trip. */
+    ms: number;
+    /** The vendor's response metadata, kept for the caller to store. */
+    raw: Record<string, unknown>;
+}
+/** A parsed answer and what it cost. */
+export interface Answer<T> {
+    value: T;
+    usage?: Usage;
+}
+export interface AskOptions extends Omit<Request, "prompt"> {
+    /** More calls after an answer that does not parse, each told why. Default 1. */
+    repairs?: number;
+}
+export interface Model {
+    /** The model id, as spends and records name it (`claude-haiku-5-5`, `groq:openai/gpt-oss-120b`). */
+    readonly id: string;
+    /** The vendor alone (`anthropic`, `groq`), for per-vendor sums. */
+    readonly provider: string;
+    /** The part kinds it takes. A part outside this set throws `Unsupported`, never dropped. */
+    readonly takes: ReadonlySet<PartKind>;
+    complete(request: Request | string): Promise<Reply>;
+    ask<T>(prompt: string | readonly Part[], shape: ZodType<T>, o?: AskOptions): Promise<Answer<T>>;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,70 @@
 {
   "name": "@wrenautomation/models",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "One door to every model: a Model takes text, image, video, audio and PDF parts, answers with text, tokens and USD, and parses an answer to a zod shape. Adapters for Anthropic, Gemini, Cohere, any OpenAI-compatible server and a shell command (claude -p); ears for speech to text; one price table; one key ring.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wrenautomation/models.git"
+  },
+  "license": "PolyForm-Shield-1.0.0",
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./prices": {
+      "types": "./dist/prices.d.ts",
+      "import": "./dist/prices.js"
+    },
+    "./hear": {
+      "types": "./dist/hear.d.ts",
+      "import": "./dist/hear.js"
+    },
+    "./command": {
+      "types": "./dist/command.d.ts",
+      "import": "./dist/command.js"
+    },
+    "./spec": {
+      "types": "./dist/spec.d.ts",
+      "import": "./dist/spec.js"
+    }
+  },
+  "packageManager": "pnpm@9.15.0",
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "prepare": "git config core.hooksPath .githooks || true",
+    "lint": "biome check --error-on-warnings .",
+    "lint:fix": "biome check --write .",
+    "typecheck": "tsc --noEmit",
+    "build": "rm -rf dist && tsc",
+    "test": "vitest run",
+    "gates": "lockf -t 900 /tmp/wren_automation-checks.lock sh -c 'pnpm lint && pnpm typecheck && pnpm test'",
+    "prepublishOnly": "pnpm build"
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "4.0.90",
+    "@ai-sdk/cohere": "4.0.71",
+    "@ai-sdk/google": "4.0.107",
+    "@ai-sdk/openai-compatible": "3.0.80",
+    "ai": "7.0.155",
+    "zod": "4.6.5"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.14",
+    "@types/node": "22.20.3",
+    "typescript": "5.9.3",
+    "vitest": "5.0.1"
+  }
+}