@arden-hq/loop 0.0.0-stage → 0.1.2

package/dist/providers/kit/retry.d.ts

@@ -0,0 +1,43 @@
+/** Total connection attempts per request (the pre-emission 401 auth retry is excluded). */
+export declare const DEFAULT_MAX_ATTEMPTS = 5;
+/**
+ * A classified failure retries by its own `retryable` (408/429/5xx statuses and
+ * transport failures do; semantic rejections and other 4xx do not). An
+ * unclassified Error retries when its message names a transport failure
+ * (connection resets, timeouts, overload-style fetch errors).
+ */
+export declare const isRetryableFailure: (error: unknown) => boolean;
+/**
+ * Delay before retry `attempt` (1-based): response headers win, then the SSE
+ * wire `retry:` hint, then exponential backoff.
+ */
+export declare const retryDelayMs: (attempt: number, error: unknown, wireHintMs?: number, random?: number) => number;
+/** Backoff sleep that the abort signal cancels immediately with the loop's AbortError. */
+export declare const backoffSleep: (delayMs: number, signal?: AbortSignal) => Promise<void>;
+/**
+ * The one retry decision: the delay before attempt `attempt + 1` when the
+ * failure is a transient one and the budget allows another try, else
+ * undefined (the failure stands).
+ */
+export declare const nextRetry: (attempt: number, error: unknown, options?: {
+    readonly maxAttempts?: number;
+    readonly wireHintMs?: number | undefined;
+}) => number | undefined;
+/**
+ * `fetch` with the transport retry, for a model endpoint called with one JSON
+ * request (embeddings, decision models, a local model server). A dropped
+ * connection or a 408/429/5xx answer is tried again under `nextRetry`; the
+ * request's own signal bounds every attempt and every wait, so a caller's
+ * timeout still holds. The last answer is returned as it came, so the caller
+ * reads its status as before. Only a body that can be sent again (none, or a
+ * string) is retried.
+ */
+export declare const retryingFetch: (fetch: typeof globalThis.fetch, maxAttempts?: number) => typeof globalThis.fetch;
+/**
+ * A one-shot model call with the transport retry: `run` again after a
+ * transient failure under `nextRetry`, for a call that is not a plain fetch
+ * (a multipart upload over node:http). The signal bounds every attempt and
+ * wait. A non-OK answer must throw an HttpStatusError for its status to count.
+ */
+export declare const retrying: <T>(run: () => Promise<T>, signal: AbortSignal | undefined, maxAttempts?: number) => Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/providers/kit/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/providers/kit/retry.ts"],"names":[],"mappings":"AAMA,2FAA2F;AAC3F,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAarC;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,UAAW,OAAO,KAAG,OAGnD,CAAA;AAUD;;;GAGG;AACH,eAAO,MAAM,YAAY,YACd,MAAM,SACR,OAAO,eACD,MAAM,sBAElB,MAKF,CAAA;AAED,0FAA0F;AAC1F,eAAO,MAAM,YAAY,YAAa,MAAM,WAAW,WAAW,KAAG,OAAO,CAAC,IAAI,CAG7E,CAAA;AAEJ;;;;GAIG;AACH,eAAO,MAAM,SAAS,YACX,MAAM,SACR,OAAO,YACL;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,KACnF,MAAM,GAAG,SAGG,CAAA;AAEf;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,UAChB,OAAO,UAAU,CAAC,KAAK,2BAAuC,OAAO,UAAU,CAAC,KA2BvF,CAAA;AAEH;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAU,CAAC,OACzB,MAAM,OAAO,CAAC,CAAC,CAAC,UACb,WAAW,GAAG,SAAS,2BAE9B,OAAO,CAAC,CAAC,CAWX,CAAA"}

package/dist/providers/kit/retry.js

