@jini-ai/agent-runtime 0.1.0

package/dist/providers/ollama-chat.d.ts

@@ -0,0 +1,106 @@
+import { type TurnEndReason } from './turn-end-guard.js';
+export interface OllamaFunctionToolDef {
+    readonly type: 'function';
+    readonly function: {
+        readonly name: string;
+        readonly description?: string;
+        readonly parameters: Record<string, unknown>;
+    };
+}
+/**
+ * Ollama's native `/api/chat` tool-call shape — genuinely different from the
+ * OpenAI-compatible one this file's types were originally copied from:
+ * `arguments` is a native JSON object (not a stringified blob), and there is
+ * no `id`/`type` field at all (confirmed against Ollama's own documented
+ * "Chat request (No streaming, with tools)" example,
+ * `github.com/ollama/ollama/blob/main/docs/api.md`). Round-4 external audit
+ * (`AUD-R4-002`) found the first port had kept the OpenAI shape here, which
+ * a strict Ollama server can reject. Synthetic per-call `id`s are still
+ * generated (see `runSingleOllamaRequest`) but stay purely internal to this
+ * module's own event stream — they are never put on the wire.
+ */
+export interface OllamaToolCallParam {
+    readonly function: {
+        readonly name: string;
+        readonly arguments: unknown;
+    };
+}
+export interface OllamaMessageParam {
+    readonly role: 'system' | 'user' | 'assistant' | 'tool';
+    readonly content: string | null;
+    readonly tool_calls?: readonly OllamaToolCallParam[];
+    /** Ollama's native tool-result association field — NOT `tool_call_id` (that's the OpenAI shape; Ollama has no call-id concept on the wire). */
+    readonly tool_name?: string;
+}
+export interface OllamaToolCall {
+    readonly id: string;
+    readonly name: string;
+    readonly input: unknown;
+}
+export interface OllamaToolResult {
+    readonly content: string;
+}
+/** Host-owned tool execution — same "the collaborator is always supplied" convention as `anthropic-messages.ts#AnthropicToolExecutor`. */
+export type OllamaToolExecutor = (call: OllamaToolCall) => Promise<OllamaToolResult>;
+export type OllamaTurnEndReason = TurnEndReason;
+export type OllamaTurnEvent = {
+    readonly type: 'status';
+    readonly label: string;
+} | {
+    readonly type: 'text_delta';
+    readonly delta: string;
+} | {
+    readonly type: 'tool_use';
+    readonly id: string;
+    readonly name: string;
+    readonly input: unknown;
+} | {
+    readonly type: 'tool_result';
+    readonly toolUseId: string;
+    readonly content: string;
+    readonly isError: boolean;
+} | {
+    readonly type: 'usage';
+    readonly usage: Record<string, unknown> | null;
+} | {
+    readonly type: 'fabricated_role_marker';
+    readonly marker: string;
+    readonly messageId: string;
+} | {
+    readonly type: 'error';
+    readonly message: string;
+    readonly code?: string;
+} | {
+    readonly type: 'end';
+    readonly reason: OllamaTurnEndReason;
+};
+export interface OllamaTurnOptions {
+    /** Required — see module doc (OD's real handler rejects a request with no apiKey). */
+    readonly apiKey: string;
+    /** Defaults to `https://ollama.com` (Ollama Cloud) — see module doc. Pass a local address explicitly to target a local install. */
+    readonly baseUrl?: string;
+    readonly model: string;
+    readonly messages: readonly OllamaMessageParam[];
+    readonly tools?: readonly OllamaFunctionToolDef[];
+    readonly temperature?: number;
+    readonly maxTokens?: number;
+    /** Same bound and rationale as `AnthropicTurnOptions.maxToolTurns`. Defaults to 8. */
+    readonly maxToolTurns?: number;
+    readonly executeTool?: OllamaToolExecutor;
+    readonly onEvent: (event: OllamaTurnEvent) => void;
+    readonly signal?: AbortSignal;
+    /** Caller-supplied extra headers — see `anthropic-messages.ts#AnthropicTurnOptions.extraHeaders`'s doc for why this exists and what it fixes. */
+    readonly extraHeaders?: Record<string, string>;
+}
+export interface OllamaTurnResult {
+    readonly finishReason: string | null;
+    readonly toolTurns: number;
+}
+/**
+ * Runs a full Ollama native `/api/chat` turn, including the tool-execution
+ * loop when `options.executeTool` is supplied and the model requests a
+ * function call. See `anthropic-messages.ts#runAnthropicToolTurn`'s doc for
+ * the shared event-stream/`ended`-flag contract this mirrors exactly.
+ */
+export declare function runOllamaToolTurn(options: OllamaTurnOptions): Promise<OllamaTurnResult>;
+//# sourceMappingURL=ollama-chat.d.ts.map

