@jerome-benoit/sap-ai-provider-v2 5.0.3 → 5.1.0

package/dist/index.d.cts

@@ -3,13 +3,748 @@ import { CustomRequestConfig } from '@sap-ai-sdk/core';
 export { CustomRequestConfig } from '@sap-ai-sdk/core';
 import { HttpDestinationOrFetchOptions } from '@sap-cloud-sdk/connectivity';
 export { HttpDestinationOrFetchOptions } from '@sap-cloud-sdk/connectivity';
+import { OpenAIResponsesProviderOptions } from '@ai-sdk/openai';
 import { AzureOpenAiChatCompletionParameters } from '@sap-ai-sdk/foundation-models';
 import { OrchestrationConfigRefOverride, OrchestrationModuleConfig, FilteringModule, GroundingModule, MaskingModule, OrchestrationConfigRefById, OrchestrationConfigRefByName, ChatCompletionTool, TranslationModule, ChatModel } from '@sap-ai-sdk/orchestration';
 export { AssistantChatMessage, ChatCompletionRequest, ChatCompletionTool, ChatMessage, ChatMessageContent, ChatMessages, Citation, DeveloperChatMessage, DocumentTranslationApplyToSelector, FileContent, FilteringModule, FunctionObject, GroundingModule, ImageContentUrl, LlmModelDetails, LlmModelParams, MaskingModule, OrchestrationClient, OrchestrationConfigRef, OrchestrationConfigRefById, OrchestrationConfigRefByName, OrchestrationConfigRefOverride, OrchestrationEmbeddingClient, OrchestrationEmbeddingResponse, OrchestrationError, OrchestrationErrorResponse, OrchestrationModuleConfig, OrchestrationModuleConfigList, OrchestrationResponse, OrchestrationStream, OrchestrationStreamChunkResponse, OrchestrationStreamResponse, PromptTemplatingModule, SystemChatMessage, ToolChatMessage, TranslationApplyToCategory, TranslationInputParameters, TranslationModule, TranslationOutputParameters, TranslationTargetLanguage, UserChatMessage, UserChatMessageContent, UserChatMessageContentItem, buildAzureContentSafetyFilter, buildDocumentGroundingConfig, buildDpiMaskingProvider, buildLlamaGuard38BFilter, buildTranslationConfig } from '@sap-ai-sdk/orchestration';
-import { LanguageModelV2 as LanguageModelV2$1, LanguageModelV2CallOptions as LanguageModelV2CallOptions$1, LanguageModelV3CallOptions } from '@ai-sdk/provider';
+import { LanguageModelV2 as LanguageModelV2$1, LanguageModelV2CallOptions as LanguageModelV2CallOptions$1 } from '@ai-sdk/provider';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { InferSchema } from '@ai-sdk/provider-utils';
 
