@proposit/proposit-core 1.5.1 → 1.6.0

package/dist/extensions/ollama/errors.js

@@ -0,0 +1,210 @@
+// Ollama-provider error classes + the `classifyOllamaError` mapping.
+//
+// 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) — NOT by class
+// identity. The failure *codes* live in the SDK-free
+// `src/lib/pipelines/failure-codes.ts`. So these Ollama classes carry
+// the same `retryReason` tags as the OpenAI provider's classes and set
+// their `code` from the lib constants. They deliberately do NOT import
+// from `extensions/openai/` and do NOT touch `src/lib/`.
+//
+// Mapping for the framework's default retry policy
+// (`retryOn: ["schema_validation", "transient"]`):
+//
+//   * `TransientLlmError` — `retryReason: "transient"`. Genuinely
+//     transient local hiccups: mid-stream `ECONNRESET`/socket drop,
+//     cold-model-load 5xx (model pulled but still loading into VRAM),
+//     generic 5xx. Retried by the default policy.
+//   * `RateLimitLlmError` — `retryReason: "rate_limit"`. A local
+//     daemon rarely rate-limits, but a remote-Ollama / proxy setup can
+//     return 429; mapped for contract parity. Not in the default
+//     `retryOn`, so it fails fast (callers can opt in).
+//   * `SchemaValidationLlmError` — tagged `transient`; the framework's
+//     schema-retry path handles it. Thrown only for genuinely
+//     malformed / non-parseable JSON in the model's reply — NOT for a
+//     context-overflow (which is deterministic; see below).
+//   * `NonRetryableLlmError` — no tag; framework surfaces it
+//     immediately as `LLM_NON_RETRYABLE_ERROR`. Used for: daemon
+//     unreachable (`ECONNREFUSED`), model-not-pulled (404), and
+//     context-length / eval errors (deterministic — a retry re-fails).
+//   * `ToolLoopExhaustedError` — surfaces from the function-tool loop
+//     when the round cap is hit. Non-retryable (no tag).
+import { LLM_NON_RETRYABLE_ERROR, LLM_RATE_LIMITED, LLM_TRANSIENT_ERROR, } from "../../lib/pipelines/failure-codes.js";
+export class TransientLlmError extends Error {
+    retryReason = "transient";
+    code = LLM_TRANSIENT_ERROR;
+    status;
+    constructor(args) {
+        super(args.message);
+        this.name = "TransientLlmError";
+        this.status = args.status;
+    }
+}
+export class RateLimitLlmError extends Error {
+    retryReason = "rate_limit";
+    code = LLM_RATE_LIMITED;
+    status;
+    constructor(args) {
+        super(args.message);
+        this.name = "RateLimitLlmError";
+        this.status = args.status;
+    }
+}
+/**
+ * Thrown when the model's structured-output reply is genuinely
+ * malformed / non-parseable JSON. Tagged `transient` so the framework's
+ * default retry policy retries — a single re-roll often produces
+ * conforming output.
+ *
+ * **Do not** route a context-length overflow here: an overflow is
+ * deterministic and re-fails on the retried (still-oversized) prompt.
+ * `classifyOllamaError` routes overflow to {@link NonRetryableLlmError}.
+ */
+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 {
+    code = LLM_NON_RETRYABLE_ERROR;
+    status;
+    constructor(args) {
+        super(args.message);
+        this.name = "NonRetryableLlmError";
+        this.status = args.status;
+    }
+}
+export class ToolLoopExhaustedError extends Error {
+    rounds;
+    constructor(args) {
+        super(args.message);
+        this.name = "ToolLoopExhaustedError";
+        this.rounds = args.rounds;
+    }
+}
+// -- error-shape probes ---------------------------------------------------
+//
+// The `ollama` SDK throws plain `Error`s (sometimes a `ResponseError`
+// carrying a `status_code`) and lets low-level `fetch` failures bubble
+// up. undici wraps a connection refusal as `TypeError: fetch failed`
+// with a `.cause` carrying the Node `code`. We probe both the error
+// itself and one level of `.cause` for the Node-style `code` and an
+// HTTP-ish `status` / `status_code`.
+function nodeCodeOf(err) {
+    const direct = readCode(err);
+    if (direct !== undefined)
+        return direct;
+    if (typeof err === "object" && err !== null) {
+        return readCode(err.cause);
+    }
+    return undefined;
+}
+function readCode(value) {
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    const code = value.code;
+    return typeof code === "string" ? code : undefined;
+}
+function statusOf(err) {
+    if (typeof err !== "object" || err === null)
+        return undefined;
+    // `status_code` is the `ollama` SDK's ResponseError wire field — an
+    // external snake_case name, exempt from the camelCase rule.
+    /* eslint-disable @typescript-eslint/naming-convention */
+    const e = err;
+    if (typeof e.status === "number")
+        return e.status;
+    if (typeof e.status_code === "number")
+        return e.status_code;
+    /* eslint-enable @typescript-eslint/naming-convention */
+    return undefined;
+}
+function messageOf(err) {
+    if (err instanceof Error)
+        return err.message;
+    if (typeof err === "string")
+        return err;
+    return String(err);
+}
+const CONTEXT_OVERFLOW_PATTERN = /context (?:length|window)|maximum context|exceeds the (?:maximum )?context|too (?:many|long).*token|num_ctx/i;
+const MODEL_NOT_FOUND_PATTERN = /model .* not found|not found, try pulling|no such model|pull(?:ing)? it/i;
+/**
+ * Map an error surfaced by the `ollama` SDK (or an underlying `fetch`
+ * failure) to one of the framework-recognized provider error classes.
+ *
+ * The mapping is deliberately exhaustive on the cases the reviewer
+ * called out so they can't silently regress:
+ *
+ *   - `ECONNREFUSED`            → NonRetryable (daemon down; a retry
+ *                                 won't bring it up within backoff).
+ *   - model-not-pulled (404)    → NonRetryable (`ollama pull` hint).
+ *   - context-overflow/eval err → NonRetryable (deterministic; never
+ *                                 SchemaValidationLlmError).
+ *   - `ECONNRESET` / socket drop→ Transient.
+ *   - cold-load / generic 5xx   → Transient.
+ *   - 429                       → RateLimit (remote/proxy setups).
+ *   - anything else             → NonRetryable (safe fail-fast default).
+ */
+export function classifyOllamaError(err) {
+    const code = nodeCodeOf(err);
+    const status = statusOf(err);
+    const message = messageOf(err);
+    // Daemon unreachable — a connection refusal is the canonical
+    // "`ollama serve` isn't running on :11434" failure. A retry within
+    // the framework's short backoff won't bring it back up.
+    if (code === "ECONNREFUSED") {
+        return new NonRetryableLlmError({
+            message: `Cannot reach the Ollama daemon (${code}). Is \`ollama serve\` running on :11434? Original error: ${message}`,
+        });
+    }
+    // Mid-stream socket drop / transient connection loss — retryable.
+    if (code === "ECONNRESET" || code === "ETIMEDOUT" || code === "EPIPE") {
+        return new TransientLlmError({
+            message: `Transient connection error talking to the Ollama daemon (${code}): ${message}`,
+        });
+    }
+    // Model not pulled — Ollama returns a 404 whose body says the model
+    // was not found. Deterministic until the user pulls it.
+    if (status === 404 || MODEL_NOT_FOUND_PATTERN.test(message)) {
+        return new NonRetryableLlmError({
+            message: `Ollama model not found. Run \`ollama pull <model>\` to download it first. Original error: ${message}`,
+            status,
+        });
+    }
+    // Context-length overflow / model-eval error — DETERMINISTIC. Must
+    // be NonRetryable: routing this to SchemaValidationLlmError (tagged
+    // `transient`) would burn a guaranteed-failing second attempt on
+    // the same oversized prompt.
+    if (CONTEXT_OVERFLOW_PATTERN.test(message)) {
+        return new NonRetryableLlmError({
+            message: `Ollama request exceeded the model's context window (deterministic — retrying the same prompt will re-fail). Shorten the input or raise \`num_ctx\`. Original error: ${message}`,
+            status,
+        });
+    }
+    if (status === 429) {
+        return new RateLimitLlmError({
+            message: `Ollama returned 429 (rate-limited; typical of a remote/proxied daemon): ${message}`,
+            status,
+        });
+    }
+    // Cold-model-load (model pulled but still loading into VRAM) and
+    // any other 5xx are transient — a retry after backoff can succeed
+    // once the model is resident.
+    if (status !== undefined && status >= 500) {
+        return new TransientLlmError({
+            message: `Ollama returned ${status.toString()} (possibly a cold model load into VRAM): ${message}`,
+            status,
+        });
+    }
+    // Safe default: fail fast rather than retry an unrecognized error.
+    return new NonRetryableLlmError({
+        message: `Unclassified Ollama error: ${message}`,
+        status,
+    });
+}
+//# sourceMappingURL=errors.js.map

