@jerome-benoit/sap-ai-provider 4.2.2 → 4.2.3

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { EmbeddingModelV3, EmbeddingModelV3CallOptions, EmbeddingModelV3Result, LanguageModelV3, LanguageModelV3CallOptions, LanguageModelV3GenerateResult, LanguageModelV3StreamResult, ProviderV3 } from '@ai-sdk/provider';
 import { DeploymentIdConfig, ResourceGroupConfig } from '@sap-ai-sdk/ai-api/internal.js';
-import { EmbeddingModelParams, FilteringModule, GroundingModule, MaskingModule, ChatCompletionTool, TranslationModule, ChatModel } from '@sap-ai-sdk/orchestration';
+import { EmbeddingModelParams, ChatModel, FilteringModule, GroundingModule, MaskingModule, ChatCompletionTool, TranslationModule } from '@sap-ai-sdk/orchestration';
 export { AssistantChatMessage, ChatCompletionRequest, ChatCompletionTool, ChatMessage, DeveloperChatMessage, DocumentTranslationApplyToSelector, FilteringModule, FunctionObject, GroundingModule, LlmModelDetails, LlmModelParams, MaskingModule, OrchestrationClient, OrchestrationConfigRef, OrchestrationEmbeddingClient, OrchestrationErrorResponse, OrchestrationModuleConfig, OrchestrationResponse, OrchestrationStreamChunkResponse, OrchestrationStreamResponse, PromptTemplatingModule, SystemChatMessage, ToolChatMessage, TranslationApplyToCategory, TranslationInputParameters, TranslationModule, TranslationOutputParameters, TranslationTargetLanguage, UserChatMessage, buildAzureContentSafetyFilter, buildDocumentGroundingConfig, buildDpiMaskingProvider, buildLlamaGuard38BFilter, buildTranslationConfig, isConfigReference } from '@sap-ai-sdk/orchestration';
 import { HttpDestinationOrFetchOptions } from '@sap-cloud-sdk/connectivity';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
@@ -8,6 +8,8 @@ import { InferSchema } from '@ai-sdk/provider-utils';
 
 /**
  * SAP AI Embedding Model - Vercel AI SDK EmbeddingModelV3 implementation for SAP AI Core.
+ *
+ * This is the main implementation containing all business logic for SAP AI Core embedding generation.
  * @module sap-ai-embedding-model
  */
 
@@ -33,9 +35,10 @@ interface SAPAIEmbeddingSettings {
     readonly type?: "document" | "query" | "text";
 }
 /**
+ * Internal configuration for SAP AI Embedding Model.
  * @internal
  */