+// ==================================================================================================
+// JSON Schema Draft 07
+// ==================================================================================================
+// https://tools.ietf.org/html/draft-handrews-json-schema-validation-01
+// --------------------------------------------------------------------------------------------------
+
+/**
+ * Primitive type
+ * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.1.1
+ */
+type JSONSchema7TypeName =
+    | "string" //
+    | "number"
+    | "integer"
+    | "boolean"
+    | "object"
+    | "array"
+    | "null";
+
+/**
+ * Primitive type
+ * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.1.1
+ */
+type JSONSchema7Type =
+    | string //
+    | number
+    | boolean
+    | JSONSchema7Object
+    | JSONSchema7Array
+    | null;
+
+// Workaround for infinite type recursion
+interface JSONSchema7Object {
+    [key: string]: JSONSchema7Type;
+}
+
+// Workaround for infinite type recursion
+// https://github.com/Microsoft/TypeScript/issues/3496#issuecomment-128553540
+interface JSONSchema7Array extends Array<JSONSchema7Type> {}
+
+/**
+ * Meta schema
+ *
+ * Recommended values:
+ * - 'http://json-schema.org/schema#'
+ * - 'http://json-schema.org/hyper-schema#'
+ * - 'http://json-schema.org/draft-07/schema#'
+ * - 'http://json-schema.org/draft-07/hyper-schema#'
+ *
+ * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-5
+ */
+type JSONSchema7Version = string;
+
+/**
+ * JSON Schema v7
+ * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01
+ */
+type JSONSchema7Definition = JSONSchema7 | boolean;
+interface JSONSchema7 {
+    $id?: string | undefined;
+    $ref?: string | undefined;
+    $schema?: JSONSchema7Version | undefined;
+    $comment?: string | undefined;
+
+    /**
+     * @see https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-00#section-8.2.4
+     * @see https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-validation-00#appendix-A
+     */
+    $defs?: {
+        [key: string]: JSONSchema7Definition;
+    } | undefined;
+
+    /**
+     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.1
+     */
+    type?: JSONSchema7TypeName | JSONSchema7TypeName[] | undefined;
+    enum?: JSONSchema7Type[] | undefined;
+    const?: JSONSchema7Type | undefined;
+
+    /**
+     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.2
+     */
+    multipleOf?: number | undefined;
+    maximum?: number | undefined;
+    exclusiveMaximum?: number | undefined;
+    minimum?: number | undefined;
+    exclusiveMinimum?: number | undefined;
+
+    /**
+     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.3
+     */
+    maxLength?: number | undefined;
+    minLength?: number | undefined;
+    pattern?: string | undefined;
+
+    /**
+     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.4
+     */
+    items?: JSONSchema7Definition | JSONSchema7Definition[] | undefined;
+    additionalItems?: JSONSchema7Definition | undefined;
+    maxItems?: number | undefined;
+    minItems?: number | undefined;
+    uniqueItems?: boolean | undefined;
+    contains?: JSONSchema7Definition | undefined;
+
+    /**
+     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.5
+     */
+    maxProperties?: number | undefined;
+    minProperties?: number | undefined;
+    required?: string[] | undefined;
+    properties?: {
+        [key: string]: JSONSchema7Definition;
+    } | undefined;
+    patternProperties?: {
+        [key: string]: JSONSchema7Definition;
+    } | undefined;
+    additionalProperties?: JSONSchema7Definition | undefined;
+    dependencies?: {
+        [key: string]: JSONSchema7Definition | string[];
+    } | undefined;
+    propertyNames?: JSONSchema7Definition | undefined;
+
+    /**
+     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.6
+     */
+    if?: JSONSchema7Definition | undefined;
+    then?: JSONSchema7Definition | undefined;
+    else?: JSONSchema7Definition | undefined;
+
+    /**
+     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.7
+     */
+    allOf?: JSONSchema7Definition[] | undefined;
+    anyOf?: JSONSchema7Definition[] | undefined;
+    oneOf?: JSONSchema7Definition[] | undefined;
+    not?: JSONSchema7Definition | undefined;
+
+    /**
+     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-7
+     */
+    format?: string | undefined;
+
+    /**
+     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-8
+     */
+    contentMediaType?: string | undefined;
+    contentEncoding?: string | undefined;
+
+    /**
+     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-9
+     */
+    definitions?: {
+        [key: string]: JSONSchema7Definition;
+    } | undefined;
+
+    /**
+     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-10
+     */
+    title?: string | undefined;
+    description?: string | undefined;
+    default?: JSONSchema7Type | undefined;
+    readOnly?: boolean | undefined;
+    writeOnly?: boolean | undefined;
+    examples?: JSONSchema7Type | undefined;
+}
+
+/**
+ * A JSON value can be a string, number, boolean, object, array, or null.
+ * JSON values can be serialized and deserialized by the JSON.stringify and JSON.parse methods.
+ */
+type JSONValue$1 = null | string | number | boolean | JSONObject$1 | JSONArray$1;
+type JSONObject$1 = {
+    [key: string]: JSONValue$1 | undefined;
+};
+type JSONArray$1 = JSONValue$1[];
+
+/**
+ * Additional provider-specific options.
+ * Options are additional input to the provider.
+ * They are passed through to the provider from the AI SDK
+ * and enable provider-specific functionality
+ * that can be fully encapsulated in the provider.
+ *
+ * This enables us to quickly ship provider-specific functionality
+ * without affecting the core AI SDK.
+ *
+ * The outer record is keyed by the provider name, and the inner
+ * record is keyed by the provider-specific metadata key.
+ *
+ * ```ts
+ * {
+ *   "anthropic": {
+ *     "cacheControl": { "type": "ephemeral" }
+ *   }
+ * }
+ * ```
+ */
+type SharedV3ProviderOptions = Record<string, JSONObject$1>;
+
+/**
+ * A tool has a name, a description, and a set of parameters.
+ *
+ * Note: this is **not** the user-facing tool definition. The AI SDK methods will
+ * map the user-facing tool definitions to this format.
+ */
+type LanguageModelV3FunctionTool = {
+    /**
+     * The type of the tool (always 'function').
+     */
+    type: 'function';
+    /**
+     * The name of the tool. Unique within this model call.
+     */
+    name: string;
+    /**
+     * A description of the tool. The language model uses this to understand the
+     * tool's purpose and to provide better completion suggestions.
+     */
+    description?: string;
+    /**
+     * The parameters that the tool expects. The language model uses this to
+     * understand the tool's input requirements and to provide matching suggestions.
+     */
+    inputSchema: JSONSchema7;
+    /**
+     * An optional list of input examples that show the language
+     * model what the input should look like.
+     */
+    inputExamples?: Array<{
+        input: JSONObject$1;
+    }>;
+    /**
+     * Strict mode setting for the tool.
+     *
+     * Providers that support strict mode will use this setting to determine
+     * how the input should be generated. Strict mode will always produce
+     * valid inputs, but it might limit what input schemas are supported.
+     */
+    strict?: boolean;
+    /**
+     * The provider-specific options for the tool.
+     */
+    providerOptions?: SharedV3ProviderOptions;
+};
+
+/**
+ * Data content. Can be a Uint8Array, base64 encoded data as a string or a URL.
+ */
+type LanguageModelV3DataContent = Uint8Array | string | URL;
+
+/**
+ * A prompt is a list of messages.
+ *
+ * Note: Not all models and prompt formats support multi-modal inputs and
+ * tool calls. The validation happens at runtime.
+ *
+ * Note: This is not a user-facing prompt. The AI SDK methods will map the
+ * user-facing prompt types such as chat or instruction prompts to this format.
+ */
+type LanguageModelV3Prompt = Array<LanguageModelV3Message>;
+type LanguageModelV3Message = ({
+    role: 'system';
+    content: string;
+} | {
+    role: 'user';
+    content: Array<LanguageModelV3TextPart | LanguageModelV3FilePart>;
+} | {
+    role: 'assistant';
+    content: Array<LanguageModelV3TextPart | LanguageModelV3FilePart | LanguageModelV3ReasoningPart | LanguageModelV3ToolCallPart | LanguageModelV3ToolResultPart>;
+} | {
+    role: 'tool';
+    content: Array<LanguageModelV3ToolResultPart | LanguageModelV3ToolApprovalResponsePart>;
+}) & {
+    /**
+     * Additional provider-specific options. They are passed through
+     * to the provider from the AI SDK and enable provider-specific
+     * functionality that can be fully encapsulated in the provider.
+     */
+    providerOptions?: SharedV3ProviderOptions;
+};
+/**
+ * Text content part of a prompt. It contains a string of text.
+ */
+interface LanguageModelV3TextPart {
+    type: 'text';
+    /**
+     * The text content.
+     */
+    text: string;
+    /**
+     * Additional provider-specific options. They are passed through
+     * to the provider from the AI SDK and enable provider-specific
+     * functionality that can be fully encapsulated in the provider.
+     */
+    providerOptions?: SharedV3ProviderOptions;
+}
+/**
+ * Reasoning content part of a prompt. It contains a string of reasoning text.
+ */
+interface LanguageModelV3ReasoningPart {
+    type: 'reasoning';
+    /**
+     * The reasoning text.
+     */
+    text: string;
+    /**
+     * Additional provider-specific options. They are passed through
+     * to the provider from the AI SDK and enable provider-specific
+     * functionality that can be fully encapsulated in the provider.
+     */
+    providerOptions?: SharedV3ProviderOptions;
+}
+/**
+ * File content part of a prompt. It contains a file.
+ */
+interface LanguageModelV3FilePart {
+    type: 'file';
+    /**
+     * Optional filename of the file.
+     */
+    filename?: string;
+    /**
+     * File data. Can be a Uint8Array, base64 encoded data as a string or a URL.
+     */
+    data: LanguageModelV3DataContent;
+    /**
+     * The original URL string before it was parsed into a URL.
+     *
+     * This is available when parsing changes the string and a provider needs to
+     * preserve an opaque non-HTTP URI exactly.
+     */
+    originalUrl?: string;
+    /**
+     * IANA media type of the file.
+     *
+     * Can support wildcards, e.g. `image/*` (in which case the provider needs to take appropriate action).
+     *
+     * @see https://www.iana.org/assignments/media-types/media-types.xhtml
+     */
+    mediaType: string;
+    /**
+     * Additional provider-specific options. They are passed through
+     * to the provider from the AI SDK and enable provider-specific
+     * functionality that can be fully encapsulated in the provider.
+     */
+    providerOptions?: SharedV3ProviderOptions;
+}
+/**
+ * Tool call content part of a prompt. It contains a tool call (usually generated by the AI model).
+ */
+interface LanguageModelV3ToolCallPart {
+    type: 'tool-call';
+    /**
+     * ID of the tool call. This ID is used to match the tool call with the tool result.
+     */
+    toolCallId: string;
+    /**
+     * Name of the tool that is being called.
+     */
+    toolName: string;
+    /**
+     * Arguments of the tool call. This is a JSON-serializable object that matches the tool's input schema.
+     */
+    input: unknown;
+    /**
+     * Whether the tool call will be executed by the provider.
+     * If this flag is not set or is false, the tool call will be executed by the client.
+     */
+    providerExecuted?: boolean;
+    /**
+     * Additional provider-specific options. They are passed through
+     * to the provider from the AI SDK and enable provider-specific
+     * functionality that can be fully encapsulated in the provider.
+     */
+    providerOptions?: SharedV3ProviderOptions;
+}
+/**
+ * Tool result content part of a prompt. It contains the result of the tool call with the matching ID.
+ */
+interface LanguageModelV3ToolResultPart {
+    type: 'tool-result';
+    /**
+     * ID of the tool call that this result is associated with.
+     */
+    toolCallId: string;
+    /**
+     * Name of the tool that generated this result.
+     */
+    toolName: string;
+    /**
+     * Result of the tool call.
+     */
+    output: LanguageModelV3ToolResultOutput;
+    /**
+     * Additional provider-specific options. They are passed through
+     * to the provider from the AI SDK and enable provider-specific
+     * functionality that can be fully encapsulated in the provider.
+     */
+    providerOptions?: SharedV3ProviderOptions;
+}
+/**
+ * Tool approval response content part of a prompt. It contains the user's
+ * decision to approve or deny a provider-executed tool call.
+ */
+interface LanguageModelV3ToolApprovalResponsePart {
+    type: 'tool-approval-response';
+    /**
+     * ID of the approval request that this response refers to.
+     */
+    approvalId: string;
+    /**
+     * Whether the approval was granted (true) or denied (false).
+     */
+    approved: boolean;
+    /**
+     * Optional reason for approval or denial.
+     */
+    reason?: string;
+    /**
+     * Additional provider-specific options. They are passed through
+     * to the provider from the AI SDK and enable provider-specific
+     * functionality that can be fully encapsulated in the provider.
+     */
+    providerOptions?: SharedV3ProviderOptions;
+}
+/**
+ * Result of a tool call.
+ */
+type LanguageModelV3ToolResultOutput = {
+    /**
+     * Text tool output that should be directly sent to the API.
+     */
+    type: 'text';
+    value: string;
+    /**
+     * Provider-specific options.
+     */
+    providerOptions?: SharedV3ProviderOptions;
+} | {
+    type: 'json';
+    value: JSONValue$1;
+    /**
+     * Provider-specific options.
+     */
+    providerOptions?: SharedV3ProviderOptions;
+} | {
+    /**
+     * Type when the user has denied the execution of the tool call.
+     */
+    type: 'execution-denied';
+    /**
+     * Optional reason for the execution denial.
+     */
+    reason?: string;
+    /**
+     * Provider-specific options.
+     */
+    providerOptions?: SharedV3ProviderOptions;
+} | {
+    type: 'error-text';
+    value: string;
+    /**
+     * Provider-specific options.
+     */
+    providerOptions?: SharedV3ProviderOptions;
+} | {
+    type: 'error-json';
+    value: JSONValue$1;
+    /**
+     * Provider-specific options.
+     */
+    providerOptions?: SharedV3ProviderOptions;
+} | {
+    type: 'content';
+    value: Array<{
+        type: 'text';
+        /**
+         * Text content.
+         */
+        text: string;
+        /**
+         * Provider-specific options.
+         */
+        providerOptions?: SharedV3ProviderOptions;
+    } | {
+        type: 'file-data';
+        /**
+         * Base-64 encoded media data.
+         */
+        data: string;
+        /**
+         * IANA media type.
+         * @see https://www.iana.org/assignments/media-types/media-types.xhtml
+         */
+        mediaType: string;
+        /**
+         * Optional filename of the file.
+         */
+        filename?: string;
+        /**
+         * Provider-specific options.
+         */
+        providerOptions?: SharedV3ProviderOptions;
+    } | {
+        type: 'file-url';
+        /**
+         * URL of the file.
+         */
+        url: string;
+        /**
+         * IANA media type.
+         * @see https://www.iana.org/assignments/media-types/media-types.xhtml
+         */
+        mediaType?: string;
+        /**
+         * Provider-specific options.
+         */
+        providerOptions?: SharedV3ProviderOptions;
+    } | {
+        type: 'file-id';
+        /**
+         * ID of the file.
+         *
+         * If you use multiple providers, you need to
+         * specify the provider specific ids using
+         * the Record option. The key is the provider
+         * name, e.g. 'openai' or 'anthropic'.
+         */
+        fileId: string | Record<string, string>;
+        /**
+         * Provider-specific options.
+         */
+        providerOptions?: SharedV3ProviderOptions;
+    } | {
+        /**
+         * Images that are referenced using base64 encoded data.
+         */
+        type: 'image-data';
+        /**
+         * Base-64 encoded image data.
+         */
+        data: string;
+        /**
+         * IANA media type.
+         * @see https://www.iana.org/assignments/media-types/media-types.xhtml
+         */
+        mediaType: string;
+        /**
+         * Provider-specific options.
+         */
+        providerOptions?: SharedV3ProviderOptions;
+    } | {
+        /**
+         * Images that are referenced using a URL.
+         */
+        type: 'image-url';
+        /**
+         * URL of the image.
+         */
+        url: string;
+        /**
+         * Provider-specific options.
+         */
+        providerOptions?: SharedV3ProviderOptions;
+    } | {
+        /**
+         * Images that are referenced using a provider file id.
+         */
+        type: 'image-file-id';
+        /**
+         * Image that is referenced using a provider file id.
+         *
+         * If you use multiple providers, you need to
+         * specify the provider specific ids using
+         * the Record option. The key is the provider
+         * name, e.g. 'openai' or 'anthropic'.
+         */
+        fileId: string | Record<string, string>;
+        /**
+         * Provider-specific options.
+         */
+        providerOptions?: SharedV3ProviderOptions;
+    } | {
+        /**
+         * Custom content part. This can be used to implement
+         * provider-specific content parts.
+         */
+        type: 'custom';
+        /**
+         * Provider-specific options.
+         */
+        providerOptions?: SharedV3ProviderOptions;
+    }>;
+};
+
+/**
+ * The configuration of a provider tool.
+ *
+ * Provider tools are tools that are specific to a certain provider.
+ * The input and output schemas are defined be the provider, and
+ * some of the tools are also executed on the provider systems.
+ */
+type LanguageModelV3ProviderTool = {
+    /**
+     * The type of the tool (always 'provider').
+     */
+    type: 'provider';
+    /**
+     * The ID of the tool. Should follow the format `<provider-id>.<unique-tool-name>`.
+     */
+    id: `${string}.${string}`;
+    /**
+     * The name of the tool. Unique within this model call.
+     */
+    name: string;
+    /**
+     * The arguments for configuring the tool. Must match the expected arguments defined by the provider for this tool.
+     */
+    args: Record<string, unknown>;
+};
+
+type LanguageModelV3ToolChoice = {
+    type: 'auto';
+} | {
+    type: 'none';
+} | {
+    type: 'required';
+} | {
+    type: 'tool';
+    toolName: string;
+};
+
+type LanguageModelV3CallOptions = {
+    /**
+     * A language mode prompt is a standardized prompt type.
+     *
+     * Note: This is **not** the user-facing prompt. The AI SDK methods will map the
+     * user-facing prompt types such as chat or instruction prompts to this format.
+     * That approach allows us to evolve the user  facing prompts without breaking
+     * the language model interface.
+     */
+    prompt: LanguageModelV3Prompt;
+    /**
+     * Maximum number of tokens to generate.
+     */
+    maxOutputTokens?: number;
+    /**
+     * Temperature setting. The range depends on the provider and model.
+     */
+    temperature?: number;
+    /**
+     * Stop sequences.
+     * If set, the model will stop generating text when one of the stop sequences is generated.
+     * Providers may have limits on the number of stop sequences.
+     */
+    stopSequences?: string[];
+    /**
+     * Nucleus sampling.
+     */
+    topP?: number;
+    /**
+     * Only sample from the top K options for each subsequent token.
+     *
+     * Used to remove "long tail" low probability responses.
+     * Recommended for advanced use cases only. You usually only need to use temperature.
+     */
+    topK?: number;
+    /**
+     * Presence penalty setting. It affects the likelihood of the model to
+     * repeat information that is already in the prompt.
+     */
+    presencePenalty?: number;
+    /**
+     * Frequency penalty setting. It affects the likelihood of the model
+     * to repeatedly use the same words or phrases.
+     */
+    frequencyPenalty?: number;
+    /**
+     * Response format. The output can either be text or JSON. Default is text.
+     *
+     * If JSON is selected, a schema can optionally be provided to guide the LLM.
+     */
+    responseFormat?: {
+        type: 'text';
+    } | {
+        type: 'json';
+        /**
+         * JSON schema that the generated output should conform to.
+         */
+        schema?: JSONSchema7;
+        /**
+         * Name of output that should be generated. Used by some providers for additional LLM guidance.
+         */
+        name?: string;
+        /**
+         * Description of the output that should be generated. Used by some providers for additional LLM guidance.
+         */
+        description?: string;
+    };
+    /**
+     * The seed (integer) to use for random sampling. If set and supported
+     * by the model, calls will generate deterministic results.
+     */
+    seed?: number;
+    /**
+     * The tools that are available for the model.
+     */
+    tools?: Array<LanguageModelV3FunctionTool | LanguageModelV3ProviderTool>;
+    /**
+     * Specifies how the tool should be selected. Defaults to 'auto'.
+     */
+    toolChoice?: LanguageModelV3ToolChoice;
+    /**
+     * Include raw chunks in the stream. Only applicable for streaming calls.
+     */
+    includeRawChunks?: boolean;
+    /**
+     * Abort signal for cancelling the operation.
+     */
+    abortSignal?: AbortSignal;
+    /**
+     * Additional HTTP headers to be sent with the request.
+     * Only applicable for HTTP-based providers.
+     */
+    headers?: Record<string, string | undefined>;
+    /**
+     * Additional provider-specific options. They are passed through
+     * to the provider from the AI SDK and enable provider-specific
+     * functionality that can be fully encapsulated in the provider.
+     */
+    providerOptions?: SharedV3ProviderOptions;
+};
+
 /** Default provider name used as key in `providerOptions` and `providerMetadata` objects. */
 declare const SAP_AI_PROVIDER_NAME: "sap-ai";
 /**
@@ -20,7 +755,8 @@ declare const SAP_AI_PROVIDER_NAME: "sap-ai";
 declare function getProviderName(providerIdentifier: string): string;
 /** @internal */
 declare const sapAILanguageModelProviderOptions: _ai_sdk_provider_utils.LazySchema<{
-    api?: "orchestration" | "foundation-models" | undefined;
+    api?: "orchestration" | "foundation-models" | "responses" | undefined;
+    dropUnsupportedParams?: boolean | undefined;
     escapeTemplatePlaceholders?: boolean | undefined;
     includeReasoning?: boolean | undefined;
     modelParams?: {
@@ -52,12 +788,15 @@ declare const sapAILanguageModelProviderOptions: _ai_sdk_provider_utils.LazySche
         version: string;
         scope?: "tenant" | "resource_group" | undefined;
     } | undefined;
+    responses?: (JSONObject$1 & {
+        readonly metadata?: null | Record<string, string>;
+    }) | undefined;
 }>;
 /** @internal */
 type SAPAILanguageModelProviderOptions = InferSchema<typeof sapAILanguageModelProviderOptions>;
 /** @internal */
 declare const sapAIEmbeddingProviderOptions: _ai_sdk_provider_utils.LazySchema<{
-    api?: "orchestration" | "foundation-models" | undefined;
+    api?: "orchestration" | "foundation-models" | "responses" | undefined;
     modelParams?: {
         [x: string]: unknown;
         dimensions?: number | undefined;
@@ -88,173 +827,6 @@ declare function escapeOrchestrationPlaceholders(text: string): string;
  */
 declare function unescapeOrchestrationPlaceholders(text: string): string;
 
-// ==================================================================================================
-// JSON Schema Draft 07
-// ==================================================================================================
-// https://tools.ietf.org/html/draft-handrews-json-schema-validation-01
-// --------------------------------------------------------------------------------------------------
-
-/**
- * Primitive type
- * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.1.1
- */
-type JSONSchema7TypeName =
-    | "string" //
-    | "number"
-    | "integer"
-    | "boolean"
-    | "object"
-    | "array"
-    | "null";
-
-/**
- * Primitive type
- * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.1.1
- */
-type JSONSchema7Type =
-    | string //
-    | number
-    | boolean
-    | JSONSchema7Object
-    | JSONSchema7Array
-    | null;
-
-// Workaround for infinite type recursion
-interface JSONSchema7Object {
-    [key: string]: JSONSchema7Type;
-}
-
-// Workaround for infinite type recursion
-// https://github.com/Microsoft/TypeScript/issues/3496#issuecomment-128553540
-interface JSONSchema7Array extends Array<JSONSchema7Type> {}
-
-/**
- * Meta schema
- *
- * Recommended values:
- * - 'http://json-schema.org/schema#'
- * - 'http://json-schema.org/hyper-schema#'
- * - 'http://json-schema.org/draft-07/schema#'
- * - 'http://json-schema.org/draft-07/hyper-schema#'
- *
- * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-5
- */
-type JSONSchema7Version = string;
-
-/**
- * JSON Schema v7
- * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01
- */
-type JSONSchema7Definition = JSONSchema7 | boolean;
-interface JSONSchema7 {
-    $id?: string | undefined;
-    $ref?: string | undefined;
-    $schema?: JSONSchema7Version | undefined;
-    $comment?: string | undefined;
-
-    /**
-     * @see https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-00#section-8.2.4
-     * @see https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-validation-00#appendix-A
-     */
-    $defs?: {
-        [key: string]: JSONSchema7Definition;
-    } | undefined;
-
-    /**
-     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.1
-     */
-    type?: JSONSchema7TypeName | JSONSchema7TypeName[] | undefined;
-    enum?: JSONSchema7Type[] | undefined;
-    const?: JSONSchema7Type | undefined;
-
-    /**
-     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.2
-     */
-    multipleOf?: number | undefined;
-    maximum?: number | undefined;
-    exclusiveMaximum?: number | undefined;
-    minimum?: number | undefined;
-    exclusiveMinimum?: number | undefined;
-
-    /**
-     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.3
-     */
-    maxLength?: number | undefined;
-    minLength?: number | undefined;
-    pattern?: string | undefined;
-
-    /**
-     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.4
-     */
-    items?: JSONSchema7Definition | JSONSchema7Definition[] | undefined;
-    additionalItems?: JSONSchema7Definition | undefined;
-    maxItems?: number | undefined;
-    minItems?: number | undefined;
-    uniqueItems?: boolean | undefined;
-    contains?: JSONSchema7Definition | undefined;
-
-    /**
-     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.5
-     */
-    maxProperties?: number | undefined;
-    minProperties?: number | undefined;
-    required?: string[] | undefined;
-    properties?: {
-        [key: string]: JSONSchema7Definition;
-    } | undefined;
-    patternProperties?: {
-        [key: string]: JSONSchema7Definition;
-    } | undefined;
-    additionalProperties?: JSONSchema7Definition | undefined;
-    dependencies?: {
-        [key: string]: JSONSchema7Definition | string[];
-    } | undefined;
-    propertyNames?: JSONSchema7Definition | undefined;
-
-    /**
-     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.6
-     */
-    if?: JSONSchema7Definition | undefined;
-    then?: JSONSchema7Definition | undefined;
-    else?: JSONSchema7Definition | undefined;
-
-    /**
-     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.7
-     */
-    allOf?: JSONSchema7Definition[] | undefined;
-    anyOf?: JSONSchema7Definition[] | undefined;
-    oneOf?: JSONSchema7Definition[] | undefined;
-    not?: JSONSchema7Definition | undefined;
-
-    /**
-     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-7
-     */
-    format?: string | undefined;
-
-    /**
-     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-8
-     */
-    contentMediaType?: string | undefined;
-    contentEncoding?: string | undefined;
-
-    /**
-     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-9
-     */
-    definitions?: {
-        [key: string]: JSONSchema7Definition;
-    } | undefined;
-
-    /**
-     * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-10
-     */
-    title?: string | undefined;
-    description?: string | undefined;
-    default?: JSONSchema7Type | undefined;
-    readOnly?: boolean | undefined;
-    writeOnly?: boolean | undefined;
-    examples?: JSONSchema7Type | undefined;
-}
-
 type SharedV2Headers = Record<string, string>;
 
 /**
@@ -682,6 +1254,13 @@ interface LanguageModelV2FilePart {
   */
     data: LanguageModelV2DataContent;
     /**
+     * The original URL string before it was parsed into a `URL`.
+     *
+     * This is available when parsing would change the string and a provider
+     * needs to preserve an opaque non-HTTP URI exactly.
+     */
+    originalUrl?: string;
+    /**
   IANA media type of the file.
   
   Can support wildcards, e.g. `image/*` (in which case the provider needs to take appropriate action).
@@ -1680,7 +2259,7 @@ interface ProviderV2 {
 /** Azure OpenAI chat extension configuration for "On Your Data" RAG scenarios. */
 type AzureOpenAiChatExtensionConfiguration = NonNullable<AzureOpenAiChatCompletionParameters["data_sources"]>[number];
 /**
- * Common model parameters shared between both APIs.
+ * Common model parameters shared between APIs.
  *
  * Known parameters are validated by Zod in constructor settings and per-call
  * `modelParams` provider options; additional model-specific keys are passed through.
@@ -1768,6 +2347,12 @@ type OrchestrationModelParams = CommonModelParams;
 /** Model settings when using Orchestration API with filtering, grounding, masking, and translation. */
 interface OrchestrationModelSettings {
     readonly api?: "orchestration";
+    /**
+     * Whether Orchestration drops parameters unsupported by Responses-only models.
+     * Applies to the primary local model, not fallback models or stored configurations.
+     * Omitted values retain the SAP service default; false requests an explicit error.
+     */
+    readonly dropUnsupportedParams?: boolean;
     /** @default true */
     readonly escapeTemplatePlaceholders?: boolean;
     /**
@@ -1862,15 +2447,33 @@ interface PromptTemplateRefByScenarioNameVersion {
 type PromptTemplateScope = "resource_group" | "tenant";
 /** Response format for structured output (OpenAI-compatible). */
 type ResponseFormat = AzureOpenAiChatCompletionParameters["response_format"];
+/** Default settings configuration when using the Responses API. */
+interface ResponsesDefaultSettings {
+    readonly api: "responses";
+    readonly settings?: ResponsesModelSettings;
+}
+/** Model-specific Responses API options, validated by the OpenAI provider. */
+type ResponsesModelOptions = Omit<OpenAIResponsesProviderOptions, "metadata"> & {
+    readonly metadata?: null | Record<string, string>;
+};
+/** Model settings for the OpenAI Responses API through SAP AI Core. */
+interface ResponsesModelSettings {
+    readonly api: "responses";
+    readonly modelParams?: CommonModelParams;
+    readonly modelVersion?: string;
+    readonly responseFormat?: ResponseFormat;
+    readonly responses?: ResponsesModelOptions;
+}
 /**
  * Supported API types for SAP AI Core.
  *
  * - `'orchestration'` - Full-featured API with data masking, content filtering, document grounding, and translation.
  * - `'foundation-models'` - Direct model access with Azure OpenAI-specific parameters like `logprobs`, `seed`, and `dataSources`.
+ * - `'responses'` - OpenAI Responses API with native reasoning and tool-call history.
  */
-type SAPAIApiType = "foundation-models" | "orchestration";
+type SAPAIApiType = "foundation-models" | "orchestration" | "responses";
 /** Union type for API-specific default settings configuration. */
-type SAPAIDefaultSettingsConfig = FoundationModelsDefaultSettings | OrchestrationDefaultSettings;
+type SAPAIDefaultSettingsConfig = FoundationModelsDefaultSettings | OrchestrationDefaultSettings | ResponsesDefaultSettings;
 /** Settings for the SAP AI Embedding Model. */
 interface SAPAIEmbeddingSettings {
     readonly api?: SAPAIApiType;
@@ -1901,20 +2504,23 @@ interface SAPAIEmbeddingSettings {
  */
 type SAPAIModelId = ChatModel;
 /**
- * Union type for model settings - supports both APIs.
+ * Union type for API-specific model settings.
  *
  * Use `FoundationModelsModelSettings` for Foundation Models API features (dataSources, logprobs, seed).
  * Use `OrchestrationModelSettings` for Orchestration API features (filtering, grounding, masking, translation).
+ * Use `ResponsesModelSettings` for native OpenAI Responses options and reasoning history.
  */
-type SAPAIModelSettings = FoundationModelsModelSettings | OrchestrationModelSettings;
+type SAPAIModelSettings = FoundationModelsModelSettings | OrchestrationModelSettings | ResponsesModelSettings;
 
 /**
  * Settings for configuring SAP AI Core model behavior.
- * Legacy interface maintained for backward compatibility - prefer OrchestrationModelSettings
- * or FoundationModelsModelSettings for API-specific type safety.
+ * Legacy interface maintained for backward compatibility. Prefer the API-specific
+ * OrchestrationModelSettings, FoundationModelsModelSettings, or ResponsesModelSettings types.
  */
 interface SAPAISettings {
     readonly api?: SAPAIApiType;
+    /** Orchestration API only; controls unsupported parameters on the primary local model. */
+    readonly dropUnsupportedParams?: boolean;
     /** @default true */
     readonly escapeTemplatePlaceholders?: boolean;
     /** Orchestration API only. */
@@ -1941,6 +2547,8 @@ interface SAPAISettings {
     /** Orchestration API only. */
     readonly promptTemplateRef?: PromptTemplateRef;
     readonly responseFormat?: ResponseFormat;
+    /** Responses API only. */
+    readonly responses?: ResponsesModelOptions;
     /** Orchestration API only; ignored when `orchestrationConfigRef` is used. */
     readonly streamOptions?: OrchestrationStreamOptions;
     /** Orchestration API only. */
@@ -2122,7 +2730,7 @@ type ConvertedV2Warning = Extract<LanguageModelV2CallWarning, {
  * SAP AI Language Model V2 - Vercel AI SDK LanguageModelV2 implementation for SAP AI Core.
  *
  * This module provides the language model implementation that connects to SAP AI Core
- * services (Orchestration API or Foundation Models API) for text generation.
+ * services (Orchestration, Foundation Models Chat Completions, or OpenAI Responses) for text generation.
  * @see {@link https://sdk.vercel.ai/docs/reference/ai-sdk-core/generate-text | Vercel AI SDK generateText()}
  * @see {@link https://sdk.vercel.ai/docs/reference/ai-sdk-core/stream-text | Vercel AI SDK streamText()}
  */
@@ -2142,8 +2750,9 @@ interface SAPAILanguageModelV2Config {
  * SAP AI Language Model implementing Vercel AI SDK LanguageModelV2.
  *
  * This class provides chat completion and streaming capabilities through SAP AI Core,
- * supporting both the Orchestration API (with content filtering, grounding, masking,
- * and translation) and Foundation Models API (direct Azure OpenAI access).
+ * supporting the Orchestration API (with content filtering, grounding, masking,
+ * and translation), Foundation Models Chat Completions, and native OpenAI Responses
+ * through SAP AI Core.
  *
  * Users typically don't instantiate this class directly. Instead, use the
  * {@link createSAPAIProvider} factory function:
@@ -2226,6 +2835,7 @@ interface SAPAIProviderSettings {
      * This option does not enable automatic failover between APIs.
      * - `'orchestration'` (default): SAP AI Core Orchestration API - supports filtering, grounding, masking, translation
      * - `'foundation-models'`: SAP AI Core Foundation Models API - supports dataSources, logprobs, seed, etc.
+     * - `'responses'`: OpenAI Responses API through SAP AI Core - supports reasoning and tool-call history
      * @default 'orchestration'
      */
     readonly api?: SAPAIApiType;
@@ -2289,11 +2899,11 @@ interface SAPAIProviderV2 extends ProviderV2 {
  * Creates an SAP AI Provider V2 instance for use with AI SDK 5.
  * AI SDK 6 can also consume this provider through its V2 compatibility layer.
  *
- * Uses the official SAP AI SDK (`@sap-ai-sdk/orchestration` and
- * `@sap-ai-sdk/foundation-models`) for API communication. Authentication is automatic via service binding
- * (VCAP_SERVICES on SAP BTP) or AICORE_SERVICE_KEY environment variable.
+ * Uses SAP AI SDK clients for Orchestration and Foundation Models, and its HTTP
+ * transport with the OpenAI provider for Responses. Authentication uses a service
+ * binding (VCAP_SERVICES on SAP BTP) or the AICORE_SERVICE_KEY environment variable.
  * @param options - Provider configuration options.
- * @param options.api - Default API type: `'orchestration'` (default) or `'foundation-models'`.
+ * @param options.api - Default API type: `'orchestration'` (default), `'foundation-models'`, or `'responses'`.
  * @param options.defaultSettings - Default model settings applied to every model instance.
  * @param options.deploymentId - Explicit SAP AI Core deployment ID; omit for automatic deployment resolution.
  * @param options.destination - Custom SAP Cloud SDK destination configuration.
@@ -2335,10 +2945,12 @@ interface ValidateSettingsOptions {
     readonly embeddingSettings?: SAPAIEmbeddingSettings;
     readonly invocationSettings?: {
         readonly api?: SAPAIApiType;
+        readonly dropUnsupportedParams?: boolean;
         readonly escapeTemplatePlaceholders?: boolean;
         readonly orchestrationConfigRef?: unknown;
         readonly placeholderValues?: unknown;
         readonly promptTemplateRef?: unknown;
+        readonly responses?: unknown;
     };
     readonly modelApi?: SAPAIApiType;
     readonly modelSettings?: SAPAIModelSettings | SAPAISettings;
@@ -2375,4 +2987,5 @@ declare function validateSettings(options: ValidateSettingsOptions): void;
 /** Current package version from package.json, injected at build time. */
 declare const VERSION: string;
 
-export { ApiSwitchError, type AzureOpenAiChatExtensionConfiguration, type CommonModelParams, type DeploymentConfig, type FoundationModelsDefaultSettings, type FoundationModelsEmbeddingParams, type FoundationModelsModelParams, type FoundationModelsModelSettings, type OrchestrationDefaultSettings, type OrchestrationModelParams, type OrchestrationModelSettings, type OrchestrationStreamOptions, type PromptTemplateRef, type PromptTemplateRefByID, type PromptTemplateRefByScenarioNameVersion, type PromptTemplateScope, type ResponseFormat, type SAPAIApiType, type SAPAIDefaultSettingsConfig, SAPAIEmbeddingModelV2 as SAPAIEmbeddingModel, type SAPAIEmbeddingModelId, type SAPAIEmbeddingProviderOptions, type SAPAIEmbeddingSettings, SAPAILanguageModelV2 as SAPAILanguageModel, type SAPAILanguageModelProviderOptions, type SAPAIModelId, type SAPAIModelSettings, type SAPAIProviderV2 as SAPAIProvider, type SAPAIProviderSettings, type SAPAISettings, SAP_AI_PROVIDER_NAME, UnsupportedFeatureError, VERSION, createSAPAIProvider, escapeOrchestrationPlaceholders, getProviderName, resolveApi, sapAIEmbeddingProviderOptions, sapAILanguageModelProviderOptions, sapai, unescapeOrchestrationPlaceholders, validateSettings };
+export { ApiSwitchError, SAPAIEmbeddingModelV2 as SAPAIEmbeddingModel, SAPAILanguageModelV2 as SAPAILanguageModel, SAP_AI_PROVIDER_NAME, UnsupportedFeatureError, VERSION, createSAPAIProvider, escapeOrchestrationPlaceholders, getProviderName, resolveApi, sapAIEmbeddingProviderOptions, sapAILanguageModelProviderOptions, sapai, unescapeOrchestrationPlaceholders, validateSettings };
+export type { AzureOpenAiChatExtensionConfiguration, CommonModelParams, DeploymentConfig, FoundationModelsDefaultSettings, FoundationModelsEmbeddingParams, FoundationModelsModelParams, FoundationModelsModelSettings, JSONArray, JSONObject, JSONSchema7, JSONValue, LanguageModelV2ResponseMetadata, LanguageModelV3CallOptions, OrchestrationDefaultSettings, OrchestrationModelParams, OrchestrationModelSettings, OrchestrationStreamOptions, PromptTemplateRef, PromptTemplateRefByID, PromptTemplateRefByScenarioNameVersion, PromptTemplateScope, ResponseFormat, ResponsesDefaultSettings, ResponsesModelOptions, ResponsesModelSettings, SAPAIApiType, SAPAIDefaultSettingsConfig, SAPAIEmbeddingModelId, SAPAIEmbeddingProviderOptions, SAPAIEmbeddingSettings, SAPAILanguageModelProviderOptions, SAPAIModelId, SAPAIModelSettings, SAPAIProviderV2 as SAPAIProvider, SAPAIProviderSettings, SAPAISettings, JSONArray$1 as V3JSONArray, JSONObject$1 as V3JSONObject, JSONValue$1 as V3JSONValue };