@jerome-benoit/sap-ai-provider-v2 4.7.0 → 4.8.0

package/dist/index.d.cts

@@ -1,6 +1,9 @@
 import { EmbeddingModelV2, SharedV2ProviderOptions, SharedV2ProviderMetadata, SharedV2Headers, LanguageModelV2, LanguageModelV2CallOptions, LanguageModelV2Content, LanguageModelV2FinishReason, LanguageModelV2ResponseMetadata, LanguageModelV2Usage, LanguageModelV2CallWarning, LanguageModelV2StreamPart, ProviderV2, ImageModelV2 } from '@ai-sdk/provider';
 import { DeploymentIdConfig, ResourceGroupConfig } from '@sap-ai-sdk/ai-api/internal.js';
+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 { AzureOpenAiChatCompletionParameters } from '@sap-ai-sdk/foundation-models';
 import { OrchestrationModuleConfig, FilteringModule, GroundingModule, MaskingModule, OrchestrationConfigRef, 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, 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';
@@ -289,7 +292,7 @@ interface SAPAIEmbeddingSettings {
  *
  * Model availability depends on tenant configuration and region.
  * Common values include: `'gpt-4.1'`, `'gpt-4.1-mini'`, `'anthropic--claude-4.5-sonnet'`, `'gemini-2.5-pro'`.
- * @see {@link https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/models-and-scenarios-in-generative-ai-hub|SAP AI Core Models}
+ * @see {@link https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/models-and-scenarios-in-generative-ai-hub | SAP AI Core Models}
  */
 type SAPAIModelId = ChatModel;
 /**
@@ -310,6 +313,8 @@ interface SAPAISettings {
     /** @default true */
     readonly escapeTemplatePlaceholders?: boolean;
     /** Orchestration API only. */
+    readonly fallbackModuleConfigs?: OrchestrationModuleConfig[];
+    /** Orchestration API only. */
     readonly filtering?: FilteringModule;
     /** Orchestration API only. */
     readonly grounding?: GroundingModule;
@@ -351,6 +356,7 @@ interface SAPAIEmbeddingModelV2Config {
     readonly destination?: HttpDestinationOrFetchOptions;
     readonly provider: string;
     readonly providerApi?: SAPAIApiType;
+    readonly requestConfig?: CustomRequestConfig;
 }
 /**
  * SAP AI Core Embedding Model implementing Vercel AI SDK EmbeddingModelV2.
@@ -505,6 +511,7 @@ interface SAPAILanguageModelV2Config {
     readonly destination?: HttpDestinationOrFetchOptions;
     readonly provider: string;
     readonly providerApi?: SAPAIApiType;
+    readonly requestConfig?: CustomRequestConfig;
 }
 /**
  * SAP AI Language Model implementing Vercel AI SDK LanguageModelV2.
@@ -614,6 +621,21 @@ interface SAPAIProviderSettings {
      * @default 'sap-ai'
      */
     readonly name?: string;
+    /**
+     * Custom request configuration forwarded to the underlying SAP AI SDK client on every
+     * call created from this provider.
+     *
+     * Provider-level only (not overridable per-call via `providerOptions['sap-ai']`). The
+     * AI SDK `abortSignal` option always wins over any `signal` on `requestConfig`; the
+     * latter is dropped before the request is forwarded. Node-only knobs (`httpAgent`,
+     * `httpsAgent`) are silently ignored on Edge / Cloudflare Workers runtimes.
+     *
+     * See the "Note on `requestConfig`" section under `SAPAIProviderSettings` in
+     * `API_REFERENCE.md` for the full SAP AI Core `AI-*` header guidance.
+     * @see {@link https://sap.github.io/ai-sdk/docs/js/getting-started | SAP Cloud SDK for AI (JS)}
+     * @see {@link https://github.com/jerome-benoit/sap-ai-provider/blob/main/API_REFERENCE.md#requestconfig-note | Note on `requestConfig` (API_REFERENCE.md)}
+     */
+    readonly requestConfig?: CustomRequestConfig;
     /**
      * SAP AI Core resource group for resource isolation and access control.
      * @default 'default'
@@ -644,6 +666,7 @@ interface SAPAIProviderV2 extends ProviderV2 {
  * @param options.destination - Custom SAP Cloud SDK destination configuration.
  * @param options.logLevel - Log level for SAP Cloud SDK loggers (`'debug'`, `'info'`, `'warn'`, `'error'`).
  * @param options.name - Provider name used as key in `providerOptions` (default: `'sap-ai'`).
+ * @param options.requestConfig - Provider-level custom request configuration. See {@link SAPAIProviderSettings.requestConfig} for scope, portability, and abort semantics.
  * @param options.resourceGroup - SAP AI Core resource group (default: `'default'`).
  * @param options.warnOnAmbiguousConfig - Whether to warn when both deploymentId and resourceGroup are set.
  * @returns A configured SAP AI provider instance that can be used as a callable or via methods.

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 import { EmbeddingModelV2, SharedV2ProviderOptions, SharedV2ProviderMetadata, SharedV2Headers, LanguageModelV2, LanguageModelV2CallOptions, LanguageModelV2Content, LanguageModelV2FinishReason, LanguageModelV2ResponseMetadata, LanguageModelV2Usage, LanguageModelV2CallWarning, LanguageModelV2StreamPart, ProviderV2, ImageModelV2 } from '@ai-sdk/provider';
 import { DeploymentIdConfig, ResourceGroupConfig } from '@sap-ai-sdk/ai-api/internal.js';
+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 { AzureOpenAiChatCompletionParameters } from '@sap-ai-sdk/foundation-models';
 import { OrchestrationModuleConfig, FilteringModule, GroundingModule, MaskingModule, OrchestrationConfigRef, 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, 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';
@@ -289,7 +292,7 @@ interface SAPAIEmbeddingSettings {
  *
  * Model availability depends on tenant configuration and region.
  * Common values include: `'gpt-4.1'`, `'gpt-4.1-mini'`, `'anthropic--claude-4.5-sonnet'`, `'gemini-2.5-pro'`.
- * @see {@link https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/models-and-scenarios-in-generative-ai-hub|SAP AI Core Models}
+ * @see {@link https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/models-and-scenarios-in-generative-ai-hub | SAP AI Core Models}
  */
 type SAPAIModelId = ChatModel;
 /**
@@ -310,6 +313,8 @@ interface SAPAISettings {
     /** @default true */
     readonly escapeTemplatePlaceholders?: boolean;
     /** Orchestration API only. */
+    readonly fallbackModuleConfigs?: OrchestrationModuleConfig[];
+    /** Orchestration API only. */
     readonly filtering?: FilteringModule;
     /** Orchestration API only. */
     readonly grounding?: GroundingModule;
@@ -351,6 +356,7 @@ interface SAPAIEmbeddingModelV2Config {
     readonly destination?: HttpDestinationOrFetchOptions;
     readonly provider: string;
     readonly providerApi?: SAPAIApiType;
+    readonly requestConfig?: CustomRequestConfig;
 }
 /**
  * SAP AI Core Embedding Model implementing Vercel AI SDK EmbeddingModelV2.
@@ -505,6 +511,7 @@ interface SAPAILanguageModelV2Config {
     readonly destination?: HttpDestinationOrFetchOptions;
     readonly provider: string;
     readonly providerApi?: SAPAIApiType;
+    readonly requestConfig?: CustomRequestConfig;
 }
 /**
  * SAP AI Language Model implementing Vercel AI SDK LanguageModelV2.
@@ -614,6 +621,21 @@ interface SAPAIProviderSettings {
      * @default 'sap-ai'
      */
     readonly name?: string;
+    /**
+     * Custom request configuration forwarded to the underlying SAP AI SDK client on every
+     * call created from this provider.
+     *
+     * Provider-level only (not overridable per-call via `providerOptions['sap-ai']`). The
+     * AI SDK `abortSignal` option always wins over any `signal` on `requestConfig`; the
+     * latter is dropped before the request is forwarded. Node-only knobs (`httpAgent`,
+     * `httpsAgent`) are silently ignored on Edge / Cloudflare Workers runtimes.
+     *
+     * See the "Note on `requestConfig`" section under `SAPAIProviderSettings` in
+     * `API_REFERENCE.md` for the full SAP AI Core `AI-*` header guidance.
+     * @see {@link https://sap.github.io/ai-sdk/docs/js/getting-started | SAP Cloud SDK for AI (JS)}
+     * @see {@link https://github.com/jerome-benoit/sap-ai-provider/blob/main/API_REFERENCE.md#requestconfig-note | Note on `requestConfig` (API_REFERENCE.md)}
+     */
+    readonly requestConfig?: CustomRequestConfig;
     /**
      * SAP AI Core resource group for resource isolation and access control.
      * @default 'default'
@@ -644,6 +666,7 @@ interface SAPAIProviderV2 extends ProviderV2 {
  * @param options.destination - Custom SAP Cloud SDK destination configuration.
  * @param options.logLevel - Log level for SAP Cloud SDK loggers (`'debug'`, `'info'`, `'warn'`, `'error'`).
  * @param options.name - Provider name used as key in `providerOptions` (default: `'sap-ai'`).
+ * @param options.requestConfig - Provider-level custom request configuration. See {@link SAPAIProviderSettings.requestConfig} for scope, portability, and abort semantics.
  * @param options.resourceGroup - SAP AI Core resource group (default: `'default'`).
  * @param options.warnOnAmbiguousConfig - Whether to warn when both deploymentId and resourceGroup are set.
  * @returns A configured SAP AI provider instance that can be used as a callable or via methods.

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   mergeSettingsWithApi,
   resolveApi,
   validateSettings
-} from "./chunk-WDUOKIKD.js";
+} from "./chunk-KVOLFUQJ.js";
 import {
   escapeOrchestrationPlaceholders,
   unescapeOrchestrationPlaceholders
@@ -20,7 +20,7 @@ import {
   sapAILanguageModelProviderOptions,
   validateEmbeddingModelParamsSettings,
   validateModelParamsSettings
-} from "./chunk-TVXWNZQT.js";
+} from "./chunk-3ZSXTKOK.js";
 
 // src/sap-ai-adapters-v3-to-v2.ts
 function convertFinishReasonToV2(internalFinishReason) {
@@ -253,21 +253,21 @@ function getOrCreateLanguageModelStrategy(api) {
 async function createEmbeddingModelStrategy(api) {
   if (api === "foundation-models") {
     const { AzureOpenAiEmbeddingClient } = await import("@sap-ai-sdk/foundation-models");
-    const { FoundationModelsEmbeddingModelStrategy } = await import("./foundation-models-embedding-model-strategy-YWPDIJEN.js");
+    const { FoundationModelsEmbeddingModelStrategy } = await import("./foundation-models-embedding-model-strategy-SWRJNFD4.js");
     return new FoundationModelsEmbeddingModelStrategy(AzureOpenAiEmbeddingClient);
   }
   const { OrchestrationEmbeddingClient: OrchestrationEmbeddingClient2 } = await import("@sap-ai-sdk/orchestration");
-  const { OrchestrationEmbeddingModelStrategy } = await import("./orchestration-embedding-model-strategy-66QYAO64.js");
+  const { OrchestrationEmbeddingModelStrategy } = await import("./orchestration-embedding-model-strategy-C5G735Q2.js");
   return new OrchestrationEmbeddingModelStrategy(OrchestrationEmbeddingClient2);
 }
 async function createLanguageModelStrategy(api) {
   if (api === "foundation-models") {
     const { AzureOpenAiChatClient } = await import("@sap-ai-sdk/foundation-models");
-    const { FoundationModelsLanguageModelStrategy } = await import("./foundation-models-language-model-strategy-WDSQWU64.js");
+    const { FoundationModelsLanguageModelStrategy } = await import("./foundation-models-language-model-strategy-LRAC25ZY.js");
     return new FoundationModelsLanguageModelStrategy(AzureOpenAiChatClient);
   }
   const { OrchestrationClient: OrchestrationClient2 } = await import("@sap-ai-sdk/orchestration");
-  const { OrchestrationLanguageModelStrategy } = await import("./orchestration-language-model-strategy-4TKRZK7U.js");
+  const { OrchestrationLanguageModelStrategy } = await import("./orchestration-language-model-strategy-NUHYRIXH.js");
   return new OrchestrationLanguageModelStrategy(OrchestrationClient2);
 }
 
@@ -316,7 +316,8 @@ var SAPAIEmbeddingModel = class {
       deploymentConfig: this.config.deploymentConfig,
       destination: this.config.destination,
       modelId: this.modelId,
-      provider: this.config.provider
+      provider: this.config.provider,
+      requestConfig: this.config.requestConfig
     };
     return strategy.doEmbed(strategyConfig, this.settings, options, this.maxEmbeddingsPerCall);
   }
@@ -452,7 +453,8 @@ var SAPAILanguageModel = class {
       deploymentConfig: this.config.deploymentConfig,
       destination: this.config.destination,
       modelId: this.modelId,
-      provider: this.config.provider
+      provider: this.config.provider,
+      requestConfig: this.config.requestConfig
     };
     return { strategy, strategyConfig };
   }
@@ -545,7 +547,8 @@ function createSAPAIProvider(options = {}) {
       deploymentConfig,
       destination: options.destination,
       provider: `${providerName}.chat`,
-      providerApi
+      providerApi,
+      requestConfig: options.requestConfig
     });
   };
   const createEmbeddingModel = (modelId, settings = {}) => {
@@ -561,7 +564,8 @@ function createSAPAIProvider(options = {}) {
       deploymentConfig,
       destination: options.destination,
       provider: `${providerName}.embedding`,
-      providerApi
+      providerApi,
+      requestConfig: options.requestConfig
     });
   };
   const provider = function(modelId, settings) {