package/dist/providers/ollama-chat.d.ts.map

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

package/dist/providers/ollama-chat.js

@@ -0,0 +1,292 @@
+/**
+ * @module providers/ollama-chat
+ *
+ * Ollama native Chat API wire adapter + tool-loop turn-runner. Sibling of
+ * `anthropic-messages.ts`/`openai-chat.ts`/`azure-chat.ts` — see those
+ * modules' headers for the shared design rationale.
+ *
+ * **Corrected to match Open Design's real behavior** (an earlier version of
+ * this module targeted Ollama's OpenAI-compatible `/v1/chat/completions`
+ * surface instead — found wrong by a live side-by-side comparison against a
+ * running OD daemon, `apps/daemon/src/routes/chat.ts:1298`'s real
+ * `/api/proxy/ollama/stream` handler):
+ *
+ * - **Endpoint**: `{baseUrl}/api/chat` — Ollama's own native chat API, not
+ *   the OpenAI-compatible shim. `baseUrl` has any trailing `/api` stripped
+ *   before appending, matching OD's `.replace(/\/api\/?$/, '')`.
+ * - **Wire format**: newline-delimited JSON (NDJSON), one JSON object per
+ *   line, terminated by a line with `"done": true` — NOT Server-Sent
+ *   Events. `text_delta`s come from `message.content`; the terminal line's
+ *   `done: true` ends the stream (see `runSingleOllamaRequest` below).
+ * - **`apiKey` is required**, like every other provider — OD's real handler
+ *   rejects a request with no `apiKey` (`if (!apiKey || !model)`), because
+ *   its default target is Ollama Cloud (see next point), not a bare local
+ *   install.
+ * - **Default `baseUrl` is `https://ollama.com`** (Ollama Cloud), matching
+ *   OD's `effectiveBaseUrl = baseUrl || 'https://ollama.com'` — not a local
+ *   loopback address. A caller running a real local Ollama install still
+ *   just passes `baseUrl: 'http://localhost:11434'` explicitly; the
+ *   loopback carve-out in `connection-guard.ts` (documented there as
+ *   existing "for local LLM servers like Ollama") still applies when they
+ *   do.
+ * - **Token limit**: `options.num_predict` (Ollama's native token-limit
+ *   field), sent only when `maxTokens` is a positive number — matches OD's
+ *   `if (typeof maxTokens === 'number' && maxTokens > 0) payload.options = {
+ *   num_predict: maxTokens }`.
+ *
+ * **Round-4 external audit fix (`AUD-R4-002`)**: the first port of this
+ * module's tool-call loop kept the OpenAI-compatible wire shape for both the
+ * emitted lifecycle event and the continuation request — `tool_use` was
+ * never emitted, and the assistant/tool continuation messages used a
+ * stringified `arguments` blob with `id`/`type`/`tool_call_id` fields that
+ * don't exist in Ollama's native tool-call schema. Fixed: `tool_use` now
+ * fires for every resolved call as soon as the stream ends (see
+ * `runSingleOllamaRequest`), and `OllamaToolCallParam`/`OllamaMessageParam`
+ * now match Ollama's own documented shape (`arguments` as a native object,
+ * `tool_name` instead of `tool_call_id` — see those interfaces' docs).
+ *
+ * **Deliberate extension beyond OD's own scope, not a parity gap**: OD's
+ * ollama handler never builds a `tools` field into its request and never
+ * reads `message.tool_calls` from the response — its own ollama proxy has
+ * no tool-calling support at all. Ollama's real native `/api/chat` API does
+ * support tool calling (a `tools` array in the same OpenAI
+ * function-declaration shape on the request, `message.tool_calls: [{id?,
+ * function: {name, arguments}}]` on a non-streaming-final response chunk —
+ * see `github.com/ollama/ollama/blob/main/docs/api.md#chat-request-with-
+ * tools`). This module keeps that capability (as the original, pre-parity-
+ * fix version of this file already did) rather than removing working
+ * functionality just to match a gap in OD's own product scope — matching
+ * this repo's established practice elsewhere (e.g. `xai.ts` deliberately
+ * generalizing OD's OAuth-connect *shape* while dropping its OD-specific
+ * SuperGrok billing gate).
+ */
+import { createRoleMarkerGuard } from '../role-marker-guard.js';
+import { defaultDnsLookup, redactSecrets, validateBaseUrlResolved } from './connection-guard.js';
+import { createTurnEndGuard } from './turn-end-guard.js';
+const DEFAULT_OLLAMA_BASE_URL = 'https://ollama.com';
+const DEFAULT_MAX_TOOL_TURNS = 8;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Strips a trailing `/api` (with or without a trailing slash) before appending `/api/chat` — matches OD's `.replace(/\/+$/, '').replace(/\/api\/?$/, '')` so a caller-supplied `baseUrl` ending in `/api` doesn't produce `/api/api/chat`. */
+function ollamaRequestUrl(baseUrl) {
+    const trimmed = (baseUrl ?? DEFAULT_OLLAMA_BASE_URL).replace(/\/+$/, '').replace(/\/api\/?$/, '');
+    return `${trimmed}/api/chat`;
+}
+function ollamaHeaders(options) {
+    return {
+        'content-type': 'application/json',
+        authorization: `Bearer ${options.apiKey}`,
+        ...(options.extraHeaders ?? {}),
+    };
+}
+function ollamaRequestBody(options, messages) {
+    const modelOptions = {};
+    if (options.temperature !== undefined)
+        modelOptions.temperature = options.temperature;
+    if (typeof options.maxTokens === 'number' && options.maxTokens > 0)
+        modelOptions.num_predict = options.maxTokens;
+    return {
+        model: options.model,
+        stream: true,
+        messages,
+        ...(Object.keys(modelOptions).length > 0 ? { options: modelOptions } : {}),
+        ...(options.tools && options.tools.length > 0 ? { tools: options.tools } : {}),
+    };
+}
+function extractOllamaErrorDetail(rawText) {
+    try {
+        const parsed = JSON.parse(rawText);
+        if (isRecord(parsed) && typeof parsed.error === 'string')
+            return parsed.error;
+    }
+    catch {
+        // fall through to raw text
+    }
+    return rawText.slice(0, 500);
+}
+/**
+ * Reads a `fetch` response body as newline-delimited JSON, yielding one
+ * parsed line at a time. Buffers partial lines across chunk boundaries — an
+ * NDJSON line is not guaranteed to arrive in a single chunk. A trailing,
+ * unterminated final line (no closing newline) is still yielded once the
+ * stream ends, matching `sse-decode.ts#decodeSseStream`'s equivalent
+ * tolerance for the SSE case.
+ */
+async function* decodeNdjsonStream(body) {
+    const decoder = new TextDecoder();
+    let buffer = '';
+    for await (const chunk of body) {
+        buffer += typeof chunk === 'string' ? chunk : decoder.decode(chunk, { stream: true });
+        let newlineIndex;
+        while ((newlineIndex = buffer.indexOf('\n')) >= 0) {
+            const line = buffer.slice(0, newlineIndex).trim();
+            buffer = buffer.slice(newlineIndex + 1);
+            if (!line)
+                continue;
+            try {
+                yield JSON.parse(line);
+            }
+            catch {
+                continue; // tolerate a malformed/empty keep-alive line
+            }
+        }
+    }
+    const trailing = buffer.trim();
+    if (trailing) {
+        try {
+            yield JSON.parse(trailing);
+        }
+        catch {
+            // final partial line was never completed — nothing usable to yield
+        }
+    }
+}
+/** Runs exactly one Ollama `/api/chat` NDJSON streaming request and reduces it into a single outcome. Mirrors `anthropic-messages.ts#runSingleAnthropicRequest`'s `emitEnd` contract — see that function's doc. */
+async function runSingleOllamaRequest(options, messages, emitEnd) {
+    const { onEvent } = options;
+    const baseUrlCheck = await validateBaseUrlResolved(options.baseUrl ?? DEFAULT_OLLAMA_BASE_URL, defaultDnsLookup);
+    if (baseUrlCheck.error) {
+        onEvent({ type: 'error', message: baseUrlCheck.error });
+        emitEnd('error');
+        return { finishReason: null, toolCalls: [], text: '' };
+    }
+    let response;
+    try {
+        response = (await fetch(ollamaRequestUrl(options.baseUrl), {
+            method: 'POST',
+            headers: ollamaHeaders(options),
+            body: JSON.stringify(ollamaRequestBody(options, messages)),
+            ...(options.signal ? { signal: options.signal } : {}),
+        }));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        onEvent({ type: 'error', message: redactSecrets(message, [options.apiKey]) });
+        emitEnd('error');
+        return { finishReason: null, toolCalls: [], text: '' };
+    }
+    if (!response.ok) {
+        const rawText = await response.text();
+        onEvent({
+            type: 'error',
+            message: redactSecrets(extractOllamaErrorDetail(rawText), [options.apiKey]),
+            code: String(response.status),
+        });
+        emitEnd('error');
+        return { finishReason: null, toolCalls: [], text: '' };
+    }
+    if (!response.body) {
+        onEvent({ type: 'error', message: 'Ollama response had no body' });
+        emitEnd('error');
+        return { finishReason: null, toolCalls: [], text: '' };
+    }
+    onEvent({ type: 'status', label: 'requesting' });
+    const guard = createRoleMarkerGuard('ollama-turn');
+    let fullText = '';
+    const toolCalls = [];
+    let finishReason = null;
+    for await (const line of decodeNdjsonStream(response.body)) {
+        if (!isRecord(line))
+            continue;
+        const message = isRecord(line.message) ? line.message : null;
+        if (message && typeof message.content === 'string' && message.content.length > 0) {
+            const safe = guard.feedText(message.content);
+            if (safe.length > 0) {
+                fullText += safe;
+                onEvent({ type: 'text_delta', delta: safe });
+            }
+            if (guard.contaminated) {
+                const warn = guard.warningEvent();
+                if (warn)
+                    onEvent(warn);
+                finishReason = 'contaminated';
+                emitEnd('contaminated');
+                break;
+            }
+        }
+        if (message && Array.isArray(message.tool_calls)) {
+            for (const rawCall of message.tool_calls) {
+                if (!isRecord(rawCall) || !isRecord(rawCall.function))
+                    continue;
+                const name = typeof rawCall.function.name === 'string' ? rawCall.function.name : '';
+                if (!name)
+                    continue;
+                const args = rawCall.function.arguments;
+                const input = typeof args === 'string' ? (() => { try {
+                    return JSON.parse(args);
+                }
+                catch {
+                    return args;
+                } })() : args;
+                const id = typeof rawCall.id === 'string' && rawCall.id ? rawCall.id : `ollama-tool-${toolCalls.length}`;
+                toolCalls.push({ id, name, input });
+            }
+            if (toolCalls.length > 0)
+                finishReason = 'tool_calls';
+        }
+        if (line.done === true) {
+            if (finishReason !== 'contaminated' && finishReason !== 'tool_calls')
+                finishReason = 'stop';
+            break;
+        }
+    }
+    // Emitted for every resolved call as soon as the stream ends, independent of whether the
+    // caller actually supplied an `executeTool` — matches `openai-chat.ts#runOpenAiCompatibleRequest`'s
+    // identical unconditional-on-resolution emission (see AUD-R4-002 fix note in the module doc).
+    if (finishReason === 'tool_calls') {
+        for (const call of toolCalls) {
+            onEvent({ type: 'tool_use', id: call.id, name: call.name, input: call.input });
+        }
+    }
+    return { finishReason, toolCalls, text: fullText };
+}
+/**
+ * Runs a full Ollama native `/api/chat` turn, including the tool-execution
+ * loop when `options.executeTool` is supplied and the model requests a
+ * function call. See `anthropic-messages.ts#runAnthropicToolTurn`'s doc for
+ * the shared event-stream/`ended`-flag contract this mirrors exactly.
+ */
+export async function runOllamaToolTurn(options) {
+    const maxToolTurns = options.maxToolTurns ?? DEFAULT_MAX_TOOL_TURNS;
+    const endGuard = createTurnEndGuard(options.onEvent, (reason) => ({ type: 'end', reason }));
+    const emitEnd = endGuard.emitEnd;
+    let messages = options.messages.slice();
+    let toolTurns = 0;
+    let lastFinishReason = null;
+    while (true) {
+        const outcome = await runSingleOllamaRequest(options, messages, emitEnd);
+        lastFinishReason = outcome.finishReason;
+        if (endGuard.hasEnded())
+            break;
+        if (outcome.finishReason !== 'tool_calls' || outcome.toolCalls.length === 0) {
+            emitEnd('stop');
+            break;
+        }
+        if (!options.executeTool) {
+            emitEnd('stop');
+            break;
+        }
+        if (toolTurns >= maxToolTurns) {
+            emitEnd('max_tool_turns');
+            break;
+        }
+        toolTurns += 1;
+        const assistantToolCalls = outcome.toolCalls.map((call) => ({
+            function: { name: call.name, arguments: call.input },
+        }));
+        const toolResultMessages = [];
+        for (const call of outcome.toolCalls) {
+            const result = await options.executeTool(call);
+            options.onEvent({ type: 'tool_result', toolUseId: call.id, content: result.content, isError: false });
+            toolResultMessages.push({ role: 'tool', content: result.content, tool_name: call.name });
+        }
+        messages = [
+            ...messages,
+            { role: 'assistant', content: outcome.text || null, tool_calls: assistantToolCalls },
+            ...toolResultMessages,
+        ];
+    }
+    return { finishReason: lastFinishReason, toolTurns };
+}
+//# sourceMappingURL=ollama-chat.js.map

