@proposit/proposit-core 2.1.0 → 2.2.0

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

@@ -1,219 +0,0 @@
-import type { TOllamaJsonSchema } from "./structured-output.js";
-/**
- * The minimal subset of the `ollama` SDK's `chat()` response we read.
- * We model only the fields the provider touches so a mock client (and
- * a real `ChatResponse`) both satisfy it without importing the SDK type
- * (which would force the optional peer into the type graph).
- */
-export type TOllamaChatToolCall = {
-    function: {
-        name: string;
-        arguments: Record<string, unknown>;
-    };
-};
-export type TOllamaChatMessage = {
-    role: string;
-    content: string;
-    /**
-     * Thinking-model reasoning trace, present when `think` is enabled.
-     * A wire field on the Ollama chat message; read so an empty
-     * `content` accompanied by a thinking trace can be surfaced as a
-     * deterministic, actionable failure instead of a silently-discarded
-     * answer. See `OllamaProvider`'s empty-content handling.
-     */
-    thinking?: string;
-    tool_calls?: TOllamaChatToolCall[];
-};
-export type TOllamaChatResponse = {
-    message: TOllamaChatMessage;
-    done?: boolean;
-    prompt_eval_count?: number;
-    eval_count?: number;
-};
-/** Tool spec in the `ollama` SDK's `chat({ tools })` wire shape. */
-export type TOllamaToolWire = {
-    type: "function";
-    function: {
-        name: string;
-        description: string;
-        parameters: TOllamaJsonSchema;
-    };
-};
-/** The `chat()` request body subset the provider builds. */
-export type TOllamaChatRequest = {
-    model: string;
-    messages: TOllamaChatMessage[];
-    format?: string | object;
-    /**
-     * Toggle the model's thinking trace. Omitted → model default (ON for
-     * reasoning models like qwen3). The provider sends this only when the
-     * consumer configures `TOllamaProviderConfig.think`.
-     */
-    think?: boolean;
-    tools?: TOllamaToolWire[];
-    stream?: boolean;
-    options?: {
-        temperature?: number;
-        num_predict?: number;
-        num_ctx?: number;
-    };
-};
-/**
- * The slice of the `ollama` SDK client surface the provider depends on:
- * a single `chat()` method and an `abort()` to honor `AbortSignal`.
- * Modeling it as a structural type (rather than importing `Ollama`)
- * keeps the optional peer out of the type graph and gives tests a clean
- * injection seam.
- */
-export type TOllamaClient = {
-    chat(request: TOllamaChatRequest): Promise<TOllamaChatResponse | AsyncIterable<TOllamaChatResponse>>;
-    abort(): void;
-};
-/**
- * The shape of the dynamically-imported `ollama` module. `Ollama` is
- * the SDK's exported class-constructor name (an external symbol), so it
- * is exempt from the in-repo camelCase property-naming rule. The SDK's
- * `Config` accepts an optional `fetch` override (used by the
- * per-provider raised-timeout dispatcher — see `./timeout-fetch.ts`).
- */
-export type TOllamaModule = {
-    Ollama: new (config: {
-        host: string;
-        fetch?: typeof fetch;
-    }) => TOllamaClient;
-};
-/**
- * Structural slice of the `undici` module the timeout-fetch helper uses.
- * Modeled (not imported) so the optional `undici` peer stays out of the
- * type graph — same pattern as {@link TOllamaModule} for the `ollama`
- * peer. The undici `Agent` constructor accepts millisecond timeout
- * options; we raise `headersTimeout` + `bodyTimeout` (and `connectTimeout`)
- * so a long local thinking-model generation isn't aborted at undici's
- * 300s default. `Agent` is undici's exported class-constructor name (an
- * external symbol), exempt from the camelCase rule.
- */
-export type TUndiciAgentOptions = {
-    headersTimeout?: number;
-    bodyTimeout?: number;
-    connectTimeout?: number;
-};
-export type TUndiciDispatcher = object;
-export type TUndiciModule = {
-    Agent: new (options: TUndiciAgentOptions) => TUndiciDispatcher;
-    /**
-     * undici's own `fetch`. The raised-timeout `Agent` MUST be passed as
-     * a `dispatcher` to *this* fetch — the one from the same undici
-     * module the `Agent` was constructed from. Node's bundled-undici
-     * global `fetch` rejects a foreign-undici `Agent` dispatcher with
-     * `UND_ERR_INVALID_ARG`, so the base fetch and the dispatcher must
-     * come from the same undici instance. See `./timeout-fetch.ts`.
-     */
-    fetch: typeof fetch;
-};
-export type TOllamaProviderConfig = {
-    /** Daemon base URL. Defaults to `http://localhost:11434`. */
-    baseUrl?: string;
-    /**
-     * Pre-built SDK client. Primarily a test seam (inject a mock). When
-     * omitted, the provider dynamically imports the `ollama` package and
-     * constructs an `Ollama({ host: baseUrl })`; a missing package
-     * surfaces as an actionable error at construction time.
-     */
-    client?: TOllamaClient;
-    /**
-     * Injectable `ollama`-module importer. Test seam — defaults to
-     * `import("ollama")`. Lets tests assert the SDK client is constructed
-     * with the per-provider timeout-fetch without touching the real
-     * package. Ignored when `client` is provided.
-     *
-     * @internal
-     */
-    importOllama?: () => Promise<TOllamaModule>;
-    /**
-     * Injectable `undici`-module importer. Test seam — defaults to
-     * `import("undici")`. See {@link requestTimeoutMs}.
-     *
-     * @internal
-     */
-    importUndici?: () => Promise<TUndiciModule>;
-    /**
-     * Per-request HTTP timeout in milliseconds, applied via a
-     * **per-provider** undici `Agent` (raised `headersTimeout` +
-     * `bodyTimeout`) passed as the `ollama` SDK client's `fetch`
-     * dispatcher. Defaults to **1_200_000 (20 min)** — local thinking
-     * models legitimately take many minutes per structured-extraction
-     * stage, and undici's 300s default aborts them mid-generation with a
-     * `UND_ERR_HEADERS_TIMEOUT` `fetch failed`.
-     *
-     * **No global state is mutated** — the raised timeout is scoped to
-     * this provider's client only (never `setGlobalDispatcher`). Requires
-     * the optional `undici` peer; if it is not installed the provider
-     * falls back to the SDK's default fetch (300s) and relies on
-     * `classifyOllamaError` retrying the resulting timeout as transient.
-     *
-     * Set `0` to disable the custom dispatcher entirely (use the SDK
-     * default). A finite positive value is recommended.
-     */
-    requestTimeoutMs?: number;
-    /**
-     * Context-window size sent as Ollama's `options.num_ctx`. Defaults
-     * to a generous **32768**.
-     *
-     * **Why this is set, and set generously.** Ollama's per-model
-     * default `num_ctx` is small (often ~4096) and Ollama **silently
-     * truncates** any prompt longer than `num_ctx` — no error is raised;
-     * the model dutifully emits schema-valid JSON from a truncated
-     * prompt, which then passes the framework's `Value.Check` and yields
-     * a quietly-wrong parse. A real v2 ingestion prompt (segmenting a
-     * multi-KB argument) easily exceeds 4096 tokens, so without a
-     * generous default the stated goal — running the *whole* pipeline
-     * locally on real text — would silently misbehave. Raise this
-     * further for very large inputs; lower it only if VRAM-constrained
-     * and inputs are known to be small.
-     */
-    numCtx?: number;
-    /**
-     * Stream the `chat()` generation and accumulate the chunks inside
-     * the provider, returning a single synthesized response. Defaults
-     * to **`true`** — streaming is the primary fix for the hardcoded
-     * ~300s non-streaming Ollama timeout (ollama/ollama#5081): headers
-     * and the first chunk arrive immediately and undici's `bodyTimeout`
-     * resets per chunk, so a long local thinking-model generation is no
-     * longer aborted mid-flight. Set `false` to restore the legacy
-     * single one-shot (`stream: false`) request.
-     */
-    stream?: boolean;
-    /**
-     * Toggle Ollama's thinking trace (`think` on the chat request).
-     *
-     * **Opt-in.** When unset (the default) the provider sends no `think`
-     * field and the model's own default applies (ON for reasoning models
-     * like `qwen3.6:latest`, off for non-thinking models like `gemma2`).
-     *
-     * **There is no safe global default**, because on `qwen3.6:latest`
-     * the thinking toggle's effect on structured-output fidelity is
-     * stage-dependent and cuts both ways (verified empirically):
-     *
-     * - With `think: true`, some stages (e.g. claim-mention-extraction)
-     *   emit their entire answer in the thinking channel and return an
-     *   **empty `content`** — which the provider surfaces as a
-     *   deterministic {@link NonRetryableLlmError} (not a retry-burning
-     *   transient error) advising `think: false`.
-     * - With `think: false`, other stages (e.g. segmentation) drop the
-     *   required object wrapper and return a **bare array**, failing the
-     *   downstream schema check. Ollama's `format` does NOT hard-enforce
-     *   the object envelope on this model.
-     *
-     * So set `think` per the stages a given provider instance serves, or
-     * — simplest — run a non-thinking model (e.g. `gemma2:9b`) for the
-     * whole ingestion pipeline, which sidesteps the toggle entirely.
-     */
-    think?: boolean;
-    /**
-     * Cap on function-tool agent-loop round-trips before throwing
-     * `ToolLoopExhaustedError`. Defaults to 6, mirroring the OpenAI
-     * provider. No ingestion stage uses tools, so this is secondary.
-     */
-    maxToolCallRounds?: number;
-};
-//# sourceMappingURL=types.d.ts.map

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

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

package/dist/extensions/ollama/types.js

@@ -1,7 +0,0 @@
-// Extension-internal types for the Ollama provider.
-//
-// Property names on the SDK request/response shapes are *wire* names
-// dictated by the Ollama HTTP API (snake_case); the in-repo brain-style
-// camelCase rule does not apply to external wire formats.
-export {};
-//# sourceMappingURL=types.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/extensions/ollama/types.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,EAAE;AACF,qEAAqE;AACrE,wEAAwE;AACxE,0DAA0D"}