@ai-sdk/open-responses 2.0.51 → 2.0.54

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @ai-sdk/open-responses
 
+## 2.0.54
+
+### Patch Changes
+
+- Updated dependencies [af9597b]
+- Updated dependencies [bc49f78]
+  - @ai-sdk/provider-utils@5.0.49
+
+## 2.0.53
+
+### Patch Changes
+
+- Updated dependencies [be877ff]
+  - @ai-sdk/provider-utils@5.0.48
+
+## 2.0.52
+
+### Patch Changes
+
+- 2147b86: Add QuiverAI Arrow 2 language models through the Responses API, with provider-local reasoning validation, stateless history replay, and workflow serialization that preserves QuiverAI configuration and behavior.
+
+  Add reusable Open Responses transport configuration, response-error metadata extraction for generation and streaming, cache-write accounting, and OpenAI-compatible custom tools. Preserve text, image, and file custom-tool results and complete tool inputs when streaming deltas are omitted.
+
 ## 2.0.51
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { LanguageModelV4ProviderTool, JSONObject, LanguageModelV4Content, LanguageModelV4StreamPart, LanguageModelV4ToolCallPart, LanguageModelV4ToolResultPart, ProviderV4, LanguageModelV4 } from '@ai-sdk/provider';
+import { LanguageModelV4ProviderTool, JSONObject, LanguageModelV4Content, LanguageModelV4StreamPart, LanguageModelV4ToolCallPart, LanguageModelV4ToolResultPart, APICallError, ProviderV4, LanguageModelV4 } from '@ai-sdk/provider';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
-import { MaybePromiseLike, FetchFunction, InferSchema } from '@ai-sdk/provider-utils';
+import { MaybePromiseLike, FetchFunction, ResponseHandler, InferSchema } from '@ai-sdk/provider-utils';
 
 declare const VERSION: string;
 
@@ -90,9 +90,82 @@ interface OpenResponsesExtension {
         state: Map<string, unknown>;
     }): MaybePromiseLike<OpenResponsesExtensionStreamPart[] | undefined>;
 }
