mindweave 0.0.1 → 2.1.2

package/dist/drivers/anthropic/manifest.js

@@ -0,0 +1,221 @@
+export const FABLE = "claude-fable-5";
+export const OPUS = "claude-opus-5";
+export const OPUS_48 = "claude-opus-4-8";
+export const SONNET = "claude-sonnet-5";
+export const HAIKU = "claude-haiku-4-5";
+/** The model used when nothing is saved and no env override is set. */
+export const DEFAULT_MODEL = SONNET;
+/**
+ * The models offered by `/model`. First entry is this provider's default, which is
+ * also where `/provider` lands when someone switches to Anthropic.
+ *
+ * Descriptions say what the model is FOR, not what it scores. Someone reading the
+ * picker is choosing between five things they are about to pay for, and the useful
+ * distinction is the kind of work each one earns its rate on.
+ */
+export const MODELS = [
+    { id: SONNET, label: "Claude Sonnet 5", description: "fast, strong at code — the default" },
+    { id: OPUS, label: "Claude Opus 5", description: "deep reasoning for long, complex work" },
+    { id: OPUS_48, label: "Claude Opus 4.8", description: "the previous Opus — proven and steady" },
+    { id: FABLE, label: "Claude Fable 5", description: "the toughest challenges, at the highest rate" },
+    { id: HAIKU, label: "Claude Haiku 4.5", description: "cheapest and quickest, for simple work" },
+];
+const CURRENT = {
+    canDisableThinking: true,
+    takesEffort: true,
+    maxDisabledEffort: null,
+    // Every model on this surface STORES 1M tokens, but this is deliberately the
+    // sharp window rather than the storage cap: on BYOK every token in the window is
+    // the user's money on every turn, so anchoring compaction at 1M would mean
+    // carrying an enormous prompt long after it stopped earning its cost.
+    window: 200_000,
+    searchTool: "web_search_20260209",
+};
+const SURFACES = {
+    // Thinking is always on and any explicit `thinking` config is rejected — see
+    // `client.ts`, which omits the field entirely for this model.
+    [FABLE]: { ...CURRENT, canDisableThinking: false },
+    // Thinking may be turned off, but only at effort `high` or below.
+    [OPUS]: { ...CURRENT, maxDisabledEffort: "high" },
+    [OPUS_48]: { ...CURRENT },
+    [SONNET]: { ...CURRENT },
+    // The legacy surface. No `effort` rungs, thinking is a token budget, and the
+    // window here is the model's real maximum rather than a judgment call — Haiku
+    // stores 200K, it does not store 1M.
+    [HAIKU]: {
+        canDisableThinking: true,
+        takesEffort: false,
+        maxDisabledEffort: null,
+        window: 200_000,
+        searchTool: "web_search_20250305",
+    },
+};
+/** The surface a model runs on, falling back to the default model's for unknown ids. */
+export function surfaceOf(model) {
+    return SURFACES[model] ?? SURFACES[DEFAULT_MODEL];
+}
+/**
+ * The reasoning levels offered by `/think`, which depend on the model's surface.
+ *
+ * Three shapes, one per surface rule:
+ *
+ *   - Fable 5 has no "answer directly" rung at all, because there is no such
+ *     request to make. Offering one would be a switch that silently did nothing —
+ *     or, worse, a 400. The choice on this model is only how much it thinks.
+ *   - Haiku 4.5 has no effort ladder, so it gets the plain on/off pair. The stored
+ *     `effort` is inert for it and `normalize` pins it so nothing odd persists.
+ *   - The rest get the full four rungs.
+ *
+ * The current-surface "Standard" deliberately pairs no-thinking with `high` rather
+ * than a lower rung: on Opus 5 thinking may only be turned off at effort `high` or
+ * below, so this is the one setting that keeps a no-thinking request legal on every
+ * model that offers it.
+ */
+export function thinkLevels(model) {
+    const surface = surfaceOf(model);
+    if (!surface.canDisableThinking) {
+        return [
+            { label: "Standard", description: "always thinks — lighter budget", thinking: true, effort: "medium" },
+            { label: "Thinking", description: "think first, then answer", thinking: true, effort: "high" },
+            { label: "Deep", description: "more reasoning, more tool work", thinking: true, effort: "xhigh" },
+            { label: "Maximum", description: "maximum reasoning budget", thinking: true, effort: "max" },
+        ];
+    }
+    if (!surface.takesEffort) {
+        return [
+            { label: "Standard", description: "answer directly — fastest", thinking: false, effort: "high" },
+            { label: "Thinking", description: "think first, then answer", thinking: true, effort: "high" },
+        ];
+    }
+    return [
+        { label: "Standard", description: "answer directly — fastest", thinking: false, effort: "high" },
+        { label: "Thinking", description: "think first, then answer", thinking: true, effort: "high" },
+        { label: "Deep", description: "more reasoning, more tool work", thinking: true, effort: "xhigh" },
+        { label: "Maximum", description: "maximum reasoning budget", thinking: true, effort: "max" },
+    ];
+}
+/**
+ * List prices (USD / 1M tokens). Cache reads are ~1/10 of fresh input, which is
+ * what keeps a re-sent conversation cheap. Sonnet is running an introductory rate
+ * below this through 2026-08-31; the durable list price is used here so the
+ * estimate doesn't start under-reporting the moment that ends.
+ */
+/** Anthropic bills a 5-minute cache WRITE at 1.25x base input — the tokens are both
+ *  processed and stored. (The 1h TTL is 2x; Mindweave does not buy it.) Folding writes
+ *  into the plain input rate under-reported every turn of an agentic loop, which writes
+ *  a new prefix segment constantly. */
+const CACHE_WRITE_MULTIPLIER = 1.25;
+const PRICES = {
+    [FABLE]: { cacheHit: 1, cacheMiss: 10, output: 50, cacheWrite: 10 * CACHE_WRITE_MULTIPLIER },
+    [OPUS]: { cacheHit: 0.5, cacheMiss: 5, output: 25, cacheWrite: 5 * CACHE_WRITE_MULTIPLIER },
+    [OPUS_48]: { cacheHit: 0.5, cacheMiss: 5, output: 25, cacheWrite: 5 * CACHE_WRITE_MULTIPLIER },
+    [SONNET]: { cacheHit: 0.3, cacheMiss: 3, output: 15, cacheWrite: 3 * CACHE_WRITE_MULTIPLIER },
+    [HAIKU]: { cacheHit: 0.1, cacheMiss: 1, output: 5, cacheWrite: 1 * CACHE_WRITE_MULTIPLIER },
+};
+/** Cache-aware list price for a model, falling back to the default model's. */
+export function price(model) {
+    return PRICES[model] ?? PRICES[DEFAULT_MODEL];
+}
+/** The model's USABLE context window — see `ModelSurface.window`. */
+export function contextWindow(model) {
+    return surfaceOf(model).window;
+}
+/**
+ * The ceiling this driver puts on a single buffered (non-streaming) call.
+ *
+ * Every model here accepts far more, but a non-streaming request that runs long
+ * risks an HTTP timeout, so the buffered path — core's small internal calls, like
+ * a compaction summary — is deliberately capped low. `client.ts` sends this value
+ * and `dynamo/contextWindow.ts` reserves it; keeping one exported constant means
+ * the request and the reservation cannot drift apart.
+ *
+ * The streaming ceiling is a separate, much larger number and lives in `client.ts`,
+ * because nothing in core needs to reserve room for it.
+ */
+export const BUFFERED_OUTPUT_TOKENS = 16_000;
+export function bufferedOutputTokens(_model) {
+    return BUFFERED_OUTPUT_TOKENS;
+}
+/** Effort rungs the current surface accepts, weakest first. */
+const EFFORTS = ["low", "medium", "high", "xhigh", "max"];
+/**
+ * Every model offered here reads images. Anthropic accepts JPEG, PNG, GIF and WebP,
+ * and downscales anything oversized itself, so this driver takes what core sends and
+ * adds no resizing of its own.
+ */
+export function acceptsImages(_model) {
+    return true;
+}
+/**
+ * Coerce a stored or unknown config onto a model this provider actually serves, and
+ * keep the reasoning intent legal for it.
+ *
+ * Four corrections. The first three enforce rules the API would otherwise reject:
+ *   - Fable 5 always thinks, so a no-thinking config becomes a thinking one.
+ *   - Haiku 4.5 takes no effort rung, so the stored value is pinned to `high`
+ *     (inert for it, and the rung every other model treats as the safe default).
+ *   - Opus 5 rejects no-thinking above `high`, so such a config steps its effort
+ *     down rather than reaching the wire.
+ *
+ * The fourth is about the UI rather than the wire: the result is snapped onto a
+ * rung the target model's `/think` ladder actually OFFERS. A legal-but-unlisted
+ * setting is the failure this catches — Fable's lightest rung is `medium`, which
+ * every current-surface model accepts happily, so carrying it to Sonnet produced a
+ * config that worked but that `/think` could not show as selected, leaving the user
+ * in a state with no tick beside it and no way to name what they were running.
+ *
+ * All four matter most on a MODEL SWITCH: `/model` carries the current reasoning
+ * intent across, so every level of every model has to land somewhere real on every
+ * other model.
+ */
+export function normalize(config) {
+    const model = SURFACES[config.model] ? config.model : DEFAULT_MODEL;
+    const surface = surfaceOf(model);
+    const thinking = surface.canDisableThinking ? config.thinking === true : true;
+    let effort = EFFORTS.includes(config.effort) ? config.effort : "high";
+    if (!surface.takesEffort)
+        effort = "high";
+    const cap = surface.maxDisabledEffort;
+    if (!thinking && cap && EFFORTS.indexOf(effort) > EFFORTS.indexOf(cap))
+        effort = cap;
+    return { model, thinking, effort: snapToOfferedRung(model, thinking, effort) };
+}
+/**
+ * Move an effort onto the nearest rung this model's `/think` ladder offers.
+ *
+ * Ties break DOWNWARD: an unlisted setting resolves to the cheaper neighbour, never
+ * the dearer one, because silently spending more of the user's money than the level
+ * they were on is the worse of the two ways to be wrong.
+ */
+function snapToOfferedRung(model, thinking, effort) {
+    const offered = thinkLevels(model).filter((l) => l.thinking === thinking);
+    if (offered.length === 0)
+        return effort;
+    if (offered.some((l) => l.effort === effort))
+        return effort;
+    const want = EFFORTS.indexOf(effort);
+    let best = offered[0];
+    for (const level of offered) {
+        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 best.effort;
+}
+/** The cheap metadata half of this driver — see `index.ts` for the wire half. */
+export const anthropicManifest = {
+    id: "anthropic",
+    label: "Anthropic",
+    apiKeyEnv: "ANTHROPIC_API_KEY",
+    keysUrl: "https://console.anthropic.com/settings/keys",
+    models: MODELS,
+    thinkLevels,
+    price,
+    contextWindow,
+    bufferedOutputTokens,
+    acceptsImages,
+    normalize,
+};
+//# sourceMappingURL=manifest.js.map

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

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

package/dist/drivers/cerebras/client.js

@@ -0,0 +1,69 @@
+import { compatStreamTurn, compatToolTurn, listModels, standardCacheSplit } from "../openaiCompat/wire.js";
+import { BUFFERED_OUTPUT_TOKENS, DEFAULT_MODEL, takesEffort } from "./manifest.js";
+const BASE_URL = process.env.MINDWEAVE_CEREBRAS_URL ?? "https://api.cerebras.ai/v1";
+/** The model a request runs on, matching the shared layer's own fallback. */
+function modelOf(config) {
+    return config?.model ?? process.env.MINDWEAVE_MODEL ?? DEFAULT_MODEL;
+}
+/**
+ * Cerebras's reasoning fields.
+ *
+ * Collapsed to two states rather than forwarding the shared effort rung. The models
+ * here come from several vendors whose effort vocabularies differ, and this driver
+ * cannot tell from a discovered id which one applies — so it sends the values every
+ * one of them accepts instead of a rung that works on some and is rejected by others.
+ */
+export function reasoningFields(config) {
+    if (!takesEffort(modelOf(config)))
+        return {};
+    return { reasoning_effort: config?.thinking ? "default" : "none" };
+}
+/**
+ * Turn Cerebras's live catalogue into picker entries.
+ *
+ * No context window is reported by this endpoint, so entries carry no size hint —
+ * saying "128K context" here would be repeating this driver's own conservative
+ * default back to the user as though the provider had stated it.
+ */
+export function toChoices(listed) {
+    return listed
+        .filter((m) => !/whisper|tts|guard|embed/i.test(m.id))
+        .map((m) => ({ id: m.id, label: m.id, description: "served on Cerebras" }))
+        .sort((a, b) => a.id.localeCompare(b.id));
+}
+/**
+ * Fetch the models Cerebras is serving right now.
+ *
+ * Throws when the key is missing or the request fails, which is the contract the
+ * registry relies on: a throw keeps the previous list, an empty array replaces it.
+ */
+export async function discoverModels() {
+    return toChoices(await listModels(cerebrasProvider));
+}
+/**
+ * Cerebras caches automatically, and the split is read for the TOKEN COUNT rather
+ * than for the price: unlike every other provider here, it bills cached input at the
+ * full standard rate, so the caching buys latency and nothing else. The manifest's
+ * prices reflect that (no discount); this hook exists so a multi-step turn does not
+ * report every step's whole prompt as fresh, which is a count, not a bill.
+ *
+ * No `extraStop`: the finish reasons are the plain OpenAI set.
+ */
+export const cerebrasProvider = {
+    label: "Cerebras",
+    baseUrl: BASE_URL,
+    apiKeyEnv: "CEREBRAS_API_KEY",
+    defaultModel: process.env.MINDWEAVE_MODEL ?? DEFAULT_MODEL,
+    reasoningFields,
+    cacheSplit: standardCacheSplit,
+    bufferedMaxTokens: BUFFERED_OUTPUT_TOKENS,
+};
+/** Ask the model for one turn. */
+export async function toolTurn(req, options = {}) {
+    return compatToolTurn(cerebrasProvider, req, options.signal);
+}
+/** Ask the model for one turn, streaming deltas to `options.onEvent`. */
+export async function streamTurn(req, options = {}) {
+    return compatStreamTurn(cerebrasProvider, req, options.onEvent, options.signal);
+}
+//# sourceMappingURL=client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/drivers/cerebras/client.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,EAAuB,MAAM,yBAAyB,CAAC;AAChI,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEnF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,4BAA4B,CAAC;AAEpF,6EAA6E;AAC7E,SAAS,OAAO,CAAC,MAA+B;IAC9C,OAAO,MAAM,EAAE,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,aAAa,CAAC;AACvE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,MAA+B;IAC7D,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;AACrE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,MAAwB;IAChD,OAAO,MAAM;SACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACrD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC,CAAC;SAC1E,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,OAAO,SAAS,CAAC,MAAM,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,KAAK,EAAE,UAAU;IACjB,OAAO,EAAE,QAAQ;IACjB,SAAS,EAAE,kBAAkB;IAC7B,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,aAAa;IAC1D,eAAe;IACf,UAAU,EAAE,kBAAkB;IAC9B,iBAAiB,EAAE,sBAAsB;CAC1C,CAAC;AAEF,kCAAkC;AAClC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAiB,EAAE,UAAuB,EAAE;IACzE,OAAO,cAAc,CAAC,gBAAgB,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAiB,EAAE,UAAyB,EAAE;IAC7E,OAAO,gBAAgB,CAAC,gBAAgB,EAAE,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;AAClF,CAAC"}

package/dist/drivers/cerebras/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/drivers/cerebras/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,CAAC,MAAM,cAAc,GAAW,EAAE,GAAG,gBAAgB,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAEpF,eAAe,cAAc,CAAC"}

package/dist/drivers/cerebras/manifest.js

@@ -0,0 +1,140 @@
+/**
+ * A minimal fallback list, shown only before discovery has run or when it fails.
+ * Short on purpose: a fallback naming a withdrawn model is worse than one naming
+ * two that work. The live list replaces this entirely.
+ */
+export const MODELS = [
+    { id: "gpt-oss-120b", label: "GPT-OSS 120B", description: "open weights, with a reasoning dial" },
+    { id: "zai-glm-4.7", label: "GLM 4.7", description: "served on Cerebras, very fast" },
+];
+/** The model used when nothing is saved and no env override is set. */
+export const DEFAULT_MODEL = MODELS[0].id;
+/**
+ * Models known to accept `reasoning_effort`, matched by SUBSTRING rather than exact
+ * id — the discovered ids carry vendor prefixes and size suffixes that vary, so an
+ * exact table would go stale for the same reason the model list does. A false
+ * negative costs a reasoning dial; a false positive costs a rejected request, so the
+ * list stays narrow.
+ */
+const EFFORT_MODELS = ["gpt-oss", "qwen3", "glm"];
+export function takesEffort(model) {
+    const id = model.toLowerCase();
+    return EFFORT_MODELS.some((fragment) => id.includes(fragment));
+}
+/**
+ * The reasoning levels offered by `/think`.
+ *
+ * Two states rather than a graded ladder. The models served here come from several
+ * vendors with different effort vocabularies, and this driver does not know which
+ * one a discovered id belongs to — so it offers the states every one of them
+ * accepts, instead of a rung that works on some and 400s on others.
+ */
+export function thinkLevels(model) {
+    if (takesEffort(model)) {
+        return [
+            { label: "Standard", description: "answer directly — fastest", thinking: false, effort: "low" },
+            { label: "Thinking", description: "think first, then answer", thinking: true, effort: "high" },
+        ];
+    }
+    return [{ label: "Standard", description: "this model has no reasoning dial", thinking: false, effort: "low" }];
+}
+/**
+ * List prices (USD / 1M tokens), for the models whose rates are published.
+ *
+ * A discovered lineup cannot have a complete table by definition. The fallback is
+ * the cheapest plausible rate rather than an average, for the same reason as Groq's:
+ * this provider serves open models cheaply, so guessing high would make an
+ * inexpensive session look alarming.
+ *
+ * `cacheHit` deliberately EQUALS `cacheMiss` throughout, and that is a fact rather
+ * than an unfinished table: Cerebras bills cached input at the standard rate, so its
+ * prompt caching buys latency and no money. It is the one provider here where a
+ * cache discount would be invented.
+ */
+const PRICES = [
+    ["gpt-oss-120b", { cacheHit: 0.25, cacheMiss: 0.25, output: 0.69 }],
+    ["glm-4.7", { cacheHit: 0.6, cacheMiss: 0.6, output: 2.2 }],
+    ["qwen3", { cacheHit: 0.29, cacheMiss: 0.29, output: 0.59 }],
+];
+const UNKNOWN_PRICE = { cacheHit: 0.25, cacheMiss: 0.25, output: 0.69 };
+export function price(model) {
+    const id = model.toLowerCase();
+    return PRICES.find(([fragment]) => id.includes(fragment))?.[1] ?? UNKNOWN_PRICE;
+}
+/**
+ * The model's USABLE context window. A single conservative figure, because the
+ * listing reports no per-model size and the open models served here vary widely.
+ * Under-stating costs some usable context; over-stating lets a transcript grow past
+ * what the model can attend to, which is the worse failure.
+ */
+export function contextWindow(_model) {
+    return 128_000;
+}
+/** The ceiling this driver puts on a single BUFFERED call. */
+export const BUFFERED_OUTPUT_TOKENS = 8_000;
+export function bufferedOutputTokens(_model) {
+    return BUFFERED_OUTPUT_TOKENS;
+}
+const EFFORTS = ["low", "medium", "high", "xhigh", "max"];
+/**
+ * Coerce a stored config onto something serveable.
+ *
+ * As with Groq, an unknown model id is KEPT rather than coerced. A discovered
+ * provider's list is empty until it is asked, and rewriting the user's saved model
+ * in that window would silently change their choice on every launch.
+ */
+export function normalize(config) {
+    const model = config.model || DEFAULT_MODEL;
+    const thinking = takesEffort(model) ? config.thinking === true : false;
+    const effort = EFFORTS.includes(config.effort) ? config.effort : "low";
+    return { model, thinking, effort: snapToOfferedRung(model, thinking, effort) };
+}
+/** Move an effort onto the nearest rung this model's ladder offers, ties downward. */
+function snapToOfferedRung(model, thinking, effort) {
+    const offered = thinkLevels(model).filter((l) => l.thinking === thinking);
+    if (offered.length === 0)
+        return thinkLevels(model)[0].effort;
+    if (offered.some((l) => l.effort === effort))
+        return effort;
+    const want = EFFORTS.indexOf(effort);
+    let best = offered[0];
+    for (const level of offered) {
+        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 best.effort;
+}
+/**
+ * Recognise a Cerebras model id without a list.
+ *
+ * Narrower than Groq's on purpose. Both providers serve overlapping open models, so
+ * a broad claim here would let Cerebras capture ids Groq also serves, and whichever
+ * provider happened to be earlier in the registry would win — a coin toss deciding
+ * which endpoint a saved model runs against. Only the `zai-` prefix is distinctive
+ * to this catalogue; everything else is left to the real lists.
+ *
+ * The consequence, stated rather than hidden: a saved Cerebras model with a shared
+ * id resolves correctly only once discovery has run, which it does at session start.
+ */
+export function ownsModel(model) {
+    return model.toLowerCase().startsWith("zai-");
+}
+/** The cheap metadata half of this driver — see `index.ts` for the wire half. */
+export const cerebrasManifest = {
+    id: "cerebras",
+    label: "Cerebras",
+    apiKeyEnv: "CEREBRAS_API_KEY",
+    keysUrl: "https://cloud.cerebras.ai/",
+    models: MODELS,
+    thinkLevels,
+    price,
+    contextWindow,
+    bufferedOutputTokens,
+    normalize,
+    ownsModel,
+    /** Imported inside the function so this module loads no wire code — see Groq's. */
+    discoverModels: async () => (await import("./client.js")).discoverModels(),
+};
+//# sourceMappingURL=manifest.js.map

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

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

package/dist/drivers/clientId.js

@@ -0,0 +1,41 @@
+/**
+ * clientId.ts — the identifying string Mindweave sends with every provider
+ * request.
+ *
+ * Every provider logs the `User-Agent` (or equivalent) header on inbound
+ * requests for its own analytics, rate-limit tiers, and abuse review — the same
+ * way Cursor, Cline, Aider and every other terminal coding agent identify
+ * themselves rather than looking like a bare SDK call. This is that string, sent
+ * consistently from every driver so Mindweave's traffic reads as Mindweave's
+ * traffic wherever a provider looks.
+ *
+ * Deliberately self-contained rather than importing `cli/version.ts` — a driver
+ * may import nothing from outside `drivers/` except `types.js` (see the header of
+ * that file), and this constant is exactly the kind of core-adjacent thing that
+ * boundary exists to keep out. So the same safe, degrade-to-nothing read is
+ * duplicated here in miniature rather than the boundary being bent for it.
+ */
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+let cached = null;
+/** `mindweave/1.9.9 (mwcode)`, or `mindweave (mwcode)` if the version can't be
+ *  read — never throws, never blocks a request on a missing package.json. */
+export function clientId() {
+    if (cached !== null)
+        return cached;
+    let version = "";
+    try {
+        const root = join(dirname(fileURLToPath(import.meta.url)), "..", "..");
+        const pkg = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
+        if (typeof pkg.version === "string")
+            version = pkg.version;
+    }
+    catch {
+        // No package.json (or it's malformed) — identify without a version rather
+        // than fail a request over it.
+    }
+    cached = version ? `mindweave/${version} (mwcode)` : "mindweave (mwcode)";
+    return cached;
+}
+//# sourceMappingURL=clientId.js.map

package/dist/drivers/clientId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientId.js","sourceRoot":"","sources":["../../src/drivers/clientId.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC;6EAC6E;AAC7E,MAAM,UAAU,QAAQ;IACtB,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACnC,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACvE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAA0B,CAAC;QAClG,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;YAAE,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,0EAA0E;QAC1E,+BAA+B;IACjC,CAAC;IACD,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,aAAa,OAAO,WAAW,CAAC,CAAC,CAAC,oBAAoB,CAAC;IAC1E,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/drivers/contextOverflow.js

@@ -0,0 +1,77 @@
+/**
+ * contextOverflow.ts — telling "this conversation no longer fits" apart from
+ * "we sent something broken".
+ *
+ * A provider can refuse an over-long request two ways, and only one of them was
+ * handled. Some report it as a FINISH REASON on an otherwise successful response
+ * (`model_context_window_exceeded`), which the drivers already map to the `overflow`
+ * stop and the engine already recovers from by shedding its oldest rounds. Most
+ * providers instead REJECT the request outright with a 400, and that path had no
+ * recovery at all: `providerError.ts` classifies a 400 as a malformed request, our
+ * bug, deliberately loud — so a conversation that had merely grown too long ended the
+ * turn with a red error, after the user had already paid for the refused call.
+ *
+ * That classification stays exactly as it is for every other 400. This is the same
+ * kind of narrow reprieve the balance-phrase carve-out is: it answers one prior
+ * question, "is this refusal about LENGTH", and answers it from the provider's own
+ * sentence rather than from a status code that cannot distinguish it.
+ *
+ * WHICH DIRECTION THIS SHOULD FAIL. A miss costs a dead turn. A false positive costs
+ * the oldest rounds of a conversation and one retry, and if the request was never
+ * really too long the retry fails again and the real error surfaces then. So the
+ * phrase list leans towards matching, and the recovery it triggers is capped at once
+ * per turn precisely so a wrong guess cannot loop.
+ */
+import { detailOf, providerMessage, statusOf } from "./providerError.js";
+/**
+ * Statuses that can carry a length refusal.
+ *
+ * 400 is where almost every provider puts it. 413 is the literal "payload too large",
+ * which a gateway in front of a provider may return instead. 422 covers the handful
+ * that treat an over-long prompt as a validation failure. A 5xx is the provider
+ * falling over and a 401/402/403/429 is the account, and neither becomes recoverable
+ * by dropping history, so both are excluded rather than left to the phrase match.
+ */
+const OVERFLOW_STATUSES = new Set([400, 413, 422]);
+/**
+ * How the providers in the lineup word it. Lower-cased substrings, checked against
+ * the provider's own sentence.
+ *
+ * Every entry here is about SIZE and nothing else, which is what keeps this from
+ * quietly widening into "any 400 we felt like retrying". `context_length_exceeded` is
+ * OpenAI's machine-readable code rather than prose, and is matched because it travels
+ * in the same body.
+ */
+const OVERFLOW_PHRASES = [
+    "context length",
+    "context window",
+    "context_length_exceeded",
+    "maximum context",
+    "prompt is too long",
+    "too many tokens",
+    "input token count",
+    "token count exceeds",
+    "exceeds the maximum number of tokens",
+    "reduce the length of the messages",
+    "request too large",
+];
+/**
+ * Did the provider refuse this request because the conversation no longer fits (pure)?
+ *
+ * An error with no status at all is still examined: SDK wrappers do not always expose
+ * one, and a sentence that plainly says the prompt was too long means the same thing
+ * whether or not the number survived the trip.
+ */
+export function isContextOverflowError(error) {
+    const status = statusOf(error);
+    if (status !== null && !OVERFLOW_STATUSES.has(status))
+        return false;
+    const detail = detailOf(error);
+    // The provider's own sentence when one can be extracted, and the raw body when it
+    // cannot — a phrase this specific is not going to match the surrounding JSON by
+    // accident, and insisting on a parsed message would miss every provider that sends
+    // plain text.
+    const text = `${providerMessage(detail)}\n${detail}`.toLowerCase();
+    return OVERFLOW_PHRASES.some((phrase) => text.includes(phrase));
+}
+//# sourceMappingURL=contextOverflow.js.map

package/dist/drivers/contextOverflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextOverflow.js","sourceRoot":"","sources":["../../src/drivers/contextOverflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEzE;;;;;;;;GAQG;AACH,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,gBAAgB,GAAG;IACvB,gBAAgB;IAChB,gBAAgB;IAChB,yBAAyB;IACzB,iBAAiB;IACjB,oBAAoB;IACpB,iBAAiB;IACjB,mBAAmB;IACnB,qBAAqB;IACrB,sCAAsC;IACtC,mCAAmC;IACnC,mBAAmB;CACpB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAEpE,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,kFAAkF;IAClF,gFAAgF;IAChF,mFAAmF;IACnF,cAAc;IACd,MAAM,IAAI,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC;IACnE,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AAClE,CAAC"}