mindweave 2.4.7 → 2.4.9

package/dist/drivers/openrouter/catalog.js

@@ -0,0 +1,136 @@
+import { BASE_URL, OPENROUTER_HEADERS } from "./endpoint.js";
+import { PREFIX, USABLE_WINDOW_CAP } from "./manifest.js";
+/**
+ * Whether a model can serve an agent turn here at all.
+ *
+ * Everything that works is listed; a model is left out only when it would fail on
+ * first use or cannot be priced:
+ *   - no text output, or no `tools` — an agent turn needs both;
+ *   - `:batch` entries, which only answer through the Batch API;
+ *   - OpenRouter's own routers (`openrouter/…`, price `-1`), whose model, price and
+ *     window are unknown until after the call;
+ *   - `~` aliases, which point at whatever is newest, so a saved choice would silently
+ *     change model, price and behaviour.
+ */
+export function isUsable(entry) {
+    if (!entry.id || entry.id.startsWith("~") || entry.id.startsWith("openrouter/"))
+        return false;
+    if (entry.id.endsWith(":batch"))
+        return false;
+    if (!(entry.architecture?.output_modalities ?? []).includes("text"))
+        return false;
+    if (!(entry.supported_parameters ?? []).includes("tools"))
+        return false;
+    const prompt = Number(entry.pricing?.prompt);
+    return Number.isFinite(prompt) && prompt >= 0;
+}
+const EFFORT_LEVELS = [
+    { label: "Low", description: "reasoning effort: low", thinking: true, effort: "low" },
+    { label: "Medium", description: "reasoning effort: medium", thinking: true, effort: "medium" },
+    { label: "High", description: "reasoning effort: high", thinking: true, effort: "high" },
+    { label: "Extra high", description: "reasoning effort: extra high", thinking: true, effort: "xhigh" },
+    { label: "Maximum", description: "reasoning effort: maximum", thinking: true, effort: "max" },
+];
+const STANDARD = { label: "Standard", description: "answer directly — fastest", thinking: false, effort: "low" };
+/**
+ * The `/think` ladder the catalogue says this model accepts.
+ *
+ * No reasoning object: one row, nothing to choose. A reasoning model whose thinking is
+ * `mandatory` gets no Standard row, because OpenRouter rejects turning it off. Effort
+ * rungs are the ones it lists that Mindweave also has (`minimal` has no equivalent). A
+ * model that only toggles reasoning, with no efforts, gets a single Thinking row.
+ */
+export function levelsFor(entry) {
+    const r = entry.reasoning;
+    if (!r)
+        return [{ ...STANDARD, description: "this model has no reasoning dial" }];
+    const offered = new Set(r.supported_efforts ?? []);
+    const rungs = EFFORT_LEVELS.filter((l) => offered.has(l.effort));
+    const on = rungs.length > 0 ? rungs : [{ label: "Thinking", description: "think first, then answer", thinking: true, effort: "high" }];
+    return r.mandatory ? on : [STANDARD, ...on];
+}
+/** Per-token price strings to USD per million. */
+function perMillion(value) {
+    const n = Number(value);
+    return typeof value === "string" && value !== "" && Number.isFinite(n) && n >= 0 ? n * 1_000_000 : undefined;
+}
+export function priceFor(entry) {
+    const p = entry.pricing ?? {};
+    const miss = perMillion(p.prompt);
+    const output = perMillion(p.completion);
+    if (miss === undefined || output === undefined)
+        return undefined;
+    const hit = perMillion(p.input_cache_read);
+    const write = perMillion(p.input_cache_write);
+    return { cacheMiss: miss, output, cacheHit: hit ?? miss, ...(write !== undefined ? { cacheWrite: write } : {}) };
+}
+/** "Anthropic: Claude Fable 5.1" → vendor "Anthropic", label "Claude Fable 5.1". */
+function splitName(entry) {
+    const name = entry.name?.trim() || entry.id;
+    const colon = name.indexOf(": ");
+    if (colon > 0)
+        return { vendor: name.slice(0, colon), label: name.slice(colon + 2) };
+    return { vendor: entry.id.split("/")[0] ?? "", label: name };
+}
+function money(n) {
+    if (n === 0)
+        return "0";
+    return n >= 1 ? n.toFixed(2).replace(/\.00$/, "") : n.toPrecision(2).replace(/0+$/, "").replace(/\.$/, "");
+}
+export function toChoice(entry) {
+    const { vendor, label } = splitName(entry);
+    const price = priceFor(entry);
+    // `:free` variants share a tight daily request limit. A model can also simply cost
+    // nothing without the suffix (a stealth preview), and "$0 in / $0 out" reads as a
+    // missing price rather than a free one.
+    const limited = entry.id.endsWith(":free");
+    const free = limited || (price !== undefined && price.cacheMiss === 0 && price.output === 0);
+    const advertised = entry.top_provider?.context_length || entry.context_length || 0;
+    const facts = {
+        thinkLevels: levelsFor(entry),
+        acceptsImages: (entry.architecture?.input_modalities ?? []).includes("image"),
+        ...(price ? { price } : {}),
+        ...(advertised > 0 ? { contextWindow: Math.min(advertised, USABLE_WINDOW_CAP) } : {}),
+    };
+    const parts = [vendor];
+    if (free)
+        parts.push(limited ? "free, rate-limited" : "free");
+    else if (price)
+        parts.push(`$${money(price.cacheMiss)} in / $${money(price.output)} out per M`);
+    // Some hosts bill more at peak hours. The listed price is the base one, and saying so
+    // is better than a cost figure that quietly reads low half the day.
+    if (Array.isArray(entry.pricing?.overrides) && entry.pricing.overrides.length > 0)
+        parts.push("peak hours cost more");
+    const until = entry.expiration_date ? Date.parse(entry.expiration_date) : NaN;
+    return {
+        id: PREFIX + entry.id,
+        label,
+        description: parts.filter(Boolean).join(" · "),
+        facts,
+        ...(Number.isFinite(until) ? { until } : {}),
+    };
+}
+export function toChoices(entries) {
+    return entries.filter(isUsable).map(toChoice);
+}
+/**
+ * Fetch the catalogue. It is public, but asked for only with a key: without one the
+ * provider cannot be used, and every launch would otherwise download it for nothing.
+ * Throws on any failure, so the registry keeps the list it had.
+ */
+export async function discoverModels() {
+    const key = process.env.OPENROUTER_API_KEY;
+    if (!key)
+        throw new Error("No OPENROUTER_API_KEY");
+    const response = await fetch(`${BASE_URL}/models`, {
+        headers: { Authorization: `Bearer ${key}`, ...OPENROUTER_HEADERS },
+    });
+    if (!response.ok)
+        throw new Error(`OpenRouter catalogue: HTTP ${response.status}`);
+    const body = (await response.json());
+    const choices = toChoices(body.data ?? []);
+    if (choices.length === 0)
+        throw new Error("OpenRouter catalogue listed no usable models");
+    return choices;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/drivers/openrouter/catalog.js.map

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

package/dist/drivers/openrouter/client.js

@@ -0,0 +1,102 @@
+import { compatStreamTurn, compatToolTurn } from "../openaiCompat/wire.js";
+import { BASE_URL, OPENROUTER_HEADERS } from "./endpoint.js";
+import { BUFFERED_OUTPUT_TOKENS, DEFAULT_MODEL, wireId } from "./manifest.js";
+/**
+ * Reasoning, in OpenRouter's normalized field.
+ *
+ * Thinking on sends the chosen effort, which OpenRouter maps onto each vendor's own
+ * control. Thinking off sends `enabled: false`. The ladder the user picked from came
+ * from the catalogue, so a model whose reasoning is mandatory never reaches the off
+ * branch, and a model with no reasoning at all only ever has the off row.
+ */
+export function reasoningFields(config) {
+    if (!config)
+        return {};
+    return config.thinking ? { reasoning: { effort: config.effort } } : { reasoning: { enabled: false } };
+}
+/**
+ * The cache split, including writes.
+ *
+ * `prompt_tokens` is the whole prompt; `cached_tokens` the part read from cache and
+ * `cache_write_tokens` the part written to it. Writes are reported so the ones billed
+ * at a premium (Anthropic's 1.25x) are priced as such.
+ */
+export function cacheSplit(usage) {
+    const details = usage.prompt_tokens_details;
+    const hit = typeof details?.cached_tokens === "number" ? details.cached_tokens : 0;
+    const write = typeof details?.cache_write_tokens === "number" ? details.cache_write_tokens : 0;
+    if (hit === 0 && write === 0)
+        return undefined;
+    const prompt = typeof usage.prompt_tokens === "number" ? usage.prompt_tokens : 0;
+    return { hit, miss: Math.max(0, prompt - hit), ...(write > 0 ? { write } : {}) };
+}
+/** Models that cache only what is marked. Every other family here caches automatically. */
+function needsBreakpoints(model) {
+    return model.startsWith("anthropic/");
+}
+/** Put a breakpoint on a message's last content part, turning string content into parts. */
+function mark(message) {
+    const content = message.content;
+    const breakpoint = { cache_control: { type: "ephemeral" } };
+    if (typeof content === "string") {
+        return { ...message, content: [{ type: "text", text: content, ...breakpoint }] };
+    }
+    if (Array.isArray(content) && content.length > 0) {
+        const parts = [...content];
+        parts[parts.length - 1] = { ...parts[parts.length - 1], ...breakpoint };
+        return { ...message, content: parts };
+    }
+    return message;
+}
+function hasText(message) {
+    const content = message.content;
+    return (typeof content === "string" && content.length > 0) || (Array.isArray(content) && content.length > 0);
+}
+/**
+ * Explicit breakpoints at the two stable boundaries: the end of the system prompt, and
+ * the last message before the volatile context tail. The same boundaries the Anthropic
+ * driver uses, and never on the tail itself, which changes every step. An assistant
+ * message with only tool calls has no text to mark, so the boundary walks back to the
+ * nearest one that does.
+ */
+export function withBreakpoints(messages, hasContextTail) {
+    const out = [...messages];
+    if (out[0]?.role === "system" && hasText(out[0]))
+        out[0] = mark(out[0]);
+    let last = out.length - 1 - (hasContextTail ? 1 : 0);
+    while (last > 0 && !hasText(out[last]))
+        last--;
+    if (last > 0)
+        out[last] = mark(out[last]);
+    return out;
+}
+export function finishBody(body, req) {
+    const model = wireId(String(body.model ?? DEFAULT_MODEL));
+    const out = { ...body, model };
+    if (needsBreakpoints(model) && Array.isArray(body.messages)) {
+        out.messages = withBreakpoints(body.messages, !!req.context?.trim());
+    }
+    // Allowed by default, which is OpenRouter's default too; the provider notice says so.
+    if (process.env.MINDWEAVE_OPENROUTER_DATA?.trim().toLowerCase() === "deny") {
+        out.provider = { data_collection: "deny" };
+    }
+    return out;
+}
+export const openrouterProvider = {
+    label: "OpenRouter",
+    baseUrl: BASE_URL,
+    apiKeyEnv: "OPENROUTER_API_KEY",
+    defaultModel: DEFAULT_MODEL,
+    reasoningFields,
+    cacheSplit,
+    bufferedMaxTokens: BUFFERED_OUTPUT_TOKENS,
+    headers: OPENROUTER_HEADERS,
+    finishBody,
+};
+export async function toolTurn(req, options = {}) {
+    return compatToolTurn(openrouterProvider, req, options.signal);
+}
+export async function streamTurn(req, options = {}) {
+    return compatStreamTurn(openrouterProvider, req, options.onEvent, options.signal);
+}
+//# sourceMappingURL=client.js.map

package/dist/drivers/openrouter/client.js.map

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

package/dist/drivers/openrouter/endpoint.js

@@ -0,0 +1,20 @@
+/**
+ * endpoint.ts — where OpenRouter lives and how Mindweave introduces itself to it.
+ *
+ * Its own module so the catalogue and the client share it without the catalogue
+ * loading any wire code.
+ */
+export const BASE_URL = (process.env.MINDWEAVE_OPENROUTER_URL ?? "https://openrouter.ai/api/v1").replace(/\/+$/, "");
+/**
+ * App attribution. OpenRouter credits requests to an app by `HTTP-Referer` plus a title,
+ * which is what lists it on openrouter.ai's app rankings; the `User-Agent` every driver
+ * already sends is not read for that. `X-Title` is the older spelling of the title and
+ * still accepted, so both go out.
+ */
+export const OPENROUTER_HEADERS = {
+    "HTTP-Referer": "https://github.com/mindweave-cli/mindweave",
+    "X-OpenRouter-Title": "mwcode",
+    "X-Title": "mwcode",
+    "X-OpenRouter-Categories": "cli-agent",
+};
+//# sourceMappingURL=endpoint.js.map

package/dist/drivers/openrouter/endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../../../src/drivers/openrouter/endpoint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,8BAA8B,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAErH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA2B;IACxD,cAAc,EAAE,4CAA4C;IAC5D,oBAAoB,EAAE,QAAQ;IAC9B,SAAS,EAAE,QAAQ;IACnB,yBAAyB,EAAE,WAAW;CACvC,CAAC"}

package/dist/drivers/openrouter/index.js

@@ -0,0 +1,5 @@
+import { streamTurn, toolTurn } from "./client.js";
+import { openrouterManifest } from "./manifest.js";
+export const openrouterDriver = { ...openrouterManifest, toolTurn, streamTurn };
+export default openrouterDriver;
+//# sourceMappingURL=index.js.map

package/dist/drivers/openrouter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/drivers/openrouter/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,CAAC,MAAM,gBAAgB,GAAW,EAAE,GAAG,kBAAkB,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAExF,eAAe,gBAAgB,CAAC"}

package/dist/drivers/openrouter/manifest.js

@@ -0,0 +1,83 @@
+/** The namespace every OpenRouter model id carries inside Mindweave. */
+export const PREFIX = "openrouter:";
+/** OpenRouter's own id for a namespaced one. */
+export function wireId(model) {
+    return model.startsWith(PREFIX) ? model.slice(PREFIX.length) : model;
+}
+/**
+ * Shown before discovery has run. The same model Mindweave defaults to elsewhere, so a
+ * fresh OpenRouter user starts somewhere familiar and cheap. A fallback, never a
+ * placement: the full catalogue replaces this list as soon as it arrives.
+ */
+export const MODELS = [
+    { id: `${PREFIX}deepseek/deepseek-v4.1-flash`, label: "DeepSeek V4.1 Flash", description: "DeepSeek" },
+];
+export const DEFAULT_MODEL = MODELS[0].id;
+/**
+ * Before the catalogue describes a model, offer the two states every reasoning model
+ * on OpenRouter accepts. The catalogue's real ladder replaces this per model.
+ */
+export function thinkLevels(_model) {
+    return [
+        { label: "Standard", description: "answer directly — fastest", thinking: false, effort: "low" },
+        { label: "Thinking", description: "think first, then answer", thinking: true, effort: "high" },
+    ];
+}
+/** DeepSeek V4.1 Flash's catalogue price: the only model a fallback can name. */
+const FALLBACK_PRICE = { cacheHit: 0.003, cacheMiss: 0.15, output: 0.6 };
+export function price(_model) {
+    return FALLBACK_PRICE;
+}
+/**
+ * The most context Mindweave lets a transcript grow into on this provider.
+ *
+ * The catalogue reports each model's ADVERTISED maximum, often 1M. The window core
+ * wants is the USABLE one, where retrieval stays reliable, and every vendor driver
+ * sets that well below the advertised figure (DeepSeek 192K-256K, Gemini 200K) on
+ * evidence that recall falls off past it. A router cannot measure hundreds of models,
+ * so it applies the same ceiling, and a smaller advertised window still wins.
+ */
+export const USABLE_WINDOW_CAP = 200_000;
+export function contextWindow(_model) {
+    return 128_000;
+}
+/** The ceiling on a buffered call. Generous, because most models here reason first and
+ *  a reasoning budget comes out of the same allowance as the answer. */
+export const BUFFERED_OUTPUT_TOKENS = 16_000;
+export function bufferedOutputTokens(_model) {
+    return BUFFERED_OUTPUT_TOKENS;
+}
+/**
+ * Keep the saved model even when it is not listed yet: the catalogue may not have
+ * arrived, and coercing a valid choice onto the fallback would change it on every
+ * launch. The registry snaps the reasoning selection onto the model's real ladder once
+ * the catalogue describes it.
+ */
+export function normalize(config) {
+    const model = config.model || DEFAULT_MODEL;
+    const thinking = config.thinking === true;
+    // Onto the fallback ladder above: one effort per state.
+    return { model, thinking, effort: thinking ? "high" : "low" };
+}
+export function ownsModel(model) {
+    return model.startsWith(PREFIX);
+}
+export const openrouterManifest = {
+    id: "openrouter",
+    label: "OpenRouter",
+    apiKeyEnv: "OPENROUTER_API_KEY",
+    keysUrl: "https://openrouter.ai/keys",
+    models: MODELS,
+    thinkLevels,
+    price,
+    contextWindow,
+    bufferedOutputTokens,
+    normalize,
+    ownsModel,
+    notice: "OpenRouter may send prompts to hosts that store or train on them. " +
+        "Set MINDWEAVE_OPENROUTER_DATA=deny to use only hosts that do not.",
+    // Lazy for the same reason as every discovered provider: the manifest loads for every
+    // user, and the catalogue code should only load for someone who uses it.
+    discoverModels: async () => (await import("./catalog.js")).discoverModels(),
+};
+//# sourceMappingURL=manifest.js.map

package/dist/drivers/openrouter/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../src/drivers/openrouter/manifest.ts"],"names":[],"mappings":"AAiBA,wEAAwE;AACxE,MAAM,CAAC,MAAM,MAAM,GAAG,aAAa,CAAC;AAEpC,gDAAgD;AAChD,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAkB;IACnC,EAAE,EAAE,EAAE,GAAG,MAAM,8BAA8B,EAAE,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,UAAU,EAAE;CACvG,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC;AAE3C;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAe;IACzC,OAAO;QACL,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,2BAA2B,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;QAC/F,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,0BAA0B,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;KAC/F,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,cAAc,GAAe,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AAErF,MAAM,UAAU,KAAK,CAAC,MAAe;IACnC,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAEzC,MAAM,UAAU,aAAa,CAAC,MAAe;IAC3C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;wEACwE;AACxE,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE7C,MAAM,UAAU,oBAAoB,CAAC,MAAe;IAClD,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,MAAmB;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,aAAa,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC;IAC1C,wDAAwD;IACxD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,EAAE,EAAE,YAAY;IAChB,KAAK,EAAE,YAAY;IACnB,SAAS,EAAE,oBAAoB;IAC/B,OAAO,EAAE,4BAA4B;IACrC,MAAM,EAAE,MAAM;IACd,WAAW;IACX,KAAK;IACL,aAAa;IACb,oBAAoB;IACpB,SAAS;IACT,SAAS;IACT,MAAM,EACJ,oEAAoE;QACpE,mEAAmE;IACrE,sFAAsF;IACtF,yEAAyE;IACzE,cAAc,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,EAAE;CAC5E,CAAC"}

package/dist/drivers/providerError.js

@@ -20,6 +20,7 @@
  * ACCOUNT reason, and QUOTES the provider's own sentence. The wrapper is universal
  * and cannot be wrong; the precision comes from the provider, which already knows.
  */
+import { isRetryable } from "./retryPolicy.js";
 /**
  * Statuses that mean the ACCOUNT cannot run this request.
  *
@@ -178,4 +179,54 @@ export function accessRefusal(error, providerLabel, canSwitch) {
         body: said ? `${said}\n\n${action}` : action,
     };
 }
+/**
+ * Recognise a failure on the provider's side and shape it for the screen.
+ *
+ * By the time one of these reaches the user, the retry layer has already tried again
+ * and given up, so the useful thing to say is what the user can do: wait, or pick
+ * another model. A red "API error 502: ERROR" says neither, and reads as if Mindweave
+ * crashed. Three shapes count:
+ *   - a 5xx status, the provider or its upstream host falling over;
+ *   - a failure the provider reported inside a successful response (a router whose
+ *     upstream died mid-reply), which carries no status;
+ *   - a request that never got through, after the network retries ran out.
+ *
+ * A 4xx never lands here. 400 and friends are a request we built wrong and stay loud;
+ * 401/402/403/429 are `accessRefusal`'s.
+ *
+ * The provider's own sentence is quoted when it says something. Routers often send a
+ * bare "ERROR" or the status text, and quoting that adds a line that explains nothing.
+ */
+export function providerOutage(error, providerLabel, modelLabel) {
+    const status = statusOf(error);
+    const upstream = !!error && typeof error === "object" && error.upstream === true;
+    const serverSide = status !== null && status >= 500 && status < 600;
+    const unreachable = status === null && !upstream && isRetryable(error, null);
+    if (!serverSide && !upstream && !unreachable)
+        return null;
+    const NL = String.fromCharCode(10);
+    const advice = "The conversation is saved. Try again in a moment, or pick a different model with /model.";
+    if (unreachable) {
+        return {
+            title: `Can't reach ${providerLabel}`,
+            body: `The request didn't get through, even after retrying. Check your connection, or the provider may be down.${NL}${NL}${advice}`,
+        };
+    }
+    const reported = serverSide
+        ? providerMessage(detailOf(error))
+        : providerMessage(String(error.message ?? "").replace(/^.*?API error:\s*/, ""));
+    const informative = reported.length > 0 &&
+        !/^(error|internal server error|bad gateway|service unavailable|gateway timeout|the reply ended with an error)\.?$/i.test(reported);
+    const what = serverSide
+        ? `${providerLabel} returned an error (${status}) while running it, even after retrying.`
+        : `${providerLabel} reported an error part way through the reply.`;
+    const lines = [
+        `${what} This is on the provider's side, not your key or your setup. New and preview models fail like this more often.`,
+        ...(informative ? [`${providerLabel} said: "${reported}"`] : []),
+    ];
+    return {
+        title: `${modelLabel} isn't responding right now`,
+        body: `${lines.join(NL)}${NL}${NL}${advice}`,
+    };
+}
 //# sourceMappingURL=providerError.js.map

package/dist/drivers/providerError.js.map

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

package/dist/drivers/registry.js

@@ -12,6 +12,7 @@ import { geminiManifest } from "./gemini/manifest.js";
 import { metaManifest } from "./meta/manifest.js";
 import { minimaxManifest } from "./minimax/manifest.js";
 import { tencentManifest } from "./tencent/manifest.js";
+import { openrouterManifest } from "./openrouter/manifest.js";
 /** Every provider's cheap metadata, in display order. Always loaded. */
 const MANIFESTS = [
     deepseekManifest,
@@ -28,6 +29,7 @@ const MANIFESTS = [
     metaManifest,
     minimaxManifest,
     tencentManifest,
+    openrouterManifest,
 ];
 /** How to load each provider's wire code, on demand. Keyed by manifest id. */
 const LOADERS = {
@@ -45,6 +47,7 @@ const LOADERS = {
     meta: async () => (await import("./meta/index.js")).metaDriver,
     minimax: async () => (await import("./minimax/index.js")).minimaxDriver,
     tencent: async () => (await import("./tencent/index.js")).tencentDriver,
+    openrouter: async () => (await import("./openrouter/index.js")).openrouterDriver,
 };
 /** The provider used when a model id doesn't match any other. */
 const FALLBACK = MANIFESTS[0];
@@ -85,10 +88,77 @@ export function modelsOf(manifest) {
  * actually serves.
  */
 export function manifestForModel(model) {
-    return (MANIFESTS.find((m) => modelsOf(m).some((c) => c.id === model)) ??
+    return withFacts(MANIFESTS.find((m) => modelsOf(m).some((c) => c.id === model)) ??
         MANIFESTS.find((m) => m.ownsModel?.(model) === true) ??
         FALLBACK);
 }
+/** The facts a discovered listing reported for one model, if any. */
+function factsOf(manifest, model) {
+    return discovered.get(manifest.id)?.find((c) => c.id === model)?.facts;
+}
+const views = new WeakMap();
+/**
+ * A discovered provider's manifest, answering from its listing's facts first.
+ *
+ * Every consumer reads a model's window, price, vision and reasoning ladder through
+ * `manifestForModel`, so wrapping here is what lets a router report real numbers
+ * without a single call site learning that discovered facts exist. Anything the
+ * listing did not report falls through to the manifest's own function.
+ *
+ * A fixed provider is returned untouched: it has no listing to consult.
+ */
+function withFacts(manifest) {
+    if (!manifest.discoverModels)
+        return manifest;
+    let view = views.get(manifest);
+    if (view)
+        return view;
+    view = {
+        ...manifest,
+        thinkLevels: (model) => factsOf(manifest, model)?.thinkLevels ?? manifest.thinkLevels(model),
+        price: (model) => factsOf(manifest, model)?.price ?? manifest.price(model),
+        contextWindow: (model) => factsOf(manifest, model)?.contextWindow ?? manifest.contextWindow(model),
+        bufferedOutputTokens: (model) => factsOf(manifest, model)?.bufferedOutputTokens ?? manifest.bufferedOutputTokens?.(model) ?? 0,
+        acceptsImages: (model) => factsOf(manifest, model)?.acceptsImages ?? manifest.acceptsImages?.(model) ?? false,
+        normalize: (config) => {
+            const base = manifest.normalize(config);
+            const levels = factsOf(manifest, base.model)?.thinkLevels;
+            // Snapped from the caller's own selection, not the manifest's fallback answer: the
+            // fallback ladder is coarser, and rounding through it first would lose a rung the
+            // real ladder has.
+            return levels ? snapToLevels({ ...config, model: base.model }, levels) : base;
+        },
+    };
+    views.set(manifest, view);
+    return view;
+}
+const EFFORTS = ["low", "medium", "high", "xhigh", "max"];
+/**
+ * Move a reasoning selection onto a ladder the model actually offers.
+ *
+ * Thinking is kept on or off when the ladder allows it, and flipped when it does not
+ * (a model that cannot stop reasoning has no off rung). The effort goes to the nearest
+ * offered rung, ties downward, which is the convention every fixed driver follows:
+ * rounding up would quietly spend more than the user chose.
+ */
+export function snapToLevels(config, levels) {
+    if (levels.length === 0)
+        return config;
+    const same = levels.filter((l) => l.thinking === config.thinking);
+    const pool = same.length > 0 ? same : levels;
+    const thinking = pool[0].thinking;
+    if (pool.some((l) => l.effort === config.effort))
+        return { ...config, thinking };
+    const want = EFFORTS.indexOf(config.effort);
+    let best = pool[0];
+    for (const level of pool) {
+        const d = Math.abs(EFFORTS.indexOf(level.effort) - want);
+        const bestD = Math.abs(EFFORTS.indexOf(best.effort) - want);
+        if (d < bestD || (d === bestD && EFFORTS.indexOf(level.effort) < EFFORTS.indexOf(best.effort)))
+            best = level;
+    }
+    return { ...config, thinking, effort: best.effort };
+}
 /** Every model offered across all installed providers. */
 export function allModels() {
     return MANIFESTS.flatMap((m) => modelsOf(m));
@@ -105,14 +175,23 @@ export function allModels() {
  * it (no key, nothing running), not by a picker that quietly loses its contents.
  * Returns the ids that refreshed successfully, so a caller can tell the difference.
  */
-export async function refreshModels() {
-    const dynamic = MANIFESTS.filter((m) => m.discoverModels);
+export async function refreshModels(options = {}) {
+    const maxAge = options.maxAgeMs ?? 0;
+    const now = Date.now();
+    const dynamic = MANIFESTS.filter((m) => m.discoverModels).filter((m) => {
+        // A list younger than the caller's tolerance is left alone. A router's catalogue is
+        // a large download, and asking for it on every picker open costs a visible pause
+        // for a list that changes weekly.
+        const at = refreshedAt.get(m.id);
+        return maxAge <= 0 || at === undefined || now - at >= maxAge;
+    });
     const results = await Promise.all(dynamic.map(async (m) => {
         try {
             const models = await m.discoverModels();
             // An empty result is a real answer — a runtime with nothing pulled — and is
             // stored as such. Failure is the case that must not overwrite.
             discovered.set(m.id, models);
+            refreshedAt.set(m.id, Date.now());
             return m.id;
         }
         catch {
@@ -121,9 +200,38 @@ export async function refreshModels() {
     }));
     return results.filter((id) => id !== null);
 }
+/** When each discovered list was fetched, in ms. Seeded lists carry their fetch time. */
+const refreshedAt = new Map();
+/**
+ * A discovered provider's list as last fetched, for persisting. Undefined when it has
+ * never been fetched or seeded, which is different from an empty list.
+ */
+export function discoveredList(id) {
+    const models = discovered.get(id);
+    const fetchedAt = refreshedAt.get(id);
+    return models && fetchedAt !== undefined ? { models, fetchedAt } : undefined;
+}
+/**
+ * Install a previously fetched list, so a picker and the first turn have real facts
+ * before the network answers. Never replaces a list fetched in this process: a disk
+ * copy is older by definition.
+ */
+export function seedDiscovered(id, models, fetchedAt) {
+    if (!MANIFESTS.some((m) => m.id === id && m.discoverModels))
+        return;
+    if (discovered.has(id))
+        return;
+    discovered.set(id, models);
+    refreshedAt.set(id, fetchedAt);
+}
+/** Ids of every provider that discovers its models. */
+export function discoveredProviderIds() {
+    return MANIFESTS.filter((m) => m.discoverModels).map((m) => m.id);
+}
 /** Drop every discovered list. For tests, and for a full provider reset. */
 export function clearDiscovered() {
     discovered.clear();
+    refreshedAt.clear();
 }
 /**
  * Every installed provider, in display order — what `/provider` lists.