+type OpenResponsesExtensionRegistry = {
+    byEventType: Map<OpenResponsesNamespacedType, OpenResponsesEventExtension>;
+    byExtensionId: Map<LanguageModelV4ProviderTool['id'], OpenResponsesExtension>;
+    byItemType: Map<OpenResponsesNamespacedType, OpenResponsesItemExtension>;
+    byProviderToolId: Map<LanguageModelV4ProviderTool['id'], OpenResponsesToolExtension>;
+    byToolType: Map<OpenResponsesNamespacedType, OpenResponsesToolExtension>;
+};
+type OpenResponsesToolExtension = OpenResponsesExtension & {
+    toolType: OpenResponsesNamespacedType;
+    encodeTool: NonNullable<OpenResponsesExtension['encodeTool']>;
+};
+type OpenResponsesItemExtension = OpenResponsesExtension & {
+    itemTypes: readonly OpenResponsesNamespacedType[];
+    decodeItem: NonNullable<OpenResponsesExtension['decodeItem']>;
+};
+type OpenResponsesEventExtension = OpenResponsesExtension & {
+    eventTypes: readonly OpenResponsesNamespacedType[];
+    decodeEvent: NonNullable<OpenResponsesExtension['decodeEvent']>;
+};
+
+type OpenResponsesCustomToolOptions = {
+    /**
+     * An optional description of what the custom tool does.
+     */
+    description?: string;
+    /**
+     * The raw text format returned by the model.
+     */
+    format?: {
+        type: 'grammar';
+        syntax: 'regex' | 'lark';
+        definition: string;
+    } | {
+        type: 'text';
+    };
+};
+declare function createOpenResponsesTools({ customToolId, }: {
+    customToolId: `${string}.${string}`;
+}): {
+    /**
+     * Creates a caller-executed OpenAI-compatible custom tool. Custom tools accept
+     * a raw string, optionally constrained by a grammar. Requires endpoint support.
+     */
+    customTool: (options: Parameters<_ai_sdk_provider_utils.ProviderDefinedToolFactory<string, OpenResponsesCustomToolOptions, {}>>[0]) => ReturnType<_ai_sdk_provider_utils.ProviderDefinedToolFactory<string, OpenResponsesCustomToolOptions, {}>>;
+};
+
+/**
+ * An error that occurred while generating the response.
+ */
+type ResponseError = {
+    code: string;
+    message: string;
+    [key: string]: unknown;
+};
+
+type OpenResponsesConfig = {
+    provider: string;
+    providerOptionsName: string;
+    url: string;
+    headers?: () => Record<string, string | undefined>;
+    fetch?: FetchFunction;
+    failedResponseHandler?: ResponseHandler<APICallError>;
+    getResponseErrorMetadata?: (error: ResponseError) => {
+        statusCode?: number;
+        isRetryable?: boolean;
+    };
+    generateId: () => string;
+    extensionRegistry?: OpenResponsesExtensionRegistry;
+    strictResponseInput?: boolean;
+    customToolId?: `${string}.${string}`;
+    structuredOutputs?: boolean;
+};
 
 interface OpenResponsesProvider extends ProviderV4 {
     (modelId: string): LanguageModelV4;
+    tools: ReturnType<typeof createOpenResponsesTools>;
 }
 interface OpenResponsesProviderSettings {
     /**
@@ -110,12 +183,21 @@ interface OpenResponsesProviderSettings {
     /**
      * Custom headers to include in the requests.
      */
-    headers?: Record<string, string>;
+    headers?: Record<string, string> | (() => Record<string, string>);
     /**
      * Custom fetch implementation. You can use it as a middleware to intercept requests,
      * or to provide a custom fetch implementation for e.g. testing.
      */
     fetch?: FetchFunction;
+    /**
+     * Custom handler for non-successful HTTP responses.
+     */
+    failedResponseHandler?: ResponseHandler<APICallError>;
+    /**
+     * Extracts HTTP status and retryability metadata from endpoint-specific
+     * response errors. Applies to both generation and streaming errors.
+     */
+    getResponseErrorMetadata?: OpenResponsesConfig['getResponseErrorMetadata'];
     /**
      * Whether to serialize assistant history using the strict OpenAI Responses
      * input schemas. Assistant messages without an item ID are sent as easy input
@@ -124,6 +206,25 @@ interface OpenResponsesProviderSettings {
      * @default false
      */
     strictResponseInput?: boolean;
+    /**
+     * Provider-tool ID used for caller-executed Open Responses custom tools.
+     *
+     * @default 'open-responses.custom'
+     */
+    customToolId?: `${string}.${string}`;
+    /**
+     * Whether JSON response formats are sent to the endpoint. When disabled,
+     * structured output requests produce an unsupported warning and are omitted.
+     *
+     * @default true
+     */
+    structuredOutputs?: boolean;
+    /**
+     * User-agent suffix for requests.
+     *
+     * @default `ai-sdk/open-responses/<version>`
+     */
+    userAgentSuffix?: string;
     /**
      * Codecs for Open Responses extension tools, items, and streaming events.
      *
@@ -139,4 +240,4 @@ declare const openResponsesLanguageModelOptions: _ai_sdk_provider_utils.LazySche
 }>;
 type OpenResponsesLanguageModelOptions = InferSchema<typeof openResponsesLanguageModelOptions>;
 
-export { type OpenResponsesExtension as Experimental_OpenResponsesExtension, type OpenResponsesExtensionContentPart as Experimental_OpenResponsesExtensionContentPart, type OpenResponsesExtensionEvent as Experimental_OpenResponsesExtensionEvent, type OpenResponsesExtensionInputPart as Experimental_OpenResponsesExtensionInputPart, type OpenResponsesExtensionItem as Experimental_OpenResponsesExtensionItem, type OpenResponsesExtensionRecord as Experimental_OpenResponsesExtensionRecord, type OpenResponsesExtensionStreamPart as Experimental_OpenResponsesExtensionStreamPart, type OpenResponsesNamespacedType as Experimental_OpenResponsesNamespacedType, type OpenResponsesLanguageModelOptions, type OpenResponsesLanguageModelOptions as OpenResponsesOptions, type OpenResponsesProvider, type OpenResponsesProviderSettings, VERSION, createOpenResponses };
+export { type OpenResponsesExtension as Experimental_OpenResponsesExtension, type OpenResponsesExtensionContentPart as Experimental_OpenResponsesExtensionContentPart, type OpenResponsesExtensionEvent as Experimental_OpenResponsesExtensionEvent, type OpenResponsesExtensionInputPart as Experimental_OpenResponsesExtensionInputPart, type OpenResponsesExtensionItem as Experimental_OpenResponsesExtensionItem, type OpenResponsesExtensionRecord as Experimental_OpenResponsesExtensionRecord, type OpenResponsesExtensionStreamPart as Experimental_OpenResponsesExtensionStreamPart, type OpenResponsesNamespacedType as Experimental_OpenResponsesNamespacedType, type OpenResponsesCustomToolOptions, type OpenResponsesLanguageModelOptions, type OpenResponsesLanguageModelOptions as OpenResponsesOptions, type OpenResponsesProvider, type OpenResponsesProviderSettings, VERSION, createOpenResponses };