@proposit/proposit-core 2.0.0 → 2.2.0

package/dist/cli/commands/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAmDxC,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAuNxD"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAmDxC,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAwNxD"}

package/dist/cli/commands/parse.js

@@ -6,8 +6,9 @@ import { ClaimCitationLibrary } from "../../lib/core/claim-citation-library.js";
 import { cliLog } from "../logging.js";
 import { errorExit, printJson, printLine, printWarning } from "../output.js";
 import { resolveApiKey, createLlmProvider } from "../llm/index.js";
-import { basicsExtension, createIngestionV1Pipeline, executePipeline, } from "../../lib/index.js";
-const DEFAULT_PARSE_MODEL = "gpt-5.4";
+import { executePipeline } from "../../lib/index.js";
+import { createScholarPipeline, createScribePipeline, } from "../../extensions/pipelines/ingestion/index.js";
+import { basicsExtension } from "../../extensions/pipelines/base/index.js";
 class CliArgumentParser extends BasicsArgumentParser {
     cliTitle;
     cliDescription;
@@ -40,20 +41,17 @@ export function registerParseCommand(args) {
         .option("--llm <provider>", "LLM provider name", "openai")
         .option("--api-key <key>", "API key (overrides env var)")
         .option("--model <model>", "Model override")
-        .option("--pipeline <version>", "Ingestion pipeline version (v1 or v2)", "v1")
+        .option("--pipeline <name>", "Ingestion pipeline (scholar = thorough, scribe = fast)", "scholar")
         .option("--title <title>", "Argument title (overrides LLM-generated title)")
         .option("--description <desc>", "Argument description", "")
         .option("--dry-run", "Print raw LLM JSON without persisting")
         .action(async (text, opts) => {
-        // 1. Resolve pipeline version. v1 is the only
-        //    supported value today; the v2 flag value is wired
-        //    as a clean rejection so users discover the flag
-        //    exists without silent fallbacks.
-        if (opts.pipeline !== "v1") {
-            if (opts.pipeline === "v2") {
-                errorExit("v2 pipeline not yet shipped.");
-            }
-            errorExit(`Unknown pipeline version "${opts.pipeline}". Supported: v1.`);
+        // 1. Resolve the ingestion pipeline. `scholar` (thorough,
+        //    multi-stage) is the default; `scribe` (fast, two
+        //    cheap LLM calls) is opt-in. Both emit the same
+        //    parsed-argument response shape.
+        if (opts.pipeline !== "scholar" && opts.pipeline !== "scribe") {
+            errorExit(`Unknown pipeline "${opts.pipeline}". Supported: scholar, scribe.`);
         }
         // 2. Resolve API key
         let apiKey;
@@ -77,14 +75,19 @@ export function registerParseCommand(args) {
         if (!inputText.trim()) {
             errorExit("Input text is empty.");
         }
-        // 4. Build the v1 ingestion pipeline and execute.
-        //    The pipeline owns the LLM call + structured-
+        // 4. Build the selected ingestion pipeline and execute.
+        //    The pipeline owns the LLM calls + structured-
         //    output validation; the CLI is left with engine
-        //    construction + persistence.
+        //    construction + persistence. `--model`, when given,
+        //    overrides every stage's model via the pipeline-level
+        //    `llm.defaults`.
         const provider = createLlmProvider(opts.llm, { apiKey });
-        const pipeline = createIngestionV1Pipeline(basicsExtension, {
-            model: opts.model ?? DEFAULT_PARSE_MODEL,
-        });
+        const buildPipeline = opts.pipeline === "scribe"
+            ? createScribePipeline
+            : createScholarPipeline;
+        const pipeline = buildPipeline(basicsExtension, opts.model
+            ? { llm: { defaults: { model: opts.model } } }
+            : undefined);
         let pipelineResult;
         try {
             pipelineResult = await executePipeline(pipeline, { text: inputText }, { llm: provider });
@@ -94,17 +97,12 @@ export function registerParseCommand(args) {
             await cliLog("parse:pipeline-error", { error: msg });
             errorExit(msg);
         }
-        // Forward-compatibility branch — `output === null` is
-        // not reachable under the v1 single-shot pipeline
-        // (the `parse-argument` stage either completes or
-        // throws via `LlmStageRetryExhaustedError`, both of
-        // which surface here as a failures-non-empty + null
-        // output OR an outer `executePipeline` throw caught
-        // above). A v2 multi-stage pipeline would reach this
-        // branch when its finalize returns null on
-        // irresolvable-conclusion / empty-canonicalization
-        // outcomes. Leave the branch wired so a v2 cutover
-        // doesn't need to revisit the CLI.
+        // A degraded import: the pipeline's finalize returned no
+        // argument. Both scholar and scribe reach this when
+        // finalize returns null — empty canonicalization (no
+        // claims extracted) or an irresolvable conclusion — with
+        // the reason carried on `failures`. Surface those and
+        // exit non-zero rather than printing a null argument.
         if (pipelineResult.output === null) {
             const failureSummary = pipelineResult.failures
                 .map((f) => `[${f.code}] ${f.message}`)

package/dist/cli/commands/parse.js.map

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

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":"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"}

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"}