@@ -0,0 +1,118 @@
+import { backoffDelayMs, parseRetryAfter, retryAfterHints } from "@arden-hq/std/retry";
+import { sleep } from "@arden-hq/std/sleep";
+import { abortError } from "../../abort.js";
+import { HttpStatusError, ProviderError } from "./errors.js";
+/** Total connection attempts per request (the pre-emission 401 auth retry is excluded). */
+export const DEFAULT_MAX_ATTEMPTS = 5;
+const RETRY_MAX_DELAY_MS = 30_000;
+const BACKOFF = { initialMs: 250, maxMs: RETRY_MAX_DELAY_MS, jitter: 0.25 };
+const RETRYABLE_MESSAGE_PATTERNS = [
+    /overloaded|service unavailable|too many requests|rate limit/i,
+    /terminated|fetch failed|failed to fetch|network[-_\s]error|connection (?:error|refused|reset|lost)|socket connection was closed|socket hang up|reset before headers|getaddrinfo|enotfound|eai_again|econnrefused|econnreset|etimedout/i,
+    /^timeout$|\b(?:request|response|connection|network|stream|read) (?:timeout|timed out|time out)\b/i
+];
+const matchesRetryableMessage = (value) => typeof value === "string" && RETRYABLE_MESSAGE_PATTERNS.some((pattern) => pattern.test(value));
+/**
+ * A classified failure retries by its own `retryable` (408/429/5xx statuses and
+ * transport failures do; semantic rejections and other 4xx do not). An
+ * unclassified Error retries when its message names a transport failure
+ * (connection resets, timeouts, overload-style fetch errors).
+ */
+export const isRetryableFailure = (error) => {
+    if (error instanceof ProviderError)
+        return error.retryable;
+    return error instanceof Error && matchesRetryableMessage(error.message);
+};
+const cap = (ms) => Math.min(RETRY_MAX_DELAY_MS, Math.ceil(ms));
+const retryAfterDelayMs = (error) => {
+    if (!(error instanceof HttpStatusError))
+        return undefined;
+    const asked = parseRetryAfter(error);
+    return asked === undefined ? undefined : cap(asked);
+};
+/**
+ * Delay before retry `attempt` (1-based): response headers win, then the SSE
+ * wire `retry:` hint, then exponential backoff.
+ */
+export const retryDelayMs = (attempt, error, wireHintMs, random = Math.random()) => {
+    const directed = retryAfterDelayMs(error);
+    if (directed !== undefined)
+        return directed;
+    if (wireHintMs !== undefined)
+        return cap(wireHintMs);
+    return backoffDelayMs(BACKOFF, attempt, random);
+};
+/** Backoff sleep that the abort signal cancels immediately with the loop's AbortError. */
+export const backoffSleep = (delayMs, signal) => sleep(delayMs, signal).catch(() => {
+    throw abortError();
+});
+/**
+ * The one retry decision: the delay before attempt `attempt + 1` when the
+ * failure is a transient one and the budget allows another try, else
+ * undefined (the failure stands).
+ */
+export const nextRetry = (attempt, error, options = {}) => attempt < (options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS) && isRetryableFailure(error)
+    ? retryDelayMs(attempt, error, options.wireHintMs)
+    : undefined;
+/**
+ * `fetch` with the transport retry, for a model endpoint called with one JSON
+ * request (embeddings, decision models, a local model server). A dropped
+ * connection or a 408/429/5xx answer is tried again under `nextRetry`; the
+ * request's own signal bounds every attempt and every wait, so a caller's
+ * timeout still holds. The last answer is returned as it came, so the caller
+ * reads its status as before. Only a body that can be sent again (none, or a
+ * string) is retried.
+ */
+export const retryingFetch = (fetch, maxAttempts = DEFAULT_MAX_ATTEMPTS) => async (input, init) => {
+    const replayable = !(input instanceof Request) &&
+        (init?.body === undefined || init.body === null || typeof init.body === "string");
+    for (let attempt = 1;; attempt += 1) {
+        let failure;
+        try {
+            const response = await fetch(input, init);
+            if (response.ok || !replayable)
+                return response;
+            failure = new HttpStatusError(`HTTP ${String(response.status)}`, {
+                status: response.status,
+                ...retryAfterHints(response.headers),
+                code: "provider_unavailable"
+            });
+            const delayMs = nextRetry(attempt, failure, { maxAttempts });
+            if (delayMs === undefined)
+                return response;
+            await response.body?.cancel().catch(() => undefined);
+            await backoffSleep(delayMs, init?.signal ?? undefined);
+            continue;
+        }
+        catch (error) {
+            if (failure !== undefined || init?.signal?.aborted || !replayable)
+                throw error;
+            const delayMs = nextRetry(attempt, error, { maxAttempts });
+            if (delayMs === undefined)
+                throw error;
+            await backoffSleep(delayMs, init?.signal ?? undefined);
+        }
+    }
+};
+/**
+ * A one-shot model call with the transport retry: `run` again after a
+ * transient failure under `nextRetry`, for a call that is not a plain fetch
+ * (a multipart upload over node:http). The signal bounds every attempt and
+ * wait. A non-OK answer must throw an HttpStatusError for its status to count.
+ */
+export const retrying = async (run, signal, maxAttempts = DEFAULT_MAX_ATTEMPTS) => {
+    for (let attempt = 1;; attempt += 1) {
+        try {
+            return await run();
+        }
+        catch (error) {
+            if (signal?.aborted)
+                throw error;
+            const delayMs = nextRetry(attempt, error, { maxAttempts });
+            if (delayMs === undefined)
+                throw error;
+            await backoffSleep(delayMs, signal);
+        }
+    }
+};
+//# sourceMappingURL=retry.js.map

