@ai-sdk/open-responses 2.0.27 → 2.0.29

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @ai-sdk/open-responses
 
+## 2.0.29
+
+### Patch Changes
+
+- Updated dependencies [e6087c9]
+  - @ai-sdk/provider-utils@5.0.28
+
+## 2.0.28
+
+### Patch Changes
+
+- 3b9f025: Add a provider-native `reasoningEffort` option for Open Responses endpoints.
+- 1c1a9d1: Preserve Open Responses output item order, text annotations, reasoning state, and reasoning part boundaries when replaying manually managed history.
+- 6fe187f: fix(open-responses): close unfinished reasoning stream parts with their original IDs
+- 1d0bdaa: Warn when provider-defined tools are unsupported instead of silently dropping them.
+
 ## 2.0.27
 
 ### Patch Changes

package/dist/index.d.ts

@@ -33,6 +33,7 @@ interface OpenResponsesProviderSettings {
 declare function createOpenResponses(options: OpenResponsesProviderSettings): OpenResponsesProvider;
 
 declare const openResponsesLanguageModelOptions: _ai_sdk_provider_utils.LazySchema<{
+    reasoningEffort?: string | null | undefined;
     reasoningSummary?: "auto" | "concise" | "detailed" | null | undefined;
 }>;
 type OpenResponsesLanguageModelOptions = InferSchema<typeof openResponsesLanguageModelOptions>;

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/version.ts
-var VERSION = true ? "2.0.27" : "0.0.0-test";
+var VERSION = true ? "2.0.29" : "0.0.0-test";
 
 // src/open-responses-provider.ts
 import {
@@ -40,9 +40,10 @@ import {
   resolveFullMediaType
 } from "@ai-sdk/provider-utils";
 async function convertToOpenResponsesInput({
-  prompt
+  prompt,
+  providerOptionsName = "open-responses"
 }) {
-  var _a, _b, _c;
+  var _a, _b, _c, _d;
   const input = [];
   const warnings = [];
   const systemMessages = [];
@@ -106,27 +107,89 @@ async function convertToOpenResponsesInput({
         break;
       }
       case "assistant": {
-        const assistantContent = [];
-        const reasoningItems = [];
-        const toolCalls = [];
+        let assistantContent = [];
+        let assistantMessageId;
+        const flushAssistantContent = () => {
+          if (assistantContent.length === 0) {
+            return;
+          }
+          input.push({
+            type: "message",
+            role: "assistant",
+            content: assistantContent,
+            ...assistantMessageId != null && { id: assistantMessageId }
+          });
+          assistantContent = [];
+          assistantMessageId = void 0;
+        };
         for (const part of content) {
           switch (part.type) {
             case "reasoning": {
-              reasoningItems.push({
+              flushAssistantContent();
+              const providerData = getProviderData(part, providerOptionsName);
+              const itemId = typeof (providerData == null ? void 0 : providerData.itemId) === "string" ? providerData.itemId : void 0;
+              const summary = parseReasoningSummary(
+                providerData == null ? void 0 : providerData.reasoningSummary
+              );
+              const reasoningContent = parseReasoningContent(
+                providerData == null ? void 0 : providerData.reasoningContent
+              );
+              const hasReasoningContent = providerData != null && "reasoningContent" in providerData;
+              const encryptedContent = typeof (providerData == null ? void 0 : providerData.reasoningEncryptedContent) === "string" ? providerData.reasoningEncryptedContent : void 0;
+              const reasoningItem = {
                 type: "reasoning",
-                summary: [],
-                content: [{ type: "reasoning_text", text: part.text }]
-              });
+                summary: summary != null ? summary : [],
+                ...itemId != null && { id: itemId },
+                ...reasoningContent != null ? { content: reasoningContent } : !hasReasoningContent && part.text.length > 0 ? {
+                  content: [
+                    {
+                      type: "reasoning_text",
+                      text: part.text
+                    }
+                  ]
+                } : {},
+                ...encryptedContent != null && {
+                  encrypted_content: encryptedContent
+                }
+              };
+              const previousItem = input[input.length - 1];
+              if (reasoningItem.id != null && (previousItem == null ? void 0 : previousItem.type) === "reasoning" && previousItem.id === reasoningItem.id) {
+                if (reasoningItem.content != null) {
+                  previousItem.content = [
+                    ...(_b = previousItem.content) != null ? _b : [],
+                    ...reasoningItem.content
+                  ];
+                }
+              } else {
+                input.push(reasoningItem);
+              }
               break;
             }
             case "text": {
-              assistantContent.push({ type: "output_text", text: part.text });
+              const providerData = getProviderData(part, providerOptionsName);
+              const itemId = typeof (providerData == null ? void 0 : providerData.itemId) === "string" ? providerData.itemId : void 0;
+              const annotations = parseOutputTextAnnotations(
+                providerData == null ? void 0 : providerData.annotations
+              );
+              if (assistantContent.length > 0 && assistantMessageId !== itemId) {
+                flushAssistantContent();
+              }
+              assistantMessageId = itemId;
+              assistantContent.push({
+                type: "output_text",
+                text: part.text,
+                ...annotations != null && { annotations }
+              });
               break;
             }
             case "tool-call": {
+              flushAssistantContent();
               const argumentsValue = typeof part.input === "string" ? part.input : JSON.stringify(part.input);
-              toolCalls.push({
+              const providerData = getProviderData(part, providerOptionsName);
+              const itemId = typeof (providerData == null ? void 0 : providerData.itemId) === "string" ? providerData.itemId : void 0;
+              input.push({
                 type: "function_call",
+                ...itemId != null && { id: itemId },
                 call_id: part.toolCallId,
                 name: part.toolName,
                 arguments: argumentsValue
@@ -135,19 +198,7 @@ async function convertToOpenResponsesInput({
             }
           }
         }
-        for (const reasoningItem of reasoningItems) {
-          input.push(reasoningItem);
-        }
-        if (assistantContent.length > 0) {
-          input.push({
-            type: "message",
-            role: "assistant",
-            content: assistantContent
-          });
-        }
-        for (const toolCall of toolCalls) {
-          input.push(toolCall);
-        }
+        flushAssistantContent();
         break;
       }
       case "tool": {
@@ -161,7 +212,7 @@ async function convertToOpenResponsesInput({
                 contentValue = output.value;
                 break;
               case "execution-denied":
-                contentValue = (_b = output.reason) != null ? _b : "Tool call execution denied.";
+                contentValue = (_c = output.reason) != null ? _c : "Tool call execution denied.";
                 break;
               case "json":
               case "error-json":
@@ -192,7 +243,7 @@ async function convertToOpenResponsesInput({
                         } else {
                           contentParts.push({
                             type: "input_file",
-                            filename: (_c = item.filename) != null ? _c : "data",
+                            filename: (_d = item.filename) != null ? _d : "data",
                             file_data: `data:${fullMediaType};base64,${convertToBase64(item.data.data)}`
                           });
                         }
@@ -246,6 +297,47 @@ async function convertToOpenResponsesInput({
     warnings
   };
 }
+function getProviderData(part, providerOptionsName) {
+  var _a, _b, _c;
+  const providerData = (_c = (_a = part.providerOptions) == null ? void 0 : _a[providerOptionsName]) != null ? _c : (_b = part.providerMetadata) == null ? void 0 : _b[providerOptionsName];
+  return providerData != null && typeof providerData === "object" && !Array.isArray(providerData) ? providerData : void 0;
+}
+function parseReasoningSummary(value) {
+  if (!Array.isArray(value) || !value.every(
+    (part) => part != null && typeof part === "object" && part.type === "summary_text" && typeof part.text === "string"
+  )) {
+    return void 0;
+  }
+  return value.map((part) => ({
+    type: "summary_text",
+    text: part.text
+  }));
+}
+function parseReasoningContent(value) {
+  if (!Array.isArray(value) || !value.every(
+    (part) => part != null && typeof part === "object" && part.type === "reasoning_text" && typeof part.text === "string"
+  )) {
+    return void 0;
+  }
+  return value.map((part) => ({
+    type: "reasoning_text",
+    text: part.text
+  }));
+}
+function parseOutputTextAnnotations(value) {
+  if (!Array.isArray(value) || !value.every(
+    (annotation) => annotation != null && typeof annotation === "object" && annotation.type === "url_citation" && typeof annotation.start_index === "number" && typeof annotation.end_index === "number" && typeof annotation.url === "string" && typeof annotation.title === "string"
+  )) {
+    return void 0;
+  }
+  return value.map((annotation) => ({
+    type: "url_citation",
+    start_index: annotation.start_index,
+    end_index: annotation.end_index,
+    url: annotation.url,
+    title: annotation.title
+  }));
+}
 
 // src/responses/open-responses-api.ts
 import { lazySchema, zodSchema } from "@ai-sdk/provider-utils";
@@ -290,6 +382,11 @@ import { z as z2 } from "zod/v4";
 var openResponsesLanguageModelOptions = lazySchema2(
   () => zodSchema2(
     z2.object({
+      /**
+       * Provider-native reasoning effort. The value is passed through to the
+       * endpoint and takes precedence over the top-level `reasoning` setting.
+       */
+      reasoningEffort: z2.string().nullish(),
       /**
        * Controls reasoning summary output from the model.
        * Valid values: 'concise', 'detailed', 'auto'.
@@ -337,7 +434,7 @@ var OpenResponsesLanguageModel = class _OpenResponsesLanguageModel {
     toolChoice,
     responseFormat
   }) {
-    var _a;
+    var _a, _b;
     const warnings = [];
     if (stopSequences != null) {
       warnings.push({ type: "unsupported", feature: "stopSequences" });
@@ -353,16 +450,27 @@ var OpenResponsesLanguageModel = class _OpenResponsesLanguageModel {
       instructions,
       warnings: inputWarnings
     } = await convertToOpenResponsesInput({
-      prompt
+      prompt,
+      providerOptionsName: this.config.providerOptionsName
     });
     warnings.push(...inputWarnings);
-    const functionTools = tools == null ? void 0 : tools.filter((tool) => tool.type === "function").map((tool) => ({
-      type: "function",
-      name: tool.name,
-      description: tool.description,
-      parameters: tool.inputSchema,
-      ...tool.strict != null ? { strict: tool.strict } : {}
-    }));
+    const functionTools = [];
+    for (const tool of tools != null ? tools : []) {
+      if (tool.type === "provider") {
+        warnings.push({
+          type: "unsupported",
+          feature: `provider-defined tool ${tool.id}`
+        });
+      } else {
+        functionTools.push({
+          type: "function",
+          name: tool.name,
+          description: tool.description,
+          parameters: tool.inputSchema,
+          ...tool.strict != null ? { strict: tool.strict } : {}
+        });
+      }
+    }
     const convertedToolChoice = toolChoice == null ? void 0 : toolChoice.type === "tool" ? { type: "function", name: toolChoice.toolName } : toolChoice.type;
     const textFormat = (responseFormat == null ? void 0 : responseFormat.type) === "json" ? {
       type: "json_schema",
@@ -378,7 +486,7 @@ var OpenResponsesLanguageModel = class _OpenResponsesLanguageModel {
       providerOptions,
       schema: openResponsesLanguageModelOptions
     });
-    const resolvedReasoningEffort = isCustomReasoning(reasoning) ? reasoning === "none" ? "none" : mapReasoningToProviderEffort({
+    const resolvedReasoningEffort = (_b = openResponsesOptions == null ? void 0 : openResponsesOptions.reasoningEffort) != null ? _b : isCustomReasoning(reasoning) ? reasoning === "none" ? "none" : mapReasoningToProviderEffort({
       reasoning,
       effortMap: {
         minimal: "low",
@@ -407,7 +515,7 @@ var OpenResponsesLanguageModel = class _OpenResponsesLanguageModel {
             summary: openResponsesOptions.reasoningSummary
           }
         } : void 0,
-        tools: (functionTools == null ? void 0 : functionTools.length) ? functionTools : void 0,
+        tools: functionTools.length ? functionTools : void 0,
         tool_choice: convertedToolChoice,
         ...textFormat != null && { text: { format: textFormat } }
       },
@@ -415,7 +523,7 @@ var OpenResponsesLanguageModel = class _OpenResponsesLanguageModel {
     };
   }
   async doGenerate(options) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
     const { body, warnings } = await this.getArgs(options);
     const {
       responseHeaders,
@@ -467,19 +575,42 @@ var OpenResponsesLanguageModel = class _OpenResponsesLanguageModel {
       switch (part.type) {
         // TODO AI SDK 7 adjust reasoning in the specification to better support the reasoning structure from open responses.
         case "reasoning": {
-          for (const contentPart of (_e = part.content) != null ? _e : []) {
+          if (((_f = (_e = part.content) == null ? void 0 : _e.length) != null ? _f : 0) > 0) {
+            for (const contentPart of part.content) {
+              content.push({
+                type: "reasoning",
+                text: contentPart.text,
+                providerMetadata: createReasoningProviderMetadata({
+                  part,
+                  providerOptionsName: this.config.providerOptionsName,
+                  reasoningContent: [contentPart]
+                })
+              });
+            }
+          } else {
             content.push({
               type: "reasoning",
-              text: contentPart.text
+              text: part.summary.map((summaryPart) => summaryPart.text).join(""),
+              providerMetadata: createReasoningProviderMetadata({
+                part,
+                providerOptionsName: this.config.providerOptionsName
+              })
             });
           }
           break;
         }
         case "message": {
           for (const contentPart of part.content) {
+            const annotations = getOutputTextAnnotations(contentPart);
             content.push({
               type: "text",
-              text: contentPart.text
+              text: contentPart.text,
+              providerMetadata: {
+                [this.config.providerOptionsName]: {
+                  itemId: part.id,
+                  ...annotations.length > 0 && { annotations }
+                }
+              }
             });
           }
           break;
@@ -490,7 +621,10 @@ var OpenResponsesLanguageModel = class _OpenResponsesLanguageModel {
             type: "tool-call",
             toolCallId: part.call_id,
             toolName: part.name,
-            input: part.arguments
+            input: part.arguments,
+            providerMetadata: {
+              [this.config.providerOptionsName]: { itemId: part.id }
+            }
           });
           break;
         }
@@ -498,17 +632,17 @@ var OpenResponsesLanguageModel = class _OpenResponsesLanguageModel {
     }
     const usage = response.usage;
     const inputTokens = usage == null ? void 0 : usage.input_tokens;
-    const cachedInputTokens = (_f = usage == null ? void 0 : usage.input_tokens_details) == null ? void 0 : _f.cached_tokens;
+    const cachedInputTokens = (_g = usage == null ? void 0 : usage.input_tokens_details) == null ? void 0 : _g.cached_tokens;
     const outputTokens = usage == null ? void 0 : usage.output_tokens;
-    const reasoningTokens = (_g = usage == null ? void 0 : usage.output_tokens_details) == null ? void 0 : _g.reasoning_tokens;
+    const reasoningTokens = (_h = usage == null ? void 0 : usage.output_tokens_details) == null ? void 0 : _h.reasoning_tokens;
     return {
       content,
       finishReason: {
         unified: mapOpenResponsesFinishReason({
-          finishReason: (_h = response.incomplete_details) == null ? void 0 : _h.reason,
+          finishReason: (_i = response.incomplete_details) == null ? void 0 : _i.reason,
           hasToolCalls
         }),
-        raw: (_j = (_i = response.incomplete_details) == null ? void 0 : _i.reason) != null ? _j : void 0
+        raw: (_k = (_j = response.incomplete_details) == null ? void 0 : _j.reason) != null ? _k : void 0
       },
       usage: {
         inputTokens: {
@@ -589,13 +723,14 @@ var OpenResponsesLanguageModel = class _OpenResponsesLanguageModel {
       };
       usage.raw = responseUsage;
     };
-    let isActiveReasoning = false;
+    let activeReasoningId;
     let hasToolCalls = false;
     let finishReason = {
       unified: "other",
       raw: void 0
     };
     const toolCallsByItemId = /* @__PURE__ */ new Map();
+    const providerOptionsName = this.config.providerOptionsName;
     return {
       stream: response.pipeThrough(
         new TransformStream({
@@ -650,7 +785,12 @@ var OpenResponsesLanguageModel = class _OpenResponsesLanguageModel {
                 type: "tool-call",
                 toolCallId,
                 toolName,
-                input
+                input,
+                providerMetadata: {
+                  [providerOptionsName]: {
+                    itemId: chunk.item.id
+                  }
+                }
               });
               hasToolCalls = true;
               toolCallsByItemId.delete(chunk.item.id);
@@ -659,7 +799,7 @@ var OpenResponsesLanguageModel = class _OpenResponsesLanguageModel {
                 type: "reasoning-start",
                 id: chunk.item.id
               });
-              isActiveReasoning = true;
+              activeReasoningId = chunk.item.id;
             } else if (chunk.type === "response.reasoning_text.delta") {
               const reasoningChunk = chunk;
               controller.enqueue({
@@ -668,8 +808,17 @@ var OpenResponsesLanguageModel = class _OpenResponsesLanguageModel {
                 delta: reasoningChunk.delta
               });
             } else if (chunk.type === "response.output_item.done" && chunk.item.type === "reasoning") {
-              controller.enqueue({ type: "reasoning-end", id: chunk.item.id });
-              isActiveReasoning = false;
+              controller.enqueue({
+                type: "reasoning-end",
+                id: chunk.item.id,
+                providerMetadata: createReasoningProviderMetadata({
+                  part: chunk.item,
+                  providerOptionsName
+                })
+              });
+              if (activeReasoningId === chunk.item.id) {
+                activeReasoningId = void 0;
+              }
             } else if (chunk.type === "response.output_item.added" && chunk.item.type === "message") {
               controller.enqueue({ type: "text-start", id: chunk.item.id });
             } else if (chunk.type === "response.output_text.delta") {
@@ -679,7 +828,19 @@ var OpenResponsesLanguageModel = class _OpenResponsesLanguageModel {
                 delta: chunk.delta
               });
             } else if (chunk.type === "response.output_item.done" && chunk.item.type === "message") {
-              controller.enqueue({ type: "text-end", id: chunk.item.id });
+              const annotations = chunk.item.content.flatMap(
+                getOutputTextAnnotations
+              );
+              controller.enqueue({
+                type: "text-end",
+                id: chunk.item.id,
+                providerMetadata: {
+                  [providerOptionsName]: {
+                    itemId: chunk.item.id,
+                    ...annotations.length > 0 && { annotations }
+                  }
+                }
+              });
             } else if (chunk.type === "response.completed" || chunk.type === "response.incomplete") {
               const reason = (_f = chunk.response.incomplete_details) == null ? void 0 : _f.reason;
               finishReason = {
@@ -699,8 +860,11 @@ var OpenResponsesLanguageModel = class _OpenResponsesLanguageModel {
             }
           },
           flush(controller) {
-            if (isActiveReasoning) {
-              controller.enqueue({ type: "reasoning-end", id: "reasoning-0" });
+            if (activeReasoningId != null) {
+              controller.enqueue({
+                type: "reasoning-end",
+                id: activeReasoningId
+              });
             }
             controller.enqueue({
               type: "finish",
@@ -716,6 +880,42 @@ var OpenResponsesLanguageModel = class _OpenResponsesLanguageModel {
     };
   }
 };
+function createReasoningProviderMetadata({
+  part,
+  providerOptionsName,
+  reasoningContent = part.content
+}) {
+  return {
+    [providerOptionsName]: {
+      itemId: part.id,
+      reasoningSummary: part.summary.map((summaryPart) => ({
+        type: "summary_text",
+        text: summaryPart.text
+      })),
+      reasoningContent: reasoningContent == null ? null : reasoningContent.map((contentPart) => ({
+        type: "reasoning_text",
+        text: contentPart.text
+      })),
+      ...part.encrypted_content != null && {
+        reasoningEncryptedContent: part.encrypted_content
+      }
+    }
+  };
+}
+function getOutputTextAnnotations(value) {
+  if (value == null || typeof value !== "object" || !("annotations" in value) || !Array.isArray(value.annotations) || !value.annotations.every(
+    (annotation) => annotation != null && typeof annotation === "object" && annotation.type === "url_citation" && typeof annotation.start_index === "number" && typeof annotation.end_index === "number" && typeof annotation.url === "string" && typeof annotation.title === "string"
+  )) {
+    return [];
+  }
+  return value.annotations.map((annotation) => ({
+    type: "url_citation",
+    start_index: annotation.start_index,
+    end_index: annotation.end_index,
+    url: annotation.url,
+    title: annotation.title
+  }));
+}
 
 // src/open-responses-provider.ts
 function createOpenResponses(options) {