@proposit/proposit-core 2.1.0 → 2.2.0

package/dist/extensions/chat-completions/errors.d.ts

@@ -0,0 +1,66 @@
+export declare class TransientLlmError extends Error {
+    readonly retryReason: "transient";
+    readonly status?: number;
+    constructor(args: {
+        message: string;
+        status?: number;
+    });
+}
+export declare class RateLimitLlmError extends Error {
+    readonly retryReason: "rate_limit";
+    readonly status?: number;
+    constructor(args: {
+        message: string;
+        status?: number;
+    });
+}
+/**
+ * Persistent provider budget exhaustion — surfaced as a 429 whose body
+ * carries an `insufficient_quota` code/type. Distinct from the transient
+ * {@link RateLimitLlmError} throttle: the framework reads the
+ * `quota_exhausted` tag, which is absent from every default `retryOn`,
+ * so the stage fails fast on attempt 1.
+ */
+export declare class QuotaExhaustedLlmError extends Error {
+    readonly retryReason: "quota_exhausted";
+    readonly status?: number;
+    constructor(args: {
+        message: string;
+        status?: number;
+    });
+}
+/**
+ * Thrown when the endpoint rejects our request because the model's
+ * output failed server-side JSON-Schema enforcement (typical 422).
+ * Tagged `transient` so the framework's default retry policy retries — a
+ * single re-roll often produces conforming output.
+ */
+export declare class SchemaValidationLlmError extends Error {
+    readonly retryReason: "transient";
+    readonly status?: number;
+    constructor(args: {
+        message: string;
+        status?: number;
+    });
+}
+export declare class NonRetryableLlmError extends Error {
+    readonly status?: number;
+    constructor(args: {
+        message: string;
+        status?: number;
+    });
+}
+/**
+ * Route an HTTP status family (plus an optional structured provider
+ * error code) into the framework-recognized error class.
+ */
+export declare function classifyHttpError(status: number, message: string, providerErrorCode?: string): Error;
+/**
+ * Map a low-level `fetch` failure (server unreachable, connection reset,
+ * the request timeout firing as a non-Abort transport error) to a
+ * transient error. Talking to a local OpenAI-compatible server that is
+ * down or mid-generation is retryable — a retry after backoff can
+ * succeed once the server is up / a slow generation completes.
+ */
+export declare function classifyFetchError(err: unknown): Error;
+//# sourceMappingURL=errors.d.ts.map

package/dist/extensions/chat-completions/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/extensions/chat-completions/errors.ts"],"names":[],"mappings":"AAmCA,qBAAa,iBAAkB,SAAQ,KAAK;IACxC,SAAgB,WAAW,EAAG,WAAW,CAAS;IAClD,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAA;gBAEnB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAKzD;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IACxC,SAAgB,WAAW,EAAG,YAAY,CAAS;IACnD,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAA;gBAEnB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAKzD;AAED;;;;;;GAMG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC7C,SAAgB,WAAW,EAAG,iBAAiB,CAAS;IACxD,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAA;gBAEnB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAKzD;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IAC/C,SAAgB,WAAW,EAAG,WAAW,CAAS;IAClD,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAA;gBAEnB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAKzD;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC3C,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAA;gBAEnB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAKzD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,iBAAiB,CAAC,EAAE,MAAM,GAC3B,KAAK,CA6BP;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAKtD"}

package/dist/extensions/chat-completions/errors.js

