@tanstack/openai-base 0.9.15 → 0.10.0

package/dist/esm/adapters/chat-completions-text.js

@@ -868,6 +868,7 @@ var OpenAIBaseChatCompletionsTextAdapter = class extends BaseTextAdapter {
 				}
 			};
 		}
+		if (part.type === "document") throw new Error(`${this.name} does not support document parts on the Chat Completions API; use the Responses adapter, which sends them as input_file.`);
 		return null;
 	}
 	/**

package/dist/esm/adapters/chat-completions-text.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat-completions-text.js","names":[],"sources":["../../../src/adapters/chat-completions-text.ts"],"sourcesContent":["import { EventType, normalizeSystemPrompts } from '@tanstack/ai'\nimport { BaseTextAdapter } from '@tanstack/ai/adapters'\nimport {\n  toRunErrorPayload,\n  toRunErrorRawEvent,\n} from '@tanstack/ai/adapter-internals'\nimport { generateId } from '@tanstack/ai-utils'\nimport { extractRequestOptions } from '../utils/request-options'\nimport { makeStructuredOutputCompatible } from '../utils/schema-converter'\nimport { buildChatCompletionsUsage } from '../usage'\nimport { convertToolsToChatCompletionsFormat } from './chat-completions-tool-converter'\nimport type OpenAI from 'openai'\nimport type {\n  StructuredOutputOptions,\n  StructuredOutputResult,\n} from '@tanstack/ai/adapters'\nimport type {\n  ChatCompletionChunk,\n  ChatCompletionContentPart,\n  ChatCompletionCreateParamsStreaming,\n  ChatCompletionMessageParam,\n} from 'openai/resources/chat/completions/completions'\nimport type {\n  ContentPart,\n  DefaultMessageMetadataByModality,\n  Modality,\n  ModelMessage,\n  RunFinishedEvent,\n  StreamChunk,\n  TextOptions,\n} from '@tanstack/ai'\n\n/**\n * Shared implementation of the OpenAI Chat Completions API. Holds the\n * stream-accumulator + AG-UI lifecycle logic and calls the OpenAI SDK\n * directly. Subclasses (ai-openai, ai-grok, ai-groq) construct an OpenAI\n * client with their provider-specific `baseURL` / headers and pass it in.\n */\nexport abstract class OpenAIBaseChatCompletionsTextAdapter<\n  TModel extends string,\n  TProviderOptions extends Record<string, unknown> = Record<string, unknown>,\n  TInputModalities extends ReadonlyArray<Modality> = ReadonlyArray<Modality>,\n  TMessageMetadata extends DefaultMessageMetadataByModality =\n    DefaultMessageMetadataByModality,\n  TToolCapabilities extends ReadonlyArray<string> = ReadonlyArray<string>,\n> extends BaseTextAdapter<\n  TModel,\n  TProviderOptions,\n  TInputModalities,\n  TMessageMetadata,\n  TToolCapabilities\n> {\n  override readonly kind = 'text' as const\n  readonly name: string\n  protected client: OpenAI\n\n  constructor(model: TModel, name: string, client: OpenAI) {\n    super({}, model)\n    this.name = name\n    this.client = client\n  }\n\n  async *chatStream(\n    options: TextOptions<TProviderOptions>,\n  ): AsyncIterable<StreamChunk> {\n    // AG-UI lifecycle tracking (mutable state object for ESLint compatibility)\n    const aguiState = {\n      runId: generateId(this.name),\n      threadId: options.threadId ?? generateId(this.name),\n      messageId: generateId(this.name),\n      hasEmittedRunStarted: false,\n    }\n\n    try {\n      // mapOptionsToRequest can throw (e.g. fail-loud guards in convertMessage\n      // for empty content or unsupported parts). Keep it inside the try so\n      // those failures surface as a single RUN_ERROR event, matching every\n      // other failure mode here — callers iterating chatStream then only need\n      // one error-handling path instead of both a try/catch around iteration\n      // and a RUN_ERROR handler.\n      const requestParams = this.mapOptionsToRequest(options)\n      options.logger.request(\n        `activity=chat provider=${this.name} model=${this.model} messages=${options.messages.length} tools=${options.tools?.length ?? 0} stream=true`,\n        { provider: this.name, model: this.model },\n      )\n      const stream = await this.client.chat.completions.create(\n        {\n          ...requestParams,\n          stream: true,\n          stream_options: { include_usage: true },\n        },\n        extractRequestOptions(options.request),\n      )\n\n      yield* this.processStreamChunks(stream, options, aguiState)\n    } catch (error: unknown) {\n      // Narrow before logging: raw SDK errors can carry request metadata\n      // (including auth headers) which we must never surface to user loggers.\n      const errorPayload = toRunErrorPayload(\n        error,\n        `${this.name}.chatStream failed`,\n      )\n      const rawEvent = toRunErrorRawEvent(error)\n\n      // Emit RUN_STARTED if not yet emitted\n      if (!aguiState.hasEmittedRunStarted) {\n        aguiState.hasEmittedRunStarted = true\n        yield {\n          type: EventType.RUN_STARTED,\n          runId: aguiState.runId,\n          threadId: aguiState.threadId,\n          model: options.model,\n          timestamp: Date.now(),\n          parentRunId: options.parentRunId,\n        }\n      }\n\n      const rejectedToolCall = this.extractRejectedToolCall(\n        rawEvent,\n        errorPayload.message,\n      )\n      if (rejectedToolCall) {\n        const toolCallId = generateId(this.name)\n        yield {\n          type: EventType.TOOL_CALL_START,\n          toolCallId,\n          toolCallName: rejectedToolCall.toolName,\n          toolName: rejectedToolCall.toolName,\n          parentMessageId: aguiState.messageId,\n          model: options.model,\n          timestamp: Date.now(),\n        }\n        yield {\n          type: EventType.TOOL_CALL_ARGS,\n          toolCallId,\n          delta: rejectedToolCall.arguments,\n          args: rejectedToolCall.arguments,\n          model: options.model,\n          timestamp: Date.now(),\n        }\n        yield {\n          type: EventType.TOOL_CALL_END,\n          toolCallId,\n          toolCallName: rejectedToolCall.toolName,\n          toolName: rejectedToolCall.toolName,\n          ...(rejectedToolCall.input !== undefined && {\n            input: rejectedToolCall.input,\n          }),\n          result: JSON.stringify({ error: rejectedToolCall.error }),\n          state: 'output-error',\n          model: options.model,\n          timestamp: Date.now(),\n        }\n        yield {\n          type: EventType.RUN_FINISHED,\n          runId: aguiState.runId,\n          threadId: aguiState.threadId,\n          model: options.model,\n          timestamp: Date.now(),\n          finishReason: 'tool_calls',\n        }\n        return\n      }\n\n      // Emit AG-UI RUN_ERROR. Conditional `code` spread keeps the wire\n      // shape spec-compliant under `exactOptionalPropertyTypes`: AG-UI's\n      // `RunErrorEvent.code` is `string?` (absent vs explicit `undefined`\n      // matter), so we omit the key when there's no code.\n      yield {\n        type: EventType.RUN_ERROR,\n        model: options.model,\n        timestamp: Date.now(),\n        message: errorPayload.message,\n        code: errorPayload.code,\n        // Forward the provider's structured error body so consumers can recover\n        // the upstream detail the `{ message, code }` payload drops. Omitted\n        // when the error carried no provider body (see toRunErrorRawEvent).\n        ...(rawEvent !== undefined && { rawEvent }),\n        error: {\n          message: errorPayload.message,\n          code: errorPayload.code,\n        },\n      }\n\n      options.logger.errors(`${this.name}.chatStream fatal`, {\n        error: errorPayload,\n        source: `${this.name}.chatStream`,\n      })\n    }\n  }\n\n  /**\n   * Extracts a rejected tool call from a provider error. Returned calls are\n   * emitted as non-executable `output-error` results so the model can repair them.\n   */\n  protected extractRejectedToolCall(\n    _rawEvent: unknown,\n    _fallbackMessage: string,\n  ):\n    | {\n        toolName: string\n        arguments: string\n        input?: unknown\n        error: string\n      }\n    | undefined {\n    return undefined\n  }\n\n  /**\n   * Generate structured output using the provider's JSON Schema response format.\n   * Uses stream: false to get the complete response in one call.\n   *\n   * OpenAI-compatible APIs have strict requirements for structured output:\n   * - All properties must be in the `required` array\n   * - Optional fields should have null added to their type union\n   * - additionalProperties must be false for all objects\n   *\n   * The outputSchema is already JSON Schema (converted in the ai layer).\n   * We apply provider-specific transformations for structured output compatibility.\n   */\n  async structuredOutput(\n    options: StructuredOutputOptions<TProviderOptions>,\n  ): Promise<StructuredOutputResult<unknown>> {\n    const { chatOptions, outputSchema } = options\n    const requestParams = this.mapOptionsToRequest(chatOptions)\n\n    const jsonSchema = this.makeStructuredOutputCompatible(\n      outputSchema,\n      outputSchema.required,\n    )\n\n    try {\n      // Strip stream_options which is only valid for streaming calls\n      const {\n        stream_options: _,\n        stream: __,\n        ...cleanParams\n      } = requestParams as any\n      chatOptions.logger.request(\n        `activity=structuredOutput provider=${this.name} model=${this.model} messages=${chatOptions.messages.length}`,\n        { provider: this.name, model: this.model },\n      )\n      const response = await this.client.chat.completions.create(\n        {\n          ...cleanParams,\n          stream: false,\n          response_format: {\n            type: 'json_schema',\n            json_schema: {\n              name: 'structured_output',\n              schema: jsonSchema,\n              strict: true,\n            },\n          },\n        },\n        extractRequestOptions(chatOptions.request),\n      )\n\n      // Extract text content from the response. Fail loud on empty content\n      // rather than letting it cascade into a JSON-parse error on '' — the\n      // root cause (the model returned no content for the structured request)\n      // is then visible in logs.\n      const rawText = response.choices[0]?.message.content\n      if (typeof rawText !== 'string' || rawText.length === 0) {\n        throw new Error(\n          `${this.name}.structuredOutput: response contained no content`,\n        )\n      }\n\n      // Parse the JSON response\n      let parsed: unknown\n      try {\n        parsed = JSON.parse(rawText)\n      } catch {\n        throw new Error(\n          `Failed to parse structured output as JSON. Content: ${rawText.slice(0, 200)}${rawText.length > 200 ? '...' : ''}`,\n        )\n      }\n\n      // Final provider-specific shaping pass (default passthrough). Null-widening\n      // from strict mode is undone by the engine, not here.\n      const transformed = this.transformStructuredOutput(parsed)\n\n      // Surface usage so non-stream structured paths (and\n      // fallbackStructuredOutputStream) can forward tokens to middleware.\n      const usage = buildChatCompletionsUsage(response.usage)\n      return {\n        data: transformed,\n        rawText,\n        ...(usage && { usage }),\n      }\n    } catch (error: unknown) {\n      // Narrow before logging: raw SDK errors can carry request metadata\n      // (including auth headers) which we must never surface to user loggers.\n      chatOptions.logger.errors(`${this.name}.structuredOutput fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.structuredOutput failed`),\n        source: `${this.name}.structuredOutput`,\n      })\n      throw error\n    }\n  }\n\n  /**\n   * Stream structured output. Single Chat Completions request with\n   * `response_format: json_schema` + `stream: true`. Emits the standard\n   * AG-UI lifecycle (`RUN_STARTED` → `REASONING_*?` → `TEXT_MESSAGE_*`\n   * carrying raw JSON deltas → terminal `CUSTOM 'structured-output.complete'`\n   * → `RUN_FINISHED`). Subclasses use the same SDK-call / reasoning /\n   * structured-output-transform hooks as `chatStream` / `structuredOutput` —\n   * no per-subclass override should be needed.\n   */\n  async *structuredOutputStream(\n    options: StructuredOutputOptions<TProviderOptions>,\n  ): AsyncIterable<StreamChunk> {\n    const { chatOptions, outputSchema } = options\n    const requestParams = this.mapOptionsToRequest(chatOptions)\n\n    const jsonSchema = this.makeStructuredOutputCompatible(\n      outputSchema,\n      outputSchema.required,\n    )\n\n    const aguiState = {\n      runId: generateId(this.name),\n      threadId: chatOptions.threadId ?? generateId(this.name),\n      messageId: generateId(this.name),\n      hasEmittedRunStarted: false,\n    }\n\n    let accumulatedContent = ''\n    let accumulatedReasoning = ''\n    let hasEmittedTextMessageStart = false\n    let reasoningMessageId: string | undefined\n    let hasClosedReasoning = false\n    let stepId: string | undefined\n    let lastModel: string | undefined\n    let lastUsage:\n      | OpenAI.Chat.Completions.ChatCompletionChunk['usage']\n      | undefined\n\n    const closeReasoningLifecycle = function* (this: {\n      name: string\n    }): Generator<StreamChunk> {\n      if (reasoningMessageId && !hasClosedReasoning) {\n        hasClosedReasoning = true\n        yield {\n          type: EventType.REASONING_MESSAGE_END,\n          messageId: reasoningMessageId,\n          model: lastModel || chatOptions.model,\n          timestamp: Date.now(),\n        }\n        yield {\n          type: EventType.REASONING_END,\n          messageId: reasoningMessageId,\n          model: lastModel || chatOptions.model,\n          timestamp: Date.now(),\n        }\n        if (stepId) {\n          yield {\n            type: EventType.STEP_FINISHED,\n            stepName: stepId,\n            stepId,\n            model: lastModel || chatOptions.model,\n            timestamp: Date.now(),\n            content: accumulatedReasoning,\n          }\n        }\n      }\n    }.bind(this)\n\n    try {\n      // Strip stream_options + tools from the base request. Structured output\n      // sends `response_format: json_schema` and doesn't carry tools — keeping\n      // them in the request can confuse strict-mode validation upstream.\n      const {\n        stream_options: _so,\n        stream: _s,\n        tools: _t,\n        ...cleanParams\n      } = requestParams\n\n      chatOptions.logger.request(\n        `activity=structuredOutputStream provider=${this.name} model=${this.model} messages=${chatOptions.messages.length}`,\n        { provider: this.name, model: this.model },\n      )\n\n      const stream = await this.client.chat.completions.create(\n        {\n          ...cleanParams,\n          stream: true,\n          stream_options: { include_usage: true },\n          response_format: {\n            type: 'json_schema',\n            json_schema: {\n              name: 'structured_output',\n              schema: jsonSchema,\n              strict: true,\n            },\n          },\n        },\n        extractRequestOptions(chatOptions.request),\n      )\n\n      for await (const chunk of stream) {\n        const choiceForLog = chunk.choices[0]\n        chatOptions.logger.provider(\n          `provider=${this.name} finish_reason=${choiceForLog?.finish_reason ?? 'none'} hasContent=${!!choiceForLog?.delta.content} hasUsage=${!!chunk.usage}`,\n          { provider: this.name, model: chunk.model },\n        )\n\n        if (chunk.model) lastModel = chunk.model\n\n        // Usage may arrive on a chunk with empty `choices` (OpenAI's\n        // include_usage terminal chunk) or piggybacked on a finish chunk\n        // (`x_groq.usage` on Groq). Capture from either independent of\n        // choices[0].\n        const usage =\n          chunk.usage ??\n          (chunk as { x_groq?: { usage?: typeof chunk.usage } }).x_groq?.usage\n        if (usage) lastUsage = usage\n\n        if (!aguiState.hasEmittedRunStarted) {\n          aguiState.hasEmittedRunStarted = true\n          yield {\n            type: EventType.RUN_STARTED,\n            runId: aguiState.runId,\n            threadId: aguiState.threadId,\n            model: chunk.model || chatOptions.model,\n            timestamp: Date.now(),\n            parentRunId: chatOptions.parentRunId,\n          }\n        }\n\n        // Reasoning (via the extractReasoning hook — same hook as chatStream).\n        const reasoning = this.extractReasoning(chunk)\n        if (reasoning && reasoning.text) {\n          if (!reasoningMessageId) {\n            reasoningMessageId = generateId(this.name)\n            stepId = generateId(this.name)\n            yield {\n              type: EventType.REASONING_START,\n              messageId: reasoningMessageId,\n              model: chunk.model || chatOptions.model,\n              timestamp: Date.now(),\n            }\n            yield {\n              type: EventType.REASONING_MESSAGE_START,\n              messageId: reasoningMessageId,\n              role: 'reasoning' as const,\n              model: chunk.model || chatOptions.model,\n              timestamp: Date.now(),\n            }\n            yield {\n              type: EventType.STEP_STARTED,\n              stepName: stepId,\n              stepId,\n              model: chunk.model || chatOptions.model,\n              timestamp: Date.now(),\n              stepType: 'thinking',\n            }\n          }\n          accumulatedReasoning += reasoning.text\n          yield {\n            type: EventType.REASONING_MESSAGE_CONTENT,\n            messageId: reasoningMessageId,\n            delta: reasoning.text,\n            model: chunk.model || chatOptions.model,\n            timestamp: Date.now(),\n          }\n        }\n\n        const choice = chunk.choices[0]\n        if (!choice) continue\n\n        const deltaContent = choice.delta.content\n        if (deltaContent) {\n          yield* closeReasoningLifecycle()\n\n          if (!hasEmittedTextMessageStart) {\n            hasEmittedTextMessageStart = true\n            yield {\n              type: EventType.TEXT_MESSAGE_START,\n              messageId: aguiState.messageId,\n              model: chunk.model || chatOptions.model,\n              timestamp: Date.now(),\n              role: 'assistant',\n            }\n          }\n\n          accumulatedContent += deltaContent\n\n          yield {\n            type: EventType.TEXT_MESSAGE_CONTENT,\n            messageId: aguiState.messageId,\n            model: chunk.model || chatOptions.model,\n            timestamp: Date.now(),\n            delta: deltaContent,\n            content: accumulatedContent,\n          }\n        }\n      }\n\n      // Finalisation: close any open lifecycle, parse + validate, emit\n      // terminal events. This block always runs unless the loop threw — abort\n      // and SDK errors land in the catch block below.\n      yield* closeReasoningLifecycle()\n\n      if (hasEmittedTextMessageStart) {\n        yield {\n          type: EventType.TEXT_MESSAGE_END,\n          messageId: aguiState.messageId,\n          model: lastModel || chatOptions.model,\n          timestamp: Date.now(),\n        }\n      }\n\n      if (accumulatedContent.length === 0) {\n        yield {\n          type: EventType.RUN_ERROR,\n          runId: aguiState.runId,\n          model: lastModel || chatOptions.model,\n          timestamp: Date.now(),\n          message: `${this.name}.structuredOutputStream: response contained no content`,\n          code: 'empty-response',\n          error: {\n            message: `${this.name}.structuredOutputStream: response contained no content`,\n            code: 'empty-response',\n          },\n        }\n        return\n      }\n\n      let parsed: unknown\n      try {\n        parsed = JSON.parse(accumulatedContent)\n      } catch {\n        yield {\n          type: EventType.RUN_ERROR,\n          runId: aguiState.runId,\n          model: lastModel || chatOptions.model,\n          timestamp: Date.now(),\n          message: `Failed to parse structured output as JSON. Content: ${accumulatedContent.slice(0, 200)}${accumulatedContent.length > 200 ? '...' : ''}`,\n          code: 'parse-error',\n          error: {\n            message: 'Failed to parse structured output as JSON',\n            code: 'parse-error',\n          },\n        }\n        return\n      }\n\n      const transformed = this.transformStructuredOutput(parsed)\n\n      yield {\n        type: EventType.CUSTOM,\n        name: 'structured-output.complete',\n        value: {\n          object: transformed,\n          raw: accumulatedContent,\n          ...(accumulatedReasoning ? { reasoning: accumulatedReasoning } : {}),\n        },\n        model: lastModel || chatOptions.model,\n        timestamp: Date.now(),\n      }\n\n      yield {\n        type: EventType.RUN_FINISHED,\n        runId: aguiState.runId,\n        threadId: aguiState.threadId,\n        model: lastModel || chatOptions.model,\n        timestamp: Date.now(),\n        finishReason: 'stop',\n        ...(lastUsage && {\n          usage: buildChatCompletionsUsage(lastUsage),\n        }),\n      }\n    } catch (error: unknown) {\n      if (!aguiState.hasEmittedRunStarted) {\n        aguiState.hasEmittedRunStarted = true\n        yield {\n          type: EventType.RUN_STARTED,\n          runId: aguiState.runId,\n          threadId: aguiState.threadId,\n          model: chatOptions.model,\n          timestamp: Date.now(),\n          parentRunId: chatOptions.parentRunId,\n        }\n      }\n\n      const isAbort = this.isAbortError(error)\n      const errorPayload = toRunErrorPayload(\n        error,\n        `${this.name}.structuredOutputStream failed`,\n      )\n\n      // Conditional `code` spread keeps the wire shape spec-compliant under\n      // `exactOptionalPropertyTypes`: AG-UI's `RunErrorEvent.code` is `string?`\n      // (absent vs explicit `undefined` matter).\n      const resolvedCode = isAbort ? 'aborted' : errorPayload.code\n      const rawEvent = isAbort ? undefined : toRunErrorRawEvent(error)\n      yield {\n        type: EventType.RUN_ERROR,\n        runId: aguiState.runId,\n        model: lastModel || chatOptions.model,\n        timestamp: Date.now(),\n        message: errorPayload.message,\n        ...(resolvedCode !== undefined && { code: resolvedCode }),\n        ...(rawEvent !== undefined && { rawEvent }),\n        error: {\n          message: errorPayload.message,\n          ...(resolvedCode !== undefined && { code: resolvedCode }),\n        },\n      }\n\n      chatOptions.logger.errors(`${this.name}.structuredOutputStream fatal`, {\n        error: errorPayload,\n        source: `${this.name}.structuredOutputStream`,\n      })\n    }\n  }\n\n  /**\n   * Cross-SDK abort detection for `structuredOutputStream`. Default duck-types\n   * on `name === 'APIUserAbortError'` (OpenAI SDK), `code === 'ERR_CANCELED'`,\n   * and standard `AbortError`s. Subclasses with proprietary error types (e.g.\n   * `@openrouter/sdk`'s `RequestAbortedError`) override to extend the check.\n   */\n  protected isAbortError(error: unknown): boolean {\n    if (!error || typeof error !== 'object') return false\n    const e = error as { name?: unknown; code?: unknown }\n    return (\n      e.name === 'APIUserAbortError' ||\n      e.name === 'AbortError' ||\n      e.code === 'ERR_CANCELED'\n    )\n  }\n\n  /**\n   * Applies provider-specific transformations for structured output compatibility.\n   * Override this in subclasses to handle provider-specific quirks.\n   */\n  protected makeStructuredOutputCompatible(\n    schema: Record<string, any>,\n    originalRequired?: Array<string>,\n  ): Record<string, any> {\n    return makeStructuredOutputCompatible(schema, originalRequired)\n  }\n\n  /**\n   * Extract reasoning content from a stream chunk. Default returns\n   * `undefined` because the OpenAI Chat Completions chunk shape doesn't\n   * carry reasoning. The chunk param is typed `unknown` so an override can\n   * narrow to its own SDK chunk type without an `as` dance — the base only\n   * passes through `processStreamChunks`'s structurally-iterated chunk.\n   */\n  protected extractReasoning(_chunk: unknown): { text: string } | undefined {\n    return undefined\n  }\n\n  /**\n   * Final shaping pass applied to parsed structured-output JSON before it is\n   * returned to the caller. Default is a passthrough.\n   *\n   * Provider `null`s are no longer stripped here: strict-mode null-widening is\n   * now undone precisely by the engine (`undoNullWidening`, driven by the\n   * schema's null-widening map) the moment the result is captured, so a blind\n   * `transformNullsToUndefined` at the adapter would only destroy genuine\n   * `.nullable()` nulls. Subclasses may still override to remap or reshape the\n   * provider's structured output.\n   */\n  protected transformStructuredOutput(parsed: unknown): unknown {\n    return parsed\n  }\n\n  /**\n   * Processes streamed chunks from the Chat Completions API and yields AG-UI events.\n   * Override this in subclasses to handle provider-specific stream behavior.\n   */\n  protected async *processStreamChunks(\n    stream: AsyncIterable<ChatCompletionChunk>,\n    options: TextOptions,\n    aguiState: {\n      runId: string\n      threadId: string\n      messageId: string\n      hasEmittedRunStarted: boolean\n    },\n  ): AsyncIterable<StreamChunk> {\n    let accumulatedContent = ''\n    let hasEmittedTextMessageStart = false\n    let lastModel: string | undefined\n    // Track usage from any chunk that carries it. With\n    // `stream_options: { include_usage: true }` OpenAI emits a terminal chunk\n    // whose `choices` is `[]` and only the `usage` field is populated; the\n    // earlier `finish_reason` chunk does NOT include token counts. We must\n    // therefore defer RUN_FINISHED until the iterator is exhausted so we can\n    // pick up usage from the trailing chunk regardless of arrival order.\n    let lastUsage: ChatCompletionChunk['usage'] | undefined\n    let pendingFinishReason:\n      | ChatCompletionChunk['choices'][number]['finish_reason']\n      | undefined\n\n    // Track tool calls being streamed (arguments come in chunks)\n    const toolCallsInProgress = new Map<\n      number,\n      {\n        id: string\n        name: string\n        arguments: string\n        started: boolean // Track if TOOL_CALL_START has been emitted\n      }\n    >()\n\n    // Reasoning lifecycle (driven by extractReasoning() hook — see method\n    // docs). The base wire format (OpenAI Chat Completions) has no reasoning,\n    // so these stay unused for openai/grok/groq. OpenRouter etc. opt in.\n    let reasoningMessageId: string | undefined\n    let hasClosedReasoning = false\n    // Legacy STEP_STARTED/STEP_FINISHED pair emitted alongside REASONING_*\n    // for back-compat with consumers (UI, devtools) that haven't migrated\n    // to the spec REASONING_* events yet.\n    let stepId: string | undefined\n    let accumulatedReasoning = ''\n    // Track whether ANY tool call lifecycle was actually completed across the\n    // entire stream. Lets us downgrade a `tool_calls` finish_reason to `stop`\n    // when the upstream signalled tool calls but never produced a complete\n    // start/end pair — emitting RUN_FINISHED { finishReason: 'tool_calls' }\n    // with no matching TOOL_CALL_END would leave consumers waiting for tool\n    // results that never arrive.\n    let emittedAnyToolCallEnd = false\n\n    try {\n      for await (const chunk of stream) {\n        const choiceForLog = chunk.choices[0]\n        options.logger.provider(\n          `provider=${this.name} finish_reason=${choiceForLog?.finish_reason ?? 'none'} hasContent=${!!choiceForLog?.delta.content} hasToolCalls=${!!choiceForLog?.delta.tool_calls} hasUsage=${!!chunk.usage}`,\n          { provider: this.name, model: chunk.model },\n        )\n\n        // Capture usage from any chunk (including the terminal usage-only\n        // chunk emitted when `stream_options.include_usage` is on).\n        if (chunk.usage) {\n          lastUsage = chunk.usage\n        }\n        if (chunk.model) {\n          lastModel = chunk.model\n        }\n\n        // Emit RUN_STARTED on the first chunk of any kind so callers see a\n        // run lifecycle even on streams that arrive entirely as usage-only\n        // (no choices). Without this, a usage-first stream would skip\n        // RUN_STARTED via `if (!choice) continue` below and the post-loop\n        // synthetic block would also skip RUN_FINISHED (it gates on\n        // `hasEmittedRunStarted`).\n        if (!aguiState.hasEmittedRunStarted) {\n          aguiState.hasEmittedRunStarted = true\n          yield {\n            type: EventType.RUN_STARTED,\n            runId: aguiState.runId,\n            threadId: aguiState.threadId,\n            model: chunk.model || options.model,\n            timestamp: Date.now(),\n            parentRunId: options.parentRunId,\n          }\n        }\n\n        // Reasoning content (extractReasoning() hook). Run before reading\n        // choice/delta so reasoning-only chunks (no `choices`) still drive\n        // the REASONING_* lifecycle on providers that send reasoning out of\n        // band. The base default returns undefined.\n        const reasoning = this.extractReasoning(chunk)\n        if (reasoning && reasoning.text) {\n          if (!reasoningMessageId) {\n            reasoningMessageId = generateId(this.name)\n            stepId = generateId(this.name)\n            yield {\n              type: EventType.REASONING_START,\n              messageId: reasoningMessageId,\n              model: chunk.model || options.model,\n              timestamp: Date.now(),\n            }\n            yield {\n              type: EventType.REASONING_MESSAGE_START,\n              messageId: reasoningMessageId,\n              role: 'reasoning' as const,\n              model: chunk.model || options.model,\n              timestamp: Date.now(),\n            }\n            // Legacy STEP_STARTED (single emission, paired with the\n            // STEP_FINISHED below when reasoning closes).\n            yield {\n              type: EventType.STEP_STARTED,\n              stepName: stepId,\n              stepId,\n              model: chunk.model || options.model,\n              timestamp: Date.now(),\n              stepType: 'thinking',\n            }\n          }\n          accumulatedReasoning += reasoning.text\n          yield {\n            type: EventType.REASONING_MESSAGE_CONTENT,\n            messageId: reasoningMessageId,\n            delta: reasoning.text,\n            model: chunk.model || options.model,\n            timestamp: Date.now(),\n          }\n        }\n\n        const choice = chunk.choices[0]\n\n        if (!choice) continue\n\n        const delta = choice.delta\n        const deltaContent = delta.content\n        const deltaToolCalls = delta.tool_calls\n\n        // Handle content delta\n        if (deltaContent) {\n          // Close reasoning before text starts so consumers see a clean\n          // REASONING_END before any TEXT_MESSAGE_START.\n          if (reasoningMessageId && !hasClosedReasoning) {\n            hasClosedReasoning = true\n            yield {\n              type: EventType.REASONING_MESSAGE_END,\n              messageId: reasoningMessageId,\n              model: chunk.model || options.model,\n              timestamp: Date.now(),\n            }\n            yield {\n              type: EventType.REASONING_END,\n              messageId: reasoningMessageId,\n              model: chunk.model || options.model,\n              timestamp: Date.now(),\n            }\n            if (stepId) {\n              yield {\n                type: EventType.STEP_FINISHED,\n                stepName: stepId,\n                stepId,\n                model: chunk.model || options.model,\n                timestamp: Date.now(),\n                content: accumulatedReasoning,\n              }\n            }\n          }\n\n          // Emit TEXT_MESSAGE_START on first text content\n          if (!hasEmittedTextMessageStart) {\n            hasEmittedTextMessageStart = true\n            yield {\n              type: EventType.TEXT_MESSAGE_START,\n              messageId: aguiState.messageId,\n              model: chunk.model || options.model,\n              timestamp: Date.now(),\n              role: 'assistant',\n            }\n          }\n\n          accumulatedContent += deltaContent\n\n          // Emit AG-UI TEXT_MESSAGE_CONTENT\n          yield {\n            type: EventType.TEXT_MESSAGE_CONTENT,\n            messageId: aguiState.messageId,\n            model: chunk.model || options.model,\n            timestamp: Date.now(),\n            delta: deltaContent,\n            content: accumulatedContent,\n          }\n        }\n\n        // Handle tool calls - they come in as deltas\n        if (deltaToolCalls) {\n          for (const toolCallDelta of deltaToolCalls) {\n            const index = toolCallDelta.index\n\n            // Initialize or update the tool call in progress\n            let toolCall = toolCallsInProgress.get(index)\n            if (!toolCall) {\n              toolCall = {\n                id: toolCallDelta.id || '',\n                name: toolCallDelta.function?.name || '',\n                arguments: '',\n                started: false,\n              }\n              toolCallsInProgress.set(index, toolCall)\n            }\n\n            // Update with any new data from the delta\n            if (toolCallDelta.id) {\n              toolCall.id = toolCallDelta.id\n            }\n            if (toolCallDelta.function?.name) {\n              toolCall.name = toolCallDelta.function.name\n            }\n            if (toolCallDelta.function?.arguments) {\n              toolCall.arguments += toolCallDelta.function.arguments\n            }\n\n            // Emit TOOL_CALL_START when we have id and name\n            if (toolCall.id && toolCall.name && !toolCall.started) {\n              toolCall.started = true\n              yield {\n                type: EventType.TOOL_CALL_START,\n                toolCallId: toolCall.id,\n                toolCallName: toolCall.name,\n                toolName: toolCall.name,\n                parentMessageId: aguiState.messageId,\n                model: chunk.model || options.model,\n                timestamp: Date.now(),\n                index,\n              }\n            }\n\n            // Emit TOOL_CALL_ARGS for argument deltas\n            if (toolCallDelta.function?.arguments && toolCall.started) {\n              yield {\n                type: EventType.TOOL_CALL_ARGS,\n                toolCallId: toolCall.id,\n                model: chunk.model || options.model,\n                timestamp: Date.now(),\n                delta: toolCallDelta.function.arguments,\n              }\n            }\n          }\n        }\n\n        // Handle finish reason. We DO emit TOOL_CALL_END and TEXT_MESSAGE_END\n        // here because the corresponding _START events have already fired,\n        // and tool execution downstream wants to begin as soon as possible.\n        // RUN_FINISHED is deferred until the iterator is fully exhausted so\n        // we can capture the trailing usage chunk that arrives AFTER this\n        // chunk when stream_options.include_usage is on.\n        if (choice.finish_reason) {\n          if (\n            choice.finish_reason === 'tool_calls' ||\n            toolCallsInProgress.size > 0\n          ) {\n            for (const [, toolCall] of toolCallsInProgress) {\n              // Skip tool calls that never emitted TOOL_CALL_START — emitting\n              // a stray TOOL_CALL_END here would violate AG-UI lifecycle\n              // (END without matching START) for partial deltas where the\n              // upstream never sent both id and name.\n              if (!toolCall.started) continue\n\n              // Parse arguments for TOOL_CALL_END. Surface parse failures via\n              // the logger so a model emitting malformed JSON for tool args\n              // is debuggable instead of silently invoking the tool with {}.\n              // Non-object JSON (e.g. a bare string or number) is also coerced\n              // to {} so downstream tool execution doesn't receive a primitive\n              // input, mirroring the Responses adapter's guard.\n              let parsedInput: unknown = {}\n              if (toolCall.arguments) {\n                try {\n                  const parsed: unknown = JSON.parse(toolCall.arguments)\n                  parsedInput =\n                    parsed && typeof parsed === 'object' ? parsed : {}\n                } catch (parseError) {\n                  options.logger.errors(\n                    `${this.name}.processStreamChunks tool-args JSON parse failed`,\n                    {\n                      error: toRunErrorPayload(\n                        parseError,\n                        `tool ${toolCall.name} (${toolCall.id}) returned malformed JSON arguments`,\n                      ),\n                      source: `${this.name}.processStreamChunks`,\n                      toolCallId: toolCall.id,\n                      toolName: toolCall.name,\n                      rawArguments: toolCall.arguments,\n                    },\n                  )\n                  parsedInput = {}\n                }\n              }\n\n              // Emit AG-UI TOOL_CALL_END\n              yield {\n                type: EventType.TOOL_CALL_END,\n                toolCallId: toolCall.id,\n                toolCallName: toolCall.name,\n                toolName: toolCall.name,\n                model: chunk.model || options.model,\n                timestamp: Date.now(),\n                input: parsedInput,\n              }\n              emittedAnyToolCallEnd = true\n            }\n            // Clear tool-call state after emission so a subsequent\n            // `finish_reason: 'stop'` chunk (or the post-loop synthetic\n            // block) doesn't see lingering entries and misreport the finish.\n            toolCallsInProgress.clear()\n          }\n\n          // Emit TEXT_MESSAGE_END if we had text content\n          if (hasEmittedTextMessageStart) {\n            yield {\n              type: EventType.TEXT_MESSAGE_END,\n              messageId: aguiState.messageId,\n              model: chunk.model || options.model,\n              timestamp: Date.now(),\n            }\n            hasEmittedTextMessageStart = false\n          }\n\n          // Remember the upstream finish_reason; RUN_FINISHED is emitted at\n          // end-of-stream so we pick up the trailing usage-only chunk too.\n          pendingFinishReason = choice.finish_reason\n        }\n      }\n\n      // Emit a single terminal RUN_FINISHED after the iterator is exhausted.\n      // This both delivers accurate token counts (the trailing usage chunk\n      // may arrive AFTER the finish_reason chunk) and gives consumers a\n      // guaranteed terminal event even when the upstream cuts off mid-stream\n      // (no finish_reason chunk ever arrives).\n      if (aguiState.hasEmittedRunStarted) {\n        // Close any started tool calls that never got finish_reason. A\n        // truncated stream that emitted TOOL_CALL_START but never reached\n        // finish_reason would otherwise leave consumers with an unbalanced\n        // start. Skip non-started entries (no matching START to close).\n        let pendingToolCount = 0\n        for (const [, toolCall] of toolCallsInProgress) {\n          if (!toolCall.started) continue\n          let parsedInput: unknown = {}\n          if (toolCall.arguments) {\n            try {\n              const parsed: unknown = JSON.parse(toolCall.arguments)\n              parsedInput = parsed && typeof parsed === 'object' ? parsed : {}\n            } catch (parseError) {\n              // Mirror the finish_reason path's logger call — a truncated\n              // stream emitting malformed tool-call JSON would otherwise\n              // silently invoke the tool with `{}`, the exact failure the\n              // finish_reason logger was added to prevent.\n              options.logger.errors(\n                `${this.name}.processStreamChunks tool-args JSON parse failed (drain)`,\n                {\n                  error: toRunErrorPayload(\n                    parseError,\n                    `tool ${toolCall.name} (${toolCall.id}) returned malformed JSON arguments`,\n                  ),\n                  source: `${this.name}.processStreamChunks`,\n                  toolCallId: toolCall.id,\n                  toolName: toolCall.name,\n                  rawArguments: toolCall.arguments,\n                },\n              )\n              parsedInput = {}\n            }\n          }\n          yield {\n            type: EventType.TOOL_CALL_END,\n            toolCallId: toolCall.id,\n            toolCallName: toolCall.name,\n            toolName: toolCall.name,\n            model: lastModel || options.model,\n            timestamp: Date.now(),\n            input: parsedInput,\n          }\n          pendingToolCount += 1\n          emittedAnyToolCallEnd = true\n        }\n        toolCallsInProgress.clear()\n\n        // Make sure the text message lifecycle is closed even on early\n        // termination paths where finish_reason never arrives.\n        if (hasEmittedTextMessageStart) {\n          yield {\n            type: EventType.TEXT_MESSAGE_END,\n            messageId: aguiState.messageId,\n            model: lastModel || options.model,\n            timestamp: Date.now(),\n          }\n        }\n\n        // Close any reasoning lifecycle that text never closed (no text\n        // content arrived, or the stream cut off before text started).\n        if (reasoningMessageId && !hasClosedReasoning) {\n          hasClosedReasoning = true\n          yield {\n            type: EventType.REASONING_MESSAGE_END,\n            messageId: reasoningMessageId,\n            model: lastModel || options.model,\n            timestamp: Date.now(),\n          }\n          yield {\n            type: EventType.REASONING_END,\n            messageId: reasoningMessageId,\n            model: lastModel || options.model,\n            timestamp: Date.now(),\n          }\n          if (stepId) {\n            yield {\n              type: EventType.STEP_FINISHED,\n              stepName: stepId,\n              stepId,\n              model: lastModel || options.model,\n              timestamp: Date.now(),\n              content: accumulatedReasoning,\n            }\n          }\n        }\n\n        // Map upstream finish_reason to AG-UI's narrower vocabulary.\n        // Collapsing length / content_filter to 'stop' would hide why the\n        // run terminated — surface it instead. Use `tool_calls` only when\n        // a TOOL_CALL_END was actually emitted: an upstream that signalled\n        // `tool_calls` but never produced a started/ended pair must NOT\n        // surface `tool_calls` here, since downstream consumers wait for\n        // tool results that would never arrive. OpenAI's legacy\n        // `function_call` value (from the v1 function-calling API) is\n        // normalized to `tool_calls` — semantically the same termination.\n        const finishReason: NonNullable<RunFinishedEvent['finishReason']> =\n          emittedAnyToolCallEnd\n            ? 'tool_calls'\n            : pendingFinishReason === 'tool_calls'\n              ? 'stop'\n              : pendingFinishReason === 'function_call'\n                ? 'tool_calls'\n                : (pendingFinishReason ?? 'stop')\n\n        // Conditional `usage` spread: AG-UI's `RunFinishedEvent.usage` is\n        // optional with no `| undefined`; omit the key entirely when no usage\n        // arrived rather than emitting `usage: undefined`.\n        yield {\n          type: EventType.RUN_FINISHED,\n          runId: aguiState.runId,\n          threadId: aguiState.threadId,\n          model: lastModel || options.model,\n          timestamp: Date.now(),\n          ...(lastUsage && {\n            usage: buildChatCompletionsUsage(lastUsage),\n          }),\n          finishReason,\n        }\n      }\n    } catch (error: unknown) {\n      // Narrow before logging: raw SDK errors can carry request metadata\n      // (including auth headers) which we must never surface to user loggers.\n      const errorPayload = toRunErrorPayload(\n        error,\n        `${this.name}.processStreamChunks failed`,\n      )\n      const rawEvent = toRunErrorRawEvent(error)\n      options.logger.errors(`${this.name}.processStreamChunks fatal`, {\n        error: errorPayload,\n        source: `${this.name}.processStreamChunks`,\n      })\n\n      // Emit AG-UI RUN_ERROR with conditional `code` spread (see chatStream's\n      // catch block for the rationale). `rawEvent` carries the provider's\n      // structured error body when present.\n      yield {\n        type: EventType.RUN_ERROR,\n        model: options.model,\n        timestamp: Date.now(),\n        message: errorPayload.message,\n        ...(errorPayload.code !== undefined && { code: errorPayload.code }),\n        ...(rawEvent !== undefined && { rawEvent }),\n        error: {\n          message: errorPayload.message,\n          ...(errorPayload.code !== undefined && { code: errorPayload.code }),\n        },\n      }\n    }\n  }\n\n  /**\n   * Maps common TextOptions to Chat Completions API request format.\n   * Override this in subclasses to add provider-specific options.\n   */\n  protected mapOptionsToRequest(\n    options: TextOptions,\n  ): ChatCompletionCreateParamsStreaming {\n    const tools = options.tools\n      ? convertToolsToChatCompletionsFormat(\n          options.tools,\n          this.makeStructuredOutputCompatible.bind(this),\n        )\n      : undefined\n\n    // Build messages array with system prompts\n    const messages: Array<ChatCompletionMessageParam> = []\n\n    // Add system prompts first\n    const systemPrompts = normalizeSystemPrompts(options.systemPrompts)\n    if (systemPrompts.length > 0) {\n      messages.push({\n        role: 'system',\n        content: systemPrompts.map((p) => p.content).join('\\n'),\n      })\n    }\n\n    // Convert messages\n    for (const message of options.messages) {\n      messages.push(this.convertMessage(message))\n    }\n\n    const modelOptions = options.modelOptions\n\n    // Native combined mode (issue #605): when the engine threads\n    // `outputSchema` through TextOptions, the adapter declared\n    // `supportsCombinedToolsAndSchema` and the schema is already JSON Schema\n    // (pre-converted at the activity boundary). Wire it into\n    // `response_format` alongside any `tools`. Modern OpenAI-compatible\n    // Chat Completions accepts both together and emits the schema-\n    // constrained text on the natural final turn.\n    const combinedSchema = options.outputSchema as\n      | Record<string, unknown>\n      | undefined\n    const responseFormat = combinedSchema\n      ? {\n          response_format: {\n            type: 'json_schema' as const,\n            json_schema: {\n              name: 'structured_output',\n              schema: this.makeStructuredOutputCompatible(\n                combinedSchema,\n                Array.isArray(combinedSchema.required)\n                  ? (combinedSchema.required as Array<string>)\n                  : undefined,\n              ),\n              strict: true,\n            },\n          },\n        }\n      : undefined\n\n    // `modelOptions` is the sole sampling surface: callers set provider-native\n    // wire names (`temperature`, `top_p`, `max_tokens`/`max_completion_tokens`)\n    // there and they flow through the spread below. The root\n    // `temperature`/`topP`/`maxTokens` fields are intentionally NOT read here.\n    return {\n      ...modelOptions,\n      model: options.model,\n      messages,\n      // Conditional spread: `tools: undefined` would clobber any\n      // modelOptions.tools the caller set above.\n      ...(tools &&\n        tools.length > 0 && {\n          tools,\n        }),\n      ...(responseFormat ?? {}),\n      stream: true,\n    }\n  }\n\n  /**\n   * Modern OpenAI-compatible Chat Completions APIs support `tools` and\n   * `response_format: json_schema` together in a single streaming request\n   * (per issue #605). Subclasses can override — Groq, for instance, must\n   * return `false` because its API rejects schema + tools + stream with a\n   * 400.\n   */\n  supportsCombinedToolsAndSchema(): boolean {\n    return true\n  }\n\n  /**\n   * Converts a single ModelMessage to the Chat Completions API message format.\n   * Override this in subclasses to handle provider-specific message formats.\n   */\n  protected convertMessage(message: ModelMessage): ChatCompletionMessageParam {\n    // Handle tool messages\n    if (message.role === 'tool') {\n      // The Chat Completions API has no multimodal `tool` message support\n      // (unlike the Responses API's `function_call_output`). A tool that\n      // returns an `Array<ContentPart>` is therefore stringified here — the\n      // documented fallback for providers on the chat-completions path\n      // (Groq, Ollama, Grok, OpenRouter chat). Multimodal tool results are\n      // only delivered structurally via the Responses adapter.\n      return {\n        role: 'tool',\n        tool_call_id: message.toolCallId || '',\n        content:\n          typeof message.content === 'string'\n            ? message.content\n            : JSON.stringify(message.content),\n      }\n    }\n\n    // Handle assistant messages\n    if (message.role === 'assistant') {\n      const toolCalls = message.toolCalls?.map((tc) => ({\n        id: tc.id,\n        type: 'function' as const,\n        function: {\n          name: tc.function.name,\n          arguments:\n            typeof tc.function.arguments === 'string'\n              ? tc.function.arguments\n              : JSON.stringify(tc.function.arguments),\n        },\n      }))\n      const hasToolCalls = !!toolCalls && toolCalls.length > 0\n      const textContent = this.extractTextContent(message.content)\n\n      // Per the OpenAI Chat Completions contract, an assistant message that\n      // only carries tool_calls should have `content: null` (or omit content)\n      // rather than `content: ''`. Empty-string content interacts oddly with\n      // tokenization on some backends; null is the documented shape.\n      return {\n        role: 'assistant',\n        content: hasToolCalls && !textContent ? null : textContent,\n        ...(hasToolCalls ? { tool_calls: toolCalls } : {}),\n      }\n    }\n\n    // Handle user messages - support multimodal content\n    const contentParts = this.normalizeContent(message.content)\n\n    // If only text, use simple string format\n    if (contentParts.length === 1 && contentParts[0]?.type === 'text') {\n      const text = contentParts[0].content\n      if (text.length === 0) {\n        // Single empty text part is the same fail-loud condition as below —\n        // an empty paid request mask a real intent (caller passed `null`/'',\n        // or an upstream step normalised everything to an empty string).\n        throw new Error(\n          `User message for ${this.name} has empty text content. ` +\n            `Empty user messages would produce a paid request with no input; ` +\n            `provide non-empty content or omit the message.`,\n        )\n      }\n      return {\n        role: 'user',\n        content: text,\n      }\n    }\n\n    // Otherwise, use array format for multimodal. Fail fast on unsupported\n    // content parts rather than silently dropping them — a message of all\n    // unsupported parts would otherwise turn into an empty user prompt and\n    // mask a real capability mismatch.\n    const parts: Array<ChatCompletionContentPart> = []\n    for (const part of contentParts) {\n      const converted = this.convertContentPart(part)\n      if (!converted) {\n        throw new Error(\n          `Unsupported content part type for ${this.name}: ${part.type}. ` +\n            `Override convertContentPart() in a subclass to handle this type, ` +\n            `or remove it from the message.`,\n        )\n      }\n      parts.push(converted)\n    }\n\n    if (parts.length === 0) {\n      // The original message had no content parts at all (e.g. content was\n      // explicitly null or []). Sending an empty user message to OpenAI\n      // produces a paid request with no signal — fail loud instead.\n      throw new Error(\n        `User message for ${this.name} has no content parts. ` +\n          `Empty user messages would produce a paid request with no input; ` +\n          `provide at least one text/image/audio part or omit the message.`,\n      )\n    }\n\n    return {\n      role: 'user',\n      content: parts,\n    }\n  }\n\n  /**\n   * Converts a single ContentPart to the Chat Completions API content part format.\n   * Override this in subclasses to handle additional content types or provider-specific metadata.\n   */\n  protected convertContentPart(\n    part: ContentPart,\n  ): ChatCompletionContentPart | null {\n    if (part.type === 'text') {\n      return { type: 'text', text: part.content }\n    }\n\n    if (part.type === 'image') {\n      const imageMetadata = part.metadata as\n        | { detail?: 'auto' | 'low' | 'high' }\n        | undefined\n\n      // For base64 data, construct a data URI using the mimeType from source.\n      // Default to a generic octet-stream MIME if the source didn't provide\n      // one — interpolating `undefined` into the URI (\"data:undefined;base64,\n      // ...\") would produce an invalid URI the API rejects.\n      const imageValue = part.source.value\n      const imageMime = part.source.mimeType || 'application/octet-stream'\n      const imageUrl =\n        part.source.type === 'data' && !imageValue.startsWith('data:')\n          ? `data:${imageMime};base64,${imageValue}`\n          : imageValue\n\n      return {\n        type: 'image_url',\n        image_url: {\n          url: imageUrl,\n          detail: imageMetadata?.detail || 'auto',\n        },\n      }\n    }\n\n    // Unsupported content type — subclasses can override to handle more types\n    return null\n  }\n\n  /**\n   * Normalizes message content to an array of ContentPart.\n   * Handles backward compatibility with string content.\n   */\n  protected normalizeContent(\n    content: string | null | Array<ContentPart>,\n  ): Array<ContentPart> {\n    if (content === null) {\n      return []\n    }\n    if (typeof content === 'string') {\n      return [{ type: 'text', content: content }]\n    }\n    return content\n  }\n\n  /**\n   * Extracts text content from a content value that may be string, null, or ContentPart array.\n   */\n  protected extractTextContent(\n    content: string | null | Array<ContentPart>,\n  ): string {\n    if (content === null) {\n      return ''\n    }\n    if (typeof content === 'string') {\n      return content\n    }\n    // It's an array of ContentPart\n    return content\n      .filter((p) => p.type === 'text')\n      .map((p) => p.content)\n      .join('')\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"chat-completions-text.js","names":[],"sources":["../../../src/adapters/chat-completions-text.ts"],"sourcesContent":["import { EventType, normalizeSystemPrompts } from '@tanstack/ai'\nimport { BaseTextAdapter } from '@tanstack/ai/adapters'\nimport {\n  toRunErrorPayload,\n  toRunErrorRawEvent,\n} from '@tanstack/ai/adapter-internals'\nimport { generateId } from '@tanstack/ai-utils'\nimport { extractRequestOptions } from '../utils/request-options'\nimport { makeStructuredOutputCompatible } from '../utils/schema-converter'\nimport { buildChatCompletionsUsage } from '../usage'\nimport { convertToolsToChatCompletionsFormat } from './chat-completions-tool-converter'\nimport type OpenAI from 'openai'\nimport type {\n  StructuredOutputOptions,\n  StructuredOutputResult,\n} from '@tanstack/ai/adapters'\nimport type {\n  ChatCompletionChunk,\n  ChatCompletionContentPart,\n  ChatCompletionCreateParamsStreaming,\n  ChatCompletionMessageParam,\n} from 'openai/resources/chat/completions/completions'\nimport type {\n  ContentPart,\n  DefaultMessageMetadataByModality,\n  Modality,\n  ModelMessage,\n  RunFinishedEvent,\n  StreamChunk,\n  TextOptions,\n} from '@tanstack/ai'\n\n/**\n * Shared implementation of the OpenAI Chat Completions API. Holds the\n * stream-accumulator + AG-UI lifecycle logic and calls the OpenAI SDK\n * directly. Subclasses (ai-openai, ai-grok, ai-groq) construct an OpenAI\n * client with their provider-specific `baseURL` / headers and pass it in.\n */\nexport abstract class OpenAIBaseChatCompletionsTextAdapter<\n  TModel extends string,\n  TProviderOptions extends Record<string, unknown> = Record<string, unknown>,\n  TInputModalities extends ReadonlyArray<Modality> = ReadonlyArray<Modality>,\n  TMessageMetadata extends DefaultMessageMetadataByModality =\n    DefaultMessageMetadataByModality,\n  TToolCapabilities extends ReadonlyArray<string> = ReadonlyArray<string>,\n> extends BaseTextAdapter<\n  TModel,\n  TProviderOptions,\n  TInputModalities,\n  TMessageMetadata,\n  TToolCapabilities\n> {\n  override readonly kind = 'text' as const\n  readonly name: string\n  protected client: OpenAI\n\n  constructor(model: TModel, name: string, client: OpenAI) {\n    super({}, model)\n    this.name = name\n    this.client = client\n  }\n\n  async *chatStream(\n    options: TextOptions<TProviderOptions>,\n  ): AsyncIterable<StreamChunk> {\n    // AG-UI lifecycle tracking (mutable state object for ESLint compatibility)\n    const aguiState = {\n      runId: generateId(this.name),\n      threadId: options.threadId ?? generateId(this.name),\n      messageId: generateId(this.name),\n      hasEmittedRunStarted: false,\n    }\n\n    try {\n      // mapOptionsToRequest can throw (e.g. fail-loud guards in convertMessage\n      // for empty content or unsupported parts). Keep it inside the try so\n      // those failures surface as a single RUN_ERROR event, matching every\n      // other failure mode here — callers iterating chatStream then only need\n      // one error-handling path instead of both a try/catch around iteration\n      // and a RUN_ERROR handler.\n      const requestParams = this.mapOptionsToRequest(options)\n      options.logger.request(\n        `activity=chat provider=${this.name} model=${this.model} messages=${options.messages.length} tools=${options.tools?.length ?? 0} stream=true`,\n        { provider: this.name, model: this.model },\n      )\n      const stream = await this.client.chat.completions.create(\n        {\n          ...requestParams,\n          stream: true,\n          stream_options: { include_usage: true },\n        },\n        extractRequestOptions(options.request),\n      )\n\n      yield* this.processStreamChunks(stream, options, aguiState)\n    } catch (error: unknown) {\n      // Narrow before logging: raw SDK errors can carry request metadata\n      // (including auth headers) which we must never surface to user loggers.\n      const errorPayload = toRunErrorPayload(\n        error,\n        `${this.name}.chatStream failed`,\n      )\n      const rawEvent = toRunErrorRawEvent(error)\n\n      // Emit RUN_STARTED if not yet emitted\n      if (!aguiState.hasEmittedRunStarted) {\n        aguiState.hasEmittedRunStarted = true\n        yield {\n          type: EventType.RUN_STARTED,\n          runId: aguiState.runId,\n          threadId: aguiState.threadId,\n          model: options.model,\n          timestamp: Date.now(),\n          parentRunId: options.parentRunId,\n        }\n      }\n\n      const rejectedToolCall = this.extractRejectedToolCall(\n        rawEvent,\n        errorPayload.message,\n      )\n      if (rejectedToolCall) {\n        const toolCallId = generateId(this.name)\n        yield {\n          type: EventType.TOOL_CALL_START,\n          toolCallId,\n          toolCallName: rejectedToolCall.toolName,\n          toolName: rejectedToolCall.toolName,\n          parentMessageId: aguiState.messageId,\n          model: options.model,\n          timestamp: Date.now(),\n        }\n        yield {\n          type: EventType.TOOL_CALL_ARGS,\n          toolCallId,\n          delta: rejectedToolCall.arguments,\n          args: rejectedToolCall.arguments,\n          model: options.model,\n          timestamp: Date.now(),\n        }\n        yield {\n          type: EventType.TOOL_CALL_END,\n          toolCallId,\n          toolCallName: rejectedToolCall.toolName,\n          toolName: rejectedToolCall.toolName,\n          ...(rejectedToolCall.input !== undefined && {\n            input: rejectedToolCall.input,\n          }),\n          result: JSON.stringify({ error: rejectedToolCall.error }),\n          state: 'output-error',\n          model: options.model,\n          timestamp: Date.now(),\n        }\n        yield {\n          type: EventType.RUN_FINISHED,\n          runId: aguiState.runId,\n          threadId: aguiState.threadId,\n          model: options.model,\n          timestamp: Date.now(),\n          finishReason: 'tool_calls',\n        }\n        return\n      }\n\n      // Emit AG-UI RUN_ERROR. Conditional `code` spread keeps the wire\n      // shape spec-compliant under `exactOptionalPropertyTypes`: AG-UI's\n      // `RunErrorEvent.code` is `string?` (absent vs explicit `undefined`\n      // matter), so we omit the key when there's no code.\n      yield {\n        type: EventType.RUN_ERROR,\n        model: options.model,\n        timestamp: Date.now(),\n        message: errorPayload.message,\n        code: errorPayload.code,\n        // Forward the provider's structured error body so consumers can recover\n        // the upstream detail the `{ message, code }` payload drops. Omitted\n        // when the error carried no provider body (see toRunErrorRawEvent).\n        ...(rawEvent !== undefined && { rawEvent }),\n        error: {\n          message: errorPayload.message,\n          code: errorPayload.code,\n        },\n      }\n\n      options.logger.errors(`${this.name}.chatStream fatal`, {\n        error: errorPayload,\n        source: `${this.name}.chatStream`,\n      })\n    }\n  }\n\n  /**\n   * Extracts a rejected tool call from a provider error. Returned calls are\n   * emitted as non-executable `output-error` results so the model can repair them.\n   */\n  protected extractRejectedToolCall(\n    _rawEvent: unknown,\n    _fallbackMessage: string,\n  ):\n    | {\n        toolName: string\n        arguments: string\n        input?: unknown\n        error: string\n      }\n    | undefined {\n    return undefined\n  }\n\n  /**\n   * Generate structured output using the provider's JSON Schema response format.\n   * Uses stream: false to get the complete response in one call.\n   *\n   * OpenAI-compatible APIs have strict requirements for structured output:\n   * - All properties must be in the `required` array\n   * - Optional fields should have null added to their type union\n   * - additionalProperties must be false for all objects\n   *\n   * The outputSchema is already JSON Schema (converted in the ai layer).\n   * We apply provider-specific transformations for structured output compatibility.\n   */\n  async structuredOutput(\n    options: StructuredOutputOptions<TProviderOptions>,\n  ): Promise<StructuredOutputResult<unknown>> {\n    const { chatOptions, outputSchema } = options\n    const requestParams = this.mapOptionsToRequest(chatOptions)\n\n    const jsonSchema = this.makeStructuredOutputCompatible(\n      outputSchema,\n      outputSchema.required,\n    )\n\n    try {\n      // Strip stream_options which is only valid for streaming calls\n      const {\n        stream_options: _,\n        stream: __,\n        ...cleanParams\n      } = requestParams as any\n      chatOptions.logger.request(\n        `activity=structuredOutput provider=${this.name} model=${this.model} messages=${chatOptions.messages.length}`,\n        { provider: this.name, model: this.model },\n      )\n      const response = await this.client.chat.completions.create(\n        {\n          ...cleanParams,\n          stream: false,\n          response_format: {\n            type: 'json_schema',\n            json_schema: {\n              name: 'structured_output',\n              schema: jsonSchema,\n              strict: true,\n            },\n          },\n        },\n        extractRequestOptions(chatOptions.request),\n      )\n\n      // Extract text content from the response. Fail loud on empty content\n      // rather than letting it cascade into a JSON-parse error on '' — the\n      // root cause (the model returned no content for the structured request)\n      // is then visible in logs.\n      const rawText = response.choices[0]?.message.content\n      if (typeof rawText !== 'string' || rawText.length === 0) {\n        throw new Error(\n          `${this.name}.structuredOutput: response contained no content`,\n        )\n      }\n\n      // Parse the JSON response\n      let parsed: unknown\n      try {\n        parsed = JSON.parse(rawText)\n      } catch {\n        throw new Error(\n          `Failed to parse structured output as JSON. Content: ${rawText.slice(0, 200)}${rawText.length > 200 ? '...' : ''}`,\n        )\n      }\n\n      // Final provider-specific shaping pass (default passthrough). Null-widening\n      // from strict mode is undone by the engine, not here.\n      const transformed = this.transformStructuredOutput(parsed)\n\n      // Surface usage so non-stream structured paths (and\n      // fallbackStructuredOutputStream) can forward tokens to middleware.\n      const usage = buildChatCompletionsUsage(response.usage)\n      return {\n        data: transformed,\n        rawText,\n        ...(usage && { usage }),\n      }\n    } catch (error: unknown) {\n      // Narrow before logging: raw SDK errors can carry request metadata\n      // (including auth headers) which we must never surface to user loggers.\n      chatOptions.logger.errors(`${this.name}.structuredOutput fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.structuredOutput failed`),\n        source: `${this.name}.structuredOutput`,\n      })\n      throw error\n    }\n  }\n\n  /**\n   * Stream structured output. Single Chat Completions request with\n   * `response_format: json_schema` + `stream: true`. Emits the standard\n   * AG-UI lifecycle (`RUN_STARTED` → `REASONING_*?` → `TEXT_MESSAGE_*`\n   * carrying raw JSON deltas → terminal `CUSTOM 'structured-output.complete'`\n   * → `RUN_FINISHED`). Subclasses use the same SDK-call / reasoning /\n   * structured-output-transform hooks as `chatStream` / `structuredOutput` —\n   * no per-subclass override should be needed.\n   */\n  async *structuredOutputStream(\n    options: StructuredOutputOptions<TProviderOptions>,\n  ): AsyncIterable<StreamChunk> {\n    const { chatOptions, outputSchema } = options\n    const requestParams = this.mapOptionsToRequest(chatOptions)\n\n    const jsonSchema = this.makeStructuredOutputCompatible(\n      outputSchema,\n      outputSchema.required,\n    )\n\n    const aguiState = {\n      runId: generateId(this.name),\n      threadId: chatOptions.threadId ?? generateId(this.name),\n      messageId: generateId(this.name),\n      hasEmittedRunStarted: false,\n    }\n\n    let accumulatedContent = ''\n    let accumulatedReasoning = ''\n    let hasEmittedTextMessageStart = false\n    let reasoningMessageId: string | undefined\n    let hasClosedReasoning = false\n    let stepId: string | undefined\n    let lastModel: string | undefined\n    let lastUsage:\n      | OpenAI.Chat.Completions.ChatCompletionChunk['usage']\n      | undefined\n\n    const closeReasoningLifecycle = function* (this: {\n      name: string\n    }): Generator<StreamChunk> {\n      if (reasoningMessageId && !hasClosedReasoning) {\n        hasClosedReasoning = true\n        yield {\n          type: EventType.REASONING_MESSAGE_END,\n          messageId: reasoningMessageId,\n          model: lastModel || chatOptions.model,\n          timestamp: Date.now(),\n        }\n        yield {\n          type: EventType.REASONING_END,\n          messageId: reasoningMessageId,\n          model: lastModel || chatOptions.model,\n          timestamp: Date.now(),\n        }\n        if (stepId) {\n          yield {\n            type: EventType.STEP_FINISHED,\n            stepName: stepId,\n            stepId,\n            model: lastModel || chatOptions.model,\n            timestamp: Date.now(),\n            content: accumulatedReasoning,\n          }\n        }\n      }\n    }.bind(this)\n\n    try {\n      // Strip stream_options + tools from the base request. Structured output\n      // sends `response_format: json_schema` and doesn't carry tools — keeping\n      // them in the request can confuse strict-mode validation upstream.\n      const {\n        stream_options: _so,\n        stream: _s,\n        tools: _t,\n        ...cleanParams\n      } = requestParams\n\n      chatOptions.logger.request(\n        `activity=structuredOutputStream provider=${this.name} model=${this.model} messages=${chatOptions.messages.length}`,\n        { provider: this.name, model: this.model },\n      )\n\n      const stream = await this.client.chat.completions.create(\n        {\n          ...cleanParams,\n          stream: true,\n          stream_options: { include_usage: true },\n          response_format: {\n            type: 'json_schema',\n            json_schema: {\n              name: 'structured_output',\n              schema: jsonSchema,\n              strict: true,\n            },\n          },\n        },\n        extractRequestOptions(chatOptions.request),\n      )\n\n      for await (const chunk of stream) {\n        const choiceForLog = chunk.choices[0]\n        chatOptions.logger.provider(\n          `provider=${this.name} finish_reason=${choiceForLog?.finish_reason ?? 'none'} hasContent=${!!choiceForLog?.delta.content} hasUsage=${!!chunk.usage}`,\n          { provider: this.name, model: chunk.model },\n        )\n\n        if (chunk.model) lastModel = chunk.model\n\n        // Usage may arrive on a chunk with empty `choices` (OpenAI's\n        // include_usage terminal chunk) or piggybacked on a finish chunk\n        // (`x_groq.usage` on Groq). Capture from either independent of\n        // choices[0].\n        const usage =\n          chunk.usage ??\n          (chunk as { x_groq?: { usage?: typeof chunk.usage } }).x_groq?.usage\n        if (usage) lastUsage = usage\n\n        if (!aguiState.hasEmittedRunStarted) {\n          aguiState.hasEmittedRunStarted = true\n          yield {\n            type: EventType.RUN_STARTED,\n            runId: aguiState.runId,\n            threadId: aguiState.threadId,\n            model: chunk.model || chatOptions.model,\n            timestamp: Date.now(),\n            parentRunId: chatOptions.parentRunId,\n          }\n        }\n\n        // Reasoning (via the extractReasoning hook — same hook as chatStream).\n        const reasoning = this.extractReasoning(chunk)\n        if (reasoning && reasoning.text) {\n          if (!reasoningMessageId) {\n            reasoningMessageId = generateId(this.name)\n            stepId = generateId(this.name)\n            yield {\n              type: EventType.REASONING_START,\n              messageId: reasoningMessageId,\n              model: chunk.model || chatOptions.model,\n              timestamp: Date.now(),\n            }\n            yield {\n              type: EventType.REASONING_MESSAGE_START,\n              messageId: reasoningMessageId,\n              role: 'reasoning' as const,\n              model: chunk.model || chatOptions.model,\n              timestamp: Date.now(),\n            }\n            yield {\n              type: EventType.STEP_STARTED,\n              stepName: stepId,\n              stepId,\n              model: chunk.model || chatOptions.model,\n              timestamp: Date.now(),\n              stepType: 'thinking',\n            }\n          }\n          accumulatedReasoning += reasoning.text\n          yield {\n            type: EventType.REASONING_MESSAGE_CONTENT,\n            messageId: reasoningMessageId,\n            delta: reasoning.text,\n            model: chunk.model || chatOptions.model,\n            timestamp: Date.now(),\n          }\n        }\n\n        const choice = chunk.choices[0]\n        if (!choice) continue\n\n        const deltaContent = choice.delta.content\n        if (deltaContent) {\n          yield* closeReasoningLifecycle()\n\n          if (!hasEmittedTextMessageStart) {\n            hasEmittedTextMessageStart = true\n            yield {\n              type: EventType.TEXT_MESSAGE_START,\n              messageId: aguiState.messageId,\n              model: chunk.model || chatOptions.model,\n              timestamp: Date.now(),\n              role: 'assistant',\n            }\n          }\n\n          accumulatedContent += deltaContent\n\n          yield {\n            type: EventType.TEXT_MESSAGE_CONTENT,\n            messageId: aguiState.messageId,\n            model: chunk.model || chatOptions.model,\n            timestamp: Date.now(),\n            delta: deltaContent,\n            content: accumulatedContent,\n          }\n        }\n      }\n\n      // Finalisation: close any open lifecycle, parse + validate, emit\n      // terminal events. This block always runs unless the loop threw — abort\n      // and SDK errors land in the catch block below.\n      yield* closeReasoningLifecycle()\n\n      if (hasEmittedTextMessageStart) {\n        yield {\n          type: EventType.TEXT_MESSAGE_END,\n          messageId: aguiState.messageId,\n          model: lastModel || chatOptions.model,\n          timestamp: Date.now(),\n        }\n      }\n\n      if (accumulatedContent.length === 0) {\n        yield {\n          type: EventType.RUN_ERROR,\n          runId: aguiState.runId,\n          model: lastModel || chatOptions.model,\n          timestamp: Date.now(),\n          message: `${this.name}.structuredOutputStream: response contained no content`,\n          code: 'empty-response',\n          error: {\n            message: `${this.name}.structuredOutputStream: response contained no content`,\n            code: 'empty-response',\n          },\n        }\n        return\n      }\n\n      let parsed: unknown\n      try {\n        parsed = JSON.parse(accumulatedContent)\n      } catch {\n        yield {\n          type: EventType.RUN_ERROR,\n          runId: aguiState.runId,\n          model: lastModel || chatOptions.model,\n          timestamp: Date.now(),\n          message: `Failed to parse structured output as JSON. Content: ${accumulatedContent.slice(0, 200)}${accumulatedContent.length > 200 ? '...' : ''}`,\n          code: 'parse-error',\n          error: {\n            message: 'Failed to parse structured output as JSON',\n            code: 'parse-error',\n          },\n        }\n        return\n      }\n\n      const transformed = this.transformStructuredOutput(parsed)\n\n      yield {\n        type: EventType.CUSTOM,\n        name: 'structured-output.complete',\n        value: {\n          object: transformed,\n          raw: accumulatedContent,\n          ...(accumulatedReasoning ? { reasoning: accumulatedReasoning } : {}),\n        },\n        model: lastModel || chatOptions.model,\n        timestamp: Date.now(),\n      }\n\n      yield {\n        type: EventType.RUN_FINISHED,\n        runId: aguiState.runId,\n        threadId: aguiState.threadId,\n        model: lastModel || chatOptions.model,\n        timestamp: Date.now(),\n        finishReason: 'stop',\n        ...(lastUsage && {\n          usage: buildChatCompletionsUsage(lastUsage),\n        }),\n      }\n    } catch (error: unknown) {\n      if (!aguiState.hasEmittedRunStarted) {\n        aguiState.hasEmittedRunStarted = true\n        yield {\n          type: EventType.RUN_STARTED,\n          runId: aguiState.runId,\n          threadId: aguiState.threadId,\n          model: chatOptions.model,\n          timestamp: Date.now(),\n          parentRunId: chatOptions.parentRunId,\n        }\n      }\n\n      const isAbort = this.isAbortError(error)\n      const errorPayload = toRunErrorPayload(\n        error,\n        `${this.name}.structuredOutputStream failed`,\n      )\n\n      // Conditional `code` spread keeps the wire shape spec-compliant under\n      // `exactOptionalPropertyTypes`: AG-UI's `RunErrorEvent.code` is `string?`\n      // (absent vs explicit `undefined` matter).\n      const resolvedCode = isAbort ? 'aborted' : errorPayload.code\n      const rawEvent = isAbort ? undefined : toRunErrorRawEvent(error)\n      yield {\n        type: EventType.RUN_ERROR,\n        runId: aguiState.runId,\n        model: lastModel || chatOptions.model,\n        timestamp: Date.now(),\n        message: errorPayload.message,\n        ...(resolvedCode !== undefined && { code: resolvedCode }),\n        ...(rawEvent !== undefined && { rawEvent }),\n        error: {\n          message: errorPayload.message,\n          ...(resolvedCode !== undefined && { code: resolvedCode }),\n        },\n      }\n\n      chatOptions.logger.errors(`${this.name}.structuredOutputStream fatal`, {\n        error: errorPayload,\n        source: `${this.name}.structuredOutputStream`,\n      })\n    }\n  }\n\n  /**\n   * Cross-SDK abort detection for `structuredOutputStream`. Default duck-types\n   * on `name === 'APIUserAbortError'` (OpenAI SDK), `code === 'ERR_CANCELED'`,\n   * and standard `AbortError`s. Subclasses with proprietary error types (e.g.\n   * `@openrouter/sdk`'s `RequestAbortedError`) override to extend the check.\n   */\n  protected isAbortError(error: unknown): boolean {\n    if (!error || typeof error !== 'object') return false\n    const e = error as { name?: unknown; code?: unknown }\n    return (\n      e.name === 'APIUserAbortError' ||\n      e.name === 'AbortError' ||\n      e.code === 'ERR_CANCELED'\n    )\n  }\n\n  /**\n   * Applies provider-specific transformations for structured output compatibility.\n   * Override this in subclasses to handle provider-specific quirks.\n   */\n  protected makeStructuredOutputCompatible(\n    schema: Record<string, any>,\n    originalRequired?: Array<string>,\n  ): Record<string, any> {\n    return makeStructuredOutputCompatible(schema, originalRequired)\n  }\n\n  /**\n   * Extract reasoning content from a stream chunk. Default returns\n   * `undefined` because the OpenAI Chat Completions chunk shape doesn't\n   * carry reasoning. The chunk param is typed `unknown` so an override can\n   * narrow to its own SDK chunk type without an `as` dance — the base only\n   * passes through `processStreamChunks`'s structurally-iterated chunk.\n   */\n  protected extractReasoning(_chunk: unknown): { text: string } | undefined {\n    return undefined\n  }\n\n  /**\n   * Final shaping pass applied to parsed structured-output JSON before it is\n   * returned to the caller. Default is a passthrough.\n   *\n   * Provider `null`s are no longer stripped here: strict-mode null-widening is\n   * now undone precisely by the engine (`undoNullWidening`, driven by the\n   * schema's null-widening map) the moment the result is captured, so a blind\n   * `transformNullsToUndefined` at the adapter would only destroy genuine\n   * `.nullable()` nulls. Subclasses may still override to remap or reshape the\n   * provider's structured output.\n   */\n  protected transformStructuredOutput(parsed: unknown): unknown {\n    return parsed\n  }\n\n  /**\n   * Processes streamed chunks from the Chat Completions API and yields AG-UI events.\n   * Override this in subclasses to handle provider-specific stream behavior.\n   */\n  protected async *processStreamChunks(\n    stream: AsyncIterable<ChatCompletionChunk>,\n    options: TextOptions,\n    aguiState: {\n      runId: string\n      threadId: string\n      messageId: string\n      hasEmittedRunStarted: boolean\n    },\n  ): AsyncIterable<StreamChunk> {\n    let accumulatedContent = ''\n    let hasEmittedTextMessageStart = false\n    let lastModel: string | undefined\n    // Track usage from any chunk that carries it. With\n    // `stream_options: { include_usage: true }` OpenAI emits a terminal chunk\n    // whose `choices` is `[]` and only the `usage` field is populated; the\n    // earlier `finish_reason` chunk does NOT include token counts. We must\n    // therefore defer RUN_FINISHED until the iterator is exhausted so we can\n    // pick up usage from the trailing chunk regardless of arrival order.\n    let lastUsage: ChatCompletionChunk['usage'] | undefined\n    let pendingFinishReason:\n      | ChatCompletionChunk['choices'][number]['finish_reason']\n      | undefined\n\n    // Track tool calls being streamed (arguments come in chunks)\n    const toolCallsInProgress = new Map<\n      number,\n      {\n        id: string\n        name: string\n        arguments: string\n        started: boolean // Track if TOOL_CALL_START has been emitted\n      }\n    >()\n\n    // Reasoning lifecycle (driven by extractReasoning() hook — see method\n    // docs). The base wire format (OpenAI Chat Completions) has no reasoning,\n    // so these stay unused for openai/grok/groq. OpenRouter etc. opt in.\n    let reasoningMessageId: string | undefined\n    let hasClosedReasoning = false\n    // Legacy STEP_STARTED/STEP_FINISHED pair emitted alongside REASONING_*\n    // for back-compat with consumers (UI, devtools) that haven't migrated\n    // to the spec REASONING_* events yet.\n    let stepId: string | undefined\n    let accumulatedReasoning = ''\n    // Track whether ANY tool call lifecycle was actually completed across the\n    // entire stream. Lets us downgrade a `tool_calls` finish_reason to `stop`\n    // when the upstream signalled tool calls but never produced a complete\n    // start/end pair — emitting RUN_FINISHED { finishReason: 'tool_calls' }\n    // with no matching TOOL_CALL_END would leave consumers waiting for tool\n    // results that never arrive.\n    let emittedAnyToolCallEnd = false\n\n    try {\n      for await (const chunk of stream) {\n        const choiceForLog = chunk.choices[0]\n        options.logger.provider(\n          `provider=${this.name} finish_reason=${choiceForLog?.finish_reason ?? 'none'} hasContent=${!!choiceForLog?.delta.content} hasToolCalls=${!!choiceForLog?.delta.tool_calls} hasUsage=${!!chunk.usage}`,\n          { provider: this.name, model: chunk.model },\n        )\n\n        // Capture usage from any chunk (including the terminal usage-only\n        // chunk emitted when `stream_options.include_usage` is on).\n        if (chunk.usage) {\n          lastUsage = chunk.usage\n        }\n        if (chunk.model) {\n          lastModel = chunk.model\n        }\n\n        // Emit RUN_STARTED on the first chunk of any kind so callers see a\n        // run lifecycle even on streams that arrive entirely as usage-only\n        // (no choices). Without this, a usage-first stream would skip\n        // RUN_STARTED via `if (!choice) continue` below and the post-loop\n        // synthetic block would also skip RUN_FINISHED (it gates on\n        // `hasEmittedRunStarted`).\n        if (!aguiState.hasEmittedRunStarted) {\n          aguiState.hasEmittedRunStarted = true\n          yield {\n            type: EventType.RUN_STARTED,\n            runId: aguiState.runId,\n            threadId: aguiState.threadId,\n            model: chunk.model || options.model,\n            timestamp: Date.now(),\n            parentRunId: options.parentRunId,\n          }\n        }\n\n        // Reasoning content (extractReasoning() hook). Run before reading\n        // choice/delta so reasoning-only chunks (no `choices`) still drive\n        // the REASONING_* lifecycle on providers that send reasoning out of\n        // band. The base default returns undefined.\n        const reasoning = this.extractReasoning(chunk)\n        if (reasoning && reasoning.text) {\n          if (!reasoningMessageId) {\n            reasoningMessageId = generateId(this.name)\n            stepId = generateId(this.name)\n            yield {\n              type: EventType.REASONING_START,\n              messageId: reasoningMessageId,\n              model: chunk.model || options.model,\n              timestamp: Date.now(),\n            }\n            yield {\n              type: EventType.REASONING_MESSAGE_START,\n              messageId: reasoningMessageId,\n              role: 'reasoning' as const,\n              model: chunk.model || options.model,\n              timestamp: Date.now(),\n            }\n            // Legacy STEP_STARTED (single emission, paired with the\n            // STEP_FINISHED below when reasoning closes).\n            yield {\n              type: EventType.STEP_STARTED,\n              stepName: stepId,\n              stepId,\n              model: chunk.model || options.model,\n              timestamp: Date.now(),\n              stepType: 'thinking',\n            }\n          }\n          accumulatedReasoning += reasoning.text\n          yield {\n            type: EventType.REASONING_MESSAGE_CONTENT,\n            messageId: reasoningMessageId,\n            delta: reasoning.text,\n            model: chunk.model || options.model,\n            timestamp: Date.now(),\n          }\n        }\n\n        const choice = chunk.choices[0]\n\n        if (!choice) continue\n\n        const delta = choice.delta\n        const deltaContent = delta.content\n        const deltaToolCalls = delta.tool_calls\n\n        // Handle content delta\n        if (deltaContent) {\n          // Close reasoning before text starts so consumers see a clean\n          // REASONING_END before any TEXT_MESSAGE_START.\n          if (reasoningMessageId && !hasClosedReasoning) {\n            hasClosedReasoning = true\n            yield {\n              type: EventType.REASONING_MESSAGE_END,\n              messageId: reasoningMessageId,\n              model: chunk.model || options.model,\n              timestamp: Date.now(),\n            }\n            yield {\n              type: EventType.REASONING_END,\n              messageId: reasoningMessageId,\n              model: chunk.model || options.model,\n              timestamp: Date.now(),\n            }\n            if (stepId) {\n              yield {\n                type: EventType.STEP_FINISHED,\n                stepName: stepId,\n                stepId,\n                model: chunk.model || options.model,\n                timestamp: Date.now(),\n                content: accumulatedReasoning,\n              }\n            }\n          }\n\n          // Emit TEXT_MESSAGE_START on first text content\n          if (!hasEmittedTextMessageStart) {\n            hasEmittedTextMessageStart = true\n            yield {\n              type: EventType.TEXT_MESSAGE_START,\n              messageId: aguiState.messageId,\n              model: chunk.model || options.model,\n              timestamp: Date.now(),\n              role: 'assistant',\n            }\n          }\n\n          accumulatedContent += deltaContent\n\n          // Emit AG-UI TEXT_MESSAGE_CONTENT\n          yield {\n            type: EventType.TEXT_MESSAGE_CONTENT,\n            messageId: aguiState.messageId,\n            model: chunk.model || options.model,\n            timestamp: Date.now(),\n            delta: deltaContent,\n            content: accumulatedContent,\n          }\n        }\n\n        // Handle tool calls - they come in as deltas\n        if (deltaToolCalls) {\n          for (const toolCallDelta of deltaToolCalls) {\n            const index = toolCallDelta.index\n\n            // Initialize or update the tool call in progress\n            let toolCall = toolCallsInProgress.get(index)\n            if (!toolCall) {\n              toolCall = {\n                id: toolCallDelta.id || '',\n                name: toolCallDelta.function?.name || '',\n                arguments: '',\n                started: false,\n              }\n              toolCallsInProgress.set(index, toolCall)\n            }\n\n            // Update with any new data from the delta\n            if (toolCallDelta.id) {\n              toolCall.id = toolCallDelta.id\n            }\n            if (toolCallDelta.function?.name) {\n              toolCall.name = toolCallDelta.function.name\n            }\n            if (toolCallDelta.function?.arguments) {\n              toolCall.arguments += toolCallDelta.function.arguments\n            }\n\n            // Emit TOOL_CALL_START when we have id and name\n            if (toolCall.id && toolCall.name && !toolCall.started) {\n              toolCall.started = true\n              yield {\n                type: EventType.TOOL_CALL_START,\n                toolCallId: toolCall.id,\n                toolCallName: toolCall.name,\n                toolName: toolCall.name,\n                parentMessageId: aguiState.messageId,\n                model: chunk.model || options.model,\n                timestamp: Date.now(),\n                index,\n              }\n            }\n\n            // Emit TOOL_CALL_ARGS for argument deltas\n            if (toolCallDelta.function?.arguments && toolCall.started) {\n              yield {\n                type: EventType.TOOL_CALL_ARGS,\n                toolCallId: toolCall.id,\n                model: chunk.model || options.model,\n                timestamp: Date.now(),\n                delta: toolCallDelta.function.arguments,\n              }\n            }\n          }\n        }\n\n        // Handle finish reason. We DO emit TOOL_CALL_END and TEXT_MESSAGE_END\n        // here because the corresponding _START events have already fired,\n        // and tool execution downstream wants to begin as soon as possible.\n        // RUN_FINISHED is deferred until the iterator is fully exhausted so\n        // we can capture the trailing usage chunk that arrives AFTER this\n        // chunk when stream_options.include_usage is on.\n        if (choice.finish_reason) {\n          if (\n            choice.finish_reason === 'tool_calls' ||\n            toolCallsInProgress.size > 0\n          ) {\n            for (const [, toolCall] of toolCallsInProgress) {\n              // Skip tool calls that never emitted TOOL_CALL_START — emitting\n              // a stray TOOL_CALL_END here would violate AG-UI lifecycle\n              // (END without matching START) for partial deltas where the\n              // upstream never sent both id and name.\n              if (!toolCall.started) continue\n\n              // Parse arguments for TOOL_CALL_END. Surface parse failures via\n              // the logger so a model emitting malformed JSON for tool args\n              // is debuggable instead of silently invoking the tool with {}.\n              // Non-object JSON (e.g. a bare string or number) is also coerced\n              // to {} so downstream tool execution doesn't receive a primitive\n              // input, mirroring the Responses adapter's guard.\n              let parsedInput: unknown = {}\n              if (toolCall.arguments) {\n                try {\n                  const parsed: unknown = JSON.parse(toolCall.arguments)\n                  parsedInput =\n                    parsed && typeof parsed === 'object' ? parsed : {}\n                } catch (parseError) {\n                  options.logger.errors(\n                    `${this.name}.processStreamChunks tool-args JSON parse failed`,\n                    {\n                      error: toRunErrorPayload(\n                        parseError,\n                        `tool ${toolCall.name} (${toolCall.id}) returned malformed JSON arguments`,\n                      ),\n                      source: `${this.name}.processStreamChunks`,\n                      toolCallId: toolCall.id,\n                      toolName: toolCall.name,\n                      rawArguments: toolCall.arguments,\n                    },\n                  )\n                  parsedInput = {}\n                }\n              }\n\n              // Emit AG-UI TOOL_CALL_END\n              yield {\n                type: EventType.TOOL_CALL_END,\n                toolCallId: toolCall.id,\n                toolCallName: toolCall.name,\n                toolName: toolCall.name,\n                model: chunk.model || options.model,\n                timestamp: Date.now(),\n                input: parsedInput,\n              }\n              emittedAnyToolCallEnd = true\n            }\n            // Clear tool-call state after emission so a subsequent\n            // `finish_reason: 'stop'` chunk (or the post-loop synthetic\n            // block) doesn't see lingering entries and misreport the finish.\n            toolCallsInProgress.clear()\n          }\n\n          // Emit TEXT_MESSAGE_END if we had text content\n          if (hasEmittedTextMessageStart) {\n            yield {\n              type: EventType.TEXT_MESSAGE_END,\n              messageId: aguiState.messageId,\n              model: chunk.model || options.model,\n              timestamp: Date.now(),\n            }\n            hasEmittedTextMessageStart = false\n          }\n\n          // Remember the upstream finish_reason; RUN_FINISHED is emitted at\n          // end-of-stream so we pick up the trailing usage-only chunk too.\n          pendingFinishReason = choice.finish_reason\n        }\n      }\n\n      // Emit a single terminal RUN_FINISHED after the iterator is exhausted.\n      // This both delivers accurate token counts (the trailing usage chunk\n      // may arrive AFTER the finish_reason chunk) and gives consumers a\n      // guaranteed terminal event even when the upstream cuts off mid-stream\n      // (no finish_reason chunk ever arrives).\n      if (aguiState.hasEmittedRunStarted) {\n        // Close any started tool calls that never got finish_reason. A\n        // truncated stream that emitted TOOL_CALL_START but never reached\n        // finish_reason would otherwise leave consumers with an unbalanced\n        // start. Skip non-started entries (no matching START to close).\n        let pendingToolCount = 0\n        for (const [, toolCall] of toolCallsInProgress) {\n          if (!toolCall.started) continue\n          let parsedInput: unknown = {}\n          if (toolCall.arguments) {\n            try {\n              const parsed: unknown = JSON.parse(toolCall.arguments)\n              parsedInput = parsed && typeof parsed === 'object' ? parsed : {}\n            } catch (parseError) {\n              // Mirror the finish_reason path's logger call — a truncated\n              // stream emitting malformed tool-call JSON would otherwise\n              // silently invoke the tool with `{}`, the exact failure the\n              // finish_reason logger was added to prevent.\n              options.logger.errors(\n                `${this.name}.processStreamChunks tool-args JSON parse failed (drain)`,\n                {\n                  error: toRunErrorPayload(\n                    parseError,\n                    `tool ${toolCall.name} (${toolCall.id}) returned malformed JSON arguments`,\n                  ),\n                  source: `${this.name}.processStreamChunks`,\n                  toolCallId: toolCall.id,\n                  toolName: toolCall.name,\n                  rawArguments: toolCall.arguments,\n                },\n              )\n              parsedInput = {}\n            }\n          }\n          yield {\n            type: EventType.TOOL_CALL_END,\n            toolCallId: toolCall.id,\n            toolCallName: toolCall.name,\n            toolName: toolCall.name,\n            model: lastModel || options.model,\n            timestamp: Date.now(),\n            input: parsedInput,\n          }\n          pendingToolCount += 1\n          emittedAnyToolCallEnd = true\n        }\n        toolCallsInProgress.clear()\n\n        // Make sure the text message lifecycle is closed even on early\n        // termination paths where finish_reason never arrives.\n        if (hasEmittedTextMessageStart) {\n          yield {\n            type: EventType.TEXT_MESSAGE_END,\n            messageId: aguiState.messageId,\n            model: lastModel || options.model,\n            timestamp: Date.now(),\n          }\n        }\n\n        // Close any reasoning lifecycle that text never closed (no text\n        // content arrived, or the stream cut off before text started).\n        if (reasoningMessageId && !hasClosedReasoning) {\n          hasClosedReasoning = true\n          yield {\n            type: EventType.REASONING_MESSAGE_END,\n            messageId: reasoningMessageId,\n            model: lastModel || options.model,\n            timestamp: Date.now(),\n          }\n          yield {\n            type: EventType.REASONING_END,\n            messageId: reasoningMessageId,\n            model: lastModel || options.model,\n            timestamp: Date.now(),\n          }\n          if (stepId) {\n            yield {\n              type: EventType.STEP_FINISHED,\n              stepName: stepId,\n              stepId,\n              model: lastModel || options.model,\n              timestamp: Date.now(),\n              content: accumulatedReasoning,\n            }\n          }\n        }\n\n        // Map upstream finish_reason to AG-UI's narrower vocabulary.\n        // Collapsing length / content_filter to 'stop' would hide why the\n        // run terminated — surface it instead. Use `tool_calls` only when\n        // a TOOL_CALL_END was actually emitted: an upstream that signalled\n        // `tool_calls` but never produced a started/ended pair must NOT\n        // surface `tool_calls` here, since downstream consumers wait for\n        // tool results that would never arrive. OpenAI's legacy\n        // `function_call` value (from the v1 function-calling API) is\n        // normalized to `tool_calls` — semantically the same termination.\n        const finishReason: NonNullable<RunFinishedEvent['finishReason']> =\n          emittedAnyToolCallEnd\n            ? 'tool_calls'\n            : pendingFinishReason === 'tool_calls'\n              ? 'stop'\n              : pendingFinishReason === 'function_call'\n                ? 'tool_calls'\n                : (pendingFinishReason ?? 'stop')\n\n        // Conditional `usage` spread: AG-UI's `RunFinishedEvent.usage` is\n        // optional with no `| undefined`; omit the key entirely when no usage\n        // arrived rather than emitting `usage: undefined`.\n        yield {\n          type: EventType.RUN_FINISHED,\n          runId: aguiState.runId,\n          threadId: aguiState.threadId,\n          model: lastModel || options.model,\n          timestamp: Date.now(),\n          ...(lastUsage && {\n            usage: buildChatCompletionsUsage(lastUsage),\n          }),\n          finishReason,\n        }\n      }\n    } catch (error: unknown) {\n      // Narrow before logging: raw SDK errors can carry request metadata\n      // (including auth headers) which we must never surface to user loggers.\n      const errorPayload = toRunErrorPayload(\n        error,\n        `${this.name}.processStreamChunks failed`,\n      )\n      const rawEvent = toRunErrorRawEvent(error)\n      options.logger.errors(`${this.name}.processStreamChunks fatal`, {\n        error: errorPayload,\n        source: `${this.name}.processStreamChunks`,\n      })\n\n      // Emit AG-UI RUN_ERROR with conditional `code` spread (see chatStream's\n      // catch block for the rationale). `rawEvent` carries the provider's\n      // structured error body when present.\n      yield {\n        type: EventType.RUN_ERROR,\n        model: options.model,\n        timestamp: Date.now(),\n        message: errorPayload.message,\n        ...(errorPayload.code !== undefined && { code: errorPayload.code }),\n        ...(rawEvent !== undefined && { rawEvent }),\n        error: {\n          message: errorPayload.message,\n          ...(errorPayload.code !== undefined && { code: errorPayload.code }),\n        },\n      }\n    }\n  }\n\n  /**\n   * Maps common TextOptions to Chat Completions API request format.\n   * Override this in subclasses to add provider-specific options.\n   */\n  protected mapOptionsToRequest(\n    options: TextOptions,\n  ): ChatCompletionCreateParamsStreaming {\n    const tools = options.tools\n      ? convertToolsToChatCompletionsFormat(\n          options.tools,\n          this.makeStructuredOutputCompatible.bind(this),\n        )\n      : undefined\n\n    // Build messages array with system prompts\n    const messages: Array<ChatCompletionMessageParam> = []\n\n    // Add system prompts first\n    const systemPrompts = normalizeSystemPrompts(options.systemPrompts)\n    if (systemPrompts.length > 0) {\n      messages.push({\n        role: 'system',\n        content: systemPrompts.map((p) => p.content).join('\\n'),\n      })\n    }\n\n    // Convert messages\n    for (const message of options.messages) {\n      messages.push(this.convertMessage(message))\n    }\n\n    const modelOptions = options.modelOptions\n\n    // Native combined mode (issue #605): when the engine threads\n    // `outputSchema` through TextOptions, the adapter declared\n    // `supportsCombinedToolsAndSchema` and the schema is already JSON Schema\n    // (pre-converted at the activity boundary). Wire it into\n    // `response_format` alongside any `tools`. Modern OpenAI-compatible\n    // Chat Completions accepts both together and emits the schema-\n    // constrained text on the natural final turn.\n    const combinedSchema = options.outputSchema as\n      | Record<string, unknown>\n      | undefined\n    const responseFormat = combinedSchema\n      ? {\n          response_format: {\n            type: 'json_schema' as const,\n            json_schema: {\n              name: 'structured_output',\n              schema: this.makeStructuredOutputCompatible(\n                combinedSchema,\n                Array.isArray(combinedSchema.required)\n                  ? (combinedSchema.required as Array<string>)\n                  : undefined,\n              ),\n              strict: true,\n            },\n          },\n        }\n      : undefined\n\n    // `modelOptions` is the sole sampling surface: callers set provider-native\n    // wire names (`temperature`, `top_p`, `max_tokens`/`max_completion_tokens`)\n    // there and they flow through the spread below. The root\n    // `temperature`/`topP`/`maxTokens` fields are intentionally NOT read here.\n    return {\n      ...modelOptions,\n      model: options.model,\n      messages,\n      // Conditional spread: `tools: undefined` would clobber any\n      // modelOptions.tools the caller set above.\n      ...(tools &&\n        tools.length > 0 && {\n          tools,\n        }),\n      ...(responseFormat ?? {}),\n      stream: true,\n    }\n  }\n\n  /**\n   * Modern OpenAI-compatible Chat Completions APIs support `tools` and\n   * `response_format: json_schema` together in a single streaming request\n   * (per issue #605). Subclasses can override — Groq, for instance, must\n   * return `false` because its API rejects schema + tools + stream with a\n   * 400.\n   */\n  supportsCombinedToolsAndSchema(): boolean {\n    return true\n  }\n\n  /**\n   * Converts a single ModelMessage to the Chat Completions API message format.\n   * Override this in subclasses to handle provider-specific message formats.\n   */\n  protected convertMessage(message: ModelMessage): ChatCompletionMessageParam {\n    // Handle tool messages\n    if (message.role === 'tool') {\n      // The Chat Completions API has no multimodal `tool` message support\n      // (unlike the Responses API's `function_call_output`). A tool that\n      // returns an `Array<ContentPart>` is therefore stringified here — the\n      // documented fallback for providers on the chat-completions path\n      // (Groq, Ollama, Grok, OpenRouter chat). Multimodal tool results are\n      // only delivered structurally via the Responses adapter.\n      return {\n        role: 'tool',\n        tool_call_id: message.toolCallId || '',\n        content:\n          typeof message.content === 'string'\n            ? message.content\n            : JSON.stringify(message.content),\n      }\n    }\n\n    // Handle assistant messages\n    if (message.role === 'assistant') {\n      const toolCalls = message.toolCalls?.map((tc) => ({\n        id: tc.id,\n        type: 'function' as const,\n        function: {\n          name: tc.function.name,\n          arguments:\n            typeof tc.function.arguments === 'string'\n              ? tc.function.arguments\n              : JSON.stringify(tc.function.arguments),\n        },\n      }))\n      const hasToolCalls = !!toolCalls && toolCalls.length > 0\n      const textContent = this.extractTextContent(message.content)\n\n      // Per the OpenAI Chat Completions contract, an assistant message that\n      // only carries tool_calls should have `content: null` (or omit content)\n      // rather than `content: ''`. Empty-string content interacts oddly with\n      // tokenization on some backends; null is the documented shape.\n      return {\n        role: 'assistant',\n        content: hasToolCalls && !textContent ? null : textContent,\n        ...(hasToolCalls ? { tool_calls: toolCalls } : {}),\n      }\n    }\n\n    // Handle user messages - support multimodal content\n    const contentParts = this.normalizeContent(message.content)\n\n    // If only text, use simple string format\n    if (contentParts.length === 1 && contentParts[0]?.type === 'text') {\n      const text = contentParts[0].content\n      if (text.length === 0) {\n        // Single empty text part is the same fail-loud condition as below —\n        // an empty paid request mask a real intent (caller passed `null`/'',\n        // or an upstream step normalised everything to an empty string).\n        throw new Error(\n          `User message for ${this.name} has empty text content. ` +\n            `Empty user messages would produce a paid request with no input; ` +\n            `provide non-empty content or omit the message.`,\n        )\n      }\n      return {\n        role: 'user',\n        content: text,\n      }\n    }\n\n    // Otherwise, use array format for multimodal. Fail fast on unsupported\n    // content parts rather than silently dropping them — a message of all\n    // unsupported parts would otherwise turn into an empty user prompt and\n    // mask a real capability mismatch.\n    const parts: Array<ChatCompletionContentPart> = []\n    for (const part of contentParts) {\n      const converted = this.convertContentPart(part)\n      if (!converted) {\n        throw new Error(\n          `Unsupported content part type for ${this.name}: ${part.type}. ` +\n            `Override convertContentPart() in a subclass to handle this type, ` +\n            `or remove it from the message.`,\n        )\n      }\n      parts.push(converted)\n    }\n\n    if (parts.length === 0) {\n      // The original message had no content parts at all (e.g. content was\n      // explicitly null or []). Sending an empty user message to OpenAI\n      // produces a paid request with no signal — fail loud instead.\n      throw new Error(\n        `User message for ${this.name} has no content parts. ` +\n          `Empty user messages would produce a paid request with no input; ` +\n          `provide at least one text/image/audio part or omit the message.`,\n      )\n    }\n\n    return {\n      role: 'user',\n      content: parts,\n    }\n  }\n\n  /**\n   * Converts a single ContentPart to the Chat Completions API content part format.\n   * Override this in subclasses to handle additional content types or provider-specific metadata.\n   */\n  protected convertContentPart(\n    part: ContentPart,\n  ): ChatCompletionContentPart | null {\n    if (part.type === 'text') {\n      return { type: 'text', text: part.content }\n    }\n\n    if (part.type === 'image') {\n      const imageMetadata = part.metadata as\n        | { detail?: 'auto' | 'low' | 'high' }\n        | undefined\n\n      // For base64 data, construct a data URI using the mimeType from source.\n      // Default to a generic octet-stream MIME if the source didn't provide\n      // one — interpolating `undefined` into the URI (\"data:undefined;base64,\n      // ...\") would produce an invalid URI the API rejects.\n      const imageValue = part.source.value\n      const imageMime = part.source.mimeType || 'application/octet-stream'\n      const imageUrl =\n        part.source.type === 'data' && !imageValue.startsWith('data:')\n          ? `data:${imageMime};base64,${imageValue}`\n          : imageValue\n\n      return {\n        type: 'image_url',\n        image_url: {\n          url: imageUrl,\n          detail: imageMetadata?.detail || 'auto',\n        },\n      }\n    }\n\n    if (part.type === 'document') {\n      // Documents (PDF) are implemented on the Responses adapter, which maps\n      // them to `input_file`. Model modality arrays are not endpoint-scoped,\n      // so a document part can type-check for a model this adapter serves —\n      // point callers at the supported path instead of a generic error.\n      throw new Error(\n        `${this.name} does not support document parts on the Chat Completions ` +\n          `API; use the Responses adapter, which sends them as input_file.`,\n      )\n    }\n\n    // Unsupported content type — subclasses can override to handle more types\n    return null\n  }\n\n  /**\n   * Normalizes message content to an array of ContentPart.\n   * Handles backward compatibility with string content.\n   */\n  protected normalizeContent(\n    content: string | null | Array<ContentPart>,\n  ): Array<ContentPart> {\n    if (content === null) {\n      return []\n    }\n    if (typeof content === 'string') {\n      return [{ type: 'text', content: content }]\n    }\n    return content\n  }\n\n  /**\n   * Extracts text content from a content value that may be string, null, or ContentPart array.\n   */\n  protected extractTextContent(\n    content: string | null | Array<ContentPart>,\n  ): string {\n    if (content === null) {\n      return ''\n    }\n    if (typeof content === 'string') {\n      return content\n    }\n    // It's an array of ContentPart\n    return content\n      .filter((p) => p.type === 'text')\n      .map((p) => p.content)\n      .join('')\n  }\n}\n"],"mappings":"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"}

package/dist/esm/adapters/responses-text.d.ts

@@ -132,7 +132,7 @@ export declare abstract class OpenAIBaseResponsesTextAdapter<TModel extends stri
     protected convertMessagesToInput(messages: Array<ModelMessage>): ResponseInput;
     /**
      * Converts a ContentPart to Responses API input content item.
-     * Handles text, image, and audio content parts.
+     * Handles text, image, audio, and document (PDF) content parts.
      * Override this in subclasses for additional content types or provider-specific metadata.
      */
     protected convertContentPartToInput(part: ContentPart): ResponseInputContent;

package/dist/esm/adapters/responses-text.js

@@ -7,6 +7,7 @@ import { toRunErrorPayload, toRunErrorRawEvent } from "@tanstack/ai/adapter-inte
 import { BaseTextAdapter } from "@tanstack/ai/adapters";
 import { generateId } from "@tanstack/ai-utils";
 //#region src/adapters/responses-text.ts
+var PDF_BASE64_MAGIC = "JVBERi";
 /**
 * Shared implementation of the OpenAI Responses API. Holds the stream-event
 * accumulator + AG-UI lifecycle and calls the OpenAI SDK directly. Subclasses
@@ -1122,7 +1123,7 @@ var OpenAIBaseResponsesTextAdapter = class extends BaseTextAdapter {
 			const contentParts = this.normalizeContent(message.content);
 			const inputContent = [];
 			for (const part of contentParts) inputContent.push(this.convertContentPartToInput(part));
-			if (inputContent.length === 0) throw new Error(`User message for ${this.name} has no content parts. Empty user messages would produce a paid request with no input; provide at least one text/image/audio part or omit the message.`);
+			if (inputContent.length === 0) throw new Error(`User message for ${this.name} has no content parts. Empty user messages would produce a paid request with no input; provide at least one text/image/audio/document part or omit the message.`);
 			result.push({
 				type: "message",
 				role: "user",
@@ -1133,7 +1134,7 @@ var OpenAIBaseResponsesTextAdapter = class extends BaseTextAdapter {
 	}
 	/**
 	* Converts a ContentPart to Responses API input content item.
-	* Handles text, image, and audio content parts.
+	* Handles text, image, audio, and document (PDF) content parts.
 	* Override this in subclasses for additional content types or provider-specific metadata.
 	*/
 	convertContentPartToInput(part) {
@@ -1169,6 +1170,28 @@ var OpenAIBaseResponsesTextAdapter = class extends BaseTextAdapter {
 					file_data: audioValue.startsWith("data:") ? audioValue : `data:${audioMime};base64,${audioValue}`
 				};
 			}
+			case "document": {
+				const documentMetadata = part.metadata;
+				const documentDetail = documentMetadata?.detail !== void 0 ? { detail: documentMetadata.detail } : {};
+				if (part.source.type === "url") return {
+					type: "input_file",
+					file_url: part.source.value,
+					...documentDetail
+				};
+				const documentValue = part.source.value;
+				const documentMime = ((part.source.mimeType || "application/pdf").split(";")[0] ?? "").trim().toLowerCase();
+				if (documentMime !== "application/pdf") throw new Error(`${this.name} document parts only support application/pdf (received ${documentMime})`);
+				if (documentValue.startsWith("data:") && !/^data:application\/pdf[;,]/i.test(documentValue)) throw new Error(`${this.name} document parts only support application/pdf (received data URL with non-PDF media type)`);
+				const documentBase64 = documentValue.startsWith("data:") ? /;base64,/i.test(documentValue) ? documentValue.slice(documentValue.indexOf(",") + 1) : "" : documentValue;
+				if (documentBase64 && !documentBase64.startsWith(PDF_BASE64_MAGIC)) throw new Error(`${this.name} document parts only support application/pdf (inline data does not start with the %PDF header)`);
+				const documentFileData = documentValue.startsWith("data:") ? documentValue : `data:${documentMime};base64,${documentValue}`;
+				return {
+					type: "input_file",
+					filename: documentMetadata?.filename || "document.pdf",
+					file_data: documentFileData,
+					...documentDetail
+				};
+			}
 			default: throw new Error(`Unsupported content part type: ${part.type}`);
 		}
 	}

