mindweave 0.0.1 → 2.1.2

package/dist/drivers/mistral/manifest.js

@@ -0,0 +1,118 @@
+export const MEDIUM = "mistral-medium-3-5-26-04";
+export const LARGE = "mistral-large-3-25-12";
+export const SMALL = "mistral-small-4-0-26-03";
+export const MINISTRAL_8B = "ministral-3-8b-25-12";
+/** The model used when nothing is saved and no env override is set. */
+export const DEFAULT_MODEL = MEDIUM;
+/** The models offered by `/model`. First entry is this provider's default. */
+export const MODELS = [
+    { id: MEDIUM, label: "Mistral Medium 3.5", description: "the flagship, tuned for agents and code — the default" },
+    { id: LARGE, label: "Mistral Large 3", description: "open weights, and much cheaper than the flagship" },
+    { id: SMALL, label: "Mistral Small 4", description: "small and capable, with a reasoning dial" },
+    { id: MINISTRAL_8B, label: "Ministral 8B", description: "cheapest tier, for simple work" },
+];
+/**
+ * Whether a model takes the `reasoning_effort` dial. Mistral serves it on the
+ * flagship and on Small 4, and not on the rest of the lineup.
+ */
+export function takesEffort(model) {
+    return model === MEDIUM || model === SMALL;
+}
+/**
+ * The reasoning levels offered by `/think`.
+ *
+ * `reasoning_effort` is a ROOT-LEVEL field here, and `none` is its off switch: at
+ * `none` the model thinks minimally and the thinking chunk is omitted, at `high` a
+ * full thinking chunk precedes the answer. Those two are the documented ends, so
+ * those two are what is offered — inventing intermediate rungs whose behaviour is
+ * undocumented would be a menu making promises the API has not made.
+ */
+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).
+ *
+ * Note the lineup is not priced in name order: Medium 3.5 is the newer flagship and
+ * costs several times Large 3, which is the older open-weight workhorse. That reads
+ * as a mistake and is not one.
+ *
+ * Cached input bills at a TENTH of the standard input rate, which is why `cacheHit`
+ * is a real discount here rather than a mirror of `cacheMiss`. An earlier version of
+ * this file asserted Mistral published no cached rate; it does.
+ */
+const PRICES = {
+    [MEDIUM]: { cacheHit: 0.15, cacheMiss: 1.5, output: 7.5 },
+    [LARGE]: { cacheHit: 0.05, cacheMiss: 0.5, output: 1.5 },
+    [SMALL]: { cacheHit: 0.015, cacheMiss: 0.15, output: 0.6 },
+    [MINISTRAL_8B]: { cacheHit: 0.015, cacheMiss: 0.15, output: 0.15 },
+};
+/** 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 — the sharp span rather than the storage cap,
+ *  for the same BYOK reason as every other driver here. */
+export function contextWindow(_model) {
+    return 128_000;
+}
+/** The ceiling this driver puts on a single BUFFERED call. Core reserves exactly
+ *  this much room below the window, and `client.ts` sends the same constant. */
+export const BUFFERED_OUTPUT_TOKENS = 8_000;
+export function bufferedOutputTokens(_model) {
+    return BUFFERED_OUTPUT_TOKENS;
+}
+/**
+ * Vision is deliberately NOT declared. Medium 3.5 and Large 3 are described as
+ * multimodal and Ministral 8B carries vision, but Small 4's image support is not
+ * something this driver has confirmed. A capability true for some of a list and
+ * unverified for the rest cannot be reported as a flat yes: core would attach bytes
+ * a session might silently be unable to read. Add it per model once confirmed.
+ */
+/** The effort rungs this driver uses. `none` is expressed as thinking-off. */
+const EFFORTS = ["low", "medium", "high", "xhigh", "max"];
+/** Coerce a stored or unknown config onto a model this provider actually serves,
+ *  then snap onto a rung `/think` lists so no unlisted setting can persist. */
+export function normalize(config) {
+    const model = PRICES[config.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;
+}
+/** The cheap metadata half of this driver — see `index.ts` for the wire half. */
+export const mistralManifest = {
+    id: "mistral",
+    label: "Mistral",
+    apiKeyEnv: "MISTRAL_API_KEY",
+    keysUrl: "https://console.mistral.ai/api-keys",
+    models: MODELS,
+    thinkLevels,
+    price,
+    contextWindow,
+    bufferedOutputTokens,
+    normalize,
+};
+//# sourceMappingURL=manifest.js.map

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

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

package/dist/drivers/openai/client.js

@@ -0,0 +1,290 @@
+import { basename } from "node:path";
+import { clientId } from "../clientId.js";
+import { RETRY_MAX_ATTEMPTS } from "../retryPolicy.js";
+import { BUFFERED_OUTPUT_TOKENS, DEFAULT_MODEL } from "./manifest.js";
+const MODEL = process.env.MINDWEAVE_MODEL ?? DEFAULT_MODEL;
+/** Output ceiling for a streamed turn. This caps reasoning AND answer together, so
+ *  it needs headroom at the higher rungs; the family accepts up to 128K. */
+const MAX_TOKENS_STREAM = 64_000;
+/** Buffered calls are the small internal ones (summaries, page distillation), and a
+ *  non-streaming request that runs long risks an HTTP timeout. The value lives in
+ *  the manifest because core reserves room for it when setting the compaction bars. */
+const MAX_TOKENS_BUFFERED = BUFFERED_OUTPUT_TOKENS;
+let client = null;
+/** The shared SDK client, or a clear setup error if no key is configured yet. */
+async function api() {
+    if (!client) {
+        const apiKey = process.env.OPENAI_API_KEY;
+        if (!apiKey) {
+            throw new Error("No OPENAI_API_KEY found. Add your key to the global config so Mindweave works " +
+                "in every project:\n" +
+                "  ~/.mindweave/.env  →  OPENAI_API_KEY=your-key-here\n" +
+                "(A per-project .env or an exported shell variable also works.)");
+        }
+        const { default: OpenAIClient } = await import("openai");
+        // Retries made explicit rather than inherited. These two drivers reach their
+        // provider through a vendor SDK that retries on its own, while the other eleven
+        // go through `openaiCompat/wire.ts` and use `retryPolicy.ts`. Pinning the count
+        // here means a session behaves the same way whichever provider it is pointed at,
+        // and that an SDK upgrade changing its default cannot quietly change ours.
+        client = new OpenAIClient({ apiKey, maxRetries: RETRY_MAX_ATTEMPTS - 1, defaultHeaders: { "User-Agent": clientId() } });
+    }
+    return client;
+}
+/**
+ * Convert the stored transcript into Responses input items.
+ *
+ * Two shapes have no direct equivalent and are converted rather than passed
+ * through: an assistant message's `tool_calls` become sibling `function_call`
+ * items, and a `role: "tool"` message becomes a `function_call_output`. A stray
+ * in-conversation system message is pulled out and returned separately, because
+ * the Responses API carries system text in `instructions` and dropping it would
+ * silently lose instructions.
+ */
+export function renderInput(req) {
+    const input = [];
+    const extraSystem = [];
+    for (const msg of req.messages) {
+        if (msg.role === "system") {
+            if (msg.content.trim())
+                extraSystem.push(msg.content);
+            continue;
+        }
+        if (msg.role === "tool") {
+            input.push({
+                type: "function_call_output",
+                call_id: msg.tool_call_id ?? "",
+                output: msg.content || "(no output)",
+            });
+            continue;
+        }
+        if (msg.role === "user") {
+            // Images first: the model reads an image-then-text message more reliably
+            // than the reverse, and each is labelled so a later turn can name it.
+            const content = [];
+            for (const img of msg.images ?? []) {
+                content.push({ type: "input_text", text: `Image (${basename(img.path)}):` });
+                content.push({
+                    type: "input_image",
+                    detail: "auto",
+                    image_url: `data:${img.mediaType};base64,${img.data}`,
+                });
+            }
+            if (msg.content.trim())
+                content.push({ type: "input_text", text: msg.content });
+            if (content.length > 0)
+                input.push({ role: "user", content });
+            continue;
+        }
+        // Assistant: prose first, then each tool call as its own item. Plain-string
+        // content is the simple input form; the block form is the OUTPUT shape and
+        // requires an id and status we neither have nor should invent.
+        if (msg.content.trim())
+            input.push({ role: "assistant", content: msg.content });
+        for (const call of msg.tool_calls ?? []) {
+            input.push({
+                type: "function_call",
+                call_id: call.id,
+                name: call.function.name,
+                arguments: call.function.arguments || "{}",
+            });
+        }
+    }
+    return { input, extraSystem };
+}
+/** Translate the tool schemas from their stored OpenAI CHAT shape (nested under
+ *  `function`) into the Responses shape (flat). The two are not interchangeable —
+ *  sending the nested form here is a validation error, not a tolerated variant. */
+function renderTools(req) {
+    return (req.tools ?? []).map((t) => ({
+        type: "function",
+        name: t.function.name,
+        description: t.function.description,
+        parameters: (t.function.parameters ?? {}),
+        // Loose schema validation: the tool schemas are hand-written and some carry
+        // shapes strict mode rejects. The engine validates arguments itself anyway.
+        strict: false,
+    }));
+}
+/**
+ * Build the request body shared by both paths.
+ *
+ * `store: false` is deliberate and load-bearing: by default OpenAI RETAINS the
+ * response server-side for later retrieval. Mindweave is a local-first tool whose
+ * transcript lives on the user's disk, so leaving a copy of every turn on a vendor's
+ * servers is not a default it should inherit silently.
+ *
+ * The volatile `context` is appended as the LAST input item so a changing code map
+ * or todo list never invalidates the cached prefix — OpenAI caches the longest
+ * identical prefix from the start, which is the property the ModelRequest split
+ * exists to guarantee.
+ */
+export function buildBody(req, maxTokens) {
+    const cfg = req.model;
+    const { input, extraSystem } = renderInput(req);
+    if (req.context && req.context.trim()) {
+        input.push({
+            role: "user",
+            content: [{ type: "input_text", text: `<current_context>\n${req.context}\n</current_context>` }],
+        });
+    }
+    // The API rejects an empty conversation; the engine never sends one, but a
+    // tool-less internal call could in principle.
+    if (input.length === 0) {
+        input.push({ role: "user", content: [{ type: "input_text", text: "(no input)" }] });
+    }
+    const body = {
+        model: cfg?.model ?? MODEL,
+        instructions: [req.system, ...extraSystem].filter((s) => s.trim()).join("\n\n"),
+        input,
+        max_output_tokens: maxTokens,
+        // Reasoning is ONE dial here: `none` is the off switch rather than a separate
+        // flag, so the shared thinking/effort pair collapses into a single rung.
+        reasoning: { effort: cfg?.thinking ? cfg.effort : "none" },
+        store: false,
+    };
+    const tools = renderTools(req);
+    if (tools.length > 0) {
+        body.tools = tools;
+        body.tool_choice = "auto";
+    }
+    return body;
+}
+/** Fold the Responses usage into the shared shape. `input_tokens` here is the FULL
+ *  prompt including the cached part, unlike Anthropic's, so the miss side is the
+ *  remainder after cache reads rather than a sum. */
+export function toUsage(usage) {
+    if (!usage)
+        return undefined;
+    const promptTokens = usage.input_tokens ?? 0;
+    const cacheHit = usage.input_tokens_details?.cached_tokens ?? 0;
+    const completionTokens = usage.output_tokens ?? 0;
+    return {
+        promptTokens,
+        completionTokens,
+        totalTokens: usage.total_tokens ?? promptTokens + completionTokens,
+        cacheHitTokens: cacheHit,
+        cacheMissTokens: Math.max(0, promptTokens - cacheHit),
+    };
+}
+/**
+ * Map a finished response onto the shared stop reason.
+ *
+ * The signal lives in two places: an unfinished response says WHY in
+ * `incomplete_details`, and a refusal arrives as a content part rather than a
+ * status. Both have to be read, or a cut-off reply and a declined one both look
+ * like a clean finish and the loop carries on with half an answer.
+ */
+export function toStop(response) {
+    if (response.status === "incomplete") {
+        return response.incomplete_details?.reason === "content_filter" ? "refused" : "truncated";
+    }
+    if (response.status === "failed")
+        return "overloaded";
+    for (const item of response.output ?? []) {
+        if (item.type !== "message")
+            continue;
+        for (const part of item.content ?? []) {
+            if (part.type === "refusal")
+                return "refused";
+        }
+    }
+    return "end";
+}
+/** Pull the assembled reply and tool calls out of a finished response. */
+export function toTurn(response) {
+    let content = "";
+    const toolCalls = [];
+    for (const item of response.output ?? []) {
+        if (item.type === "message") {
+            for (const part of item.content ?? []) {
+                if (part.type === "output_text")
+                    content += part.text;
+            }
+        }
+        else if (item.type === "function_call") {
+            toolCalls.push({
+                // The engine echoes this back as the result's key, and the API matches
+                // results on `call_id` — NOT on the item's own `id`. Sending the wrong
+                // one is an unmatched-result error on the following turn.
+                id: item.call_id,
+                name: item.name,
+                arguments: item.arguments || "{}",
+            });
+        }
+        // `reasoning` items are deliberately dropped — see the note in the file header.
+    }
+    return { content, toolCalls, stop: toStop(response) };
+}
+/** Ask the model for one turn. Usage rides back with it: these are core's internal
+ *  calls, and they spend real tokens that the meter would otherwise never see. */
+export async function toolTurn(req, options = {}) {
+    const response = await (await api()).responses.create(buildBody(req, MAX_TOKENS_BUFFERED), {
+        signal: options.signal,
+    });
+    return { ...toTurn(response), usage: toUsage(response.usage) };
+}
+/**
+ * Ask the model for one turn, STREAMING. Deltas go to `options.onEvent` for the
+ * live UI; the assembled turn is the return value, in the same shape the engine
+ * records either way. The SDK assembles the final response (including each tool
+ * call's JSON), so nothing here reassembles fragmented arguments by hand.
+ */
+export async function streamTurn(req, options = {}) {
+    const stream = (await api()).responses.stream({ ...buildBody(req, MAX_TOKENS_STREAM), stream: true }, { signal: options.signal });
+    if (options.onEvent) {
+        // Tool calls are announced by item index, and the shared event shape keys on a
+        // dense index — so map the API's `output_index` onto one.
+        const indexOf = new Map();
+        for await (const event of stream) {
+            emit(event, options.onEvent, indexOf);
+        }
+    }
+    const response = await stream.finalResponse();
+    return { ...toTurn(response), usage: toUsage(response.usage) };
+}
+/**
+ * Map one streaming event onto the shared event shape.
+ *
+ * Reasoning arrives on two different channels depending on how the model was
+ * asked — `reasoning_text` when the raw stream is available, `reasoning_summary_text`
+ * when only a summary is. Both are handled: whichever one the provider sends, the
+ * UI shows reasoning rather than an unexplained pause.
+ */
+export function emit(event, onEvent, indexOf) {
+    switch (event.type) {
+        case "response.output_text.delta":
+            if (event.delta)
+                onEvent({ type: "text", delta: event.delta });
+            return;
+        case "response.reasoning_text.delta":
+        case "response.reasoning_summary_text.delta":
+            if (event.delta)
+                onEvent({ type: "reasoning", delta: event.delta });
+            return;
+        case "response.output_item.added": {
+            const item = event.item;
+            if (item.type !== "function_call")
+                return;
+            const index = indexOf.size;
+            indexOf.set(event.output_index, index);
+            onEvent({ type: "tool_start", index, id: item.call_id, name: item.name });
+            return;
+        }
+        case "response.function_call_arguments.delta": {
+            const index = indexOf.get(event.output_index);
+            // A fragment before its item was announced has nowhere to go; the final
+            // response still carries the whole call, so dropping the delta only costs
+            // the live preview, never the call itself.
+            if (index === undefined || !event.delta)
+                return;
+            onEvent({ type: "tool_args", index, delta: event.delta });
+            return;
+        }
+        default:
+            // Every other event (created, in_progress, content_part.*, done, usage) has
+            // no shared equivalent — the assembled response carries what they describe.
+            return;
+    }
+}
+//# sourceMappingURL=client.js.map

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

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

package/dist/drivers/openai/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/drivers/openai/index.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,CAAC,MAAM,YAAY,GAAW;IAClC,GAAG,cAAc;IACjB,QAAQ;IACR,UAAU;CACX,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/drivers/openai/manifest.js

@@ -0,0 +1,133 @@
+export const SOL = "gpt-5.6-sol";
+export const TERRA = "gpt-5.6-terra";
+export const LUNA = "gpt-5.6-luna";
+/** The model used when nothing is saved and no env override is set. */
+export const DEFAULT_MODEL = TERRA;
+/**
+ * The models offered by `/model`. First entry is this provider's default, which is
+ * also where `/provider` lands when someone switches to OpenAI.
+ *
+ * Terra leads because it is the balanced tier — Sol is roughly 2.5x its rate and
+ * Luna a tenth of it, so Terra is the one that is rarely the wrong answer.
+ */
+export const MODELS = [
+    { id: TERRA, label: "GPT-5.6 Terra", description: "balanced intelligence and cost — the default" },
+    { id: SOL, label: "GPT-5.6 Sol", description: "the frontier tier, for the hardest problems" },
+    { id: LUNA, label: "GPT-5.6 Luna", description: "cheap and quick, for high-volume work" },
+];
+/**
+ * The reasoning levels offered by `/think`.
+ *
+ * OpenAI expresses reasoning as a single `effort` rung with `none` as its off
+ * switch, rather than a separate on/off flag plus a budget. That maps onto the
+ * shared shape cleanly: `thinking: false` becomes `none` on the wire, and the four
+ * thinking rungs are sent as themselves. All three models take the same ladder.
+ *
+ * The provider also accepts `minimal` between `none` and `low`. It is not offered:
+ * it would be a fifth rung whose difference from `low` no user could predict, and
+ * the ladder is more useful short.
+ */
+export function thinkLevels(_model) {
+    return [
+        { label: "Standard", description: "answer directly — fastest", thinking: false, effort: "high" },
+        { label: "Thinking", description: "think first, then answer", thinking: true, effort: "medium" },
+        { label: "Deep", description: "more reasoning, more tool work", thinking: true, effort: "high" },
+        { label: "Maximum", description: "maximum reasoning budget", thinking: true, effort: "max" },
+    ];
+}
+/**
+ * List prices (USD / 1M tokens). Cached input bills at a tenth of fresh input,
+ * which is what keeps a re-sent conversation cheap.
+ */
+const PRICES = {
+    [SOL]: { cacheHit: 0.5, cacheMiss: 5, output: 30 },
+    [TERRA]: { cacheHit: 0.2, cacheMiss: 2, output: 12 },
+    [LUNA]: { cacheHit: 0.02, cacheMiss: 0.2, output: 1.2 },
+};
+/** 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. All three STORE 1.05M tokens (922K of it
+ * input), 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. Same reasoning, and the same number, as Anthropic's.
+ */
+export function contextWindow(_model) {
+    return 200_000;
+}
+/**
+ * The ceiling this driver puts on a single BUFFERED (non-streaming) call.
+ *
+ * All three models accept 128K output, but a non-streaming request that runs that
+ * long risks an HTTP timeout, so the buffered path — core's small internal calls,
+ * like a compaction summary — is capped far lower. `client.ts` sends this value and
+ * `dynamo/contextWindow.ts` reserves it; one exported constant means the request
+ * and the reservation cannot drift apart.
+ */
+export const BUFFERED_OUTPUT_TOKENS = 16_000;
+export function bufferedOutputTokens(_model) {
+    return BUFFERED_OUTPUT_TOKENS;
+}
+/** The effort rungs this provider accepts, weakest first. */
+const EFFORTS = ["low", "medium", "high", "xhigh", "max"];
+/** Every model in this family takes image input alongside text. */
+export function acceptsImages(_model) {
+    return true;
+}
+/**
+ * Coerce a stored or unknown config onto a model this provider actually serves.
+ *
+ * There is no per-model rule to enforce here — the family shares one ladder, so an
+ * unknown model id falls back and an unknown effort clamps, and that is all. The
+ * result is then snapped onto a rung `/think` actually lists, so a config carried
+ * in from another provider by `/model` cannot leave the user on a setting the menu
+ * has no tick beside.
+ */
+export function normalize(config) {
+    const model = PRICES[config.model] ? config.model : DEFAULT_MODEL;
+    const thinking = config.thinking === true;
+    const effort = EFFORTS.includes(config.effort) ? config.effort : "high";
+    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 openaiManifest = {
+    id: "openai",
+    label: "OpenAI",
+    apiKeyEnv: "OPENAI_API_KEY",
+    keysUrl: "https://platform.openai.com/api-keys",
+    models: MODELS,
+    thinkLevels,
+    price,
+    contextWindow,
+    bufferedOutputTokens,
+    acceptsImages,
+    normalize,
+};
+//# sourceMappingURL=manifest.js.map

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

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