@@ -0,0 +1,139 @@
+// chat-completions-provider error classes + the `classifyHttpError` /
+// `classifyFetchError` mappings.
+//
+// The framework's `llmStage` retry policy classifies provider errors by
+// inspecting a `retryReason` tag on the thrown object (see
+// `src/lib/pipelines/stage-helpers.ts#classifyError`). To play cleanly
+// with that mechanism, each error class carries the appropriate tag as
+// an own property. The framework derives the `TProcessingFailure.code`
+// from the tag, so these classes need no `code` of their own.
+//
+// The class names intentionally mirror the OpenAI provider's names but
+// are *distinct* classes living in this extension; they are surfaced
+// only from this subpath (NOT the package root) to avoid colliding with
+// the root-exported OpenAI error classes.
+//
+// Mapping for the framework's default retry policy
+// (`retryOn: ["schema_validation", "transient"]`):
+//
+//   * `TransientLlmError` — `retryReason: "transient"`. 5xx responses +
+//     low-level fetch failures (server unreachable, connection reset, a
+//     request timeout). Retried under the default policy.
+//   * `RateLimitLlmError` — `retryReason: "rate_limit"`. A 429 whose body
+//     is NOT `insufficient_quota`. Not retried by default — callers can
+//     opt into `retryOn: ["..., "rate_limit"]`.
+//   * `QuotaExhaustedLlmError` — `retryReason: "quota_exhausted"`.
+//     Persistent budget exhaustion (a 429 whose body code/type is
+//     `insufficient_quota`). Fail-fast: the tag is absent from every
+//     default `retryOn`, so the stage breaks on attempt 1.
+//   * `SchemaValidationLlmError` — `retryReason: "transient"`. The
+//     model's output failed schema enforcement on the server side
+//     (typical 422). A single re-roll often produces conforming output.
+//   * `NonRetryableLlmError` — no tag; the framework classifies it as
+//     `non_retryable` and surfaces it immediately. Used for 400/401/403
+//     and other unrecoverable 4xx.
+export class TransientLlmError extends Error {
+    retryReason = "transient";
+    status;
+    constructor(args) {
+        super(args.message);
+        this.name = "TransientLlmError";
+        this.status = args.status;
+    }
+}
+export class RateLimitLlmError extends Error {
+    retryReason = "rate_limit";
+    status;
+    constructor(args) {
+        super(args.message);
+        this.name = "RateLimitLlmError";
+        this.status = args.status;
+    }
+}
+/**
+ * Persistent provider budget exhaustion — surfaced as a 429 whose body
+ * carries an `insufficient_quota` code/type. Distinct from the transient
+ * {@link RateLimitLlmError} throttle: the framework reads the
+ * `quota_exhausted` tag, which is absent from every default `retryOn`,
+ * so the stage fails fast on attempt 1.
+ */
+export class QuotaExhaustedLlmError extends Error {
+    retryReason = "quota_exhausted";
+    status;
+    constructor(args) {
+        super(args.message);
+        this.name = "QuotaExhaustedLlmError";
+        this.status = args.status;
+    }
+}
+/**
+ * Thrown when the endpoint rejects our request because the model's
+ * output failed server-side JSON-Schema enforcement (typical 422).
+ * Tagged `transient` so the framework's default retry policy retries — a
+ * single re-roll often produces conforming output.
+ */
+export class SchemaValidationLlmError extends Error {
+    retryReason = "transient";
+    status;
+    constructor(args) {
+        super(args.message);
+        this.name = "SchemaValidationLlmError";
+        this.status = args.status;
+    }
+}
+export class NonRetryableLlmError extends Error {
+    status;
+    constructor(args) {
+        super(args.message);
+        this.name = "NonRetryableLlmError";
+        this.status = args.status;
+    }
+}
+/**
+ * Route an HTTP status family (plus an optional structured provider
+ * error code) into the framework-recognized error class.
+ */
+export function classifyHttpError(status, message, providerErrorCode) {
+    if (status >= 500) {
+        return new TransientLlmError({ message, status });
+    }
+    if (status === 429) {
+        // 429 splits on the body's structured error code: persistent
+        // budget exhaustion (`insufficient_quota`) is fail-fast, every
+        // other (and every unparseable) 429 stays the transient throttle.
+        // The safe default is always "transient + retryable" — never a
+        // false quota trip.
+        if (providerErrorCode === "insufficient_quota") {
+            return new QuotaExhaustedLlmError({ message, status });
+        }
+        return new RateLimitLlmError({ message, status });
+    }
+    // 400 is a malformed request — a converter bug, an unsupported
+    // parameter, or a request shape the endpoint doesn't accept;
+    // retrying just burns the second attempt, so classify non-retryable.
+    if (status === 400) {
+        return new NonRetryableLlmError({ message, status });
+    }
+    // 422 signals the model's structured-output reply failed server-side
+    // schema validation; a re-roll can succeed, so route it through the
+    // schema-validation class (tagged transient).
+    if (status === 422) {
+        return new SchemaValidationLlmError({ message, status });
+    }
+    // 401/403 and every other 4xx are unrecoverable.
+    return new NonRetryableLlmError({ message, status });
+}
+/**
+ * Map a low-level `fetch` failure (server unreachable, connection reset,
+ * the request timeout firing as a non-Abort transport error) to a
+ * transient error. Talking to a local OpenAI-compatible server that is
+ * down or mid-generation is retryable — a retry after backoff can
+ * succeed once the server is up / a slow generation completes.
+ */
+export function classifyFetchError(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return new TransientLlmError({
+        message: `Network error calling the chat-completions endpoint: ${message}`,
+    });
+}
+//# sourceMappingURL=errors.js.map