package/dist/providers/ollama-chat.js.map

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

package/dist/providers/openai-chat.d.ts

@@ -0,0 +1,147 @@
+import { type TurnEndReason } from './turn-end-guard.js';
+export interface OpenAiFunctionToolDef {
+    readonly type: 'function';
+    readonly function: {
+        readonly name: string;
+        readonly description?: string;
+        readonly parameters: Record<string, unknown>;
+    };
+}
+export interface OpenAiToolCallParam {
+    readonly id: string;
+    readonly type: 'function';
+    readonly function: {
+        readonly name: string;
+        readonly arguments: string;
+    };
+}
+export interface OpenAiMessageParam {
+    readonly role: 'system' | 'user' | 'assistant' | 'tool';
+    readonly content: string | null;
+    readonly tool_calls?: readonly OpenAiToolCallParam[];
+    readonly tool_call_id?: string;
+    readonly name?: string;
+}
+export interface OpenAiToolCall {
+    readonly id: string;
+    readonly name: string;
+    readonly input: unknown;
+}
+export interface OpenAiToolResult {
+    readonly content: string;
+}
+/** Host-owned tool execution — same "the collaborator is always supplied" convention as `anthropic-messages.ts#AnthropicToolExecutor`. */
+export type OpenAiToolExecutor = (call: OpenAiToolCall) => Promise<OpenAiToolResult>;
+export type OpenAiTurnEndReason = TurnEndReason;
+export type OpenAiTurnEvent = {
+    readonly type: 'status';
+    readonly label: string;
+} | {
+    readonly type: 'text_delta';
+    readonly delta: string;
+} | {
+    readonly type: 'tool_use';
+    readonly id: string;
+    readonly name: string;
+    readonly input: unknown;
+} | {
+    readonly type: 'tool_result';
+    readonly toolUseId: string;
+    readonly content: string;
+    readonly isError: boolean;
+} | {
+    readonly type: 'usage';
+    readonly usage: Record<string, unknown> | null;
+} | {
+    readonly type: 'fabricated_role_marker';
+    readonly marker: string;
+    readonly messageId: string;
+} | {
+    readonly type: 'error';
+    readonly message: string;
+    readonly code?: string;
+} | {
+    readonly type: 'end';
+    readonly reason: OpenAiTurnEndReason;
+};
+export interface OpenAiTurnOptions {
+    readonly apiKey: string;
+    /** Defaults to `https://api.openai.com`. Overridable for OpenAI-compatible gateways (matching `providers/model-catalog.ts`'s `openai`-protocol `baseUrl` convention). */
+    readonly baseUrl?: string;
+    readonly model: string;
+    readonly messages: readonly OpenAiMessageParam[];
+    readonly tools?: readonly OpenAiFunctionToolDef[];
+    readonly temperature?: number;
+    /** Defaults to {@link DEFAULT_OPENAI_MAX_TOKENS} (8192) when omitted or not a positive number — a token limit is always sent, matching OD's real behavior (see module doc). */
+    readonly maxTokens?: number;
+    /** Same bound and rationale as `AnthropicTurnOptions.maxToolTurns`. Defaults to 8. */
+    readonly maxToolTurns?: number;
+    readonly executeTool?: OpenAiToolExecutor;
+    readonly onEvent: (event: OpenAiTurnEvent) => void;
+    readonly signal?: AbortSignal;
+    /** Caller-supplied extra headers — see `anthropic-messages.ts#AnthropicTurnOptions.extraHeaders`'s doc for why this exists and what it fixes. */
+    readonly extraHeaders?: Record<string, string>;
+}
+export interface OpenAiTurnResult {
+    readonly finishReason: string | null;
+    readonly toolTurns: number;
+}
+/** Matches OD's own default (`apps/daemon/src/routes/chat.ts`'s openai/azure handlers both fall back to this when the caller doesn't supply one) — a real, explicit bound is always sent, never an unbounded request. */
+export declare const DEFAULT_OPENAI_MAX_TOKENS = 8192;
+/** Shared return shape for one reduced OpenAI-compatible streaming request — exported so every OpenAI-compatible provider turn-runner (`azure-chat.ts`, `ollama-chat.ts`) can type its own internal single-request helper against it without re-declaring an identical interface. */
+export interface OpenAiCompatibleRequestOutcome {
+    readonly finishReason: string | null;
+    readonly toolCalls: readonly OpenAiToolCall[];
+    readonly text: string;
+}
+/** Injected parameters for {@link runOpenAiCompatibleRequest}. Every OpenAI-compatible provider builds its own URL/headers/body (its own auth scheme, its own base-URL default and SSRF validation) and hands the finished request to this shared reducer — see that function's doc for why. */
+export interface OpenAiCompatibleRequestInit {
+    readonly url: string;
+    readonly headers: Record<string, string>;
+    readonly body: Record<string, unknown>;
+    readonly signal?: AbortSignal;
+    /** Secrets to strip out of any error message surfaced to the caller (e.g. the request's API key) — forwarded verbatim to `redactSecrets`'s `exactSecrets` parameter. */
+    readonly redactSecretsList: ReadonlyArray<string | undefined | null>;
+    /** Role-marker guard message id — distinguishes each provider's stream in guard telemetry (`'openai-turn'`, `'azure-turn'`, `'ollama-turn'`). */
+    readonly guardMessageId: string;
+    /** Human-readable provider name used in the "response had no body" fallback error message (e.g. `'OpenAI'`, `'Azure OpenAI'`, `'Ollama'`). */
+    readonly providerLabel: string;
+    readonly onEvent: (event: OpenAiTurnEvent) => void;
+    readonly emitEnd: (reason: OpenAiTurnEndReason) => void;
+    readonly hasEnded: () => boolean;
+    /**
+     * Optional single-retry hook: called with the HTTP status and raw error
+     * body text on a non-ok response, before the error is treated as
+     * terminal. Return a replacement request body to retry once with, or
+     * `null`/`undefined` to fall through to the normal error path. Matches
+     * OD's real `[proxy:azure]` handler, which retries a 400
+     * `isUnsupportedMaxTokensError` response with `max_completion_tokens`
+     * (see `azure-chat.ts`). Cleared on the retried call so a second failure
+     * cannot retry again.
+     */
+    readonly retryableBody?: (status: number, rawErrorText: string) => Record<string, unknown> | null | undefined;
+}
+/**
+ * Runs exactly one OpenAI-compatible (Chat Completions JSON wire format)
+ * streaming HTTP request and reduces its SSE events into a single outcome.
+ * Extracted so this ~150-line SSE-reduction loop has exactly one
+ * implementation shared by every OpenAI-compatible provider turn-runner in
+ * this package: `runOpenAiToolTurn` itself (below), plus
+ * `azure-chat.ts#runAzureToolTurn` and `ollama-chat.ts#runOllamaToolTurn` —
+ * both target byte-identical chat-completions JSON, differing only in URL
+ * and auth. Callers own their own base-URL SSRF validation
+ * (`validateBaseUrl`) and URL/header/body construction *before* calling
+ * this function — it only knows how to run *a* request against whatever
+ * URL/headers/body it is handed, and has no opinion on any provider's
+ * defaults. Mirrors `anthropic-messages.ts#runSingleAnthropicRequest`'s
+ * `emitEnd` contract — see that function's doc.
+ */
+export declare function runOpenAiCompatibleRequest(init: OpenAiCompatibleRequestInit): Promise<OpenAiCompatibleRequestOutcome>;
+/**
+ * Runs a full OpenAI Chat Completions turn, including the tool-execution
+ * loop when `options.executeTool` is supplied and the model requests a
+ * function call. See `anthropic-messages.ts#runAnthropicToolTurn`'s doc for
+ * the shared event-stream/`ended`-flag contract this mirrors exactly.
+ */
+export declare function runOpenAiToolTurn(options: OpenAiTurnOptions): Promise<OpenAiTurnResult>;
+//# sourceMappingURL=openai-chat.d.ts.map

package/dist/providers/openai-chat.d.ts.map

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