@nodetool-ai/runtime 0.7.0-rc.23 → 0.8.1

package/dist/providers/openai-compat/client.js

@@ -0,0 +1,157 @@
+import { sseEvents } from "./sse.js";
+import { OpenAICompatError, errorFromOkBody, errorFromResponse, errorFromStreamEvent } from "./errors.js";
+import { isObjectLike } from "@nodetool-ai/protocol";
+const RETRYABLE_STATUS = new Set([408, 409, 429]);
+const DEFAULT_MAX_RETRIES = 2;
+const DEFAULT_TIMEOUT_MS = 600_000;
+export function trimTrailingSlashes(url) {
+    // A loop, not `replace(/\/+$/,"")` — the regex backtracks polynomially on
+    // adversarial input.
+    let end = url.length;
+    while (end > 0 && url[end - 1] === "/")
+        end -= 1;
+    return url.slice(0, end);
+}
+function isRetryableStatus(status) {
+    return RETRYABLE_STATUS.has(status) || status >= 500;
+}
+/** `Retry-After` seconds when present and sane (0–60s), else null. */
+function retryAfterMs(response) {
+    const header = response.headers.get("retry-after");
+    if (!header)
+        return null;
+    const seconds = Number(header);
+    if (Number.isFinite(seconds) && seconds >= 0 && seconds <= 60) {
+        return seconds * 1000;
+    }
+    const dateMs = Date.parse(header);
+    if (!Number.isNaN(dateMs)) {
+        const delta = dateMs - Date.now();
+        if (delta > 0 && delta <= 60_000)
+            return delta;
+    }
+    return null;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function backoffMs(attempt) {
+    const base = Math.min(500 * 2 ** attempt, 8000);
+    return base * (0.75 + Math.random() * 0.5);
+}
+/**
+ * Minimal typed client for OpenAI-compatible `/chat/completions` endpoints,
+ * built on `fetch`. Replaces the `openai` npm package for providers that only
+ * ever used it as a generic HTTP client (Groq, Cerebras, xAI, Mistral, …).
+ */
+export class OpenAICompatClient {
+    baseURL;
+    _apiKey;
+    _defaultHeaders;
+    _fetch;
+    _maxRetries;
+    _timeoutMs;
+    constructor(options) {
+        this.baseURL = trimTrailingSlashes(options.baseURL);
+        this._apiKey = options.apiKey;
+        this._defaultHeaders = options.defaultHeaders ?? {};
+        this._fetch = options.fetchFn ?? globalThis.fetch.bind(globalThis);
+        this._maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+        this._timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    }
+    headers(streaming) {
+        return {
+            Authorization: `Bearer ${this._apiKey}`,
+            "Content-Type": "application/json",
+            Accept: streaming ? "text/event-stream" : "application/json",
+            ...this._defaultHeaders
+        };
+    }
+    /**
+     * POST with retries. Retries fire only before any body is consumed, so both
+     * the non-streaming call and the streaming connection setup are covered.
+     * Non-2xx responses (after retries) surface as {@link OpenAICompatError}.
+     */
+    async post(path, body, streaming, options) {
+        const url = `${this.baseURL}${path}`;
+        const payload = JSON.stringify(body);
+        for (let attempt = 0;; attempt++) {
+            options.signal?.throwIfAborted();
+            const timeout = AbortSignal.timeout(this._timeoutMs);
+            const signal = options.signal
+                ? AbortSignal.any([options.signal, timeout])
+                : timeout;
+            let response;
+            try {
+                response = await this._fetch(url, {
+                    method: "POST",
+                    headers: this.headers(streaming),
+                    body: payload,
+                    signal
+                });
+            }
+            catch (error) {
+                // Abort by the caller is never retried; network errors and timeouts are.
+                if (options.signal?.aborted)
+                    throw error;
+                if (attempt >= this._maxRetries)
+                    throw error;
+                await sleep(backoffMs(attempt));
+                continue;
+            }
+            if (response.ok)
+                return response;
+            const detail = await response.text().catch(() => "");
+            if (attempt < this._maxRetries && isRetryableStatus(response.status)) {
+                await sleep(retryAfterMs(response) ?? backoffMs(attempt));
+                continue;
+            }
+            throw errorFromResponse(response.status, detail);
+        }
+    }
+    /**
+     * Non-streaming chat completion.
+     *
+     * A 200 is not proof of success: a gateway that routes to an upstream
+     * provider answers 200 and reports a later failure inside the body, so the
+     * body is checked for an `error` before it is handed back as a completion.
+     */
+    async chatCompletions(request, options = {}) {
+        const response = await this.post("/chat/completions", { ...request, stream: false }, false, options);
+        const body = await response.json();
+        const error = errorFromOkBody(body);
+        if (error)
+            throw error;
+        return body;
+    }
+    /**
+     * Streaming chat completion. Yields parsed SSE chunks until the `[DONE]`
+     * sentinel (or end of stream). Mid-stream `{"error": …}` events throw an
+     * {@link OpenAICompatError}.
+     */
+    async *chatCompletionsStream(request, options = {}) {
+        const response = await this.post("/chat/completions", { ...request, stream: true }, true, options);
+        if (!response.body) {
+            throw new OpenAICompatError(response.status, "streaming response has no body");
+        }
+        for await (const data of sseEvents(response.body)) {
+            if (data === "[DONE]")
+                return;
+            let parsed;
+            try {
+                parsed = JSON.parse(data);
+            }
+            catch {
+                throw new OpenAICompatError(undefined, `could not parse stream event as JSON: ${data.slice(0, 200)}`);
+            }
+            if (!isObjectLike(parsed))
+                continue;
+            const event = parsed;
+            const error = errorFromStreamEvent(event);
+            if (error)
+                throw error;
+            yield event;
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/providers/openai-compat/client.js.map

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

package/dist/providers/openai-compat/decode.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Response decoding for the OpenAI Chat Completions dialect.
+ *
+ * Split out of {@link OpenAICompatProvider} so one function owns the step from
+ * a raw `POST /chat/completions` body to the fields NodeTool reads. The live
+ * contract probe and the checked-in raw-response fixtures
+ * (`packages/runtime/tests/fixtures/provider-contract/`) run this same
+ * function, so a wire change shows up here rather than in a provider method no
+ * test can reach without a network call.
+ */
+import type { ChatCompletionUsage } from "./types.js";
+/** One tool call as it arrives on the wire, before NodeTool normalizes it. */
+export interface DecodedToolCall {
+    id: string;
+    name: string;
+    /** Raw JSON argument string; absent when the gateway omitted it. */
+    arguments?: string;
+}
+export interface DecodedChatCompletion {
+    content: string | null;
+    /** Undefined when the response carried no `tool_calls` field at all. */
+    toolCalls: DecodedToolCall[] | undefined;
+    finishReason: string | null;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        cachedTokens: number;
+    } | null;
+}
+export declare function decodeChatCompletionUsage(usage: ChatCompletionUsage | null | undefined): DecodedChatCompletion["usage"];
+/**
+ * Decode a non-streaming chat completion body. Throws when the envelope
+ * carries no choice — the one shape the caller cannot turn into a message.
+ */
+export declare function decodeChatCompletion(body: unknown): DecodedChatCompletion;
+//# sourceMappingURL=decode.d.ts.map

package/dist/providers/openai-compat/decode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-compat/decode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAEV,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,wEAAwE;IACxE,SAAS,EAAE,eAAe,EAAE,GAAG,SAAS,CAAC;IACzC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACnF;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAC5C,qBAAqB,CAAC,OAAO,CAAC,CAOhC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,qBAAqB,CA8BzE"}

package/dist/providers/openai-compat/decode.js

@@ -0,0 +1,55 @@
+/**
+ * Response decoding for the OpenAI Chat Completions dialect.
+ *
+ * Split out of {@link OpenAICompatProvider} so one function owns the step from
+ * a raw `POST /chat/completions` body to the fields NodeTool reads. The live
+ * contract probe and the checked-in raw-response fixtures
+ * (`packages/runtime/tests/fixtures/provider-contract/`) run this same
+ * function, so a wire change shows up here rather than in a provider method no
+ * test can reach without a network call.
+ */
+import { isObjectLike } from "@nodetool-ai/protocol";
+export function decodeChatCompletionUsage(usage) {
+    if (!usage)
+        return null;
+    return {
+        inputTokens: usage.prompt_tokens ?? 0,
+        outputTokens: usage.completion_tokens ?? 0,
+        cachedTokens: usage.prompt_tokens_details?.cached_tokens ?? 0
+    };
+}
+/**
+ * Decode a non-streaming chat completion body. Throws when the envelope
+ * carries no choice — the one shape the caller cannot turn into a message.
+ */
+export function decodeChatCompletion(body) {
+    if (!isObjectLike(body)) {
+        throw new Error("chat completion response is not an object");
+    }
+    const completion = body;
+    const choice = completion.choices?.[0];
+    if (!choice) {
+        throw new Error("chat completion response has no choices");
+    }
+    const message = choice.message;
+    // Keep function calls, and entries with no `type` at all — some gateways
+    // omit it (the wire type marks `type` optional). The streaming path
+    // likewise accepts every tool-call delta. Only drop entries that explicitly
+    // declare a non-function type.
+    const toolCalls = !Array.isArray(message?.tool_calls)
+        ? undefined
+        : message.tool_calls
+            .filter((tc) => tc.type === "function" || tc.type === undefined)
+            .map((tc) => ({
+            id: String(tc.id ?? ""),
+            name: String(tc.function?.name ?? ""),
+            arguments: tc.function?.arguments ?? undefined
+        }));
+    return {
+        content: message?.content ?? null,
+        toolCalls,
+        finishReason: choice.finish_reason ?? null,
+        usage: decodeChatCompletionUsage(completion.usage)
+    };
+}
+//# sourceMappingURL=decode.js.map

package/dist/providers/openai-compat/decode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.js","sourceRoot":"","sources":["../../../src/providers/openai-compat/decode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAsBrD,MAAM,UAAU,yBAAyB,CACvC,KAA6C;IAE7C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,aAAa,IAAI,CAAC;QACrC,YAAY,EAAE,KAAK,CAAC,iBAAiB,IAAI,CAAC;QAC1C,YAAY,EAAE,KAAK,CAAC,qBAAqB,EAAE,aAAa,IAAI,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAChD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,UAAU,GAAG,IAA8B,CAAC;IAClD,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,yEAAyE;IACzE,oEAAoE;IACpE,4EAA4E;IAC5E,+BAA+B;IAC/B,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC;QACnD,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,OAAO,CAAC,UAAU;aACf,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,UAAU,IAAI,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC;aAC/D,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YACZ,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;YACvB,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC;YACrC,SAAS,EAAE,EAAE,CAAC,QAAQ,EAAE,SAAS,IAAI,SAAS;SAC/C,CAAC,CAAC,CAAC;IAEV,OAAO;QACL,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI;QACjC,SAAS;QACT,YAAY,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI;QAC1C,KAAK,EAAE,yBAAyB,CAAC,UAAU,CAAC,KAAK,CAAC;KACnD,CAAC;AACJ,CAAC"}

package/dist/providers/openai-compat/errors.d.ts

@@ -0,0 +1,54 @@
+export declare class OpenAICompatError extends Error {
+    /** HTTP status; `undefined` for mid-stream error events with no status. */
+    readonly status: number | undefined;
+    readonly code: string | null;
+    readonly type: string | null;
+    readonly param: string | null;
+    /** The parsed error body (or raw text when not JSON). */
+    readonly body: unknown;
+    constructor(status: number | undefined, message: string, details?: {
+        code?: string | null;
+        type?: string | null;
+        param?: string | null;
+        body?: unknown;
+    });
+}
+interface ParsedErrorBody {
+    message: string;
+    code: string | null;
+    type: string | null;
+    param: string | null;
+    body: unknown;
+}
+/**
+ * Extract the human-readable message (and code/type/param) from an
+ * OpenAI-style error payload: `{"error": {"message": …, "code": …}}`, a
+ * top-level `{"message": …}`, or plain text.
+ */
+export declare function parseErrorBody(text: string): ParsedErrorBody;
+/** Map a non-2xx HTTP response body to an {@link OpenAICompatError}. */
+export declare function errorFromResponse(status: number, bodyText: string): OpenAICompatError;
+/**
+ * Map a mid-stream SSE error event to an {@link OpenAICompatError}. Returns
+ * `null` when the event is not an error.
+ *
+ * The error rides at the top level (`{"error": {...}}`) or inside the first
+ * choice — OpenRouter reports a failure that happens after the stream opened
+ * as a `finish_reason: "error"` choice, because the 200 status is already on
+ * the wire by then.
+ */
+export declare function errorFromStreamEvent(event: Record<string, unknown>): OpenAICompatError | null;
+/**
+ * Map an error carried by a *successful* (HTTP 200) chat-completion body to an
+ * {@link OpenAICompatError}. Returns `null` for an ordinary completion.
+ *
+ * A gateway that has already committed a 200 cannot report a later failure in
+ * the status, so it reports it in the body instead — OpenRouter's API
+ * reference says to check the body for an `error` field even on a 200 rather
+ * than relying on the status alone. Without this the body reaches
+ * {@link decodeChatCompletion}, which sees no `choices` and answers "no
+ * choices" — a diagnosis that names neither the endpoint nor the reason.
+ */
+export declare function errorFromOkBody(body: unknown): OpenAICompatError | null;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/providers/openai-compat/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-compat/errors.ts"],"names":[],"mappings":"AAUA,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAEvB,YACE,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,EAAE,OAAO,CAAC;KACX,EASP;CACF;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;CACf;AAUD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAuB5D;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,iBAAiB,CAGnB;AAsDD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,iBAAiB,GAAG,IAAI,CAK1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI,CAMvE"}

package/dist/providers/openai-compat/errors.js

@@ -0,0 +1,144 @@
+/**
+ * Typed error for OpenAI-compatible HTTP endpoints.
+ *
+ * The message deliberately mirrors the `openai` SDK's `APIError` format —
+ * `"<status> <upstream message>"` — because callers classify failures by
+ * matching on `String(error)` (BaseProvider.isRateLimitError looks for `429` /
+ * "rate limit", isContextLengthError for "context length", …).
+ */
+import { isNumber, isString } from "@nodetool-ai/protocol";
+export class OpenAICompatError extends Error {
+    /** HTTP status; `undefined` for mid-stream error events with no status. */
+    status;
+    code;
+    type;
+    param;
+    /** The parsed error body (or raw text when not JSON). */
+    body;
+    constructor(status, message, details = {}) {
+        super(status === undefined ? message : `${status} ${message}`);
+        this.name = "OpenAICompatError";
+        this.status = status;
+        this.code = details.code ?? null;
+        this.type = details.type ?? null;
+        this.param = details.param ?? null;
+        this.body = details.body;
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function stringOrNull(value) {
+    return isString(value) ? value : null;
+}
+/**
+ * Extract the human-readable message (and code/type/param) from an
+ * OpenAI-style error payload: `{"error": {"message": …, "code": …}}`, a
+ * top-level `{"message": …}`, or plain text.
+ */
+export function parseErrorBody(text) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return { message: text, code: null, type: null, param: null, body: text };
+    }
+    const root = isRecord(parsed) ? parsed : {};
+    const err = isRecord(root.error) ? root.error : root;
+    const message = stringOrNull(err.message) ??
+        (isString(root.error) ? root.error : null) ??
+        text;
+    return {
+        message,
+        code: stringOrNull(err.code) ?? (isNumber(err.code) ? String(err.code) : null),
+        type: stringOrNull(err.type),
+        param: stringOrNull(err.param),
+        body: parsed
+    };
+}
+/** Map a non-2xx HTTP response body to an {@link OpenAICompatError}. */
+export function errorFromResponse(status, bodyText) {
+    const parsed = parseErrorBody(bodyText);
+    return new OpenAICompatError(status, parsed.message, parsed);
+}
+/**
+ * Map one `error` value — wherever it sat in the payload — to an
+ * {@link OpenAICompatError}. `payload` is the whole body or event, kept for
+ * the error's `body` so a caller logging the failure sees what arrived.
+ * Returns `null` when `err` is absent or not an error shape.
+ */
+function errorFromErrorValue(err, payload, fallbackMessage) {
+    if (err === undefined || err === null)
+        return null;
+    if (isString(err)) {
+        return new OpenAICompatError(undefined, err, { body: payload });
+    }
+    if (!isRecord(err))
+        return null;
+    const message = stringOrNull(err.message) ?? fallbackMessage;
+    // A numeric `code` is the HTTP status on a gateway that reports the failure
+    // in a 200 body (OpenRouter mirrors the status there). Taking it as the
+    // status is what keeps `BaseProvider.isRateLimitError` — which matches on
+    // `String(error)` — working for a 429 that never reached the status line.
+    const codeStatus = isNumber(err.code) && err.code >= 100 && err.code <= 599
+        ? err.code
+        : undefined;
+    const status = isNumber(err.status)
+        ? err.status
+        : isNumber(err.http_status)
+            ? err.http_status
+            : codeStatus;
+    return new OpenAICompatError(status, message, {
+        code: stringOrNull(err.code) ?? (isNumber(err.code) ? String(err.code) : null),
+        type: stringOrNull(err.type),
+        param: stringOrNull(err.param),
+        body: payload
+    });
+}
+/** The `error` carried by the payload's first choice, if any. */
+function choiceError(payload) {
+    const choices = payload.choices;
+    if (!Array.isArray(choices))
+        return undefined;
+    const choice = choices[0];
+    if (!isRecord(choice))
+        return undefined;
+    // Streaming puts it on the delta on some gateways, non-streaming on the
+    // choice itself; the choice's own field wins when both are present.
+    if (choice.error !== undefined && choice.error !== null)
+        return choice.error;
+    const delta = choice.delta;
+    return isRecord(delta) ? delta.error : undefined;
+}
+/**
+ * Map a mid-stream SSE error event to an {@link OpenAICompatError}. Returns
+ * `null` when the event is not an error.
+ *
+ * The error rides at the top level (`{"error": {...}}`) or inside the first
+ * choice — OpenRouter reports a failure that happens after the stream opened
+ * as a `finish_reason: "error"` choice, because the 200 status is already on
+ * the wire by then.
+ */
+export function errorFromStreamEvent(event) {
+    return (errorFromErrorValue(event.error, event, "stream error") ??
+        errorFromErrorValue(choiceError(event), event, "stream error"));
+}
+/**
+ * Map an error carried by a *successful* (HTTP 200) chat-completion body to an
+ * {@link OpenAICompatError}. Returns `null` for an ordinary completion.
+ *
+ * A gateway that has already committed a 200 cannot report a later failure in
+ * the status, so it reports it in the body instead — OpenRouter's API
+ * reference says to check the body for an `error` field even on a 200 rather
+ * than relying on the status alone. Without this the body reaches
+ * {@link decodeChatCompletion}, which sees no `choices` and answers "no
+ * choices" — a diagnosis that names neither the endpoint nor the reason.
+ */
+export function errorFromOkBody(body) {
+    if (!isRecord(body))
+        return null;
+    return (errorFromErrorValue(body.error, body, "chat completion failed") ??
+        errorFromErrorValue(choiceError(body), body, "chat completion failed"));
+}
+//# sourceMappingURL=errors.js.map

package/dist/providers/openai-compat/errors.js.map

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

package/dist/providers/openai-compat/index.d.ts

@@ -0,0 +1,8 @@
+export { OpenAICompatClient, trimTrailingSlashes } from "./client.js";
+export type { OpenAICompatClientOptions, RequestOptions } from "./client.js";
+export { OpenAICompatError, errorFromOkBody, errorFromResponse, errorFromStreamEvent, parseErrorBody } from "./errors.js";
+export { sseEvents } from "./sse.js";
+export { decodeChatCompletion, decodeChatCompletionUsage } from "./decode.js";
+export type { DecodedChatCompletion, DecodedToolCall } from "./decode.js";
+export type { ChatCompletionsRequest, ChatCompletionResponse, ChatCompletionChunk, ChatCompletionChunkChoice, ChatCompletionChunkDelta, ChatCompletionChunkDeltaToolCall, ChatCompletionChoice, ChatCompletionAssistantMessage, ChatCompletionMessageToolCall, ChatCompletionToolCallFunction, ChatCompletionUsage } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/openai-compat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-compat/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACtE,YAAY,EACV,yBAAyB,EACzB,cAAc,EACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,qBAAqB,EACrB,eAAe,EAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,gCAAgC,EAChC,oBAAoB,EACpB,8BAA8B,EAC9B,6BAA6B,EAC7B,8BAA8B,EAC9B,mBAAmB,EACpB,MAAM,YAAY,CAAC"}

package/dist/providers/openai-compat/index.js

@@ -0,0 +1,5 @@
+export { OpenAICompatClient, trimTrailingSlashes } from "./client.js";
+export { OpenAICompatError, errorFromOkBody, errorFromResponse, errorFromStreamEvent, parseErrorBody } from "./errors.js";
+export { sseEvents } from "./sse.js";
+export { decodeChatCompletion, decodeChatCompletionUsage } from "./decode.js";
+//# sourceMappingURL=index.js.map

package/dist/providers/openai-compat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/openai-compat/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAKtE,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,aAAa,CAAC"}

package/dist/providers/openai-compat/sse.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Minimal Server-Sent Events parser for OpenAI-style streaming responses.
+ *
+ * Yields the joined `data:` payload of each event. Handles the parts of the
+ * SSE spec that OpenAI-compatible gateways actually exercise:
+ *  - events separated by blank lines, with LF or CRLF line endings
+ *  - events and lines split across arbitrary network-chunk boundaries
+ *  - multiple `data:` lines per event (joined with `\n`)
+ *  - comment lines (`:`) and non-data fields (`event:`, `id:`, …) are ignored
+ *  - a final unterminated event is flushed at end-of-stream (some gateways
+ *    close the connection right after `data: [DONE]` without a blank line)
+ */
+export declare function sseEvents(body: ReadableStream<Uint8Array>): AsyncGenerator<string, void, undefined>;
+//# sourceMappingURL=sse.d.ts.map

package/dist/providers/openai-compat/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-compat/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAuB,SAAS,CAC9B,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAC/B,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAsDzC"}

package/dist/providers/openai-compat/sse.js

@@ -0,0 +1,69 @@
+/**
+ * Minimal Server-Sent Events parser for OpenAI-style streaming responses.
+ *
+ * Yields the joined `data:` payload of each event. Handles the parts of the
+ * SSE spec that OpenAI-compatible gateways actually exercise:
+ *  - events separated by blank lines, with LF or CRLF line endings
+ *  - events and lines split across arbitrary network-chunk boundaries
+ *  - multiple `data:` lines per event (joined with `\n`)
+ *  - comment lines (`:`) and non-data fields (`event:`, `id:`, …) are ignored
+ *  - a final unterminated event is flushed at end-of-stream (some gateways
+ *    close the connection right after `data: [DONE]` without a blank line)
+ */
+export async function* sseEvents(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder("utf-8");
+    let buffer = "";
+    let dataLines = [];
+    const takeEvent = () => {
+        if (dataLines.length === 0)
+            return null;
+        const event = dataLines.join("\n");
+        dataLines = [];
+        return event;
+    };
+    const consumeLine = (rawLine) => {
+        const line = rawLine.endsWith("\r") ? rawLine.slice(0, -1) : rawLine;
+        if (line === "") {
+            return takeEvent();
+        }
+        if (line.startsWith("data:")) {
+            const value = line.slice(5);
+            dataLines.push(value.startsWith(" ") ? value.slice(1) : value);
+        }
+        // Comments (":…") and other fields ("event:", "id:", "retry:") are ignored.
+        return null;
+    };
+    try {
+        for (;;) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            let newlineAt;
+            while ((newlineAt = buffer.indexOf("\n")) !== -1) {
+                const line = buffer.slice(0, newlineAt);
+                buffer = buffer.slice(newlineAt + 1);
+                const event = consumeLine(line);
+                if (event !== null)
+                    yield event;
+            }
+        }
+        // Flush any decoder-buffered bytes and a trailing line without newline.
+        buffer += decoder.decode();
+        if (buffer !== "") {
+            const event = consumeLine(buffer);
+            if (event !== null)
+                yield event;
+        }
+        const trailing = takeEvent();
+        if (trailing !== null)
+            yield trailing;
+    }
+    finally {
+        // Stop the underlying connection if the consumer bails early.
+        await reader.cancel().catch(() => undefined);
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/providers/openai-compat/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../../src/providers/openai-compat/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,SAAS,CAC9B,IAAgC;IAEhC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,SAAS,GAAa,EAAE,CAAC;IAE7B,MAAM,SAAS,GAAG,GAAkB,EAAE;QACpC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACxC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,SAAS,GAAG,EAAE,CAAC;QACf,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,CAAC,OAAe,EAAiB,EAAE;QACrD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACrE,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YAChB,OAAO,SAAS,EAAE,CAAC;QACrB,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC5B,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACjE,CAAC;QACD,4EAA4E;QAC5E,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,IAAI,CAAC;QACH,SAAS,CAAC;YACR,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAElD,IAAI,SAAiB,CAAC;YACtB,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;gBACxC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;gBACrC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;gBAChC,IAAI,KAAK,KAAK,IAAI;oBAAE,MAAM,KAAK,CAAC;YAClC,CAAC;QACH,CAAC;QAED,wEAAwE;QACxE,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAC3B,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;YAClC,IAAI,KAAK,KAAK,IAAI;gBAAE,MAAM,KAAK,CAAC;QAClC,CAAC;QACD,MAAM,QAAQ,GAAG,SAAS,EAAE,CAAC;QAC7B,IAAI,QAAQ,KAAK,IAAI;YAAE,MAAM,QAAQ,CAAC;IACxC,CAAC;YAAS,CAAC;QACT,8DAA8D;QAC9D,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC7C,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}