-interface SAPAIEmbeddingConfig {
+interface SAPAIEmbeddingModelConfig {
     readonly deploymentConfig: DeploymentIdConfig | ResourceGroupConfig;
     readonly destination?: HttpDestinationOrFetchOptions;
     readonly provider: string;
@@ -63,11 +66,21 @@ declare class SAPAIEmbeddingModel implements EmbeddingModelV3 {
     readonly supportsParallelCalls: boolean;
     private readonly config;
     private readonly settings;
-    constructor(modelId: SAPAIEmbeddingModelId, settings: SAPAIEmbeddingSettings | undefined, config: SAPAIEmbeddingConfig);
+    /**
+     * Creates a new SAP AI Embedding Model instance.
+     *
+     * This is the main implementation that handles all SAP AI Core embedding logic.
+     * @param modelId - The model identifier (e.g., 'text-embedding-ada-002', 'text-embedding-3-small').
+     * @param settings - Model configuration settings (embedding type, model parameters, etc.). Defaults to {}.
+     * @param config - SAP AI Core deployment and destination configuration.
+     */
+    constructor(modelId: SAPAIEmbeddingModelId, settings: SAPAIEmbeddingSettings | undefined, config: SAPAIEmbeddingModelConfig);
     /**
      * Generates embeddings for the given input values.
-     * @param options - The Vercel AI SDK embedding call options.
-     * @returns The embedding result with vectors and usage data.
+     *
+     * Validates input count, merges settings, calls SAP AI SDK, and normalizes embeddings.
+     * @param options - The Vercel AI SDK V3 embedding call options.
+     * @returns The embedding result with vectors, usage data, and warnings.
      */
     doEmbed(options: EmbeddingModelV3CallOptions): Promise<EmbeddingModelV3Result>;
     /**
@@ -86,43 +99,6 @@ declare class SAPAIEmbeddingModel implements EmbeddingModelV3 {
     private normalizeEmbedding;
 }
 
-/** Default provider name used as key in `providerOptions` and `providerMetadata` objects. */
-declare const SAP_AI_PROVIDER_NAME: "sap-ai";
-/**
- * Extracts the provider name from a provider identifier (e.g., "sap-ai.chat" → "sap-ai").
- * @param providerIdentifier - The full provider identifier string.
- * @returns The provider name without any suffix.
- */
-declare function getProviderName(providerIdentifier: string): string;
-/** Zod schema for SAP AI language model provider options passed via `providerOptions['sap-ai']` object. */
-declare const sapAILanguageModelProviderOptions: _ai_sdk_provider_utils.LazySchema<{
-    includeReasoning?: boolean | undefined;
-    modelParams?: {
-        [x: string]: unknown;
-        frequencyPenalty?: number | undefined;
-        maxTokens?: number | undefined;
-        n?: number | undefined;
-        parallel_tool_calls?: boolean | undefined;
-        presencePenalty?: number | undefined;
-        temperature?: number | undefined;
-        topP?: number | undefined;
-    } | undefined;
-}>;
-/** SAP AI language model provider options type inferred from Zod schema. */
-type SAPAILanguageModelProviderOptions = InferSchema<typeof sapAILanguageModelProviderOptions>;
-/** Zod schema for SAP AI embedding model provider options passed via `providerOptions['sap-ai']` object. */
-declare const sapAIEmbeddingProviderOptions: _ai_sdk_provider_utils.LazySchema<{
-    modelParams?: {
-        [x: string]: unknown;
-        dimensions?: number | undefined;
-        encoding_format?: "base64" | "binary" | "float" | undefined;
-        normalize?: boolean | undefined;
-    } | undefined;
-    type?: "document" | "query" | "text" | undefined;
-}>;
-/** SAP AI embedding model provider options type inferred from Zod schema. */
-type SAPAIEmbeddingProviderOptions = InferSchema<typeof sapAIEmbeddingProviderOptions>;
-
 /**
  * Supported model IDs in SAP AI Core.
  * Actual availability depends on your SAP AI Core tenant configuration.
@@ -185,18 +161,21 @@ interface SAPAISettings {
 
 /**
  * SAP AI Language Model - Vercel AI SDK LanguageModelV3 implementation for SAP AI Core Orchestration.
+ *
+ * This is the main implementation containing all business logic for SAP AI Core integration.
  */
 
 /**
+ * Internal configuration for SAP AI Language Model.
  * @internal
  */
-interface SAPAIConfig {
+interface SAPAILanguageModelConfig {
     readonly deploymentConfig: DeploymentIdConfig | ResourceGroupConfig;
     readonly destination?: HttpDestinationOrFetchOptions;
     readonly provider: string;
 }
 /**
- * SAP AI Chat Language Model implementing Vercel AI SDK LanguageModelV3.
+ * SAP AI Language Model implementing Vercel AI SDK LanguageModelV3.
  *
  * Features: text generation, tool calling, multi-modal input, data masking, content filtering.
  * Supports: Azure OpenAI, Google Vertex AI, AWS Bedrock, AI Core open source models.
@@ -234,23 +213,31 @@ declare class SAPAILanguageModel implements LanguageModelV3 {
     private readonly settings;
     /**
      * Creates a new SAP AI Language Model instance.
-     * @param modelId - The model identifier (e.g., 'gpt-4', 'claude-3').
-     * @param settings - Model configuration settings.
+     *
+     * This is the main implementation that handles all SAP AI Core orchestration logic.
+     * @param modelId - The model identifier (e.g., 'gpt-4o', 'claude-3-5-sonnet', 'gemini-2.0-flash').
+     * @param settings - Model configuration settings (temperature, max tokens, filtering, etc.).
      * @param config - SAP AI Core deployment and destination configuration.
      * @internal
      */
-    constructor(modelId: SAPAIModelId, settings: SAPAISettings, config: SAPAIConfig);
+    constructor(modelId: SAPAIModelId, settings: SAPAISettings, config: SAPAILanguageModelConfig);
     /**
      * Generates a single completion (non-streaming).
-     * Note: Abort signal uses Promise.race; doesn't cancel underlying HTTP request.
-     * @param options - The Vercel AI SDK generation call options.
-     * @returns The generation result with content, usage, and provider metadata.
+     *
+     * Builds orchestration configuration, converts messages, validates parameters,
+     * calls SAP AI SDK, and processes the response.
+     * Supports request cancellation via AbortSignal at the HTTP transport layer.
+     * @param options - The Vercel AI SDK V3 generation call options.
+     * @returns The generation result with content, usage, warnings, and provider metadata.
      */
     doGenerate(options: LanguageModelV3CallOptions): Promise<LanguageModelV3GenerateResult>;
     /**
      * Generates a streaming completion.
-     * Note: Abort signal uses Promise.race; doesn't cancel underlying HTTP request.
-     * @param options - The Vercel AI SDK generation call options.
+     *
+     * Builds orchestration configuration, creates streaming client, and transforms
+     * the stream with proper event handling (text blocks, tool calls, finish reason).
+     * Supports request cancellation via AbortSignal at the HTTP transport layer.
+     * @param options - The Vercel AI SDK V3 generation call options.
      * @returns A stream result with async iterable stream parts.
      */
     doStream(options: LanguageModelV3CallOptions): Promise<LanguageModelV3StreamResult>;
@@ -276,18 +263,55 @@ declare class SAPAILanguageModel implements LanguageModelV3 {
     private createClient;
 }
 
+/** Default provider name used as key in `providerOptions` and `providerMetadata` objects. */
+declare const SAP_AI_PROVIDER_NAME: "sap-ai";
+/**
+ * Extracts the provider name from a provider identifier (e.g., "sap-ai.chat" → "sap-ai").
+ * @param providerIdentifier - The full provider identifier string.
+ * @returns The provider name without any suffix.
+ */
+declare function getProviderName(providerIdentifier: string): string;
+/** Zod schema for SAP AI language model provider options passed via `providerOptions['sap-ai']` object. */
+declare const sapAILanguageModelProviderOptions: _ai_sdk_provider_utils.LazySchema<{
+    includeReasoning?: boolean | undefined;
+    modelParams?: {
+        [x: string]: unknown;
+        frequencyPenalty?: number | undefined;
+        maxTokens?: number | undefined;
+        n?: number | undefined;
+        parallel_tool_calls?: boolean | undefined;
+        presencePenalty?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+    } | undefined;
+}>;
+/** SAP AI language model provider options type inferred from Zod schema. */
+type SAPAILanguageModelProviderOptions = InferSchema<typeof sapAILanguageModelProviderOptions>;
+/** Zod schema for SAP AI embedding model provider options passed via `providerOptions['sap-ai']` object. */
+declare const sapAIEmbeddingProviderOptions: _ai_sdk_provider_utils.LazySchema<{
+    modelParams?: {
+        [x: string]: unknown;
+        dimensions?: number | undefined;
+        encoding_format?: "base64" | "binary" | "float" | undefined;
+        normalize?: boolean | undefined;
+    } | undefined;
+    type?: "document" | "query" | "text" | undefined;
+}>;
+/** SAP AI embedding model provider options type inferred from Zod schema. */
+type SAPAIEmbeddingProviderOptions = InferSchema<typeof sapAIEmbeddingProviderOptions>;
+
 /** Deployment configuration type used by the SAP AI SDK. */
 type DeploymentConfig = DeploymentIdConfig | ResourceGroupConfig;
 /**
  * SAP AI Provider interface for creating and configuring SAP AI Core models.
- * Extends the standard Vercel AI SDK ProviderV3 interface with SAP-specific functionality.
+ * Extends the Vercel AI SDK ProviderV3 interface with SAP-specific functionality.
  */
 interface SAPAIProvider extends ProviderV3 {
     /** Creates a language model instance. */
     (modelId: SAPAIModelId, settings?: SAPAISettings): SAPAILanguageModel;
-    /** Creates a chat model instance (equivalent to calling the provider function directly). */
+    /** Creates a language model instance (custom convenience method). */
     chat(modelId: SAPAIModelId, settings?: SAPAISettings): SAPAILanguageModel;
-    /** Creates an embedding model instance. */
+    /** Creates an embedding model instance (custom convenience method). */
     embedding(modelId: SAPAIEmbeddingModelId, settings?: SAPAIEmbeddingSettings): SAPAIEmbeddingModel;
     /** Creates an embedding model instance (Vercel AI SDK ProviderV3 standard method). */
     embeddingModel(modelId: SAPAIEmbeddingModelId, settings?: SAPAIEmbeddingSettings): SAPAIEmbeddingModel;
@@ -315,6 +339,13 @@ interface SAPAIProviderSettings {
     readonly deploymentId?: string;
     /** Custom destination configuration for SAP AI Core. */
     readonly destination?: HttpDestinationOrFetchOptions;
+    /**
+     * Log level for SAP Cloud SDK loggers.
+     * Controls verbosity of internal SAP SDK logging (e.g., authentication, service binding).
+     * Note: SAP_CLOUD_SDK_LOG_LEVEL environment variable takes precedence if set.
+     * @default 'warn'
+     */
+    readonly logLevel?: "debug" | "error" | "info" | "warn";
     /**
      * Provider name used as key for `providerOptions` and `providerMetadata`.
      * @default 'sap-ai'
@@ -341,4 +372,4 @@ declare function createSAPAIProvider(options?: SAPAIProviderSettings): SAPAIProv
 /** Default SAP AI provider instance with automatic authentication via SAP AI SDK. */
 declare const sapai: SAPAIProvider;
 
-export { type DeploymentConfig, SAPAIEmbeddingModel, type SAPAIEmbeddingModelId, type SAPAIEmbeddingProviderOptions, type SAPAIEmbeddingSettings, type SAPAILanguageModelProviderOptions, type SAPAIModelId, type SAPAIProvider, type SAPAIProviderSettings, type SAPAISettings, SAP_AI_PROVIDER_NAME, createSAPAIProvider, getProviderName, sapAIEmbeddingProviderOptions, sapAILanguageModelProviderOptions, sapai };
+export { type DeploymentConfig, SAPAIEmbeddingModel, type SAPAIEmbeddingModelId, type SAPAIEmbeddingProviderOptions, type SAPAIEmbeddingSettings, SAPAILanguageModel, type SAPAILanguageModelProviderOptions, type SAPAIModelId, type SAPAIProvider, type SAPAIProviderSettings, type SAPAISettings, SAP_AI_PROVIDER_NAME, createSAPAIProvider, getProviderName, sapAIEmbeddingProviderOptions, sapAILanguageModelProviderOptions, sapai };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { EmbeddingModelV3, EmbeddingModelV3CallOptions, EmbeddingModelV3Result, LanguageModelV3, LanguageModelV3CallOptions, LanguageModelV3GenerateResult, LanguageModelV3StreamResult, ProviderV3 } from '@ai-sdk/provider';
 import { DeploymentIdConfig, ResourceGroupConfig } from '@sap-ai-sdk/ai-api/internal.js';
-import { EmbeddingModelParams, FilteringModule, GroundingModule, MaskingModule, ChatCompletionTool, TranslationModule, ChatModel } from '@sap-ai-sdk/orchestration';
+import { EmbeddingModelParams, ChatModel, FilteringModule, GroundingModule, MaskingModule, ChatCompletionTool, TranslationModule } from '@sap-ai-sdk/orchestration';
 export { AssistantChatMessage, ChatCompletionRequest, ChatCompletionTool, ChatMessage, DeveloperChatMessage, DocumentTranslationApplyToSelector, FilteringModule, FunctionObject, GroundingModule, LlmModelDetails, LlmModelParams, MaskingModule, OrchestrationClient, OrchestrationConfigRef, OrchestrationEmbeddingClient, OrchestrationErrorResponse, OrchestrationModuleConfig, OrchestrationResponse, OrchestrationStreamChunkResponse, OrchestrationStreamResponse, PromptTemplatingModule, SystemChatMessage, ToolChatMessage, TranslationApplyToCategory, TranslationInputParameters, TranslationModule, TranslationOutputParameters, TranslationTargetLanguage, UserChatMessage, buildAzureContentSafetyFilter, buildDocumentGroundingConfig, buildDpiMaskingProvider, buildLlamaGuard38BFilter, buildTranslationConfig, isConfigReference } from '@sap-ai-sdk/orchestration';
 import { HttpDestinationOrFetchOptions } from '@sap-cloud-sdk/connectivity';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
@@ -8,6 +8,8 @@ import { InferSchema } from '@ai-sdk/provider-utils';
 
 /**
  * SAP AI Embedding Model - Vercel AI SDK EmbeddingModelV3 implementation for SAP AI Core.
+ *
+ * This is the main implementation containing all business logic for SAP AI Core embedding generation.
  * @module sap-ai-embedding-model
  */
 
@@ -33,9 +35,10 @@ interface SAPAIEmbeddingSettings {
     readonly type?: "document" | "query" | "text";
 }
 /**
+ * Internal configuration for SAP AI Embedding Model.
  * @internal
  */
-interface SAPAIEmbeddingConfig {
+interface SAPAIEmbeddingModelConfig {
     readonly deploymentConfig: DeploymentIdConfig | ResourceGroupConfig;
     readonly destination?: HttpDestinationOrFetchOptions;
     readonly provider: string;
@@ -63,11 +66,21 @@ declare class SAPAIEmbeddingModel implements EmbeddingModelV3 {
     readonly supportsParallelCalls: boolean;
     private readonly config;
     private readonly settings;
-    constructor(modelId: SAPAIEmbeddingModelId, settings: SAPAIEmbeddingSettings | undefined, config: SAPAIEmbeddingConfig);
+    /**
+     * Creates a new SAP AI Embedding Model instance.
+     *
+     * This is the main implementation that handles all SAP AI Core embedding logic.
+     * @param modelId - The model identifier (e.g., 'text-embedding-ada-002', 'text-embedding-3-small').
+     * @param settings - Model configuration settings (embedding type, model parameters, etc.). Defaults to {}.
+     * @param config - SAP AI Core deployment and destination configuration.
+     */
+    constructor(modelId: SAPAIEmbeddingModelId, settings: SAPAIEmbeddingSettings | undefined, config: SAPAIEmbeddingModelConfig);
     /**
      * Generates embeddings for the given input values.
-     * @param options - The Vercel AI SDK embedding call options.
-     * @returns The embedding result with vectors and usage data.
+     *
+     * Validates input count, merges settings, calls SAP AI SDK, and normalizes embeddings.
+     * @param options - The Vercel AI SDK V3 embedding call options.
+     * @returns The embedding result with vectors, usage data, and warnings.
      */
     doEmbed(options: EmbeddingModelV3CallOptions): Promise<EmbeddingModelV3Result>;
     /**
@@ -86,43 +99,6 @@ declare class SAPAIEmbeddingModel implements EmbeddingModelV3 {
     private normalizeEmbedding;
 }
 
-/** Default provider name used as key in `providerOptions` and `providerMetadata` objects. */
-declare const SAP_AI_PROVIDER_NAME: "sap-ai";
-/**
- * Extracts the provider name from a provider identifier (e.g., "sap-ai.chat" → "sap-ai").
- * @param providerIdentifier - The full provider identifier string.
- * @returns The provider name without any suffix.
- */
-declare function getProviderName(providerIdentifier: string): string;
-/** Zod schema for SAP AI language model provider options passed via `providerOptions['sap-ai']` object. */
-declare const sapAILanguageModelProviderOptions: _ai_sdk_provider_utils.LazySchema<{
-    includeReasoning?: boolean | undefined;
-    modelParams?: {
-        [x: string]: unknown;
-        frequencyPenalty?: number | undefined;
-        maxTokens?: number | undefined;
-        n?: number | undefined;
-        parallel_tool_calls?: boolean | undefined;
-        presencePenalty?: number | undefined;
-        temperature?: number | undefined;
-        topP?: number | undefined;
-    } | undefined;
-}>;
-/** SAP AI language model provider options type inferred from Zod schema. */
-type SAPAILanguageModelProviderOptions = InferSchema<typeof sapAILanguageModelProviderOptions>;
-/** Zod schema for SAP AI embedding model provider options passed via `providerOptions['sap-ai']` object. */
-declare const sapAIEmbeddingProviderOptions: _ai_sdk_provider_utils.LazySchema<{
-    modelParams?: {
-        [x: string]: unknown;
-        dimensions?: number | undefined;
-        encoding_format?: "base64" | "binary" | "float" | undefined;
-        normalize?: boolean | undefined;
-    } | undefined;
-    type?: "document" | "query" | "text" | undefined;
-}>;
-/** SAP AI embedding model provider options type inferred from Zod schema. */
-type SAPAIEmbeddingProviderOptions = InferSchema<typeof sapAIEmbeddingProviderOptions>;
-
 /**
  * Supported model IDs in SAP AI Core.
  * Actual availability depends on your SAP AI Core tenant configuration.
@@ -185,18 +161,21 @@ interface SAPAISettings {
 
 /**
  * SAP AI Language Model - Vercel AI SDK LanguageModelV3 implementation for SAP AI Core Orchestration.
+ *
+ * This is the main implementation containing all business logic for SAP AI Core integration.
  */
 
 /**
+ * Internal configuration for SAP AI Language Model.
  * @internal
  */
-interface SAPAIConfig {
+interface SAPAILanguageModelConfig {
     readonly deploymentConfig: DeploymentIdConfig | ResourceGroupConfig;
     readonly destination?: HttpDestinationOrFetchOptions;
     readonly provider: string;
 }
 /**
- * SAP AI Chat Language Model implementing Vercel AI SDK LanguageModelV3.
+ * SAP AI Language Model implementing Vercel AI SDK LanguageModelV3.
  *
  * Features: text generation, tool calling, multi-modal input, data masking, content filtering.
  * Supports: Azure OpenAI, Google Vertex AI, AWS Bedrock, AI Core open source models.
@@ -234,23 +213,31 @@ declare class SAPAILanguageModel implements LanguageModelV3 {
     private readonly settings;
     /**
      * Creates a new SAP AI Language Model instance.
-     * @param modelId - The model identifier (e.g., 'gpt-4', 'claude-3').
-     * @param settings - Model configuration settings.
+     *
+     * This is the main implementation that handles all SAP AI Core orchestration logic.
+     * @param modelId - The model identifier (e.g., 'gpt-4o', 'claude-3-5-sonnet', 'gemini-2.0-flash').
+     * @param settings - Model configuration settings (temperature, max tokens, filtering, etc.).
      * @param config - SAP AI Core deployment and destination configuration.
      * @internal
      */
-    constructor(modelId: SAPAIModelId, settings: SAPAISettings, config: SAPAIConfig);
+    constructor(modelId: SAPAIModelId, settings: SAPAISettings, config: SAPAILanguageModelConfig);
     /**
      * Generates a single completion (non-streaming).
-     * Note: Abort signal uses Promise.race; doesn't cancel underlying HTTP request.
-     * @param options - The Vercel AI SDK generation call options.
-     * @returns The generation result with content, usage, and provider metadata.
+     *
+     * Builds orchestration configuration, converts messages, validates parameters,
+     * calls SAP AI SDK, and processes the response.
+     * Supports request cancellation via AbortSignal at the HTTP transport layer.
+     * @param options - The Vercel AI SDK V3 generation call options.
+     * @returns The generation result with content, usage, warnings, and provider metadata.
      */
     doGenerate(options: LanguageModelV3CallOptions): Promise<LanguageModelV3GenerateResult>;
     /**
      * Generates a streaming completion.
-     * Note: Abort signal uses Promise.race; doesn't cancel underlying HTTP request.
-     * @param options - The Vercel AI SDK generation call options.
+     *
+     * Builds orchestration configuration, creates streaming client, and transforms
+     * the stream with proper event handling (text blocks, tool calls, finish reason).
+     * Supports request cancellation via AbortSignal at the HTTP transport layer.
+     * @param options - The Vercel AI SDK V3 generation call options.
      * @returns A stream result with async iterable stream parts.
      */
     doStream(options: LanguageModelV3CallOptions): Promise<LanguageModelV3StreamResult>;
@@ -276,18 +263,55 @@ declare class SAPAILanguageModel implements LanguageModelV3 {
     private createClient;
 }
 
+/** Default provider name used as key in `providerOptions` and `providerMetadata` objects. */
+declare const SAP_AI_PROVIDER_NAME: "sap-ai";
+/**
+ * Extracts the provider name from a provider identifier (e.g., "sap-ai.chat" → "sap-ai").
+ * @param providerIdentifier - The full provider identifier string.
+ * @returns The provider name without any suffix.
+ */
+declare function getProviderName(providerIdentifier: string): string;
+/** Zod schema for SAP AI language model provider options passed via `providerOptions['sap-ai']` object. */
+declare const sapAILanguageModelProviderOptions: _ai_sdk_provider_utils.LazySchema<{
+    includeReasoning?: boolean | undefined;
+    modelParams?: {
+        [x: string]: unknown;
+        frequencyPenalty?: number | undefined;
+        maxTokens?: number | undefined;
+        n?: number | undefined;
+        parallel_tool_calls?: boolean | undefined;
+        presencePenalty?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+    } | undefined;
+}>;
+/** SAP AI language model provider options type inferred from Zod schema. */
+type SAPAILanguageModelProviderOptions = InferSchema<typeof sapAILanguageModelProviderOptions>;
+/** Zod schema for SAP AI embedding model provider options passed via `providerOptions['sap-ai']` object. */
+declare const sapAIEmbeddingProviderOptions: _ai_sdk_provider_utils.LazySchema<{
+    modelParams?: {
+        [x: string]: unknown;
+        dimensions?: number | undefined;
+        encoding_format?: "base64" | "binary" | "float" | undefined;
+        normalize?: boolean | undefined;
+    } | undefined;
+    type?: "document" | "query" | "text" | undefined;
+}>;
+/** SAP AI embedding model provider options type inferred from Zod schema. */
+type SAPAIEmbeddingProviderOptions = InferSchema<typeof sapAIEmbeddingProviderOptions>;
+
 /** Deployment configuration type used by the SAP AI SDK. */
 type DeploymentConfig = DeploymentIdConfig | ResourceGroupConfig;
 /**
  * SAP AI Provider interface for creating and configuring SAP AI Core models.
- * Extends the standard Vercel AI SDK ProviderV3 interface with SAP-specific functionality.
+ * Extends the Vercel AI SDK ProviderV3 interface with SAP-specific functionality.
  */
 interface SAPAIProvider extends ProviderV3 {
     /** Creates a language model instance. */
     (modelId: SAPAIModelId, settings?: SAPAISettings): SAPAILanguageModel;
-    /** Creates a chat model instance (equivalent to calling the provider function directly). */
+    /** Creates a language model instance (custom convenience method). */
     chat(modelId: SAPAIModelId, settings?: SAPAISettings): SAPAILanguageModel;
-    /** Creates an embedding model instance. */
+    /** Creates an embedding model instance (custom convenience method). */
     embedding(modelId: SAPAIEmbeddingModelId, settings?: SAPAIEmbeddingSettings): SAPAIEmbeddingModel;
     /** Creates an embedding model instance (Vercel AI SDK ProviderV3 standard method). */
     embeddingModel(modelId: SAPAIEmbeddingModelId, settings?: SAPAIEmbeddingSettings): SAPAIEmbeddingModel;
@@ -315,6 +339,13 @@ interface SAPAIProviderSettings {
     readonly deploymentId?: string;
     /** Custom destination configuration for SAP AI Core. */
     readonly destination?: HttpDestinationOrFetchOptions;
+    /**
+     * Log level for SAP Cloud SDK loggers.
+     * Controls verbosity of internal SAP SDK logging (e.g., authentication, service binding).
+     * Note: SAP_CLOUD_SDK_LOG_LEVEL environment variable takes precedence if set.
+     * @default 'warn'
+     */
+    readonly logLevel?: "debug" | "error" | "info" | "warn";
     /**
      * Provider name used as key for `providerOptions` and `providerMetadata`.
      * @default 'sap-ai'
@@ -341,4 +372,4 @@ declare function createSAPAIProvider(options?: SAPAIProviderSettings): SAPAIProv
 /** Default SAP AI provider instance with automatic authentication via SAP AI SDK. */
 declare const sapai: SAPAIProvider;
 
-export { type DeploymentConfig, SAPAIEmbeddingModel, type SAPAIEmbeddingModelId, type SAPAIEmbeddingProviderOptions, type SAPAIEmbeddingSettings, type SAPAILanguageModelProviderOptions, type SAPAIModelId, type SAPAIProvider, type SAPAIProviderSettings, type SAPAISettings, SAP_AI_PROVIDER_NAME, createSAPAIProvider, getProviderName, sapAIEmbeddingProviderOptions, sapAILanguageModelProviderOptions, sapai };
+export { type DeploymentConfig, SAPAIEmbeddingModel, type SAPAIEmbeddingModelId, type SAPAIEmbeddingProviderOptions, type SAPAIEmbeddingSettings, SAPAILanguageModel, type SAPAILanguageModelProviderOptions, type SAPAIModelId, type SAPAIProvider, type SAPAIProviderSettings, type SAPAISettings, SAP_AI_PROVIDER_NAME, createSAPAIProvider, getProviderName, sapAIEmbeddingProviderOptions, sapAILanguageModelProviderOptions, sapai };

package/dist/index.js

@@ -14146,7 +14146,7 @@ var require_cloud_sdk_logger = __commonJS({
     exports.createLogger = createLogger;
     exports.getLogger = getLogger;
     exports.setLogLevel = setLogLevel;
-    exports.setGlobalLogLevel = setGlobalLogLevel;
+    exports.setGlobalLogLevel = setGlobalLogLevel2;
     exports.getGlobalLogLevel = getGlobalLogLevel;
     exports.setGlobalTransports = setGlobalTransports;
     exports.setLogFormat = setLogFormat;
@@ -14233,7 +14233,7 @@ var require_cloud_sdk_logger = __commonJS({
         messageContextOrLogger.level = level;
       }
     }
-    function setGlobalLogLevel(level) {
+    function setGlobalLogLevel2(level) {
       container.options.level = level;
       container.loggers.forEach((logger) => {
         logger.level = level;
@@ -30280,6 +30280,14 @@ var SAPAIEmbeddingModel = class {
   supportsParallelCalls = true;
   config;
   settings;
+  /**
+   * Creates a new SAP AI Embedding Model instance.
+   *
+   * This is the main implementation that handles all SAP AI Core embedding logic.
+   * @param modelId - The model identifier (e.g., 'text-embedding-ada-002', 'text-embedding-3-small').
+   * @param settings - Model configuration settings (embedding type, model parameters, etc.). Defaults to {}.
+   * @param config - SAP AI Core deployment and destination configuration.
+   */
   constructor(modelId, settings = {}, config) {
     if (settings.modelParams) {
       validateEmbeddingModelParamsSettings(settings.modelParams);
@@ -30292,8 +30300,10 @@ var SAPAIEmbeddingModel = class {
   }
   /**
    * Generates embeddings for the given input values.
-   * @param options - The Vercel AI SDK embedding call options.
-   * @returns The embedding result with vectors and usage data.
+   *
+   * Validates input count, merges settings, calls SAP AI SDK, and normalizes embeddings.
+   * @param options - The Vercel AI SDK V3 embedding call options.
+   * @returns The embedding result with vectors, usage data, and warnings.
    */
   async doEmbed(options) {
     const { abortSignal, providerOptions, values } = options;
@@ -30384,9 +30394,6 @@ var SAPAIEmbeddingModel = class {
   }
 };
 
-// src/sap-ai-provider.ts
-import { NoSuchModelError as NoSuchModelError2 } from "@ai-sdk/provider";
-
 // src/sap-ai-language-model.ts
 import { parseProviderOptions as parseProviderOptions2 } from "@ai-sdk/provider-utils";
 import {
@@ -30609,8 +30616,10 @@ var SAPAILanguageModel = class {
   settings;
   /**
    * Creates a new SAP AI Language Model instance.
-   * @param modelId - The model identifier (e.g., 'gpt-4', 'claude-3').
-   * @param settings - Model configuration settings.
+   *
+   * This is the main implementation that handles all SAP AI Core orchestration logic.
+   * @param modelId - The model identifier (e.g., 'gpt-4o', 'claude-3-5-sonnet', 'gemini-2.0-flash').
+   * @param settings - Model configuration settings (temperature, max tokens, filtering, etc.).
    * @param config - SAP AI Core deployment and destination configuration.
    * @internal
    */
@@ -30624,9 +30633,12 @@ var SAPAILanguageModel = class {
   }
   /**
    * Generates a single completion (non-streaming).
-   * Note: Abort signal uses Promise.race; doesn't cancel underlying HTTP request.
-   * @param options - The Vercel AI SDK generation call options.
-   * @returns The generation result with content, usage, and provider metadata.
+   *
+   * Builds orchestration configuration, converts messages, validates parameters,
+   * calls SAP AI SDK, and processes the response.
+   * Supports request cancellation via AbortSignal at the HTTP transport layer.
+   * @param options - The Vercel AI SDK V3 generation call options.
+   * @returns The generation result with content, usage, warnings, and provider metadata.
    */
   async doGenerate(options) {
     try {
@@ -30657,36 +30669,10 @@ var SAPAILanguageModel = class {
           return translation && Object.keys(translation).length > 0 ? { translation } : {};
         })()
       };
-      const response = await (async () => {
-        const completionPromise = client.chatCompletion(requestBody);
-        if (options.abortSignal) {
-          return Promise.race([
-            completionPromise,
-            new Promise((_, reject) => {
-              if (options.abortSignal?.aborted) {
-                reject(
-                  new Error(
-                    `Request aborted: ${String(options.abortSignal.reason ?? "unknown reason")}`
-                  )
-                );
-                return;
-              }
-              options.abortSignal?.addEventListener(
-                "abort",
-                () => {
-                  reject(
-                    new Error(
-                      `Request aborted: ${String(options.abortSignal?.reason ?? "unknown reason")}`
-                    )
-                  );
-                },
-                { once: true }
-              );
-            })
-          ]);
-        }
-        return completionPromise;
-      })();
+      const response = await client.chatCompletion(
+        requestBody,
+        options.abortSignal ? { signal: options.abortSignal } : void 0
+      );
       const responseHeadersRaw = response.rawResponse.headers;
       const responseHeaders = responseHeadersRaw ? Object.fromEntries(
         Object.entries(responseHeadersRaw).flatMap(([key, value]) => {
@@ -30774,8 +30760,11 @@ var SAPAILanguageModel = class {
   }
   /**
    * Generates a streaming completion.
-   * Note: Abort signal uses Promise.race; doesn't cancel underlying HTTP request.
-   * @param options - The Vercel AI SDK generation call options.
+   *
+   * Builds orchestration configuration, creates streaming client, and transforms
+   * the stream with proper event handling (text blocks, tool calls, finish reason).
+   * Supports request cancellation via AbortSignal at the HTTP transport layer.
+   * @param options - The Vercel AI SDK V3 generation call options.
    * @returns A stream result with async iterable stream parts.
    */
   async doStream(options) {
@@ -31342,6 +31331,8 @@ function mapFinishReason(reason) {
 }
 
 // src/sap-ai-provider.ts
+var import_util2 = __toESM(require_dist(), 1);
+import { NoSuchModelError as NoSuchModelError2 } from "@ai-sdk/provider";
 function createSAPAIProvider(options = {}) {
   if (options.defaultSettings?.modelParams) {
     validateModelParamsSettings(options.defaultSettings.modelParams);
@@ -31354,6 +31345,10 @@ function createSAPAIProvider(options = {}) {
       "createSAPAIProvider: both 'deploymentId' and 'resourceGroup' were provided; using 'deploymentId' and ignoring 'resourceGroup'."
     );
   }
+  if (!process.env.SAP_CLOUD_SDK_LOG_LEVEL) {
+    const logLevel = options.logLevel ?? "warn";
+    (0, import_util2.setGlobalLogLevel)(logLevel);
+  }
   const deploymentConfig = options.deploymentId ? { deploymentId: options.deploymentId } : { resourceGroup };
   const createModel = (modelId, settings = {}) => {
     const mergedSettings = {
@@ -31427,6 +31422,7 @@ export {
   OrchestrationStreamChunkResponse,
   OrchestrationStreamResponse,
   SAPAIEmbeddingModel,
+  SAPAILanguageModel,
   SAP_AI_PROVIDER_NAME,
   buildAzureContentSafetyFilter,
   buildDocumentGroundingConfig,