package/dist/providers/kit/retry.js.map

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

package/dist/providers/kit/sse.d.ts

@@ -0,0 +1,22 @@
+export interface SseEvent {
+    readonly event: string;
+    readonly data: string;
+}
+/** Incremental SSE decoder with the same seam the provider consumed before. */
+export declare class SseParser {
+    #private;
+    /** Last `retry:` reconnection hint seen on the wire, in milliseconds. */
+    retryDelayMs: number | undefined;
+    constructor();
+    feed(chunk: string): Array<SseEvent>;
+}
+/**
+ * Reads `body` as SSE events. `streamName` opens the failure messages
+ * ("<streamName> became idle", "<streamName> failed").
+ */
+export declare function readSseEvents(body: ReadableStream<Uint8Array>, parser: SseParser, options: {
+    readonly idleTimeoutMs: number;
+    readonly streamName: string;
+    readonly signal?: AbortSignal;
+}): AsyncGenerator<SseEvent>;
+//# sourceMappingURL=sse.d.ts.map

package/dist/providers/kit/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../src/providers/kit/sse.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,+EAA+E;AAC/E,qBAAa,SAAS;;IAGpB,yEAAyE;IACzE,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;IAEhC,cASC;IAED,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAKnC;CACF;AAyBD;;;GAGG;AACH,wBAAuB,aAAa,CAClC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE;IACP,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B,GACA,cAAc,CAAC,QAAQ,CAAC,CAsB1B"}

package/dist/providers/kit/sse.js

