@myagentroam/agent 0.11.33 → 0.11.35

package/dist/agent-core/model/openai-responses.js

@@ -1,2123 +0,0 @@
-import { observeModelRequestUsage } from './usage-observer.js';
-import { observationModelParts } from '../tools/code-mode/observations.js';
-import { modelImageKey, modelImageUrl } from './image.js';
-import { stableToolSchema } from '../tools/definition-projection.js';
-import { isDeepStrictEqual } from 'node:util';
-import { createHash, randomUUID } from 'node:crypto';
-import { describeMarAgentError, MarAgentError } from '../error.js';
-import { assertInlineMediaBudget } from '../session/inline-media.js';
-import { marAgentReasoningEffortSchema, resolveModelDefaultReasoningEffort, usesResponsesConfigurationUpdates } from './configuration.js';
-import WebSocket from 'ws';
-import { isRetryableUpstreamOverloadCode, number, parseSse, record, text, observeModelStreamEvent, modelStreamEventObservedAt } from './sse.js';
-import { connectSocks5Target, fetchModelResponse, isRetryableModelHttpStatus, isRetryableModelTransportError, modelRetryMaxAttempts, isRetryableModelRequestError, modelRetryDelay, waitForModelRetry } from './http.js';
-import { acquireModelCredential, appendModelCredentialHeaders, modelCredentialSensitiveValues } from './runtime-credential.js';
-import { resolveModelTextBlocks } from './text-blocks.js';
-import { jsonToolInput } from './tool-input.js';
-import { reportModelAttempt } from './attempt-diagnostics.js';
-import { productUserAgent } from './product-user-agent.js';
-const WEBSOCKET_IDLE_TIMEOUT_MS = 300_000;
-const WEBSOCKET_SEND_FRAME_BYTES = 1024 * 1024;
-export const OPENAI_RESPONSES_EARLY_EOF_REASON = 'OPENAI_RESPONSES_EARLY_EOF';
-export const OPENAI_RESPONSES_WEBSOCKET_CONNECTION_LIMIT_REASON = 'OPENAI_RESPONSES_WEBSOCKET_CONNECTION_LIMIT';
-const X_CODEX_TURN_STATE = 'x-codex-turn-state';
-export class OpenAiResponsesAdapter {
-    #cachedState = {};
-    #cacheLeased = false;
-    #closed = false;
-    #configuration;
-    constructor(configuration) {
-        this.#configuration = configuration;
-    }
-    get configuration() {
-        return this.#configuration;
-    }
-    prepareReconfigure(configuration) {
-        if (!sameResponsesAdapterConfiguration(this.#configuration, configuration))
-            return undefined;
-        return () => {
-            this.#configuration = configuration;
-        };
-    }
-    async *start(request, signal) {
-        const turn = new OpenAiResponsesTurnSession(this, {}, false);
-        try {
-            yield* turn.start(request, signal);
-        }
-        finally {
-            await turn.close();
-        }
-    }
-    createTurnSession() {
-        if (this.#closed)
-            throw new MarAgentError('MAR_AGENT_DISPOSED', 'Model adapter is disposed.');
-        const cacheLease = !this.#cacheLeased;
-        const state = cacheLease ? this.#cachedState : {};
-        if (cacheLease) {
-            this.#cachedState = {};
-            this.#cacheLeased = true;
-        }
-        return new OpenAiResponsesTurnSession(this, state, cacheLease);
-    }
-    async close() {
-        if (this.#closed)
-            return;
-        this.#closed = true;
-        invalidateResponsesWebSocket(this.#cachedState, true);
-    }
-    releaseTurnSession(state, cacheLease) {
-        if (!cacheLease || this.#closed) {
-            invalidateResponsesWebSocket(state, true);
-            return;
-        }
-        if (state.socket !== undefined && state.socket.readyState !== WebSocket.OPEN) {
-            invalidateResponsesWebSocket(state, false);
-            clearResponsesContinuation(state);
-        }
-        this.#cachedState = state;
-        this.#cacheLeased = false;
-    }
-    async *startTurn(request, signal, turn, prepared) {
-        let useContinuation = prepared.continuation;
-        let requestBody = prepared.body;
-        let credentialReason = 'REQUEST';
-        let unauthorizedRetryUsed = false;
-        let invalidContinuationFallbackUsed = false;
-        const retryState = request.retryState ?? { attempts: 0 };
-        const maxAttempts = modelRetryMaxAttempts(retryState);
-        let resetOutputTiming = false;
-        while (retryState.attempts < maxAttempts) {
-            if (resetOutputTiming)
-                yield { type: 'output.reset' };
-            resetOutputTiming = false;
-            const attempt = retryState.attempts++;
-            const attemptNumber = attempt + 1;
-            const attemptStartedAt = Date.now();
-            const attemptContinuation = useContinuation;
-            const attemptCredentialReason = credentialReason;
-            const attemptTransport = this.configuration.responsesTransport?.transport === 'WEBSOCKET' ? 'WEBSOCKET' : 'HTTP';
-            const requestPrefixDiagnostic = request.onAttemptDiagnostic
-                ? {
-                    requestInputItems: prepared.inputItemCount
-                }
-                : {};
-            const prelude = [];
-            let sawSemanticEvent = false;
-            let firstSemanticEventType;
-            turn.beginAttempt();
-            await reportModelAttempt(request, {
-                protocol: 'OPENAI_RESPONSES',
-                transport: attemptTransport,
-                state: 'STARTED',
-                attempt: attemptNumber,
-                maxAttempts,
-                continuation: attemptContinuation,
-                credentialReason: attemptCredentialReason,
-                ...requestPrefixDiagnostic
-            });
-            try {
-                for await (const event of observeModelRequestUsage(() => this.startAttempt(request, signal, requestBody, useContinuation, credentialReason, turn), request, this.configuration, signal)) {
-                    if (event.type.startsWith('output.')) {
-                        resetOutputTiming = true;
-                        yield event;
-                        continue;
-                    }
-                    if (!sawSemanticEvent && !isSemanticEvent(event)) {
-                        prelude.push(event);
-                        continue;
-                    }
-                    if (!sawSemanticEvent) {
-                        sawSemanticEvent = true;
-                        firstSemanticEventType = event.type;
-                        for (const pending of prelude)
-                            yield pending;
-                        prelude.length = 0;
-                    }
-                    yield event;
-                }
-                await reportModelAttempt(request, {
-                    protocol: 'OPENAI_RESPONSES',
-                    transport: attemptTransport,
-                    state: 'SUCCEEDED',
-                    attempt: attemptNumber,
-                    maxAttempts,
-                    continuation: attemptContinuation,
-                    credentialReason: attemptCredentialReason,
-                    ...requestPrefixDiagnostic,
-                    semanticEventObserved: sawSemanticEvent,
-                    ...(firstSemanticEventType === undefined ? {} : { firstSemanticEventType }),
-                    ...turn.connectionDiagnostic(),
-                    durationMs: Math.max(0, Date.now() - attemptStartedAt)
-                });
-                return;
-            }
-            catch (error) {
-                const reportFailure = async (willRetry, options = {}) => reportModelAttempt(request, {
-                    protocol: 'OPENAI_RESPONSES',
-                    transport: attemptTransport,
-                    state: 'FAILED',
-                    attempt: attemptNumber,
-                    maxAttempts,
-                    continuation: attemptContinuation,
-                    credentialReason: attemptCredentialReason,
-                    ...requestPrefixDiagnostic,
-                    semanticEventObserved: sawSemanticEvent,
-                    ...(firstSemanticEventType === undefined ? {} : { firstSemanticEventType }),
-                    ...turn.connectionDiagnostic(),
-                    durationMs: Math.max(0, Date.now() - attemptStartedAt),
-                    ...openAiResponsesAttemptError(error),
-                    willRetry,
-                    ...(options.retryDelayMs === undefined ? {} : { retryDelayMs: options.retryDelayMs }),
-                    ...(options.retryReason === undefined ? {} : { retryReason: options.retryReason })
-                });
-                if (!signal.aborted &&
-                    !sawSemanticEvent &&
-                    useContinuation &&
-                    !invalidContinuationFallbackUsed &&
-                    isLocalContinuationReset(error)) {
-                    invalidContinuationFallbackUsed = true;
-                    useContinuation = false;
-                    requestBody = prepared.fullBody;
-                    turn.resetContinuation();
-                    turn.invalidateWebSocket();
-                    retryState.attempts = Math.max(0, retryState.attempts - 1);
-                    credentialReason = 'RECONNECT';
-                    await reportFailure(true, {
-                        retryDelayMs: 0,
-                        retryReason: 'INVALID_CONTINUATION'
-                    });
-                    continue;
-                }
-                if (!signal.aborted &&
-                    attemptNumber < maxAttempts &&
-                    !sawSemanticEvent &&
-                    useContinuation &&
-                    !invalidContinuationFallbackUsed &&
-                    isInvalidPreviousResponseError(error)) {
-                    invalidContinuationFallbackUsed = true;
-                    useContinuation = false;
-                    requestBody = prepared.fullBody;
-                    turn.resetContinuation();
-                    turn.invalidateWebSocket();
-                    credentialReason = 'RECONNECT';
-                    await reportFailure(true, {
-                        retryDelayMs: 0,
-                        retryReason: 'INVALID_CONTINUATION'
-                    });
-                    continue;
-                }
-                if (!signal.aborted &&
-                    attemptNumber < maxAttempts &&
-                    !sawSemanticEvent &&
-                    !unauthorizedRetryUsed &&
-                    this.configuration.credentialProvider !== undefined &&
-                    isModelAuthenticationFailure(error)) {
-                    const revision = credentialRevision(error);
-                    if (revision !== undefined)
-                        await this.configuration.credentialProvider.invalidate(revision);
-                    unauthorizedRetryUsed = true;
-                    credentialReason = 'UNAUTHORIZED';
-                    await reportFailure(true, {
-                        retryDelayMs: 0,
-                        retryReason: 'UNAUTHORIZED'
-                    });
-                    continue;
-                }
-                const willRetry = !(signal.aborted ||
-                    (sawSemanticEvent && request.retryState === undefined) ||
-                    !(isRetryableModelRequestError(error) || isOpenAiResponsesRecoverableStreamError(error)) ||
-                    attemptNumber >= maxAttempts);
-                if (!willRetry) {
-                    await reportFailure(false);
-                    throw error;
-                }
-                const delayMs = modelRetryDelay(retryAfter(error), attempt);
-                await reportFailure(true, {
-                    retryDelayMs: delayMs,
-                    retryReason: 'STREAM'
-                });
-                if (sawSemanticEvent) {
-                    retryState.retryDelayMs = delayMs;
-                    throw error;
-                }
-                credentialReason =
-                    error instanceof MarAgentError && error.details?.transport === 'WEBSOCKET'
-                        ? 'RECONNECT'
-                        : 'REQUEST';
-                useContinuation = false;
-                requestBody = prepared.fullBody;
-                if (error instanceof MarAgentError && error.details?.transport === 'WEBSOCKET')
-                    turn.invalidateWebSocket();
-                await waitForModelRetry(retryAfter(error), attempt, signal, delayMs);
-            }
-        }
-    }
-    async *startAttempt(request, signal, body, continuation, credentialReason, turn) {
-        let latestCredentialRevision;
-        let diagnosticSecrets = [];
-        const fetchResponse = async (requestBody) => {
-            const serializedBody = JSON.stringify(requestBody);
-            return await fetchModelResponse(responsesEndpoint(this.configuration.baseUrl), async () => {
-                const credential = await acquireResponsesCredential(this.configuration, credentialReason, signal);
-                latestCredentialRevision = credential.revision;
-                diagnosticSecrets = modelCredentialSensitiveValues(credential);
-                return {
-                    request: {
-                        method: 'POST',
-                        headers: responsesHeaders(credential, request.promptCacheKey, turn.currentTurnState()),
-                        body: serializedBody,
-                        redirect: 'manual'
-                    },
-                    httpVersion: this.configuration.responsesTransport?.transport === 'HTTP'
-                        ? this.configuration.responsesTransport.httpVersion
-                        : '1.1',
-                    ...(credential.socks5Url === undefined
-                        ? {}
-                        : { socks5Url: credential.socks5Url.reveal() })
-                };
-            }, signal, 1);
-        };
-        let response;
-        let rawEvents;
-        try {
-            if (this.configuration.responsesTransport?.transport === 'WEBSOCKET')
-                rawEvents = webSocketResponseEvents({
-                    configuration: this.configuration,
-                    body,
-                    promptCacheKey: request.promptCacheKey,
-                    reason: credentialReason,
-                    signal,
-                    continuation,
-                    turn,
-                    credentialAcquired: (revision) => (latestCredentialRevision = revision)
-                });
-            else {
-                response = await fetchResponse(body);
-                turn.captureTurnState(response.headers.get(X_CODEX_TURN_STATE));
-                rawEvents = parseOpenAiResponsesSse(response, signal, continuation, diagnosticSecrets);
-            }
-        }
-        catch (error) {
-            if (this.configuration.responsesTransport?.transport === 'WEBSOCKET')
-                turn.invalidateWebSocket();
-            throw withCredentialRevision(withResponsesAttemptDetails(error, continuation, this.configuration.responsesTransport?.transport), latestCredentialRevision);
-        }
-        let completed = false;
-        const functionCalls = new Map();
-        const customCalls = new Map();
-        const textPhases = new Map();
-        const pendingCompletedText = new Map();
-        const emittedCompletedText = new Set();
-        const emittedReasoning = new Set();
-        const emittedFunctionCalls = new Set();
-        const hostedWebCalls = new Map();
-        try {
-            for await (const raw of rawEvents) {
-                const event = record(raw);
-                const type = text(event.type) ?? 'unknown';
-                if (type === 'response.output_item.added' &&
-                    ['reasoning', 'message', 'function_call', 'custom_tool_call'].includes(text(record(event.item).type) ?? ''))
-                    yield observeModelStreamEvent({ type: 'output.started' }, modelStreamEventObservedAt(raw));
-                if (type === 'response.web_search_call.searching')
-                    yield observeModelStreamEvent({ type: 'output.paused' }, modelStreamEventObservedAt(raw));
-                if (type === 'response.output_item.done') {
-                    const item = responseItem(event.item);
-                    if (item)
-                        yield observeModelStreamEvent({ type: 'response.item', provider: 'OPENAI_RESPONSES', item }, modelStreamEventObservedAt(raw));
-                }
-                if (type === 'response.output_item.added' && text(record(event.item).type) === 'message') {
-                    const item = record(event.item);
-                    const itemId = text(item.id);
-                    const phase = messagePhase(item.phase);
-                    if (itemId && phase)
-                        textPhases.set(itemId, phase);
-                }
-                else if (type === 'response.output_item.done' &&
-                    text(record(event.item).type) === 'message') {
-                    const item = record(event.item);
-                    const itemId = text(item.id) ?? text(event.item_id) ?? 'text';
-                    const phase = messagePhase(item.phase) ?? textPhases.get(itemId) ?? 'final_answer';
-                    textPhases.set(itemId, phase);
-                    const completedText = pendingCompletedText.get(itemId) ?? responseMessageText(item);
-                    if (completedText !== undefined && !emittedCompletedText.has(itemId)) {
-                        emittedCompletedText.add(itemId);
-                        pendingCompletedText.delete(itemId);
-                        yield observeModelStreamEvent({ type: 'text.completed', itemId, phase, text: completedText }, modelStreamEventObservedAt(raw));
-                    }
-                }
-                else if (type === 'response.output_item.added' &&
-                    text(record(event.item).type) === 'function_call') {
-                    const item = record(event.item);
-                    const itemId = text(item.id);
-                    if (itemId)
-                        functionCalls.set(itemId, {
-                            callId: text(item.call_id) ?? itemId,
-                            name: text(item.name) ?? 'unknown'
-                        });
-                }
-                else if (type === 'response.output_item.added' &&
-                    text(record(event.item).type) === 'custom_tool_call') {
-                    const item = record(event.item);
-                    const itemId = text(item.id);
-                    if (itemId)
-                        customCalls.set(itemId, {
-                            callId: text(item.call_id) ?? itemId,
-                            name: text(item.name) ?? 'unknown',
-                            input: text(item.input) ?? ''
-                        });
-                }
-                else if ((type === 'response.output_item.added' || type === 'response.output_item.done') &&
-                    text(record(event.item).type) === 'reasoning') {
-                    // Native reasoning context is retained above; its lifecycle is not visible output.
-                    continue;
-                }
-                else if (type === 'response.custom_tool_call_input.delta') {
-                    const itemId = text(event.item_id) ?? '';
-                    const known = customCalls.get(itemId);
-                    const delta = text(event.delta) ?? '';
-                    if (known)
-                        known.input += delta;
-                    if (delta.length > 0)
-                        yield observeModelStreamEvent({ type: 'output.delta' }, modelStreamEventObservedAt(raw));
-                }
-                else if (type === 'response.function_call_arguments.delta' ||
-                    type === 'response.reasoning_text.delta' ||
-                    type === 'response.reasoning_summary_text.delta') {
-                    if ((text(event.delta)?.length ?? 0) > 0)
-                        yield observeModelStreamEvent({ type: 'output.delta' }, modelStreamEventObservedAt(raw));
-                }
-                else if (type === 'response.created')
-                    yield observeModelStreamEvent({
-                        type: 'response.started',
-                        responseId: responseEventId(event) ?? 'unknown',
-                        ...(text(record(event.response).model)
-                            ? { modelId: text(record(event.response).model) }
-                            : {})
-                    }, modelStreamEventObservedAt(raw));
-                else if (type === 'response.output_text.delta')
-                    yield observeModelStreamEvent({
-                        type: 'text.delta',
-                        itemId: text(event.item_id) ?? 'text',
-                        phase: messagePhase(event.phase) ??
-                            textPhases.get(text(event.item_id) ?? '') ??
-                            'commentary',
-                        delta: text(event.delta) ?? ''
-                    }, modelStreamEventObservedAt(raw));
-                else if (type === 'response.output_text.done') {
-                    const itemId = text(event.item_id) ?? 'text';
-                    const completedText = text(event.text) ?? '';
-                    const phase = messagePhase(event.phase) ?? textPhases.get(itemId);
-                    if (emittedCompletedText.has(itemId))
-                        continue;
-                    if (phase) {
-                        emittedCompletedText.add(itemId);
-                        yield observeModelStreamEvent({ type: 'text.completed', itemId, phase, text: completedText }, modelStreamEventObservedAt(raw));
-                    }
-                    else
-                        pendingCompletedText.set(itemId, completedText);
-                }
-                else if (type === 'response.reasoning_summary_text.done') {
-                    const itemId = JSON.stringify([
-                        text(event.item_id) ?? `reasoning-${event.output_index ?? 0}`,
-                        event.summary_index ?? 0
-                    ]);
-                    const summary = text(event.text) ?? '';
-                    if (!summary.trim() || emittedReasoning.has(itemId))
-                        continue;
-                    emittedReasoning.add(itemId);
-                    yield observeModelStreamEvent({
-                        type: 'reasoning.completed',
-                        itemId,
-                        representation: 'summary',
-                        text: summary
-                    }, modelStreamEventObservedAt(raw));
-                }
-                else if (type === 'response.output_item.done' &&
-                    text(record(event.item).type) === 'tool_search_call') {
-                    const item = record(event.item);
-                    const callId = text(item.call_id) ?? text(item.id) ?? 'unknown';
-                    let arguments_ = item.arguments ?? {};
-                    let argumentError;
-                    if (typeof arguments_ === 'string')
-                        try {
-                            arguments_ = JSON.parse(arguments_);
-                        }
-                        catch {
-                            argumentError = 'Tool Search arguments are invalid JSON.';
-                        }
-                    if (!emittedFunctionCalls.has(callId)) {
-                        emittedFunctionCalls.add(callId);
-                        yield observeModelStreamEvent({
-                            type: 'client_tool.call',
-                            callId,
-                            name: 'tool_search',
-                            arguments: arguments_,
-                            ...(argumentError ? { argumentError } : {})
-                        }, modelStreamEventObservedAt(raw));
-                    }
-                }
-                else if (type === 'response.function_call_arguments.done' ||
-                    (type === 'response.output_item.done' &&
-                        text(record(event.item).type) === 'function_call')) {
-                    const item = record(event.item);
-                    const known = functionCalls.get(text(event.item_id) ?? text(item.id) ?? '');
-                    let args = {};
-                    let argumentError;
-                    try {
-                        args = JSON.parse(text(event.arguments) ?? text(item.arguments) ?? '{}');
-                    }
-                    catch {
-                        argumentError = 'Function arguments are invalid JSON.';
-                    }
-                    const callId = text(event.call_id) ??
-                        text(item.call_id) ??
-                        known?.callId ??
-                        text(event.item_id) ??
-                        text(item.id) ??
-                        'unknown';
-                    if (!emittedFunctionCalls.has(callId)) {
-                        emittedFunctionCalls.add(callId);
-                        yield observeModelStreamEvent({
-                            type: 'client_tool.call',
-                            callId,
-                            name: text(event.name) ?? text(item.name) ?? known?.name ?? 'unknown',
-                            arguments: args,
-                            ...(argumentError ? { argumentError } : {})
-                        }, modelStreamEventObservedAt(raw));
-                    }
-                }
-                else if (type === 'response.custom_tool_call_input.done' ||
-                    (type === 'response.output_item.done' &&
-                        text(record(event.item).type) === 'custom_tool_call')) {
-                    const item = record(event.item);
-                    const itemId = text(event.item_id) ?? text(item.id) ?? '';
-                    const known = customCalls.get(itemId);
-                    const callId = text(event.call_id) ?? text(item.call_id) ?? known?.callId ?? itemId;
-                    if (!emittedFunctionCalls.has(callId)) {
-                        emittedFunctionCalls.add(callId);
-                        yield observeModelStreamEvent({
-                            type: 'client_tool.call',
-                            callId,
-                            name: text(event.name) ?? text(item.name) ?? known?.name ?? 'unknown',
-                            arguments: text(event.input) ?? text(item.input) ?? known?.input ?? '',
-                            inputMode: 'freeform'
-                        }, modelStreamEventObservedAt(raw));
-                    }
-                }
-                else if (type.includes('web_search_call') ||
-                    text(record(event.item).type) === 'web_search_call') {
-                    const item = record(event.item);
-                    const itemId = text(event.item_id) ?? text(item.id) ?? 'web';
-                    const previous = hostedWebCalls.get(itemId);
-                    const action = record(Object.keys(record(event.action)).length ? event.action : item.action);
-                    const actionType = text(action.type);
-                    const kind = actionType === 'open_page' || actionType === 'find_in_page'
-                        ? 'WEB_FETCH'
-                        : (previous?.kind ?? 'WEB_SEARCH');
-                    const summary = { ...previous?.summary, ...hostedWebActionSummary(action) };
-                    const projected = hostedWebActionInput(action);
-                    const input = { ...previous?.input, ...projected.input };
-                    const truncated = previous?.truncated === true || projected.truncated;
-                    hostedWebCalls.set(itemId, { kind, summary, input, truncated });
-                    const output = {
-                        ...(summary.title === undefined ? {} : { title: summary.title }),
-                        ...(summary.sources === undefined ? {} : { sources: summary.sources }),
-                        ...(summary.sourcesTruncated === undefined
-                            ? {}
-                            : { sourcesTruncated: summary.sourcesTruncated })
-                    };
-                    yield observeModelStreamEvent({
-                        type: 'hosted_tool',
-                        itemId,
-                        kind,
-                        toolName: 'web_search',
-                        ...(Object.keys(input).length ? { input } : {}),
-                        ...(Object.keys(output).length ? { output } : {}),
-                        ...(truncated || summary.sourcesTruncated === true ? { truncated: true } : {}),
-                        status: type.endsWith('.failed')
-                            ? 'FAILED'
-                            : type.endsWith('.completed') || type === 'response.output_item.done'
-                                ? 'COMPLETED'
-                                : 'RUNNING',
-                        summary
-                    }, modelStreamEventObservedAt(raw));
-                }
-                else if (type === 'response.output_text.annotation.added') {
-                    const annotation = record(event.annotation);
-                    const url = text(annotation.url);
-                    if (url)
-                        yield observeModelStreamEvent({
-                            type: 'citation',
-                            citation: {
-                                id: text(annotation.id) ??
-                                    `${text(event.item_id) ?? 'text'}-${number(event.annotation_index) ?? 0}`,
-                                url,
-                                ...(text(annotation.title) ? { title: text(annotation.title) } : {})
-                            }
-                        }, modelStreamEventObservedAt(raw));
-                }
-                else if (type === 'response.completed' || type === 'response.incomplete') {
-                    yield observeModelStreamEvent({ type: 'output.completed' }, modelStreamEventObservedAt(raw));
-                    const responseData = record(event.response);
-                    if (type === 'response.completed')
-                        turn.captureCompletedResponseId(responseEventId(event));
-                    for (const [itemId, completedText] of pendingCompletedText) {
-                        if (emittedCompletedText.has(itemId))
-                            continue;
-                        emittedCompletedText.add(itemId);
-                        yield observeModelStreamEvent({
-                            type: 'text.completed',
-                            itemId,
-                            phase: textPhases.get(itemId) ?? 'final_answer',
-                            text: completedText
-                        }, modelStreamEventObservedAt(raw));
-                    }
-                    pendingCompletedText.clear();
-                    for (const citation of responseCitations(responseData))
-                        yield observeModelStreamEvent({ type: 'citation', citation }, modelStreamEventObservedAt(raw));
-                    const usage = record(responseData.usage);
-                    const inputDetails = record(usage.input_tokens_details);
-                    const rolloutBudgetUnits = optionalRolloutBudgetUnits(usage.codex_rollout_budget_units);
-                    yield observeModelStreamEvent({
-                        type: 'usage',
-                        final: true,
-                        usage: {
-                            inputTokens: number(usage.input_tokens),
-                            totalInputTokens: number(usage.input_tokens),
-                            reasoningTokens: number(record(usage.output_tokens_details).reasoning_tokens),
-                            contextInputTokens: number(usage.input_tokens),
-                            outputTokens: number(usage.output_tokens),
-                            cacheReadTokens: number(inputDetails.cached_tokens),
-                            cacheWriteTokens: number(inputDetails.cache_write_tokens),
-                            ...(rolloutBudgetUnits === undefined ? {} : { rolloutBudgetUnits })
-                        }
-                    }, modelStreamEventObservedAt(raw));
-                    yield observeModelStreamEvent({
-                        type: 'completed',
-                        reason: type === 'response.incomplete' ? 'max_output' : 'completed'
-                    }, modelStreamEventObservedAt(raw));
-                    completed = true;
-                }
-                else if (type === 'error' ||
-                    type === 'response.failed' ||
-                    (event.type === undefined && event.error !== undefined)) {
-                    const topLevel = record(event.error);
-                    const nested = record(record(event.response).error);
-                    const code = boundedError(text(event.code) ??
-                        text(topLevel.code) ??
-                        text(topLevel.type) ??
-                        text(nested.code) ??
-                        text(nested.type), 80);
-                    const message = boundedError(text(event.message) ??
-                        text(topLevel.message) ??
-                        text(nested.message) ??
-                        text(event.error), 1_000);
-                    const status = upstreamHttpStatus(event.status, topLevel.status, record(event.response).status, nested.status);
-                    const connectionLimit = this.configuration.responsesTransport?.transport === 'WEBSOCKET' &&
-                        isWebSocketConnectionLimitCode(code);
-                    const retryable = connectionLimit || isRetryableResponsesUpstreamError(code, message);
-                    throw new MarAgentError(code ?? 'MAR_AGENT_MODEL_PROTOCOL_ERROR', message ?? 'OpenAI Responses request failed.', {
-                        details: {
-                            ...(status === undefined ? {} : { status }),
-                            ...(connectionLimit
-                                ? { reason: OPENAI_RESPONSES_WEBSOCKET_CONNECTION_LIMIT_REASON }
-                                : {}),
-                            ...(retryable ? { retryAfter: response?.headers.get('retry-after') ?? null } : {}),
-                            continuation,
-                            ...(this.configuration.responsesTransport?.transport === 'WEBSOCKET'
-                                ? { transport: 'WEBSOCKET' }
-                                : {})
-                        },
-                        ...(retryable ? { retryable: true } : {})
-                    });
-                }
-                else if (!isNonSemanticOpenAiResponsesEvent(type))
-                    yield observeModelStreamEvent({ type: 'unknown', nativeType: type }, modelStreamEventObservedAt(raw));
-            }
-        }
-        catch (error) {
-            if (this.configuration.responsesTransport?.transport === 'WEBSOCKET')
-                turn.invalidateWebSocket();
-            throw withCredentialRevision(withResponsesAttemptDetails(error, continuation, this.configuration.responsesTransport?.transport), latestCredentialRevision);
-        }
-        if (!completed)
-            throw new MarAgentError('MAR_AGENT_MODEL_PROTOCOL_ERROR', 'OpenAI Responses stream ended without a terminal event.', {
-                details: {
-                    reason: OPENAI_RESPONSES_EARLY_EOF_REASON,
-                    retryAfter: response?.headers.get('retry-after') ?? null,
-                    continuation,
-                    ...(this.configuration.responsesTransport?.transport === 'WEBSOCKET'
-                        ? { transport: 'WEBSOCKET' }
-                        : {})
-                },
-                retryable: true
-            });
-    }
-}
-function sameResponsesAdapterConfiguration(current, next) {
-    const { apiKey: currentApiKey, credentialProvider: currentCredentialProvider, ...currentTransport } = current;
-    const { apiKey: nextApiKey, credentialProvider: nextCredentialProvider, ...nextTransport } = next;
-    const credentialsAreRebindable = (currentCredentialProvider !== undefined && nextCredentialProvider !== undefined) ||
-        (currentApiKey !== undefined &&
-            nextApiKey !== undefined &&
-            currentApiKey.reveal() === nextApiKey.reveal());
-    return credentialsAreRebindable && isDeepStrictEqual(currentTransport, nextTransport);
-}
-class OpenAiResponsesTurnSession {
-    adapter;
-    state;
-    cacheLease;
-    #active = false;
-    #closed = false;
-    #turnState;
-    #completedResponseId;
-    #connectionDiagnostic;
-    #webSocketDiagnostic;
-    constructor(adapter, state, cacheLease) {
-        this.adapter = adapter;
-        this.state = state;
-        this.cacheLease = cacheLease;
-    }
-    async *start(request, signal) {
-        if (this.#closed)
-            throw new MarAgentError('MAR_AGENT_DISPOSED', 'Model turn session is disposed.');
-        if (this.#active)
-            throw new MarAgentError('MAR_AGENT_MODEL_PROTOCOL_ERROR', 'Model turn session already has an active request.');
-        this.#active = true;
-        let responseId;
-        const outputItems = [];
-        let completed = false;
-        let sawUnrepresentedOutput = false;
-        let outputMessageCount = 0;
-        try {
-            const prepared = this.prepareRequest(request);
-            this.#completedResponseId = undefined;
-            for await (const event of this.adapter.startTurn(request, signal, this, prepared)) {
-                if (event.type === 'response.item' ||
-                    event.type === 'text.completed' ||
-                    event.type === 'client_tool.call')
-                    outputMessageCount++;
-                if (event.type === 'response.started' && event.responseId !== 'unknown')
-                    responseId = event.responseId;
-                else if (event.type === 'response.item')
-                    outputItems.push(JSON.parse(JSON.stringify(event.item)));
-                else if (event.type === 'text.delta' ||
-                    event.type === 'output.delta' ||
-                    event.type === 'text.completed' ||
-                    event.type === 'reasoning.completed' ||
-                    event.type === 'client_tool.call' ||
-                    event.type === 'hosted_tool' ||
-                    event.type === 'citation' ||
-                    event.type === 'unknown')
-                    sawUnrepresentedOutput = true;
-                else if (event.type === 'completed')
-                    completed = event.reason === 'completed' || event.reason === 'tool_use';
-                yield event;
-            }
-            responseId = this.#completedResponseId ?? responseId;
-            if (responsesContinuationEnabled(this.adapter.configuration) &&
-                completed &&
-                responseId !== undefined &&
-                (outputItems.length > 0 || !sawUnrepresentedOutput)) {
-                this.state.lastRequest =
-                    this.adapter.configuration.responsesTransport?.transport === 'WEBSOCKET'
-                        ? { ...prepared.body, input: [] }
-                        : prepared.fullBody;
-                this.state.lastMessageCount = request.messages.length + outputMessageCount;
-                this.state.lastInputItemCount = prepared.inputItemCount;
-                this.state.lastSystem = JSON.stringify([request.system, request.systemBlocks]);
-                this.state.lastResponse = { responseId, outputItems };
-            }
-            else
-                clearResponsesContinuation(this.state);
-        }
-        catch (error) {
-            clearResponsesContinuation(this.state);
-            throw error;
-        }
-        finally {
-            this.#completedResponseId = undefined;
-            this.#active = false;
-        }
-    }
-    async close() {
-        if (this.#closed)
-            return;
-        this.#closed = true;
-        this.adapter.releaseTurnSession(this.state, this.cacheLease);
-    }
-    resetContinuation() {
-        clearResponsesContinuation(this.state);
-    }
-    continuationInputCount() {
-        return this.state.lastMessageCount ?? 0;
-    }
-    commitContinuationInput(messageCount) {
-        if (this.state.lastResponse !== undefined)
-            this.state.lastMessageCount = messageCount;
-    }
-    captureCompletedResponseId(responseId) {
-        if (responseId !== undefined)
-            this.#completedResponseId = responseId;
-    }
-    prepareRequest(request) {
-        assertInlineMediaBudget(request);
-        if (this.adapter.configuration.responsesTransport?.transport === 'WEBSOCKET' &&
-            this.state.socket !== undefined &&
-            this.state.socket.readyState !== WebSocket.OPEN) {
-            invalidateResponsesWebSocket(this.state, false);
-            clearResponsesContinuation(this.state);
-        }
-        // The continuation baseline must not share mutable schemas or items with callers.
-        const snapshot = (body) => JSON.parse(JSON.stringify(body));
-        let full;
-        const fullBody = () => (full ??= snapshot(responsesRequestBody(this.adapter.configuration, request, request.messages)));
-        if (responsesContinuationEnabled(this.adapter.configuration)) {
-            const websocket = this.adapter.configuration.responsesTransport?.transport === 'WEBSOCKET';
-            const suffixMessages = websocket && this.state.lastMessageCount !== undefined
-                ? request.messages.slice(this.state.lastMessageCount)
-                : undefined;
-            const suffixBody = websocket &&
-                this.state.lastResponse !== undefined &&
-                suffixMessages !== undefined &&
-                this.state.lastRequest !== undefined &&
-                this.state.lastSystem === JSON.stringify([request.system, request.systemBlocks]) &&
-                // Top-level images attach to the last real user, which must be in this suffix.
-                (!request.images?.length || suffixMessages.some(isRealUserMessage))
-                ? snapshot(responsesRequestBody(this.adapter.configuration, { ...request, system: '', systemBlocks: [] }, suffixMessages, this.state.lastResponse.outputItems))
-                : undefined;
-            const incremental = websocket
-                ? suffixBody !== undefined &&
-                    responsesContinuationPropertiesMatch(this.state.lastRequest, suffixBody)
-                    ? suffixBody.input
-                    : undefined
-                : incrementalResponsesInput(this.state, fullBody());
-            if (incremental !== undefined) {
-                const responseId = this.state.lastResponse.responseId;
-                const inputItemCount = websocket
-                    ? (this.state.lastInputItemCount ?? 0) +
-                        this.state.lastResponse.outputItems.length +
-                        incremental.length
-                    : fullBody().input.length;
-                delete this.state.lastResponse;
-                return {
-                    get fullBody() {
-                        return fullBody();
-                    },
-                    inputItemCount,
-                    body: {
-                        ...(suffixBody ?? fullBody()),
-                        input: incremental,
-                        previous_response_id: responseId
-                    },
-                    continuation: true
-                };
-            }
-        }
-        return {
-            fullBody: fullBody(),
-            inputItemCount: fullBody().input.length,
-            body: fullBody(),
-            continuation: false
-        };
-    }
-    currentTurnState() {
-        return this.#turnState;
-    }
-    beginAttempt() {
-        this.#connectionDiagnostic = undefined;
-        this.#webSocketDiagnostic = undefined;
-    }
-    captureWebSocketDiagnostic(diagnostic) {
-        this.#webSocketDiagnostic = diagnostic;
-    }
-    connectionDiagnostic() {
-        return { ...this.#connectionDiagnostic, ...this.#webSocketDiagnostic };
-    }
-    captureTurnState(value) {
-        if (this.#turnState !== undefined || typeof value !== 'string')
-            return;
-        const bounded = boundedError(value.trim(), 8_192);
-        if (bounded)
-            this.#turnState = bounded;
-    }
-    withTurnStateMetadata(body) {
-        if (this.#turnState === undefined)
-            return body;
-        return {
-            ...body,
-            client_metadata: {
-                ...record(body.client_metadata),
-                [X_CODEX_TURN_STATE]: this.#turnState
-            }
-        };
-    }
-    invalidateWebSocket() {
-        invalidateResponsesWebSocket(this.state, true);
-    }
-    async webSocketForRequest(input) {
-        const endpoint = webSocketEndpoint(input.configuration.baseUrl);
-        const existingSocket = this.state.socket;
-        if (existingSocket !== undefined &&
-            (existingSocket.readyState !== WebSocket.OPEN || this.state.endpoint !== endpoint)) {
-            invalidateResponsesWebSocket(this.state, false);
-            if (input.continuation) {
-                clearResponsesContinuation(this.state);
-                throw localContinuationReset();
-            }
-        }
-        if (input.continuation && this.state.socket === undefined) {
-            clearResponsesContinuation(this.state);
-            throw localContinuationReset();
-        }
-        if (this.state.socket === undefined) {
-            const handshakeCredential = await acquireResponsesCredential(input.configuration, input.reason, input.signal);
-            input.credentialAcquired(handshakeCredential.revision);
-            await this.connectWebSocket(endpoint, handshakeCredential, input.promptCacheKey, input.signal);
-        }
-        const requestCredential = await acquireResponsesCredential(input.configuration, input.reason, input.signal);
-        input.credentialAcquired(requestCredential.revision);
-        if (requestCredential.revision !== this.state.credentialRevision ||
-            responsesCredentialFingerprint(requestCredential) !== this.state.credentialFingerprint) {
-            invalidateResponsesWebSocket(this.state, false);
-            if (input.continuation) {
-                clearResponsesContinuation(this.state);
-                throw localContinuationReset();
-            }
-            await this.connectWebSocket(endpoint, requestCredential, input.promptCacheKey, input.signal);
-        }
-        if (input.signal.aborted) {
-            invalidateResponsesWebSocket(this.state, true);
-            throw input.signal.reason;
-        }
-        const socket = this.state.socket;
-        if (socket?.readyState !== WebSocket.OPEN) {
-            invalidateResponsesWebSocket(this.state, true);
-            throw new MarAgentError('MAR_AGENT_MODEL_CONNECTION_FAILED', 'OpenAI Responses WebSocket connection is unavailable.', {
-                details: {
-                    transport: 'WEBSOCKET',
-                    continuation: input.continuation,
-                    reason: 'MODEL_TRANSPORT_FAILURE'
-                },
-                retryable: true
-            });
-        }
-        if (this.#connectionDiagnostic === undefined &&
-            this.state.connectionId !== undefined &&
-            this.state.proxyType !== undefined)
-            this.#connectionDiagnostic = {
-                connectionId: this.state.connectionId,
-                connectionReused: true,
-                proxyType: this.state.proxyType
-            };
-        return socket;
-    }
-    async connectWebSocket(endpoint, credential, promptCacheKey, signal) {
-        const parsedEndpoint = new URL(endpoint);
-        const connectionId = randomUUID();
-        const proxyType = credential.socks5Url === undefined ? 'DIRECT' : 'SOCKS5';
-        this.#connectionDiagnostic = { connectionId, connectionReused: false, proxyType };
-        const socket = new WebSocket(parsedEndpoint, {
-            headers: Object.fromEntries(webSocketHeaders(credential, promptCacheKey)),
-            perMessageDeflate: false,
-            maxPayload: 16 * 1024 * 1024,
-            handshakeTimeout: 30_000,
-            ...(credential.socks5Url === undefined
-                ? {}
-                : {
-                    createConnection: socks5WebSocketConnection(credential.socks5Url.reveal(), parsedEndpoint, signal)
-                })
-        });
-        try {
-            await waitForWebSocketOpen(socket, signal);
-        }
-        catch (error) {
-            terminateWebSocket(socket);
-            throw error;
-        }
-        this.state.socket = socket;
-        this.state.endpoint = endpoint;
-        this.state.credentialRevision = credential.revision;
-        this.state.credentialFingerprint = responsesCredentialFingerprint(credential);
-        this.state.connectionId = connectionId;
-        this.state.proxyType = proxyType;
-    }
-}
-function localContinuationReset() {
-    return new MarAgentError('MAR_AGENT_RESPONSES_CONTINUATION_RESET', 'The Responses connection changed before the incremental request was sent.');
-}
-function isLocalContinuationReset(error) {
-    return error instanceof MarAgentError && error.code === 'MAR_AGENT_RESPONSES_CONTINUATION_RESET';
-}
-function responsesRequestBody(configuration, request, messages, previousOutputItems = []) {
-    const systemBlocks = resolveModelTextBlocks(request.system, request.systemBlocks ?? []);
-    if ((request.systemBlocks !== undefined && systemBlocks.some((block) => block.cache)) ||
-        messages.some((message) => message.textBlocks !== undefined &&
-            resolveModelTextBlocks(message.content, message.textBlocks).some((block) => block.cache)))
-        throw new MarAgentError('MAR_AGENT_MODEL_CAPABILITY_UNAVAILABLE', 'This model protocol does not support explicit text-block cache markers.');
-    const tools = request.allowTools === false
-        ? []
-        : request.tools.map((tool) => tool.nativeType === 'tool_search' &&
-            configuration.responsesOptionalParameters?.nativeTools !== false
-            ? {
-                type: 'tool_search',
-                execution: 'client',
-                description: tool.description,
-                parameters: stableToolSchema(strictFunctionSchema(stableToolSchema(tool.inputSchema)))
-            }
-            : responsesFunctionTool(tool, configuration.responsesOptionalParameters?.nativeTools !== false));
-    if (configuration.responsesToolNamespace && tools.length > 0) {
-        const native = tools.filter((tool) => record(tool).type === 'tool_search');
-        const nested = tools.filter((tool) => record(tool).type !== 'tool_search');
-        tools.splice(0, tools.length, ...native);
-        if (nested.length)
-            tools.push({
-                type: 'namespace',
-                name: configuration.responsesToolNamespace,
-                description: 'Client-side agent tools.',
-                tools: nested
-            });
-    }
-    if (request.allowTools !== false &&
-        request.allowHostedTools !== false &&
-        configuration.hostedWebSearch)
-        tools.push({ type: 'web_search' });
-    const toolChoice = request.toolChoice ?? 'auto';
-    const input = openAiInput(messages, request.images, configuration.id, true, usesResponsesConfigurationUpdates(configuration), configuration.responsesOptionalParameters?.nativeTools !== false, request.tools, previousOutputItems);
-    const systemInput = responsesSystemInput(request, systemBlocks);
-    if (systemInput !== undefined)
-        input.unshift(systemInput);
-    return {
-        model: configuration.modelId,
-        ...(request.outputLimit === undefined
-            ? {}
-            : {
-                max_output_tokens: Math.min(request.outputLimit, configuration.maxOutputTokens)
-            }),
-        ...(configuration.serviceTier !== undefined
-            ? { service_tier: configuration.serviceTier }
-            : configuration.fastMode === true
-                ? { service_tier: 'priority' }
-                : {}),
-        tools,
-        ...(tools.length > 0 ? { tool_choice: toolChoice, parallel_tool_calls: true } : {}),
-        input,
-        stream: true,
-        store: configuration.responsesPreviousResponseId === true &&
-            configuration.responsesTransport?.transport !== 'WEBSOCKET',
-        ...(configuration.responsesOptionalParameters?.textVerbosity === false
-            ? {}
-            : { text: { verbosity: 'low' } }),
-        include: [
-            'reasoning.encrypted_content',
-            ...(configuration.hostedWebSearch &&
-                request.allowTools !== false &&
-                request.allowHostedTools !== false &&
-                toolChoice !== 'none'
-                ? ['web_search_call.action.sources']
-                : [])
-        ],
-        ...(request.promptCacheKey &&
-            configuration.responsesOptionalParameters?.promptCacheKey !== false
-            ? { prompt_cache_key: request.promptCacheKey }
-            : {}),
-        ...(configuration.responsesOptionalParameters?.reasoningEffort === false &&
-            configuration.responsesOptionalParameters?.reasoningSummary === false
-            ? {}
-            : {
-                reasoning: {
-                    ...(configuration.responsesOptionalParameters?.reasoningEffort === false
-                        ? {}
-                        : {
-                            effort: request.requestReasoningEffort?.trim() ||
-                                request.reasoningEffort?.trim() ||
-                                resolveModelDefaultReasoningEffort(configuration)
-                        }),
-                    ...(configuration.responsesOptionalParameters?.reasoningSummary === false
-                        ? {}
-                        : { summary: 'auto' })
-                }
-            })
-    };
-}
-function responsesSystemInput(request, blocks = resolveModelTextBlocks(request.system, request.systemBlocks ?? [])) {
-    if (blocks.length === 0)
-        return undefined;
-    return {
-        role: 'developer',
-        content: blocks.map((block) => ({ type: 'input_text', text: block.text }))
-    };
-}
-function incrementalResponsesInput(state, current) {
-    const previous = state.lastRequest;
-    const completion = state.lastResponse;
-    if (previous === undefined || completion === undefined)
-        return undefined;
-    if (!responsesContinuationPropertiesMatch(previous, current))
-        return undefined;
-    const baseline = [...previous.input, ...completion.outputItems];
-    if (current.input.length < baseline.length)
-        return undefined;
-    for (let index = 0; index < baseline.length; index++)
-        if (JSON.stringify(baseline[index]) !== JSON.stringify(current.input[index]))
-            return undefined;
-    return current.input.slice(baseline.length);
-}
-function responsesContinuationPropertiesMatch(previous, current) {
-    return (JSON.stringify({ ...previous, input: undefined, previous_response_id: undefined }) ===
-        JSON.stringify({ ...current, input: undefined, previous_response_id: undefined }));
-}
-function clearResponsesContinuation(state) {
-    delete state.lastRequest;
-    delete state.lastMessageCount;
-    delete state.lastInputItemCount;
-    delete state.lastSystem;
-    delete state.lastResponse;
-}
-function hashResponsesValue(value) {
-    return createHash('sha256').update(JSON.stringify(value)).digest('hex');
-}
-function responsesContinuationEnabled(configuration) {
-    return configuration.responsesPreviousResponseId === true;
-}
-function responsesCredentialFingerprint(credential) {
-    return hashResponsesValue({
-        bearer: credential.bearer.reveal(),
-        headers: Object.fromEntries(Object.entries(credential.headers).map(([name, value]) => [
-            name,
-            typeof value === 'string' ? value : value.reveal()
-        ])),
-        socks5Url: credential.socks5Url?.reveal()
-    });
-}
-function invalidateResponsesWebSocket(state, clearContinuation) {
-    const socket = state.socket;
-    delete state.socket;
-    delete state.endpoint;
-    delete state.credentialRevision;
-    delete state.credentialFingerprint;
-    delete state.connectionId;
-    delete state.proxyType;
-    if (clearContinuation)
-        clearResponsesContinuation(state);
-    if (socket !== undefined &&
-        socket.readyState !== WebSocket.CLOSED &&
-        socket.readyState !== WebSocket.CLOSING)
-        terminateWebSocket(socket);
-}
-function turnStateFromEvent(event) {
-    for (const headers of [
-        record(event.headers),
-        record(record(event.response).headers),
-        record(record(event.metadata).headers)
-    ]) {
-        for (const [name, value] of Object.entries(headers))
-            if (name.toLowerCase() === X_CODEX_TURN_STATE && typeof value === 'string')
-                return value;
-    }
-    return undefined;
-}
-async function* parseOpenAiResponsesSse(response, signal, continuation, sensitiveValues) {
-    try {
-        yield* parseSse(response, signal, undefined, undefined, sensitiveValues);
-    }
-    catch (cause) {
-        if (response.ok && !signal.aborted && isRetryableOpenAiStreamReadError(cause))
-            throw new MarAgentError('MAR_AGENT_MODEL_PROTOCOL_ERROR', 'OpenAI Responses stream was interrupted.', {
-                details: {
-                    reason: OPENAI_RESPONSES_EARLY_EOF_REASON,
-                    retryAfter: response.headers.get('retry-after'),
-                    continuation
-                },
-                retryable: true,
-                cause
-            });
-        throw cause;
-    }
-}
-async function* webSocketResponseEvents(input) {
-    const body = input.turn.withTurnStateMetadata(input.body);
-    const payload = Buffer.from(JSON.stringify({ type: 'response.create', ...body }), 'utf8');
-    const diagnostic = webSocketRequestDiagnostic(body, payload.length);
-    input.turn.captureWebSocketDiagnostic(diagnostic);
-    const socket = await input.turn.webSocketForRequest({
-        configuration: input.configuration,
-        promptCacheKey: input.promptCacheKey,
-        reason: input.reason,
-        signal: input.signal,
-        continuation: input.continuation,
-        credentialAcquired: input.credentialAcquired
-    });
-    const messages = webSocketMessages(socket, input.signal, (code) => {
-        diagnostic.webSocketCloseCode = code;
-    });
-    try {
-        diagnostic.webSocketPhase = 'SEND';
-        await sendWebSocketMessage(socket, payload, input.signal, () => {
-            diagnostic.sentFrameCount = (diagnostic.sentFrameCount ?? 0) + 1;
-        });
-        diagnostic.webSocketPhase = 'RECEIVE';
-        let terminal = false;
-        for await (const item of messages) {
-            const event = record(item);
-            const type = text(event.type);
-            input.turn.captureTurnState(turnStateFromEvent(event));
-            if (type !== 'response.metadata' && type !== 'codex.response.metadata')
-                yield item;
-            if (type === 'response.completed' ||
-                type === 'response.incomplete' ||
-                type === 'response.failed' ||
-                type === 'error') {
-                terminal = true;
-                return;
-            }
-        }
-        // Intentionally treat a close without a terminal model event as retryable EOF,
-        // including close code 1009. Close codes remain diagnostic evidence rather than
-        // a separate model-error classification. The shared attempt budget still bounds
-        // retries; this policy does not shrink the request or guarantee recovery.
-        if (!terminal && !input.signal.aborted)
-            throw new MarAgentError('MAR_AGENT_MODEL_PROTOCOL_ERROR', 'OpenAI Responses WebSocket closed before a terminal event.', {
-                details: {
-                    reason: OPENAI_RESPONSES_EARLY_EOF_REASON,
-                    transport: 'WEBSOCKET',
-                    continuation: input.continuation
-                },
-                retryable: true
-            });
-    }
-    finally {
-        messages.dispose();
-    }
-}
-function webSocketRequestDiagnostic(body, requestBytes) {
-    let imageCount = 0;
-    let imageBytes = 0;
-    for (const item of body.input) {
-        const entry = record(item);
-        const parts = Array.isArray(entry.content)
-            ? entry.content
-            : Array.isArray(entry.output)
-                ? entry.output
-                : [];
-        for (const value of parts) {
-            const part = record(value);
-            if (part.type !== 'input_image')
-                continue;
-            imageCount++;
-            const url = text(part.image_url);
-            if (url === undefined)
-                continue;
-            const marker = url.indexOf(';base64,');
-            if (url.startsWith('data:') && marker >= 0)
-                imageBytes += Buffer.byteLength(url.slice(marker + 8), 'base64');
-        }
-    }
-    return {
-        requestBytes,
-        imageCount,
-        imageBytes,
-        requestFrameCount: Math.ceil(requestBytes / WEBSOCKET_SEND_FRAME_BYTES),
-        sentFrameCount: 0,
-        webSocketPhase: 'CONNECT'
-    };
-}
-async function waitForWebSocketOpen(socket, signal) {
-    if (signal.aborted) {
-        terminateWebSocket(socket);
-        throw signal.reason;
-    }
-    await new Promise((resolve, reject) => {
-        const cleanup = () => {
-            signal.removeEventListener('abort', abort);
-            socket.off('open', open);
-            socket.off('error', error);
-            socket.off('close', close);
-            socket.off('unexpected-response', unexpectedResponse);
-        };
-        const settle = (operation) => {
-            cleanup();
-            operation();
-        };
-        const abort = () => settle(() => {
-            terminateWebSocket(socket);
-            reject(signal.reason);
-        });
-        const open = () => settle(resolve);
-        const error = (cause) => settle(() => reject(new MarAgentError('MAR_AGENT_MODEL_CONNECTION_FAILED', 'OpenAI Responses WebSocket connection failed.', {
-            details: { reason: 'MODEL_TRANSPORT_FAILURE', transport: 'WEBSOCKET' },
-            retryable: true,
-            cause
-        })));
-        const close = () => settle(() => reject(new MarAgentError('MAR_AGENT_MODEL_CONNECTION_FAILED', 'OpenAI Responses WebSocket closed during connection.', {
-            details: { reason: 'MODEL_TRANSPORT_FAILURE', transport: 'WEBSOCKET' },
-            retryable: true
-        })));
-        const unexpectedResponse = (_request, response) => settle(() => {
-            const status = response.statusCode ?? 0;
-            response.resume();
-            terminateWebSocket(socket);
-            const retryable = status !== 401 && isRetryableModelHttpStatus(status);
-            const retryAfter = response.headers['retry-after'];
-            const retryAfterValue = Array.isArray(retryAfter) ? retryAfter[0] : retryAfter;
-            reject(new MarAgentError(status === 401 ? 'MAR_AGENT_MODEL_AUTH_FAILED' : 'MAR_AGENT_MODEL_CONNECTION_FAILED', status === 401
-                ? 'OpenAI Responses WebSocket authentication failed.'
-                : 'OpenAI Responses WebSocket handshake failed.', {
-                details: {
-                    status,
-                    transport: 'WEBSOCKET',
-                    ...(retryAfterValue === undefined ? {} : { retryAfter: retryAfterValue })
-                },
-                ...(retryable ? { retryable: true } : {})
-            }));
-        });
-        signal.addEventListener('abort', abort, { once: true });
-        socket.once('open', open);
-        socket.once('error', error);
-        socket.once('close', close);
-        socket.once('unexpected-response', unexpectedResponse);
-    });
-}
-async function sendWebSocketMessage(socket, payload, signal, frameSent) {
-    for (let offset = 0; offset < payload.length; offset += WEBSOCKET_SEND_FRAME_BYTES) {
-        if (signal.aborted)
-            throw signal.reason;
-        const end = Math.min(payload.length, offset + WEBSOCKET_SEND_FRAME_BYTES);
-        await new Promise((resolve, reject) => {
-            let settled = false;
-            const cleanup = () => {
-                settled = true;
-                signal.removeEventListener('abort', abort);
-                socket.off('error', error);
-                socket.off('close', close);
-            };
-            const abort = () => {
-                cleanup();
-                socket.terminate();
-                reject(signal.reason);
-            };
-            const error = (cause) => {
-                cleanup();
-                reject(webSocketReceiveError(cause));
-            };
-            const close = () => error(new Error('WebSocket closed while sending the request.'));
-            signal.addEventListener('abort', abort, { once: true });
-            socket.once('error', error);
-            socket.once('close', close);
-            try {
-                socket.send(payload.subarray(offset, end), { binary: false, fin: end === payload.length }, (cause) => {
-                    if (settled)
-                        return;
-                    cleanup();
-                    if (cause)
-                        reject(webSocketReceiveError(cause));
-                    else if (signal.aborted)
-                        reject(signal.reason);
-                    else {
-                        frameSent();
-                        resolve();
-                    }
-                });
-            }
-            catch (cause) {
-                cleanup();
-                reject(webSocketReceiveError(cause));
-            }
-        });
-    }
-}
-function webSocketMessages(socket, signal, closed) {
-    const queue = [];
-    let resume;
-    const push = (item) => {
-        queue.push(item);
-        resume?.();
-        resume = undefined;
-    };
-    const message = (value) => push({
-        type: 'message',
-        value,
-        observedAt: performance.now()
-    });
-    const close = (code) => {
-        closed(code);
-        push({ type: 'closed' });
-    };
-    const error = (cause) => push({
-        type: 'error',
-        error: webSocketReceiveError(cause)
-    });
-    const abort = () => {
-        terminateWebSocket(socket);
-        push({ type: 'error', error: signal.reason });
-    };
-    if (signal.aborted) {
-        terminateWebSocket(socket);
-        throw signal.reason;
-    }
-    socket.on('message', message);
-    socket.on('close', close);
-    socket.on('error', error);
-    signal.addEventListener('abort', abort, { once: true });
-    const dispose = () => {
-        signal.removeEventListener('abort', abort);
-        socket.off('message', message);
-        socket.off('close', close);
-        socket.off('error', error);
-    };
-    return {
-        dispose,
-        async *[Symbol.asyncIterator]() {
-            try {
-                let idleDeadline = Date.now() + WEBSOCKET_IDLE_TIMEOUT_MS;
-                while (true) {
-                    if (Date.now() >= idleDeadline)
-                        throw webSocketIdleError(socket);
-                    if (queue.length === 0)
-                        await new Promise((resolve, reject) => {
-                            const timer = setTimeout(() => {
-                                resume = undefined;
-                                reject(webSocketIdleError(socket));
-                            }, Math.max(0, idleDeadline - Date.now()));
-                            resume = () => {
-                                clearTimeout(timer);
-                                resolve();
-                            };
-                        });
-                    const item = queue.shift();
-                    if (item === undefined)
-                        continue;
-                    if (item.type === 'closed')
-                        return;
-                    if (item.type === 'error')
-                        throw item.error;
-                    const text = await webSocketMessageText(item.value);
-                    if (Buffer.byteLength(text) > 16 * 1024 * 1024)
-                        throw new MarAgentError('MAR_AGENT_MODEL_PROTOCOL_ERROR', 'Model response exceeded the size limit.');
-                    try {
-                        const event = JSON.parse(text);
-                        if (!isWebSocketNonProgressEvent(event))
-                            idleDeadline = Date.now() + WEBSOCKET_IDLE_TIMEOUT_MS;
-                        yield observeModelStreamEvent(event, item.observedAt);
-                    }
-                    catch (cause) {
-                        throw new MarAgentError('MAR_AGENT_MODEL_PROTOCOL_ERROR', 'Model WebSocket contained invalid JSON.', { cause });
-                    }
-                }
-            }
-            finally {
-                dispose();
-            }
-        }
-    };
-}
-function webSocketIdleError(socket) {
-    terminateWebSocket(socket);
-    return new MarAgentError('MAR_AGENT_MODEL_TIMEOUT', 'OpenAI Responses WebSocket was idle for too long.', {
-        details: { reason: OPENAI_RESPONSES_EARLY_EOF_REASON, transport: 'WEBSOCKET' },
-        retryable: true
-    });
-}
-function isWebSocketNonProgressEvent(value) {
-    const type = text(record(value).type);
-    return (type === 'response.metadata' ||
-        type === 'codex.response.metadata' ||
-        type === 'responsesapi.websocket_timing' ||
-        type === 'response.queued' ||
-        type === 'response.in_progress');
-}
-async function webSocketMessageText(value) {
-    if (typeof value === 'string')
-        return value;
-    if (Buffer.isBuffer(value))
-        return value.toString('utf8');
-    if (value instanceof ArrayBuffer)
-        return Buffer.from(value).toString('utf8');
-    if (ArrayBuffer.isView(value))
-        return Buffer.from(value.buffer, value.byteOffset, value.byteLength).toString('utf8');
-    if (Array.isArray(value) && value.every((part) => Buffer.isBuffer(part)))
-        return Buffer.concat(value).toString('utf8');
-    throw new MarAgentError('MAR_AGENT_MODEL_PROTOCOL_ERROR', 'Model WebSocket returned an unsupported frame.');
-}
-function webSocketHeaders(credential, promptCacheKey) {
-    const headers = responsesHeaders(credential, promptCacheKey);
-    headers.delete('accept');
-    headers.delete('content-type');
-    headers.set('openai-beta', 'responses_websockets=2026-02-06');
-    return headers;
-}
-function webSocketEndpoint(baseUrl) {
-    const endpoint = new URL(responsesEndpoint(baseUrl));
-    endpoint.protocol = endpoint.protocol === 'https:' ? 'wss:' : 'ws:';
-    return endpoint.toString();
-}
-function socks5WebSocketConnection(socks5Url, endpoint, signal) {
-    return ((_options, callback) => {
-        if (callback === undefined)
-            throw new MarAgentError('MAR_AGENT_MODEL_CONNECTION_FAILED', 'WebSocket connection callback is unavailable.');
-        void connectSocks5Target({
-            socks5Url,
-            targetHost: endpoint.hostname,
-            targetPort: Number(endpoint.port || (endpoint.protocol === 'wss:' ? 443 : 80)),
-            tls: endpoint.protocol === 'wss:',
-            servername: endpoint.hostname,
-            ...(endpoint.protocol === 'wss:' ? { alpnProtocols: ['http/1.1'] } : {}),
-            signal
-        }).then((socket) => callback(null, socket), (error) => callback(error instanceof Error
-            ? error
-            : new Error('SOCKS5 WebSocket connection failed.', { cause: error })));
-        return undefined;
-    });
-}
-function terminateWebSocket(socket) {
-    if (socket.readyState === WebSocket.CONNECTING)
-        socket.once('error', () => undefined);
-    socket.terminate();
-}
-function webSocketReceiveError(cause) {
-    const code = cause.code;
-    if (typeof code === 'string' && code.startsWith('WS_ERR_'))
-        return new MarAgentError('MAR_AGENT_MODEL_PROTOCOL_ERROR', code === 'WS_ERR_UNSUPPORTED_MESSAGE_LENGTH'
-            ? 'Model response exceeded the size limit.'
-            : 'Model WebSocket protocol is invalid.', { cause });
-    return new MarAgentError('MAR_AGENT_MODEL_PROTOCOL_ERROR', 'OpenAI Responses WebSocket was interrupted.', {
-        details: {
-            reason: OPENAI_RESPONSES_EARLY_EOF_REASON,
-            transport: 'WEBSOCKET'
-        },
-        retryable: true,
-        cause
-    });
-}
-function isSemanticEvent(event) {
-    if (event.type.startsWith('output.'))
-        return false;
-    if (event.type === 'response.started' || event.type === 'usage' || event.type === 'response.item')
-        return false;
-    if (event.type === 'text.delta')
-        return event.delta.length > 0;
-    if (event.type === 'text.completed' || event.type === 'reasoning.completed')
-        return event.text.length > 0;
-    return true;
-}
-function isNonSemanticOpenAiResponsesEvent(type) {
-    return NON_SEMANTIC_OPENAI_RESPONSES_EVENTS.has(type);
-}
-const NON_SEMANTIC_OPENAI_RESPONSES_EVENTS = new Set([
-    'codex.response.metadata',
-    'response.content_part.added',
-    'response.content_part.done',
-    'response.in_progress',
-    'response.metadata',
-    'response.queued',
-    'response.reasoning_summary_part.added',
-    'response.reasoning_summary_part.done',
-    'responsesapi.websocket_timing'
-]);
-function isRetryableResponsesUpstreamError(code, message) {
-    if (isRetryableUpstreamOverloadCode(code))
-        return true;
-    if (code !== 'invalid_request_error')
-        return false;
-    // Exact compatibility exception, not a general access/authentication retry rule.
-    const summary = message?.startsWith(`${code}: `) ? message.slice(code.length + 2) : message;
-    return summary === 'Unable to verify Daybreak Blue access. Please try again.';
-}
-export function isOpenAiResponsesRecoverableStreamError(error) {
-    return (error instanceof MarAgentError &&
-        error.retryable &&
-        (error.details?.reason === OPENAI_RESPONSES_EARLY_EOF_REASON ||
-            error.details?.reason === OPENAI_RESPONSES_WEBSOCKET_CONNECTION_LIMIT_REASON ||
-            isRetryableResponsesUpstreamError(error.code, error.message)));
-}
-function isWebSocketConnectionLimitCode(code) {
-    return code?.trim().toLowerCase() === 'websocket_connection_limit_reached';
-}
-function isRetryableOpenAiStreamReadError(error) {
-    return (isRetryableModelTransportError(error) ||
-        (error instanceof MarAgentError &&
-            error.code === 'MAR_AGENT_MODEL_TIMEOUT' &&
-            error.details?.reason === 'MODEL_STREAM_IDLE_TIMEOUT'));
-}
-function retryAfter(error) {
-    const value = error.details?.retryAfter;
-    return typeof value === 'string' ? value : null;
-}
-function openAiResponsesAttemptError(error) {
-    const diagnostic = describeMarAgentError(error, 'MAR_AGENT_MODEL_ATTEMPT_FAILED');
-    const causeCode = deepestCauseCode(error);
-    const reason = error instanceof MarAgentError && typeof error.details?.reason === 'string'
-        ? error.details.reason
-        : undefined;
-    return {
-        errorCode: diagnostic.code,
-        errorMessage: diagnostic.message,
-        ...(causeCode === undefined || causeCode === diagnostic.code ? {} : { causeCode }),
-        ...(reason === undefined ? {} : { reason }),
-        retryable: error instanceof MarAgentError && error.retryable
-    };
-}
-function deepestCauseCode(error) {
-    const seen = new Set();
-    let current = error;
-    let code;
-    while (current !== undefined && current !== null && !seen.has(current) && seen.size < 8) {
-        seen.add(current);
-        const candidate = current instanceof MarAgentError
-            ? current.code
-            : typeof current === 'object' && 'code' in current
-                ? current.code
-                : undefined;
-        if (typeof candidate === 'string' && candidate.trim())
-            code = boundedError(candidate, 80) ?? code;
-        current =
-            typeof current === 'object' && 'cause' in current
-                ? current.cause
-                : undefined;
-    }
-    return code;
-}
-function responsesEndpoint(baseUrl) {
-    const normalized = baseUrl.replace(/\/$/, '');
-    if (new URL(normalized).pathname.endsWith('/backend-api/codex'))
-        return `${normalized}/responses`;
-    return `${normalized.endsWith('/v1') ? normalized : `${normalized}/v1`}/responses`;
-}
-async function acquireResponsesCredential(configuration, reason, signal) {
-    return acquireModelCredential(configuration, reason, 'OpenAI Responses requires a model credential.', signal);
-}
-const RESERVED_CREDENTIAL_HEADERS = new Set([
-    'accept',
-    'authorization',
-    'connection',
-    'content-length',
-    'content-type',
-    'host',
-    'openai-beta',
-    'proxy-authorization',
-    'sec-websocket-accept',
-    'sec-websocket-extensions',
-    'sec-websocket-key',
-    'sec-websocket-protocol',
-    'sec-websocket-version',
-    'session-id',
-    'thread-id',
-    'transfer-encoding',
-    'upgrade',
-    'x-client-request-id',
-    X_CODEX_TURN_STATE,
-    'x-openai-internal-codex-responses-lite'
-]);
-function responsesHeaders(credential, promptCacheKey, turnState) {
-    const headers = new Headers({
-        authorization: `Bearer ${credential.bearer.reveal()}`,
-        'content-type': 'application/json',
-        accept: 'text/event-stream',
-        'user-agent': productUserAgent(),
-        'x-client-request-id': randomUUID(),
-        ...(promptCacheKey
-            ? {
-                'session-id': promptCacheKey,
-                'thread-id': promptCacheKey
-            }
-            : {})
-    });
-    if (turnState)
-        headers.set(X_CODEX_TURN_STATE, turnState);
-    return appendModelCredentialHeaders(headers, credential, RESERVED_CREDENTIAL_HEADERS);
-}
-function withCredentialRevision(error, revision) {
-    if (!(error instanceof MarAgentError) || revision === undefined)
-        return error;
-    const prefix = `${error.code}: `;
-    return new MarAgentError(error.code, error.message.startsWith(prefix) ? error.message.slice(prefix.length) : error.message, {
-        details: { ...error.details, credentialRevision: revision },
-        retryable: error.retryable,
-        cause: error
-    });
-}
-function withResponsesAttemptDetails(error, continuation, transport) {
-    if (!(error instanceof MarAgentError))
-        return error;
-    const prefix = `${error.code}: `;
-    return new MarAgentError(error.code, error.message.startsWith(prefix) ? error.message.slice(prefix.length) : error.message, {
-        details: {
-            ...error.details,
-            continuation,
-            ...(transport === 'WEBSOCKET' ? { transport: 'WEBSOCKET' } : {})
-        },
-        retryable: error.retryable,
-        cause: error
-    });
-}
-function isModelAuthenticationFailure(error) {
-    if (!(error instanceof MarAgentError))
-        return false;
-    if (typeof error.details?.status === 'number')
-        return error.details.status === 401;
-    const code = error.code.toLowerCase();
-    return code === 'unauthorized';
-}
-function credentialRevision(error) {
-    const revision = error.details?.credentialRevision;
-    return typeof revision === 'number' && Number.isSafeInteger(revision) && revision >= 0
-        ? revision
-        : undefined;
-}
-function boundedError(value, maximum) {
-    const normalized = value?.trim();
-    if (!normalized)
-        return undefined;
-    return [...normalized].slice(0, maximum).join('');
-}
-function upstreamHttpStatus(...values) {
-    for (const value of values) {
-        const candidate = typeof value === 'string' && /^\d{3}$/u.test(value) ? Number(value) : number(value);
-        if (candidate !== undefined &&
-            Number.isInteger(candidate) &&
-            candidate >= 100 &&
-            candidate <= 599)
-            return candidate;
-    }
-    return undefined;
-}
-function optionalRolloutBudgetUnits(value) {
-    if (value === undefined)
-        return undefined;
-    const units = number(value);
-    if (units !== undefined && units >= 0)
-        return units;
-    throw new MarAgentError('MAR_AGENT_MODEL_PROTOCOL_ERROR', 'Provider rollout budget units are invalid.');
-}
-function messagePhase(value) {
-    return value === 'commentary' || value === 'final_answer' ? value : undefined;
-}
-function responseMessageText(item) {
-    const content = Array.isArray(item.content) ? item.content : [];
-    const parts = content
-        .map(record)
-        .filter((part) => text(part.type) === 'output_text')
-        .map((part) => text(part.text) ?? '');
-    return parts.length ? parts.join('') : undefined;
-}
-function isInvalidPreviousResponseError(error) {
-    if (!(error instanceof MarAgentError))
-        return false;
-    const status = error.details?.status;
-    if (typeof status === 'number' && ![400, 404, 410].includes(status))
-        return false;
-    return isInvalidPreviousResponseFields(error.code, error.message);
-}
-function isInvalidPreviousResponseFields(code, message) {
-    const normalizedCode = code?.trim().toLowerCase();
-    // OpenAI Responses and compatible providers use these missing-reference codes.
-    if (normalizedCode === 'previous_response_not_found' ||
-        normalizedCode === 'invalid_previous_response_id')
-        return true;
-    const normalizedMessage = message?.toLowerCase().replaceAll('`', '') ?? '';
-    // xAI/Grok WSS uses api_error with a gRPC prefix; HTTP may return a plain
-    // error string, normalized by the SSE boundary to MAR_AGENT_MODEL_PROTOCOL_ERROR.
-    // Do not treat account/model lookup failures as a missing response reference.
-    if ((normalizedCode === 'api_error' ||
-        normalizedCode === 'mar_agent_model_protocol_error' ||
-        normalizedCode === undefined) &&
-        /^(?:(?:mar_agent_model_protocol_error|api_error): )?(?:grpc error: )?response with id=\S+ not found[.!]?$/u.test(normalizedMessage))
-        return true;
-    // Compatibility gateways use these unsupported-parameter discriminators.
-    if ((normalizedCode === 'unsupported_parameter' ||
-        normalizedCode === 'unsupported_previous_response_id') &&
-        normalizedMessage.includes('previous_response_id'))
-        return true;
-    // OpenAI-style request errors and generic compatibility envelopes may only
-    // name the rejected parameter. Explicit auth, permission, overload or other
-    // error codes take precedence even when their message mentions continuation.
-    if (normalizedCode !== undefined &&
-        normalizedCode !== 'invalid_request_error' &&
-        normalizedCode !== 'api_error' &&
-        normalizedCode !== 'mar_agent_model_protocol_error')
-        return false;
-    return (normalizedMessage.includes('previous_response_id') &&
-        (normalizedMessage.includes('invalid') ||
-            normalizedMessage.includes('not found') ||
-            normalizedMessage.includes('does not exist') ||
-            normalizedMessage.includes('expired') ||
-            normalizedMessage.includes('not supported') ||
-            normalizedMessage.includes('unsupported') ||
-            normalizedMessage.includes('unavailable')));
-}
-const RESPONSE_ITEM_TYPES = new Set([
-    'message',
-    'reasoning',
-    'function_call',
-    'custom_tool_call',
-    'tool_search_call',
-    'tool_search_output',
-    'web_search_call'
-]);
-// A freeform patch item can contain the complete 4 MiB patch plus its JSON envelope.
-const MAX_RESPONSE_ITEM_BYTES = 5 * 1024 * 1024;
-function hostedWebActionInput(action) {
-    const input = {};
-    let truncated = false;
-    for (const [key, limit] of [
-        ['type', 128],
-        ['query', 10_000],
-        ['url', 2_048],
-        ['pattern', 10_000]
-    ]) {
-        const value = action[key];
-        if (typeof value !== 'string')
-            continue;
-        input[key] = value.slice(0, limit);
-        truncated ||= value.length > limit;
-    }
-    if (Array.isArray(action.queries)) {
-        const queries = action.queries.filter((value) => typeof value === 'string');
-        input.queries = queries.slice(0, 10).map((value) => value.slice(0, 10_000));
-        truncated ||=
-            queries.length > 10 || queries.slice(0, 10).some((value) => value.length > 10_000);
-    }
-    return { input, truncated };
-}
-function hostedWebActionSummary(action) {
-    const queries = Array.isArray(action.queries)
-        ? action.queries
-            .slice(0, 10)
-            .filter((query) => typeof query === 'string' && query.length > 0)
-        : [];
-    const query = text(action.query) || queries.join('\n');
-    const url = text(action.url);
-    const title = text(action.title);
-    const sources = Array.isArray(action.sources)
-        ? action.sources
-            .slice(0, 20)
-            .map((source) => {
-            const value = record(source);
-            const sourceUrl = text(value.url);
-            if (!sourceUrl)
-                return undefined;
-            const sourceTitle = text(value.title);
-            const snippet = text(value.snippet);
-            return {
-                url: sourceUrl.slice(0, 2048),
-                ...(sourceTitle ? { title: sourceTitle.slice(0, 256) } : {}),
-                ...(snippet ? { snippet: snippet.slice(0, 2000) } : {})
-            };
-        })
-            .filter((source) => source !== undefined)
-        : [];
-    return {
-        ...(query ? { query: query.slice(0, 10_000) } : {}),
-        ...(url ? { url: url.slice(0, 2048) } : {}),
-        ...(title ? { title: title.slice(0, 256) } : {}),
-        ...(Array.isArray(action.sources) ? { sources } : {}),
-        ...(Array.isArray(action.sources) && action.sources.length > 20
-            ? { sourcesTruncated: true }
-            : {})
-    };
-}
-function responseItem(value) {
-    const item = record(value);
-    const itemType = text(item.type);
-    if (!itemType || !RESPONSE_ITEM_TYPES.has(itemType))
-        return undefined;
-    const serialized = JSON.stringify(item);
-    if (Buffer.byteLength(serialized) > MAX_RESPONSE_ITEM_BYTES)
-        throw new MarAgentError('MAR_AGENT_MODEL_PROTOCOL_ERROR', 'Responses output item exceeds the context record limit.');
-    return JSON.parse(serialized);
-}
-function strictFunctionSchema(value, optional = false) {
-    if (value === null || typeof value !== 'object' || Array.isArray(value))
-        return value;
-    const schema = value;
-    const supportedSchema = Object.fromEntries(Object.entries(schema).filter(([keyword]) => keyword !== 'propertyNames' && keyword !== 'uniqueItems'));
-    if (optional && Array.isArray(schema.enum) && !schema.enum.includes(null))
-        supportedSchema.enum = [...schema.enum, null];
-    if (schema.type === 'object') {
-        const properties = record(schema.properties);
-        const required = new Set(Array.isArray(schema.required) ? schema.required : []);
-        return {
-            ...supportedSchema,
-            ...(optional ? { type: ['object', 'null'] } : {}),
-            properties: Object.fromEntries(Object.entries(properties).map(([name, property]) => [
-                name,
-                strictFunctionSchema(property, !required.has(name))
-            ])),
-            required: Object.keys(properties),
-            additionalProperties: false
-        };
-    }
-    if (schema.type === 'array')
-        return {
-            ...supportedSchema,
-            ...(schema.items === undefined ? {} : { items: strictFunctionSchema(schema.items) }),
-            ...(optional ? { type: ['array', 'null'] } : {})
-        };
-    if (!optional)
-        return supportedSchema;
-    if (typeof schema.type === 'string')
-        return { ...supportedSchema, type: [schema.type, 'null'] };
-    if (Array.isArray(schema.type))
-        return {
-            ...supportedSchema,
-            type: schema.type.includes('null') ? schema.type : [...schema.type, 'null']
-        };
-    if (Array.isArray(schema.enum))
-        return supportedSchema;
-    return { anyOf: [supportedSchema, { type: 'null' }] };
-}
-function responseCitations(response) {
-    const citations = new Map();
-    for (const output of Array.isArray(response.output) ? response.output : []) {
-        const item = record(output);
-        for (const content of Array.isArray(item.content) ? item.content : []) {
-            const part = record(content);
-            for (const value of Array.isArray(part.annotations) ? part.annotations : []) {
-                const annotation = record(value);
-                const url = text(annotation.url);
-                if (!url)
-                    continue;
-                const id = text(annotation.id) ?? `${text(item.id) ?? 'text'}-${citations.size}`;
-                const title = text(annotation.title);
-                citations.set(`${id}:${url}`, {
-                    id,
-                    url,
-                    ...(title ? { title } : {})
-                });
-            }
-        }
-    }
-    return [...citations.values()];
-}
-function responseEventId(event) {
-    return text(record(event.response).id);
-}
-export function openAiInput(messages, images, modelId, requireEncryptedReasoning, configurationUpdates = true, nativeTools = true, tools = [], previousOutputItems = []) {
-    const compatibleMessages = messages.filter((message) => message.role !== 'provider' ||
-        (message.provider === 'OPENAI_RESPONSES' &&
-            (message.providerModelId === undefined || message.providerModelId === modelId) &&
-            (configurationUpdates || message.item?.type !== 'configuration_update') &&
-            (nativeTools ||
-                !['custom_tool_call', 'tool_search_call', 'tool_search_output'].includes(String(message.item?.type))) &&
-            (!requireEncryptedReasoning ||
-                message.item?.type !== 'reasoning' ||
-                typeof message.item.encrypted_content === 'string')));
-    const lastUser = compatibleMessages.findLast(isRealUserMessage);
-    const providerCallIds = new Set();
-    const functionCallIds = new Set();
-    const customCallIds = new Set();
-    const providerMessageTexts = new Set();
-    // Incremental input omits the calls already retained by the WebSocket response.
-    for (const item of previousOutputItems) {
-        if (typeof item.call_id !== 'string')
-            continue;
-        if (item.type === 'function_call')
-            functionCallIds.add(item.call_id);
-        if (nativeTools && item.type === 'custom_tool_call')
-            customCallIds.add(item.call_id);
-    }
-    for (const message of compatibleMessages) {
-        if (message.role !== 'provider' || !message.item)
-            continue;
-        if (message.item.type === 'function_call' && typeof message.item.call_id === 'string') {
-            providerCallIds.add(message.item.call_id);
-            functionCallIds.add(message.item.call_id);
-        }
-        if (message.item.type === 'tool_search_call' && typeof message.item.call_id === 'string')
-            providerCallIds.add(message.item.call_id);
-        if (message.item.type === 'custom_tool_call' && typeof message.item.call_id === 'string') {
-            providerCallIds.add(message.item.call_id);
-            customCallIds.add(message.item.call_id);
-        }
-        if (message.item.type === 'message') {
-            const content = Array.isArray(message.item.content) ? message.item.content : [];
-            const value = content
-                .map((part) => {
-                const item = record(part);
-                return text(item.text) ?? '';
-            })
-                .join('');
-            if (value)
-                providerMessageTexts.add(value);
-        }
-    }
-    for (const message of compatibleMessages)
-        if (nativeTools &&
-            message.role === 'tool_call' &&
-            message.inputMode === 'freeform' &&
-            message.callId)
-            customCallIds.add(message.callId);
-    const orderedMessages = [];
-    for (const message of compatibleMessages) {
-        if (message.role === 'provider' && message.item?.type === 'configuration_update') {
-            const userIndex = orderedMessages.findLastIndex(isRealUserMessage);
-            if (userIndex >= 0) {
-                orderedMessages.splice(userIndex, 0, message);
-                continue;
-            }
-        }
-        orderedMessages.push(message);
-    }
-    // SDK records the update after the user input; the wire item must precede
-    // that user message so the new effort applies to the response.
-    return orderedMessages
-        .filter((message) => !(message.role === 'tool_call' && message.callId && providerCallIds.has(message.callId)) &&
-        !(message.role === 'assistant' && providerMessageTexts.has(message.content)))
-        .map((message) => openAiInputItem(message, message === lastUser ? images : undefined, customCallIds, functionCallIds, nativeTools, tools));
-}
-function openAiInputItem(message, images, customCallIds = new Set(), functionCallIds = new Set(), nativeTools = true, tools = []) {
-    const userImages = message.role === 'user' ? uniqueModelImages(message.images, images) : [];
-    if (message.role === 'provider') {
-        if (message.provider !== 'OPENAI_RESPONSES' || !message.item)
-            throw new MarAgentError('MAR_AGENT_MODEL_PROTOCOL_ERROR', 'Provider context item is invalid.');
-        if (message.item.type === 'configuration_update') {
-            const effort = marAgentReasoningEffortSchema.safeParse(record(message.item.reasoning).effort);
-            if (effort.success)
-                return { type: 'configuration_update', reasoning: { effort: effort.data } };
-        }
-        const item = responseItem(message.item);
-        if (!item)
-            throw new MarAgentError('MAR_AGENT_MODEL_PROTOCOL_ERROR', 'Provider context item type is unsupported.');
-        return item;
-    }
-    if (nativeTools && message.role === 'tool_call' && message.inputMode === 'freeform')
-        return {
-            type: 'custom_tool_call',
-            call_id: message.callId,
-            name: message.name,
-            input: String(message.arguments ?? '')
-        };
-    if (nativeTools && message.role === 'tool_call' && message.name === 'tool_search')
-        return {
-            type: 'tool_search_call',
-            call_id: message.callId,
-            status: 'completed',
-            execution: 'client',
-            arguments: message.arguments ?? {}
-        };
-    if (message.role === 'tool_call')
-        return {
-            type: 'function_call',
-            call_id: message.callId,
-            name: message.name,
-            arguments: JSON.stringify(message.inputMode === 'freeform'
-                ? jsonToolInput(message, tools.find((tool) => tool.name === message.name))
-                : (message.arguments ?? {}))
-        };
-    if (message.role === 'tool' &&
-        nativeTools &&
-        message.toolSearchTools &&
-        !functionCallIds.has(message.callId ?? ''))
-        return {
-            type: 'tool_search_output',
-            call_id: message.callId,
-            status: 'completed',
-            execution: 'client',
-            tools: message.toolSearchTools.map((tool) => responsesFunctionTool(tool))
-        };
-    if (message.role === 'tool')
-        return {
-            type: customCallIds.has(message.callId ?? '')
-                ? 'custom_tool_call_output'
-                : 'function_call_output',
-            call_id: message.callId,
-            output: observationModelParts(message)?.map((part) => part.type === 'text'
-                ? { type: 'input_text', text: part.text }
-                : {
-                    type: 'input_image',
-                    image_url: modelImageUrl(part.image)
-                }) ??
-                (message.textBlocks !== undefined
-                    ? [
-                        ...resolveModelTextBlocks(message.content, message.textBlocks).map((block) => ({
-                            type: 'input_text',
-                            text: block.text
-                        })),
-                        ...(message.images ?? []).map((image) => ({
-                            type: 'input_image',
-                            image_url: modelImageUrl(image)
-                        }))
-                    ]
-                    : message.images?.length
-                        ? [
-                            { type: 'input_text', text: message.content },
-                            ...message.images.map((image) => ({
-                                type: 'input_image',
-                                image_url: modelImageUrl(image)
-                            }))
-                        ]
-                        : message.content)
-        };
-    return {
-        role: message.role === 'user' && contextualAuthority(message) === 'instruction'
-            ? 'developer'
-            : message.role,
-        content: message.textBlocks !== undefined
-            ? [
-                ...resolveModelTextBlocks(message.content, message.textBlocks).map((block) => ({
-                    type: message.role === 'assistant' ? 'output_text' : 'input_text',
-                    text: block.text
-                })),
-                ...userImages.map((image) => ({
-                    type: 'input_image',
-                    image_url: modelImageUrl(image)
-                }))
-            ]
-            : userImages.length > 0
-                ? [
-                    { type: 'input_text', text: message.content },
-                    ...userImages.map((image) => ({
-                        type: 'input_image',
-                        image_url: modelImageUrl(image)
-                    }))
-                ]
-                : message.content
-    };
-}
-function contextualAuthority(message) {
-    return message.contextualBlock?.authority;
-}
-function isRealUserMessage(message) {
-    return (message.role === 'user' &&
-        message.contextKind === undefined &&
-        message.contextualBlock === undefined);
-}
-function responsesFunctionTool(tool, nativeTools = true) {
-    const strict = !hasOpenFunctionObject(tool.inputSchema);
-    return tool.inputMode === 'freeform' && nativeTools
-        ? { type: 'custom', name: tool.name, description: tool.description }
-        : {
-            type: 'function',
-            name: tool.name,
-            description: tool.description,
-            parameters: stableToolSchema(strict ? strictFunctionSchema(stableToolSchema(tool.inputSchema)) : tool.inputSchema),
-            strict
-        };
-}
-function hasOpenFunctionObject(value) {
-    if (value === null || typeof value !== 'object' || Array.isArray(value))
-        return false;
-    const schema = record(value);
-    if ((schema.type === 'object' || (Array.isArray(schema.type) && schema.type.includes('object'))) &&
-        (schema.additionalProperties === true ||
-            (schema.additionalProperties !== null && typeof schema.additionalProperties === 'object') ||
-            (schema.properties === undefined && schema.additionalProperties !== false)))
-        return true;
-    const children = [
-        ...Object.values(record(schema.properties)),
-        ...Object.values(record(schema.$defs)),
-        ...Object.values(record(schema.definitions)),
-        schema.items,
-        ...[schema.anyOf, schema.oneOf, schema.allOf].flatMap((items) => Array.isArray(items) ? items : [])
-    ];
-    return children.some(hasOpenFunctionObject);
-}
-function uniqueModelImages(...groups) {
-    const seen = new Set();
-    return groups.flatMap((group) => (group ?? []).flatMap((image) => {
-        const key = modelImageKey(image);
-        if (seen.has(key))
-            return [];
-        seen.add(key);
-        return [image];
-    }));
-}