@proposit/proposit-core 1.10.0 → 2.0.0

package/dist/extensions/openai/openai-http.js

@@ -0,0 +1,310 @@
+// HTTP transport for the OpenAI Responses API: the single-call POST,
+// the foreground/background dispatch, the submit-then-poll background
+// loop, and the background-stream create. These functions own the wire
+// interaction (fetch, headers, abort handling, status classification);
+// they return the parsed `TOpenAiResponsesEnvelope` and leave the
+// retrieval-shaped projection to the layer above.
+//
+// Layering: this module sits above `openai-parsing.ts` (it consumes
+// `readSseEnvelope` / `isAbortError`) and `errors.ts` (error classes +
+// `classifyHttpError`); nothing here imports from `provider.ts` or
+// `openai-retrieval.ts`, keeping the dependency graph acyclic.
+import { isAbortError, readSseEnvelope } from "./openai-parsing.js";
+import { classifyHttpError, ResponseNotFoundError, TransientLlmError, } from "./errors.js";
+export function resolveFetch(injected, fnName) {
+    const fetchImpl = injected ?? globalThis.fetch;
+    if (!fetchImpl) {
+        throw new Error(`${fnName}: no fetch implementation available. Pass \`fetch\` explicitly or run in an environment that provides \`globalThis.fetch\` (Node ≥18, modern browsers, Expo).`);
+    }
+    return fetchImpl;
+}
+// -- HTTP --
+export async function fetchResponseEnvelope(args) {
+    if (args.backgroundStream) {
+        return runBackgroundStream({
+            url: args.url,
+            apiKey: args.apiKey,
+            body: args.body,
+            fetchImpl: args.fetchImpl,
+            signal: args.signal,
+            onResponseId: args.onResponseId,
+        });
+    }
+    if (args.background) {
+        return runBackground({
+            url: args.url,
+            apiKey: args.apiKey,
+            body: args.body,
+            fetchImpl: args.fetchImpl,
+            signal: args.signal,
+            pollIntervalMs: args.pollIntervalMs,
+        });
+    }
+    if (args.stream) {
+        const response = await callOnce({
+            url: args.url,
+            apiKey: args.apiKey,
+            body: { ...args.body, stream: true },
+            fetchImpl: args.fetchImpl,
+            signal: args.signal,
+        });
+        return readSseEnvelope(response);
+    }
+    const response = await callOnce({
+        url: args.url,
+        apiKey: args.apiKey,
+        body: args.body,
+        fetchImpl: args.fetchImpl,
+        signal: args.signal,
+    });
+    return parseJsonOrThrowTransient(response, "OpenAI response body was not valid JSON");
+}
+export async function parseJsonOrThrowTransient(response, context) {
+    return response
+        .json()
+        .then((j) => j)
+        .catch((err) => {
+        throw new TransientLlmError({
+            message: `${context}: ${err instanceof Error ? err.message : String(err)}`,
+        });
+    });
+}
+function abortError() {
+    const e = new Error("The OpenAI background request was aborted.");
+    e.name = "AbortError";
+    return e;
+}
+// Resolves (never rejects) on abort by design: the poll loop owns the
+// abort→cancel→throw decision at exactly two checkpoints (top-of-loop and
+// the in-flight-GET catch), so this helper just needs to wake the loop
+// promptly instead of waiting out the full interval. Keeping it
+// non-throwing avoids a second, competing abort surface.
+function abortableDelay(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal?.aborted) {
+            resolve();
+            return;
+        }
+        const onAbort = () => {
+            cleanup();
+            resolve();
+        };
+        const cleanup = () => {
+            clearTimeout(timer);
+            signal?.removeEventListener("abort", onAbort);
+        };
+        const timer = setTimeout(() => {
+            cleanup();
+            resolve();
+        }, ms);
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+export async function getResponseById(args) {
+    let response;
+    try {
+        response = await args.fetchImpl(`${args.url}/${args.id}`, {
+            method: "GET",
+            headers: { Authorization: `Bearer ${args.apiKey}` },
+            signal: args.signal,
+        });
+    }
+    catch (err) {
+        if (isAbortError(err))
+            throw err;
+        throw new TransientLlmError({
+            message: `Network error polling OpenAI background response: ${err instanceof Error ? err.message : String(err)}`,
+        });
+    }
+    if (response.status === 404) {
+        // Response has aged out of the ~10-minute retention window or
+        // was never stored. Surface as a typed error so callers can
+        // clear the stored id and settle the stage as failed.
+        throw new ResponseNotFoundError({ responseId: args.id });
+    }
+    if (!response.ok) {
+        const errorBody = await response.text().catch(() => "");
+        throw classifyHttpError(response.status, `OpenAI poll ${response.status.toString()}: ${errorBody || response.statusText}`);
+    }
+    return parseJsonOrThrowTransient(response, "OpenAI poll body was not valid JSON");
+}
+// Intentionally takes no AbortSignal — cancel must fire even though the
+// caller's signal has already aborted; passing the fired signal would
+// abort the cancel itself.
+async function cancelBackground(args) {
+    // Best-effort + idempotent — swallow errors; the abort is surfaced
+    // regardless of whether cancel succeeds.
+    try {
+        await args.fetchImpl(`${args.url}/${args.id}/cancel`, {
+            method: "POST",
+            headers: { Authorization: `Bearer ${args.apiKey}` },
+        });
+    }
+    catch {
+        // ignore
+    }
+}
+function isTerminalBackgroundStatus(status) {
+    return (status === "completed" ||
+        status === "failed" ||
+        status === "incomplete" ||
+        status === "cancelled");
+}
+/**
+ * Submit a single request with `{ background: true, stream: true,
+ * store: true }` and consume the resulting SSE stream live, returning
+ * the terminal envelope.
+ *
+ * A background response can only be streamed if it was *created* with
+ * `stream: true` (a background-without-stream response is poll-only and
+ * cannot later be streamed), so this mode uses one streaming create
+ * call rather than a separate non-streaming submit POST. The response
+ * id is therefore not in a JSON POST body — it arrives in the first
+ * `response.created` SSE event. `onResponseId` fires the moment that
+ * event is parsed (before the terminal event), so the caller can
+ * persist the id while the call is still in flight.
+ *
+ * The response keeps generating server-side even if the connection
+ * drops during stream consumption, and can be recovered via
+ * `retrieveResponse` within the ~10-minute retention window. A
+ * connection drop mid-stream (no terminal event before stream end) is
+ * classified as a `TransientLlmError` so the framework's retry policy
+ * applies — but because the id was already surfaced mid-flight, a
+ * crashed in-flight call can be recovered rather than blindly re-run.
+ */
+async function runBackgroundStream(args) {
+    if (args.signal?.aborted)
+        throw abortError();
+    const httpResponse = await callOnce({
+        url: args.url,
+        apiKey: args.apiKey,
+        body: { ...args.body, background: true, stream: true, store: true },
+        fetchImpl: args.fetchImpl,
+        signal: args.signal,
+    });
+    return readSseEnvelope(httpResponse, args.onResponseId);
+}
+async function runBackground(args) {
+    if (args.signal?.aborted)
+        throw abortError();
+    const submit = await callOnce({
+        url: args.url,
+        apiKey: args.apiKey,
+        body: { ...args.body, background: true, store: true },
+        fetchImpl: args.fetchImpl,
+        signal: args.signal,
+    });
+    const submitEnvelope = await parseJsonOrThrowTransient(submit, "OpenAI background submit body was not valid JSON");
+    const id = submitEnvelope.id;
+    if (!id) {
+        throw new TransientLlmError({
+            message: "OpenAI background submit returned no response id.",
+        });
+    }
+    // Fast-path: a small/cached request can come back already terminal on
+    // submit — return it directly rather than issuing a redundant poll GET
+    // (and avoid a `store`-expiry window between submit and first poll).
+    if (isTerminalBackgroundStatus(submitEnvelope.status)) {
+        if (submitEnvelope.status === "cancelled")
+            throw abortError();
+        return submitEnvelope;
+    }
+    for (;;) {
+        if (args.signal?.aborted) {
+            await cancelBackground({
+                url: args.url,
+                id,
+                apiKey: args.apiKey,
+                fetchImpl: args.fetchImpl,
+            });
+            throw abortError();
+        }
+        let env;
+        try {
+            env = await getResponseById({
+                url: args.url,
+                id,
+                apiKey: args.apiKey,
+                fetchImpl: args.fetchImpl,
+                signal: args.signal,
+            });
+        }
+        catch (err) {
+            // Abort landing DURING an in-flight poll GET surfaces as an
+            // AbortError from getResponseById (real fetch rejects the
+            // in-flight request). The top-of-loop check alone would miss
+            // it, so cancel here before re-throwing — this is what makes
+            // the "AbortSignal → cancel POST" guarantee hold mid-poll.
+            if (isAbortError(err)) {
+                await cancelBackground({
+                    url: args.url,
+                    id,
+                    apiKey: args.apiKey,
+                    fetchImpl: args.fetchImpl,
+                });
+                throw abortError();
+            }
+            throw err;
+        }
+        const status = env.status;
+        // Deliberately inlined rather than calling
+        // `isTerminalBackgroundStatus`: `cancelled` is terminal too but
+        // needs the opposite disposition (throw `abortError()` vs. return
+        // the envelope), so the two terminal cases are split here.
+        if (status === "completed" ||
+            status === "failed" ||
+            status === "incomplete") {
+            return env;
+        }
+        if (status === "cancelled") {
+            throw abortError();
+        }
+        await abortableDelay(args.pollIntervalMs, args.signal);
+    }
+}
+export async function callOnce(args) {
+    let response;
+    try {
+        response = await args.fetchImpl(args.url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${args.apiKey}`,
+            },
+            body: JSON.stringify(args.body),
+            signal: args.signal,
+        });
+    }
+    catch (err) {
+        // Aborts come through as a thrown error with `name === "AbortError"`
+        // (DOM spec). Surface as-is so `llmStage`'s mid-flight-abort
+        // detector turns it into `StageAbortedError`. Other low-level
+        // fetch failures are transient.
+        if (isAbortError(err)) {
+            throw err;
+        }
+        throw new TransientLlmError({
+            message: `Network error calling OpenAI: ${err instanceof Error ? err.message : String(err)}`,
+        });
+    }
+    if (response.ok) {
+        return response;
+    }
+    const errorBody = await response.text().catch(() => "");
+    const message = `OpenAI Responses API ${response.status.toString()}: ${errorBody || response.statusText}`;
+    // Best-effort structured extraction of the provider error
+    // code/type so a 429 can be split into persistent quota exhaustion
+    // vs. transient throttling. Never throws on malformed bodies — an
+    // unparseable body leaves `providerErrorCode` undefined, which
+    // `classifyHttpError` treats as the safe transient default.
+    let providerErrorCode;
+    try {
+        const parsed = JSON.parse(errorBody);
+        providerErrorCode = parsed.error?.code ?? parsed.error?.type;
+    }
+    catch {
+        providerErrorCode = undefined;
+    }
+    throw classifyHttpError(response.status, message, providerErrorCode);
+}
+//# sourceMappingURL=openai-http.js.map

package/dist/extensions/openai/openai-http.js.map

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

package/dist/extensions/openai/openai-parsing.d.ts

@@ -0,0 +1,34 @@
+import type { TLlmTokenUsage } from "../../lib/llm/types.js";
+import type { TOpenAiOutputItem, TOpenAiResponsesEnvelope } from "./types.js";
+/**
+ * Read an SSE `text/event-stream` body and return the envelope carried
+ * by the terminal event. A stream that ends with no terminal event
+ * (connection drop) throws `TransientLlmError` so the framework retries.
+ * `AbortError` from the underlying reader propagates verbatim so
+ * `llmStage` marks the stage `skipped`.
+ *
+ * `onResponseId`, when supplied, fires the moment the `response.created`
+ * lifecycle event is parsed — i.e. while the call is still streaming,
+ * before the terminal event arrives. This is the load-bearing seam for
+ * background-stream mode: it lets a caller persist the response id
+ * mid-flight so an in-flight call interrupted before completion can be
+ * recovered from the upstream's stored copy. Invoked at most once.
+ *
+ * Note: the event-separator scan assumes LF (`\n\n`) framing, which the
+ * OpenAI Responses API emits. Reuse against a strict CRLF-only SSE
+ * server would need the separator scan adjusted to `\r\n\r\n`.
+ */
+export declare function readSseEnvelope(response: Response, onResponseId?: (responseId: string) => void): Promise<TOpenAiResponsesEnvelope>;
+type TParsedFunctionCall = {
+    callId: string;
+    name: string;
+    arguments: string;
+};
+export declare function pickFunctionCalls(output: TOpenAiOutputItem[] | undefined): TParsedFunctionCall[];
+export declare function extractAssistantText(output: TOpenAiOutputItem[] | undefined): string | undefined;
+export declare function safeParseJson(raw: string): unknown;
+export declare function extractUsage(envelope: TOpenAiResponsesEnvelope): TLlmTokenUsage;
+export declare function mergeUsage(accumulated: TLlmTokenUsage, next: TLlmTokenUsage): TLlmTokenUsage;
+export declare function isAbortError(err: unknown): boolean;
+export {};
+//# sourceMappingURL=openai-parsing.d.ts.map

package/dist/extensions/openai/openai-parsing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-parsing.d.ts","sourceRoot":"","sources":["../../../src/extensions/openai/openai-parsing.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AAoE7E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,eAAe,CACjC,QAAQ,EAAE,QAAQ,EAClB,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAC5C,OAAO,CAAC,wBAAwB,CAAC,CAkEnC;AAED,KAAK,mBAAmB,GAAG;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,iBAAiB,EAAE,GAAG,SAAS,GACxC,mBAAmB,EAAE,CAoBvB;AAED,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,iBAAiB,EAAE,GAAG,SAAS,GACxC,MAAM,GAAG,SAAS,CAiBpB;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAUlD;AAED,wBAAgB,YAAY,CACxB,QAAQ,EAAE,wBAAwB,GACnC,cAAc,CAYhB;AAED,wBAAgB,UAAU,CACtB,WAAW,EAAE,cAAc,EAC3B,IAAI,EAAE,cAAc,GACrB,cAAc,CAShB;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAMlD"}

package/dist/extensions/openai/openai-parsing.js

@@ -0,0 +1,226 @@
+// SSE stream reading and Responses-API envelope/output parsing for the
+// OpenAI provider. These are pure, transport-agnostic helpers: given an
+// HTTP `Response` (for streaming) or a parsed envelope, they extract the
+// terminal envelope, assistant text, function calls, and token usage.
+//
+// `isAbortError` lives here as the lowest-level shared abort predicate —
+// `readSseEnvelope` needs it, and the HTTP and retrieval layers (which
+// sit above this module) import it down.
+import { SchemaValidationLlmError, TransientLlmError } from "./errors.js";
+const SSE_TERMINAL_EVENTS = new Set([
+    "response.completed",
+    "response.incomplete",
+    "response.failed",
+]);
+// The lifecycle event the Responses API emits first, before any output
+// chunks. It carries the response object — including `.id` — so a
+// streaming consumer learns the id while the call is still in flight.
+const SSE_CREATED_EVENT = "response.created";
+/**
+ * Parse one SSE event block. Returns:
+ *
+ *   * `{ kind: "terminal", envelope }` for a terminal Responses-API
+ *     event (`response.completed` / `.incomplete` / `.failed`),
+ *     carrying the embedded full `response` envelope;
+ *   * `{ kind: "created", responseId }` for the lifecycle
+ *     `response.created` event, surfacing the response id the moment
+ *     it is known (before any output);
+ *   * `undefined` for every intermediate / unrecognized event.
+ *
+ * The events carry a `type` field inside the data JSON, so we key off
+ * that and fall back to the SSE `event:` line.
+ */
+function parseSseEvent(raw) {
+    let eventType;
+    const dataLines = [];
+    for (const line of raw.split("\n")) {
+        if (line.startsWith(":"))
+            continue; // SSE comment line — ignore.
+        if (line.startsWith("event:")) {
+            eventType = line.slice(6).trim();
+        }
+        else if (line.startsWith("data:")) {
+            dataLines.push(line.slice(5).replace(/^ /, ""));
+        }
+    }
+    if (dataLines.length === 0)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(dataLines.join("\n"));
+    }
+    catch {
+        return undefined;
+    }
+    // Prefer the discriminator inside the data JSON (Responses-API
+    // events carry `type` there); fall back to the SSE `event:` line so
+    // the parser is robust if the API ever sends the type only there.
+    // (No `[DONE]` sentinel handling — that is a Chat-Completions frame
+    // the Responses API does not emit.)
+    const type = parsed.type ?? eventType;
+    if (type && SSE_TERMINAL_EVENTS.has(type) && parsed.response) {
+        return { kind: "terminal", envelope: parsed.response };
+    }
+    if (type === SSE_CREATED_EVENT && parsed.response?.id) {
+        return { kind: "created", responseId: parsed.response.id };
+    }
+    return undefined;
+}
+/**
+ * Read an SSE `text/event-stream` body and return the envelope carried
+ * by the terminal event. A stream that ends with no terminal event
+ * (connection drop) throws `TransientLlmError` so the framework retries.
+ * `AbortError` from the underlying reader propagates verbatim so
+ * `llmStage` marks the stage `skipped`.
+ *
+ * `onResponseId`, when supplied, fires the moment the `response.created`
+ * lifecycle event is parsed — i.e. while the call is still streaming,
+ * before the terminal event arrives. This is the load-bearing seam for
+ * background-stream mode: it lets a caller persist the response id
+ * mid-flight so an in-flight call interrupted before completion can be
+ * recovered from the upstream's stored copy. Invoked at most once.
+ *
+ * Note: the event-separator scan assumes LF (`\n\n`) framing, which the
+ * OpenAI Responses API emits. Reuse against a strict CRLF-only SSE
+ * server would need the separator scan adjusted to `\r\n\r\n`.
+ */
+export async function readSseEnvelope(response, onResponseId) {
+    const body = response.body;
+    if (!body) {
+        throw new TransientLlmError({
+            message: "OpenAI streaming response carried no body.",
+        });
+    }
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let terminal;
+    let idSurfaced = false;
+    const handleEvent = (rawEvent) => {
+        const parsedEvent = parseSseEvent(rawEvent);
+        if (!parsedEvent)
+            return;
+        if (parsedEvent.kind === "terminal") {
+            terminal = parsedEvent.envelope;
+            return;
+        }
+        // kind === "created": surface the id once, the moment it's known.
+        if (!idSurfaced) {
+            idSurfaced = true;
+            onResponseId?.(parsedEvent.responseId);
+        }
+    };
+    try {
+        for (;;) {
+            const chunk = await reader.read();
+            if (chunk.done)
+                break;
+            buffer += decoder.decode(chunk.value, { stream: true });
+            let sep = buffer.indexOf("\n\n");
+            while (sep !== -1) {
+                const rawEvent = buffer.slice(0, sep);
+                buffer = buffer.slice(sep + 2);
+                handleEvent(rawEvent);
+                sep = buffer.indexOf("\n\n");
+            }
+        }
+    }
+    catch (err) {
+        if (isAbortError(err)) {
+            throw err;
+        }
+        throw new TransientLlmError({
+            message: `OpenAI streaming read failed: ${err instanceof Error ? err.message : String(err)}`,
+        });
+    }
+    // Flush any bytes the streaming decoder is still holding (an
+    // incomplete multi-byte UTF-8 sequence at the final chunk boundary),
+    // then scan for any remaining terminal frame.
+    buffer += decoder.decode();
+    let tailSep = buffer.indexOf("\n\n");
+    while (tailSep !== -1) {
+        const rawEvent = buffer.slice(0, tailSep);
+        buffer = buffer.slice(tailSep + 2);
+        handleEvent(rawEvent);
+        tailSep = buffer.indexOf("\n\n");
+    }
+    if (!terminal) {
+        throw new TransientLlmError({
+            message: "OpenAI streaming ended without a terminal response event (connection drop?).",
+        });
+    }
+    return terminal;
+}
+export function pickFunctionCalls(output) {
+    if (!output)
+        return [];
+    const calls = [];
+    for (const item of output) {
+        if (item.type === "function_call") {
+            /* eslint-disable @typescript-eslint/naming-convention */
+            const fc = item;
+            /* eslint-enable @typescript-eslint/naming-convention */
+            calls.push({
+                callId: fc.call_id,
+                name: fc.name,
+                arguments: fc.arguments,
+            });
+        }
+    }
+    return calls;
+}
+export function extractAssistantText(output) {
+    if (!output)
+        return undefined;
+    for (const item of output) {
+        if (item.type === "message") {
+            const msg = item;
+            const blocks = msg.content ?? [];
+            const textBlock = blocks.find((b) => b.type === "output_text" || b.type === "text");
+            if (textBlock?.text !== undefined) {
+                return textBlock.text;
+            }
+        }
+    }
+    return undefined;
+}
+export function safeParseJson(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        throw new SchemaValidationLlmError({
+            message: `OpenAI returned malformed JSON in structured-output text: ${err instanceof Error ? err.message : String(err)}`,
+        });
+    }
+}
+export function extractUsage(envelope) {
+    const usage = envelope.usage;
+    if (!usage)
+        return { input: 0, output: 0 };
+    const result = {
+        input: usage.input_tokens ?? 0,
+        output: usage.output_tokens ?? 0,
+    };
+    const reasoning = usage.output_tokens_details?.reasoning_tokens;
+    if (reasoning !== undefined) {
+        result.reasoning = reasoning;
+    }
+    return result;
+}
+export function mergeUsage(accumulated, next) {
+    const merged = {
+        input: accumulated.input + next.input,
+        output: accumulated.output + next.output,
+    };
+    if (accumulated.reasoning !== undefined || next.reasoning !== undefined) {
+        merged.reasoning = (accumulated.reasoning ?? 0) + (next.reasoning ?? 0);
+    }
+    return merged;
+}
+export function isAbortError(err) {
+    return (typeof err === "object" &&
+        err !== null &&
+        err.name === "AbortError");
+}
+//# sourceMappingURL=openai-parsing.js.map

package/dist/extensions/openai/openai-parsing.js.map

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