package/dist/extensions/ollama/errors.js.map

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

package/dist/extensions/ollama/index.d.ts

@@ -0,0 +1,6 @@
+export { OllamaProvider } from "./provider.js";
+export type { TOllamaProviderConfig, TOllamaClient, TOllamaChatRequest, TOllamaChatResponse, } from "./types.js";
+export { typeboxToJsonSchema } from "./structured-output.js";
+export type { TOllamaJsonSchema } from "./structured-output.js";
+export { NonRetryableLlmError, RateLimitLlmError, SchemaValidationLlmError, ToolLoopExhaustedError, TransientLlmError, classifyOllamaError, } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/ollama/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/ollama/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,YAAY,EACR,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GACtB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAC5D,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EACH,oBAAoB,EACpB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,GACtB,MAAM,aAAa,CAAA"}

package/dist/extensions/ollama/index.js

@@ -0,0 +1,17 @@
+// Barrel for the Ollama provider extension.
+//
+// Public surface consumed via the `@proposit/proposit-core/extensions/ollama`
+// subpath export: the provider constructor + its config type + the
+// standard-JSON-schema converter + the error classes (which callers may
+// `instanceof`-match for finer-grained observability).
+//
+// NOTE: the error class names (`NonRetryableLlmError`, …) 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 { OllamaProvider } from "./provider.js";
+export { typeboxToJsonSchema } from "./structured-output.js";
+export { NonRetryableLlmError, RateLimitLlmError, SchemaValidationLlmError, ToolLoopExhaustedError, TransientLlmError, classifyOllamaError, } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/extensions/ollama/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/ollama/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,EAAE;AACF,8EAA8E;AAC9E,mEAAmE;AACnE,wEAAwE;AACxE,uDAAuD;AACvD,EAAE;AACF,wEAAwE;AACxE,uEAAuE;AACvE,uEAAuE;AACvE,uEAAuE;AACvE,wEAAwE;AACxE,4DAA4D;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAO9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAE5D,OAAO,EACH,oBAAoB,EACpB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,GACtB,MAAM,aAAa,CAAA"}

