@salesforce/sfdx-agent-harness-openai 0.0.1

package/dist/openai-message-mapper.d.ts

@@ -0,0 +1,79 @@
+import { type Message, type MessagePart } from '@salesforce/sfdx-agent-sdk';
+import type { SessionRecord } from './openai-session-store.js';
+/**
+ * Bridges the `@openai/agents` flat `AgentInputItem[]` history and the SDK's
+ * `Message[]` contract in both directions.
+ *
+ * **Read** ({@link recordsToMessages}): the OpenAI run loop persists a completed
+ * tool call as a `function_call` item and a separate `function_call_result` item
+ * sharing `callId`. Each item maps to its own `Message`;
+ * the shared {@link splitToolResultsIntoToolMessages} normalizer then produces
+ * the canonical two-message layout (`assistant`(tool-call) + separate
+ * `role:'tool'`(tool-result), #647). Running the shared normalizer — rather than
+ * hand-emitting the layout — is the single-site contract that keeps the three
+ * harnesses from drifting. `createdAt` rides on the {@link SessionRecord}; a
+ * tool result's `isError` rides on the record too and is restored onto the
+ * `tool-result` part.
+ *
+ * **Write** ({@link messagesToRecords}): the `addContext` path. Each `Message`
+ * part lowers to a flat item — a `tool-call` part → `function_call`, a
+ * `tool-result` part → `function_call_result`, text/reasoning → message /
+ * reasoning items. OpenAI stores these separately natively, so — unlike the
+ * Mastra harness, which coalesces call+result into one object and needs
+ * `mergeToolResultsIntoAssistant` on write — no merge step is required; the split
+ * IS the native representation, and a `getMessages()` → `addContext()` round-trip
+ * is lossless.
+ *
+ * **Supported parts:** text, reasoning, and tool parts. Multimodal
+ * (`image` / `file`) parts are rejected with `INVALID_MESSAGE_CONTENT`, matching
+ * the text-only stream input the harness accepts; multimodal is not yet
+ * implemented.
+ */
+/**
+ * Map persisted records to the canonical `Message[]` layout. Does NOT sort — the
+ * caller sorts ascending by `createdAt` after the normalizer (the #464 read
+ * contract), so the normalizer's inherited-`createdAt` tool messages land
+ * adjacent to their originating call under a stable sort.
+ */
+export declare function recordsToMessages(records: SessionRecord[]): Message[];
+/**
+ * Lower `Message[]` (already `createdAt`-backfilled by the caller) to
+ * {@link SessionRecord}s. Each message's parts expand to one or more flat items;
+ * every record inherits its source message's `createdAt`, so a message that
+ * expands to a `function_call` + `function_call_result` pair keeps them adjacent
+ * under the read-side stable sort (equal `createdAt` → insertion order).
+ */
+export declare function messagesToRecords(messages: Message[]): SessionRecord[];
+/**
+ * Render a {@link MessagePart} as a plain-text transcript fragment. Byte-identical
+ * to the Mastra and Claude harnesses' copies — the shared
+ * `@salesforce/harness-conformance` `TRANSCRIPT_FIXTURES` table is the drift-guard
+ * (cross-harness imports are lint-blocked, so each harness keeps its own copy).
+ *
+ * Tool args/results render verbatim (the compaction char budget is the safety
+ * net, not per-part truncation). Image/file parts render as a size-aware
+ * placeholder and NEVER inline their base64 blob.
+ */
+export declare function partToTranscriptText(part: MessagePart): string;
+/**
+ * Maximum flattened-transcript length (in characters) sent to the model in a
+ * single `compactThread` summarization call. Transcripts above this size are
+ * split into roughly-equal chunks, each chunk is summarized separately, and the
+ * concatenated chunk-summaries are then summarized into the final summary.
+ *
+ * ~400k characters maps to ~100k tokens at a conservative 4:1 chars-per-token
+ * ratio, leaving headroom under typical 200k-token model context windows for the
+ * prompt scaffolding and the model's own response. A byte-identical copy of the
+ * Mastra and Claude harnesses' constant — cross-harness imports are lint-blocked,
+ * so each harness keeps its own copy.
+ */
+export declare const MAX_TRANSCRIPT_CHARS = 400000;
+/**
+ * Splits a string into ≤ `maxChars`-sized chunks, preferring line boundaries so
+ * message turns are not torn across chunks. Falls back to a hard slice if a
+ * single line itself exceeds the budget. A byte-identical copy of the sibling
+ * harnesses' `splitIntoChunks` (drift-guarded socially, not by a shared table —
+ * the transcript conformance fixtures cover `partToTranscriptText`, not the
+ * chunker).
+ */
+export declare function splitIntoChunks(text: string, maxChars: number): string[];