package/dist/esm/adapters/responses-text.js.map

@@ -1 +1 @@
-{"version":3,"file":"responses-text.js","names":[],"sources":["../../../src/adapters/responses-text.ts"],"sourcesContent":["import { EventType, normalizeSystemPrompts } from '@tanstack/ai'\nimport { BaseTextAdapter } from '@tanstack/ai/adapters'\nimport {\n  toRunErrorPayload,\n  toRunErrorRawEvent,\n} from '@tanstack/ai/adapter-internals'\nimport { generateId } from '@tanstack/ai-utils'\nimport { extractRequestOptions } from '../utils/request-options'\nimport { makeStructuredOutputCompatible } from '../utils/schema-converter'\nimport { buildResponsesUsage } from '../usage'\nimport { convertToolsToResponsesFormat } from './responses-tool-converter'\nimport type OpenAI from 'openai'\nimport type {\n  StructuredOutputOptions,\n  StructuredOutputResult,\n} from '@tanstack/ai/adapters'\nimport type {\n  Response,\n  ResponseCreateParams,\n  ResponseFunctionCallOutputItem,\n  ResponseInput,\n  ResponseInputContent,\n  ResponseStreamEvent,\n} from 'openai/resources/responses/responses'\nimport type {\n  ContentPart,\n  DefaultMessageMetadataByModality,\n  Modality,\n  ModelMessage,\n  StreamChunk,\n  TextOptions,\n} from '@tanstack/ai'\n\n/**\n * Provider-specific metadata that preserves the Responses API output item ID.\n *\n * Responses function calls have two identifiers: `call_id` correlates the\n * function output with the call, while `id` identifies the output item itself.\n * TanStack AI uses `call_id` as the canonical tool-call ID and carries the\n * item ID here so stateless follow-up requests can replay both values.\n */\nexport interface OpenAIResponsesToolCallMetadata {\n  itemId: string\n}\n\ninterface StreamedFunctionCallMetadata {\n  callId: string\n  index: number\n  name: string\n  started: boolean\n  ended?: boolean\n  pendingArguments?: string | undefined\n}\n\n/**\n * Shared implementation of the OpenAI Responses API. Holds the stream-event\n * accumulator + AG-UI lifecycle and calls the OpenAI SDK directly. Subclasses\n * (today: ai-openai) construct an OpenAI client with their provider-specific\n * `baseURL` / headers and pass it in.\n */\nexport abstract class OpenAIBaseResponsesTextAdapter<\n  TModel extends string,\n  TProviderOptions extends Record<string, unknown> = Record<string, unknown>,\n  TInputModalities extends ReadonlyArray<Modality> = ReadonlyArray<Modality>,\n  TMessageMetadata extends DefaultMessageMetadataByModality =\n    DefaultMessageMetadataByModality,\n  TToolCapabilities extends ReadonlyArray<string> = ReadonlyArray<string>,\n> extends BaseTextAdapter<\n  TModel,\n  TProviderOptions,\n  TInputModalities,\n  TMessageMetadata,\n  TToolCapabilities,\n  OpenAIResponsesToolCallMetadata\n> {\n  override readonly kind = 'text' as const\n  readonly name: string\n  protected client: OpenAI\n\n  constructor(model: TModel, name: string, client: OpenAI) {\n    super({}, model)\n    this.name = name\n    this.client = client\n  }\n\n  async *chatStream(\n    options: TextOptions<TProviderOptions>,\n  ): AsyncIterable<StreamChunk> {\n    // Key streamed state by output item ID because argument deltas reference\n    // `item_id`. The state separately retains `call_id`, which is the public\n    // tool-call ID and the correlation key for function_call_output.\n    const toolCallMetadata = new Map<string, StreamedFunctionCallMetadata>()\n\n    // AG-UI lifecycle tracking. Honor a caller-supplied `runId` (as `threadId`\n    // already does) so the emitted RUN_STARTED matches the id the caller keys\n    // durability by — e.g. a summarize run threading the client's runId through\n    // for mid-run reload resumability. Falls back to a generated id.\n    const aguiState = {\n      runId: options.runId ?? generateId(this.name),\n      threadId: options.threadId ?? generateId(this.name),\n      messageId: generateId(this.name),\n      hasEmittedRunStarted: false,\n    }\n\n    try {\n      // mapOptionsToRequest can throw on caller-side validation failures\n      // (empty user content, unsupported parts, webSearchTool() rejection in\n      // the OpenRouter override). Keep it inside the try so those failures\n      // surface as RUN_ERROR events instead of iterator throws.\n      const requestParams = this.mapOptionsToRequest(options)\n      options.logger.request(\n        `activity=chat provider=${this.name} model=${this.model} messages=${options.messages.length} tools=${options.tools?.length ?? 0} stream=true`,\n        { provider: this.name, model: this.model },\n      )\n      const response = await this.client.responses.create(\n        {\n          ...requestParams,\n          stream: true,\n        },\n        extractRequestOptions(options.request),\n      )\n\n      yield* this.processStreamChunks(\n        response,\n        toolCallMetadata,\n        options,\n        aguiState,\n      )\n    } catch (error: unknown) {\n      // Narrow before logging: raw SDK errors can carry request metadata\n      // (including auth headers) which we must never surface to user loggers.\n      const errorPayload = toRunErrorPayload(\n        error,\n        `${this.name}.chatStream failed`,\n      )\n      const rawEvent = toRunErrorRawEvent(error)\n\n      // Emit RUN_STARTED if not yet emitted\n      if (!aguiState.hasEmittedRunStarted) {\n        aguiState.hasEmittedRunStarted = true\n        yield {\n          type: EventType.RUN_STARTED,\n          runId: aguiState.runId,\n          threadId: aguiState.threadId,\n          model: options.model,\n          timestamp: Date.now(),\n          parentRunId: options.parentRunId,\n        }\n      }\n\n      // Emit AG-UI RUN_ERROR. Conditional `code` spread keeps the wire\n      // shape spec-compliant under `exactOptionalPropertyTypes`: AG-UI's\n      // `RunErrorEvent.code` is `string?` (absent vs explicit `undefined`\n      // matter), so we omit the key when there's no code.\n      yield {\n        type: EventType.RUN_ERROR,\n        model: options.model,\n        timestamp: Date.now(),\n        message: errorPayload.message,\n        code: errorPayload.code,\n        // Forward the provider's structured error body when present (see\n        // toRunErrorRawEvent); omitted otherwise.\n        ...(rawEvent !== undefined && { rawEvent }),\n        error: {\n          message: errorPayload.message,\n          code: errorPayload.code,\n        },\n      }\n\n      options.logger.errors(`${this.name}.chatStream fatal`, {\n        error: errorPayload,\n        source: `${this.name}.chatStream`,\n      })\n    }\n  }\n\n  /**\n   * Generate structured output using the provider's native JSON Schema response format.\n   * Uses stream: false to get the complete response in one call.\n   *\n   * OpenAI-compatible Responses APIs have strict requirements for structured output:\n   * - All properties must be in the `required` array\n   * - Optional fields should have null added to their type union\n   * - additionalProperties must be false for all objects\n   *\n   * The outputSchema is already JSON Schema (converted in the ai layer).\n   * We apply provider-specific transformations for structured output compatibility.\n   */\n  async structuredOutput(\n    options: StructuredOutputOptions<TProviderOptions>,\n  ): Promise<StructuredOutputResult<unknown>> {\n    const { chatOptions, outputSchema } = options\n    const requestParams = this.mapOptionsToRequest(chatOptions)\n\n    // Apply provider-specific transformations for structured output compatibility\n    const jsonSchema = this.makeStructuredOutputCompatible(\n      outputSchema,\n      outputSchema.required,\n    )\n\n    try {\n      // Strip streaming-only fields a subclass override of mapOptionsToRequest\n      // might have returned (parallel to chat-completions's structuredOutput\n      // cleanup) — sending stream_options to a non-streaming call is a 4xx.\n      const {\n        stream: _stream,\n        stream_options: _streamOptions,\n        ...cleanParams\n      } = requestParams as Record<string, unknown>\n      void _stream\n      void _streamOptions\n      chatOptions.logger.request(\n        `activity=structuredOutput provider=${this.name} model=${this.model} messages=${chatOptions.messages.length}`,\n        { provider: this.name, model: this.model },\n      )\n      const response = await this.client.responses.create(\n        {\n          ...(cleanParams as Omit<ResponseCreateParams, 'stream'>),\n          stream: false,\n          // Configure structured output via text.format\n          text: {\n            format: {\n              type: 'json_schema',\n              name: 'structured_output',\n              schema: jsonSchema,\n              strict: true,\n            },\n          },\n        },\n        extractRequestOptions(chatOptions.request),\n      )\n\n      // Extract text content from the response. `stream: false` narrows the\n      // SDK return type to `Response`, but the explicit annotation makes\n      // that contract local rather than relying on inference through the\n      // overloaded `client.responses.create` signature.\n      const rawText = this.extractTextFromResponse(response satisfies Response)\n\n      // Fail loud on empty content rather than letting it cascade into a\n      // confusing \"Failed to parse JSON. Content: \" error — the root cause\n      // (the model returned no text content for the structured request) is\n      // then visible in logs. Mirrors the chat-completions sibling.\n      if (rawText.length === 0) {\n        throw new Error(\n          `${this.name}.structuredOutput: response contained no content`,\n        )\n      }\n\n      // Parse the JSON response\n      let parsed: unknown\n      try {\n        parsed = JSON.parse(rawText)\n      } catch {\n        throw new Error(\n          `Failed to parse structured output as JSON. Content: ${rawText.slice(0, 200)}${rawText.length > 200 ? '...' : ''}`,\n        )\n      }\n\n      // Provider-specific post-parse shaping (default passthrough). Null-widening\n      // from strict mode is undone by the engine, not here.\n      const transformed = this.transformStructuredOutput(parsed)\n\n      // Surface usage so non-stream structured paths (and\n      // fallbackStructuredOutputStream) can forward tokens to middleware.\n      const usage = buildResponsesUsage(response.usage)\n      return {\n        data: transformed,\n        rawText,\n        ...(usage && { usage }),\n      }\n    } catch (error: unknown) {\n      // Narrow before logging: raw SDK errors can carry request metadata\n      // (including auth headers) which we must never surface to user loggers.\n      chatOptions.logger.errors(`${this.name}.structuredOutput fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.structuredOutput failed`),\n        source: `${this.name}.structuredOutput`,\n      })\n      throw error\n    }\n  }\n\n  /**\n   * Stream structured output via the Responses API: single request with\n   * `text.format: json_schema` + `stream: true`. Consumes Responses-API\n   * events (`response.output_text.delta`, `response.reasoning_text.delta`,\n   * `response.reasoning_summary_text.delta`, `response.refusal.delta`,\n   * `response.completed`, `response.failed`) and re-emits the standard AG-UI\n   * lifecycle ending with `CUSTOM 'structured-output.complete'`.\n   *\n   * Tools are stripped (structured output is mutually exclusive with tool\n   * calls in this path). Reasoning text is accumulated and surfaced both as\n   * REASONING_* lifecycle events during the stream and on the terminal\n   * CUSTOM event's `value.reasoning`.\n   */\n  async *structuredOutputStream(\n    options: StructuredOutputOptions<TProviderOptions>,\n  ): AsyncIterable<StreamChunk> {\n    const { chatOptions, outputSchema } = options\n    const requestParams = this.mapOptionsToRequest(chatOptions)\n\n    const jsonSchema = this.makeStructuredOutputCompatible(\n      outputSchema,\n      outputSchema.required,\n    )\n\n    const aguiState = {\n      runId: generateId(this.name),\n      threadId: chatOptions.threadId ?? generateId(this.name),\n      messageId: generateId(this.name),\n      hasEmittedRunStarted: false,\n    }\n\n    let accumulatedContent = ''\n    let accumulatedReasoning = ''\n    let hasEmittedTextMessageStart = false\n    let reasoningMessageId: string | undefined\n    let stepId: string | undefined\n    let hasClosedReasoning = false\n    let model: string = chatOptions.model\n    let usage: OpenAI.Responses.Response['usage'] | undefined\n\n    const closeReasoning = function* (this: {\n      name: string\n    }): Generator<StreamChunk> {\n      if (reasoningMessageId && !hasClosedReasoning) {\n        hasClosedReasoning = true\n        yield {\n          type: EventType.REASONING_MESSAGE_END,\n          messageId: reasoningMessageId,\n          model,\n          timestamp: Date.now(),\n        }\n        yield {\n          type: EventType.REASONING_END,\n          messageId: reasoningMessageId,\n          model,\n          timestamp: Date.now(),\n        }\n        if (stepId) {\n          yield {\n            type: EventType.STEP_FINISHED,\n            stepName: stepId,\n            stepId,\n            model,\n            timestamp: Date.now(),\n            content: accumulatedReasoning,\n          }\n        }\n      }\n    }.bind(this)\n\n    const openReasoning = function* (this: {\n      name: string\n    }): Generator<StreamChunk> {\n      if (reasoningMessageId) return\n      reasoningMessageId = generateId(this.name)\n      stepId = generateId(this.name)\n      yield {\n        type: EventType.REASONING_START,\n        messageId: reasoningMessageId,\n        model,\n        timestamp: Date.now(),\n      }\n      yield {\n        type: EventType.REASONING_MESSAGE_START,\n        messageId: reasoningMessageId,\n        role: 'reasoning' as const,\n        model,\n        timestamp: Date.now(),\n      }\n      yield {\n        type: EventType.STEP_STARTED,\n        stepName: stepId,\n        stepId,\n        model,\n        timestamp: Date.now(),\n        stepType: 'thinking',\n      }\n    }.bind(this)\n\n    try {\n      const { tools: _tools, ...cleanParams } = requestParams\n      void _tools\n\n      chatOptions.logger.request(\n        `activity=structuredOutputStream provider=${this.name} model=${this.model} messages=${chatOptions.messages.length}`,\n        { provider: this.name, model: this.model },\n      )\n\n      const stream = await this.client.responses.create(\n        {\n          ...cleanParams,\n          stream: true,\n          text: {\n            format: {\n              type: 'json_schema',\n              name: 'structured_output',\n              schema: jsonSchema,\n              strict: true,\n            },\n          },\n        },\n        extractRequestOptions(chatOptions.request),\n      )\n\n      for await (const chunk of stream) {\n        chatOptions.logger.provider(\n          `provider=${this.name} type=${chunk.type}`,\n          { provider: this.name, type: chunk.type },\n        )\n\n        if (!aguiState.hasEmittedRunStarted) {\n          aguiState.hasEmittedRunStarted = true\n          yield {\n            type: EventType.RUN_STARTED,\n            runId: aguiState.runId,\n            threadId: aguiState.threadId,\n            model,\n            timestamp: Date.now(),\n            parentRunId: chatOptions.parentRunId,\n          }\n        }\n\n        if (\n          chunk.type === 'response.created' ||\n          chunk.type === 'response.in_progress'\n        ) {\n          const responseModel = (chunk as { response?: { model?: string } })\n            .response?.model\n          if (responseModel) model = responseModel\n          continue\n        }\n\n        if (chunk.type === 'response.refusal.delta') {\n          const delta =\n            typeof (chunk as { delta?: unknown }).delta === 'string'\n              ? (chunk as { delta: string }).delta\n              : ''\n          yield {\n            type: EventType.RUN_ERROR,\n            runId: aguiState.runId,\n            model,\n            timestamp: Date.now(),\n            message: `Model refused: ${delta}`,\n            code: 'refusal',\n            error: { message: `Model refused: ${delta}`, code: 'refusal' },\n          }\n          return\n        }\n\n        if (\n          chunk.type === 'response.reasoning_text.delta' ||\n          chunk.type === 'response.reasoning_summary_text.delta'\n        ) {\n          const raw = (chunk as { delta?: unknown }).delta\n          const reasoningDelta = Array.isArray(raw)\n            ? raw.join('')\n            : typeof raw === 'string'\n              ? raw\n              : ''\n          if (!reasoningDelta) continue\n          yield* openReasoning()\n          // openReasoning() guarantees reasoningMessageId is set on first call;\n          // TS can't see through the generator side-effect.\n          if (!reasoningMessageId) continue\n          accumulatedReasoning += reasoningDelta\n          yield {\n            type: EventType.REASONING_MESSAGE_CONTENT,\n            messageId: reasoningMessageId,\n            delta: reasoningDelta,\n            model,\n            timestamp: Date.now(),\n          }\n          continue\n        }\n\n        if (chunk.type === 'response.output_text.delta') {\n          const raw = (chunk as { delta?: unknown }).delta\n          const textDelta = Array.isArray(raw)\n            ? raw.join('')\n            : typeof raw === 'string'\n              ? raw\n              : ''\n          if (!textDelta) continue\n\n          yield* closeReasoning()\n\n          if (!hasEmittedTextMessageStart) {\n            hasEmittedTextMessageStart = true\n            yield {\n              type: EventType.TEXT_MESSAGE_START,\n              messageId: aguiState.messageId,\n              model,\n              timestamp: Date.now(),\n              role: 'assistant',\n            }\n          }\n          accumulatedContent += textDelta\n          yield {\n            type: EventType.TEXT_MESSAGE_CONTENT,\n            messageId: aguiState.messageId,\n            model,\n            timestamp: Date.now(),\n            delta: textDelta,\n            content: accumulatedContent,\n          }\n          continue\n        }\n\n        if (chunk.type === 'response.completed') {\n          const response = chunk.response\n          if (response.usage) usage = response.usage\n          if (response.model) model = response.model\n          continue\n        }\n\n        if (chunk.type === 'response.failed') {\n          const response = (\n            chunk as {\n              response?: { error?: { message?: string; code?: string } }\n            }\n          ).response\n          const message =\n            response?.error?.message || 'Responses API stream failed'\n          const code = response?.error?.code\n          // Conditional `code` spread keeps the wire shape spec-compliant\n          // under `exactOptionalPropertyTypes` (see chatStream catch).\n          yield {\n            type: EventType.RUN_ERROR,\n            runId: aguiState.runId,\n            model,\n            timestamp: Date.now(),\n            message,\n            ...(code !== undefined && { code }),\n            error: { message, ...(code !== undefined && { code }) },\n          }\n          return\n        }\n      }\n\n      yield* closeReasoning()\n\n      if (hasEmittedTextMessageStart) {\n        yield {\n          type: EventType.TEXT_MESSAGE_END,\n          messageId: aguiState.messageId,\n          model,\n          timestamp: Date.now(),\n        }\n      }\n\n      if (accumulatedContent.length === 0) {\n        yield {\n          type: EventType.RUN_ERROR,\n          runId: aguiState.runId,\n          model,\n          timestamp: Date.now(),\n          message: `${this.name}.structuredOutputStream: response contained no content`,\n          code: 'empty-response',\n          error: {\n            message: `${this.name}.structuredOutputStream: response contained no content`,\n            code: 'empty-response',\n          },\n        }\n        return\n      }\n\n      let parsed: unknown\n      try {\n        parsed = JSON.parse(accumulatedContent)\n      } catch {\n        yield {\n          type: EventType.RUN_ERROR,\n          runId: aguiState.runId,\n          model,\n          timestamp: Date.now(),\n          message: `Failed to parse structured output as JSON. Content: ${accumulatedContent.slice(0, 200)}${accumulatedContent.length > 200 ? '...' : ''}`,\n          code: 'parse-error',\n          error: {\n            message: 'Failed to parse structured output as JSON',\n            code: 'parse-error',\n          },\n        }\n        return\n      }\n\n      // Route through the same hook as the non-streaming path (default\n      // passthrough). Engine un-widens nulls; the streaming path must not strip\n      // them blindly either.\n      const transformed = this.transformStructuredOutput(parsed)\n\n      yield {\n        type: EventType.CUSTOM,\n        name: 'structured-output.complete',\n        value: {\n          object: transformed,\n          raw: accumulatedContent,\n          ...(accumulatedReasoning ? { reasoning: accumulatedReasoning } : {}),\n        },\n        model,\n        timestamp: Date.now(),\n      }\n\n      yield {\n        type: EventType.RUN_FINISHED,\n        runId: aguiState.runId,\n        threadId: aguiState.threadId,\n        model,\n        timestamp: Date.now(),\n        finishReason: 'stop',\n        ...(usage && {\n          usage: buildResponsesUsage(usage),\n        }),\n      }\n    } catch (error: unknown) {\n      if (!aguiState.hasEmittedRunStarted) {\n        aguiState.hasEmittedRunStarted = true\n        yield {\n          type: EventType.RUN_STARTED,\n          runId: aguiState.runId,\n          threadId: aguiState.threadId,\n          model,\n          timestamp: Date.now(),\n          parentRunId: chatOptions.parentRunId,\n        }\n      }\n\n      const isAbort = this.isAbortError(error)\n      const errorPayload = toRunErrorPayload(\n        error,\n        `${this.name}.structuredOutputStream failed`,\n      )\n\n      // Conditional `code` spread keeps the wire shape spec-compliant under\n      // `exactOptionalPropertyTypes` (see chatStream catch).\n      const resolvedCode = isAbort ? 'aborted' : errorPayload.code\n      const rawEvent = isAbort ? undefined : toRunErrorRawEvent(error)\n      yield {\n        type: EventType.RUN_ERROR,\n        runId: aguiState.runId,\n        model,\n        timestamp: Date.now(),\n        message: errorPayload.message,\n        ...(resolvedCode !== undefined && { code: resolvedCode }),\n        ...(rawEvent !== undefined && { rawEvent }),\n        error: {\n          message: errorPayload.message,\n          ...(resolvedCode !== undefined && { code: resolvedCode }),\n        },\n      }\n\n      chatOptions.logger.errors(`${this.name}.structuredOutputStream fatal`, {\n        error: errorPayload,\n        source: `${this.name}.structuredOutputStream`,\n      })\n    }\n  }\n\n  /**\n   * Cross-SDK abort detection for `structuredOutputStream`. Mirrors the\n   * Chat Completions base; subclasses with proprietary error types override.\n   */\n  protected isAbortError(error: unknown): boolean {\n    if (!error || typeof error !== 'object') return false\n    const e = error as { name?: unknown; code?: unknown }\n    return (\n      e.name === 'APIUserAbortError' ||\n      e.name === 'AbortError' ||\n      e.code === 'ERR_CANCELED'\n    )\n  }\n\n  /**\n   * Applies provider-specific transformations for structured output compatibility.\n   * Override this in subclasses to handle provider-specific quirks.\n   */\n  protected makeStructuredOutputCompatible(\n    schema: Record<string, any>,\n    originalRequired?: Array<string>,\n  ): Record<string, any> {\n    return makeStructuredOutputCompatible(schema, originalRequired)\n  }\n\n  /**\n   * Final shaping pass applied to parsed structured-output JSON before it is\n   * returned to the caller. Default is a passthrough.\n   *\n   * Provider `null`s are no longer stripped here: strict-mode null-widening is\n   * now undone precisely by the engine (`undoNullWidening`, driven by the\n   * schema's null-widening map) the moment the result is captured, so a blind\n   * `transformNullsToUndefined` at the adapter would only destroy genuine\n   * `.nullable()` nulls. Subclasses may still override to remap or reshape the\n   * provider's structured output.\n   */\n  protected transformStructuredOutput(parsed: unknown): unknown {\n    return parsed\n  }\n\n  /**\n   * Extract text content from a non-streaming Responses API response.\n   * Override this in subclasses for provider-specific response shapes.\n   */\n  protected extractTextFromResponse(response: Response): string {\n    let textContent = ''\n    let refusal: string | undefined\n    let sawMessageItem = false\n    const observedItemTypes = new Set<string>()\n\n    for (const item of response.output) {\n      observedItemTypes.add(item.type)\n      if (item.type === 'message') {\n        sawMessageItem = true\n        for (const part of item.content) {\n          // Cast off the discriminated union before the type discrimination\n          // so future SDK variants (e.g. `output_audio`, `output_image`) hit\n          // the explicit error path rather than being misreported as refusals\n          // when they get added to the union. Mirrors the streaming side's\n          // handleContentPart.\n          const partType = (part as { type: string }).type\n          if (partType === 'output_text') {\n            textContent += (part as { text?: string }).text ?? ''\n          } else if (partType === 'refusal') {\n            const refusalText = (part as { refusal?: string }).refusal\n            refusal = refusalText || refusal || 'Refused without explanation'\n          } else {\n            throw new Error(\n              `${this.name}.extractTextFromResponse: unsupported message content part type \"${partType}\"`,\n            )\n          }\n        }\n      }\n    }\n\n    // Surface refusals as an explicit error so callers don't see a generic\n    // \"Failed to parse structured output as JSON. Content: \" when the model\n    // refused for safety / content-policy reasons.\n    if (!textContent && refusal !== undefined) {\n      const err = new Error(`Model refused to respond: ${refusal}`)\n      ;(err as Error & { code?: string }).code = 'refusal'\n      throw err\n    }\n\n    // Response had items but none carried message text (e.g. only\n    // function_call or reasoning items). Surface that explicitly so a\n    // downstream structured-output caller doesn't see a misleading\n    // \"Failed to parse JSON. Content: \" from an empty string.\n    if (!textContent && response.output.length > 0 && !sawMessageItem) {\n      throw new Error(\n        `${this.name}.extractTextFromResponse: response.output contained items of type(s) [${[...observedItemTypes].sort().join(', ')}] but no message text — the model returned a non-text response`,\n      )\n    }\n\n    return textContent\n  }\n\n  /**\n   * Processes streamed chunks from the Responses API and yields AG-UI events.\n   * Override this in subclasses to handle provider-specific stream behavior.\n   *\n   * Handles the following event types:\n   * - response.created / response.incomplete / response.failed\n   * - response.output_text.delta\n   * - response.reasoning_text.delta\n   * - response.reasoning_summary_text.delta\n   * - response.content_part.added / response.content_part.done\n   * - response.output_item.added\n   * - response.function_call_arguments.delta / response.function_call_arguments.done\n   * - response.completed\n   * - error\n   */\n  protected async *processStreamChunks(\n    stream: AsyncIterable<ResponseStreamEvent>,\n    toolCallMetadata: Map<string, StreamedFunctionCallMetadata>,\n    options: TextOptions<TProviderOptions>,\n    aguiState: {\n      runId: string\n      threadId: string\n      messageId: string\n      hasEmittedRunStarted: boolean\n    },\n  ): AsyncIterable<StreamChunk> {\n    let accumulatedContent = ''\n    let accumulatedReasoning = ''\n\n    // Track if we've been streaming deltas to avoid duplicating content from done events\n    let hasStreamedContentDeltas = false\n    let hasStreamedReasoningDeltas = false\n\n    // Preserve response metadata across events\n    let model: string = options.model\n\n    // AG-UI lifecycle tracking\n    let stepId: string | null = null\n    let hasEmittedTextMessageStart = false\n    let hasEmittedStepStarted = false\n    // Track whether we've emitted a terminal RUN_FINISHED so the\n    // end-of-stream fallback below knows to synthesise one when the upstream\n    // cuts off without a response.completed event.\n    let runFinishedEmitted = false\n\n    try {\n      for await (const chunk of stream) {\n        options.logger.provider(`provider=${this.name} type=${chunk.type}`, {\n          provider: this.name,\n          type: chunk.type,\n        })\n\n        // Emit RUN_STARTED on first chunk\n        if (!aguiState.hasEmittedRunStarted) {\n          aguiState.hasEmittedRunStarted = true\n          yield {\n            type: EventType.RUN_STARTED,\n            runId: aguiState.runId,\n            threadId: aguiState.threadId,\n            model: model || options.model,\n            timestamp: Date.now(),\n            parentRunId: options.parentRunId,\n          }\n        }\n\n        const handleContentPart = (contentPart: {\n          type: string\n          text?: string\n          refusal?: string\n        }): StreamChunk => {\n          if (contentPart.type === 'output_text') {\n            accumulatedContent += contentPart.text || ''\n            return {\n              type: EventType.TEXT_MESSAGE_CONTENT,\n              messageId: aguiState.messageId,\n              model: model || options.model,\n              timestamp: Date.now(),\n              delta: contentPart.text || '',\n              content: accumulatedContent,\n            }\n          }\n\n          if (contentPart.type === 'reasoning_text') {\n            accumulatedReasoning += contentPart.text || ''\n            // Cache the fallback stepId rather than generating a fresh one\n            // on every call — otherwise multiple reasoning chunks arriving\n            // before STEP_STARTED was emitted (e.g. via response.content_part.done\n            // alone) would each get a different stepId and break correlation.\n            if (!stepId) {\n              stepId = generateId(this.name)\n            }\n            return {\n              type: EventType.STEP_FINISHED,\n              stepName: stepId,\n              stepId,\n              model: model || options.model,\n              timestamp: Date.now(),\n              delta: contentPart.text || '',\n              content: accumulatedReasoning,\n            }\n          }\n          // Either a real refusal or an unknown content_part type. Surface\n          // the part type in the error so unknown parts are debuggable\n          // instead of being misreported as \"Unknown refusal\".\n          const isRefusal = contentPart.type === 'refusal'\n          const message = isRefusal\n            ? contentPart.refusal || 'Refused without explanation'\n            : `Unsupported response content_part type: ${contentPart.type}`\n          const code = isRefusal ? 'refusal' : contentPart.type\n          return {\n            type: EventType.RUN_ERROR,\n            model: model || options.model,\n            timestamp: Date.now(),\n            message,\n            code,\n            error: { message, code },\n          }\n        }\n\n        // Capture model metadata from any of these events (created starts\n        // the run; failed/incomplete signal terminal failure).\n        if (\n          chunk.type === 'response.created' ||\n          chunk.type === 'response.incomplete' ||\n          chunk.type === 'response.failed'\n        ) {\n          model = chunk.response.model\n        }\n\n        // response.created marks the start of a fresh run — safe to reset\n        // the per-run accumulators here.\n        if (chunk.type === 'response.created') {\n          hasStreamedContentDeltas = false\n          hasStreamedReasoningDeltas = false\n          hasEmittedTextMessageStart = false\n          hasEmittedStepStarted = false\n          accumulatedContent = ''\n          accumulatedReasoning = ''\n        }\n\n        // response.failed and response.incomplete are TERMINAL events for\n        // the current response. Close any open AG-UI message lifecycle FIRST\n        // so consumers tracking start/end pairs don't see an unbalanced\n        // TEXT_MESSAGE_START. Then surface the error and mark the run as\n        // finished so the post-loop synthetic terminal block doesn't emit\n        // a duplicate RUN_FINISHED on top of RUN_ERROR.\n        if (\n          chunk.type === 'response.failed' ||\n          chunk.type === 'response.incomplete'\n        ) {\n          if (hasEmittedTextMessageStart) {\n            yield {\n              type: EventType.TEXT_MESSAGE_END,\n              messageId: aguiState.messageId,\n              model: chunk.response.model,\n              timestamp: Date.now(),\n            }\n            hasEmittedTextMessageStart = false\n          }\n          // Coalesce error + incomplete_details into a single RUN_ERROR\n          // payload — emitting two distinct events for one terminal upstream\n          // event would force consumers to handle a non-existent ordering.\n          const errorMessage =\n            chunk.response.error?.message ||\n            chunk.response.incomplete_details?.reason ||\n            (chunk.type === 'response.failed'\n              ? 'Response failed'\n              : 'Response ended incomplete')\n          const errorCode =\n            chunk.response.error?.code ??\n            (chunk.response.incomplete_details ? 'incomplete' : undefined) ??\n            undefined\n          // Always emit RUN_ERROR for terminal failure events, even when the\n          // upstream omitted both `error` and `incomplete_details`. Skipping\n          // emission on a `response.incomplete` with no detail would let the\n          // post-loop synthetic block silently coerce the run to a clean\n          // `RUN_FINISHED { finishReason: 'stop' }` — masking the failure.\n          yield {\n            type: EventType.RUN_ERROR,\n            model: chunk.response.model,\n            timestamp: Date.now(),\n            message: errorMessage,\n            ...(errorCode !== undefined && { code: errorCode }),\n            error: {\n              message: errorMessage,\n              ...(errorCode !== undefined && { code: errorCode }),\n            },\n          }\n          // RUN_ERROR is the terminal event for this run; stop processing\n          // any further chunks the iterator might still deliver.\n          runFinishedEmitted = true\n          return\n        }\n\n        // Handle output text deltas (token-by-token streaming)\n        // response.output_text.delta provides incremental text updates\n        if (chunk.type === 'response.output_text.delta' && chunk.delta) {\n          // Delta can be an array of strings or a single string\n          const textDelta = Array.isArray(chunk.delta)\n            ? chunk.delta.join('')\n            : typeof chunk.delta === 'string'\n              ? chunk.delta\n              : ''\n\n          if (textDelta) {\n            // Emit TEXT_MESSAGE_START on first text content\n            if (!hasEmittedTextMessageStart) {\n              hasEmittedTextMessageStart = true\n              yield {\n                type: EventType.TEXT_MESSAGE_START,\n                messageId: aguiState.messageId,\n                model: model || options.model,\n                timestamp: Date.now(),\n                role: 'assistant',\n              }\n            }\n\n            accumulatedContent += textDelta\n            hasStreamedContentDeltas = true\n            yield {\n              type: EventType.TEXT_MESSAGE_CONTENT,\n              messageId: aguiState.messageId,\n              model: model || options.model,\n              timestamp: Date.now(),\n              delta: textDelta,\n              content: accumulatedContent,\n            }\n          }\n        }\n\n        // Handle reasoning deltas (token-by-token thinking/reasoning streaming)\n        // response.reasoning_text.delta provides incremental reasoning updates\n        if (chunk.type === 'response.reasoning_text.delta' && chunk.delta) {\n          // Delta can be an array of strings or a single string\n          const reasoningDelta = Array.isArray(chunk.delta)\n            ? chunk.delta.join('')\n            : typeof chunk.delta === 'string'\n              ? chunk.delta\n              : ''\n\n          if (reasoningDelta) {\n            // Emit STEP_STARTED on first reasoning content\n            if (!hasEmittedStepStarted) {\n              hasEmittedStepStarted = true\n              stepId = generateId(this.name)\n              yield {\n                type: EventType.STEP_STARTED,\n                stepName: stepId,\n                stepId,\n                model: model || options.model,\n                timestamp: Date.now(),\n                stepType: 'thinking',\n              }\n            }\n\n            accumulatedReasoning += reasoningDelta\n            hasStreamedReasoningDeltas = true\n            const fallbackStepId = stepId || generateId(this.name)\n            yield {\n              type: EventType.STEP_FINISHED,\n              stepName: fallbackStepId,\n              stepId: fallbackStepId,\n              model: model || options.model,\n              timestamp: Date.now(),\n              delta: reasoningDelta,\n              content: accumulatedReasoning,\n            }\n          }\n        }\n\n        // Handle reasoning summary deltas (when using reasoning.summary option)\n        // response.reasoning_summary_text.delta provides incremental summary updates\n        if (\n          chunk.type === 'response.reasoning_summary_text.delta' &&\n          chunk.delta\n        ) {\n          const summaryDelta =\n            typeof chunk.delta === 'string' ? chunk.delta : ''\n\n          if (summaryDelta) {\n            // Emit STEP_STARTED on first reasoning content\n            if (!hasEmittedStepStarted) {\n              hasEmittedStepStarted = true\n              stepId = generateId(this.name)\n              yield {\n                type: EventType.STEP_STARTED,\n                stepName: stepId,\n                stepId,\n                model: model || options.model,\n                timestamp: Date.now(),\n                stepType: 'thinking',\n              }\n            }\n\n            accumulatedReasoning += summaryDelta\n            hasStreamedReasoningDeltas = true\n            const fallbackStepId = stepId || generateId(this.name)\n            yield {\n              type: EventType.STEP_FINISHED,\n              stepName: fallbackStepId,\n              stepId: fallbackStepId,\n              model: model || options.model,\n              timestamp: Date.now(),\n              delta: summaryDelta,\n              content: accumulatedReasoning,\n            }\n          }\n        }\n\n        // handle content_part added events for text, reasoning and refusals\n        if (chunk.type === 'response.content_part.added') {\n          const contentPart = chunk.part\n          // Emit TEXT_MESSAGE_START if this is text content\n          if (\n            contentPart.type === 'output_text' &&\n            !hasEmittedTextMessageStart\n          ) {\n            hasEmittedTextMessageStart = true\n            yield {\n              type: EventType.TEXT_MESSAGE_START,\n              messageId: aguiState.messageId,\n              model: model || options.model,\n              timestamp: Date.now(),\n              role: 'assistant',\n            }\n          }\n          // Emit STEP_STARTED if this is reasoning content\n          if (contentPart.type === 'reasoning_text' && !hasEmittedStepStarted) {\n            hasEmittedStepStarted = true\n            stepId = generateId(this.name)\n            yield {\n              type: EventType.STEP_STARTED,\n              stepName: stepId,\n              stepId,\n              model: model || options.model,\n              timestamp: Date.now(),\n              stepType: 'thinking',\n            }\n          }\n          // Mark whichever stream we just emitted into so a subsequent\n          // `content_part.done` doesn't duplicate the same text. Without\n          // this flag, an `added` event carrying the full text followed by\n          // a matching `done` event would emit TEXT_MESSAGE_CONTENT twice.\n          if (contentPart.type === 'output_text') {\n            hasStreamedContentDeltas = true\n          } else if (contentPart.type === 'reasoning_text') {\n            hasStreamedReasoningDeltas = true\n          }\n          const partChunk = handleContentPart(contentPart)\n          yield partChunk\n          // handleContentPart returns RUN_ERROR for refusals / unknown\n          // content_part types — those are terminal events. Don't keep\n          // processing more chunks (and don't let the post-loop synthetic\n          // block emit a second terminal event).\n          if (partChunk.type === 'RUN_ERROR') {\n            runFinishedEmitted = true\n            return\n          }\n        }\n\n        if (chunk.type === 'response.content_part.done') {\n          const contentPart = chunk.part\n\n          // Skip emitting chunks for content parts that we've already streamed via deltas\n          // The done event is just a completion marker, not new content\n          if (contentPart.type === 'output_text' && hasStreamedContentDeltas) {\n            // Content already accumulated from deltas, skip\n            continue\n          }\n          if (\n            contentPart.type === 'reasoning_text' &&\n            hasStreamedReasoningDeltas\n          ) {\n            // Reasoning already accumulated from deltas, skip\n            continue\n          }\n\n          // Upstreams that emit `content_part.done` without any preceding\n          // deltas (or `content_part.added`) still need a START event before\n          // CONTENT — otherwise consumers tracking start/end pairs see content\n          // without a start and never see an end. Emit the lifecycle opener\n          // for whichever stream this content_part belongs to before yielding\n          // the CONTENT chunk; the post-loop block emits the matching END.\n          if (\n            contentPart.type === 'output_text' &&\n            !hasEmittedTextMessageStart\n          ) {\n            hasEmittedTextMessageStart = true\n            yield {\n              type: EventType.TEXT_MESSAGE_START,\n              messageId: aguiState.messageId,\n              model: model || options.model,\n              timestamp: Date.now(),\n              role: 'assistant',\n            }\n          } else if (\n            contentPart.type === 'reasoning_text' &&\n            !hasEmittedStepStarted\n          ) {\n            hasEmittedStepStarted = true\n            stepId = generateId(this.name)\n            yield {\n              type: EventType.STEP_STARTED,\n              stepName: stepId,\n              stepId,\n              model: model || options.model,\n              timestamp: Date.now(),\n              stepType: 'thinking',\n            }\n          }\n\n          // Only emit if we haven't been streaming deltas (e.g., for non-streaming responses)\n          const doneChunk = handleContentPart(contentPart)\n          yield doneChunk\n          if (doneChunk.type === 'RUN_ERROR') {\n            runFinishedEmitted = true\n            return\n          }\n        }\n\n        // handle output_item.added to capture function call metadata (name)\n        if (chunk.type === 'response.output_item.added') {\n          const item = chunk.item\n          if (item.type === 'function_call' && item.id) {\n            // Track the item as soon as we see it so subsequent arg deltas\n            // aren't logged as orphans, but only emit TOOL_CALL_START when\n            // both id AND name are populated. Emitting START with an empty\n            // name would propagate into TOOL_CALL_END (which reads the same\n            // metadata) and route the tool call to whatever name happens to\n            // match `''` downstream — a silent misroute.\n            let metadata = toolCallMetadata.get(item.id)\n            if (!metadata) {\n              metadata = {\n                callId: item.call_id || item.id,\n                index: chunk.output_index,\n                name: item.name || '',\n                started: false,\n              }\n              toolCallMetadata.set(item.id, metadata)\n            } else {\n              if (item.call_id) metadata.callId = item.call_id\n              if (!metadata.name && item.name) {\n                // A later output_item.added for the same id finally carries\n                // the name. Update so the gated emission below can fire.\n                metadata.name = item.name\n              }\n            }\n            if (!metadata.started && metadata.name) {\n              yield {\n                type: EventType.TOOL_CALL_START,\n                toolCallId: metadata.callId,\n                toolCallName: metadata.name,\n                toolName: metadata.name,\n                parentMessageId: aguiState.messageId,\n                model: model || options.model,\n                timestamp: Date.now(),\n                index: chunk.output_index,\n                metadata: {\n                  itemId: item.id,\n                } satisfies OpenAIResponsesToolCallMetadata,\n              }\n              metadata.started = true\n            }\n          }\n        }\n\n        // Handle function call arguments delta (streaming). Drop the\n        // previously-emitted `args` field — it had inverted polarity\n        // (populated only when metadata was MISSING, i.e. when the\n        // matching TOOL_CALL_START hadn't fired) and the chat-completions\n        // adapter never emitted it, so it leaked partial deltas as\n        // pseudo-args only on the orphan path. Consumers should accumulate\n        // `delta` themselves.\n        //\n        // Guard with `metadata?.started`: the matching TOOL_CALL_START fires\n        // from `output_item.added`, and emitting TOOL_CALL_ARGS before that\n        // would violate the AG-UI lifecycle (ARGS without START). The .done\n        // handler below applies the same guard.\n        if (\n          chunk.type === 'response.function_call_arguments.delta' &&\n          chunk.delta\n        ) {\n          const metadata = toolCallMetadata.get(chunk.item_id)\n          if (!metadata?.started) {\n            options.logger.errors(\n              `${this.name}.processStreamChunks orphan function_call_arguments.delta`,\n              {\n                source: `${this.name}.processStreamChunks`,\n                // No metadata yet, so the `call_id` is unknown here — only the\n                // output item id the delta referenced.\n                itemId: chunk.item_id,\n                rawDelta: chunk.delta,\n              },\n            )\n            continue\n          }\n          yield {\n            type: EventType.TOOL_CALL_ARGS,\n            toolCallId: metadata.callId,\n            model: model || options.model,\n            timestamp: Date.now(),\n            delta: chunk.delta,\n          }\n        }\n\n        if (chunk.type === 'response.function_call_arguments.done') {\n          const { item_id } = chunk\n\n          // Get the function name from metadata (captured in output_item.added)\n          const metadata = toolCallMetadata.get(item_id)\n          // If the matching START was never emitted (the upstream sent an\n          // `output_item.added` without a name and no later event has filled\n          // it in yet), defer END until `output_item.done` or\n          // `response.completed` can backfill the name. We stash the raw\n          // arguments so the late emission has them. Emitting END without\n          // START would produce an unbalanced AG-UI lifecycle event\n          // downstream consumers can't pair.\n          if (!metadata?.started) {\n            if (metadata) {\n              metadata.pendingArguments = chunk.arguments\n            }\n            options.logger.errors(\n              `${this.name}.processStreamChunks deferring function_call_arguments.done — TOOL_CALL_START not yet emitted (waiting for name)`,\n              {\n                source: `${this.name}.processStreamChunks`,\n                ...(metadata && { toolCallId: metadata.callId }),\n                itemId: item_id,\n                rawArguments: chunk.arguments,\n              },\n            )\n            continue\n          }\n          // The output_item.done backstop may have already emitted END (when\n          // it arrived before args.done with a populated item.arguments).\n          // Skip so we never produce a duplicate close for the same id.\n          if (metadata.ended) continue\n          const name = metadata.name || ''\n          metadata.ended = true\n\n          // Parse arguments. Surface parse failures via the logger so a\n          // model emitting malformed JSON is debuggable instead of silently\n          // invoking the tool with {}.\n          let parsedInput: unknown = {}\n          if (chunk.arguments) {\n            try {\n              const parsed = JSON.parse(chunk.arguments)\n              parsedInput = parsed && typeof parsed === 'object' ? parsed : {}\n            } catch (parseError) {\n              options.logger.errors(\n                `${this.name}.processStreamChunks tool-args JSON parse failed`,\n                {\n                  error: toRunErrorPayload(\n                    parseError,\n                    `tool ${name} (${metadata.callId}) returned malformed JSON arguments`,\n                  ),\n                  source: `${this.name}.processStreamChunks`,\n                  toolCallId: metadata.callId,\n                  itemId: item_id,\n                  toolName: name,\n                  rawArguments: chunk.arguments,\n                },\n              )\n              parsedInput = {}\n            }\n          }\n\n          yield {\n            type: EventType.TOOL_CALL_END,\n            toolCallId: metadata.callId,\n            toolCallName: name,\n            toolName: name,\n            model: model || options.model,\n            timestamp: Date.now(),\n            input: parsedInput,\n          }\n        }\n\n        // `output_item.done` is the last point at which a function_call's\n        // name is guaranteed to be on the wire — it carries the fully-formed\n        // ResponseFunctionToolCall. Use it as a backstop to recover any\n        // tool call whose name was missing from `output_item.added` (and\n        // whose START + END therefore never fired).\n        if (chunk.type === 'response.output_item.done') {\n          const item = chunk.item\n          if (item.type === 'function_call' && item.id) {\n            const metadata = toolCallMetadata.get(item.id) ?? {\n              callId: item.call_id || item.id,\n              index: chunk.output_index,\n              name: item.name || '',\n              started: false,\n            }\n            if (!toolCallMetadata.has(item.id)) {\n              toolCallMetadata.set(item.id, metadata)\n            } else {\n              if (item.call_id) metadata.callId = item.call_id\n              if (!metadata.name && item.name) metadata.name = item.name\n            }\n            // Emit gated START if we now have a name and never started.\n            if (!metadata.started && metadata.name) {\n              yield {\n                type: EventType.TOOL_CALL_START,\n                toolCallId: metadata.callId,\n                toolCallName: metadata.name,\n                toolName: metadata.name,\n                parentMessageId: aguiState.messageId,\n                model: model || options.model,\n                timestamp: Date.now(),\n                index: metadata.index,\n                metadata: {\n                  itemId: item.id,\n                } satisfies OpenAIResponsesToolCallMetadata,\n              }\n              metadata.started = true\n            }\n            // Emit END if we have args (either from a previously-deferred\n            // args.done OR from item.arguments) and haven't already ended.\n            const rawArgs =\n              typeof item.arguments === 'string' && item.arguments.length > 0\n                ? item.arguments\n                : metadata.pendingArguments\n            if (metadata.started && !metadata.ended && rawArgs !== undefined) {\n              const name = metadata.name || ''\n              let parsedInput: unknown = {}\n              if (rawArgs) {\n                try {\n                  const parsed = JSON.parse(rawArgs)\n                  parsedInput =\n                    parsed && typeof parsed === 'object' ? parsed : {}\n                } catch (parseError) {\n                  options.logger.errors(\n                    `${this.name}.processStreamChunks tool-args JSON parse failed (output_item.done backfill)`,\n                    {\n                      error: toRunErrorPayload(\n                        parseError,\n                        `tool ${name} (${metadata.callId}) returned malformed JSON arguments`,\n                      ),\n                      source: `${this.name}.processStreamChunks`,\n                      toolCallId: metadata.callId,\n                      itemId: item.id,\n                      toolName: name,\n                      rawArguments: rawArgs,\n                    },\n                  )\n                  parsedInput = {}\n                }\n              }\n              yield {\n                type: EventType.TOOL_CALL_END,\n                toolCallId: metadata.callId,\n                toolCallName: name,\n                toolName: name,\n                model: model || options.model,\n                timestamp: Date.now(),\n                input: parsedInput,\n              }\n              metadata.ended = true\n              metadata.pendingArguments = undefined\n            }\n          }\n        }\n\n        if (chunk.type === 'response.completed') {\n          // Final backstop for function_call lifecycle: if a function_call\n          // appears in `response.output[]` but was never matched by an\n          // output_item.added/done with a name, recover the missing START\n          // (and END if args were pending). Without this, a tool call could\n          // be silently dropped from the AG-UI stream while `hasFunctionCalls`\n          // below still routes the run's finishReason to 'tool_calls' —\n          // leaving consumers waiting for tool results they never saw start.\n          for (const item of chunk.response.output) {\n            if (item.type !== 'function_call' || !item.id) continue\n            const metadata = toolCallMetadata.get(item.id) ?? {\n              callId: item.call_id || item.id,\n              index: 0,\n              name: item.name || '',\n              started: false,\n            }\n            if (!toolCallMetadata.has(item.id)) {\n              toolCallMetadata.set(item.id, metadata)\n            } else {\n              if (item.call_id) metadata.callId = item.call_id\n              if (!metadata.name && item.name) metadata.name = item.name\n            }\n            if (!metadata.started && metadata.name) {\n              yield {\n                type: EventType.TOOL_CALL_START,\n                toolCallId: metadata.callId,\n                toolCallName: metadata.name,\n                toolName: metadata.name,\n                parentMessageId: aguiState.messageId,\n                model: model || options.model,\n                timestamp: Date.now(),\n                index: metadata.index,\n                metadata: {\n                  itemId: item.id,\n                } satisfies OpenAIResponsesToolCallMetadata,\n              }\n              metadata.started = true\n            }\n            const rawArgs =\n              typeof item.arguments === 'string' && item.arguments.length > 0\n                ? item.arguments\n                : metadata.pendingArguments\n            if (metadata.started && !metadata.ended) {\n              const name = metadata.name || ''\n              let parsedInput: unknown = {}\n              if (rawArgs) {\n                try {\n                  const parsed = JSON.parse(rawArgs)\n                  parsedInput =\n                    parsed && typeof parsed === 'object' ? parsed : {}\n                } catch (parseError) {\n                  options.logger.errors(\n                    `${this.name}.processStreamChunks tool-args JSON parse failed (response.completed backfill)`,\n                    {\n                      error: toRunErrorPayload(\n                        parseError,\n                        `tool ${name} (${metadata.callId}) returned malformed JSON arguments`,\n                      ),\n                      source: `${this.name}.processStreamChunks`,\n                      toolCallId: metadata.callId,\n                      itemId: item.id,\n                      toolName: name,\n                      rawArguments: rawArgs,\n                    },\n                  )\n                  parsedInput = {}\n                }\n              }\n              yield {\n                type: EventType.TOOL_CALL_END,\n                toolCallId: metadata.callId,\n                toolCallName: name,\n                toolName: name,\n                model: model || options.model,\n                timestamp: Date.now(),\n                input: parsedInput,\n              }\n              metadata.ended = true\n              metadata.pendingArguments = undefined\n            }\n          }\n\n          // Emit TEXT_MESSAGE_END if we had text content\n          if (hasEmittedTextMessageStart) {\n            yield {\n              type: EventType.TEXT_MESSAGE_END,\n              messageId: aguiState.messageId,\n              model: model || options.model,\n              timestamp: Date.now(),\n            }\n            hasEmittedTextMessageStart = false\n          }\n\n          // Determine finish reason. Function-call output → tool_calls.\n          // Otherwise surface incomplete_details.reason when present so\n          // callers can distinguish length-limit / content-filter cutoffs\n          // from a clean stop, mirroring the chat-completions adapter.\n          // The Responses API's incomplete_details.reason ('max_output_tokens'\n          // | 'content_filter') maps to the AG-UI finishReason vocabulary:\n          // max_output_tokens → 'length', content_filter → 'content_filter'.\n          const hasFunctionCalls = chunk.response.output.some(\n            (item: unknown) =>\n              (item as { type: string }).type === 'function_call',\n          )\n          const incompleteReason = chunk.response.incomplete_details?.reason\n          const finishReason:\n            | 'tool_calls'\n            | 'length'\n            | 'content_filter'\n            | 'stop' = hasFunctionCalls\n            ? 'tool_calls'\n            : incompleteReason === 'max_output_tokens'\n              ? 'length'\n              : incompleteReason === 'content_filter'\n                ? 'content_filter'\n                : 'stop'\n\n          yield {\n            type: EventType.RUN_FINISHED,\n            runId: aguiState.runId,\n            threadId: aguiState.threadId,\n            model: model || options.model,\n            timestamp: Date.now(),\n            // Omit usage entirely when the provider reported none rather than\n            // emitting fabricated zeros (also satisfies exactOptionalPropertyTypes).\n            ...(chunk.response.usage && {\n              usage: buildResponsesUsage(chunk.response.usage),\n            }),\n            finishReason,\n          }\n          runFinishedEmitted = true\n        }\n\n        if (chunk.type === 'error') {\n          // Conditional `code` spread keeps the wire shape spec-compliant\n          // under `exactOptionalPropertyTypes` (see chatStream catch).\n          const code = chunk.code ?? undefined\n          yield {\n            type: EventType.RUN_ERROR,\n            model: model || options.model,\n            timestamp: Date.now(),\n            message: chunk.message,\n            ...(code !== undefined && { code }),\n            error: {\n              message: chunk.message,\n              ...(code !== undefined && { code }),\n            },\n          }\n          // RUN_ERROR is terminal — don't let the synthetic RUN_FINISHED\n          // block fire after a top-level stream error event, and stop\n          // processing further chunks so no in-flight lifecycle events\n          // (TEXT_MESSAGE_CONTENT, TOOL_CALL_*) leak past the terminal\n          // error. Mirrors the `response.failed` / `response.incomplete`\n          // branches above which return after their RUN_ERROR emission.\n          runFinishedEmitted = true\n          return\n        }\n      }\n\n      // Synthetic terminal RUN_FINISHED if the stream ended without a\n      // response.completed event (e.g. truncated upstream connection). This\n      // mirrors the chat-completions adapter's behavior so consumers always\n      // see a terminal event for every started run.\n      if (!runFinishedEmitted && aguiState.hasEmittedRunStarted) {\n        if (hasEmittedTextMessageStart) {\n          yield {\n            type: EventType.TEXT_MESSAGE_END,\n            messageId: aguiState.messageId,\n            model: model || options.model,\n            timestamp: Date.now(),\n          }\n        }\n        // Omit `usage` entirely (vs `usage: undefined`) — the synthetic\n        // RUN_FINISHED for truncated streams has no usage data, and AG-UI's\n        // `RunFinishedEvent.usage` is optional without `| undefined` under\n        // `exactOptionalPropertyTypes`.\n        yield {\n          type: EventType.RUN_FINISHED,\n          runId: aguiState.runId,\n          threadId: aguiState.threadId,\n          model: model || options.model,\n          timestamp: Date.now(),\n          finishReason: toolCallMetadata.size > 0 ? 'tool_calls' : 'stop',\n        }\n      }\n    } catch (error: unknown) {\n      // Narrow before logging: raw SDK errors can carry request metadata\n      // (including auth headers) which we must never surface to user loggers.\n      const errorPayload = toRunErrorPayload(\n        error,\n        `${this.name}.processStreamChunks failed`,\n      )\n      const rawEvent = toRunErrorRawEvent(error)\n      options.logger.errors(`${this.name}.processStreamChunks fatal`, {\n        error: errorPayload,\n        source: `${this.name}.processStreamChunks`,\n      })\n      // Emit AG-UI RUN_ERROR with conditional `code` spread (see chatStream\n      // catch for the rationale). `rawEvent` carries the provider's structured\n      // error body when present.\n      yield {\n        type: EventType.RUN_ERROR,\n        model: options.model,\n        timestamp: Date.now(),\n        message: errorPayload.message,\n        ...(errorPayload.code !== undefined && { code: errorPayload.code }),\n        ...(rawEvent !== undefined && { rawEvent }),\n        error: {\n          message: errorPayload.message,\n          ...(errorPayload.code !== undefined && { code: errorPayload.code }),\n        },\n      }\n    }\n  }\n\n  /**\n   * Maps common TextOptions to Responses API request format.\n   * Override this in subclasses to add provider-specific options.\n   */\n  protected mapOptionsToRequest(\n    options: TextOptions<TProviderOptions>,\n  ): Omit<ResponseCreateParams, 'stream'> {\n    const input = this.convertMessagesToInput(options.messages)\n\n    const tools = options.tools\n      ? convertToolsToResponsesFormat(\n          options.tools,\n          this.makeStructuredOutputCompatible.bind(this),\n        )\n      : undefined\n\n    const modelOptions = options.modelOptions\n\n    // Native combined mode (issue #605): when the engine threads\n    // `outputSchema` through TextOptions, the adapter declared\n    // `supportsCombinedToolsAndSchema` and the schema is already JSON Schema\n    // (pre-converted at the activity boundary). Wire it into `text.format`\n    // alongside any `tools` — the Responses API supports both together and\n    // emits the schema-constrained text on the natural final turn.\n    const combinedSchema = options.outputSchema as\n      | Record<string, unknown>\n      | undefined\n    const textFormat = combinedSchema\n      ? {\n          text: {\n            format: {\n              type: 'json_schema' as const,\n              name: 'structured_output',\n              schema: this.makeStructuredOutputCompatible(\n                combinedSchema,\n                Array.isArray(combinedSchema.required)\n                  ? (combinedSchema.required as Array<string>)\n                  : undefined,\n              ),\n              strict: true,\n            },\n          },\n        }\n      : undefined\n\n    // `modelOptions` is the sole sampling surface: `temperature`, `top_p`, and\n    // `max_output_tokens` live there (typed via OpenAISamplingOptions) and are\n    // spread first. Engine-managed fields (`model`, `metadata`, `instructions`,\n    // `input`, `tools`, `textFormat`) are layered on top afterward so they\n    // always win over any same-named key a caller happened to put in\n    // `modelOptions`.\n    return {\n      ...modelOptions,\n      model: options.model,\n      ...(options.metadata !== undefined && { metadata: options.metadata }),\n      ...(() => {\n        const prompts = normalizeSystemPrompts(options.systemPrompts)\n        if (prompts.length === 0) return {}\n        return { instructions: prompts.map((p) => p.content).join('\\n') }\n      })(),\n      input,\n      // Conditional spread: `tools: undefined` would clobber any\n      // modelOptions.tools the caller set above.\n      ...(tools && tools.length > 0 && { tools }),\n      ...(textFormat ?? {}),\n    }\n  }\n\n  /**\n   * The OpenAI Responses API supports `tools` and `text.format: json_schema`\n   * together in a single streaming request (per issue #605). Subclasses\n   * that route to providers without this capability should override.\n   */\n  supportsCombinedToolsAndSchema(): boolean {\n    return true\n  }\n\n  /**\n   * Converts ModelMessage[] to Responses API ResponseInput format.\n   * Override this in subclasses for provider-specific message format quirks.\n   *\n   * Key differences from Chat Completions:\n   * - Tool results use `function_call_output` type (not `tool` role)\n   * - Assistant tool calls are `function_call` objects (not nested in `tool_calls`)\n   * - User content uses `input_text`, `input_image`, `input_file` types\n   * - System prompts go in `instructions`, not as messages\n   */\n  protected convertMessagesToInput(\n    messages: Array<ModelMessage>,\n  ): ResponseInput {\n    const result: ResponseInput = []\n\n    for (const message of messages) {\n      // Handle tool messages - convert to FunctionToolCallOutput\n      if (message.role === 'tool') {\n        const toolContent = message.content\n        const output: string | Array<ResponseFunctionCallOutputItem> =\n          Array.isArray(toolContent)\n            ? toolContent.map((part) => this.convertContentPartToInput(part))\n            : typeof toolContent === 'string'\n              ? toolContent\n              : JSON.stringify(toolContent)\n        result.push({\n          type: 'function_call_output',\n          call_id: message.toolCallId || '',\n          output,\n        })\n        continue\n      }\n\n      // Handle assistant messages\n      if (message.role === 'assistant') {\n        // If the assistant message has tool calls, add them as FunctionToolCall objects\n        // Responses API expects arguments as a string (JSON string)\n        if (message.toolCalls && message.toolCalls.length > 0) {\n          for (const toolCall of message.toolCalls) {\n            // Keep arguments as string for Responses API\n            const argumentsString =\n              typeof toolCall.function.arguments === 'string'\n                ? toolCall.function.arguments\n                : JSON.stringify(toolCall.function.arguments)\n            const itemId = (\n              toolCall.metadata as OpenAIResponsesToolCallMetadata | undefined\n            )?.itemId\n\n            result.push({\n              type: 'function_call',\n              call_id: toolCall.id,\n              ...(itemId && { id: itemId }),\n              name: toolCall.function.name,\n              arguments: argumentsString,\n            })\n          }\n        }\n\n        // Add the assistant's text message if there is content\n        if (message.content) {\n          const contentStr = this.extractTextContent(message.content)\n          if (contentStr) {\n            result.push({\n              type: 'message',\n              role: 'assistant',\n              content: contentStr,\n            })\n          }\n        }\n\n        continue\n      }\n\n      // Handle user messages (default case) — support multimodal content\n      const contentParts = this.normalizeContent(message.content)\n      const inputContent: Array<ResponseInputContent> = []\n\n      for (const part of contentParts) {\n        inputContent.push(this.convertContentPartToInput(part))\n      }\n\n      if (inputContent.length === 0) {\n        // Fail loud rather than silently sending an empty user message —\n        // mirrors the chat-completions adapter, where a paid-but-empty\n        // request would mask the real intent (caller passed `null` content\n        // or a normalize step dropped everything).\n        throw new Error(\n          `User message for ${this.name} has no content parts. ` +\n            `Empty user messages would produce a paid request with no input; ` +\n            `provide at least one text/image/audio part or omit the message.`,\n        )\n      }\n\n      result.push({\n        type: 'message',\n        role: 'user',\n        content: inputContent,\n      })\n    }\n\n    return result\n  }\n\n  /**\n   * Converts a ContentPart to Responses API input content item.\n   * Handles text, image, and audio content parts.\n   * Override this in subclasses for additional content types or provider-specific metadata.\n   */\n  protected convertContentPartToInput(part: ContentPart): ResponseInputContent {\n    switch (part.type) {\n      case 'text':\n        return {\n          type: 'input_text',\n          text: part.content,\n        }\n      case 'image': {\n        const imageMetadata = part.metadata as\n          | { detail?: 'auto' | 'low' | 'high' }\n          | undefined\n        if (part.source.type === 'url') {\n          return {\n            type: 'input_image',\n            image_url: part.source.value,\n            detail: imageMetadata?.detail || 'auto',\n          }\n        }\n        // For base64 data, construct a data URI using the mimeType from\n        // source. Default to a generic octet-stream MIME if the source\n        // didn't supply one — letting `undefined` interpolate would produce\n        // an invalid URI like \"data:undefined;base64,...\".\n        const imageValue = part.source.value\n        const imageMime = part.source.mimeType || 'application/octet-stream'\n        const imageUrl = imageValue.startsWith('data:')\n          ? imageValue\n          : `data:${imageMime};base64,${imageValue}`\n        return {\n          type: 'input_image',\n          image_url: imageUrl,\n          detail: imageMetadata?.detail || 'auto',\n        }\n      }\n      case 'audio': {\n        if (part.source.type === 'url') {\n          return {\n            type: 'input_file',\n            file_url: part.source.value,\n          }\n        }\n        // Wrap raw base64 in a data URL — `input_file` rejects bare base64\n        // payloads (matches the image branch above which already does this).\n        // Default the MIME if missing so we never interpolate `undefined`.\n        const audioValue = part.source.value\n        const audioMime = part.source.mimeType || 'application/octet-stream'\n        const audioFileData = audioValue.startsWith('data:')\n          ? audioValue\n          : `data:${audioMime};base64,${audioValue}`\n        return {\n          type: 'input_file',\n          file_data: audioFileData,\n        }\n      }\n\n      case 'video':\n      case 'document':\n      default:\n        // OpenAI Responses API doesn't accept native video/document parts on\n        // this path — surface as explicit unsupported error so callers see\n        // the same message regardless of which content type leaked through.\n        throw new Error(`Unsupported content part type: ${part.type}`)\n    }\n  }\n\n  /**\n   * Normalizes message content to an array of ContentPart.\n   * Handles backward compatibility with string content.\n   */\n  protected normalizeContent(\n    content: string | null | Array<ContentPart>,\n  ): Array<ContentPart> {\n    if (content === null) {\n      return []\n    }\n    if (typeof content === 'string') {\n      return [{ type: 'text', content: content }]\n    }\n    return content\n  }\n\n  /**\n   * Extracts text content from a content value that may be string, null, or ContentPart array.\n   */\n  protected extractTextContent(\n    content: string | null | Array<ContentPart>,\n  ): string {\n    if (content === null) {\n      return ''\n    }\n    if (typeof content === 'string') {\n      return content\n    }\n    // It's an array of ContentPart\n    return content\n      .filter((p) => p.type === 'text')\n      .map((p) => p.content)\n      .join('')\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"responses-text.js","names":[],"sources":["../../../src/adapters/responses-text.ts"],"sourcesContent":["import { EventType, normalizeSystemPrompts } from '@tanstack/ai'\nimport { BaseTextAdapter } from '@tanstack/ai/adapters'\nimport {\n  toRunErrorPayload,\n  toRunErrorRawEvent,\n} from '@tanstack/ai/adapter-internals'\nimport { generateId } from '@tanstack/ai-utils'\nimport { extractRequestOptions } from '../utils/request-options'\nimport { makeStructuredOutputCompatible } from '../utils/schema-converter'\nimport { buildResponsesUsage } from '../usage'\nimport { convertToolsToResponsesFormat } from './responses-tool-converter'\nimport type OpenAI from 'openai'\nimport type {\n  StructuredOutputOptions,\n  StructuredOutputResult,\n} from '@tanstack/ai/adapters'\nimport type {\n  Response,\n  ResponseCreateParams,\n  ResponseFunctionCallOutputItem,\n  ResponseInput,\n  ResponseInputContent,\n  ResponseStreamEvent,\n} from 'openai/resources/responses/responses'\nimport type {\n  ContentPart,\n  DefaultMessageMetadataByModality,\n  Modality,\n  ModelMessage,\n  StreamChunk,\n  TextOptions,\n} from '@tanstack/ai'\n\n// Base64 encoding of the '%PDF' file header — every PDF payload starts with\n// these bytes, so inline document data must begin with this prefix.\nconst PDF_BASE64_MAGIC = 'JVBERi'\n\n/**\n * Provider-specific metadata that preserves the Responses API output item ID.\n *\n * Responses function calls have two identifiers: `call_id` correlates the\n * function output with the call, while `id` identifies the output item itself.\n * TanStack AI uses `call_id` as the canonical tool-call ID and carries the\n * item ID here so stateless follow-up requests can replay both values.\n */\nexport interface OpenAIResponsesToolCallMetadata {\n  itemId: string\n}\n\ninterface StreamedFunctionCallMetadata {\n  callId: string\n  index: number\n  name: string\n  started: boolean\n  ended?: boolean\n  pendingArguments?: string | undefined\n}\n\n/**\n * Shared implementation of the OpenAI Responses API. Holds the stream-event\n * accumulator + AG-UI lifecycle and calls the OpenAI SDK directly. Subclasses\n * (today: ai-openai) construct an OpenAI client with their provider-specific\n * `baseURL` / headers and pass it in.\n */\nexport abstract class OpenAIBaseResponsesTextAdapter<\n  TModel extends string,\n  TProviderOptions extends Record<string, unknown> = Record<string, unknown>,\n  TInputModalities extends ReadonlyArray<Modality> = ReadonlyArray<Modality>,\n  TMessageMetadata extends DefaultMessageMetadataByModality =\n    DefaultMessageMetadataByModality,\n  TToolCapabilities extends ReadonlyArray<string> = ReadonlyArray<string>,\n> extends BaseTextAdapter<\n  TModel,\n  TProviderOptions,\n  TInputModalities,\n  TMessageMetadata,\n  TToolCapabilities,\n  OpenAIResponsesToolCallMetadata\n> {\n  override readonly kind = 'text' as const\n  readonly name: string\n  protected client: OpenAI\n\n  constructor(model: TModel, name: string, client: OpenAI) {\n    super({}, model)\n    this.name = name\n    this.client = client\n  }\n\n  async *chatStream(\n    options: TextOptions<TProviderOptions>,\n  ): AsyncIterable<StreamChunk> {\n    // Key streamed state by output item ID because argument deltas reference\n    // `item_id`. The state separately retains `call_id`, which is the public\n    // tool-call ID and the correlation key for function_call_output.\n    const toolCallMetadata = new Map<string, StreamedFunctionCallMetadata>()\n\n    // AG-UI lifecycle tracking. Honor a caller-supplied `runId` (as `threadId`\n    // already does) so the emitted RUN_STARTED matches the id the caller keys\n    // durability by — e.g. a summarize run threading the client's runId through\n    // for mid-run reload resumability. Falls back to a generated id.\n    const aguiState = {\n      runId: options.runId ?? generateId(this.name),\n      threadId: options.threadId ?? generateId(this.name),\n      messageId: generateId(this.name),\n      hasEmittedRunStarted: false,\n    }\n\n    try {\n      // mapOptionsToRequest can throw on caller-side validation failures\n      // (empty user content, unsupported parts, webSearchTool() rejection in\n      // the OpenRouter override). Keep it inside the try so those failures\n      // surface as RUN_ERROR events instead of iterator throws.\n      const requestParams = this.mapOptionsToRequest(options)\n      options.logger.request(\n        `activity=chat provider=${this.name} model=${this.model} messages=${options.messages.length} tools=${options.tools?.length ?? 0} stream=true`,\n        { provider: this.name, model: this.model },\n      )\n      const response = await this.client.responses.create(\n        {\n          ...requestParams,\n          stream: true,\n        },\n        extractRequestOptions(options.request),\n      )\n\n      yield* this.processStreamChunks(\n        response,\n        toolCallMetadata,\n        options,\n        aguiState,\n      )\n    } catch (error: unknown) {\n      // Narrow before logging: raw SDK errors can carry request metadata\n      // (including auth headers) which we must never surface to user loggers.\n      const errorPayload = toRunErrorPayload(\n        error,\n        `${this.name}.chatStream failed`,\n      )\n      const rawEvent = toRunErrorRawEvent(error)\n\n      // Emit RUN_STARTED if not yet emitted\n      if (!aguiState.hasEmittedRunStarted) {\n        aguiState.hasEmittedRunStarted = true\n        yield {\n          type: EventType.RUN_STARTED,\n          runId: aguiState.runId,\n          threadId: aguiState.threadId,\n          model: options.model,\n          timestamp: Date.now(),\n          parentRunId: options.parentRunId,\n        }\n      }\n\n      // Emit AG-UI RUN_ERROR. Conditional `code` spread keeps the wire\n      // shape spec-compliant under `exactOptionalPropertyTypes`: AG-UI's\n      // `RunErrorEvent.code` is `string?` (absent vs explicit `undefined`\n      // matter), so we omit the key when there's no code.\n      yield {\n        type: EventType.RUN_ERROR,\n        model: options.model,\n        timestamp: Date.now(),\n        message: errorPayload.message,\n        code: errorPayload.code,\n        // Forward the provider's structured error body when present (see\n        // toRunErrorRawEvent); omitted otherwise.\n        ...(rawEvent !== undefined && { rawEvent }),\n        error: {\n          message: errorPayload.message,\n          code: errorPayload.code,\n        },\n      }\n\n      options.logger.errors(`${this.name}.chatStream fatal`, {\n        error: errorPayload,\n        source: `${this.name}.chatStream`,\n      })\n    }\n  }\n\n  /**\n   * Generate structured output using the provider's native JSON Schema response format.\n   * Uses stream: false to get the complete response in one call.\n   *\n   * OpenAI-compatible Responses APIs have strict requirements for structured output:\n   * - All properties must be in the `required` array\n   * - Optional fields should have null added to their type union\n   * - additionalProperties must be false for all objects\n   *\n   * The outputSchema is already JSON Schema (converted in the ai layer).\n   * We apply provider-specific transformations for structured output compatibility.\n   */\n  async structuredOutput(\n    options: StructuredOutputOptions<TProviderOptions>,\n  ): Promise<StructuredOutputResult<unknown>> {\n    const { chatOptions, outputSchema } = options\n    const requestParams = this.mapOptionsToRequest(chatOptions)\n\n    // Apply provider-specific transformations for structured output compatibility\n    const jsonSchema = this.makeStructuredOutputCompatible(\n      outputSchema,\n      outputSchema.required,\n    )\n\n    try {\n      // Strip streaming-only fields a subclass override of mapOptionsToRequest\n      // might have returned (parallel to chat-completions's structuredOutput\n      // cleanup) — sending stream_options to a non-streaming call is a 4xx.\n      const {\n        stream: _stream,\n        stream_options: _streamOptions,\n        ...cleanParams\n      } = requestParams as Record<string, unknown>\n      void _stream\n      void _streamOptions\n      chatOptions.logger.request(\n        `activity=structuredOutput provider=${this.name} model=${this.model} messages=${chatOptions.messages.length}`,\n        { provider: this.name, model: this.model },\n      )\n      const response = await this.client.responses.create(\n        {\n          ...(cleanParams as Omit<ResponseCreateParams, 'stream'>),\n          stream: false,\n          // Configure structured output via text.format\n          text: {\n            format: {\n              type: 'json_schema',\n              name: 'structured_output',\n              schema: jsonSchema,\n              strict: true,\n            },\n          },\n        },\n        extractRequestOptions(chatOptions.request),\n      )\n\n      // Extract text content from the response. `stream: false` narrows the\n      // SDK return type to `Response`, but the explicit annotation makes\n      // that contract local rather than relying on inference through the\n      // overloaded `client.responses.create` signature.\n      const rawText = this.extractTextFromResponse(response satisfies Response)\n\n      // Fail loud on empty content rather than letting it cascade into a\n      // confusing \"Failed to parse JSON. Content: \" error — the root cause\n      // (the model returned no text content for the structured request) is\n      // then visible in logs. Mirrors the chat-completions sibling.\n      if (rawText.length === 0) {\n        throw new Error(\n          `${this.name}.structuredOutput: response contained no content`,\n        )\n      }\n\n      // Parse the JSON response\n      let parsed: unknown\n      try {\n        parsed = JSON.parse(rawText)\n      } catch {\n        throw new Error(\n          `Failed to parse structured output as JSON. Content: ${rawText.slice(0, 200)}${rawText.length > 200 ? '...' : ''}`,\n        )\n      }\n\n      // Provider-specific post-parse shaping (default passthrough). Null-widening\n      // from strict mode is undone by the engine, not here.\n      const transformed = this.transformStructuredOutput(parsed)\n\n      // Surface usage so non-stream structured paths (and\n      // fallbackStructuredOutputStream) can forward tokens to middleware.\n      const usage = buildResponsesUsage(response.usage)\n      return {\n        data: transformed,\n        rawText,\n        ...(usage && { usage }),\n      }\n    } catch (error: unknown) {\n      // Narrow before logging: raw SDK errors can carry request metadata\n      // (including auth headers) which we must never surface to user loggers.\n      chatOptions.logger.errors(`${this.name}.structuredOutput fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.structuredOutput failed`),\n        source: `${this.name}.structuredOutput`,\n      })\n      throw error\n    }\n  }\n\n  /**\n   * Stream structured output via the Responses API: single request with\n   * `text.format: json_schema` + `stream: true`. Consumes Responses-API\n   * events (`response.output_text.delta`, `response.reasoning_text.delta`,\n   * `response.reasoning_summary_text.delta`, `response.refusal.delta`,\n   * `response.completed`, `response.failed`) and re-emits the standard AG-UI\n   * lifecycle ending with `CUSTOM 'structured-output.complete'`.\n   *\n   * Tools are stripped (structured output is mutually exclusive with tool\n   * calls in this path). Reasoning text is accumulated and surfaced both as\n   * REASONING_* lifecycle events during the stream and on the terminal\n   * CUSTOM event's `value.reasoning`.\n   */\n  async *structuredOutputStream(\n    options: StructuredOutputOptions<TProviderOptions>,\n  ): AsyncIterable<StreamChunk> {\n    const { chatOptions, outputSchema } = options\n    const requestParams = this.mapOptionsToRequest(chatOptions)\n\n    const jsonSchema = this.makeStructuredOutputCompatible(\n      outputSchema,\n      outputSchema.required,\n    )\n\n    const aguiState = {\n      runId: generateId(this.name),\n      threadId: chatOptions.threadId ?? generateId(this.name),\n      messageId: generateId(this.name),\n      hasEmittedRunStarted: false,\n    }\n\n    let accumulatedContent = ''\n    let accumulatedReasoning = ''\n    let hasEmittedTextMessageStart = false\n    let reasoningMessageId: string | undefined\n    let stepId: string | undefined\n    let hasClosedReasoning = false\n    let model: string = chatOptions.model\n    let usage: OpenAI.Responses.Response['usage'] | undefined\n\n    const closeReasoning = function* (this: {\n      name: string\n    }): Generator<StreamChunk> {\n      if (reasoningMessageId && !hasClosedReasoning) {\n        hasClosedReasoning = true\n        yield {\n          type: EventType.REASONING_MESSAGE_END,\n          messageId: reasoningMessageId,\n          model,\n          timestamp: Date.now(),\n        }\n        yield {\n          type: EventType.REASONING_END,\n          messageId: reasoningMessageId,\n          model,\n          timestamp: Date.now(),\n        }\n        if (stepId) {\n          yield {\n            type: EventType.STEP_FINISHED,\n            stepName: stepId,\n            stepId,\n            model,\n            timestamp: Date.now(),\n            content: accumulatedReasoning,\n          }\n        }\n      }\n    }.bind(this)\n\n    const openReasoning = function* (this: {\n      name: string\n    }): Generator<StreamChunk> {\n      if (reasoningMessageId) return\n      reasoningMessageId = generateId(this.name)\n      stepId = generateId(this.name)\n      yield {\n        type: EventType.REASONING_START,\n        messageId: reasoningMessageId,\n        model,\n        timestamp: Date.now(),\n      }\n      yield {\n        type: EventType.REASONING_MESSAGE_START,\n        messageId: reasoningMessageId,\n        role: 'reasoning' as const,\n        model,\n        timestamp: Date.now(),\n      }\n      yield {\n        type: EventType.STEP_STARTED,\n        stepName: stepId,\n        stepId,\n        model,\n        timestamp: Date.now(),\n        stepType: 'thinking',\n      }\n    }.bind(this)\n\n    try {\n      const { tools: _tools, ...cleanParams } = requestParams\n      void _tools\n\n      chatOptions.logger.request(\n        `activity=structuredOutputStream provider=${this.name} model=${this.model} messages=${chatOptions.messages.length}`,\n        { provider: this.name, model: this.model },\n      )\n\n      const stream = await this.client.responses.create(\n        {\n          ...cleanParams,\n          stream: true,\n          text: {\n            format: {\n              type: 'json_schema',\n              name: 'structured_output',\n              schema: jsonSchema,\n              strict: true,\n            },\n          },\n        },\n        extractRequestOptions(chatOptions.request),\n      )\n\n      for await (const chunk of stream) {\n        chatOptions.logger.provider(\n          `provider=${this.name} type=${chunk.type}`,\n          { provider: this.name, type: chunk.type },\n        )\n\n        if (!aguiState.hasEmittedRunStarted) {\n          aguiState.hasEmittedRunStarted = true\n          yield {\n            type: EventType.RUN_STARTED,\n            runId: aguiState.runId,\n            threadId: aguiState.threadId,\n            model,\n            timestamp: Date.now(),\n            parentRunId: chatOptions.parentRunId,\n          }\n        }\n\n        if (\n          chunk.type === 'response.created' ||\n          chunk.type === 'response.in_progress'\n        ) {\n          const responseModel = (chunk as { response?: { model?: string } })\n            .response?.model\n          if (responseModel) model = responseModel\n          continue\n        }\n\n        if (chunk.type === 'response.refusal.delta') {\n          const delta =\n            typeof (chunk as { delta?: unknown }).delta === 'string'\n              ? (chunk as { delta: string }).delta\n              : ''\n          yield {\n            type: EventType.RUN_ERROR,\n            runId: aguiState.runId,\n            model,\n            timestamp: Date.now(),\n            message: `Model refused: ${delta}`,\n            code: 'refusal',\n            error: { message: `Model refused: ${delta}`, code: 'refusal' },\n          }\n          return\n        }\n\n        if (\n          chunk.type === 'response.reasoning_text.delta' ||\n          chunk.type === 'response.reasoning_summary_text.delta'\n        ) {\n          const raw = (chunk as { delta?: unknown }).delta\n          const reasoningDelta = Array.isArray(raw)\n            ? raw.join('')\n            : typeof raw === 'string'\n              ? raw\n              : ''\n          if (!reasoningDelta) continue\n          yield* openReasoning()\n          // openReasoning() guarantees reasoningMessageId is set on first call;\n          // TS can't see through the generator side-effect.\n          if (!reasoningMessageId) continue\n          accumulatedReasoning += reasoningDelta\n          yield {\n            type: EventType.REASONING_MESSAGE_CONTENT,\n            messageId: reasoningMessageId,\n            delta: reasoningDelta,\n            model,\n            timestamp: Date.now(),\n          }\n          continue\n        }\n\n        if (chunk.type === 'response.output_text.delta') {\n          const raw = (chunk as { delta?: unknown }).delta\n          const textDelta = Array.isArray(raw)\n            ? raw.join('')\n            : typeof raw === 'string'\n              ? raw\n              : ''\n          if (!textDelta) continue\n\n          yield* closeReasoning()\n\n          if (!hasEmittedTextMessageStart) {\n            hasEmittedTextMessageStart = true\n            yield {\n              type: EventType.TEXT_MESSAGE_START,\n              messageId: aguiState.messageId,\n              model,\n              timestamp: Date.now(),\n              role: 'assistant',\n            }\n          }\n          accumulatedContent += textDelta\n          yield {\n            type: EventType.TEXT_MESSAGE_CONTENT,\n            messageId: aguiState.messageId,\n            model,\n            timestamp: Date.now(),\n            delta: textDelta,\n            content: accumulatedContent,\n          }\n          continue\n        }\n\n        if (chunk.type === 'response.completed') {\n          const response = chunk.response\n          if (response.usage) usage = response.usage\n          if (response.model) model = response.model\n          continue\n        }\n\n        if (chunk.type === 'response.failed') {\n          const response = (\n            chunk as {\n              response?: { error?: { message?: string; code?: string } }\n            }\n          ).response\n          const message =\n            response?.error?.message || 'Responses API stream failed'\n          const code = response?.error?.code\n          // Conditional `code` spread keeps the wire shape spec-compliant\n          // under `exactOptionalPropertyTypes` (see chatStream catch).\n          yield {\n            type: EventType.RUN_ERROR,\n            runId: aguiState.runId,\n            model,\n            timestamp: Date.now(),\n            message,\n            ...(code !== undefined && { code }),\n            error: { message, ...(code !== undefined && { code }) },\n          }\n          return\n        }\n      }\n\n      yield* closeReasoning()\n\n      if (hasEmittedTextMessageStart) {\n        yield {\n          type: EventType.TEXT_MESSAGE_END,\n          messageId: aguiState.messageId,\n          model,\n          timestamp: Date.now(),\n        }\n      }\n\n      if (accumulatedContent.length === 0) {\n        yield {\n          type: EventType.RUN_ERROR,\n          runId: aguiState.runId,\n          model,\n          timestamp: Date.now(),\n          message: `${this.name}.structuredOutputStream: response contained no content`,\n          code: 'empty-response',\n          error: {\n            message: `${this.name}.structuredOutputStream: response contained no content`,\n            code: 'empty-response',\n          },\n        }\n        return\n      }\n\n      let parsed: unknown\n      try {\n        parsed = JSON.parse(accumulatedContent)\n      } catch {\n        yield {\n          type: EventType.RUN_ERROR,\n          runId: aguiState.runId,\n          model,\n          timestamp: Date.now(),\n          message: `Failed to parse structured output as JSON. Content: ${accumulatedContent.slice(0, 200)}${accumulatedContent.length > 200 ? '...' : ''}`,\n          code: 'parse-error',\n          error: {\n            message: 'Failed to parse structured output as JSON',\n            code: 'parse-error',\n          },\n        }\n        return\n      }\n\n      // Route through the same hook as the non-streaming path (default\n      // passthrough). Engine un-widens nulls; the streaming path must not strip\n      // them blindly either.\n      const transformed = this.transformStructuredOutput(parsed)\n\n      yield {\n        type: EventType.CUSTOM,\n        name: 'structured-output.complete',\n        value: {\n          object: transformed,\n          raw: accumulatedContent,\n          ...(accumulatedReasoning ? { reasoning: accumulatedReasoning } : {}),\n        },\n        model,\n        timestamp: Date.now(),\n      }\n\n      yield {\n        type: EventType.RUN_FINISHED,\n        runId: aguiState.runId,\n        threadId: aguiState.threadId,\n        model,\n        timestamp: Date.now(),\n        finishReason: 'stop',\n        ...(usage && {\n          usage: buildResponsesUsage(usage),\n        }),\n      }\n    } catch (error: unknown) {\n      if (!aguiState.hasEmittedRunStarted) {\n        aguiState.hasEmittedRunStarted = true\n        yield {\n          type: EventType.RUN_STARTED,\n          runId: aguiState.runId,\n          threadId: aguiState.threadId,\n          model,\n          timestamp: Date.now(),\n          parentRunId: chatOptions.parentRunId,\n        }\n      }\n\n      const isAbort = this.isAbortError(error)\n      const errorPayload = toRunErrorPayload(\n        error,\n        `${this.name}.structuredOutputStream failed`,\n      )\n\n      // Conditional `code` spread keeps the wire shape spec-compliant under\n      // `exactOptionalPropertyTypes` (see chatStream catch).\n      const resolvedCode = isAbort ? 'aborted' : errorPayload.code\n      const rawEvent = isAbort ? undefined : toRunErrorRawEvent(error)\n      yield {\n        type: EventType.RUN_ERROR,\n        runId: aguiState.runId,\n        model,\n        timestamp: Date.now(),\n        message: errorPayload.message,\n        ...(resolvedCode !== undefined && { code: resolvedCode }),\n        ...(rawEvent !== undefined && { rawEvent }),\n        error: {\n          message: errorPayload.message,\n          ...(resolvedCode !== undefined && { code: resolvedCode }),\n        },\n      }\n\n      chatOptions.logger.errors(`${this.name}.structuredOutputStream fatal`, {\n        error: errorPayload,\n        source: `${this.name}.structuredOutputStream`,\n      })\n    }\n  }\n\n  /**\n   * Cross-SDK abort detection for `structuredOutputStream`. Mirrors the\n   * Chat Completions base; subclasses with proprietary error types override.\n   */\n  protected isAbortError(error: unknown): boolean {\n    if (!error || typeof error !== 'object') return false\n    const e = error as { name?: unknown; code?: unknown }\n    return (\n      e.name === 'APIUserAbortError' ||\n      e.name === 'AbortError' ||\n      e.code === 'ERR_CANCELED'\n    )\n  }\n\n  /**\n   * Applies provider-specific transformations for structured output compatibility.\n   * Override this in subclasses to handle provider-specific quirks.\n   */\n  protected makeStructuredOutputCompatible(\n    schema: Record<string, any>,\n    originalRequired?: Array<string>,\n  ): Record<string, any> {\n    return makeStructuredOutputCompatible(schema, originalRequired)\n  }\n\n  /**\n   * Final shaping pass applied to parsed structured-output JSON before it is\n   * returned to the caller. Default is a passthrough.\n   *\n   * Provider `null`s are no longer stripped here: strict-mode null-widening is\n   * now undone precisely by the engine (`undoNullWidening`, driven by the\n   * schema's null-widening map) the moment the result is captured, so a blind\n   * `transformNullsToUndefined` at the adapter would only destroy genuine\n   * `.nullable()` nulls. Subclasses may still override to remap or reshape the\n   * provider's structured output.\n   */\n  protected transformStructuredOutput(parsed: unknown): unknown {\n    return parsed\n  }\n\n  /**\n   * Extract text content from a non-streaming Responses API response.\n   * Override this in subclasses for provider-specific response shapes.\n   */\n  protected extractTextFromResponse(response: Response): string {\n    let textContent = ''\n    let refusal: string | undefined\n    let sawMessageItem = false\n    const observedItemTypes = new Set<string>()\n\n    for (const item of response.output) {\n      observedItemTypes.add(item.type)\n      if (item.type === 'message') {\n        sawMessageItem = true\n        for (const part of item.content) {\n          // Cast off the discriminated union before the type discrimination\n          // so future SDK variants (e.g. `output_audio`, `output_image`) hit\n          // the explicit error path rather than being misreported as refusals\n          // when they get added to the union. Mirrors the streaming side's\n          // handleContentPart.\n          const partType = (part as { type: string }).type\n          if (partType === 'output_text') {\n            textContent += (part as { text?: string }).text ?? ''\n          } else if (partType === 'refusal') {\n            const refusalText = (part as { refusal?: string }).refusal\n            refusal = refusalText || refusal || 'Refused without explanation'\n          } else {\n            throw new Error(\n              `${this.name}.extractTextFromResponse: unsupported message content part type \"${partType}\"`,\n            )\n          }\n        }\n      }\n    }\n\n    // Surface refusals as an explicit error so callers don't see a generic\n    // \"Failed to parse structured output as JSON. Content: \" when the model\n    // refused for safety / content-policy reasons.\n    if (!textContent && refusal !== undefined) {\n      const err = new Error(`Model refused to respond: ${refusal}`)\n      ;(err as Error & { code?: string }).code = 'refusal'\n      throw err\n    }\n\n    // Response had items but none carried message text (e.g. only\n    // function_call or reasoning items). Surface that explicitly so a\n    // downstream structured-output caller doesn't see a misleading\n    // \"Failed to parse JSON. Content: \" from an empty string.\n    if (!textContent && response.output.length > 0 && !sawMessageItem) {\n      throw new Error(\n        `${this.name}.extractTextFromResponse: response.output contained items of type(s) [${[...observedItemTypes].sort().join(', ')}] but no message text — the model returned a non-text response`,\n      )\n    }\n\n    return textContent\n  }\n\n  /**\n   * Processes streamed chunks from the Responses API and yields AG-UI events.\n   * Override this in subclasses to handle provider-specific stream behavior.\n   *\n   * Handles the following event types:\n   * - response.created / response.incomplete / response.failed\n   * - response.output_text.delta\n   * - response.reasoning_text.delta\n   * - response.reasoning_summary_text.delta\n   * - response.content_part.added / response.content_part.done\n   * - response.output_item.added\n   * - response.function_call_arguments.delta / response.function_call_arguments.done\n   * - response.completed\n   * - error\n   */\n  protected async *processStreamChunks(\n    stream: AsyncIterable<ResponseStreamEvent>,\n    toolCallMetadata: Map<string, StreamedFunctionCallMetadata>,\n    options: TextOptions<TProviderOptions>,\n    aguiState: {\n      runId: string\n      threadId: string\n      messageId: string\n      hasEmittedRunStarted: boolean\n    },\n  ): AsyncIterable<StreamChunk> {\n    let accumulatedContent = ''\n    let accumulatedReasoning = ''\n\n    // Track if we've been streaming deltas to avoid duplicating content from done events\n    let hasStreamedContentDeltas = false\n    let hasStreamedReasoningDeltas = false\n\n    // Preserve response metadata across events\n    let model: string = options.model\n\n    // AG-UI lifecycle tracking\n    let stepId: string | null = null\n    let hasEmittedTextMessageStart = false\n    let hasEmittedStepStarted = false\n    // Track whether we've emitted a terminal RUN_FINISHED so the\n    // end-of-stream fallback below knows to synthesise one when the upstream\n    // cuts off without a response.completed event.\n    let runFinishedEmitted = false\n\n    try {\n      for await (const chunk of stream) {\n        options.logger.provider(`provider=${this.name} type=${chunk.type}`, {\n          provider: this.name,\n          type: chunk.type,\n        })\n\n        // Emit RUN_STARTED on first chunk\n        if (!aguiState.hasEmittedRunStarted) {\n          aguiState.hasEmittedRunStarted = true\n          yield {\n            type: EventType.RUN_STARTED,\n            runId: aguiState.runId,\n            threadId: aguiState.threadId,\n            model: model || options.model,\n            timestamp: Date.now(),\n            parentRunId: options.parentRunId,\n          }\n        }\n\n        const handleContentPart = (contentPart: {\n          type: string\n          text?: string\n          refusal?: string\n        }): StreamChunk => {\n          if (contentPart.type === 'output_text') {\n            accumulatedContent += contentPart.text || ''\n            return {\n              type: EventType.TEXT_MESSAGE_CONTENT,\n              messageId: aguiState.messageId,\n              model: model || options.model,\n              timestamp: Date.now(),\n              delta: contentPart.text || '',\n              content: accumulatedContent,\n            }\n          }\n\n          if (contentPart.type === 'reasoning_text') {\n            accumulatedReasoning += contentPart.text || ''\n            // Cache the fallback stepId rather than generating a fresh one\n            // on every call — otherwise multiple reasoning chunks arriving\n            // before STEP_STARTED was emitted (e.g. via response.content_part.done\n            // alone) would each get a different stepId and break correlation.\n            if (!stepId) {\n              stepId = generateId(this.name)\n            }\n            return {\n              type: EventType.STEP_FINISHED,\n              stepName: stepId,\n              stepId,\n              model: model || options.model,\n              timestamp: Date.now(),\n              delta: contentPart.text || '',\n              content: accumulatedReasoning,\n            }\n          }\n          // Either a real refusal or an unknown content_part type. Surface\n          // the part type in the error so unknown parts are debuggable\n          // instead of being misreported as \"Unknown refusal\".\n          const isRefusal = contentPart.type === 'refusal'\n          const message = isRefusal\n            ? contentPart.refusal || 'Refused without explanation'\n            : `Unsupported response content_part type: ${contentPart.type}`\n          const code = isRefusal ? 'refusal' : contentPart.type\n          return {\n            type: EventType.RUN_ERROR,\n            model: model || options.model,\n            timestamp: Date.now(),\n            message,\n            code,\n            error: { message, code },\n          }\n        }\n\n        // Capture model metadata from any of these events (created starts\n        // the run; failed/incomplete signal terminal failure).\n        if (\n          chunk.type === 'response.created' ||\n          chunk.type === 'response.incomplete' ||\n          chunk.type === 'response.failed'\n        ) {\n          model = chunk.response.model\n        }\n\n        // response.created marks the start of a fresh run — safe to reset\n        // the per-run accumulators here.\n        if (chunk.type === 'response.created') {\n          hasStreamedContentDeltas = false\n          hasStreamedReasoningDeltas = false\n          hasEmittedTextMessageStart = false\n          hasEmittedStepStarted = false\n          accumulatedContent = ''\n          accumulatedReasoning = ''\n        }\n\n        // response.failed and response.incomplete are TERMINAL events for\n        // the current response. Close any open AG-UI message lifecycle FIRST\n        // so consumers tracking start/end pairs don't see an unbalanced\n        // TEXT_MESSAGE_START. Then surface the error and mark the run as\n        // finished so the post-loop synthetic terminal block doesn't emit\n        // a duplicate RUN_FINISHED on top of RUN_ERROR.\n        if (\n          chunk.type === 'response.failed' ||\n          chunk.type === 'response.incomplete'\n        ) {\n          if (hasEmittedTextMessageStart) {\n            yield {\n              type: EventType.TEXT_MESSAGE_END,\n              messageId: aguiState.messageId,\n              model: chunk.response.model,\n              timestamp: Date.now(),\n            }\n            hasEmittedTextMessageStart = false\n          }\n          // Coalesce error + incomplete_details into a single RUN_ERROR\n          // payload — emitting two distinct events for one terminal upstream\n          // event would force consumers to handle a non-existent ordering.\n          const errorMessage =\n            chunk.response.error?.message ||\n            chunk.response.incomplete_details?.reason ||\n            (chunk.type === 'response.failed'\n              ? 'Response failed'\n              : 'Response ended incomplete')\n          const errorCode =\n            chunk.response.error?.code ??\n            (chunk.response.incomplete_details ? 'incomplete' : undefined) ??\n            undefined\n          // Always emit RUN_ERROR for terminal failure events, even when the\n          // upstream omitted both `error` and `incomplete_details`. Skipping\n          // emission on a `response.incomplete` with no detail would let the\n          // post-loop synthetic block silently coerce the run to a clean\n          // `RUN_FINISHED { finishReason: 'stop' }` — masking the failure.\n          yield {\n            type: EventType.RUN_ERROR,\n            model: chunk.response.model,\n            timestamp: Date.now(),\n            message: errorMessage,\n            ...(errorCode !== undefined && { code: errorCode }),\n            error: {\n              message: errorMessage,\n              ...(errorCode !== undefined && { code: errorCode }),\n            },\n          }\n          // RUN_ERROR is the terminal event for this run; stop processing\n          // any further chunks the iterator might still deliver.\n          runFinishedEmitted = true\n          return\n        }\n\n        // Handle output text deltas (token-by-token streaming)\n        // response.output_text.delta provides incremental text updates\n        if (chunk.type === 'response.output_text.delta' && chunk.delta) {\n          // Delta can be an array of strings or a single string\n          const textDelta = Array.isArray(chunk.delta)\n            ? chunk.delta.join('')\n            : typeof chunk.delta === 'string'\n              ? chunk.delta\n              : ''\n\n          if (textDelta) {\n            // Emit TEXT_MESSAGE_START on first text content\n            if (!hasEmittedTextMessageStart) {\n              hasEmittedTextMessageStart = true\n              yield {\n                type: EventType.TEXT_MESSAGE_START,\n                messageId: aguiState.messageId,\n                model: model || options.model,\n                timestamp: Date.now(),\n                role: 'assistant',\n              }\n            }\n\n            accumulatedContent += textDelta\n            hasStreamedContentDeltas = true\n            yield {\n              type: EventType.TEXT_MESSAGE_CONTENT,\n              messageId: aguiState.messageId,\n              model: model || options.model,\n              timestamp: Date.now(),\n              delta: textDelta,\n              content: accumulatedContent,\n            }\n          }\n        }\n\n        // Handle reasoning deltas (token-by-token thinking/reasoning streaming)\n        // response.reasoning_text.delta provides incremental reasoning updates\n        if (chunk.type === 'response.reasoning_text.delta' && chunk.delta) {\n          // Delta can be an array of strings or a single string\n          const reasoningDelta = Array.isArray(chunk.delta)\n            ? chunk.delta.join('')\n            : typeof chunk.delta === 'string'\n              ? chunk.delta\n              : ''\n\n          if (reasoningDelta) {\n            // Emit STEP_STARTED on first reasoning content\n            if (!hasEmittedStepStarted) {\n              hasEmittedStepStarted = true\n              stepId = generateId(this.name)\n              yield {\n                type: EventType.STEP_STARTED,\n                stepName: stepId,\n                stepId,\n                model: model || options.model,\n                timestamp: Date.now(),\n                stepType: 'thinking',\n              }\n            }\n\n            accumulatedReasoning += reasoningDelta\n            hasStreamedReasoningDeltas = true\n            const fallbackStepId = stepId || generateId(this.name)\n            yield {\n              type: EventType.STEP_FINISHED,\n              stepName: fallbackStepId,\n              stepId: fallbackStepId,\n              model: model || options.model,\n              timestamp: Date.now(),\n              delta: reasoningDelta,\n              content: accumulatedReasoning,\n            }\n          }\n        }\n\n        // Handle reasoning summary deltas (when using reasoning.summary option)\n        // response.reasoning_summary_text.delta provides incremental summary updates\n        if (\n          chunk.type === 'response.reasoning_summary_text.delta' &&\n          chunk.delta\n        ) {\n          const summaryDelta =\n            typeof chunk.delta === 'string' ? chunk.delta : ''\n\n          if (summaryDelta) {\n            // Emit STEP_STARTED on first reasoning content\n            if (!hasEmittedStepStarted) {\n              hasEmittedStepStarted = true\n              stepId = generateId(this.name)\n              yield {\n                type: EventType.STEP_STARTED,\n                stepName: stepId,\n                stepId,\n                model: model || options.model,\n                timestamp: Date.now(),\n                stepType: 'thinking',\n              }\n            }\n\n            accumulatedReasoning += summaryDelta\n            hasStreamedReasoningDeltas = true\n            const fallbackStepId = stepId || generateId(this.name)\n            yield {\n              type: EventType.STEP_FINISHED,\n              stepName: fallbackStepId,\n              stepId: fallbackStepId,\n              model: model || options.model,\n              timestamp: Date.now(),\n              delta: summaryDelta,\n              content: accumulatedReasoning,\n            }\n          }\n        }\n\n        // handle content_part added events for text, reasoning and refusals\n        if (chunk.type === 'response.content_part.added') {\n          const contentPart = chunk.part\n          // Emit TEXT_MESSAGE_START if this is text content\n          if (\n            contentPart.type === 'output_text' &&\n            !hasEmittedTextMessageStart\n          ) {\n            hasEmittedTextMessageStart = true\n            yield {\n              type: EventType.TEXT_MESSAGE_START,\n              messageId: aguiState.messageId,\n              model: model || options.model,\n              timestamp: Date.now(),\n              role: 'assistant',\n            }\n          }\n          // Emit STEP_STARTED if this is reasoning content\n          if (contentPart.type === 'reasoning_text' && !hasEmittedStepStarted) {\n            hasEmittedStepStarted = true\n            stepId = generateId(this.name)\n            yield {\n              type: EventType.STEP_STARTED,\n              stepName: stepId,\n              stepId,\n              model: model || options.model,\n              timestamp: Date.now(),\n              stepType: 'thinking',\n            }\n          }\n          // Mark whichever stream we just emitted into so a subsequent\n          // `content_part.done` doesn't duplicate the same text. Without\n          // this flag, an `added` event carrying the full text followed by\n          // a matching `done` event would emit TEXT_MESSAGE_CONTENT twice.\n          if (contentPart.type === 'output_text') {\n            hasStreamedContentDeltas = true\n          } else if (contentPart.type === 'reasoning_text') {\n            hasStreamedReasoningDeltas = true\n          }\n          const partChunk = handleContentPart(contentPart)\n          yield partChunk\n          // handleContentPart returns RUN_ERROR for refusals / unknown\n          // content_part types — those are terminal events. Don't keep\n          // processing more chunks (and don't let the post-loop synthetic\n          // block emit a second terminal event).\n          if (partChunk.type === 'RUN_ERROR') {\n            runFinishedEmitted = true\n            return\n          }\n        }\n\n        if (chunk.type === 'response.content_part.done') {\n          const contentPart = chunk.part\n\n          // Skip emitting chunks for content parts that we've already streamed via deltas\n          // The done event is just a completion marker, not new content\n          if (contentPart.type === 'output_text' && hasStreamedContentDeltas) {\n            // Content already accumulated from deltas, skip\n            continue\n          }\n          if (\n            contentPart.type === 'reasoning_text' &&\n            hasStreamedReasoningDeltas\n          ) {\n            // Reasoning already accumulated from deltas, skip\n            continue\n          }\n\n          // Upstreams that emit `content_part.done` without any preceding\n          // deltas (or `content_part.added`) still need a START event before\n          // CONTENT — otherwise consumers tracking start/end pairs see content\n          // without a start and never see an end. Emit the lifecycle opener\n          // for whichever stream this content_part belongs to before yielding\n          // the CONTENT chunk; the post-loop block emits the matching END.\n          if (\n            contentPart.type === 'output_text' &&\n            !hasEmittedTextMessageStart\n          ) {\n            hasEmittedTextMessageStart = true\n            yield {\n              type: EventType.TEXT_MESSAGE_START,\n              messageId: aguiState.messageId,\n              model: model || options.model,\n              timestamp: Date.now(),\n              role: 'assistant',\n            }\n          } else if (\n            contentPart.type === 'reasoning_text' &&\n            !hasEmittedStepStarted\n          ) {\n            hasEmittedStepStarted = true\n            stepId = generateId(this.name)\n            yield {\n              type: EventType.STEP_STARTED,\n              stepName: stepId,\n              stepId,\n              model: model || options.model,\n              timestamp: Date.now(),\n              stepType: 'thinking',\n            }\n          }\n\n          // Only emit if we haven't been streaming deltas (e.g., for non-streaming responses)\n          const doneChunk = handleContentPart(contentPart)\n          yield doneChunk\n          if (doneChunk.type === 'RUN_ERROR') {\n            runFinishedEmitted = true\n            return\n          }\n        }\n\n        // handle output_item.added to capture function call metadata (name)\n        if (chunk.type === 'response.output_item.added') {\n          const item = chunk.item\n          if (item.type === 'function_call' && item.id) {\n            // Track the item as soon as we see it so subsequent arg deltas\n            // aren't logged as orphans, but only emit TOOL_CALL_START when\n            // both id AND name are populated. Emitting START with an empty\n            // name would propagate into TOOL_CALL_END (which reads the same\n            // metadata) and route the tool call to whatever name happens to\n            // match `''` downstream — a silent misroute.\n            let metadata = toolCallMetadata.get(item.id)\n            if (!metadata) {\n              metadata = {\n                callId: item.call_id || item.id,\n                index: chunk.output_index,\n                name: item.name || '',\n                started: false,\n              }\n              toolCallMetadata.set(item.id, metadata)\n            } else {\n              if (item.call_id) metadata.callId = item.call_id\n              if (!metadata.name && item.name) {\n                // A later output_item.added for the same id finally carries\n                // the name. Update so the gated emission below can fire.\n                metadata.name = item.name\n              }\n            }\n            if (!metadata.started && metadata.name) {\n              yield {\n                type: EventType.TOOL_CALL_START,\n                toolCallId: metadata.callId,\n                toolCallName: metadata.name,\n                toolName: metadata.name,\n                parentMessageId: aguiState.messageId,\n                model: model || options.model,\n                timestamp: Date.now(),\n                index: chunk.output_index,\n                metadata: {\n                  itemId: item.id,\n                } satisfies OpenAIResponsesToolCallMetadata,\n              }\n              metadata.started = true\n            }\n          }\n        }\n\n        // Handle function call arguments delta (streaming). Drop the\n        // previously-emitted `args` field — it had inverted polarity\n        // (populated only when metadata was MISSING, i.e. when the\n        // matching TOOL_CALL_START hadn't fired) and the chat-completions\n        // adapter never emitted it, so it leaked partial deltas as\n        // pseudo-args only on the orphan path. Consumers should accumulate\n        // `delta` themselves.\n        //\n        // Guard with `metadata?.started`: the matching TOOL_CALL_START fires\n        // from `output_item.added`, and emitting TOOL_CALL_ARGS before that\n        // would violate the AG-UI lifecycle (ARGS without START). The .done\n        // handler below applies the same guard.\n        if (\n          chunk.type === 'response.function_call_arguments.delta' &&\n          chunk.delta\n        ) {\n          const metadata = toolCallMetadata.get(chunk.item_id)\n          if (!metadata?.started) {\n            options.logger.errors(\n              `${this.name}.processStreamChunks orphan function_call_arguments.delta`,\n              {\n                source: `${this.name}.processStreamChunks`,\n                // No metadata yet, so the `call_id` is unknown here — only the\n                // output item id the delta referenced.\n                itemId: chunk.item_id,\n                rawDelta: chunk.delta,\n              },\n            )\n            continue\n          }\n          yield {\n            type: EventType.TOOL_CALL_ARGS,\n            toolCallId: metadata.callId,\n            model: model || options.model,\n            timestamp: Date.now(),\n            delta: chunk.delta,\n          }\n        }\n\n        if (chunk.type === 'response.function_call_arguments.done') {\n          const { item_id } = chunk\n\n          // Get the function name from metadata (captured in output_item.added)\n          const metadata = toolCallMetadata.get(item_id)\n          // If the matching START was never emitted (the upstream sent an\n          // `output_item.added` without a name and no later event has filled\n          // it in yet), defer END until `output_item.done` or\n          // `response.completed` can backfill the name. We stash the raw\n          // arguments so the late emission has them. Emitting END without\n          // START would produce an unbalanced AG-UI lifecycle event\n          // downstream consumers can't pair.\n          if (!metadata?.started) {\n            if (metadata) {\n              metadata.pendingArguments = chunk.arguments\n            }\n            options.logger.errors(\n              `${this.name}.processStreamChunks deferring function_call_arguments.done — TOOL_CALL_START not yet emitted (waiting for name)`,\n              {\n                source: `${this.name}.processStreamChunks`,\n                ...(metadata && { toolCallId: metadata.callId }),\n                itemId: item_id,\n                rawArguments: chunk.arguments,\n              },\n            )\n            continue\n          }\n          // The output_item.done backstop may have already emitted END (when\n          // it arrived before args.done with a populated item.arguments).\n          // Skip so we never produce a duplicate close for the same id.\n          if (metadata.ended) continue\n          const name = metadata.name || ''\n          metadata.ended = true\n\n          // Parse arguments. Surface parse failures via the logger so a\n          // model emitting malformed JSON is debuggable instead of silently\n          // invoking the tool with {}.\n          let parsedInput: unknown = {}\n          if (chunk.arguments) {\n            try {\n              const parsed = JSON.parse(chunk.arguments)\n              parsedInput = parsed && typeof parsed === 'object' ? parsed : {}\n            } catch (parseError) {\n              options.logger.errors(\n                `${this.name}.processStreamChunks tool-args JSON parse failed`,\n                {\n                  error: toRunErrorPayload(\n                    parseError,\n                    `tool ${name} (${metadata.callId}) returned malformed JSON arguments`,\n                  ),\n                  source: `${this.name}.processStreamChunks`,\n                  toolCallId: metadata.callId,\n                  itemId: item_id,\n                  toolName: name,\n                  rawArguments: chunk.arguments,\n                },\n              )\n              parsedInput = {}\n            }\n          }\n\n          yield {\n            type: EventType.TOOL_CALL_END,\n            toolCallId: metadata.callId,\n            toolCallName: name,\n            toolName: name,\n            model: model || options.model,\n            timestamp: Date.now(),\n            input: parsedInput,\n          }\n        }\n\n        // `output_item.done` is the last point at which a function_call's\n        // name is guaranteed to be on the wire — it carries the fully-formed\n        // ResponseFunctionToolCall. Use it as a backstop to recover any\n        // tool call whose name was missing from `output_item.added` (and\n        // whose START + END therefore never fired).\n        if (chunk.type === 'response.output_item.done') {\n          const item = chunk.item\n          if (item.type === 'function_call' && item.id) {\n            const metadata = toolCallMetadata.get(item.id) ?? {\n              callId: item.call_id || item.id,\n              index: chunk.output_index,\n              name: item.name || '',\n              started: false,\n            }\n            if (!toolCallMetadata.has(item.id)) {\n              toolCallMetadata.set(item.id, metadata)\n            } else {\n              if (item.call_id) metadata.callId = item.call_id\n              if (!metadata.name && item.name) metadata.name = item.name\n            }\n            // Emit gated START if we now have a name and never started.\n            if (!metadata.started && metadata.name) {\n              yield {\n                type: EventType.TOOL_CALL_START,\n                toolCallId: metadata.callId,\n                toolCallName: metadata.name,\n                toolName: metadata.name,\n                parentMessageId: aguiState.messageId,\n                model: model || options.model,\n                timestamp: Date.now(),\n                index: metadata.index,\n                metadata: {\n                  itemId: item.id,\n                } satisfies OpenAIResponsesToolCallMetadata,\n              }\n              metadata.started = true\n            }\n            // Emit END if we have args (either from a previously-deferred\n            // args.done OR from item.arguments) and haven't already ended.\n            const rawArgs =\n              typeof item.arguments === 'string' && item.arguments.length > 0\n                ? item.arguments\n                : metadata.pendingArguments\n            if (metadata.started && !metadata.ended && rawArgs !== undefined) {\n              const name = metadata.name || ''\n              let parsedInput: unknown = {}\n              if (rawArgs) {\n                try {\n                  const parsed = JSON.parse(rawArgs)\n                  parsedInput =\n                    parsed && typeof parsed === 'object' ? parsed : {}\n                } catch (parseError) {\n                  options.logger.errors(\n                    `${this.name}.processStreamChunks tool-args JSON parse failed (output_item.done backfill)`,\n                    {\n                      error: toRunErrorPayload(\n                        parseError,\n                        `tool ${name} (${metadata.callId}) returned malformed JSON arguments`,\n                      ),\n                      source: `${this.name}.processStreamChunks`,\n                      toolCallId: metadata.callId,\n                      itemId: item.id,\n                      toolName: name,\n                      rawArguments: rawArgs,\n                    },\n                  )\n                  parsedInput = {}\n                }\n              }\n              yield {\n                type: EventType.TOOL_CALL_END,\n                toolCallId: metadata.callId,\n                toolCallName: name,\n                toolName: name,\n                model: model || options.model,\n                timestamp: Date.now(),\n                input: parsedInput,\n              }\n              metadata.ended = true\n              metadata.pendingArguments = undefined\n            }\n          }\n        }\n\n        if (chunk.type === 'response.completed') {\n          // Final backstop for function_call lifecycle: if a function_call\n          // appears in `response.output[]` but was never matched by an\n          // output_item.added/done with a name, recover the missing START\n          // (and END if args were pending). Without this, a tool call could\n          // be silently dropped from the AG-UI stream while `hasFunctionCalls`\n          // below still routes the run's finishReason to 'tool_calls' —\n          // leaving consumers waiting for tool results they never saw start.\n          for (const item of chunk.response.output) {\n            if (item.type !== 'function_call' || !item.id) continue\n            const metadata = toolCallMetadata.get(item.id) ?? {\n              callId: item.call_id || item.id,\n              index: 0,\n              name: item.name || '',\n              started: false,\n            }\n            if (!toolCallMetadata.has(item.id)) {\n              toolCallMetadata.set(item.id, metadata)\n            } else {\n              if (item.call_id) metadata.callId = item.call_id\n              if (!metadata.name && item.name) metadata.name = item.name\n            }\n            if (!metadata.started && metadata.name) {\n              yield {\n                type: EventType.TOOL_CALL_START,\n                toolCallId: metadata.callId,\n                toolCallName: metadata.name,\n                toolName: metadata.name,\n                parentMessageId: aguiState.messageId,\n                model: model || options.model,\n                timestamp: Date.now(),\n                index: metadata.index,\n                metadata: {\n                  itemId: item.id,\n                } satisfies OpenAIResponsesToolCallMetadata,\n              }\n              metadata.started = true\n            }\n            const rawArgs =\n              typeof item.arguments === 'string' && item.arguments.length > 0\n                ? item.arguments\n                : metadata.pendingArguments\n            if (metadata.started && !metadata.ended) {\n              const name = metadata.name || ''\n              let parsedInput: unknown = {}\n              if (rawArgs) {\n                try {\n                  const parsed = JSON.parse(rawArgs)\n                  parsedInput =\n                    parsed && typeof parsed === 'object' ? parsed : {}\n                } catch (parseError) {\n                  options.logger.errors(\n                    `${this.name}.processStreamChunks tool-args JSON parse failed (response.completed backfill)`,\n                    {\n                      error: toRunErrorPayload(\n                        parseError,\n                        `tool ${name} (${metadata.callId}) returned malformed JSON arguments`,\n                      ),\n                      source: `${this.name}.processStreamChunks`,\n                      toolCallId: metadata.callId,\n                      itemId: item.id,\n                      toolName: name,\n                      rawArguments: rawArgs,\n                    },\n                  )\n                  parsedInput = {}\n                }\n              }\n              yield {\n                type: EventType.TOOL_CALL_END,\n                toolCallId: metadata.callId,\n                toolCallName: name,\n                toolName: name,\n                model: model || options.model,\n                timestamp: Date.now(),\n                input: parsedInput,\n              }\n              metadata.ended = true\n              metadata.pendingArguments = undefined\n            }\n          }\n\n          // Emit TEXT_MESSAGE_END if we had text content\n          if (hasEmittedTextMessageStart) {\n            yield {\n              type: EventType.TEXT_MESSAGE_END,\n              messageId: aguiState.messageId,\n              model: model || options.model,\n              timestamp: Date.now(),\n            }\n            hasEmittedTextMessageStart = false\n          }\n\n          // Determine finish reason. Function-call output → tool_calls.\n          // Otherwise surface incomplete_details.reason when present so\n          // callers can distinguish length-limit / content-filter cutoffs\n          // from a clean stop, mirroring the chat-completions adapter.\n          // The Responses API's incomplete_details.reason ('max_output_tokens'\n          // | 'content_filter') maps to the AG-UI finishReason vocabulary:\n          // max_output_tokens → 'length', content_filter → 'content_filter'.\n          const hasFunctionCalls = chunk.response.output.some(\n            (item: unknown) =>\n              (item as { type: string }).type === 'function_call',\n          )\n          const incompleteReason = chunk.response.incomplete_details?.reason\n          const finishReason:\n            | 'tool_calls'\n            | 'length'\n            | 'content_filter'\n            | 'stop' = hasFunctionCalls\n            ? 'tool_calls'\n            : incompleteReason === 'max_output_tokens'\n              ? 'length'\n              : incompleteReason === 'content_filter'\n                ? 'content_filter'\n                : 'stop'\n\n          yield {\n            type: EventType.RUN_FINISHED,\n            runId: aguiState.runId,\n            threadId: aguiState.threadId,\n            model: model || options.model,\n            timestamp: Date.now(),\n            // Omit usage entirely when the provider reported none rather than\n            // emitting fabricated zeros (also satisfies exactOptionalPropertyTypes).\n            ...(chunk.response.usage && {\n              usage: buildResponsesUsage(chunk.response.usage),\n            }),\n            finishReason,\n          }\n          runFinishedEmitted = true\n        }\n\n        if (chunk.type === 'error') {\n          // Conditional `code` spread keeps the wire shape spec-compliant\n          // under `exactOptionalPropertyTypes` (see chatStream catch).\n          const code = chunk.code ?? undefined\n          yield {\n            type: EventType.RUN_ERROR,\n            model: model || options.model,\n            timestamp: Date.now(),\n            message: chunk.message,\n            ...(code !== undefined && { code }),\n            error: {\n              message: chunk.message,\n              ...(code !== undefined && { code }),\n            },\n          }\n          // RUN_ERROR is terminal — don't let the synthetic RUN_FINISHED\n          // block fire after a top-level stream error event, and stop\n          // processing further chunks so no in-flight lifecycle events\n          // (TEXT_MESSAGE_CONTENT, TOOL_CALL_*) leak past the terminal\n          // error. Mirrors the `response.failed` / `response.incomplete`\n          // branches above which return after their RUN_ERROR emission.\n          runFinishedEmitted = true\n          return\n        }\n      }\n\n      // Synthetic terminal RUN_FINISHED if the stream ended without a\n      // response.completed event (e.g. truncated upstream connection). This\n      // mirrors the chat-completions adapter's behavior so consumers always\n      // see a terminal event for every started run.\n      if (!runFinishedEmitted && aguiState.hasEmittedRunStarted) {\n        if (hasEmittedTextMessageStart) {\n          yield {\n            type: EventType.TEXT_MESSAGE_END,\n            messageId: aguiState.messageId,\n            model: model || options.model,\n            timestamp: Date.now(),\n          }\n        }\n        // Omit `usage` entirely (vs `usage: undefined`) — the synthetic\n        // RUN_FINISHED for truncated streams has no usage data, and AG-UI's\n        // `RunFinishedEvent.usage` is optional without `| undefined` under\n        // `exactOptionalPropertyTypes`.\n        yield {\n          type: EventType.RUN_FINISHED,\n          runId: aguiState.runId,\n          threadId: aguiState.threadId,\n          model: model || options.model,\n          timestamp: Date.now(),\n          finishReason: toolCallMetadata.size > 0 ? 'tool_calls' : 'stop',\n        }\n      }\n    } catch (error: unknown) {\n      // Narrow before logging: raw SDK errors can carry request metadata\n      // (including auth headers) which we must never surface to user loggers.\n      const errorPayload = toRunErrorPayload(\n        error,\n        `${this.name}.processStreamChunks failed`,\n      )\n      const rawEvent = toRunErrorRawEvent(error)\n      options.logger.errors(`${this.name}.processStreamChunks fatal`, {\n        error: errorPayload,\n        source: `${this.name}.processStreamChunks`,\n      })\n      // Emit AG-UI RUN_ERROR with conditional `code` spread (see chatStream\n      // catch for the rationale). `rawEvent` carries the provider's structured\n      // error body when present.\n      yield {\n        type: EventType.RUN_ERROR,\n        model: options.model,\n        timestamp: Date.now(),\n        message: errorPayload.message,\n        ...(errorPayload.code !== undefined && { code: errorPayload.code }),\n        ...(rawEvent !== undefined && { rawEvent }),\n        error: {\n          message: errorPayload.message,\n          ...(errorPayload.code !== undefined && { code: errorPayload.code }),\n        },\n      }\n    }\n  }\n\n  /**\n   * Maps common TextOptions to Responses API request format.\n   * Override this in subclasses to add provider-specific options.\n   */\n  protected mapOptionsToRequest(\n    options: TextOptions<TProviderOptions>,\n  ): Omit<ResponseCreateParams, 'stream'> {\n    const input = this.convertMessagesToInput(options.messages)\n\n    const tools = options.tools\n      ? convertToolsToResponsesFormat(\n          options.tools,\n          this.makeStructuredOutputCompatible.bind(this),\n        )\n      : undefined\n\n    const modelOptions = options.modelOptions\n\n    // Native combined mode (issue #605): when the engine threads\n    // `outputSchema` through TextOptions, the adapter declared\n    // `supportsCombinedToolsAndSchema` and the schema is already JSON Schema\n    // (pre-converted at the activity boundary). Wire it into `text.format`\n    // alongside any `tools` — the Responses API supports both together and\n    // emits the schema-constrained text on the natural final turn.\n    const combinedSchema = options.outputSchema as\n      | Record<string, unknown>\n      | undefined\n    const textFormat = combinedSchema\n      ? {\n          text: {\n            format: {\n              type: 'json_schema' as const,\n              name: 'structured_output',\n              schema: this.makeStructuredOutputCompatible(\n                combinedSchema,\n                Array.isArray(combinedSchema.required)\n                  ? (combinedSchema.required as Array<string>)\n                  : undefined,\n              ),\n              strict: true,\n            },\n          },\n        }\n      : undefined\n\n    // `modelOptions` is the sole sampling surface: `temperature`, `top_p`, and\n    // `max_output_tokens` live there (typed via OpenAISamplingOptions) and are\n    // spread first. Engine-managed fields (`model`, `metadata`, `instructions`,\n    // `input`, `tools`, `textFormat`) are layered on top afterward so they\n    // always win over any same-named key a caller happened to put in\n    // `modelOptions`.\n    return {\n      ...modelOptions,\n      model: options.model,\n      ...(options.metadata !== undefined && { metadata: options.metadata }),\n      ...(() => {\n        const prompts = normalizeSystemPrompts(options.systemPrompts)\n        if (prompts.length === 0) return {}\n        return { instructions: prompts.map((p) => p.content).join('\\n') }\n      })(),\n      input,\n      // Conditional spread: `tools: undefined` would clobber any\n      // modelOptions.tools the caller set above.\n      ...(tools && tools.length > 0 && { tools }),\n      ...(textFormat ?? {}),\n    }\n  }\n\n  /**\n   * The OpenAI Responses API supports `tools` and `text.format: json_schema`\n   * together in a single streaming request (per issue #605). Subclasses\n   * that route to providers without this capability should override.\n   */\n  supportsCombinedToolsAndSchema(): boolean {\n    return true\n  }\n\n  /**\n   * Converts ModelMessage[] to Responses API ResponseInput format.\n   * Override this in subclasses for provider-specific message format quirks.\n   *\n   * Key differences from Chat Completions:\n   * - Tool results use `function_call_output` type (not `tool` role)\n   * - Assistant tool calls are `function_call` objects (not nested in `tool_calls`)\n   * - User content uses `input_text`, `input_image`, `input_file` types\n   * - System prompts go in `instructions`, not as messages\n   */\n  protected convertMessagesToInput(\n    messages: Array<ModelMessage>,\n  ): ResponseInput {\n    const result: ResponseInput = []\n\n    for (const message of messages) {\n      // Handle tool messages - convert to FunctionToolCallOutput\n      if (message.role === 'tool') {\n        const toolContent = message.content\n        const output: string | Array<ResponseFunctionCallOutputItem> =\n          Array.isArray(toolContent)\n            ? toolContent.map((part) => this.convertContentPartToInput(part))\n            : typeof toolContent === 'string'\n              ? toolContent\n              : JSON.stringify(toolContent)\n        result.push({\n          type: 'function_call_output',\n          call_id: message.toolCallId || '',\n          output,\n        })\n        continue\n      }\n\n      // Handle assistant messages\n      if (message.role === 'assistant') {\n        // If the assistant message has tool calls, add them as FunctionToolCall objects\n        // Responses API expects arguments as a string (JSON string)\n        if (message.toolCalls && message.toolCalls.length > 0) {\n          for (const toolCall of message.toolCalls) {\n            // Keep arguments as string for Responses API\n            const argumentsString =\n              typeof toolCall.function.arguments === 'string'\n                ? toolCall.function.arguments\n                : JSON.stringify(toolCall.function.arguments)\n            const itemId = (\n              toolCall.metadata as OpenAIResponsesToolCallMetadata | undefined\n            )?.itemId\n\n            result.push({\n              type: 'function_call',\n              call_id: toolCall.id,\n              ...(itemId && { id: itemId }),\n              name: toolCall.function.name,\n              arguments: argumentsString,\n            })\n          }\n        }\n\n        // Add the assistant's text message if there is content\n        if (message.content) {\n          const contentStr = this.extractTextContent(message.content)\n          if (contentStr) {\n            result.push({\n              type: 'message',\n              role: 'assistant',\n              content: contentStr,\n            })\n          }\n        }\n\n        continue\n      }\n\n      // Handle user messages (default case) — support multimodal content\n      const contentParts = this.normalizeContent(message.content)\n      const inputContent: Array<ResponseInputContent> = []\n\n      for (const part of contentParts) {\n        inputContent.push(this.convertContentPartToInput(part))\n      }\n\n      if (inputContent.length === 0) {\n        // Fail loud rather than silently sending an empty user message —\n        // mirrors the chat-completions adapter, where a paid-but-empty\n        // request would mask the real intent (caller passed `null` content\n        // or a normalize step dropped everything).\n        throw new Error(\n          `User message for ${this.name} has no content parts. ` +\n            `Empty user messages would produce a paid request with no input; ` +\n            `provide at least one text/image/audio/document part or omit the message.`,\n        )\n      }\n\n      result.push({\n        type: 'message',\n        role: 'user',\n        content: inputContent,\n      })\n    }\n\n    return result\n  }\n\n  /**\n   * Converts a ContentPart to Responses API input content item.\n   * Handles text, image, audio, and document (PDF) content parts.\n   * Override this in subclasses for additional content types or provider-specific metadata.\n   */\n  protected convertContentPartToInput(part: ContentPart): ResponseInputContent {\n    switch (part.type) {\n      case 'text':\n        return {\n          type: 'input_text',\n          text: part.content,\n        }\n      case 'image': {\n        const imageMetadata = part.metadata as\n          | { detail?: 'auto' | 'low' | 'high' }\n          | undefined\n        if (part.source.type === 'url') {\n          return {\n            type: 'input_image',\n            image_url: part.source.value,\n            detail: imageMetadata?.detail || 'auto',\n          }\n        }\n        // For base64 data, construct a data URI using the mimeType from\n        // source. Default to a generic octet-stream MIME if the source\n        // didn't supply one — letting `undefined` interpolate would produce\n        // an invalid URI like \"data:undefined;base64,...\".\n        const imageValue = part.source.value\n        const imageMime = part.source.mimeType || 'application/octet-stream'\n        const imageUrl = imageValue.startsWith('data:')\n          ? imageValue\n          : `data:${imageMime};base64,${imageValue}`\n        return {\n          type: 'input_image',\n          image_url: imageUrl,\n          detail: imageMetadata?.detail || 'auto',\n        }\n      }\n      case 'audio': {\n        if (part.source.type === 'url') {\n          return {\n            type: 'input_file',\n            file_url: part.source.value,\n          }\n        }\n        // Wrap raw base64 in a data URL — `input_file` rejects bare base64\n        // payloads (matches the image branch above).\n        // Default the MIME if missing so we never interpolate `undefined`.\n        const audioValue = part.source.value\n        const audioMime = part.source.mimeType || 'application/octet-stream'\n        const audioFileData = audioValue.startsWith('data:')\n          ? audioValue\n          : `data:${audioMime};base64,${audioValue}`\n        return {\n          type: 'input_file',\n          file_data: audioFileData,\n        }\n      }\n\n      case 'document': {\n        const documentMetadata = part.metadata as\n          | { filename?: string; detail?: 'auto' | 'low' | 'high' }\n          | undefined\n        // Spread `detail` only when provided so the API applies its own\n        // default ('auto'). The Responses API accepts 'auto' | 'low' | 'high',\n        // but the pinned OpenAI SDK's `ResponseInputFile.detail` type still\n        // lists only 'low' | 'high' — cast so 'auto' (a valid API value) can\n        // pass through without a type error.\n        const documentDetail =\n          documentMetadata?.detail !== undefined\n            ? { detail: documentMetadata.detail as 'low' | 'high' }\n            : {}\n        if (part.source.type === 'url') {\n          // The Responses API fetches the PDF itself; filename and MIME\n          // type are inferred from the response.\n          return {\n            type: 'input_file',\n            file_url: part.source.value,\n            ...documentDetail,\n          }\n        }\n        // This adapter supports only PDF documents; anything else is\n        // rejected. MIME types are case-insensitive and can carry\n        // ;parameters (RFC 2045), so the type is normalized before comparing.\n        const documentValue = part.source.value\n        const documentMime = (\n          (part.source.mimeType || 'application/pdf').split(';')[0] ?? ''\n        )\n          .trim()\n          .toLowerCase()\n        if (documentMime !== 'application/pdf') {\n          throw new Error(\n            `${this.name} document parts only support application/pdf ` +\n              `(received ${documentMime})`,\n          )\n        }\n        // A pre-wrapped data URL carries its own media type — validate it too.\n        if (\n          documentValue.startsWith('data:') &&\n          !/^data:application\\/pdf[;,]/i.test(documentValue)\n        ) {\n          throw new Error(\n            `${this.name} document parts only support application/pdf ` +\n              `(received data URL with non-PDF media type)`,\n          )\n        }\n        // Sniff the payload so a non-PDF labeled (or unlabeled) as PDF is\n        // caught locally instead of by an opaque provider 400. Only base64\n        // payloads are checked; a rare `data:` URL without `;base64` is left\n        // to the server.\n        const documentBase64 = documentValue.startsWith('data:')\n          ? /;base64,/i.test(documentValue)\n            ? documentValue.slice(documentValue.indexOf(',') + 1)\n            : ''\n          : documentValue\n        if (documentBase64 && !documentBase64.startsWith(PDF_BASE64_MAGIC)) {\n          throw new Error(\n            `${this.name} document parts only support application/pdf ` +\n              `(inline data does not start with the %PDF header)`,\n          )\n        }\n        // Wrap raw base64 in a data URL — `input_file` rejects bare base64\n        // payloads (matches the image and audio branches above).\n        const documentFileData = documentValue.startsWith('data:')\n          ? documentValue\n          : `data:${documentMime};base64,${documentValue}`\n        return {\n          type: 'input_file',\n          // The Responses API requires a filename alongside PDF `file_data`.\n          filename: documentMetadata?.filename || 'document.pdf',\n          file_data: documentFileData,\n          ...documentDetail,\n        }\n      }\n\n      case 'video':\n      default:\n        // OpenAI Responses API doesn't accept native video parts on this\n        // path — surface as explicit unsupported error so callers see the\n        // same message regardless of which content type leaked through.\n        throw new Error(`Unsupported content part type: ${part.type}`)\n    }\n  }\n\n  /**\n   * Normalizes message content to an array of ContentPart.\n   * Handles backward compatibility with string content.\n   */\n  protected normalizeContent(\n    content: string | null | Array<ContentPart>,\n  ): Array<ContentPart> {\n    if (content === null) {\n      return []\n    }\n    if (typeof content === 'string') {\n      return [{ type: 'text', content: content }]\n    }\n    return content\n  }\n\n  /**\n   * Extracts text content from a content value that may be string, null, or ContentPart array.\n   */\n  protected extractTextContent(\n    content: string | null | Array<ContentPart>,\n  ): string {\n    if (content === null) {\n      return ''\n    }\n    if (typeof content === 'string') {\n      return content\n    }\n    // It's an array of ContentPart\n    return content\n      .filter((p) => p.type === 'text')\n      .map((p) => p.content)\n      .join('')\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/openai-base",
-  "version": "0.9.15",
+  "version": "0.10.0",
   "description": "Shared OpenAI SDK base adapters for TanStack AI providers using Chat Completions and Responses APIs.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -47,13 +47,13 @@
     "@tanstack/ai-utils": "^0.4.0"
   },
   "peerDependencies": {
-    "@tanstack/ai": "^0.46.0"
+    "@tanstack/ai": "^0.47.1"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.1.10",
     "vite": "^8.2.1",
     "zod": "^4.2.0",
-    "@tanstack/ai": "0.46.0"
+    "@tanstack/ai": "0.47.1"
   },
   "scripts": {
     "build": "vite build",

package/src/adapters/chat-completions-text.ts

@@ -1399,6 +1399,17 @@ export abstract class OpenAIBaseChatCompletionsTextAdapter<
       }
     }
 