package/dist/extensions/ollama/provider.d.ts

@@ -0,0 +1,19 @@
+import type { TLlmProvider, TLlmRequest, TLlmResponse } from "../../lib/llm/types.js";
+import type { TOllamaProviderConfig } from "./types.js";
+export declare class OllamaProvider implements TLlmProvider {
+    private readonly config;
+    private clientPromise;
+    private readonly maxToolRounds;
+    private readonly numCtx;
+    constructor(config?: TOllamaProviderConfig);
+    respond<T>(req: TLlmRequest<T>): Promise<TLlmResponse<T>>;
+    private runChatLoop;
+    /**
+     * Resolve the SDK client: the injected one, or a freshly imported
+     * `Ollama` instance. Memoized so the dynamic import + construction
+     * runs at most once.
+     */
+    private getClient;
+    private importAndConstructClient;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/extensions/ollama/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/extensions/ollama/provider.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EACR,YAAY,EACZ,WAAW,EACX,YAAY,EAGf,MAAM,wBAAwB,CAAA;AAa/B,OAAO,KAAK,EAKR,qBAAqB,EAExB,MAAM,YAAY,CAAA;AAYnB,qBAAa,cAAe,YAAW,YAAY;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;gBAEnB,MAAM,CAAC,EAAE,qBAAqB;IAOpC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAmCjD,WAAW;IAgJzB;;;;OAIG;IACH,OAAO,CAAC,SAAS;YAQH,wBAAwB;CAiBzC"}

package/dist/extensions/ollama/provider.js

@@ -0,0 +1,285 @@
+// Concrete `TLlmProvider` backed by a local Ollama daemon via the
+// official `ollama` npm SDK.
+//
+// Dev/test only — production stays on OpenAI. The provider exists so a
+// developer can run the entire LLM-backed stack (notably the v2
+// argument-ingestion pipeline) against a self-hosted model
+// (`qwen3.6:latest`) with zero API cost.
+//
+// Deliberate divergences from the in-repo OpenAI provider:
+//   * Uses the official `ollama` SDK (an optional peer) rather than raw
+//     `fetch`. A missing package surfaces as an actionable error at
+//     construction time (dynamic-import-or-throw).
+//   * Structured output goes through the Ollama provider's own
+//     standard-JSON-schema converter (`./structured-output.ts`), not
+//     the OpenAI strict-mode converter.
+//   * `reasoningEffort` is ignored (no Ollama analogue);
+//     `maxOutputTokens` maps to `options.num_predict` (positive values
+//     only — never 0; -1/-2 are Ollama sentinels we never emit).
+//   * Errors are classified by `./errors.ts` #classifyOllamaError, which
+//     carries the same `retryReason` tags + lib failure-codes as the
+//     OpenAI provider. No `ollama → openai` dependency, no lib change.
+//
+// `AbortSignal` is honored by registering an abort listener that calls
+// the SDK client's `abort()`; the SDK then rejects the in-flight
+// `chat()` with an `AbortError`, which the provider re-throws verbatim
+// so `llmStage`'s mid-flight-abort detector marks the stage `skipped`.
+import { debugLlmFailure, debugLlmRequest, debugLlmResponse, } from "../../lib/pipelines/debug-log.js";
+import { typeboxToJsonSchema } from "./structured-output.js";
+import { NonRetryableLlmError, SchemaValidationLlmError, ToolLoopExhaustedError, classifyOllamaError, } from "./errors.js";
+const STAGE_ID_MARKER = /<!--\s*stage-id:\s*([^\s>]+)\s*-->/;
+const DEFAULT_BASE_URL = "http://localhost:11434";
+const DEFAULT_MAX_TOOL_ROUNDS = 6;
+// Generous default context window. Ollama silently truncates prompts
+// longer than `num_ctx` (no error — the model emits schema-valid JSON
+// from a truncated prompt), and its per-model default is often ~4096,
+// well under a real multi-KB ingestion prompt. See `TOllamaProviderConfig.numCtx`.
+const DEFAULT_NUM_CTX = 32768;
+export class OllamaProvider {
+    config;
+    clientPromise = null;
+    maxToolRounds;
+    numCtx;
+    constructor(config) {
+        this.config = config ?? {};
+        this.maxToolRounds =
+            this.config.maxToolCallRounds ?? DEFAULT_MAX_TOOL_ROUNDS;
+        this.numCtx = this.config.numCtx ?? DEFAULT_NUM_CTX;
+    }
+    async respond(req) {
+        // Already-aborted short-circuit — don't even construct the
+        // client or call the daemon.
+        if (req.signal?.aborted) {
+            throw abortError();
+        }
+        const client = await this.getClient();
+        const convertedSchema = typeboxToJsonSchema(req.outputSchema);
+        const tools = req.tools ? translateTools(req.tools) : undefined;
+        const stageIdMatch = STAGE_ID_MARKER.exec(req.systemPrompt);
+        const debugStageId = stageIdMatch ? stageIdMatch[1] : null;
+        // Wire the AbortSignal to the SDK client's abort(). The SDK
+        // rejects the in-flight chat() with an AbortError when this
+        // fires.
+        const onAbort = () => {
+            client.abort();
+        };
+        req.signal?.addEventListener("abort", onAbort, { once: true });
+        try {
+            return await this.runChatLoop({
+                client,
+                req,
+                convertedSchema,
+                tools,
+                debugStageId,
+            });
+        }
+        finally {
+            req.signal?.removeEventListener("abort", onAbort);
+        }
+    }
+    async runChatLoop(args) {
+        const { client, req, convertedSchema, tools, debugStageId } = args;
+        // Running message array. Tool-call rounds append the model's
+        // tool_calls echo + the tool result before re-calling.
+        const messages = [
+            { role: "system", content: req.systemPrompt },
+            { role: "user", content: req.userMessage },
+        ];
+        let lastUsage = { input: 0, output: 0 };
+        for (let round = 0; round < this.maxToolRounds; round += 1) {
+            const chatRequest = {
+                model: req.model,
+                messages,
+                // Build `format` from the single converted object so the
+                // schema can't drift from any prompt-grounding copy.
+                format: convertedSchema,
+                stream: false,
+            };
+            if (tools) {
+                chatRequest.tools = tools;
+            }
+            // `temperature: 0` for deterministic structured output;
+            // `num_ctx` set generously so Ollama doesn't silently
+            // truncate a real multi-KB ingestion prompt (its per-model
+            // default is often ~4096). `maxOutputTokens` → num_predict,
+            // positive only: 0 means "generate nothing"; -1/-2 are Ollama
+            // sentinels we never emit.
+            const options = {
+                temperature: 0,
+                num_ctx: this.numCtx,
+            };
+            if (req.maxOutputTokens !== undefined && req.maxOutputTokens > 0) {
+                options.num_predict = req.maxOutputTokens;
+            }
+            chatRequest.options = options;
+            debugLlmRequest({
+                stageId: debugStageId,
+                model: req.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 client.chat(chatRequest);
+            }
+            catch (err) {
+                // Mid-flight abort: the SDK rejects with an AbortError
+                // when our signal listener called client.abort().
+                // Re-throw verbatim so llmStage marks the stage skipped.
+                if (isAbortError(err) || req.signal?.aborted) {
+                    throw abortError();
+                }
+                const classified = classifyOllamaError(err);
+                debugLlmFailure({
+                    stageId: debugStageId,
+                    model: req.model,
+                    errorName: classified.name,
+                    errorMessage: classified.message,
+                    tokenUsage: lastUsage,
+                });
+                throw classified;
+            }
+            lastUsage = mergeUsage(lastUsage, {
+                input: response.prompt_eval_count ?? 0,
+                output: response.eval_count ?? 0,
+            });
+            const toolCalls = response.message.tool_calls ?? [];
+            if (toolCalls.length > 0) {
+                // Echo the assistant tool-call message, then append one
+                // tool-result message per call before looping.
+                messages.push({
+                    role: "assistant",
+                    content: response.message.content,
+                    tool_calls: toolCalls,
+                });
+                for (const call of toolCalls) {
+                    const handler = findFunctionHandler(req.tools, call.function.name);
+                    if (!handler) {
+                        throw new NonRetryableLlmError({
+                            message: `Ollama requested unknown function tool "${call.function.name}".`,
+                        });
+                    }
+                    const handlerResult = await handler.handler(call.function.arguments);
+                    messages.push({
+                        role: "tool",
+                        content: typeof handlerResult === "string"
+                            ? handlerResult
+                            : JSON.stringify(handlerResult),
+                    });
+                }
+                continue;
+            }
+            const text = response.message.content;
+            if (text === undefined || text === "") {
+                throw new SchemaValidationLlmError({
+                    message: "Ollama chat response carried no assistant text content.",
+                });
+            }
+            const parsed = safeParseJson(text);
+            debugLlmResponse({
+                stageId: debugStageId,
+                outputTextLen: text.length,
+                tokenUsage: lastUsage,
+            });
+            return {
+                output: parsed,
+                tokenUsage: lastUsage,
+                // The Ollama chat response is not request-id-bearing;
+                // `rawResponseId` is optional, so leaving it undefined is
+                // contract-legal. Do not fabricate one.
+                rawResponseId: undefined,
+            };
+        }
+        throw new ToolLoopExhaustedError({
+            message: `Function-tool agent loop exceeded ${this.maxToolRounds.toString()} rounds without a final response.`,
+            rounds: this.maxToolRounds,
+        });
+    }
+    /**
+     * Resolve the SDK client: the injected one, or a freshly imported
+     * `Ollama` instance. Memoized so the dynamic import + construction
+     * runs at most once.
+     */
+    getClient() {
+        if (this.config.client) {
+            return Promise.resolve(this.config.client);
+        }
+        this.clientPromise ??= this.importAndConstructClient();
+        return this.clientPromise;
+    }
+    async importAndConstructClient() {
+        const baseUrl = this.config.baseUrl ?? DEFAULT_BASE_URL;
+        let mod;
+        try {
+            mod = (await import("ollama"));
+        }
+        catch (err) {
+            throw new Error("OllamaProvider: the optional `ollama` package is not installed. " +
+                "Run `pnpm add ollama` (it is declared as an optional peerDependency) " +
+                "or pass a pre-built `client` via the provider config. " +
+                `Original import error: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        return new mod.Ollama({ host: baseUrl });
+    }
+}
+// -- helpers --------------------------------------------------------------
+function abortError() {
+    const e = new Error("The Ollama request was aborted.");
+    e.name = "AbortError";
+    return e;
+}
+function isAbortError(err) {
+    return (typeof err === "object" &&
+        err !== null &&
+        err.name === "AbortError");
+}
+function safeParseJson(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        throw new SchemaValidationLlmError({
+            message: `Ollama returned malformed JSON in structured-output content: ${err instanceof Error ? err.message : String(err)}`,
+        });
+    }
+}
+function mergeUsage(accumulated, next) {
+    return {
+        input: accumulated.input + next.input,
+        output: accumulated.output + next.output,
+    };
+}
+function translateTools(tools) {
+    return tools.map((tool) => {
+        if (tool.kind === "function") {
+            return {
+                type: "function",
+                function: {
+                    name: tool.name,
+                    description: tool.description,
+                    parameters: typeboxToJsonSchema(tool.parameters),
+                },
+            };
+        }
+        // Hosted-tool kinds (web_search / file_search / mcp) have no
+        // local Ollama equivalent. Fail fast and legibly.
+        throw new NonRetryableLlmError({
+            message: `Tool kind "${tool.kind}" is not supported by the Ollama provider. Only kind "function" (local handler) is supported.`,
+        });
+    });
+}
+function findFunctionHandler(tools, name) {
+    if (!tools)
+        return undefined;
+    for (const tool of tools) {
+        if (tool.kind === "function" && tool.name === name) {
+            return tool;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=provider.js.map

package/dist/extensions/ollama/provider.js.map

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

package/dist/extensions/ollama/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). Ollama's `format` accepts this
+ * shape and we round-trip it through the SDK request body. Keeping the
+ * return type loose avoids dragging a JSON-Schema dependency into the
+ * converter.
+ */
+export type TOllamaJsonSchema = Record<string, unknown>;
+/**
+ * Convert a TypeBox schema into a standard JSON Schema document
+ * suitable for Ollama's `format` parameter.
+ *
+ * Throws `UnsupportedSchemaError` when the source schema contains a
+ * TypeBox primitive outside the supported subset.
+ */
+export declare function typeboxToJsonSchema(schema: TSchema): TOllamaJsonSchema;
+//# sourceMappingURL=structured-output.d.ts.map

package/dist/extensions/ollama/structured-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output.d.ts","sourceRoot":"","sources":["../../../src/extensions/ollama/structured-output.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AA6BvD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,iBAAiB,CA0BtE"}