package/dist/openai-message-mapper.js

@@ -0,0 +1,374 @@
+/*
+ * Copyright 2026, Salesforce, Inc. All rights reserved.
+ * See LICENSE.txt for license terms.
+ */
+import { AgentSDKError, AgentSDKErrorType } from '@salesforce/sfdx-agent-sdk';
+import { splitToolResultsIntoToolMessages } from '@salesforce/sfdx-agent-sdk/harness';
+/**
+ * Bridges the `@openai/agents` flat `AgentInputItem[]` history and the SDK's
+ * `Message[]` contract in both directions.
+ *
+ * **Read** ({@link recordsToMessages}): the OpenAI run loop persists a completed
+ * tool call as a `function_call` item and a separate `function_call_result` item
+ * sharing `callId`. Each item maps to its own `Message`;
+ * the shared {@link splitToolResultsIntoToolMessages} normalizer then produces
+ * the canonical two-message layout (`assistant`(tool-call) + separate
+ * `role:'tool'`(tool-result), #647). Running the shared normalizer — rather than
+ * hand-emitting the layout — is the single-site contract that keeps the three
+ * harnesses from drifting. `createdAt` rides on the {@link SessionRecord}; a
+ * tool result's `isError` rides on the record too and is restored onto the
+ * `tool-result` part.
+ *
+ * **Write** ({@link messagesToRecords}): the `addContext` path. Each `Message`
+ * part lowers to a flat item — a `tool-call` part → `function_call`, a
+ * `tool-result` part → `function_call_result`, text/reasoning → message /
+ * reasoning items. OpenAI stores these separately natively, so — unlike the
+ * Mastra harness, which coalesces call+result into one object and needs
+ * `mergeToolResultsIntoAssistant` on write — no merge step is required; the split
+ * IS the native representation, and a `getMessages()` → `addContext()` round-trip
+ * is lossless.
+ *
+ * **Supported parts:** text, reasoning, and tool parts. Multimodal
+ * (`image` / `file`) parts are rejected with `INVALID_MESSAGE_CONTENT`, matching
+ * the text-only stream input the harness accepts; multimodal is not yet
+ * implemented.
+ */
+// ── Read path ────────────────────────────────────────────────────────────────
+/**
+ * Map persisted records to the canonical `Message[]` layout. Does NOT sort — the
+ * caller sorts ascending by `createdAt` after the normalizer (the #464 read
+ * contract), so the normalizer's inherited-`createdAt` tool messages land
+ * adjacent to their originating call under a stable sort.
+ */
+export function recordsToMessages(records) {
+    const mapped = [];
+    records.forEach((record, index) => {
+        const message = itemToMessage(record, index);
+        if (message !== undefined)
+            mapped.push(message);
+    });
+    return splitToolResultsIntoToolMessages(mapped);
+}
+/**
+ * Map one persisted record to a `Message`, or `undefined` for an item type with
+ * no SDK-message equivalent (compaction markers, hosted-tool calls, etc.) so
+ * history retrieval never crashes on an unmapped upstream item.
+ */
+function itemToMessage(record, index) {
+    const item = record.item;
+    const createdAt = new Date(record.createdAt);
+    // Message items carry a `role`; every other item type is discriminated on
+    // `type`. (A `function_call` has no `role`, so this order is unambiguous.)
+    if (item.role === 'user' || item.role === 'assistant' || item.role === 'system') {
+        return messageItemToMessage(item, item.role, createdAt, index);
+    }
+    switch (item.type) {
+        case 'function_call': {
+            if (item.callId === undefined || item.name === undefined)
+                return undefined;
+            const part = {
+                type: 'tool-call',
+                toolCallId: item.callId,
+                toolName: item.name,
+                args: parseArgs(item.arguments),
+            };
+            return { id: item.id ?? `toolcall-${item.callId}`, role: 'assistant', content: [part], createdAt };
+        }
+        case 'function_call_result': {
+            if (item.callId === undefined || item.name === undefined)
+                return undefined;
+            const part = {
+                type: 'tool-result',
+                toolCallId: item.callId,
+                toolName: item.name,
+                result: normalizeToolOutput(item.output),
+                ...(record.isError === true ? { isError: true } : {}),
+            };
+            // Emit on a non-`tool` message so the shared normalizer hoists it
+            // onto its own trailing `role:'tool'` message (the single-site
+            // layout contract). Assistant is the pre-normalizer carrier here;
+            // the normalizer drops this now-empty message and emits the tool one.
+            return { id: item.id ?? `toolresult-${item.callId}`, role: 'assistant', content: [part], createdAt };
+        }
+        case 'reasoning': {
+            const text = readTextContent(item.content);
+            return {
+                id: item.id ?? `reasoning-${index}`,
+                role: 'assistant',
+                content: [{ type: 'reasoning', text }],
+                createdAt,
+            };
+        }
+        default:
+            // Unmapped item type (hosted_tool_call, computer_call, compaction,
+            // unknown, …): drop it from history rather than surface an
+            // un-renderable message.
+            return undefined;
+    }
+}
+function messageItemToMessage(item, role, createdAt, index) {
+    const id = item.id ?? `msg-${index}`;
+    if (typeof item.content === 'string') {
+        return { id, role, content: item.content, createdAt };
+    }
+    const parts = [];
+    for (const c of item.content ?? []) {
+        if (typeof c !== 'object' || c === null)
+            continue;
+        const block = c;
+        // Both input (`input_text`) and output (`output_text`) text carry `text`.
+        if ((block.type === 'input_text' || block.type === 'output_text') && typeof block.text === 'string') {
+            parts.push({ type: 'text', text: block.text });
+        }
+        else if (block.type === 'refusal' && typeof block.refusal === 'string') {
+            parts.push({ type: 'text', text: block.refusal });
+        }
+        // Non-text content (image/audio/file) is not mapped.
+    }
+    // Collapse a lone text part to string content (the shape consumers wrote and
+    // the shape #464's history test asserts via `typeof content === 'string'`).
+    if (parts.length === 1 && parts[0].type === 'text') {
+        return { id, role, content: parts[0].text, createdAt };
+    }
+    return { id, role, content: parts, createdAt };
+}
+/** Join the `text` fields of a `reasoning` item's content array. */
+function readTextContent(content) {
+    if (typeof content === 'string' || content === undefined)
+        return typeof content === 'string' ? content : '';
+    return content
+        .map((c) => typeof c === 'object' && c !== null && typeof c.text === 'string'
+        ? c.text
+        : '')
+        .join('');
+}
+// ── Write path (addContext) ────────────────────────────────────────────────────
+/**
+ * Lower `Message[]` (already `createdAt`-backfilled by the caller) to
+ * {@link SessionRecord}s. Each message's parts expand to one or more flat items;
+ * every record inherits its source message's `createdAt`, so a message that
+ * expands to a `function_call` + `function_call_result` pair keeps them adjacent
+ * under the read-side stable sort (equal `createdAt` → insertion order).
+ */
+export function messagesToRecords(messages) {
+    const records = [];
+    for (const message of messages) {
+        if (message.createdAt === undefined) {
+            // Internal contract: the caller (`addContext`) runs the shared
+            // `backfillCreatedAt` before reaching this mapper, so every message
+            // carries a `createdAt`. Throwing here surfaces a missing-backfill
+            // bug at its real call site rather than persisting a record whose
+            // timestamp would break the `getMessages` ascending sort. Mirrors
+            // Mastra's `mapMessageToMastra` guard.
+            throw new AgentSDKError(`messagesToRecords: message "${message.id}" is missing createdAt (caller must backfill before mapping).`, AgentSDKErrorType.INVALID_MESSAGE_CONTENT);
+        }
+        const createdAt = message.createdAt.toISOString();
+        for (const record of messageToItems(message)) {
+            records.push({ ...record, createdAt });
+        }
+    }
+    return records;
+}
+/** Lower one message to flat items, dropping `createdAt` (added by the caller). */
+function messageToItems(message) {
+    if (typeof message.content === 'string') {
+        return [{ item: buildMessageItem(message.role, message.content) }];
+    }
+    const out = [];
+    const textRun = [];
+    const flushText = () => {
+        if (textRun.length === 0)
+            return;
+        out.push({ item: buildMessageItem(message.role, textRun.join('')) });
+        textRun.length = 0;
+    };
+    for (const part of message.content) {
+        switch (part.type) {
+            case 'text':
+                textRun.push(part.text);
+                break;
+            case 'reasoning':
+                flushText();
+                out.push({
+                    item: { type: 'reasoning', content: [{ type: 'input_text', text: part.text }] },
+                });
+                break;
+            case 'tool-call':
+                flushText();
+                out.push({
+                    item: {
+                        type: 'function_call',
+                        callId: part.toolCallId,
+                        name: part.toolName,
+                        arguments: JSON.stringify(part.args ?? {}),
+                        status: 'completed',
+                    },
+                });
+                break;
+            case 'tool-result':
+                flushText();
+                out.push({
+                    item: {
+                        type: 'function_call_result',
+                        callId: part.toolCallId,
+                        name: part.toolName,
+                        status: 'completed',
+                        output: toOutputString(part.result),
+                    },
+                    ...(part.isError === true ? { isError: true } : {}),
+                });
+                break;
+            case 'image':
+            case 'file':
+                throw new AgentSDKError(`The OpenAI harness does not yet support "${part.type}" message parts in addContext (multimodal is not yet implemented).`, AgentSDKErrorType.INVALID_MESSAGE_CONTENT);
+        }
+    }
+    flushText();
+    return out;
+}
+/** Build the message-shaped item for a role + plain text content. */
+function buildMessageItem(role, text) {
+    switch (role) {
+        case 'assistant':
+            return {
+                role: 'assistant',
+                status: 'completed',
+                content: [{ type: 'output_text', text }],
+            };
+        case 'system':
+            return { role: 'system', content: text };
+        case 'user':
+        case 'tool':
+            // A `role:'tool'` message carries only tool-result parts (handled
+            // above); its own text content, if any, lowers to a user turn so the
+            // model sees it. Plain user text is the common case.
+            return { role: 'user', content: text };
+    }
+}
+// ── Transcript rendering (compaction + conformance drift-guard) ────────────────
+/**
+ * Render a {@link MessagePart} as a plain-text transcript fragment. Byte-identical
+ * to the Mastra and Claude harnesses' copies — the shared
+ * `@salesforce/harness-conformance` `TRANSCRIPT_FIXTURES` table is the drift-guard
+ * (cross-harness imports are lint-blocked, so each harness keeps its own copy).
+ *
+ * Tool args/results render verbatim (the compaction char budget is the safety
+ * net, not per-part truncation). Image/file parts render as a size-aware
+ * placeholder and NEVER inline their base64 blob.
+ */
+export function partToTranscriptText(part) {
+    switch (part.type) {
+        case 'text':
+        case 'reasoning':
+            return part.text;
+        case 'tool-call': {
+            const argsStr = JSON.stringify(part.args);
+            return `[tool-call: ${part.toolName}(${argsStr})]`;
+        }
+        case 'tool-result': {
+            const resultStr = typeof part.result === 'string' ? part.result : JSON.stringify(part.result);
+            return `[tool-result: ${part.toolName} → ${resultStr}]`;
+        }
+        case 'image':
+        case 'file': {
+            const name = part.fileName ? `, name="${part.fileName}"` : '';
+            return `[${part.type}: ${part.mimeType}${name}, ~${formatApproxSize(part.data)}]`;
+        }
+    }
+}
+/**
+ * Approximate decoded size of base64 `data` as a short human-readable string
+ * (`768 B` / `1.2 KB` / `15.0 MB`). Uses the `length * 0.75` approximation the
+ * gateway SDK uses; the transcript only needs a ballpark, never the exact count.
+ */
+function formatApproxSize(base64Data) {
+    const bytes = Math.floor(base64Data.length * 0.75);
+    if (bytes < 1024)
+        return `${bytes} B`;
+    const kib = bytes / 1024;
+    if (kib < 1024)
+        return `${kib.toFixed(1)} KB`;
+    return `${(kib / 1024).toFixed(1)} MB`;
+}
+/**
+ * Maximum flattened-transcript length (in characters) sent to the model in a
+ * single `compactThread` summarization call. Transcripts above this size are
+ * split into roughly-equal chunks, each chunk is summarized separately, and the
+ * concatenated chunk-summaries are then summarized into the final summary.
+ *
+ * ~400k characters maps to ~100k tokens at a conservative 4:1 chars-per-token
+ * ratio, leaving headroom under typical 200k-token model context windows for the
+ * prompt scaffolding and the model's own response. A byte-identical copy of the
+ * Mastra and Claude harnesses' constant — cross-harness imports are lint-blocked,
+ * so each harness keeps its own copy.
+ */
+export const MAX_TRANSCRIPT_CHARS = 400_000;
+/**
+ * Splits a string into ≤ `maxChars`-sized chunks, preferring line boundaries so
+ * message turns are not torn across chunks. Falls back to a hard slice if a
+ * single line itself exceeds the budget. A byte-identical copy of the sibling
+ * harnesses' `splitIntoChunks` (drift-guarded socially, not by a shared table —
+ * the transcript conformance fixtures cover `partToTranscriptText`, not the
+ * chunker).
+ */
+export function splitIntoChunks(text, maxChars) {
+    const chunks = [];
+    const lines = text.split('\n');
+    let current = '';
+    for (const line of lines) {
+        if (line.length > maxChars) {
+            if (current.length > 0) {
+                chunks.push(current);
+                current = '';
+            }
+            for (let i = 0; i < line.length; i += maxChars) {
+                chunks.push(line.slice(i, i + maxChars));
+            }
+            continue;
+        }
+        const candidate = current.length === 0 ? line : current + '\n' + line;
+        if (candidate.length > maxChars) {
+            chunks.push(current);
+            current = line;
+        }
+        else {
+            current = candidate;
+        }
+    }
+    if (current.length > 0) {
+        chunks.push(current);
+    }
+    return chunks;
+}
+/** Parse a `function_call` item's JSON `arguments` string into an args object. */
+function parseArgs(raw) {
+    if (typeof raw !== 'string')
+        return {};
+    try {
+        const parsed = JSON.parse(raw);
+        return typeof parsed === 'object' && parsed !== null ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Normalize a `function_call_result` `output` (which the protocol types as
+ * `string | { type:'text'; text } | image | file | array`) to the value carried
+ * on the SDK `tool-result` part. A bare string or `{ type:'text' }` collapses to
+ * its text; any other structured shape passes through as-is (`result` is
+ * `unknown` on the SDK contract, so consumers keep whatever the tool produced).
+ */
+function normalizeToolOutput(output) {
+    if (typeof output === 'string')
+        return output;
+    if (typeof output === 'object' && output !== null && output.type === 'text') {
+        return output.text ?? '';
+    }
+    return output;
+}
+/** Coerce a `tool-result` part's `result` to the string `output` an item stores. */
+function toOutputString(result) {
+    return typeof result === 'string' ? result : JSON.stringify(result);
+}
+//# sourceMappingURL=openai-message-mapper.js.map

package/dist/openai-message-mapper.js.map

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

package/dist/openai-model-provider.d.ts

@@ -0,0 +1,46 @@
+import { type ModelProvider } from '@openai/agents';
+import { type Clock } from '@salesforce/agentic-common';
+import type { ModelConnectivityInfo, WireCommunicationEvent } from '@salesforce/sfdx-agent-sdk';
+/**
+ * Per-request wire-communication hooks. When supplied to
+ * {@link buildOpenAIModelProvider}, the custom fetch emits one
+ * {@link WireCommunicationEvent} `llm-request` before each outbound call and one
+ * `llm-response` after the upstream replies (or the call rejects). The harness
+ * forwards each event onto its `HarnessBusOwner.wireBus`, which is what
+ * `AgentManager.onWireCommunication` aggregates. Omit to disable emission
+ * entirely (zero cost — the fetch takes its plain header-merge path).
+ */
+export type WireHooks = {
+    /** Called once with each emitted event (the harness's disposal-guarded emitter). */
+    emitWireCommunication: (event: WireCommunicationEvent) => void;
+    /** Time source for the event `timestamp`s; defaults to a fresh `RealClock`. */
+    clock?: Clock;
+};
+/**
+ * Builds a `@openai/agents` {@link ModelProvider} bound to the live
+ * {@link ModelConnectivityInfo} bag.
+ *
+ * The provider constructs one `OpenAI` client pointed at `info.baseUrl` with a
+ * custom `fetch` that merges `await info.getHeaders()` into every outbound
+ * request — the per-request JWT-rotation seam.
+ * `getInfo` is read on each `getModel()` call so a within-shape `modelId` swap
+ * or JWT rotation between turns lands without rebuilding anything; the fetch
+ * wrapper additionally re-reads `getHeaders()` per HTTP call, so credential
+ * rotation lands on the next request even within a single turn.
+ *
+ * HTTP transport is pinned via {@link setOpenAIResponsesTransport} so the custom
+ * `fetch` is the only wire seam — a WebSocket transport would bypass the
+ * per-request header hook and auth would not rotate. That single wire seam is
+ * also where wire-communication events emit (when {@link WireHooks} is supplied).
+ *
+ * Mirrors the shipping Mastra `pass-through-openai.ts` connectivity seam; the
+ * only difference is that this harness hands the client to the OpenAI Agents
+ * SDK's own `OpenAIProvider` rather than wrapping it in a `LanguageModelV3`.
+ */
+export declare function buildOpenAIModelProvider(opts: {
+    getInfo: () => ModelConnectivityInfo;
+    /** Proxy-aware inner fetch from the factory (honors HTTPS_PROXY / NO_PROXY). */
+    innerFetch?: typeof fetch;
+    /** Wire-communication emission hooks. Omit to disable emission. */
+    wireHooks?: WireHooks;
+}): ModelProvider;

package/dist/openai-model-provider.js

@@ -0,0 +1,144 @@
+/*
+ * Copyright 2026, Salesforce, Inc. All rights reserved.
+ * See LICENSE.txt for license terms.
+ */
+import OpenAI from 'openai';
+import { OpenAIProvider, setOpenAIResponsesTransport } from '@openai/agents';
+import { RealClock } from '@salesforce/agentic-common';
+/**
+ * Builds a `@openai/agents` {@link ModelProvider} bound to the live
+ * {@link ModelConnectivityInfo} bag.
+ *
+ * The provider constructs one `OpenAI` client pointed at `info.baseUrl` with a
+ * custom `fetch` that merges `await info.getHeaders()` into every outbound
+ * request — the per-request JWT-rotation seam.
+ * `getInfo` is read on each `getModel()` call so a within-shape `modelId` swap
+ * or JWT rotation between turns lands without rebuilding anything; the fetch
+ * wrapper additionally re-reads `getHeaders()` per HTTP call, so credential
+ * rotation lands on the next request even within a single turn.
+ *
+ * HTTP transport is pinned via {@link setOpenAIResponsesTransport} so the custom
+ * `fetch` is the only wire seam — a WebSocket transport would bypass the
+ * per-request header hook and auth would not rotate. That single wire seam is
+ * also where wire-communication events emit (when {@link WireHooks} is supplied).
+ *
+ * Mirrors the shipping Mastra `pass-through-openai.ts` connectivity seam; the
+ * only difference is that this harness hands the client to the OpenAI Agents
+ * SDK's own `OpenAIProvider` rather than wrapping it in a `LanguageModelV3`.
+ */
+export function buildOpenAIModelProvider(opts) {
+    const { getInfo, innerFetch, wireHooks } = opts;
+    // Pin the HTTP transport (never WebSocket) so the custom `fetch` below is the
+    // connectivity seam. Idempotent and safe to call per provider construction.
+    setOpenAIResponsesTransport('http');
+    return {
+        getModel(modelName) {
+            const info = getInfo();
+            const client = new OpenAI({
+                baseURL: info.baseUrl,
+                // The custom fetch injects the resolver-built `Authorization` header
+                // per request. The SDK still wants a non-empty `apiKey`; passing an
+                // opaque sentinel keeps it from reading `process.env['OPENAI_API_KEY']`.
+                apiKey: 'salesforce-gateway-passthrough',
+                fetch: buildGatewayFetch(getInfo, innerFetch, wireHooks),
+            });
+            const provider = new OpenAIProvider({ openAIClient: client });
+            // Prefer the caller-requested model name (the run loop passes the
+            // agent's configured model); fall back to the live bag's native id.
+            return provider.getModel(modelName ?? info.nativeModelId);
+        },
+    };
+}
+/** Bounds `llm-request` body capture so a large payload can't blow a consumer's log budget. */
+const TRACE_BODY_BYTE_BUDGET = 256 * 1024;
+/**
+ * Returns a `fetch` that merges the resolver's fresh headers into every
+ * outbound request. `getHeaders()` is re-evaluated per call so JWT rotation /
+ * premium-rate-limit gate flips land on the next request without rebuilding the
+ * client. Delegates to the proxy-aware `innerFetch` when supplied (so
+ * `HTTPS_PROXY` is honored), else the global `fetch`.
+ *
+ * When `wireHooks` is supplied, every outbound call emits one `llm-request`
+ * event before the fetch and one `llm-response` after it resolves — or, on a
+ * transport failure, an `llm-response` with `status: 0` + the captured error,
+ * then rethrows (a wire hook never swallows the underlying fetch). Body capture
+ * is best-effort and bounded ({@link TRACE_BODY_BYTE_BUDGET}); a decode failure
+ * never blocks the call.
+ */
+function buildGatewayFetch(getInfo, innerFetch, wireHooks) {
+    const baseFetch = innerFetch ?? fetch;
+    return (async (input, init) => {
+        const info = getInfo();
+        const fresh = await info.getHeaders();
+        const headers = new Headers(init?.headers);
+        for (const [key, value] of Object.entries(fresh)) {
+            if (value != null)
+                headers.set(key, value);
+        }
+        const finalInit = { ...init, headers };
+        if (wireHooks === undefined) {
+            return baseFetch(input, finalInit);
+        }
+        const url = typeof input === 'string' ? input : input instanceof URL ? input.toString() : input.url;
+        const method = (finalInit.method ?? 'GET').toUpperCase();
+        const model = info.nativeModelId;
+        const clock = wireHooks.clock ?? new RealClock();
+        const requestStart = performance.now();
+        const body = tryDecodeBody(finalInit.body);
+        wireHooks.emitWireCommunication({
+            type: 'llm-request',
+            timestamp: clock.now(),
+            url,
+            method,
+            model,
+            ...(body !== undefined ? { body } : {}),
+        });
+        try {
+            const response = await baseFetch(input, finalInit);
+            wireHooks.emitWireCommunication({
+                type: 'llm-response',
+                timestamp: clock.now(),
+                model,
+                status: response.status,
+                totalDurationMs: Math.round(performance.now() - requestStart),
+                xClientTraceId: response.headers.get('x-client-trace-id') ?? undefined,
+            });
+            return response;
+        }
+        catch (error) {
+            wireHooks.emitWireCommunication({
+                type: 'llm-response',
+                timestamp: clock.now(),
+                model,
+                status: 0,
+                error: error instanceof Error ? error : new Error(String(error)),
+                totalDurationMs: Math.round(performance.now() - requestStart),
+            });
+            throw error;
+        }
+    });
+}
+/**
+ * Best-effort decode of a request body for the `llm-request` event. Only string
+ * bodies are decoded (streams / FormData / Blob are skipped); a body over
+ * {@link TRACE_BODY_BYTE_BUDGET} is recorded as `{ truncated, byteLength }`
+ * rather than parsed. Returns `undefined` when there's nothing worth capturing.
+ */
+function tryDecodeBody(body) {
+    if (body === undefined || body === null)
+        return undefined;
+    if (typeof body !== 'string')
+        return undefined;
+    const byteLength = Buffer.byteLength(body, 'utf8');
+    if (byteLength > TRACE_BODY_BYTE_BUDGET) {
+        return { truncated: true, byteLength };
+    }
+    try {
+        const parsed = JSON.parse(body);
+        return typeof parsed === 'object' && parsed !== null ? parsed : { value: parsed };
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=openai-model-provider.js.map