+    if (part.type === 'document') {
+      // Documents (PDF) are implemented on the Responses adapter, which maps
+      // them to `input_file`. Model modality arrays are not endpoint-scoped,
+      // so a document part can type-check for a model this adapter serves —
+      // point callers at the supported path instead of a generic error.
+      throw new Error(
+        `${this.name} does not support document parts on the Chat Completions ` +
+          `API; use the Responses adapter, which sends them as input_file.`,
+      )
+    }
+
     // Unsupported content type — subclasses can override to handle more types
     return null
   }

package/src/adapters/responses-text.ts

@@ -31,6 +31,10 @@ import type {
   TextOptions,
 } from '@tanstack/ai'
 
+// Base64 encoding of the '%PDF' file header — every PDF payload starts with
+// these bytes, so inline document data must begin with this prefix.
+const PDF_BASE64_MAGIC = 'JVBERi'
+
 /**
  * Provider-specific metadata that preserves the Responses API output item ID.
  *
@@ -1795,7 +1799,7 @@ export abstract class OpenAIBaseResponsesTextAdapter<
         throw new Error(
           `User message for ${this.name} has no content parts. ` +
             `Empty user messages would produce a paid request with no input; ` +
-            `provide at least one text/image/audio part or omit the message.`,
+            `provide at least one text/image/audio/document part or omit the message.`,
         )
       }
 
@@ -1811,7 +1815,7 @@ export abstract class OpenAIBaseResponsesTextAdapter<
 
   /**
    * Converts a ContentPart to Responses API input content item.
-   * Handles text, image, and audio content parts.
+   * Handles text, image, audio, and document (PDF) content parts.
    * Override this in subclasses for additional content types or provider-specific metadata.
    */
   protected convertContentPartToInput(part: ContentPart): ResponseInputContent {
@@ -1855,7 +1859,7 @@ export abstract class OpenAIBaseResponsesTextAdapter<
           }
         }
         // Wrap raw base64 in a data URL — `input_file` rejects bare base64