@@ -0,0 +1,70 @@
+/**
+ * Idleness and network failures surface as RetryableProviderError so the
+ * kit's retry policy classifies them; abort errors pass through.
+ */
+import { createParser } from "eventsource-parser";
+import { isAbortError, raceAbort } from "../../abort.js";
+import { RetryableProviderError } from "./errors.js";
+import { errorMessage } from "@arden-hq/std/errors";
+/** Incremental SSE decoder with the same seam the provider consumed before. */
+export class SseParser {
+    #events = [];
+    #parser;
+    /** Last `retry:` reconnection hint seen on the wire, in milliseconds. */
+    retryDelayMs;
+    constructor() {
+        this.#parser = createParser({
+            onEvent: (message) => {
+                this.#events.push({ event: message.event ?? "message", data: message.data });
+            },
+            onRetry: (delayMs) => {
+                this.retryDelayMs = delayMs;
+            }
+        });
+    }
+    feed(chunk) {
+        this.#parser.feed(chunk);
+        const events = this.#events;
+        this.#events = [];
+        return events;
+    }
+}
+const asTransportError = (cause, streamName) => isAbortError(cause) || (cause instanceof DOMException && cause.name === "AbortError")
+    ? cause
+    : new RetryableProviderError(errorMessage(cause, `${streamName} failed`));
+const raceIdle = (promise, idleTimeoutMs, streamName) => new Promise((resolve, reject) => {
+    const timer = setTimeout(() => reject(new RetryableProviderError(`${streamName} became idle`)), idleTimeoutMs);
+    promise.then((value) => {
+        clearTimeout(timer);
+        resolve(value);
+    }, (cause) => {
+        clearTimeout(timer);
+        reject(cause);
+    });
+});
+/**
+ * Reads `body` as SSE events. `streamName` opens the failure messages
+ * ("<streamName> became idle", "<streamName> failed").
+ */
+export async function* readSseEvents(body, parser, options) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    try {
+        while (true) {
+            const read = raceIdle(reader.read().catch((cause) => {
+                throw asTransportError(cause, options.streamName);
+            }), options.idleTimeoutMs, options.streamName);
+            // The abort race can win and abandon the read; observe its late rejection.
+            read.catch(() => { });
+            const next = await raceAbort(read, options.signal);
+            if (next.done)
+                break;
+            yield* parser.feed(decoder.decode(next.value, { stream: true }));
+        }
+        yield* parser.feed(decoder.decode());
+    }
+    finally {
+        void reader.cancel().catch(() => { });
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/providers/kit/sse.js.map

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

package/dist/providers/openai-responses/citations.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Removes OpenAI citation markers from user-visible text.
+ *
+ * The API emits citations as framed private-use text:
+ * `\uE200cite\uE202{source-id}[\uE202{locator}]\uE201`.
+ * Applications must resolve the source ids or remove the markers before
+ * display. Arden currently presents the resolved turn sources separately, so
+ * this filter removes the protocol framing while preserving raw response items
+ * for provider replay.
+ *
+ * @see https://developers.openai.com/api/docs/guides/citation-formatting
+ */
+/** Stateful because a citation marker may span several streamed deltas. */
+export declare class OpenAiCitationFilter {
+    private state;
+    push(chunk: string): string;
+    /** Drops a truncated citation prefix or marker at the end of the response. */
+    finish(): void;
+}
+export declare const stripOpenAiCitations: (text: string) => string;
+//# sourceMappingURL=citations.d.ts.map

package/dist/providers/openai-responses/citations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citations.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-responses/citations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH,2EAA2E;AAC3E,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,KAAK,CAAgC;IAE7C,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAmC1B;IAED,8EAA8E;IAC9E,MAAM,IAAI,IAAI,CAEb;CACF;AAED,eAAO,MAAM,oBAAoB,SAAU,MAAM,KAAG,MAKnD,CAAA"}

package/dist/providers/openai-responses/citations.js

@@ -0,0 +1,65 @@
+/**
+ * Removes OpenAI citation markers from user-visible text.
+ *
+ * The API emits citations as framed private-use text:
+ * `\uE200cite\uE202{source-id}[\uE202{locator}]\uE201`.
+ * Applications must resolve the source ids or remove the markers before
+ * display. Arden currently presents the resolved turn sources separately, so
+ * this filter removes the protocol framing while preserving raw response items
+ * for provider replay.
+ *
+ * @see https://developers.openai.com/api/docs/guides/citation-formatting
+ */
+const CITATION_START = "\uE200";
+const CITATION_DELIMITER = "\uE202";
+const CITATION_STOP = "\uE201";
+const CITATION_PREFIX = `${CITATION_START}cite${CITATION_DELIMITER}`;
+/** Stateful because a citation marker may span several streamed deltas. */
+export class OpenAiCitationFilter {
+    state = { kind: "text" };
+    push(chunk) {
+        let visible = "";
+        for (const character of chunk) {
+            if (this.state.kind === "citation") {
+                if (character === CITATION_STOP)
+                    this.state = { kind: "text" };
+                continue;
+            }
+            if (this.state.kind === "prefix") {
+                const candidate = `${this.state.value}${character}`;
+                if (candidate === CITATION_PREFIX) {
+                    this.state = { kind: "citation" };
+                    continue;
+                }
+                if (CITATION_PREFIX.startsWith(candidate)) {
+                    this.state = { kind: "prefix", value: candidate };
+                    continue;
+                }
+                visible += this.state.value;
+                this.state =
+                    character === CITATION_START ? { kind: "prefix", value: character } : { kind: "text" };
+                if (character !== CITATION_START)
+                    visible += character;
+                continue;
+            }
+            if (character === CITATION_START) {
+                this.state = { kind: "prefix", value: character };
+            }
+            else {
+                visible += character;
+            }
+        }
+        return visible;
+    }
+    /** Drops a truncated citation prefix or marker at the end of the response. */
+    finish() {
+        this.state = { kind: "text" };
+    }
+}
+export const stripOpenAiCitations = (text) => {
+    const filter = new OpenAiCitationFilter();
+    const visible = filter.push(text);
+    filter.finish();
+    return visible;
+};
+//# sourceMappingURL=citations.js.map

package/dist/providers/openai-responses/citations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"citations.js","sourceRoot":"","sources":["../../../src/providers/openai-responses/citations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,cAAc,GAAG,QAAQ,CAAA;AAC/B,MAAM,kBAAkB,GAAG,QAAQ,CAAA;AACnC,MAAM,aAAa,GAAG,QAAQ,CAAA;AAC9B,MAAM,eAAe,GAAG,GAAG,cAAc,OAAO,kBAAkB,EAAE,CAAA;AAOpE,2EAA2E;AAC3E,MAAM,OAAO,oBAAoB;IACvB,KAAK,GAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IAE7C,IAAI,CAAC,KAAa;QAChB,IAAI,OAAO,GAAG,EAAE,CAAA;QAEhB,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBACnC,IAAI,SAAS,KAAK,aAAa;oBAAE,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;gBAC9D,SAAQ;YACV,CAAC;YAED,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACjC,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,EAAE,CAAA;gBACnD,IAAI,SAAS,KAAK,eAAe,EAAE,CAAC;oBAClC,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,CAAA;oBACjC,SAAQ;gBACV,CAAC;gBACD,IAAI,eAAe,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC1C,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA;oBACjD,SAAQ;gBACV,CAAC;gBAED,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAA;gBAC3B,IAAI,CAAC,KAAK;oBACR,SAAS,KAAK,cAAc,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;gBACxF,IAAI,SAAS,KAAK,cAAc;oBAAE,OAAO,IAAI,SAAS,CAAA;gBACtD,SAAQ;YACV,CAAC;YAED,IAAI,SAAS,KAAK,cAAc,EAAE,CAAC;gBACjC,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA;YACnD,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAI,SAAS,CAAA;YACtB,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,8EAA8E;IAC9E,MAAM;QACJ,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IAC/B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAU,EAAE;IAC3D,MAAM,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAA;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACjC,MAAM,CAAC,MAAM,EAAE,CAAA;IACf,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}

package/dist/providers/openai-responses/continuation.d.ts

@@ -0,0 +1,19 @@
+import type { ProviderMessage } from "../../contracts/provider.js";
+import type { InputItem } from "./items.js";
+import type { ResponsesPayload } from "./request.js";
+export interface ResponseContinuation {
+    readonly responseId: string;
+    readonly properties: string;
+    readonly input: ReadonlyArray<string>;
+    readonly pendingInput: ReadonlyArray<InputItem>;
+}
+/** Canonical replay prefix, with locally answered searches still awaiting submission. */
+export declare const responseContinuation: ({ payload, message, responseId, asyncTools }: {
+    readonly payload: ResponsesPayload;
+    readonly message: ProviderMessage;
+    readonly responseId: string;
+    readonly asyncTools: ReadonlySet<string>;
+}) => ResponseContinuation | undefined;
+/** Compaction, edits, or changed request settings start a new full-input chain. */
+export declare const incrementalInput: (payload: ResponsesPayload, previous: ResponseContinuation) => ReadonlyArray<InputItem> | undefined;
+//# sourceMappingURL=continuation.d.ts.map

package/dist/providers/openai-responses/continuation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-responses/continuation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAGpD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACrC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,SAAS,CAAC,CAAA;CAChD;AAED,yFAAyF;AACzF,eAAO,MAAM,oBAAoB,iDAK9B;IACD,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CACzC,KAAG,oBAAoB,GAAG,SAmB1B,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,YAClB,gBAAgB,YACf,oBAAoB,KAC7B,aAAa,CAAC,SAAS,CAAC,GAAG,SAS7B,CAAA"}

package/dist/providers/openai-responses/continuation.js

@@ -0,0 +1,28 @@
+import { responseItems } from "./stored-items.js";
+/** Canonical replay prefix, with locally answered searches still awaiting submission. */
+export const responseContinuation = ({ payload, message, responseId, asyncTools }) => {
+    const output = responseItems({
+        role: "assistant",
+        tool_calls: message.tool_calls ?? [],
+        ...(message.provider_state === undefined ? {} : { provider_state: message.provider_state })
+    }, asyncTools);
+    if (output === undefined)
+        return undefined;
+    const { input: _, stream: __, ...properties } = payload;
+    return {
+        responseId,
+        properties: JSON.stringify(properties),
+        input: [...payload.input, ...output].map((item) => JSON.stringify(item)),
+        pendingInput: output.filter((item) => item.type === "tool_search_output" && item.execution === "client")
+    };
+};
+/** Compaction, edits, or changed request settings start a new full-input chain. */
+export const incrementalInput = (payload, previous) => {
+    const { input, stream: _, ...properties } = payload;
+    if (JSON.stringify(properties) !== previous.properties ||
+        input.length < previous.input.length ||
+        previous.input.some((item, index) => item !== JSON.stringify(input[index])))
+        return undefined;
+    return [...previous.pendingInput, ...input.slice(previous.input.length)];
+};
+//# sourceMappingURL=continuation.js.map

package/dist/providers/openai-responses/continuation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation.js","sourceRoot":"","sources":["../../../src/providers/openai-responses/continuation.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AASjD,yFAAyF;AACzF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,EACnC,OAAO,EACP,OAAO,EACP,UAAU,EACV,UAAU,EAMX,EAAoC,EAAE;IACrC,MAAM,MAAM,GAAG,aAAa,CAC1B;QACE,IAAI,EAAE,WAAW;QACjB,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;QACpC,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;KAC5F,EACD,UAAU,CACX,CAAA;IACD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC1C,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAA;IACvD,OAAO;QACL,UAAU;QACV,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;QACtC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACxE,YAAY,EAAE,MAAM,CAAC,MAAM,CACzB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,oBAAoB,IAAI,IAAI,CAAC,SAAS,KAAK,QAAQ,CAC5E;KACF,CAAA;AACH,CAAC,CAAA;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,OAAyB,EACzB,QAA8B,EACQ,EAAE;IACxC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAA;IACnD,IACE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,UAAU;QAClD,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM;QACpC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAE3E,OAAO,SAAS,CAAA;IAClB,OAAO,CAAC,GAAG,QAAQ,CAAC,YAAY,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;AAC1E,CAAC,CAAA"}

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

@@ -0,0 +1,28 @@
+import type { ProviderErrorCode } from "../../errors.js";
+import { HttpStatusError, ProviderError } from "../kit/index.js";
+/** The public failure type of this provider. Deliberately NOT a LoopError. */
+export declare class OpenAiResponsesProviderError extends ProviderError {
+    readonly name = "OpenAiResponsesProviderError";
+    constructor(message: string, code?: ProviderErrorCode);
+}
+/** How much of a rejection body is worth carrying into the error message. */
+export declare const MAX_STATUS_DETAIL_CHARS = 600;
+/**
+ * The response failures OpenAI names itself, mapped onto the host taxonomy.
+ * Membership is also what makes a `response.failed` terminal: anything not
+ * listed here is a missing, new, overloaded, or server-side code that spends
+ * the retry budget instead.
+ */
+export declare const TERMINAL_RESPONSE_CODES: Readonly<Record<string, ProviderErrorCode>>;
+/** The failure code of a non-OK HTTP status, from the body when one was read. */
+export declare const statusFailureCode: (status: number, detail: string | null) => ProviderErrorCode;
+/**
+ * A non-OK HTTP status, carrying the retry-after headers and — when the caller
+ * could read one — what the provider actually said. A bare status is nearly
+ * useless for a 400: the reason a request was rejected lives only in its body.
+ */
+export declare class StatusError extends HttpStatusError {
+    readonly detail: string | null;
+    constructor(status: number, retryAfter: string | null, retryAfterMs?: string | null, detail?: string | null);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-responses/errors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAGhE,8EAA8E;AAC9E,qBAAa,4BAA6B,SAAQ,aAAa;IAC7D,SAAkB,IAAI,kCAAiC;IAEvD,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,iBAAoC,EAEtE;CACF;AAED,6EAA6E;AAC7E,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAW/E,CAAA;AA4CD,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,WAAY,MAAM,UAAU,MAAM,GAAG,IAAI,KAAG,iBAgBzE,CAAA;AAED;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,eAAe;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAE9B,YACE,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,YAAY,GAAE,MAAM,GAAG,IAAW,EAClC,MAAM,GAAE,MAAM,GAAG,IAAW,EAU7B;CACF"}

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

@@ -0,0 +1,103 @@
+import { retryableStatus } from "@arden-hq/std/retry";
+import { clipLine } from "@arden-hq/std/text";
+import { HttpStatusError, ProviderError } from "../kit/index.js";
+import { asRecord, stringValue } from "./items.js";
+/** The public failure type of this provider. Deliberately NOT a LoopError. */
+export class OpenAiResponsesProviderError extends ProviderError {
+    name = "OpenAiResponsesProviderError";
+    constructor(message, code = "provider_error") {
+        super(message, { code, retryable: false });
+    }
+}
+/** How much of a rejection body is worth carrying into the error message. */
+export const MAX_STATUS_DETAIL_CHARS = 600;
+/**
+ * The response failures OpenAI names itself, mapped onto the host taxonomy.
+ * Membership is also what makes a `response.failed` terminal: anything not
+ * listed here is a missing, new, overloaded, or server-side code that spends
+ * the retry budget instead.
+ */
+export const TERMINAL_RESPONSE_CODES = {
+    bio_policy: "provider_error",
+    content_filter: "provider_error",
+    context_length_exceeded: "context_length_exceeded",
+    cyber_policy: "provider_error",
+    insufficient_quota: "rate_limited",
+    invalid_prompt: "provider_error",
+    invalid_request_error: "request_invalid",
+    misalignment_policy_violation: "provider_error",
+    model_not_found: "model_unavailable",
+    usage_not_included: "provider_error"
+};
+/**
+ * A context overflow that a rejection reports only in prose. OpenAI omits the
+ * `context_length_exceeded` code on some rejections and says it in the message
+ * instead; the host taxonomy still has to see one class, not two.
+ */
+const CONTEXT_OVERFLOW_PROSE = /context (?:length|window)/i;
+/**
+ * A refusal of the model itself, in prose. The Codex backend answers a model
+ * the ChatGPT sign-in may not use with a bare `{"detail": "The '<model>'
+ * model is not supported when using Codex with a ChatGPT account."}`, and the
+ * Platform API says "The model `<model>` does not exist or you do not have
+ * access to it." Only the provider's own sentence is read, never the request
+ * echo around it.
+ */
+const MODEL_UNAVAILABLE_PROSE = /\bmodel\b.{0,80}?\b(?:is not supported|does not exist|is not available|not found)\b/i;
+const rejection = (detail) => {
+    const none = { code: undefined, type: undefined, message: undefined };
+    if (detail === null)
+        return none;
+    let decoded;
+    try {
+        decoded = JSON.parse(detail);
+    }
+    catch {
+        return none;
+    }
+    const body = asRecord(decoded);
+    const error = asRecord(body?.error);
+    return {
+        code: stringValue(error?.code) ?? undefined,
+        type: stringValue(error?.type) ?? undefined,
+        message: stringValue(error?.message) ?? stringValue(body?.detail) ?? undefined
+    };
+};
+/** The failure code of a non-OK HTTP status, from the body when one was read. */
+export const statusFailureCode = (status, detail) => {
+    const refused = rejection(detail);
+    const declared = TERMINAL_RESPONSE_CODES[refused.code ?? ""];
+    if (declared !== undefined)
+        return declared;
+    if (detail !== null && CONTEXT_OVERFLOW_PROSE.test(detail))
+        return "context_length_exceeded";
+    if ((status === 400 || status === 403 || status === 404) &&
+        refused.message !== undefined &&
+        MODEL_UNAVAILABLE_PROSE.test(refused.message))
+        return "model_unavailable";
+    if (status === 400 && refused.type === "invalid_request_error")
+        return "request_invalid";
+    if (status === 401 || status === 403)
+        return "provider_auth";
+    if (status === 429)
+        return "rate_limited";
+    if (retryableStatus(status))
+        return "provider_unavailable";
+    return "provider_error";
+};
+/**
+ * A non-OK HTTP status, carrying the retry-after headers and — when the caller
+ * could read one — what the provider actually said. A bare status is nearly
+ * useless for a 400: the reason a request was rejected lives only in its body.
+ */
+export class StatusError extends HttpStatusError {
+    detail;
+    constructor(status, retryAfter, retryAfterMs = null, detail = null) {
+        const trimmed = detail === null ? null : clipLine(detail, MAX_STATUS_DETAIL_CHARS) || null;
+        super(trimmed === null
+            ? `OpenAI request failed with status ${status}`
+            : `OpenAI request failed with status ${status}: ${trimmed}`, { status, retryAfter, retryAfterMs, code: statusFailureCode(status, trimmed) });
+        this.detail = trimmed;
+    }
+}
+//# sourceMappingURL=errors.js.map

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

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

package/dist/providers/openai-responses/history.d.ts

@@ -0,0 +1,8 @@
+import type { InputItem } from "./items.js";
+export interface InputBatch {
+    readonly items: ReadonlyArray<InputItem>;
+    readonly deferWhileCallsPending: boolean;
+}
+/** Reject malformed durable runtime-tool history before it reaches OpenAI. */
+export declare function validateFunctionCallHistory(batches: ReadonlyArray<InputBatch>): ReadonlyArray<InputItem>;
+//# sourceMappingURL=history.d.ts.map

package/dist/providers/openai-responses/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-responses/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAG3C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,CAAA;IACxC,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAA;CACzC;AAED,8EAA8E;AAC9E,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,GACjC,aAAa,CAAC,SAAS,CAAC,CA2F1B"}