@jini-ai/agent-runtime 0.1.0

package/dist/providers/anthropic-messages.js

@@ -0,0 +1,313 @@
+/**
+ * @module providers/anthropic-messages
+ *
+ * Anthropic Messages API wire adapter + tool-loop turn-runner. Built fresh
+ * against Anthropic's real, current public API docs (`platform.claude.com/
+ * docs/en/build-with-claude/streaming`, `.../api/messages-streaming`),
+ * following this repo's established "verify against real API docs, don't
+ * guess from memory" convention (see `packages/deploy/src/netlify.ts`'s
+ * doc comment for the precedent) — not a byte-for-byte OD port. Only the
+ * *shape* is modeled on OD's `apps/daemon/src/routes/chat.ts`'s
+ * `runAnthropicToolTurn` (per `ADS-memory/reports/proposals/
+ * PROP-http-route-packs-chat-model-proxy-2026-07-21.md`, which read that
+ * 2267-line file directly and extracted its mechanism, line numbers, and
+ * two confirmed bugs — this task did not have access to the OD source
+ * itself). Extends this package's existing `providers/` pattern
+ * (`model-catalog.ts`'s BYOK request/response handling,
+ * `connection-guard.ts`'s SSRF guard + secret redaction,
+ * `role-marker-guard.ts`'s contamination detector, and the
+ * "one file per vendor's stream-parsing shape" precedent
+ * `claude-stream.ts`/`copilot-stream.ts`/`qoder-stream.ts` already
+ * establish) rather than duplicating any of that inside `@jini-ai/http` — see
+ * the proposal's "real question: where does provider-specific wire-protocol
+ * logic belong?" section for the placement decision this file implements.
+ *
+ * **Scope for this pass:** the Anthropic Messages API only (native
+ * `x-api-key`/`anthropic-version` auth), text + tool-use content blocks,
+ * and the tool-execution loop. Extended thinking is deliberately out of
+ * scope — this adapter never sends a `thinking` request parameter, so
+ * Anthropic never emits `thinking`/`signature_delta` content blocks in the
+ * response (per the streaming docs: thinking blocks are opt-in), which
+ * means there is nothing to parse. A future pass can add it by following
+ * `claude-stream.ts#emitSafeText`'s precedent (thinking is passed through
+ * *unguarded* — the role-marker guard only polices the user-visible text
+ * channel, since thinking content is never re-serialized as a transcript
+ * turn boundary).
+ *
+ * **Two confirmed OD bugs fixed here, not carried forward** (both per the
+ * proposal doc above):
+ * 1. **Product-identity leak.** OD's OpenRouter branch hardcoded
+ *    `'HTTP-Referer': 'https://opendesign.dev'` / `'X-Title': 'Open Design'`.
+ *    OpenRouter itself is out of scope this pass, but the fix generalizes:
+ *    `AnthropicTurnOptions.extraHeaders` is the *only* way any caller-
+ *    identifying header reaches the outbound request, and it is always
+ *    caller-supplied — nothing in this module ever hardcodes a product or
+ *    gateway identity string.
+ * 2. **Duplicate `end`-event bug.** OD's `runAnthropicToolTurn` had two
+ *    independent `sse.send('end', {})` call sites (role-marker-guard
+ *    contamination, and normal turn completion) with no `ended`-flag guard,
+ *    unlike its sibling non-tool-loop streamers in the same file. This
+ *    module uses the shared `turn-end-guard.ts#createTurnEndGuard` — see
+ *    that module's doc for why the guard is extracted into its own
+ *    directly-tested unit rather than a local closure here — from every
+ *    exit path (contamination, normal stop, max-tool-turns, upstream/
+ *    network error), guaranteeing exactly one `end` event per call. See
+ *    `__tests__/anthropic-messages.test.ts`'s "never emits end twice" case
+ *    for the integration-level regression proof.
+ */
+import { createRoleMarkerGuard } from '../role-marker-guard.js';
+import { redactSecrets, validateBaseUrl } from './connection-guard.js';
+import { decodeSseStream } from './sse-decode.js';
+import { createTurnEndGuard } from './turn-end-guard.js';
+const DEFAULT_ANTHROPIC_BASE_URL = 'https://api.anthropic.com';
+const DEFAULT_ANTHROPIC_VERSION = '2023-06-01';
+const DEFAULT_MAX_TOOL_TURNS = 8;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function anthropicRequestUrl(baseUrl) {
+    const base = (baseUrl ?? DEFAULT_ANTHROPIC_BASE_URL).replace(/\/+$/, '');
+    return `${base}/v1/messages`;
+}
+function anthropicHeaders(options) {
+    return {
+        'content-type': 'application/json',
+        'x-api-key': options.apiKey,
+        'anthropic-version': options.apiVersion ?? DEFAULT_ANTHROPIC_VERSION,
+        ...(options.extraHeaders ?? {}),
+    };
+}
+function anthropicRequestBody(options, messages) {
+    return {
+        model: options.model,
+        max_tokens: options.maxTokens,
+        stream: true,
+        messages,
+        ...(options.system !== undefined ? { system: options.system } : {}),
+        ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),
+        ...(options.tools && options.tools.length > 0 ? { tools: options.tools } : {}),
+    };
+}
+function extractAnthropicErrorDetail(rawText) {
+    try {
+        const parsed = JSON.parse(rawText);
+        if (isRecord(parsed) && isRecord(parsed.error) && typeof parsed.error.message === 'string') {
+            return parsed.error.message;
+        }
+    }
+    catch {
+        // Non-JSON error body — fall through to the raw text below.
+    }
+    return rawText.trim().slice(0, 500);
+}
+/** Runs exactly one Anthropic Messages API streaming request and reduces its SSE events into a single outcome. Calls `emitEnd` directly (and only) on contamination or a fatal request/stream error — the caller (`runAnthropicToolTurn`) is responsible for the normal-completion `emitEnd` call once the tool loop actually concludes, so the single `ended` flag stays the sole gate for every exit path. */
+async function runSingleAnthropicRequest(options, messages, emitEnd) {
+    const { onEvent } = options;
+    const baseUrlCheck = validateBaseUrl(options.baseUrl ?? DEFAULT_ANTHROPIC_BASE_URL);
+    if (baseUrlCheck.error) {
+        onEvent({ type: 'error', message: baseUrlCheck.error });
+        emitEnd('error');
+        return { stopReason: null, toolCalls: [], text: '' };
+    }
+    let response;
+    try {
+        response = (await fetch(anthropicRequestUrl(options.baseUrl), {
+            method: 'POST',
+            headers: anthropicHeaders(options),
+            body: JSON.stringify(anthropicRequestBody(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 { stopReason: null, toolCalls: [], text: '' };
+    }
+    if (!response.ok) {
+        const rawText = await response.text();
+        onEvent({
+            type: 'error',
+            message: redactSecrets(extractAnthropicErrorDetail(rawText), [options.apiKey]),
+            code: String(response.status),
+        });
+        emitEnd('error');
+        return { stopReason: null, toolCalls: [], text: '' };
+    }
+    if (!response.body) {
+        onEvent({ type: 'error', message: 'Anthropic response had no body' });
+        emitEnd('error');
+        return { stopReason: null, toolCalls: [], text: '' };
+    }
+    onEvent({ type: 'status', label: 'requesting' });
+    const guard = createRoleMarkerGuard('anthropic-turn');
+    const blocks = new Map();
+    const toolCalls = [];
+    let fullText = '';
+    let stopReason = null;
+    let usage = null;
+    for await (const frame of decodeSseStream(response.body)) {
+        // No `isEnded()` re-check at the top of this loop: every `emitEnd(...)` call site below is
+        // immediately followed by `break`, so `ended` can never be true when a new iteration starts
+        // — traced across all six call sites in this function (the four pre-loop early returns plus
+        // the two in-loop contamination/error branches below). Verified, not assumed; see
+        // `__tests__/anthropic-messages.test.ts`'s duplicate-end-event regression case.
+        let data;
+        try {
+            data = JSON.parse(frame.data);
+        }
+        catch {
+            continue; // tolerate a malformed/empty keep-alive frame
+        }
+        if (!isRecord(data))
+            continue;
+        const kind = typeof data.type === 'string' ? data.type : frame.event;
+        if (kind === 'content_block_start' && isRecord(data.content_block) && typeof data.index === 'number') {
+            const block = data.content_block;
+            if (block.type === 'text') {
+                blocks.set(data.index, { type: 'text', text: '', inputJson: '' });
+            }
+            else if (block.type === 'tool_use' && typeof block.id === 'string' && typeof block.name === 'string') {
+                blocks.set(data.index, { type: 'tool_use', text: '', toolId: block.id, toolName: block.name, inputJson: '' });
+            }
+            else {
+                blocks.set(data.index, { type: 'other', text: '', inputJson: '' });
+            }
+            continue;
+        }
+        if (kind === 'content_block_delta' && isRecord(data.delta) && typeof data.index === 'number') {
+            const state = blocks.get(data.index);
+            const delta = data.delta;
+            if (delta.type === 'text_delta' && typeof delta.text === 'string') {
+                if (state)
+                    state.text += delta.text;
+                // No `guard.contaminated` pre-check here: the only way it can become
+                // true is the `emitEnd('contaminated'); break;` a few lines below,
+                // which exits this loop immediately — a later text_delta in the same
+                // request can never reach this point already contaminated. (`feedText`
+                // itself is still safe to call unconditionally regardless — it
+                // early-returns `''` once contaminated, per its own doc.)
+                const safe = guard.feedText(delta.text);
+                if (safe.length > 0) {
+                    fullText += safe;
+                    onEvent({ type: 'text_delta', delta: safe });
+                }
+                if (guard.contaminated) {
+                    const warn = guard.warningEvent();
+                    if (warn)
+                        onEvent(warn);
+                    emitEnd('contaminated');
+                    break;
+                }
+            }
+            else if (delta.type === 'input_json_delta' && typeof delta.partial_json === 'string' && state) {
+                state.inputJson += delta.partial_json;
+            }
+            continue;
+        }
+        if (kind === 'content_block_stop' && typeof data.index === 'number') {
+            const state = blocks.get(data.index);
+            if (state?.type === 'tool_use' && state.toolId && state.toolName) {
+                let input = {};
+                if (state.inputJson.trim()) {
+                    try {
+                        input = JSON.parse(state.inputJson);
+                    }
+                    catch {
+                        input = {};
+                    }
+                }
+                const call = { id: state.toolId, name: state.toolName, input };
+                toolCalls.push(call);
+                onEvent({ type: 'tool_use', id: call.id, name: call.name, input: call.input });
+            }
+            blocks.delete(data.index);
+            continue;
+        }
+        if (kind === 'message_delta') {
+            if (isRecord(data.delta) && typeof data.delta.stop_reason === 'string') {
+                stopReason = data.delta.stop_reason;
+            }
+            if (isRecord(data.usage)) {
+                usage = data.usage;
+                onEvent({ type: 'usage', usage });
+            }
+            continue;
+        }
+        if (kind === 'error') {
+            const errorDetail = isRecord(data.error) && typeof data.error.message === 'string' ? data.error.message : 'upstream error';
+            const errorType = isRecord(data.error) && typeof data.error.type === 'string' ? data.error.type : undefined;
+            onEvent({ type: 'error', message: redactSecrets(errorDetail, [options.apiKey]), ...(errorType ? { code: errorType } : {}) });
+            emitEnd('error');
+            break;
+        }
+        // `message_start`, `message_stop`, `ping`, and any future event type per
+        // Anthropic's own versioning policy ("your code should handle unknown
+        // event types gracefully") — nothing to do.
+    }
+    return { stopReason, toolCalls, text: fullText };
+}
+/**
+ * Runs a full Anthropic Messages API turn, including the tool-execution
+ * loop when `options.executeTool` is supplied and the model requests tool
+ * use. Emits a generic event stream via `options.onEvent` — a caller (e.g.
+ * `@jini-ai/http`'s `model-proxy.ts`) adapts those events onto an outbound SSE
+ * channel; this module has no knowledge of HTTP/Express.
+ *
+ * Guarantees exactly one `{type: 'end'}` event per call, regardless of which
+ * of the four exit paths (contamination, normal stop, max-tool-turns,
+ * request/stream error) triggers it — the fix for OD's confirmed duplicate-
+ * `end`-event bug (see module doc).
+ */
+export async function runAnthropicToolTurn(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 lastStopReason = null;
+    while (true) {
+        const outcome = await runSingleAnthropicRequest(options, messages, emitEnd);
+        lastStopReason = outcome.stopReason;
+        if (endGuard.hasEnded())
+            break;
+        if (outcome.stopReason !== 'tool_use' || outcome.toolCalls.length === 0) {
+            emitEnd('stop');
+            break;
+        }
+        if (!options.executeTool) {
+            // Pending tool calls were already emitted as `tool_use` events above;
+            // with no executor to run them, the turn ends here rather than
+            // silently retrying forever.
+            emitEnd('stop');
+            break;
+        }
+        if (toolTurns >= maxToolTurns) {
+            emitEnd('max_tool_turns');
+            break;
+        }
+        toolTurns += 1;
+        const assistantContent = [
+            ...(outcome.text ? [{ type: 'text', text: outcome.text }] : []),
+            ...outcome.toolCalls.map((call) => ({ type: 'tool_use', id: call.id, name: call.name, input: call.input })),
+        ];
+        const toolResultBlocks = [];
+        for (const call of outcome.toolCalls) {
+            const result = await options.executeTool(call);
+            options.onEvent({ type: 'tool_result', toolUseId: call.id, content: result.content, isError: result.isError ?? false });
+            toolResultBlocks.push({
+                type: 'tool_result',
+                tool_use_id: call.id,
+                content: result.content,
+                ...(result.isError !== undefined ? { is_error: result.isError } : {}),
+            });
+        }
+        messages = [
+            ...messages,
+            { role: 'assistant', content: assistantContent },
+            { role: 'user', content: toolResultBlocks },
+        ];
+    }
+    return { stopReason: lastStopReason, toolTurns };
+}
+//# sourceMappingURL=anthropic-messages.js.map

package/dist/providers/anthropic-messages.js.map

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

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

@@ -0,0 +1,99 @@
+import { type TurnEndReason } from './turn-end-guard.js';
+export interface AzureFunctionToolDef {
+    readonly type: 'function';
+    readonly function: {
+        readonly name: string;
+        readonly description?: string;
+        readonly parameters: Record<string, unknown>;
+    };
+}
+export interface AzureToolCallParam {
+    readonly id: string;
+    readonly type: 'function';
+    readonly function: {
+        readonly name: string;
+        readonly arguments: string;
+    };
+}
+export interface AzureMessageParam {
+    readonly role: 'system' | 'user' | 'assistant' | 'tool';
+    readonly content: string | null;
+    readonly tool_calls?: readonly AzureToolCallParam[];
+    readonly tool_call_id?: string;
+    readonly name?: string;
+}
+export interface AzureToolCall {
+    readonly id: string;
+    readonly name: string;
+    readonly input: unknown;
+}
+export interface AzureToolResult {
+    readonly content: string;
+}
+/** Host-owned tool execution — same "the collaborator is always supplied" convention as `anthropic-messages.ts#AnthropicToolExecutor`. */
+export type AzureToolExecutor = (call: AzureToolCall) => Promise<AzureToolResult>;
+export type AzureTurnEndReason = TurnEndReason;
+export type AzureTurnEvent = {
+    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: AzureTurnEndReason;
+};
+export interface AzureTurnOptions {
+    readonly apiKey: string;
+    /** Required — every Azure OpenAI resource has its own endpoint, so there is no sane global default (see module doc). */
+    readonly baseUrl: string;
+    /** The Azure OpenAI *deployment name* (not a raw model id). */
+    readonly model: string;
+    /** Defaults to `'2024-10-21'` — see module doc for provenance. */
+    readonly apiVersion?: string;
+    readonly messages: readonly AzureMessageParam[];
+    readonly tools?: readonly AzureFunctionToolDef[];
+    readonly temperature?: number;
+    /** Defaults to 8192 when omitted or not a positive number — a token limit is always sent, matching OD's real `azure` proxy handler (see module doc). */
+    readonly maxTokens?: number;
+    /** Same bound and rationale as `AnthropicTurnOptions.maxToolTurns`. Defaults to 8. */
+    readonly maxToolTurns?: number;
+    readonly executeTool?: AzureToolExecutor;
+    readonly onEvent: (event: AzureTurnEvent) => 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 AzureTurnResult {
+    readonly finishReason: string | null;
+    readonly toolTurns: number;
+}
+/**
+ * Runs a full Azure 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 runAzureToolTurn(options: AzureTurnOptions): Promise<AzureTurnResult>;
+//# sourceMappingURL=azure-chat.d.ts.map

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

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

package/dist/providers/azure-chat.js

@@ -0,0 +1,164 @@
+/**
+ * @module providers/azure-chat
+ *
+ * Azure OpenAI Chat Completions wire adapter + tool-loop turn-runner.
+ * Sibling of `anthropic-messages.ts`/`openai-chat.ts` — see those modules'
+ * headers for the shared design rationale. Azure OpenAI's chat-completions
+ * JSON request/response body is byte-identical to plain OpenAI's (same
+ * `messages`/`tools`/streaming-delta shape) — only the URL and the auth
+ * header differ — so this module reuses `openai-chat.ts`'s extracted
+ * `runOpenAiCompatibleRequest` SSE-reduction loop rather than duplicating
+ * it; see that function's doc for why it was pulled out.
+ *
+ * **URL**: `{baseUrl}/openai/deployments/{model}/chat/completions
+ * ?api-version={apiVersion}` — `model` here is the Azure *deployment name*,
+ * not a model id (Azure OpenAI resources map a deployment name to a
+ * specific model version at resource-creation time). `apiVersion` defaults
+ * to `'2024-10-21'`, the default this repo's real OD predecessor used for
+ * its own azure chat-completions proxy route (`apps/daemon/src/routes/
+ * chat.ts`'s `[proxy:azure]` handler, confirmed by reading that file
+ * directly in a sibling checkout — see `source-map.md`'s dated entry).
+ * That source additionally branches on whether `baseUrl` already contains
+ * a versioned `/openai/v1` path (a newer Azure OpenAI API preview); that
+ * branch is deliberately not carried forward here — this adapter targets
+ * the one documented, stable URL/body shape per this task's approved scope
+ * ("byte-identical to OpenAI, only URL/auth differ"). Its 400-retry
+ * behavior IS carried forward (see "Token-limit fix" below) — round-4
+ * external audit (`AUD-R4-001`) found the first port had dropped it,
+ * which fails every request against a GPT-5/o-series Azure deployment.
+ *
+ * **Auth**: `api-key: {apiKey}` header — NOT `Authorization: Bearer`,
+ * Azure OpenAI's own convention (also confirmed against the same OD
+ * source above).
+ *
+ * **No default `baseUrl`**: every Azure OpenAI resource has its own
+ * endpoint (`https://{resource}.openai.azure.com`), so unlike Anthropic/
+ * OpenAI/Google/Ollama, `baseUrl` is a required field on
+ * {@link AzureTurnOptions}, and `apiVersion` is validated as
+ * non-empty-if-supplied by the caller (`@jini-ai/http`'s
+ * `parseAzureProxyRequest` — see that module).
+ *
+ * **Token-limit fix**: an earlier version of this module sent no token-limit
+ * field at all — a live comparison against a running Open Design daemon
+ * found OD's real `azure` proxy handler always sends `max_tokens` (defaulting
+ * to 8192), unconditionally the legacy field name — never the newer
+ * `max_completion_tokens` `openai-chat.ts` picks for GPT-5/o-series models,
+ * since Azure deployment names are caller-defined strings, not necessarily
+ * matching OpenAI's own model-naming scheme. Wired via
+ * `./token-params.js#buildLegacyMaxTokensParam`. Because deployment names
+ * are opaque, a legacy-field request can still be rejected by a
+ * GPT-5/o-series deployment with a 400 — OD's real handler retries exactly
+ * once with `max_completion_tokens` on that specific error
+ * (`isUnsupportedMaxTokensError`); this module does the same via
+ * `runOpenAiCompatibleRequest`'s `retryableBody` hook.
+ */
+import { defaultDnsLookup, validateBaseUrlResolved } from './connection-guard.js';
+import { runOpenAiCompatibleRequest } from './openai-chat.js';
+import { buildLegacyMaxTokensParam, buildMaxCompletionTokensParam, isUnsupportedMaxTokensError } from './token-params.js';
+import { createTurnEndGuard } from './turn-end-guard.js';
+const DEFAULT_AZURE_API_VERSION = '2024-10-21';
+const DEFAULT_MAX_TOOL_TURNS = 8;
+/** Matches OD's real azure handler's default when `maxTokens` isn't supplied — see module doc. */
+const DEFAULT_AZURE_MAX_TOKENS = 8192;
+function azureRequestUrl(baseUrl, model, apiVersion) {
+    const base = baseUrl.replace(/\/+$/, '');
+    const version = apiVersion && apiVersion.trim() ? apiVersion.trim() : DEFAULT_AZURE_API_VERSION;
+    return `${base}/openai/deployments/${encodeURIComponent(model)}/chat/completions?api-version=${encodeURIComponent(version)}`;
+}
+function azureHeaders(options) {
+    return {
+        'content-type': 'application/json',
+        'api-key': options.apiKey,
+        ...(options.extraHeaders ?? {}),
+    };
+}
+function effectiveAzureMaxTokens(options) {
+    return typeof options.maxTokens === 'number' && options.maxTokens > 0 ? options.maxTokens : DEFAULT_AZURE_MAX_TOKENS;
+}
+/** `tokenParam` is injected so the 400-retry path (see module doc) can rebuild an otherwise-identical body with `max_completion_tokens` instead of `max_tokens`. */
+function azureRequestBody(options, messages, tokenParam) {
+    return {
+        stream: true,
+        stream_options: { include_usage: true },
+        messages,
+        ...tokenParam,
+        ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),
+        ...(options.tools && options.tools.length > 0 ? { tools: options.tools } : {}),
+    };
+}
+/** Validates `options.baseUrl`, then delegates to `openai-chat.ts#runOpenAiCompatibleRequest` with Azure's own URL/header/body builders. */
+async function runSingleAzureRequest(options, messages, emitEnd, hasEnded) {
+    const baseUrlCheck = await validateBaseUrlResolved(options.baseUrl, defaultDnsLookup);
+    if (baseUrlCheck.error) {
+        options.onEvent({ type: 'error', message: baseUrlCheck.error });
+        emitEnd('error');
+        return { finishReason: null, toolCalls: [], text: '' };
+    }
+    const maxTokens = effectiveAzureMaxTokens(options);
+    return runOpenAiCompatibleRequest({
+        url: azureRequestUrl(options.baseUrl, options.model, options.apiVersion),
+        headers: azureHeaders(options),
+        body: azureRequestBody(options, messages, buildLegacyMaxTokensParam(maxTokens)),
+        retryableBody: (status, rawErrorText) => status === 400 && isUnsupportedMaxTokensError(rawErrorText)
+            ? azureRequestBody(options, messages, buildMaxCompletionTokensParam(maxTokens))
+            : null,
+        ...(options.signal ? { signal: options.signal } : {}),
+        redactSecretsList: [options.apiKey],
+        guardMessageId: 'azure-turn',
+        providerLabel: 'Azure OpenAI',
+        onEvent: options.onEvent,
+        emitEnd,
+        hasEnded,
+    });
+}
+/**
+ * Runs a full Azure 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 async function runAzureToolTurn(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 runSingleAzureRequest(options, messages, emitEnd, endGuard.hasEnded);
+        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) => ({
+            id: call.id,
+            type: 'function',
+            function: { name: call.name, arguments: JSON.stringify(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_call_id: call.id });
+        }
+        messages = [
+            ...messages,
+            { role: 'assistant', content: outcome.text || null, tool_calls: assistantToolCalls },
+            ...toolResultMessages,
+        ];
+    }
+    return { finishReason: lastFinishReason, toolTurns };
+}
+//# sourceMappingURL=azure-chat.js.map

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

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