-        // payloads (matches the image branch above which already does this).
+        // payloads (matches the image branch above).
         // Default the MIME if missing so we never interpolate `undefined`.
         const audioValue = part.source.value
         const audioMime = part.source.mimeType || 'application/octet-stream'
@@ -1868,12 +1872,87 @@ export abstract class OpenAIBaseResponsesTextAdapter<
         }
       }
 
+      case 'document': {
+        const documentMetadata = part.metadata as
+          | { filename?: string; detail?: 'auto' | 'low' | 'high' }
+          | undefined
+        // Spread `detail` only when provided so the API applies its own
+        // default ('auto'). The Responses API accepts 'auto' | 'low' | 'high',
+        // but the pinned OpenAI SDK's `ResponseInputFile.detail` type still
+        // lists only 'low' | 'high' — cast so 'auto' (a valid API value) can
+        // pass through without a type error.
+        const documentDetail =
+          documentMetadata?.detail !== undefined
+            ? { detail: documentMetadata.detail as 'low' | 'high' }
+            : {}
+        if (part.source.type === 'url') {
+          // The Responses API fetches the PDF itself; filename and MIME
+          // type are inferred from the response.
+          return {
+            type: 'input_file',
+            file_url: part.source.value,
+            ...documentDetail,
+          }
+        }
+        // This adapter supports only PDF documents; anything else is
+        // rejected. MIME types are case-insensitive and can carry
+        // ;parameters (RFC 2045), so the type is normalized before comparing.
+        const documentValue = part.source.value
+        const documentMime = (
+          (part.source.mimeType || 'application/pdf').split(';')[0] ?? ''
+        )
+          .trim()
+          .toLowerCase()
+        if (documentMime !== 'application/pdf') {
+          throw new Error(
+            `${this.name} document parts only support application/pdf ` +
+              `(received ${documentMime})`,
+          )
+        }
+        // A pre-wrapped data URL carries its own media type — validate it too.
+        if (
+          documentValue.startsWith('data:') &&
+          !/^data:application\/pdf[;,]/i.test(documentValue)
+        ) {
+          throw new Error(
+            `${this.name} document parts only support application/pdf ` +
+              `(received data URL with non-PDF media type)`,
+          )
+        }
+        // Sniff the payload so a non-PDF labeled (or unlabeled) as PDF is
+        // caught locally instead of by an opaque provider 400. Only base64
+        // payloads are checked; a rare `data:` URL without `;base64` is left
+        // to the server.
+        const documentBase64 = documentValue.startsWith('data:')
+          ? /;base64,/i.test(documentValue)
+            ? documentValue.slice(documentValue.indexOf(',') + 1)
+            : ''
+          : documentValue
+        if (documentBase64 && !documentBase64.startsWith(PDF_BASE64_MAGIC)) {
+          throw new Error(
+            `${this.name} document parts only support application/pdf ` +
+              `(inline data does not start with the %PDF header)`,
+          )
+        }
+        // Wrap raw base64 in a data URL — `input_file` rejects bare base64
+        // payloads (matches the image and audio branches above).
+        const documentFileData = documentValue.startsWith('data:')
+          ? documentValue
+          : `data:${documentMime};base64,${documentValue}`
+        return {
+          type: 'input_file',
+          // The Responses API requires a filename alongside PDF `file_data`.
+          filename: documentMetadata?.filename || 'document.pdf',
+          file_data: documentFileData,
+          ...documentDetail,
+        }
+      }
+
       case 'video':
-      case 'document':
       default:
-        // OpenAI Responses API doesn't accept native video/document parts on
-        // this path — surface as explicit unsupported error so callers see
-        // the same message regardless of which content type leaked through.
+        // OpenAI Responses API doesn't accept native video parts on this
+        // path — surface as explicit unsupported error so callers see the
+        // same message regardless of which content type leaked through.
         throw new Error(`Unsupported content part type: ${part.type}`)
     }
   }