package/dist/extensions/chat-completions/errors.js.map

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

package/dist/extensions/chat-completions/http.d.ts

@@ -0,0 +1,10 @@
+import type { TChatCompletionsFetch, TChatCompletionsResponse } from "./types.js";
+export declare function requestJson(args: {
+    url: string;
+    apiKey: string;
+    body: unknown;
+    fetchImpl: TChatCompletionsFetch;
+    signal?: AbortSignal;
+    timeoutMs: number;
+}): Promise<TChatCompletionsResponse>;
+//# sourceMappingURL=http.d.ts.map

package/dist/extensions/chat-completions/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/extensions/chat-completions/http.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACR,qBAAqB,EACrB,wBAAwB,EAC3B,MAAM,YAAY,CAAA;AA2BnB,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,OAAO,CAAA;IACb,SAAS,EAAE,qBAAqB,CAAA;IAChC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;CACpB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA2DpC"}

package/dist/extensions/chat-completions/http.js

@@ -0,0 +1,80 @@
+// Raw-fetch HTTP transport for an OpenAI-compatible
+// `/v1/chat/completions` endpoint: a single POST of JSON, a per-request
+// timeout enforced via `AbortSignal.timeout` (composed with the caller's
+// abort signal so a mid-flight cancel still propagates), and non-2xx →
+// error-class classification. No SSE, no background poll — this provider
+// is synchronous. The timeout is a standard `AbortSignal.timeout` with
+// no extra HTTP-stack dependency.
+import { classifyFetchError, classifyHttpError, TransientLlmError, } from "./errors.js";
+function isAbortError(err) {
+    return (typeof err === "object" &&
+        err !== null &&
+        err.name === "AbortError");
+}
+// Compose the caller's AbortSignal with a timeout signal so EITHER one
+// aborts the request. `AbortSignal.any` / `AbortSignal.timeout` are
+// available on the supported Node floor (>=22). When no timeout is
+// configured (timeoutMs <= 0) and no caller signal is present, returns
+// undefined (no abort).
+function resolveSignal(callerSignal, timeoutMs) {
+    const timeoutSignal = timeoutMs > 0 ? AbortSignal.timeout(timeoutMs) : undefined;
+    if (callerSignal && timeoutSignal) {
+        return AbortSignal.any([callerSignal, timeoutSignal]);
+    }
+    return callerSignal ?? timeoutSignal;
+}
+export async function requestJson(args) {
+    const signal = resolveSignal(args.signal, args.timeoutMs);
+    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,
+        });
+    }
+    catch (err) {
+        // A caller-initiated abort propagates verbatim so `llmStage`'s
+        // mid-flight-abort detector marks the stage skipped — gated on the
+        // caller's signal actually having fired (a caller abort surfaces as
+        // an `AbortError`). A timeout surfaces as a `TimeoutError` (not an
+        // `AbortError`), and every other transport failure surfaces with
+        // its own name — so both fall through to `classifyFetchError` and
+        // are retried as transient.
+        if (isAbortError(err) && args.signal?.aborted) {
+            throw err;
+        }
+        throw classifyFetchError(err);
+    }
+    if (!response.ok) {
+        const errorBody = await response.text().catch(() => "");
+        const message = `Chat-completions endpoint ${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. 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);
+    }
+    return response
+        .json()
+        .then((j) => j)
+        .catch((err) => {
+        throw new TransientLlmError({
+            message: `Chat-completions response body was not valid JSON: ${err instanceof Error ? err.message : String(err)}`,
+        });
+    });
+}
+//# sourceMappingURL=http.js.map

package/dist/extensions/chat-completions/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/extensions/chat-completions/http.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,wEAAwE;AACxE,yEAAyE;AACzE,uEAAuE;AACvE,yEAAyE;AACzE,uEAAuE;AACvE,kCAAkC;AAElC,OAAO,EACH,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,GACpB,MAAM,aAAa,CAAA;AAMpB,SAAS,YAAY,CAAC,GAAY;IAC9B,OAAO,CACH,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACX,GAA0B,CAAC,IAAI,KAAK,YAAY,CACpD,CAAA;AACL,CAAC;AAED,uEAAuE;AACvE,oEAAoE;AACpE,mEAAmE;AACnE,uEAAuE;AACvE,wBAAwB;AACxB,SAAS,aAAa,CAClB,YAAqC,EACrC,SAAiB;IAEjB,MAAM,aAAa,GACf,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAC9D,IAAI,YAAY,IAAI,aAAa,EAAE,CAAC;QAChC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAA;IACzD,CAAC;IACD,OAAO,YAAY,IAAI,aAAa,CAAA;AACxC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAOjC;IACG,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;IACzD,IAAI,QAAkB,CAAA;IACtB,IAAI,CAAC;QACD,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE;YACtC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACL,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;aACzC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;YAC/B,MAAM;SACT,CAAC,CAAA;IACN,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,+DAA+D;QAC/D,mEAAmE;QACnE,oEAAoE;QACpE,mEAAmE;QACnE,iEAAiE;QACjE,kEAAkE;QAClE,4BAA4B;QAC5B,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YAC5C,MAAM,GAAG,CAAA;QACb,CAAC;QACD,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAA;IACjC,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QACvD,MAAM,OAAO,GAAG,6BAA6B,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,KACnE,SAAS,IAAI,QAAQ,CAAC,UAC1B,EAAE,CAAA;QACF,0DAA0D;QAC1D,wDAAwD;QACxD,kEAAkE;QAClE,kEAAkE;QAClE,iCAAiC;QACjC,IAAI,iBAAqC,CAAA;QACzC,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAElC,CAAA;YACD,iBAAiB,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAA;QAChE,CAAC;QAAC,MAAM,CAAC;YACL,iBAAiB,GAAG,SAAS,CAAA;QACjC,CAAC;QACD,MAAM,iBAAiB,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAA;IACxE,CAAC;IAED,OAAO,QAAQ;SACV,IAAI,EAAE;SACN,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAA6B,CAAC;SAC1C,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACpB,MAAM,IAAI,iBAAiB,CAAC;YACxB,OAAO,EAAE,sDACL,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CACnD,EAAE;SACL,CAAC,CAAA;IACN,CAAC,CAAC,CAAA;AACV,CAAC"}

package/dist/extensions/chat-completions/index.d.ts

@@ -0,0 +1,7 @@
+export { createChatCompletionsProvider } from "./provider.js";
+export type { TCreateChatCompletionsProviderOptions } from "./provider.js";
+export type { TChatCompletionsProviderConfig } from "./types.js";
+export { typeboxToJsonSchema } from "./structured-output.js";
+export type { TChatCompletionsJsonSchema } from "./structured-output.js";
+export { NonRetryableLlmError, QuotaExhaustedLlmError, RateLimitLlmError, SchemaValidationLlmError, TransientLlmError, classifyHttpError, classifyFetchError, } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/chat-completions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/chat-completions/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAA;AAC7D,YAAY,EAAE,qCAAqC,EAAE,MAAM,eAAe,CAAA;AAC1E,YAAY,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAC5D,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AACxE,OAAO,EACH,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACrB,MAAM,aAAa,CAAA"}

package/dist/extensions/chat-completions/index.js

@@ -0,0 +1,18 @@
+// Barrel for the chat-completions provider extension.
+//
+// Public surface consumed via the
+// `@proposit/proposit-core/extensions/chat-completions` subpath: the
+// provider factory + its config type + the lax JSON-schema converter +
+// the error classes (which callers may `instanceof`-match for finer-
+// grained observability) and the status/fetch classifiers.
+//
+// The error class names intentionally mirror the OpenAI provider's names
+// but are *distinct* classes living in this extension; they are surfaced
+// only from this subpath (NOT the package root) to avoid colliding with
+// the root-exported OpenAI error classes. The framework classifies by
+// the `retryReason` tag, not class identity, so the duplication is
+// intentional and harmless.
+export { createChatCompletionsProvider } from "./provider.js";
+export { typeboxToJsonSchema } from "./structured-output.js";
+export { NonRetryableLlmError, QuotaExhaustedLlmError, RateLimitLlmError, SchemaValidationLlmError, TransientLlmError, classifyHttpError, classifyFetchError, } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/extensions/chat-completions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/chat-completions/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,kCAAkC;AAClC,qEAAqE;AACrE,uEAAuE;AACvE,qEAAqE;AACrE,2DAA2D;AAC3D,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AACzE,wEAAwE;AACxE,sEAAsE;AACtE,mEAAmE;AACnE,4BAA4B;AAE5B,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAA;AAG7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAE5D,OAAO,EACH,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACrB,MAAM,aAAa,CAAA"}

package/dist/extensions/chat-completions/provider.d.ts

@@ -0,0 +1,5 @@
+import type { TLlmProvider } from "../../lib/llm/types.js";
+import { type TChatCompletionsProviderConfig } from "./types.js";
+export type TCreateChatCompletionsProviderOptions = TChatCompletionsProviderConfig;
+export declare function createChatCompletionsProvider(options?: TChatCompletionsProviderConfig): TLlmProvider;
+//# sourceMappingURL=provider.d.ts.map

package/dist/extensions/chat-completions/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/extensions/chat-completions/provider.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EACR,YAAY,EAIf,MAAM,wBAAwB,CAAA;AAS/B,OAAO,EAMH,KAAK,8BAA8B,EAEtC,MAAM,YAAY,CAAA;AAInB,MAAM,MAAM,qCAAqC,GAC7C,8BAA8B,CAAA;AAoBlC,wBAAgB,6BAA6B,CACzC,OAAO,CAAC,EAAE,8BAA8B,GACzC,YAAY,CA8Jd"}

package/dist/extensions/chat-completions/provider.js

@@ -0,0 +1,192 @@
+// Concrete `TLlmProvider` backed by an OpenAI-compatible
+// `/v1/chat/completions` endpoint (a local llama-server by default, or
+// any OpenAI-compatible chat backend by swapping baseUrl + token).
+//
+// Synchronous, structured-output-only:
+//   * One POST to `{baseUrl}/chat/completions` via raw `fetch` (the
+//     `./http.ts` `requestJson` helper) — no SSE, no background/poll, no
+//     mid-flight responseId. `TLlmProvider.respond` is the whole surface;
+//     the optional `onResponseCreated` hook is left uncalled (a
+//     synchronous provider never learns an id mid-flight), which is
+//     contract-legal — the same posture the prior local provider took.
+//   * Structured output via the lax `typeboxToJsonSchema` converter under
+//     a `response_format: { type: "json_schema", json_schema: { ... } }`.
+//   * `reasoningEffort` is ignored (no chat-completions analogue);
+//     `maxOutputTokens` maps to `max_tokens` (positive values only).
+//   * Function tools are NOT supported — a request carrying `tools` fails
+//     fast with `NonRetryableLlmError`. This provider serves the
+//     structured-output ingestion path, which uses no tools, so there is
+//     no multi-round tool loop to port.
+//   * `requestTimeoutMs` is enforced via `AbortSignal.timeout` inside
+//     `requestJson` — no extra HTTP-stack dependency.
+//
+// Error classification routes HTTP-status families + fetch failures into
+// the framework-recognized error classes (see `./errors.ts`). The
+// framework's `llmStage` retry policy classifies via the `retryReason`
+// tag on the thrown error.
+import { debugLlmFailure, debugLlmRequest, debugLlmResponse, } from "../../lib/pipelines/debug-log.js";
+import { typeboxToJsonSchema } from "./structured-output.js";
+import { requestJson } from "./http.js";
+import { NonRetryableLlmError, SchemaValidationLlmError } from "./errors.js";
+import { DEFAULT_API_KEY, DEFAULT_BASE_URL, DEFAULT_MODEL, DEFAULT_REQUEST_TIMEOUT_MS, } from "./types.js";
+const STAGE_ID_MARKER = /<!--\s*stage-id:\s*([^\s>]+)\s*-->/;
+function abortError() {
+    const e = new Error("The chat-completions request was aborted.");
+    e.name = "AbortError";
+    return e;
+}
+// Derive the `json_schema.name` from the schema's `$id` (sanitized to the
+// `^[a-zA-Z0-9_-]{1,64}$` shape OpenAI-compatible servers accept), or a
+// stable default when the schema is anonymous.
+function deriveSchemaName(schema) {
+    const id = schema.$id;
+    if (typeof id === "string" && id.length > 0) {
+        const cleaned = id.replace(/[^a-zA-Z0-9_-]/g, "_").slice(0, 64);
+        if (cleaned.length > 0)
+            return cleaned;
+    }
+    return "structured_output";
+}
+export function createChatCompletionsProvider(options) {
+    const config = options ?? {};
+    const baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
+    const url = `${baseUrl}/chat/completions`;
+    const apiKey = config.apiKey ?? DEFAULT_API_KEY;
+    // The provider's configured model is a fallback: a per-request
+    // `req.model` (the framework's normal path) wins; the configured
+    // model (or the `local-coder` default) applies only when a request
+    // carries no model.
+    const configuredModel = config.model ?? DEFAULT_MODEL;
+    const timeoutMs = config.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+    const fetchImpl = config.fetch ?? globalThis.fetch;
+    if (!fetchImpl) {
+        throw new Error("createChatCompletionsProvider: no fetch implementation available. Pass `fetch` explicitly or run in an environment that provides `globalThis.fetch` (Node ≥18, modern browsers, Expo).");
+    }
+    const respond = async (req) => {
+        if (req.signal?.aborted) {
+            throw abortError();
+        }
+        if (req.tools && req.tools.length > 0) {
+            throw new NonRetryableLlmError({
+                message: "The chat-completions provider does not support function tools — it serves structured-output requests only. Remove `tools` from the request or use a tool-capable provider.",
+            });
+        }
+        const stageIdMatch = STAGE_ID_MARKER.exec(req.systemPrompt);
+        const debugStageId = stageIdMatch ? stageIdMatch[1] : null;
+        const convertedSchema = typeboxToJsonSchema(req.outputSchema);
+        // Per-request model wins; the provider's configured model (or the
+        // `local-coder` default) is the fallback when a request carries none.
+        const model = req.model || configuredModel;
+        const body = {
+            model,
+            messages: [
+                { role: "system", content: req.systemPrompt },
+                { role: "user", content: req.userMessage },
+            ],
+            response_format: {
+                type: "json_schema",
+                json_schema: {
+                    name: deriveSchemaName(req.outputSchema),
+                    schema: convertedSchema,
+                },
+            },
+            // Deterministic structured output.
+            temperature: 0,
+        };
+        // `max_tokens`, positive only: 0 means "generate nothing".
+        if (req.maxOutputTokens !== undefined && req.maxOutputTokens > 0) {
+            body.max_tokens = req.maxOutputTokens;
+        }
+        debugLlmRequest({
+            stageId: debugStageId,
+            model,
+            maxOutputTokens: req.maxOutputTokens,
+            reasoningEffort: req.reasoningEffort,
+            systemPromptLen: req.systemPrompt.length,
+            userMessageLen: req.userMessage.length,
+            systemPromptHead: req.systemPrompt,
+            userMessageHead: req.userMessage,
+        });
+        let response;
+        try {
+            response = await requestJson({
+                url,
+                apiKey,
+                body,
+                fetchImpl,
+                signal: req.signal,
+                timeoutMs,
+            });
+        }
+        catch (err) {
+            // Honor a mid-flight abort: surface a clean AbortError so
+            // `llmStage`'s detector marks the stage skipped rather than
+            // failed. Other errors are already framework-classified by
+            // `requestJson`; re-throw them.
+            if (req.signal?.aborted ||
+                (err instanceof Error && err.name === "AbortError")) {
+                throw abortError();
+            }
+            const classified = err instanceof Error ? err : new Error(String(err));
+            debugLlmFailure({
+                stageId: debugStageId,
+                model,
+                errorName: classified.name,
+                errorMessage: classified.message,
+                tokenUsage: { input: 0, output: 0 },
+            });
+            throw classified;
+        }
+        const tokenUsage = {
+            input: response.usage?.prompt_tokens ?? 0,
+            output: response.usage?.completion_tokens ?? 0,
+        };
+        const text = response.choices?.[0]?.message?.content;
+        if (text === undefined || text === "") {
+            // Empty structured output is a schema-shaped failure — a re-roll
+            // can produce conforming output, so classify it (transient-
+            // tagged) `SchemaValidationLlmError`, not a generic transient.
+            debugLlmFailure({
+                stageId: debugStageId,
+                model,
+                errorName: "SchemaValidationLlmError",
+                errorMessage: "no assistant content",
+                tokenUsage,
+            });
+            throw new SchemaValidationLlmError({
+                message: "The chat-completions endpoint returned no assistant content.",
+            });
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch (err) {
+            debugLlmFailure({
+                stageId: debugStageId,
+                model,
+                errorName: "SchemaValidationLlmError",
+                errorMessage: err instanceof Error ? err.message : String(err),
+                rawText: text,
+                tokenUsage,
+            });
+            throw new SchemaValidationLlmError({
+                message: `The chat-completions endpoint returned malformed JSON in structured-output content: ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+        debugLlmResponse({
+            stageId: debugStageId,
+            outputTextLen: text.length,
+            tokenUsage,
+        });
+        return {
+            output: parsed,
+            tokenUsage,
+            // A chat-completions response carries no durable response id we
+            // surface; `rawResponseId` is optional, so leave it undefined.
+            rawResponseId: undefined,
+        };
+    };
+    return { respond };
+}
+//# sourceMappingURL=provider.js.map

