@tanstack/openai-base 0.9.9 → 0.9.10

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

@@ -1,1324 +1,1176 @@
+import { makeStructuredOutputCompatible } from "../utils/schema-converter.js";
+import { buildResponsesUsage } from "../usage.js";
+import { extractRequestOptions } from "../utils/request-options.js";
+import { convertToolsToResponsesFormat } from "./responses-tool-converter.js";
 import { EventType, normalizeSystemPrompts } from "@tanstack/ai";
 import { BaseTextAdapter } from "@tanstack/ai/adapters";
 import { toRunErrorPayload, toRunErrorRawEvent } from "@tanstack/ai/adapter-internals";
 import { generateId } from "@tanstack/ai-utils";
-import { extractRequestOptions } from "../utils/request-options.js";
-import { makeStructuredOutputCompatible } from "../utils/schema-converter.js";
-import { buildResponsesUsage } from "../usage.js";
-import { convertToolsToResponsesFormat } from "./responses-tool-converter.js";
-class OpenAIBaseResponsesTextAdapter extends BaseTextAdapter {
-  kind = "text";
-  name;
-  client;
-  constructor(model, name, client) {
-    super({}, model);
-    this.name = name;
-    this.client = client;
-  }
-  async *chatStream(options) {
-    const toolCallMetadata = /* @__PURE__ */ new Map();
-    const aguiState = {
-      runId: generateId(this.name),
-      threadId: options.threadId ?? generateId(this.name),
-      messageId: generateId(this.name),
-      hasEmittedRunStarted: false
-    };
-    try {
-      const requestParams = this.mapOptionsToRequest(options);
-      options.logger.request(
-        `activity=chat provider=${this.name} model=${this.model} messages=${options.messages.length} tools=${options.tools?.length ?? 0} stream=true`,
-        { provider: this.name, model: this.model }
-      );
-      const response = await this.client.responses.create(
-        {
-          ...requestParams,
-          stream: true
-        },
-        extractRequestOptions(options.request)
-      );
-      yield* this.processStreamChunks(
-        response,
-        toolCallMetadata,
-        options,
-        aguiState
-      );
-    } catch (error) {
-      const errorPayload = toRunErrorPayload(
-        error,
-        `${this.name}.chatStream failed`
-      );
-      const rawEvent = toRunErrorRawEvent(error);
-      if (!aguiState.hasEmittedRunStarted) {
-        aguiState.hasEmittedRunStarted = true;
-        yield {
-          type: EventType.RUN_STARTED,
-          runId: aguiState.runId,
-          threadId: aguiState.threadId,
-          model: options.model,
-          timestamp: Date.now(),
-          parentRunId: options.parentRunId
-        };
-      }
-      yield {
-        type: EventType.RUN_ERROR,
-        model: options.model,
-        timestamp: Date.now(),
-        message: errorPayload.message,
-        code: errorPayload.code,
-        // Forward the provider's structured error body when present (see
-        // toRunErrorRawEvent); omitted otherwise.
-        ...rawEvent !== void 0 && { rawEvent },
-        error: {
-          message: errorPayload.message,
-          code: errorPayload.code
-        }
-      };
-      options.logger.errors(`${this.name}.chatStream fatal`, {
-        error: errorPayload,
-        source: `${this.name}.chatStream`
-      });
-    }
-  }
-  /**
-   * Generate structured output using the provider's native JSON Schema response format.
-   * Uses stream: false to get the complete response in one call.
-   *
-   * OpenAI-compatible Responses APIs have strict requirements for structured output:
-   * - All properties must be in the `required` array
-   * - Optional fields should have null added to their type union
-   * - additionalProperties must be false for all objects
-   *
-   * The outputSchema is already JSON Schema (converted in the ai layer).
-   * We apply provider-specific transformations for structured output compatibility.
-   */
-  async structuredOutput(options) {
-    const { chatOptions, outputSchema } = options;
-    const requestParams = this.mapOptionsToRequest(chatOptions);
-    const jsonSchema = this.makeStructuredOutputCompatible(
-      outputSchema,
-      outputSchema.required
-    );
-    try {
-      const {
-        stream: _stream,
-        stream_options: _streamOptions,
-        ...cleanParams
-      } = requestParams;
-      void _stream;
-      void _streamOptions;
-      chatOptions.logger.request(
-        `activity=structuredOutput provider=${this.name} model=${this.model} messages=${chatOptions.messages.length}`,
-        { provider: this.name, model: this.model }
-      );
-      const response = await this.client.responses.create(
-        {
-          ...cleanParams,
-          stream: false,
-          // Configure structured output via text.format
-          text: {
-            format: {
-              type: "json_schema",
-              name: "structured_output",
-              schema: jsonSchema,
-              strict: true
-            }
-          }
-        },
-        extractRequestOptions(chatOptions.request)
-      );
-      const rawText = this.extractTextFromResponse(response);
-      if (rawText.length === 0) {
-        throw new Error(
-          `${this.name}.structuredOutput: response contained no content`
-        );
-      }
-      let parsed;
-      try {
-        parsed = JSON.parse(rawText);
-      } catch {
-        throw new Error(
-          `Failed to parse structured output as JSON. Content: ${rawText.slice(0, 200)}${rawText.length > 200 ? "..." : ""}`
-        );
-      }
-      const transformed = this.transformStructuredOutput(parsed);
-      return {
-        data: transformed,
-        rawText
-      };
-    } catch (error) {
-      chatOptions.logger.errors(`${this.name}.structuredOutput fatal`, {
-        error: toRunErrorPayload(error, `${this.name}.structuredOutput failed`),
-        source: `${this.name}.structuredOutput`
-      });
-      throw error;
-    }
-  }
-  /**
-   * Stream structured output via the Responses API: single request with
-   * `text.format: json_schema` + `stream: true`. Consumes Responses-API
-   * events (`response.output_text.delta`, `response.reasoning_text.delta`,
-   * `response.reasoning_summary_text.delta`, `response.refusal.delta`,
-   * `response.completed`, `response.failed`) and re-emits the standard AG-UI
-   * lifecycle ending with `CUSTOM 'structured-output.complete'`.
-   *
-   * Tools are stripped (structured output is mutually exclusive with tool
-   * calls in this path). Reasoning text is accumulated and surfaced both as
-   * REASONING_* lifecycle events during the stream and on the terminal
-   * CUSTOM event's `value.reasoning`.
-   */
-  async *structuredOutputStream(options) {
-    const { chatOptions, outputSchema } = options;
-    const requestParams = this.mapOptionsToRequest(chatOptions);
-    const jsonSchema = this.makeStructuredOutputCompatible(
-      outputSchema,
-      outputSchema.required
-    );
-    const timestamp = Date.now();
-    const aguiState = {
-      runId: generateId(this.name),
-      threadId: chatOptions.threadId ?? generateId(this.name),
-      messageId: generateId(this.name),
-      timestamp,
-      hasEmittedRunStarted: false
-    };
-    let accumulatedContent = "";
-    let accumulatedReasoning = "";
-    let hasEmittedTextMessageStart = false;
-    let reasoningMessageId;
-    let stepId;
-    let hasClosedReasoning = false;
-    let model = chatOptions.model;
-    let usage;
-    const closeReasoning = (function* () {
-      if (reasoningMessageId && !hasClosedReasoning) {
-        hasClosedReasoning = true;
-        yield {
-          type: EventType.REASONING_MESSAGE_END,
-          messageId: reasoningMessageId,
-          model,
-          timestamp
-        };
-        yield {
-          type: EventType.REASONING_END,
-          messageId: reasoningMessageId,
-          model,
-          timestamp
-        };
-        if (stepId) {
-          yield {
-            type: EventType.STEP_FINISHED,
-            stepName: stepId,
-            stepId,
-            model,
-            timestamp,
-            content: accumulatedReasoning
-          };
-        }
-      }
-    }).bind(this);
-    const openReasoning = (function* () {
-      if (reasoningMessageId) return;
-      reasoningMessageId = generateId(this.name);
-      stepId = generateId(this.name);
-      yield {
-        type: EventType.REASONING_START,
-        messageId: reasoningMessageId,
-        model,
-        timestamp
-      };
-      yield {
-        type: EventType.REASONING_MESSAGE_START,
-        messageId: reasoningMessageId,
-        role: "reasoning",
-        model,
-        timestamp
-      };
-      yield {
-        type: EventType.STEP_STARTED,
-        stepName: stepId,
-        stepId,
-        model,
-        timestamp,
-        stepType: "thinking"
-      };
-    }).bind(this);
-    try {
-      const { tools: _tools, ...cleanParams } = requestParams;
-      void _tools;
-      chatOptions.logger.request(
-        `activity=structuredOutputStream provider=${this.name} model=${this.model} messages=${chatOptions.messages.length}`,
-        { provider: this.name, model: this.model }
-      );
-      const stream = await this.client.responses.create(
-        {
-          ...cleanParams,
-          stream: true,
-          text: {
-            format: {
-              type: "json_schema",
-              name: "structured_output",
-              schema: jsonSchema,
-              strict: true
-            }
-          }
-        },
-        extractRequestOptions(chatOptions.request)
-      );
-      for await (const chunk of stream) {
-        chatOptions.logger.provider(
-          `provider=${this.name} type=${chunk.type}`,
-          { provider: this.name, type: chunk.type }
-        );
-        if (!aguiState.hasEmittedRunStarted) {
-          aguiState.hasEmittedRunStarted = true;
-          yield {
-            type: EventType.RUN_STARTED,
-            runId: aguiState.runId,
-            threadId: aguiState.threadId,
-            model,
-            timestamp,
-            parentRunId: chatOptions.parentRunId
-          };
-        }
-        if (chunk.type === "response.created" || chunk.type === "response.in_progress") {
-          const responseModel = chunk.response?.model;
-          if (responseModel) model = responseModel;
-          continue;
-        }
-        if (chunk.type === "response.refusal.delta") {
-          const delta = typeof chunk.delta === "string" ? chunk.delta : "";
-          yield {
-            type: EventType.RUN_ERROR,
-            runId: aguiState.runId,
-            model,
-            timestamp,
-            message: `Model refused: ${delta}`,
-            code: "refusal",
-            error: { message: `Model refused: ${delta}`, code: "refusal" }
-          };
-          return;
-        }
-        if (chunk.type === "response.reasoning_text.delta" || chunk.type === "response.reasoning_summary_text.delta") {
-          const raw = chunk.delta;
-          const reasoningDelta = Array.isArray(raw) ? raw.join("") : typeof raw === "string" ? raw : "";
-          if (!reasoningDelta) continue;
-          yield* openReasoning();
-          if (!reasoningMessageId) continue;
-          accumulatedReasoning += reasoningDelta;
-          yield {
-            type: EventType.REASONING_MESSAGE_CONTENT,
-            messageId: reasoningMessageId,
-            delta: reasoningDelta,
-            model,
-            timestamp
-          };
-          continue;
-        }
-        if (chunk.type === "response.output_text.delta") {
-          const raw = chunk.delta;
-          const textDelta = Array.isArray(raw) ? raw.join("") : typeof raw === "string" ? raw : "";
-          if (!textDelta) continue;
-          yield* closeReasoning();
-          if (!hasEmittedTextMessageStart) {
-            hasEmittedTextMessageStart = true;
-            yield {
-              type: EventType.TEXT_MESSAGE_START,
-              messageId: aguiState.messageId,
-              model,
-              timestamp,
-              role: "assistant"
-            };
-          }
-          accumulatedContent += textDelta;
-          yield {
-            type: EventType.TEXT_MESSAGE_CONTENT,
-            messageId: aguiState.messageId,
-            model,
-            timestamp,
-            delta: textDelta,
-            content: accumulatedContent
-          };
-          continue;
-        }
-        if (chunk.type === "response.completed") {
-          const response = chunk.response;
-          if (response.usage) usage = response.usage;
-          if (response.model) model = response.model;
-          continue;
-        }
-        if (chunk.type === "response.failed") {
-          const response = chunk.response;
-          const message = response?.error?.message || "Responses API stream failed";
-          const code = response?.error?.code;
-          yield {
-            type: EventType.RUN_ERROR,
-            runId: aguiState.runId,
-            model,
-            timestamp,
-            message,
-            ...code !== void 0 && { code },
-            error: { message, ...code !== void 0 && { code } }
-          };
-          return;
-        }
-      }
-      yield* closeReasoning();
-      if (hasEmittedTextMessageStart) {
-        yield {
-          type: EventType.TEXT_MESSAGE_END,
-          messageId: aguiState.messageId,
-          model,
-          timestamp
-        };
-      }
-      if (accumulatedContent.length === 0) {
-        yield {
-          type: EventType.RUN_ERROR,
-          runId: aguiState.runId,
-          model,
-          timestamp,
-          message: `${this.name}.structuredOutputStream: response contained no content`,
-          code: "empty-response",
-          error: {
-            message: `${this.name}.structuredOutputStream: response contained no content`,
-            code: "empty-response"
-          }
-        };
-        return;
-      }
-      let parsed;
-      try {
-        parsed = JSON.parse(accumulatedContent);
-      } catch {
-        yield {
-          type: EventType.RUN_ERROR,
-          runId: aguiState.runId,
-          model,
-          timestamp,
-          message: `Failed to parse structured output as JSON. Content: ${accumulatedContent.slice(0, 200)}${accumulatedContent.length > 200 ? "..." : ""}`,
-          code: "parse-error",
-          error: {
-            message: "Failed to parse structured output as JSON",
-            code: "parse-error"
-          }
-        };
-        return;
-      }
-      const transformed = this.transformStructuredOutput(parsed);
-      yield {
-        type: EventType.CUSTOM,
-        name: "structured-output.complete",
-        value: {
-          object: transformed,
-          raw: accumulatedContent,
-          ...accumulatedReasoning ? { reasoning: accumulatedReasoning } : {}
-        },
-        model,
-        timestamp
-      };
-      yield {
-        type: EventType.RUN_FINISHED,
-        runId: aguiState.runId,
-        threadId: aguiState.threadId,
-        model,
-        timestamp,
-        finishReason: "stop",
-        ...usage && {
-          usage: buildResponsesUsage(usage)
-        }
-      };
-    } catch (error) {
-      if (!aguiState.hasEmittedRunStarted) {
-        aguiState.hasEmittedRunStarted = true;
-        yield {
-          type: EventType.RUN_STARTED,
-          runId: aguiState.runId,
-          threadId: aguiState.threadId,
-          model,
-          timestamp,
-          parentRunId: chatOptions.parentRunId
-        };
-      }
-      const isAbort = this.isAbortError(error);
-      const errorPayload = toRunErrorPayload(
-        error,
-        `${this.name}.structuredOutputStream failed`
-      );
-      const resolvedCode = isAbort ? "aborted" : errorPayload.code;
-      const rawEvent = isAbort ? void 0 : toRunErrorRawEvent(error);
-      yield {
-        type: EventType.RUN_ERROR,
-        runId: aguiState.runId,
-        model,
-        timestamp,
-        message: errorPayload.message,
-        ...resolvedCode !== void 0 && { code: resolvedCode },
-        ...rawEvent !== void 0 && { rawEvent },
-        error: {
-          message: errorPayload.message,
-          ...resolvedCode !== void 0 && { code: resolvedCode }
-        }
-      };
-      chatOptions.logger.errors(`${this.name}.structuredOutputStream fatal`, {
-        error: errorPayload,
-        source: `${this.name}.structuredOutputStream`
-      });
-    }
-  }
-  /**
-   * Cross-SDK abort detection for `structuredOutputStream`. Mirrors the
-   * Chat Completions base; subclasses with proprietary error types override.
-   */
-  isAbortError(error) {
-    if (!error || typeof error !== "object") return false;
-    const e = error;
-    return e.name === "APIUserAbortError" || e.name === "AbortError" || e.code === "ERR_CANCELED";
-  }
-  /**
-   * Applies provider-specific transformations for structured output compatibility.
-   * Override this in subclasses to handle provider-specific quirks.
-   */
-  makeStructuredOutputCompatible(schema, originalRequired) {
-    return makeStructuredOutputCompatible(schema, originalRequired);
-  }
-  /**
-   * Final shaping pass applied to parsed structured-output JSON before it is
-   * returned to the caller. Default is a passthrough.
-   *
-   * Provider `null`s are no longer stripped here: strict-mode null-widening is
-   * now undone precisely by the engine (`undoNullWidening`, driven by the
-   * schema's null-widening map) the moment the result is captured, so a blind
-   * `transformNullsToUndefined` at the adapter would only destroy genuine
-   * `.nullable()` nulls. Subclasses may still override to remap or reshape the
-   * provider's structured output.
-   */
-  transformStructuredOutput(parsed) {
-    return parsed;
-  }
-  /**
-   * Extract text content from a non-streaming Responses API response.
-   * Override this in subclasses for provider-specific response shapes.
-   */
-  extractTextFromResponse(response) {
-    let textContent = "";
-    let refusal;
-    let sawMessageItem = false;
-    const observedItemTypes = /* @__PURE__ */ new Set();
-    for (const item of response.output) {
-      observedItemTypes.add(item.type);
-      if (item.type === "message") {
-        sawMessageItem = true;
-        for (const part of item.content) {
-          const partType = part.type;
-          if (partType === "output_text") {
-            textContent += part.text ?? "";
-          } else if (partType === "refusal") {
-            const refusalText = part.refusal;
-            refusal = refusalText || refusal || "Refused without explanation";
-          } else {
-            throw new Error(
-              `${this.name}.extractTextFromResponse: unsupported message content part type "${partType}"`
-            );
-          }
-        }
-      }
-    }
-    if (!textContent && refusal !== void 0) {
-      const err = new Error(`Model refused to respond: ${refusal}`);
-      err.code = "refusal";
-      throw err;
-    }
-    if (!textContent && response.output.length > 0 && !sawMessageItem) {
-      throw new Error(
-        `${this.name}.extractTextFromResponse: response.output contained items of type(s) [${[...observedItemTypes].sort().join(", ")}] but no message text — the model returned a non-text response`
-      );
-    }
-    return textContent;
-  }
-  /**
-   * Processes streamed chunks from the Responses API and yields AG-UI events.
-   * Override this in subclasses to handle provider-specific stream behavior.
-   *
-   * Handles the following event types:
-   * - response.created / response.incomplete / response.failed
-   * - response.output_text.delta
-   * - response.reasoning_text.delta
-   * - response.reasoning_summary_text.delta
-   * - response.content_part.added / response.content_part.done
-   * - response.output_item.added
-   * - response.function_call_arguments.delta / response.function_call_arguments.done
-   * - response.completed
-   * - error
-   */
-  async *processStreamChunks(stream, toolCallMetadata, options, aguiState) {
-    let accumulatedContent = "";
-    let accumulatedReasoning = "";
-    let hasStreamedContentDeltas = false;
-    let hasStreamedReasoningDeltas = false;
-    let model = options.model;
-    let stepId = null;
-    let hasEmittedTextMessageStart = false;
-    let hasEmittedStepStarted = false;
-    let runFinishedEmitted = false;
-    try {
-      for await (const chunk of stream) {
-        options.logger.provider(`provider=${this.name} type=${chunk.type}`, {
-          provider: this.name,
-          type: chunk.type
-        });
-        if (!aguiState.hasEmittedRunStarted) {
-          aguiState.hasEmittedRunStarted = true;
-          yield {
-            type: EventType.RUN_STARTED,
-            runId: aguiState.runId,
-            threadId: aguiState.threadId,
-            model: model || options.model,
-            timestamp: Date.now(),
-            parentRunId: options.parentRunId
-          };
-        }
-        const handleContentPart = (contentPart) => {
-          if (contentPart.type === "output_text") {
-            accumulatedContent += contentPart.text || "";
-            return {
-              type: EventType.TEXT_MESSAGE_CONTENT,
-              messageId: aguiState.messageId,
-              model: model || options.model,
-              timestamp: Date.now(),
-              delta: contentPart.text || "",
-              content: accumulatedContent
-            };
-          }
-          if (contentPart.type === "reasoning_text") {
-            accumulatedReasoning += contentPart.text || "";
-            if (!stepId) {
-              stepId = generateId(this.name);
-            }
-            return {
-              type: EventType.STEP_FINISHED,
-              stepName: stepId,
-              stepId,
-              model: model || options.model,
-              timestamp: Date.now(),
-              delta: contentPart.text || "",
-              content: accumulatedReasoning
-            };
-          }
-          const isRefusal = contentPart.type === "refusal";
-          const message = isRefusal ? contentPart.refusal || "Refused without explanation" : `Unsupported response content_part type: ${contentPart.type}`;
-          const code = isRefusal ? "refusal" : contentPart.type;
-          return {
-            type: EventType.RUN_ERROR,
-            model: model || options.model,
-            timestamp: Date.now(),
-            message,
-            code,
-            error: { message, code }
-          };
-        };
-        if (chunk.type === "response.created" || chunk.type === "response.incomplete" || chunk.type === "response.failed") {
-          model = chunk.response.model;
-        }
-        if (chunk.type === "response.created") {
-          hasStreamedContentDeltas = false;
-          hasStreamedReasoningDeltas = false;
-          hasEmittedTextMessageStart = false;
-          hasEmittedStepStarted = false;
-          accumulatedContent = "";
-          accumulatedReasoning = "";
-        }
-        if (chunk.type === "response.failed" || chunk.type === "response.incomplete") {
-          if (hasEmittedTextMessageStart) {
-            yield {
-              type: EventType.TEXT_MESSAGE_END,
-              messageId: aguiState.messageId,
-              model: chunk.response.model,
-              timestamp: Date.now()
-            };
-            hasEmittedTextMessageStart = false;
-          }
-          const errorMessage = chunk.response.error?.message || chunk.response.incomplete_details?.reason || (chunk.type === "response.failed" ? "Response failed" : "Response ended incomplete");
-          const errorCode = chunk.response.error?.code ?? (chunk.response.incomplete_details ? "incomplete" : void 0) ?? void 0;
-          yield {
-            type: EventType.RUN_ERROR,
-            model: chunk.response.model,
-            timestamp: Date.now(),
-            message: errorMessage,
-            ...errorCode !== void 0 && { code: errorCode },
-            error: {
-              message: errorMessage,
-              ...errorCode !== void 0 && { code: errorCode }
-            }
-          };
-          runFinishedEmitted = true;
-          return;
-        }
-        if (chunk.type === "response.output_text.delta" && chunk.delta) {
-          const textDelta = Array.isArray(chunk.delta) ? chunk.delta.join("") : typeof chunk.delta === "string" ? chunk.delta : "";
-          if (textDelta) {
-            if (!hasEmittedTextMessageStart) {
-              hasEmittedTextMessageStart = true;
-              yield {
-                type: EventType.TEXT_MESSAGE_START,
-                messageId: aguiState.messageId,
-                model: model || options.model,
-                timestamp: Date.now(),
-                role: "assistant"
-              };
-            }
-            accumulatedContent += textDelta;
-            hasStreamedContentDeltas = true;
-            yield {
-              type: EventType.TEXT_MESSAGE_CONTENT,
-              messageId: aguiState.messageId,
-              model: model || options.model,
-              timestamp: Date.now(),
-              delta: textDelta,
-              content: accumulatedContent
-            };
-          }
-        }
-        if (chunk.type === "response.reasoning_text.delta" && chunk.delta) {
-          const reasoningDelta = Array.isArray(chunk.delta) ? chunk.delta.join("") : typeof chunk.delta === "string" ? chunk.delta : "";
-          if (reasoningDelta) {
-            if (!hasEmittedStepStarted) {
-              hasEmittedStepStarted = true;
-              stepId = generateId(this.name);
-              yield {
-                type: EventType.STEP_STARTED,
-                stepName: stepId,
-                stepId,
-                model: model || options.model,
-                timestamp: Date.now(),
-                stepType: "thinking"
-              };
-            }
-            accumulatedReasoning += reasoningDelta;
-            hasStreamedReasoningDeltas = true;
-            const fallbackStepId = stepId || generateId(this.name);
-            yield {
-              type: EventType.STEP_FINISHED,
-              stepName: fallbackStepId,
-              stepId: fallbackStepId,
-              model: model || options.model,
-              timestamp: Date.now(),
-              delta: reasoningDelta,
-              content: accumulatedReasoning
-            };
-          }
-        }
-        if (chunk.type === "response.reasoning_summary_text.delta" && chunk.delta) {
-          const summaryDelta = typeof chunk.delta === "string" ? chunk.delta : "";
-          if (summaryDelta) {
-            if (!hasEmittedStepStarted) {
-              hasEmittedStepStarted = true;
-              stepId = generateId(this.name);
-              yield {
-                type: EventType.STEP_STARTED,
-                stepName: stepId,
-                stepId,
-                model: model || options.model,
-                timestamp: Date.now(),
-                stepType: "thinking"
-              };
-            }
-            accumulatedReasoning += summaryDelta;
-            hasStreamedReasoningDeltas = true;
-            const fallbackStepId = stepId || generateId(this.name);
-            yield {
-              type: EventType.STEP_FINISHED,
-              stepName: fallbackStepId,
-              stepId: fallbackStepId,
-              model: model || options.model,
-              timestamp: Date.now(),
-              delta: summaryDelta,
-              content: accumulatedReasoning
-            };
-          }
-        }
-        if (chunk.type === "response.content_part.added") {
-          const contentPart = chunk.part;
-          if (contentPart.type === "output_text" && !hasEmittedTextMessageStart) {
-            hasEmittedTextMessageStart = true;
-            yield {
-              type: EventType.TEXT_MESSAGE_START,
-              messageId: aguiState.messageId,
-              model: model || options.model,
-              timestamp: Date.now(),
-              role: "assistant"
-            };
-          }
-          if (contentPart.type === "reasoning_text" && !hasEmittedStepStarted) {
-            hasEmittedStepStarted = true;
-            stepId = generateId(this.name);
-            yield {
-              type: EventType.STEP_STARTED,
-              stepName: stepId,
-              stepId,
-              model: model || options.model,
-              timestamp: Date.now(),
-              stepType: "thinking"
-            };
-          }
-          if (contentPart.type === "output_text") {
-            hasStreamedContentDeltas = true;
-          } else if (contentPart.type === "reasoning_text") {
-            hasStreamedReasoningDeltas = true;
-          }
-          const partChunk = handleContentPart(contentPart);
-          yield partChunk;
-          if (partChunk.type === "RUN_ERROR") {
-            runFinishedEmitted = true;
-            return;
-          }
-        }
-        if (chunk.type === "response.content_part.done") {
-          const contentPart = chunk.part;
-          if (contentPart.type === "output_text" && hasStreamedContentDeltas) {
-            continue;
-          }
-          if (contentPart.type === "reasoning_text" && hasStreamedReasoningDeltas) {
-            continue;
-          }
-          if (contentPart.type === "output_text" && !hasEmittedTextMessageStart) {
-            hasEmittedTextMessageStart = true;
-            yield {
-              type: EventType.TEXT_MESSAGE_START,
-              messageId: aguiState.messageId,
-              model: model || options.model,
-              timestamp: Date.now(),
-              role: "assistant"
-            };
-          } else if (contentPart.type === "reasoning_text" && !hasEmittedStepStarted) {
-            hasEmittedStepStarted = true;
-            stepId = generateId(this.name);
-            yield {
-              type: EventType.STEP_STARTED,
-              stepName: stepId,
-              stepId,
-              model: model || options.model,
-              timestamp: Date.now(),
-              stepType: "thinking"
-            };
-          }
-          const doneChunk = handleContentPart(contentPart);
-          yield doneChunk;
-          if (doneChunk.type === "RUN_ERROR") {
-            runFinishedEmitted = true;
-            return;
-          }
-        }
-        if (chunk.type === "response.output_item.added") {
-          const item = chunk.item;
-          if (item.type === "function_call" && item.id) {
-            let metadata = toolCallMetadata.get(item.id);
-            if (!metadata) {
-              metadata = {
-                index: chunk.output_index,
-                name: item.name || "",
-                started: false
-              };
-              toolCallMetadata.set(item.id, metadata);
-            } else if (!metadata.name && item.name) {
-              metadata.name = item.name;
-            }
-            if (!metadata.started && metadata.name) {
-              yield {
-                type: EventType.TOOL_CALL_START,
-                toolCallId: item.id,
-                toolCallName: metadata.name,
-                toolName: metadata.name,
-                parentMessageId: aguiState.messageId,
-                model: model || options.model,
-                timestamp: Date.now(),
-                index: chunk.output_index
-              };
-              metadata.started = true;
-            }
-          }
-        }
-        if (chunk.type === "response.function_call_arguments.delta" && chunk.delta) {
-          const metadata = toolCallMetadata.get(chunk.item_id);
-          if (!metadata?.started) {
-            options.logger.errors(
-              `${this.name}.processStreamChunks orphan function_call_arguments.delta`,
-              {
-                source: `${this.name}.processStreamChunks`,
-                toolCallId: chunk.item_id,
-                rawDelta: chunk.delta
-              }
-            );
-            continue;
-          }
-          yield {
-            type: EventType.TOOL_CALL_ARGS,
-            toolCallId: chunk.item_id,
-            model: model || options.model,
-            timestamp: Date.now(),
-            delta: chunk.delta
-          };
-        }
-        if (chunk.type === "response.function_call_arguments.done") {
-          const { item_id } = chunk;
-          const metadata = toolCallMetadata.get(item_id);
-          if (!metadata?.started) {
-            if (metadata) {
-              metadata.pendingArguments = chunk.arguments;
-            }
-            options.logger.errors(
-              `${this.name}.processStreamChunks deferring function_call_arguments.done — TOOL_CALL_START not yet emitted (waiting for name)`,
-              {
-                source: `${this.name}.processStreamChunks`,
-                toolCallId: item_id,
-                rawArguments: chunk.arguments
-              }
-            );
-            continue;
-          }
-          if (metadata.ended) continue;
-          const name = metadata.name || "";
-          metadata.ended = true;
-          let parsedInput = {};
-          if (chunk.arguments) {
-            try {
-              const parsed = JSON.parse(chunk.arguments);
-              parsedInput = parsed && typeof parsed === "object" ? parsed : {};
-            } catch (parseError) {
-              options.logger.errors(
-                `${this.name}.processStreamChunks tool-args JSON parse failed`,
-                {
-                  error: toRunErrorPayload(
-                    parseError,
-                    `tool ${name} (${item_id}) returned malformed JSON arguments`
-                  ),
-                  source: `${this.name}.processStreamChunks`,
-                  toolCallId: item_id,
-                  toolName: name,
-                  rawArguments: chunk.arguments
-                }
-              );
-              parsedInput = {};
-            }
-          }
-          yield {
-            type: EventType.TOOL_CALL_END,
-            toolCallId: item_id,
-            toolCallName: name,
-            toolName: name,
-            model: model || options.model,
-            timestamp: Date.now(),
-            input: parsedInput
-          };
-        }
-        if (chunk.type === "response.output_item.done") {
-          const item = chunk.item;
-          if (item.type === "function_call" && item.id) {
-            const metadata = toolCallMetadata.get(item.id) ?? {
-              index: chunk.output_index,
-              name: item.name || "",
-              started: false
-            };
-            if (!toolCallMetadata.has(item.id)) {
-              toolCallMetadata.set(item.id, metadata);
-            } else if (!metadata.name && item.name) {
-              metadata.name = item.name;
-            }
-            if (!metadata.started && metadata.name) {
-              yield {
-                type: EventType.TOOL_CALL_START,
-                toolCallId: item.id,
-                toolCallName: metadata.name,
-                toolName: metadata.name,
-                parentMessageId: aguiState.messageId,
-                model: model || options.model,
-                timestamp: Date.now(),
-                index: metadata.index
-              };
-              metadata.started = true;
-            }
-            const rawArgs = typeof item.arguments === "string" && item.arguments.length > 0 ? item.arguments : metadata.pendingArguments;
-            if (metadata.started && !metadata.ended && rawArgs !== void 0) {
-              const name = metadata.name || "";
-              let parsedInput = {};
-              if (rawArgs) {
-                try {
-                  const parsed = JSON.parse(rawArgs);
-                  parsedInput = parsed && typeof parsed === "object" ? parsed : {};
-                } catch (parseError) {
-                  options.logger.errors(
-                    `${this.name}.processStreamChunks tool-args JSON parse failed (output_item.done backfill)`,
-                    {
-                      error: toRunErrorPayload(
-                        parseError,
-                        `tool ${name} (${item.id}) returned malformed JSON arguments`
-                      ),
-                      source: `${this.name}.processStreamChunks`,
-                      toolCallId: item.id,
-                      toolName: name,
-                      rawArguments: rawArgs
-                    }
-                  );
-                  parsedInput = {};
-                }
-              }
-              yield {
-                type: EventType.TOOL_CALL_END,
-                toolCallId: item.id,
-                toolCallName: name,
-                toolName: name,
-                model: model || options.model,
-                timestamp: Date.now(),
-                input: parsedInput
-              };
-              metadata.ended = true;
-              metadata.pendingArguments = void 0;
-            }
-          }
-        }
-        if (chunk.type === "response.completed") {
-          for (const item of chunk.response.output) {
-            if (item.type !== "function_call" || !item.id) continue;
-            const metadata = toolCallMetadata.get(item.id) ?? {
-              index: 0,
-              name: item.name || "",
-              started: false
-            };
-            if (!toolCallMetadata.has(item.id)) {
-              toolCallMetadata.set(item.id, metadata);
-            } else if (!metadata.name && item.name) {
-              metadata.name = item.name;
-            }
-            if (!metadata.started && metadata.name) {
-              yield {
-                type: EventType.TOOL_CALL_START,
-                toolCallId: item.id,
-                toolCallName: metadata.name,
-                toolName: metadata.name,
-                parentMessageId: aguiState.messageId,
-                model: model || options.model,
-                timestamp: Date.now(),
-                index: metadata.index
-              };
-              metadata.started = true;
-            }
-            const rawArgs = typeof item.arguments === "string" && item.arguments.length > 0 ? item.arguments : metadata.pendingArguments;
-            if (metadata.started && !metadata.ended) {
-              const name = metadata.name || "";
-              let parsedInput = {};
-              if (rawArgs) {
-                try {
-                  const parsed = JSON.parse(rawArgs);
-                  parsedInput = parsed && typeof parsed === "object" ? parsed : {};
-                } catch (parseError) {
-                  options.logger.errors(
-                    `${this.name}.processStreamChunks tool-args JSON parse failed (response.completed backfill)`,
-                    {
-                      error: toRunErrorPayload(
-                        parseError,
-                        `tool ${name} (${item.id}) returned malformed JSON arguments`
-                      ),
-                      source: `${this.name}.processStreamChunks`,
-                      toolCallId: item.id,
-                      toolName: name,
-                      rawArguments: rawArgs
-                    }
-                  );
-                  parsedInput = {};
-                }
-              }
-              yield {
-                type: EventType.TOOL_CALL_END,
-                toolCallId: item.id,
-                toolCallName: name,
-                toolName: name,
-                model: model || options.model,
-                timestamp: Date.now(),
-                input: parsedInput
-              };
-              metadata.ended = true;
-              metadata.pendingArguments = void 0;
-            }
-          }
-          if (hasEmittedTextMessageStart) {
-            yield {
-              type: EventType.TEXT_MESSAGE_END,
-              messageId: aguiState.messageId,
-              model: model || options.model,
-              timestamp: Date.now()
-            };
-            hasEmittedTextMessageStart = false;
-          }
-          const hasFunctionCalls = chunk.response.output.some(
-            (item) => item.type === "function_call"
-          );
-          const incompleteReason = chunk.response.incomplete_details?.reason;
-          const finishReason = hasFunctionCalls ? "tool_calls" : incompleteReason === "max_output_tokens" ? "length" : incompleteReason === "content_filter" ? "content_filter" : "stop";
-          yield {
-            type: EventType.RUN_FINISHED,
-            runId: aguiState.runId,
-            threadId: aguiState.threadId,
-            model: model || options.model,
-            timestamp: Date.now(),
-            // Omit usage entirely when the provider reported none rather than
-            // emitting fabricated zeros (also satisfies exactOptionalPropertyTypes).
-            ...chunk.response.usage && {
-              usage: buildResponsesUsage(chunk.response.usage)
-            },
-            finishReason
-          };
-          runFinishedEmitted = true;
-        }
-        if (chunk.type === "error") {
-          const code = chunk.code ?? void 0;
-          yield {
-            type: EventType.RUN_ERROR,
-            model: model || options.model,
-            timestamp: Date.now(),
-            message: chunk.message,
-            ...code !== void 0 && { code },
-            error: {
-              message: chunk.message,
-              ...code !== void 0 && { code }
-            }
-          };
-          runFinishedEmitted = true;
-          return;
-        }
-      }
-      if (!runFinishedEmitted && aguiState.hasEmittedRunStarted) {
-        if (hasEmittedTextMessageStart) {
-          yield {
-            type: EventType.TEXT_MESSAGE_END,
-            messageId: aguiState.messageId,
-            model: model || options.model,
-            timestamp: Date.now()
-          };
-        }
-        yield {
-          type: EventType.RUN_FINISHED,
-          runId: aguiState.runId,
-          threadId: aguiState.threadId,
-          model: model || options.model,
-          timestamp: Date.now(),
-          finishReason: toolCallMetadata.size > 0 ? "tool_calls" : "stop"
-        };
-      }
-    } catch (error) {
-      const errorPayload = toRunErrorPayload(
-        error,
-        `${this.name}.processStreamChunks failed`
-      );
-      const rawEvent = toRunErrorRawEvent(error);
-      options.logger.errors(`${this.name}.processStreamChunks fatal`, {
-        error: errorPayload,
-        source: `${this.name}.processStreamChunks`
-      });
-      yield {
-        type: EventType.RUN_ERROR,
-        model: options.model,
-        timestamp: Date.now(),
-        message: errorPayload.message,
-        ...errorPayload.code !== void 0 && { code: errorPayload.code },
-        ...rawEvent !== void 0 && { rawEvent },
-        error: {
-          message: errorPayload.message,
-          ...errorPayload.code !== void 0 && { code: errorPayload.code }
-        }
-      };
-    }
-  }
-  /**
-   * Maps common TextOptions to Responses API request format.
-   * Override this in subclasses to add provider-specific options.
-   */
-  mapOptionsToRequest(options) {
-    const input = this.convertMessagesToInput(options.messages);
-    const tools = options.tools ? convertToolsToResponsesFormat(
-      options.tools,
-      this.makeStructuredOutputCompatible.bind(this)
-    ) : void 0;
-    const modelOptions = options.modelOptions;
-    const combinedSchema = options.outputSchema;
-    const textFormat = combinedSchema ? {
-      text: {
-        format: {
-          type: "json_schema",
-          name: "structured_output",
-          schema: this.makeStructuredOutputCompatible(
-            combinedSchema,
-            Array.isArray(combinedSchema.required) ? combinedSchema.required : void 0
-          ),
-          strict: true
-        }
-      }
-    } : void 0;
-    return {
-      ...modelOptions,
-      model: options.model,
-      ...options.metadata !== void 0 && { metadata: options.metadata },
-      ...(() => {
-        const prompts = normalizeSystemPrompts(options.systemPrompts);
-        if (prompts.length === 0) return {};
-        return { instructions: prompts.map((p) => p.content).join("\n") };
-      })(),
-      input,
-      // Conditional spread: `tools: undefined` would clobber any
-      // modelOptions.tools the caller set above.
-      ...tools && tools.length > 0 && { tools },
-      ...textFormat ?? {}
-    };
-  }
-  /**
-   * The OpenAI Responses API supports `tools` and `text.format: json_schema`
-   * together in a single streaming request (per issue #605). Subclasses
-   * that route to providers without this capability should override.
-   */
-  supportsCombinedToolsAndSchema() {
-    return true;
-  }
-  /**
-   * Converts ModelMessage[] to Responses API ResponseInput format.
-   * Override this in subclasses for provider-specific message format quirks.
-   *
-   * Key differences from Chat Completions:
-   * - Tool results use `function_call_output` type (not `tool` role)
-   * - Assistant tool calls are `function_call` objects (not nested in `tool_calls`)
-   * - User content uses `input_text`, `input_image`, `input_file` types
-   * - System prompts go in `instructions`, not as messages
-   */
-  convertMessagesToInput(messages) {
-    const result = [];
-    for (const message of messages) {
-      if (message.role === "tool") {
-        const toolContent = message.content;
-        const output = Array.isArray(toolContent) ? toolContent.map((part) => this.convertContentPartToInput(part)) : typeof toolContent === "string" ? toolContent : JSON.stringify(toolContent);
-        result.push({
-          type: "function_call_output",
-          call_id: message.toolCallId || "",
-          output
-        });
-        continue;
-      }
-      if (message.role === "assistant") {
-        if (message.toolCalls && message.toolCalls.length > 0) {
-          for (const toolCall of message.toolCalls) {
-            const argumentsString = typeof toolCall.function.arguments === "string" ? toolCall.function.arguments : JSON.stringify(toolCall.function.arguments);
-            result.push({
-              type: "function_call",
-              call_id: toolCall.id,
-              name: toolCall.function.name,
-              arguments: argumentsString
-            });
-          }
-        }
-        if (message.content) {
-          const contentStr = this.extractTextContent(message.content);
-          if (contentStr) {
-            result.push({
-              type: "message",
-              role: "assistant",
-              content: contentStr
-            });
-          }
-        }
-        continue;
-      }
-      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.`
-        );
-      }
-      result.push({
-        type: "message",
-        role: "user",
-        content: inputContent
-      });
-    }
-    return result;
-  }
-  /**
-   * Converts a ContentPart to Responses API input content item.
-   * Handles text, image, and audio content parts.
-   * Override this in subclasses for additional content types or provider-specific metadata.
-   */
-  convertContentPartToInput(part) {
-    switch (part.type) {
-      case "text":
-        return {
-          type: "input_text",
-          text: part.content
-        };
-      case "image": {
-        const imageMetadata = part.metadata;
-        if (part.source.type === "url") {
-          return {
-            type: "input_image",
-            image_url: part.source.value,
-            detail: imageMetadata?.detail || "auto"
-          };
-        }
-        const imageValue = part.source.value;
-        const imageMime = part.source.mimeType || "application/octet-stream";
-        const imageUrl = imageValue.startsWith("data:") ? imageValue : `data:${imageMime};base64,${imageValue}`;
-        return {
-          type: "input_image",
-          image_url: imageUrl,
-          detail: imageMetadata?.detail || "auto"
-        };
-      }
-      case "audio": {
-        if (part.source.type === "url") {
-          return {
-            type: "input_file",
-            file_url: part.source.value
-          };
-        }
-        const audioValue = part.source.value;
-        const audioMime = part.source.mimeType || "application/octet-stream";
-        const audioFileData = audioValue.startsWith("data:") ? audioValue : `data:${audioMime};base64,${audioValue}`;
-        return {
-          type: "input_file",
-          file_data: audioFileData
-        };
-      }
-      case "video":
-      case "document":
-      default:
-        throw new Error(`Unsupported content part type: ${part.type}`);
-    }
-  }
-  /**
-   * Normalizes message content to an array of ContentPart.
-   * Handles backward compatibility with string content.
-   */
-  normalizeContent(content) {
-    if (content === null) {
-      return [];
-    }
-    if (typeof content === "string") {
-      return [{ type: "text", content }];
-    }
-    return content;
-  }
-  /**
-   * Extracts text content from a content value that may be string, null, or ContentPart array.
-   */
-  extractTextContent(content) {
-    if (content === null) {
-      return "";
-    }
-    if (typeof content === "string") {
-      return content;
-    }
-    return content.filter((p) => p.type === "text").map((p) => p.content).join("");
-  }
-}
-export {
-  OpenAIBaseResponsesTextAdapter
+//#region src/adapters/responses-text.ts
+/**
+* Shared implementation of the OpenAI Responses API. Holds the stream-event
+* accumulator + AG-UI lifecycle and calls the OpenAI SDK directly. Subclasses
+* (today: ai-openai) construct an OpenAI client with their provider-specific
+* `baseURL` / headers and pass it in.
+*/
+var OpenAIBaseResponsesTextAdapter = class extends BaseTextAdapter {
+	kind = "text";
+	name;
+	client;
+	constructor(model, name, client) {
+		super({}, model);
+		this.name = name;
+		this.client = client;
+	}
+	async *chatStream(options) {
+		const toolCallMetadata = /* @__PURE__ */ new Map();
+		const aguiState = {
+			runId: options.runId ?? generateId(this.name),
+			threadId: options.threadId ?? generateId(this.name),
+			messageId: generateId(this.name),
+			hasEmittedRunStarted: false
+		};
+		try {
+			const requestParams = this.mapOptionsToRequest(options);
+			options.logger.request(`activity=chat provider=${this.name} model=${this.model} messages=${options.messages.length} tools=${options.tools?.length ?? 0} stream=true`, {
+				provider: this.name,
+				model: this.model
+			});
+			const response = await this.client.responses.create({
+				...requestParams,
+				stream: true
+			}, extractRequestOptions(options.request));
+			yield* this.processStreamChunks(response, toolCallMetadata, options, aguiState);
+		} catch (error) {
+			const errorPayload = toRunErrorPayload(error, `${this.name}.chatStream failed`);
+			const rawEvent = toRunErrorRawEvent(error);
+			if (!aguiState.hasEmittedRunStarted) {
+				aguiState.hasEmittedRunStarted = true;
+				yield {
+					type: EventType.RUN_STARTED,
+					runId: aguiState.runId,
+					threadId: aguiState.threadId,
+					model: options.model,
+					timestamp: Date.now(),
+					parentRunId: options.parentRunId
+				};
+			}
+			yield {
+				type: EventType.RUN_ERROR,
+				model: options.model,
+				timestamp: Date.now(),
+				message: errorPayload.message,
+				code: errorPayload.code,
+				...rawEvent !== void 0 && { rawEvent },
+				error: {
+					message: errorPayload.message,
+					code: errorPayload.code
+				}
+			};
+			options.logger.errors(`${this.name}.chatStream fatal`, {
+				error: errorPayload,
+				source: `${this.name}.chatStream`
+			});
+		}
+	}
+	/**
+	* Generate structured output using the provider's native JSON Schema response format.
+	* Uses stream: false to get the complete response in one call.
+	*
+	* OpenAI-compatible Responses APIs have strict requirements for structured output:
+	* - All properties must be in the `required` array
+	* - Optional fields should have null added to their type union
+	* - additionalProperties must be false for all objects
+	*
+	* The outputSchema is already JSON Schema (converted in the ai layer).
+	* We apply provider-specific transformations for structured output compatibility.
+	*/
+	async structuredOutput(options) {
+		const { chatOptions, outputSchema } = options;
+		const requestParams = this.mapOptionsToRequest(chatOptions);
+		const jsonSchema = this.makeStructuredOutputCompatible(outputSchema, outputSchema.required);
+		try {
+			const { stream: _stream, stream_options: _streamOptions, ...cleanParams } = requestParams;
+			chatOptions.logger.request(`activity=structuredOutput provider=${this.name} model=${this.model} messages=${chatOptions.messages.length}`, {
+				provider: this.name,
+				model: this.model
+			});
+			const response = await this.client.responses.create({
+				...cleanParams,
+				stream: false,
+				text: { format: {
+					type: "json_schema",
+					name: "structured_output",
+					schema: jsonSchema,
+					strict: true
+				} }
+			}, extractRequestOptions(chatOptions.request));
+			const rawText = this.extractTextFromResponse(response);
+			if (rawText.length === 0) throw new Error(`${this.name}.structuredOutput: response contained no content`);
+			let parsed;
+			try {
+				parsed = JSON.parse(rawText);
+			} catch {
+				throw new Error(`Failed to parse structured output as JSON. Content: ${rawText.slice(0, 200)}${rawText.length > 200 ? "..." : ""}`);
+			}
+			return {
+				data: this.transformStructuredOutput(parsed),
+				rawText
+			};
+		} catch (error) {
+			chatOptions.logger.errors(`${this.name}.structuredOutput fatal`, {
+				error: toRunErrorPayload(error, `${this.name}.structuredOutput failed`),
+				source: `${this.name}.structuredOutput`
+			});
+			throw error;
+		}
+	}
+	/**
+	* Stream structured output via the Responses API: single request with
+	* `text.format: json_schema` + `stream: true`. Consumes Responses-API
+	* events (`response.output_text.delta`, `response.reasoning_text.delta`,
+	* `response.reasoning_summary_text.delta`, `response.refusal.delta`,
+	* `response.completed`, `response.failed`) and re-emits the standard AG-UI
+	* lifecycle ending with `CUSTOM 'structured-output.complete'`.
+	*
+	* Tools are stripped (structured output is mutually exclusive with tool
+	* calls in this path). Reasoning text is accumulated and surfaced both as
+	* REASONING_* lifecycle events during the stream and on the terminal
+	* CUSTOM event's `value.reasoning`.
+	*/
+	async *structuredOutputStream(options) {
+		const { chatOptions, outputSchema } = options;
+		const requestParams = this.mapOptionsToRequest(chatOptions);
+		const jsonSchema = this.makeStructuredOutputCompatible(outputSchema, outputSchema.required);
+		const timestamp = Date.now();
+		const aguiState = {
+			runId: generateId(this.name),
+			threadId: chatOptions.threadId ?? generateId(this.name),
+			messageId: generateId(this.name),
+			timestamp,
+			hasEmittedRunStarted: false
+		};
+		let accumulatedContent = "";
+		let accumulatedReasoning = "";
+		let hasEmittedTextMessageStart = false;
+		let reasoningMessageId;
+		let stepId;
+		let hasClosedReasoning = false;
+		let model = chatOptions.model;
+		let usage;
+		const closeReasoning = function* () {
+			if (reasoningMessageId && !hasClosedReasoning) {
+				hasClosedReasoning = true;
+				yield {
+					type: EventType.REASONING_MESSAGE_END,
+					messageId: reasoningMessageId,
+					model,
+					timestamp
+				};
+				yield {
+					type: EventType.REASONING_END,
+					messageId: reasoningMessageId,
+					model,
+					timestamp
+				};
+				if (stepId) yield {
+					type: EventType.STEP_FINISHED,
+					stepName: stepId,
+					stepId,
+					model,
+					timestamp,
+					content: accumulatedReasoning
+				};
+			}
+		}.bind(this);
+		const openReasoning = function* () {
+			if (reasoningMessageId) return;
+			reasoningMessageId = generateId(this.name);
+			stepId = generateId(this.name);
+			yield {
+				type: EventType.REASONING_START,
+				messageId: reasoningMessageId,
+				model,
+				timestamp
+			};
+			yield {
+				type: EventType.REASONING_MESSAGE_START,
+				messageId: reasoningMessageId,
+				role: "reasoning",
+				model,
+				timestamp
+			};
+			yield {
+				type: EventType.STEP_STARTED,
+				stepName: stepId,
+				stepId,
+				model,
+				timestamp,
+				stepType: "thinking"
+			};
+		}.bind(this);
+		try {
+			const { tools: _tools, ...cleanParams } = requestParams;
+			chatOptions.logger.request(`activity=structuredOutputStream provider=${this.name} model=${this.model} messages=${chatOptions.messages.length}`, {
+				provider: this.name,
+				model: this.model
+			});
+			const stream = await this.client.responses.create({
+				...cleanParams,
+				stream: true,
+				text: { format: {
+					type: "json_schema",
+					name: "structured_output",
+					schema: jsonSchema,
+					strict: true
+				} }
+			}, extractRequestOptions(chatOptions.request));
+			for await (const chunk of stream) {
+				chatOptions.logger.provider(`provider=${this.name} type=${chunk.type}`, {
+					provider: this.name,
+					type: chunk.type
+				});
+				if (!aguiState.hasEmittedRunStarted) {
+					aguiState.hasEmittedRunStarted = true;
+					yield {
+						type: EventType.RUN_STARTED,
+						runId: aguiState.runId,
+						threadId: aguiState.threadId,
+						model,
+						timestamp,
+						parentRunId: chatOptions.parentRunId
+					};
+				}
+				if (chunk.type === "response.created" || chunk.type === "response.in_progress") {
+					const responseModel = chunk.response?.model;
+					if (responseModel) model = responseModel;
+					continue;
+				}
+				if (chunk.type === "response.refusal.delta") {
+					const delta = typeof chunk.delta === "string" ? chunk.delta : "";
+					yield {
+						type: EventType.RUN_ERROR,
+						runId: aguiState.runId,
+						model,
+						timestamp,
+						message: `Model refused: ${delta}`,
+						code: "refusal",
+						error: {
+							message: `Model refused: ${delta}`,
+							code: "refusal"
+						}
+					};
+					return;
+				}
+				if (chunk.type === "response.reasoning_text.delta" || chunk.type === "response.reasoning_summary_text.delta") {
+					const raw = chunk.delta;
+					const reasoningDelta = Array.isArray(raw) ? raw.join("") : typeof raw === "string" ? raw : "";
+					if (!reasoningDelta) continue;
+					yield* openReasoning();
+					if (!reasoningMessageId) continue;
+					accumulatedReasoning += reasoningDelta;
+					yield {
+						type: EventType.REASONING_MESSAGE_CONTENT,
+						messageId: reasoningMessageId,
+						delta: reasoningDelta,
+						model,
+						timestamp
+					};
+					continue;
+				}
+				if (chunk.type === "response.output_text.delta") {
+					const raw = chunk.delta;
+					const textDelta = Array.isArray(raw) ? raw.join("") : typeof raw === "string" ? raw : "";
+					if (!textDelta) continue;
+					yield* closeReasoning();
+					if (!hasEmittedTextMessageStart) {
+						hasEmittedTextMessageStart = true;
+						yield {
+							type: EventType.TEXT_MESSAGE_START,
+							messageId: aguiState.messageId,
+							model,
+							timestamp,
+							role: "assistant"
+						};
+					}
+					accumulatedContent += textDelta;
+					yield {
+						type: EventType.TEXT_MESSAGE_CONTENT,
+						messageId: aguiState.messageId,
+						model,
+						timestamp,
+						delta: textDelta,
+						content: accumulatedContent
+					};
+					continue;
+				}
+				if (chunk.type === "response.completed") {
+					const response = chunk.response;
+					if (response.usage) usage = response.usage;
+					if (response.model) model = response.model;
+					continue;
+				}
+				if (chunk.type === "response.failed") {
+					const response = chunk.response;
+					const message = response?.error?.message || "Responses API stream failed";
+					const code = response?.error?.code;
+					yield {
+						type: EventType.RUN_ERROR,
+						runId: aguiState.runId,
+						model,
+						timestamp,
+						message,
+						...code !== void 0 && { code },
+						error: {
+							message,
+							...code !== void 0 && { code }
+						}
+					};
+					return;
+				}
+			}
+			yield* closeReasoning();
+			if (hasEmittedTextMessageStart) yield {
+				type: EventType.TEXT_MESSAGE_END,
+				messageId: aguiState.messageId,
+				model,
+				timestamp
+			};
+			if (accumulatedContent.length === 0) {
+				yield {
+					type: EventType.RUN_ERROR,
+					runId: aguiState.runId,
+					model,
+					timestamp,
+					message: `${this.name}.structuredOutputStream: response contained no content`,
+					code: "empty-response",
+					error: {
+						message: `${this.name}.structuredOutputStream: response contained no content`,
+						code: "empty-response"
+					}
+				};
+				return;
+			}
+			let parsed;
+			try {
+				parsed = JSON.parse(accumulatedContent);
+			} catch {
+				yield {
+					type: EventType.RUN_ERROR,
+					runId: aguiState.runId,
+					model,
+					timestamp,
+					message: `Failed to parse structured output as JSON. Content: ${accumulatedContent.slice(0, 200)}${accumulatedContent.length > 200 ? "..." : ""}`,
+					code: "parse-error",
+					error: {
+						message: "Failed to parse structured output as JSON",
+						code: "parse-error"
+					}
+				};
+				return;
+			}
+			const transformed = this.transformStructuredOutput(parsed);
+			yield {
+				type: EventType.CUSTOM,
+				name: "structured-output.complete",
+				value: {
+					object: transformed,
+					raw: accumulatedContent,
+					...accumulatedReasoning ? { reasoning: accumulatedReasoning } : {}
+				},
+				model,
+				timestamp
+			};
+			yield {
+				type: EventType.RUN_FINISHED,
+				runId: aguiState.runId,
+				threadId: aguiState.threadId,
+				model,
+				timestamp,
+				finishReason: "stop",
+				...usage && { usage: buildResponsesUsage(usage) }
+			};
+		} catch (error) {
+			if (!aguiState.hasEmittedRunStarted) {
+				aguiState.hasEmittedRunStarted = true;
+				yield {
+					type: EventType.RUN_STARTED,
+					runId: aguiState.runId,
+					threadId: aguiState.threadId,
+					model,
+					timestamp,
+					parentRunId: chatOptions.parentRunId
+				};
+			}
+			const isAbort = this.isAbortError(error);
+			const errorPayload = toRunErrorPayload(error, `${this.name}.structuredOutputStream failed`);
+			const resolvedCode = isAbort ? "aborted" : errorPayload.code;
+			const rawEvent = isAbort ? void 0 : toRunErrorRawEvent(error);
+			yield {
+				type: EventType.RUN_ERROR,
+				runId: aguiState.runId,
+				model,
+				timestamp,
+				message: errorPayload.message,
+				...resolvedCode !== void 0 && { code: resolvedCode },
+				...rawEvent !== void 0 && { rawEvent },
+				error: {
+					message: errorPayload.message,
+					...resolvedCode !== void 0 && { code: resolvedCode }
+				}
+			};
+			chatOptions.logger.errors(`${this.name}.structuredOutputStream fatal`, {
+				error: errorPayload,
+				source: `${this.name}.structuredOutputStream`
+			});
+		}
+	}
+	/**
+	* Cross-SDK abort detection for `structuredOutputStream`. Mirrors the
+	* Chat Completions base; subclasses with proprietary error types override.
+	*/
+	isAbortError(error) {
+		if (!error || typeof error !== "object") return false;
+		const e = error;
+		return e.name === "APIUserAbortError" || e.name === "AbortError" || e.code === "ERR_CANCELED";
+	}
+	/**
+	* Applies provider-specific transformations for structured output compatibility.
+	* Override this in subclasses to handle provider-specific quirks.
+	*/
+	makeStructuredOutputCompatible(schema, originalRequired) {
+		return makeStructuredOutputCompatible(schema, originalRequired);
+	}
+	/**
+	* Final shaping pass applied to parsed structured-output JSON before it is
+	* returned to the caller. Default is a passthrough.
+	*
+	* Provider `null`s are no longer stripped here: strict-mode null-widening is
+	* now undone precisely by the engine (`undoNullWidening`, driven by the
+	* schema's null-widening map) the moment the result is captured, so a blind
+	* `transformNullsToUndefined` at the adapter would only destroy genuine
+	* `.nullable()` nulls. Subclasses may still override to remap or reshape the
+	* provider's structured output.
+	*/
+	transformStructuredOutput(parsed) {
+		return parsed;
+	}
+	/**
+	* Extract text content from a non-streaming Responses API response.
+	* Override this in subclasses for provider-specific response shapes.
+	*/
+	extractTextFromResponse(response) {
+		let textContent = "";
+		let refusal;
+		let sawMessageItem = false;
+		const observedItemTypes = /* @__PURE__ */ new Set();
+		for (const item of response.output) {
+			observedItemTypes.add(item.type);
+			if (item.type === "message") {
+				sawMessageItem = true;
+				for (const part of item.content) {
+					const partType = part.type;
+					if (partType === "output_text") textContent += part.text ?? "";
+					else if (partType === "refusal") refusal = part.refusal || refusal || "Refused without explanation";
+					else throw new Error(`${this.name}.extractTextFromResponse: unsupported message content part type "${partType}"`);
+				}
+			}
+		}
+		if (!textContent && refusal !== void 0) {
+			const err = /* @__PURE__ */ new Error(`Model refused to respond: ${refusal}`);
+			err.code = "refusal";
+			throw err;
+		}
+		if (!textContent && response.output.length > 0 && !sawMessageItem) throw new Error(`${this.name}.extractTextFromResponse: response.output contained items of type(s) [${[...observedItemTypes].sort().join(", ")}] but no message text — the model returned a non-text response`);
+		return textContent;
+	}
+	/**
+	* Processes streamed chunks from the Responses API and yields AG-UI events.
+	* Override this in subclasses to handle provider-specific stream behavior.
+	*
+	* Handles the following event types:
+	* - response.created / response.incomplete / response.failed
+	* - response.output_text.delta
+	* - response.reasoning_text.delta
+	* - response.reasoning_summary_text.delta
+	* - response.content_part.added / response.content_part.done
+	* - response.output_item.added
+	* - response.function_call_arguments.delta / response.function_call_arguments.done
+	* - response.completed
+	* - error
+	*/
+	async *processStreamChunks(stream, toolCallMetadata, options, aguiState) {
+		let accumulatedContent = "";
+		let accumulatedReasoning = "";
+		let hasStreamedContentDeltas = false;
+		let hasStreamedReasoningDeltas = false;
+		let model = options.model;
+		let stepId = null;
+		let hasEmittedTextMessageStart = false;
+		let hasEmittedStepStarted = false;
+		let runFinishedEmitted = false;
+		try {
+			for await (const chunk of stream) {
+				options.logger.provider(`provider=${this.name} type=${chunk.type}`, {
+					provider: this.name,
+					type: chunk.type
+				});
+				if (!aguiState.hasEmittedRunStarted) {
+					aguiState.hasEmittedRunStarted = true;
+					yield {
+						type: EventType.RUN_STARTED,
+						runId: aguiState.runId,
+						threadId: aguiState.threadId,
+						model: model || options.model,
+						timestamp: Date.now(),
+						parentRunId: options.parentRunId
+					};
+				}
+				const handleContentPart = (contentPart) => {
+					if (contentPart.type === "output_text") {
+						accumulatedContent += contentPart.text || "";
+						return {
+							type: EventType.TEXT_MESSAGE_CONTENT,
+							messageId: aguiState.messageId,
+							model: model || options.model,
+							timestamp: Date.now(),
+							delta: contentPart.text || "",
+							content: accumulatedContent
+						};
+					}
+					if (contentPart.type === "reasoning_text") {
+						accumulatedReasoning += contentPart.text || "";
+						if (!stepId) stepId = generateId(this.name);
+						return {
+							type: EventType.STEP_FINISHED,
+							stepName: stepId,
+							stepId,
+							model: model || options.model,
+							timestamp: Date.now(),
+							delta: contentPart.text || "",
+							content: accumulatedReasoning
+						};
+					}
+					const isRefusal = contentPart.type === "refusal";
+					const message = isRefusal ? contentPart.refusal || "Refused without explanation" : `Unsupported response content_part type: ${contentPart.type}`;
+					const code = isRefusal ? "refusal" : contentPart.type;
+					return {
+						type: EventType.RUN_ERROR,
+						model: model || options.model,
+						timestamp: Date.now(),
+						message,
+						code,
+						error: {
+							message,
+							code
+						}
+					};
+				};
+				if (chunk.type === "response.created" || chunk.type === "response.incomplete" || chunk.type === "response.failed") model = chunk.response.model;
+				if (chunk.type === "response.created") {
+					hasStreamedContentDeltas = false;
+					hasStreamedReasoningDeltas = false;
+					hasEmittedTextMessageStart = false;
+					hasEmittedStepStarted = false;
+					accumulatedContent = "";
+					accumulatedReasoning = "";
+				}
+				if (chunk.type === "response.failed" || chunk.type === "response.incomplete") {
+					if (hasEmittedTextMessageStart) {
+						yield {
+							type: EventType.TEXT_MESSAGE_END,
+							messageId: aguiState.messageId,
+							model: chunk.response.model,
+							timestamp: Date.now()
+						};
+						hasEmittedTextMessageStart = false;
+					}
+					const errorMessage = chunk.response.error?.message || chunk.response.incomplete_details?.reason || (chunk.type === "response.failed" ? "Response failed" : "Response ended incomplete");
+					const errorCode = chunk.response.error?.code ?? (chunk.response.incomplete_details ? "incomplete" : void 0) ?? void 0;
+					yield {
+						type: EventType.RUN_ERROR,
+						model: chunk.response.model,
+						timestamp: Date.now(),
+						message: errorMessage,
+						...errorCode !== void 0 && { code: errorCode },
+						error: {
+							message: errorMessage,
+							...errorCode !== void 0 && { code: errorCode }
+						}
+					};
+					runFinishedEmitted = true;
+					return;
+				}
+				if (chunk.type === "response.output_text.delta" && chunk.delta) {
+					const textDelta = Array.isArray(chunk.delta) ? chunk.delta.join("") : typeof chunk.delta === "string" ? chunk.delta : "";
+					if (textDelta) {
+						if (!hasEmittedTextMessageStart) {
+							hasEmittedTextMessageStart = true;
+							yield {
+								type: EventType.TEXT_MESSAGE_START,
+								messageId: aguiState.messageId,
+								model: model || options.model,
+								timestamp: Date.now(),
+								role: "assistant"
+							};
+						}
+						accumulatedContent += textDelta;
+						hasStreamedContentDeltas = true;
+						yield {
+							type: EventType.TEXT_MESSAGE_CONTENT,
+							messageId: aguiState.messageId,
+							model: model || options.model,
+							timestamp: Date.now(),
+							delta: textDelta,
+							content: accumulatedContent
+						};
+					}
+				}
+				if (chunk.type === "response.reasoning_text.delta" && chunk.delta) {
+					const reasoningDelta = Array.isArray(chunk.delta) ? chunk.delta.join("") : typeof chunk.delta === "string" ? chunk.delta : "";
+					if (reasoningDelta) {
+						if (!hasEmittedStepStarted) {
+							hasEmittedStepStarted = true;
+							stepId = generateId(this.name);
+							yield {
+								type: EventType.STEP_STARTED,
+								stepName: stepId,
+								stepId,
+								model: model || options.model,
+								timestamp: Date.now(),
+								stepType: "thinking"
+							};
+						}
+						accumulatedReasoning += reasoningDelta;
+						hasStreamedReasoningDeltas = true;
+						const fallbackStepId = stepId || generateId(this.name);
+						yield {
+							type: EventType.STEP_FINISHED,
+							stepName: fallbackStepId,
+							stepId: fallbackStepId,
+							model: model || options.model,
+							timestamp: Date.now(),
+							delta: reasoningDelta,
+							content: accumulatedReasoning
+						};
+					}
+				}
+				if (chunk.type === "response.reasoning_summary_text.delta" && chunk.delta) {
+					const summaryDelta = typeof chunk.delta === "string" ? chunk.delta : "";
+					if (summaryDelta) {
+						if (!hasEmittedStepStarted) {
+							hasEmittedStepStarted = true;
+							stepId = generateId(this.name);
+							yield {
+								type: EventType.STEP_STARTED,
+								stepName: stepId,
+								stepId,
+								model: model || options.model,
+								timestamp: Date.now(),
+								stepType: "thinking"
+							};
+						}
+						accumulatedReasoning += summaryDelta;
+						hasStreamedReasoningDeltas = true;
+						const fallbackStepId = stepId || generateId(this.name);
+						yield {
+							type: EventType.STEP_FINISHED,
+							stepName: fallbackStepId,
+							stepId: fallbackStepId,
+							model: model || options.model,
+							timestamp: Date.now(),
+							delta: summaryDelta,
+							content: accumulatedReasoning
+						};
+					}
+				}
+				if (chunk.type === "response.content_part.added") {
+					const contentPart = chunk.part;
+					if (contentPart.type === "output_text" && !hasEmittedTextMessageStart) {
+						hasEmittedTextMessageStart = true;
+						yield {
+							type: EventType.TEXT_MESSAGE_START,
+							messageId: aguiState.messageId,
+							model: model || options.model,
+							timestamp: Date.now(),
+							role: "assistant"
+						};
+					}
+					if (contentPart.type === "reasoning_text" && !hasEmittedStepStarted) {
+						hasEmittedStepStarted = true;
+						stepId = generateId(this.name);
+						yield {
+							type: EventType.STEP_STARTED,
+							stepName: stepId,
+							stepId,
+							model: model || options.model,
+							timestamp: Date.now(),
+							stepType: "thinking"
+						};
+					}
+					if (contentPart.type === "output_text") hasStreamedContentDeltas = true;
+					else if (contentPart.type === "reasoning_text") hasStreamedReasoningDeltas = true;
+					const partChunk = handleContentPart(contentPart);
+					yield partChunk;
+					if (partChunk.type === "RUN_ERROR") {
+						runFinishedEmitted = true;
+						return;
+					}
+				}
+				if (chunk.type === "response.content_part.done") {
+					const contentPart = chunk.part;
+					if (contentPart.type === "output_text" && hasStreamedContentDeltas) continue;
+					if (contentPart.type === "reasoning_text" && hasStreamedReasoningDeltas) continue;
+					if (contentPart.type === "output_text" && !hasEmittedTextMessageStart) {
+						hasEmittedTextMessageStart = true;
+						yield {
+							type: EventType.TEXT_MESSAGE_START,
+							messageId: aguiState.messageId,
+							model: model || options.model,
+							timestamp: Date.now(),
+							role: "assistant"
+						};
+					} else if (contentPart.type === "reasoning_text" && !hasEmittedStepStarted) {
+						hasEmittedStepStarted = true;
+						stepId = generateId(this.name);
+						yield {
+							type: EventType.STEP_STARTED,
+							stepName: stepId,
+							stepId,
+							model: model || options.model,
+							timestamp: Date.now(),
+							stepType: "thinking"
+						};
+					}
+					const doneChunk = handleContentPart(contentPart);
+					yield doneChunk;
+					if (doneChunk.type === "RUN_ERROR") {
+						runFinishedEmitted = true;
+						return;
+					}
+				}
+				if (chunk.type === "response.output_item.added") {
+					const item = chunk.item;
+					if (item.type === "function_call" && item.id) {
+						let metadata = toolCallMetadata.get(item.id);
+						if (!metadata) {
+							metadata = {
+								index: chunk.output_index,
+								name: item.name || "",
+								started: false
+							};
+							toolCallMetadata.set(item.id, metadata);
+						} else if (!metadata.name && item.name) metadata.name = item.name;
+						if (!metadata.started && metadata.name) {
+							yield {
+								type: EventType.TOOL_CALL_START,
+								toolCallId: item.id,
+								toolCallName: metadata.name,
+								toolName: metadata.name,
+								parentMessageId: aguiState.messageId,
+								model: model || options.model,
+								timestamp: Date.now(),
+								index: chunk.output_index
+							};
+							metadata.started = true;
+						}
+					}
+				}
+				if (chunk.type === "response.function_call_arguments.delta" && chunk.delta) {
+					if (!toolCallMetadata.get(chunk.item_id)?.started) {
+						options.logger.errors(`${this.name}.processStreamChunks orphan function_call_arguments.delta`, {
+							source: `${this.name}.processStreamChunks`,
+							toolCallId: chunk.item_id,
+							rawDelta: chunk.delta
+						});
+						continue;
+					}
+					yield {
+						type: EventType.TOOL_CALL_ARGS,
+						toolCallId: chunk.item_id,
+						model: model || options.model,
+						timestamp: Date.now(),
+						delta: chunk.delta
+					};
+				}
+				if (chunk.type === "response.function_call_arguments.done") {
+					const { item_id } = chunk;
+					const metadata = toolCallMetadata.get(item_id);
+					if (!metadata?.started) {
+						if (metadata) metadata.pendingArguments = chunk.arguments;
+						options.logger.errors(`${this.name}.processStreamChunks deferring function_call_arguments.done — TOOL_CALL_START not yet emitted (waiting for name)`, {
+							source: `${this.name}.processStreamChunks`,
+							toolCallId: item_id,
+							rawArguments: chunk.arguments
+						});
+						continue;
+					}
+					if (metadata.ended) continue;
+					const name = metadata.name || "";
+					metadata.ended = true;
+					let parsedInput = {};
+					if (chunk.arguments) try {
+						const parsed = JSON.parse(chunk.arguments);
+						parsedInput = parsed && typeof parsed === "object" ? parsed : {};
+					} catch (parseError) {
+						options.logger.errors(`${this.name}.processStreamChunks tool-args JSON parse failed`, {
+							error: toRunErrorPayload(parseError, `tool ${name} (${item_id}) returned malformed JSON arguments`),
+							source: `${this.name}.processStreamChunks`,
+							toolCallId: item_id,
+							toolName: name,
+							rawArguments: chunk.arguments
+						});
+						parsedInput = {};
+					}
+					yield {
+						type: EventType.TOOL_CALL_END,
+						toolCallId: item_id,
+						toolCallName: name,
+						toolName: name,
+						model: model || options.model,
+						timestamp: Date.now(),
+						input: parsedInput
+					};
+				}
+				if (chunk.type === "response.output_item.done") {
+					const item = chunk.item;
+					if (item.type === "function_call" && item.id) {
+						const metadata = toolCallMetadata.get(item.id) ?? {
+							index: chunk.output_index,
+							name: item.name || "",
+							started: false
+						};
+						if (!toolCallMetadata.has(item.id)) toolCallMetadata.set(item.id, metadata);
+						else if (!metadata.name && item.name) metadata.name = item.name;
+						if (!metadata.started && metadata.name) {
+							yield {
+								type: EventType.TOOL_CALL_START,
+								toolCallId: item.id,
+								toolCallName: metadata.name,
+								toolName: metadata.name,
+								parentMessageId: aguiState.messageId,
+								model: model || options.model,
+								timestamp: Date.now(),
+								index: metadata.index
+							};
+							metadata.started = true;
+						}
+						const rawArgs = typeof item.arguments === "string" && item.arguments.length > 0 ? item.arguments : metadata.pendingArguments;
+						if (metadata.started && !metadata.ended && rawArgs !== void 0) {
+							const name = metadata.name || "";
+							let parsedInput = {};
+							if (rawArgs) try {
+								const parsed = JSON.parse(rawArgs);
+								parsedInput = parsed && typeof parsed === "object" ? parsed : {};
+							} catch (parseError) {
+								options.logger.errors(`${this.name}.processStreamChunks tool-args JSON parse failed (output_item.done backfill)`, {
+									error: toRunErrorPayload(parseError, `tool ${name} (${item.id}) returned malformed JSON arguments`),
+									source: `${this.name}.processStreamChunks`,
+									toolCallId: item.id,
+									toolName: name,
+									rawArguments: rawArgs
+								});
+								parsedInput = {};
+							}
+							yield {
+								type: EventType.TOOL_CALL_END,
+								toolCallId: item.id,
+								toolCallName: name,
+								toolName: name,
+								model: model || options.model,
+								timestamp: Date.now(),
+								input: parsedInput
+							};
+							metadata.ended = true;
+							metadata.pendingArguments = void 0;
+						}
+					}
+				}
+				if (chunk.type === "response.completed") {
+					for (const item of chunk.response.output) {
+						if (item.type !== "function_call" || !item.id) continue;
+						const metadata = toolCallMetadata.get(item.id) ?? {
+							index: 0,
+							name: item.name || "",
+							started: false
+						};
+						if (!toolCallMetadata.has(item.id)) toolCallMetadata.set(item.id, metadata);
+						else if (!metadata.name && item.name) metadata.name = item.name;
+						if (!metadata.started && metadata.name) {
+							yield {
+								type: EventType.TOOL_CALL_START,
+								toolCallId: item.id,
+								toolCallName: metadata.name,
+								toolName: metadata.name,
+								parentMessageId: aguiState.messageId,
+								model: model || options.model,
+								timestamp: Date.now(),
+								index: metadata.index
+							};
+							metadata.started = true;
+						}
+						const rawArgs = typeof item.arguments === "string" && item.arguments.length > 0 ? item.arguments : metadata.pendingArguments;
+						if (metadata.started && !metadata.ended) {
+							const name = metadata.name || "";
+							let parsedInput = {};
+							if (rawArgs) try {
+								const parsed = JSON.parse(rawArgs);
+								parsedInput = parsed && typeof parsed === "object" ? parsed : {};
+							} catch (parseError) {
+								options.logger.errors(`${this.name}.processStreamChunks tool-args JSON parse failed (response.completed backfill)`, {
+									error: toRunErrorPayload(parseError, `tool ${name} (${item.id}) returned malformed JSON arguments`),
+									source: `${this.name}.processStreamChunks`,
+									toolCallId: item.id,
+									toolName: name,
+									rawArguments: rawArgs
+								});
+								parsedInput = {};
+							}
+							yield {
+								type: EventType.TOOL_CALL_END,
+								toolCallId: item.id,
+								toolCallName: name,
+								toolName: name,
+								model: model || options.model,
+								timestamp: Date.now(),
+								input: parsedInput
+							};
+							metadata.ended = true;
+							metadata.pendingArguments = void 0;
+						}
+					}
+					if (hasEmittedTextMessageStart) {
+						yield {
+							type: EventType.TEXT_MESSAGE_END,
+							messageId: aguiState.messageId,
+							model: model || options.model,
+							timestamp: Date.now()
+						};
+						hasEmittedTextMessageStart = false;
+					}
+					const hasFunctionCalls = chunk.response.output.some((item) => item.type === "function_call");
+					const incompleteReason = chunk.response.incomplete_details?.reason;
+					const finishReason = hasFunctionCalls ? "tool_calls" : incompleteReason === "max_output_tokens" ? "length" : incompleteReason === "content_filter" ? "content_filter" : "stop";
+					yield {
+						type: EventType.RUN_FINISHED,
+						runId: aguiState.runId,
+						threadId: aguiState.threadId,
+						model: model || options.model,
+						timestamp: Date.now(),
+						...chunk.response.usage && { usage: buildResponsesUsage(chunk.response.usage) },
+						finishReason
+					};
+					runFinishedEmitted = true;
+				}
+				if (chunk.type === "error") {
+					const code = chunk.code ?? void 0;
+					yield {
+						type: EventType.RUN_ERROR,
+						model: model || options.model,
+						timestamp: Date.now(),
+						message: chunk.message,
+						...code !== void 0 && { code },
+						error: {
+							message: chunk.message,
+							...code !== void 0 && { code }
+						}
+					};
+					runFinishedEmitted = true;
+					return;
+				}
+			}
+			if (!runFinishedEmitted && aguiState.hasEmittedRunStarted) {
+				if (hasEmittedTextMessageStart) yield {
+					type: EventType.TEXT_MESSAGE_END,
+					messageId: aguiState.messageId,
+					model: model || options.model,
+					timestamp: Date.now()
+				};
+				yield {
+					type: EventType.RUN_FINISHED,
+					runId: aguiState.runId,
+					threadId: aguiState.threadId,
+					model: model || options.model,
+					timestamp: Date.now(),
+					finishReason: toolCallMetadata.size > 0 ? "tool_calls" : "stop"
+				};
+			}
+		} catch (error) {
+			const errorPayload = toRunErrorPayload(error, `${this.name}.processStreamChunks failed`);
+			const rawEvent = toRunErrorRawEvent(error);
+			options.logger.errors(`${this.name}.processStreamChunks fatal`, {
+				error: errorPayload,
+				source: `${this.name}.processStreamChunks`
+			});
+			yield {
+				type: EventType.RUN_ERROR,
+				model: options.model,
+				timestamp: Date.now(),
+				message: errorPayload.message,
+				...errorPayload.code !== void 0 && { code: errorPayload.code },
+				...rawEvent !== void 0 && { rawEvent },
+				error: {
+					message: errorPayload.message,
+					...errorPayload.code !== void 0 && { code: errorPayload.code }
+				}
+			};
+		}
+	}
+	/**
+	* Maps common TextOptions to Responses API request format.
+	* Override this in subclasses to add provider-specific options.
+	*/
+	mapOptionsToRequest(options) {
+		const input = this.convertMessagesToInput(options.messages);
+		const tools = options.tools ? convertToolsToResponsesFormat(options.tools, this.makeStructuredOutputCompatible.bind(this)) : void 0;
+		const modelOptions = options.modelOptions;
+		const combinedSchema = options.outputSchema;
+		const textFormat = combinedSchema ? { text: { format: {
+			type: "json_schema",
+			name: "structured_output",
+			schema: this.makeStructuredOutputCompatible(combinedSchema, Array.isArray(combinedSchema.required) ? combinedSchema.required : void 0),
+			strict: true
+		} } } : void 0;
+		return {
+			...modelOptions,
+			model: options.model,
+			...options.metadata !== void 0 && { metadata: options.metadata },
+			...(() => {
+				const prompts = normalizeSystemPrompts(options.systemPrompts);
+				if (prompts.length === 0) return {};
+				return { instructions: prompts.map((p) => p.content).join("\n") };
+			})(),
+			input,
+			...tools && tools.length > 0 && { tools },
+			...textFormat ?? {}
+		};
+	}
+	/**
+	* The OpenAI Responses API supports `tools` and `text.format: json_schema`
+	* together in a single streaming request (per issue #605). Subclasses
+	* that route to providers without this capability should override.
+	*/
+	supportsCombinedToolsAndSchema() {
+		return true;
+	}
+	/**
+	* Converts ModelMessage[] to Responses API ResponseInput format.
+	* Override this in subclasses for provider-specific message format quirks.
+	*
+	* Key differences from Chat Completions:
+	* - Tool results use `function_call_output` type (not `tool` role)
+	* - Assistant tool calls are `function_call` objects (not nested in `tool_calls`)
+	* - User content uses `input_text`, `input_image`, `input_file` types
+	* - System prompts go in `instructions`, not as messages
+	*/
+	convertMessagesToInput(messages) {
+		const result = [];
+		for (const message of messages) {
+			if (message.role === "tool") {
+				const toolContent = message.content;
+				const output = Array.isArray(toolContent) ? toolContent.map((part) => this.convertContentPartToInput(part)) : typeof toolContent === "string" ? toolContent : JSON.stringify(toolContent);
+				result.push({
+					type: "function_call_output",
+					call_id: message.toolCallId || "",
+					output
+				});
+				continue;
+			}
+			if (message.role === "assistant") {
+				if (message.toolCalls && message.toolCalls.length > 0) for (const toolCall of message.toolCalls) {
+					const argumentsString = typeof toolCall.function.arguments === "string" ? toolCall.function.arguments : JSON.stringify(toolCall.function.arguments);
+					result.push({
+						type: "function_call",
+						call_id: toolCall.id,
+						name: toolCall.function.name,
+						arguments: argumentsString
+					});
+				}
+				if (message.content) {
+					const contentStr = this.extractTextContent(message.content);
+					if (contentStr) result.push({
+						type: "message",
+						role: "assistant",
+						content: contentStr
+					});
+				}
+				continue;
+			}
+			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.`);
+			result.push({
+				type: "message",
+				role: "user",
+				content: inputContent
+			});
+		}
+		return result;
+	}
+	/**
+	* Converts a ContentPart to Responses API input content item.
+	* Handles text, image, and audio content parts.
+	* Override this in subclasses for additional content types or provider-specific metadata.
+	*/
+	convertContentPartToInput(part) {
+		switch (part.type) {
+			case "text": return {
+				type: "input_text",
+				text: part.content
+			};
+			case "image": {
+				const imageMetadata = part.metadata;
+				if (part.source.type === "url") return {
+					type: "input_image",
+					image_url: part.source.value,
+					detail: imageMetadata?.detail || "auto"
+				};
+				const imageValue = part.source.value;
+				const imageMime = part.source.mimeType || "application/octet-stream";
+				return {
+					type: "input_image",
+					image_url: imageValue.startsWith("data:") ? imageValue : `data:${imageMime};base64,${imageValue}`,
+					detail: imageMetadata?.detail || "auto"
+				};
+			}
+			case "audio": {
+				if (part.source.type === "url") return {
+					type: "input_file",
+					file_url: part.source.value
+				};
+				const audioValue = part.source.value;
+				const audioMime = part.source.mimeType || "application/octet-stream";
+				return {
+					type: "input_file",
+					file_data: audioValue.startsWith("data:") ? audioValue : `data:${audioMime};base64,${audioValue}`
+				};
+			}
+			default: throw new Error(`Unsupported content part type: ${part.type}`);
+		}
+	}
+	/**
+	* Normalizes message content to an array of ContentPart.
+	* Handles backward compatibility with string content.
+	*/
+	normalizeContent(content) {
+		if (content === null) return [];
+		if (typeof content === "string") return [{
+			type: "text",
+			content
+		}];
+		return content;
+	}
+	/**
+	* Extracts text content from a content value that may be string, null, or ContentPart array.
+	*/
+	extractTextContent(content) {
+		if (content === null) return "";
+		if (typeof content === "string") return content;
+		return content.filter((p) => p.type === "text").map((p) => p.content).join("");
+	}
 };
-//# sourceMappingURL=responses-text.js.map
+//#endregion
+export { OpenAIBaseResponsesTextAdapter };
+
+//# sourceMappingURL=responses-text.js.map