package/dist/extensions/chat-completions/provider.js.map

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

package/dist/extensions/chat-completions/structured-output.d.ts

@@ -0,0 +1,18 @@
+import type { TSchema } from "typebox";
+/**
+ * The output shape is intentionally typed as a plain object literal
+ * (not a full JSON-Schema TS type). The endpoint's `json_schema`
+ * `schema` slot accepts this shape and we round-trip it through the
+ * request body. Keeping the return type loose avoids dragging a
+ * JSON-Schema dependency into the converter.
+ */
+export type TChatCompletionsJsonSchema = Record<string, unknown>;
+/**
+ * Convert a TypeBox schema into a standard JSON Schema document
+ * suitable for an OpenAI-compatible `json_schema` response format.
+ *
+ * Throws `UnsupportedSchemaError` when the source schema contains a
+ * TypeBox primitive outside the supported subset.
+ */
+export declare function typeboxToJsonSchema(schema: TSchema): TChatCompletionsJsonSchema;
+//# sourceMappingURL=structured-output.d.ts.map

package/dist/extensions/chat-completions/structured-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output.d.ts","sourceRoot":"","sources":["../../../src/extensions/chat-completions/structured-output.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC;;;;;;GAMG;AACH,MAAM,MAAM,0BAA0B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AA6BhE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,OAAO,GAChB,0BAA0B,CA0B5B"}