@jerome-benoit/sap-ai-provider 4.0.0-rc.1 → 4.0.0-rc.2

package/dist/index.js

@@ -29739,7 +29739,7 @@ var require_dist = __commonJS({
   }
 });
 
-// src/sap-ai-chat-language-model.ts
+// src/sap-ai-language-model.ts
 import {
   OrchestrationClient
 } from "@sap-ai-sdk/orchestration";
@@ -29755,25 +29755,78 @@ function convertToSAPMessages(prompt, options = {}) {
   const includeReasoning = options.includeReasoning ?? false;
   for (const message of prompt) {
     switch (message.role) {
+      case "assistant": {
+        let text = "";
+        const toolCalls = [];
+        for (const part of message.content) {
+          switch (part.type) {
+            case "reasoning": {
+              if (includeReasoning && part.text) {
+                text += `<reasoning>${part.text}</reasoning>`;
+              }
+              break;
+            }
+            case "text": {
+              text += part.text;
+              break;
+            }
+            case "tool-call": {
+              let argumentsJson;
+              if (typeof part.input === "string") {
+                try {
+                  JSON.parse(part.input);
+                  argumentsJson = part.input;
+                } catch {
+                  argumentsJson = JSON.stringify(part.input);
+                }
+              } else {
+                argumentsJson = JSON.stringify(part.input);
+              }
+              toolCalls.push({
+                function: {
+                  arguments: argumentsJson,
+                  name: part.toolName
+                },
+                id: part.toolCallId,
+                type: "function"
+              });
+              break;
+            }
+          }
+        }
+        const assistantMessage = {
+          content: text || "",
+          role: "assistant",
+          tool_calls: toolCalls.length > 0 ? toolCalls : void 0
+        };
+        messages.push(assistantMessage);
+        break;
+      }
       case "system": {
         const systemMessage = {
-          role: "system",
-          content: message.content
+          content: message.content,
+          role: "system"
         };
         messages.push(systemMessage);
         break;
       }
+      case "tool": {
+        for (const part of message.content) {
+          if (part.type === "tool-result") {
+            const toolMessage = {
+              content: JSON.stringify(part.output),
+              role: "tool",
+              tool_call_id: part.toolCallId
+            };
+            messages.push(toolMessage);
+          }
+        }
+        break;
+      }
       case "user": {
         const contentParts = [];
         for (const part of message.content) {
           switch (part.type) {
-            case "text": {
-              contentParts.push({
-                type: "text",
-                text: part.text
-              });
-              break;
-            }
             case "file": {
               if (!part.mediaType.startsWith("image/")) {
                 throw new UnsupportedFunctionalityError({
@@ -29815,10 +29868,17 @@ function convertToSAPMessages(prompt, options = {}) {
                 }
               }
               contentParts.push({
-                type: "image_url",
                 image_url: {
                   url: imageUrl
-                }
+                },
+                type: "image_url"
+              });
+              break;
+            }
+            case "text": {
+              contentParts.push({
+                text: part.text,
+                type: "text"
               });
               break;
             }
@@ -29830,75 +29890,15 @@ function convertToSAPMessages(prompt, options = {}) {
           }
         }
         const userMessage = contentParts.length === 1 && contentParts[0].type === "text" ? {
-          role: "user",
-          content: contentParts[0].text ?? ""
+          content: contentParts[0].text ?? "",
+          role: "user"
         } : {
-          role: "user",
-          content: contentParts
+          content: contentParts,
+          role: "user"
         };
         messages.push(userMessage);
         break;
       }
-      case "assistant": {
-        let text = "";
-        const toolCalls = [];
-        for (const part of message.content) {
-          switch (part.type) {
-            case "text": {
-              text += part.text;
-              break;
-            }
-            case "reasoning": {
-              if (includeReasoning && part.text) {
-                text += `<reasoning>${part.text}</reasoning>`;
-              }
-              break;
-            }
-            case "tool-call": {
-              let argumentsJson;
-              if (typeof part.input === "string") {
-                try {
-                  JSON.parse(part.input);
-                  argumentsJson = part.input;
-                } catch {
-                  argumentsJson = JSON.stringify(part.input);
-                }
-              } else {
-                argumentsJson = JSON.stringify(part.input);
-              }
-              toolCalls.push({
-                id: part.toolCallId,
-                type: "function",
-                function: {
-                  name: part.toolName,
-                  arguments: argumentsJson
-                }
-              });
-              break;
-            }
-          }
-        }
-        const assistantMessage = {
-          role: "assistant",
-          content: text || "",
-          tool_calls: toolCalls.length > 0 ? toolCalls : void 0
-        };
-        messages.push(assistantMessage);
-        break;
-      }
-      case "tool": {
-        for (const part of message.content) {
-          if (part.type === "tool-result") {
-            const toolMessage = {
-              role: "tool",
-              tool_call_id: part.toolCallId,
-              content: JSON.stringify(part.output)
-            };
-            messages.push(toolMessage);
-          }
-        }
-        break;
-      }
       default: {
         const _exhaustiveCheck = message;
         throw new Error(
@@ -29913,16 +29913,6 @@ function convertToSAPMessages(prompt, options = {}) {
 // src/sap-ai-error.ts
 var import_util = __toESM(require_dist(), 1);
 import { APICallError, LoadAPIKeyError } from "@ai-sdk/provider";
-function getStatusCodeFromSAPError(code) {
-  if (!code) return 500;
-  if (code >= 100 && code < 600) {
-    return code;
-  }
-  return 500;
-}
-function isRetryable(statusCode) {
-  return statusCode === 429 || statusCode >= 500 && statusCode < 600;
-}
 function convertSAPErrorToAPICallError(errorResponse, context) {
   const error = errorResponse.error;
   let message;
@@ -29944,9 +29934,9 @@ function convertSAPErrorToAPICallError(errorResponse, context) {
   const statusCode = getStatusCodeFromSAPError(code);
   const responseBody = JSON.stringify({
     error: {
-      message,
       code,
       location,
+      message,
       request_id: requestId
     }
   });
@@ -29969,53 +29959,14 @@ Error location: ${location}`;
 Request ID: ${requestId}`;
   }
   return new APICallError({
+    isRetryable: isRetryable(statusCode),
     message: enhancedMessage,
-    url: context?.url ?? "",
     requestBodyValues: context?.requestBody,
-    statusCode,
-    responseHeaders: context?.responseHeaders,
     responseBody,
-    isRetryable: isRetryable(statusCode)
-  });
-}
-function isOrchestrationErrorResponse(error) {
-  if (error === null || typeof error !== "object" || !("error" in error)) {
-    return false;
-  }
-  const errorEnvelope = error;
-  const innerError = errorEnvelope.error;
-  if (innerError === void 0) return false;
-  if (Array.isArray(innerError)) {
-    return innerError.every(
-      (entry) => entry !== null && typeof entry === "object" && "message" in entry && typeof entry.message === "string"
-    );
-  }
-  return typeof innerError === "object" && innerError !== null && "message" in innerError && typeof innerError.message === "string";
-}
-function normalizeHeaders(headers) {
-  if (!headers || typeof headers !== "object") return void 0;
-  const record = headers;
-  const entries = Object.entries(record).flatMap(([key, value]) => {
-    if (typeof value === "string") return [[key, value]];
-    if (Array.isArray(value)) {
-      const strings = value.filter((item) => typeof item === "string").join("; ");
-      return strings.length > 0 ? [[key, strings]] : [];
-    }
-    if (typeof value === "number" || typeof value === "boolean") {
-      return [[key, String(value)]];
-    }
-    return [];
+    responseHeaders: context?.responseHeaders,
+    statusCode,
+    url: context?.url ?? ""
   });
-  if (entries.length === 0) return void 0;
-  return Object.fromEntries(entries);
-}
-function getAxiosResponseHeaders(error) {
-  if (!(error instanceof Error)) return void 0;
-  const rootCause = (0, import_util.isErrorWithCause)(error) ? error.rootCause : error;
-  if (typeof rootCause !== "object") return void 0;
-  const maybeAxios = rootCause;
-  if (maybeAxios.isAxiosError !== true) return void 0;
-  return normalizeHeaders(maybeAxios.response?.headers);
 }
 function convertToAISDKError(error, context) {
   if (error instanceof APICallError || error instanceof LoadAPIKeyError) {
@@ -30040,30 +29991,79 @@ See: https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/create-serv
     }
     if (errorMsg.includes("econnrefused") || errorMsg.includes("enotfound") || errorMsg.includes("network") || errorMsg.includes("timeout")) {
       return new APICallError({
+        cause: error,
+        isRetryable: true,
         message: `Network error connecting to SAP AI Core: ${error.message}`,
-        url: context?.url ?? "",
         requestBodyValues: context?.requestBody,
-        statusCode: 503,
-        isRetryable: true,
         responseHeaders,
-        cause: error
+        statusCode: 503,
+        url: context?.url ?? ""
       });
     }
   }
   const message = error instanceof Error ? error.message : typeof error === "string" ? error : "Unknown error occurred";
   const fullMessage = context?.operation ? `SAP AI Core ${context.operation} failed: ${message}` : `SAP AI Core error: ${message}`;
   return new APICallError({
+    cause: error,
+    isRetryable: false,
     message: fullMessage,
-    url: context?.url ?? "",
     requestBodyValues: context?.requestBody,
-    statusCode: 500,
-    isRetryable: false,
     responseHeaders,
-    cause: error
+    statusCode: 500,
+    url: context?.url ?? ""
+  });
+}
+function getAxiosResponseHeaders(error) {
+  if (!(error instanceof Error)) return void 0;
+  const rootCause = (0, import_util.isErrorWithCause)(error) ? error.rootCause : error;
+  if (typeof rootCause !== "object") return void 0;
+  const maybeAxios = rootCause;
+  if (maybeAxios.isAxiosError !== true) return void 0;
+  return normalizeHeaders(maybeAxios.response?.headers);
+}
+function getStatusCodeFromSAPError(code) {
+  if (!code) return 500;
+  if (code >= 100 && code < 600) {
+    return code;
+  }
+  return 500;
+}
+function isOrchestrationErrorResponse(error) {
+  if (error === null || typeof error !== "object" || !("error" in error)) {
+    return false;
+  }
+  const errorEnvelope = error;
+  const innerError = errorEnvelope.error;
+  if (innerError === void 0) return false;
+  if (Array.isArray(innerError)) {
+    return innerError.every(
+      (entry) => entry !== null && typeof entry === "object" && "message" in entry && typeof entry.message === "string"
+    );
+  }
+  return typeof innerError === "object" && innerError !== null && "message" in innerError && typeof innerError.message === "string";
+}
+function isRetryable(statusCode) {
+  return statusCode === 429 || statusCode >= 500 && statusCode < 600;
+}
+function normalizeHeaders(headers) {
+  if (!headers || typeof headers !== "object") return void 0;
+  const record = headers;
+  const entries = Object.entries(record).flatMap(([key, value]) => {
+    if (typeof value === "string") return [[key, value]];
+    if (Array.isArray(value)) {
+      const strings = value.filter((item) => typeof item === "string").join("; ");
+      return strings.length > 0 ? [[key, strings]] : [];
+    }
+    if (typeof value === "number" || typeof value === "boolean") {
+      return [[key, String(value)]];
+    }
+    return [];
   });
+  if (entries.length === 0) return void 0;
+  return Object.fromEntries(entries);
 }
 
-// src/sap-ai-chat-language-model.ts
+// src/sap-ai-language-model.ts
 var StreamIdGenerator = class {
   /**
    * Generates a unique ID for a text block.
@@ -30074,139 +30074,27 @@ var StreamIdGenerator = class {
     return crypto.randomUUID();
   }
 };
-function validateModelParameters(params, warnings) {
-  if (params.temperature !== void 0 && (params.temperature < 0 || params.temperature > 2)) {
-    warnings.push({
-      type: "other",
-      message: `temperature=${String(params.temperature)} is outside typical range [0, 2]. The API may reject this value.`
-    });
-  }
-  if (params.topP !== void 0 && (params.topP < 0 || params.topP > 1)) {
-    warnings.push({
-      type: "other",
-      message: `topP=${String(params.topP)} is outside valid range [0, 1]. The API may reject this value.`
-    });
-  }
-  if (params.frequencyPenalty !== void 0 && (params.frequencyPenalty < -2 || params.frequencyPenalty > 2)) {
-    warnings.push({
-      type: "other",
-      message: `frequencyPenalty=${String(params.frequencyPenalty)} is outside typical range [-2, 2]. The API may reject this value.`
-    });
-  }
-  if (params.presencePenalty !== void 0 && (params.presencePenalty < -2 || params.presencePenalty > 2)) {
-    warnings.push({
-      type: "other",
-      message: `presencePenalty=${String(params.presencePenalty)} is outside typical range [-2, 2]. The API may reject this value.`
-    });
-  }
-  if (params.maxTokens !== void 0 && params.maxTokens <= 0) {
-    warnings.push({
-      type: "other",
-      message: `maxTokens=${String(params.maxTokens)} must be positive. The API will likely reject this value.`
-    });
-  }
-  if (params.n !== void 0 && params.n <= 0) {
-    warnings.push({
-      type: "other",
-      message: `n=${String(params.n)} must be positive. The API will likely reject this value.`
-    });
-  }
-}
-function createAISDKRequestBodySummary(options) {
-  return {
-    promptMessages: options.prompt.length,
-    hasImageParts: options.prompt.some(
-      (message) => message.role === "user" && message.content.some(
-        (part) => part.type === "file" && part.mediaType.startsWith("image/")
-      )
-    ),
-    tools: options.tools?.length ?? 0,
-    temperature: options.temperature,
-    topP: options.topP,
-    topK: options.topK,
-    maxOutputTokens: options.maxOutputTokens,
-    stopSequences: options.stopSequences?.length,
-    seed: options.seed,
-    toolChoiceType: options.toolChoice?.type,
-    responseFormatType: options.responseFormat?.type
-  };
-}
-function hasCallableParse(obj) {
-  return typeof obj.parse === "function";
-}
-function isZodSchema(obj) {
-  if (obj === null || typeof obj !== "object") {
-    return false;
-  }
-  const record = obj;
-  return "_def" in record && "parse" in record && hasCallableParse(record);
-}
-function buildSAPToolParameters(schema) {
-  const schemaType = schema.type;
-  if (schemaType !== void 0 && schemaType !== "object") {
-    return {
-      type: "object",
-      properties: {},
-      required: []
-    };
-  }
-  const properties = schema.properties && typeof schema.properties === "object" ? schema.properties : {};
-  const required = Array.isArray(schema.required) && schema.required.every((item) => typeof item === "string") ? schema.required : [];
-  const additionalFields = Object.fromEntries(
-    Object.entries(schema).filter(
-      ([key]) => key !== "type" && key !== "properties" && key !== "required"
-    )
-  );
-  return {
-    type: "object",
-    properties,
-    required,
-    ...additionalFields
-  };
-}
-var SAPAIChatLanguageModel = class {
-  specificationVersion = "v3";
+var SAPAILanguageModel = class {
   modelId;
-  config;
-  settings;
-  /**
-   * Creates a new SAP AI Chat Language Model instance.
-   *
-   * @param modelId - The model identifier
-   * @param settings - Model-specific configuration settings
-   * @param config - Internal configuration (deployment config, destination, etc.)
-   *
-   * @internal This constructor is not meant to be called directly.
-   * Use the provider function instead.
-   */
-  constructor(modelId, settings, config) {
-    this.settings = settings;
-    this.config = config;
-    this.modelId = modelId;
-  }
-  /**
-   * Checks if a URL is supported for file/image uploads.
-   *
-   * @param url - The URL to check
-   * @returns True if the URL protocol is HTTPS or data with valid image format
-   */
-  supportsUrl(url) {
-    if (url.protocol === "https:") return true;
-    if (url.protocol === "data:") {
-      return /^data:image\//i.test(url.href);
-    }
-    return false;
-  }
+  specificationVersion = "v3";
   /**
-   * Returns supported URL patterns for different content types.
+   * Model capabilities.
    *
-   * @returns Record of content types to regex patterns
+   * These defaults assume “modern” model behavior to avoid maintaining a
+   * per-model capability matrix. If a deployment doesn't support a feature,
+   * SAP AI Core will fail the request at runtime.
    */
-  get supportedUrls() {
-    return {
-      "image/*": [/^https:\/\/.+$/i, /^data:image\/.*$/]
-    };
-  }
+  supportsImageUrls = true;
+  /** Multiple completions via the `n` parameter (provider-specific support). */
+  supportsMultipleCompletions = true;
+  /** Parallel tool calls. */
+  supportsParallelToolCalls = true;
+  /** Streaming responses. */
+  supportsStreaming = true;
+  /** Structured JSON outputs (json_schema response format). */
+  supportsStructuredOutputs = true;
+  /** Tool/function calling. */
+  supportsToolCalls = true;
   /**
    * Generates text completion using SAP AI Core's Orchestration API.
    *
@@ -30252,206 +30140,31 @@ var SAPAIChatLanguageModel = class {
     return this.config.provider;
   }
   /**
-   * Model capabilities.
-   *
-   * These defaults assume “modern” model behavior to avoid maintaining a
-   * per-model capability matrix. If a deployment doesn't support a feature,
-   * SAP AI Core will fail the request at runtime.
-   */
-  supportsImageUrls = true;
-  /** Structured JSON outputs (json_schema response format). */
-  supportsStructuredOutputs = true;
-  /** Tool/function calling. */
-  supportsToolCalls = true;
-  /** Streaming responses. */
-  supportsStreaming = true;
-  /** Multiple completions via the `n` parameter (provider-specific support). */
-  supportsMultipleCompletions = true;
-  /** Parallel tool calls. */
-  supportsParallelToolCalls = true;
-  /**
-   * Builds orchestration module config for SAP AI SDK.
+   * Returns supported URL patterns for different content types.
    *
-   * @param options - Call options from the AI SDK
-   * @returns Object containing orchestration config, messages, and warnings
-   * @internal
+   * @returns Record of content types to regex patterns
    */
-  buildOrchestrationConfig(options) {
-    const providerOptions = options.providerOptions?.sap ?? {};
-    const warnings = [];
-    const messages = convertToSAPMessages(options.prompt, {
-      includeReasoning: providerOptions.includeReasoning ?? this.settings.includeReasoning ?? false
-    });
-    let tools;
-    const settingsTools = providerOptions.tools ?? this.settings.tools;
-    const optionsTools = options.tools;
-    const shouldUseSettingsTools = settingsTools && settingsTools.length > 0 && (!optionsTools || optionsTools.length === 0);
-    const shouldUseOptionsTools = !!(optionsTools && optionsTools.length > 0);
-    if (settingsTools && settingsTools.length > 0 && optionsTools && optionsTools.length > 0) {
-      warnings.push({
-        type: "other",
-        message: "Both settings.tools and call options.tools were provided; preferring call options.tools."
-      });
-    }
-    if (shouldUseSettingsTools) {
-      tools = settingsTools;
-    } else {
-      const availableTools = shouldUseOptionsTools ? optionsTools : void 0;
-      tools = availableTools?.map((tool) => {
-        if (tool.type === "function") {
-          const inputSchema = tool.inputSchema;
-          const toolWithParams = tool;
-          let parameters;
-          if (toolWithParams.parameters && isZodSchema(toolWithParams.parameters)) {
-            try {
-              const jsonSchema = zodToJsonSchema(
-                toolWithParams.parameters,
-                {
-                  $refStrategy: "none"
-                }
-              );
-              const schemaRecord = jsonSchema;
-              delete schemaRecord.$schema;
-              parameters = buildSAPToolParameters(schemaRecord);
-            } catch (error) {
-              warnings.push({
-                type: "unsupported",
-                feature: `tool schema conversion for ${tool.name}`,
-                details: `Failed to convert tool Zod schema: ${error instanceof Error ? error.message : String(error)}. Falling back to empty object schema.`
-              });
-              parameters = buildSAPToolParameters({});
-            }
-          } else if (inputSchema && Object.keys(inputSchema).length > 0) {
-            const hasProperties = inputSchema.properties && typeof inputSchema.properties === "object" && Object.keys(inputSchema.properties).length > 0;
-            if (hasProperties) {
-              parameters = buildSAPToolParameters(inputSchema);
-            } else {
-              parameters = buildSAPToolParameters({});
-            }
-          } else {
-            parameters = buildSAPToolParameters({});
-          }
-          return {
-            type: "function",
-            function: {
-              name: tool.name,
-              description: tool.description,
-              parameters
-            }
-          };
-        } else {
-          warnings.push({
-            type: "unsupported",
-            feature: `tool type for ${tool.name}`,
-            details: "Only 'function' tool type is supported."
-          });
-          return null;
-        }
-      }).filter((t) => t !== null);
-    }
-    const supportsN = !this.modelId.startsWith("amazon--") && !this.modelId.startsWith("anthropic--");
-    const modelParams = {};
-    const maxTokens = options.maxOutputTokens ?? providerOptions.modelParams?.maxTokens ?? this.settings.modelParams?.maxTokens;
-    if (maxTokens !== void 0) modelParams.max_tokens = maxTokens;
-    const temperature = options.temperature ?? providerOptions.modelParams?.temperature ?? this.settings.modelParams?.temperature;
-    if (temperature !== void 0) modelParams.temperature = temperature;
-    const topP = options.topP ?? providerOptions.modelParams?.topP ?? this.settings.modelParams?.topP;
-    if (topP !== void 0) modelParams.top_p = topP;
-    if (options.topK !== void 0) modelParams.top_k = options.topK;
-    const frequencyPenalty = options.frequencyPenalty ?? providerOptions.modelParams?.frequencyPenalty ?? this.settings.modelParams?.frequencyPenalty;
-    if (frequencyPenalty !== void 0) {
-      modelParams.frequency_penalty = frequencyPenalty;
-    }
-    const presencePenalty = options.presencePenalty ?? providerOptions.modelParams?.presencePenalty ?? this.settings.modelParams?.presencePenalty;
-    if (presencePenalty !== void 0) {
-      modelParams.presence_penalty = presencePenalty;
-    }
-    if (supportsN) {
-      const nValue = providerOptions.modelParams?.n ?? this.settings.modelParams?.n;
-      if (nValue !== void 0) {
-        modelParams.n = nValue;
-      }
-    }
-    const parallelToolCalls = providerOptions.modelParams?.parallel_tool_calls ?? this.settings.modelParams?.parallel_tool_calls;
-    if (parallelToolCalls !== void 0) {
-      modelParams.parallel_tool_calls = parallelToolCalls;
-    }
-    if (options.stopSequences && options.stopSequences.length > 0) {
-      modelParams.stop = options.stopSequences;
-    }
-    if (options.seed !== void 0) {
-      modelParams.seed = options.seed;
-    }
-    validateModelParameters(
-      {
-        temperature,
-        topP,
-        frequencyPenalty,
-        presencePenalty,
-        maxTokens,
-        n: modelParams.n
-      },
-      warnings
-    );
-    if (options.toolChoice && options.toolChoice.type !== "auto") {
-      warnings.push({
-        type: "unsupported",
-        feature: "toolChoice",
-        details: `SAP AI SDK does not support toolChoice '${options.toolChoice.type}'. Using default 'auto' behavior.`
-      });
-    }
-    if (options.responseFormat?.type === "json") {
-      warnings.push({
-        type: "other",
-        message: "responseFormat JSON mode is forwarded to the underlying model; support and schema adherence depend on the model/deployment."
-      });
-    }
-    const responseFormat = options.responseFormat?.type === "json" ? options.responseFormat.schema ? {
-      type: "json_schema",
-      json_schema: {
-        name: options.responseFormat.name ?? "response",
-        description: options.responseFormat.description,
-        schema: options.responseFormat.schema,
-        strict: null
-      }
-    } : { type: "json_object" } : void 0;
-    const orchestrationConfig = {
-      promptTemplating: {
-        model: {
-          name: this.modelId,
-          version: providerOptions.modelVersion ?? this.settings.modelVersion ?? "latest",
-          params: modelParams
-        },
-        prompt: {
-          template: [],
-          tools: tools && tools.length > 0 ? tools : void 0,
-          ...responseFormat ? { response_format: responseFormat } : {}
-        }
-      },
-      ...(() => {
-        const masking = providerOptions.masking ?? this.settings.masking;
-        return masking && Object.keys(masking).length > 0 ? { masking } : {};
-      })(),
-      ...(() => {
-        const filtering = providerOptions.filtering ?? this.settings.filtering;
-        return filtering && Object.keys(filtering).length > 0 ? { filtering } : {};
-      })()
+  get supportedUrls() {
+    return {
+      "image/*": [/^https:\/\/.+$/i, /^data:image\/.*$/]
     };
-    return { orchestrationConfig, messages, warnings };
   }
+  config;
+  settings;
   /**
-   * Creates an OrchestrationClient instance.
+   * Creates a new SAP AI Chat Language Model instance.
    *
-   * @param config - Orchestration module configuration
-   * @returns OrchestrationClient instance
-   * @internal
+   * @param modelId - The model identifier
+   * @param settings - Model-specific configuration settings
+   * @param config - Internal configuration (deployment config, destination, etc.)
+   *
+   * @internal This constructor is not meant to be called directly.
+   * Use the provider function instead.
    */
-  createClient(config) {
-    return new OrchestrationClient(
-      config,
-      this.config.deploymentConfig,
-      this.config.destination
-    );
+  constructor(modelId, settings, config) {
+    this.settings = settings;
+    this.config = config;
+    this.modelId = modelId;
   }
   /**
    * Generates a single completion (non-streaming).
@@ -30489,7 +30202,7 @@ var SAPAIChatLanguageModel = class {
    */
   async doGenerate(options) {
     try {
-      const { orchestrationConfig, messages, warnings } = this.buildOrchestrationConfig(options);
+      const { messages, orchestrationConfig, warnings } = this.buildOrchestrationConfig(options);
       const client = this.createClient(orchestrationConfig);
       const promptTemplating = orchestrationConfig.promptTemplating;
       const requestBody = {
@@ -30506,6 +30219,14 @@ var SAPAIChatLanguageModel = class {
         ...(() => {
           const filtering = orchestrationConfig.filtering;
           return filtering && Object.keys(filtering).length > 0 ? { filtering } : {};
+        })(),
+        ...(() => {
+          const grounding = orchestrationConfig.grounding;
+          return grounding && Object.keys(grounding).length > 0 ? { grounding } : {};
+        })(),
+        ...(() => {
+          const translation = orchestrationConfig.translation;
+          return translation && Object.keys(translation).length > 0 ? { translation } : {};
         })()
       };
       const response = await (async () => {
@@ -30556,18 +30277,18 @@ var SAPAIChatLanguageModel = class {
       const textContent = response.getContent();
       if (textContent) {
         content.push({
-          type: "text",
-          text: textContent
+          text: textContent,
+          type: "text"
         });
       }
       const toolCalls = response.getToolCalls();
       if (toolCalls) {
         for (const toolCall of toolCalls) {
           content.push({
-            type: "tool-call",
+            input: toolCall.function.arguments,
             toolCallId: toolCall.id,
             toolName: toolCall.function.name,
-            input: toolCall.function.arguments
+            type: "tool-call"
           });
         }
       }
@@ -30576,26 +30297,13 @@ var SAPAIChatLanguageModel = class {
       const finishReason = mapFinishReason(finishReasonRaw);
       const rawResponseBody = {
         content: textContent,
-        toolCalls,
+        finishReason: finishReasonRaw,
         tokenUsage,
-        finishReason: finishReasonRaw
+        toolCalls
       };
       return {
         content,
         finishReason,
-        usage: {
-          inputTokens: {
-            total: tokenUsage.prompt_tokens,
-            noCache: tokenUsage.prompt_tokens,
-            cacheRead: void 0,
-            cacheWrite: void 0
-          },
-          outputTokens: {
-            total: tokenUsage.completion_tokens,
-            text: tokenUsage.completion_tokens,
-            reasoning: void 0
-          }
-        },
         providerMetadata: {
           "sap-ai": {
             finishReason: finishReasonRaw ?? "unknown",
@@ -30607,18 +30315,31 @@ var SAPAIChatLanguageModel = class {
           body: requestBody
         },
         response: {
-          timestamp: /* @__PURE__ */ new Date(),
-          modelId: this.modelId,
+          body: rawResponseBody,
           headers: responseHeaders,
-          body: rawResponseBody
+          modelId: this.modelId,
+          timestamp: /* @__PURE__ */ new Date()
+        },
+        usage: {
+          inputTokens: {
+            cacheRead: void 0,
+            cacheWrite: void 0,
+            noCache: tokenUsage.prompt_tokens,
+            total: tokenUsage.prompt_tokens
+          },
+          outputTokens: {
+            reasoning: void 0,
+            text: tokenUsage.completion_tokens,
+            total: tokenUsage.completion_tokens
+          }
         },
         warnings
       };
     } catch (error) {
       throw convertToAISDKError(error, {
         operation: "doGenerate",
-        url: "sap-ai:orchestration",
-        requestBody: createAISDKRequestBodySummary(options)
+        requestBody: createAISDKRequestBodySummary(options),
+        url: "sap-ai:orchestration"
       });
     }
   }
@@ -30647,6 +30368,8 @@ var SAPAIChatLanguageModel = class {
    * - Usage format: `{ inputTokens: { total, ... }, outputTokens: { total, ... } }`
    * - Warnings only in `stream-start` event
    *
+   * @see {@link https://sdk.vercel.ai/docs/ai-sdk-core/streaming Vercel AI SDK Streaming}
+   *
    * @param options - Streaming options including prompt, tools, and settings
    * @returns Promise resolving to stream and request metadata
    *
@@ -30672,7 +30395,7 @@ var SAPAIChatLanguageModel = class {
    */
   async doStream(options) {
     try {
-      const { orchestrationConfig, messages, warnings } = this.buildOrchestrationConfig(options);
+      const { messages, orchestrationConfig, warnings } = this.buildOrchestrationConfig(options);
       const client = this.createClient(orchestrationConfig);
       const promptTemplating = orchestrationConfig.promptTemplating;
       const requestBody = {
@@ -30699,25 +30422,25 @@ var SAPAIChatLanguageModel = class {
       const idGenerator = new StreamIdGenerator();
       let textBlockId = null;
       const streamState = {
+        activeText: false,
         finishReason: {
-          unified: "other",
-          raw: void 0
+          raw: void 0,
+          unified: "other"
         },
+        isFirstChunk: true,
         usage: {
           inputTokens: {
-            total: void 0,
-            noCache: void 0,
             cacheRead: void 0,
-            cacheWrite: void 0
+            cacheWrite: void 0,
+            noCache: void 0,
+            total: void 0
           },
           outputTokens: {
-            total: void 0,
+            reasoning: void 0,
             text: void 0,
-            reasoning: void 0
+            total: void 0
           }
-        },
-        isFirstChunk: true,
-        activeText: false
+        }
       };
       const toolCallsInProgress = /* @__PURE__ */ new Map();
       const sdkStream = streamResponse.stream;
@@ -30725,6 +30448,11 @@ var SAPAIChatLanguageModel = class {
       const warningsSnapshot = [...warnings];
       const warningsOut = [...warningsSnapshot];
       const transformedStream = new ReadableStream({
+        cancel(reason) {
+          if (reason) {
+            console.debug("SAP AI stream cancelled:", reason);
+          }
+        },
         async start(controller) {
           controller.enqueue({
             type: "stream-start",
@@ -30735,30 +30463,30 @@ var SAPAIChatLanguageModel = class {
               if (streamState.isFirstChunk) {
                 streamState.isFirstChunk = false;
                 controller.enqueue({
-                  type: "response-metadata",
                   modelId,
-                  timestamp: /* @__PURE__ */ new Date()
+                  timestamp: /* @__PURE__ */ new Date(),
+                  type: "response-metadata"
                 });
               }
               const deltaToolCalls = chunk.getDeltaToolCalls();
               if (Array.isArray(deltaToolCalls) && deltaToolCalls.length > 0) {
                 streamState.finishReason = {
-                  unified: "tool-calls",
-                  raw: void 0
+                  raw: void 0,
+                  unified: "tool-calls"
                 };
               }
               const deltaContent = chunk.getDeltaContent();
               if (typeof deltaContent === "string" && deltaContent.length > 0 && streamState.finishReason.unified !== "tool-calls") {
                 if (!streamState.activeText) {
                   textBlockId = idGenerator.generateTextBlockId();
-                  controller.enqueue({ type: "text-start", id: textBlockId });
+                  controller.enqueue({ id: textBlockId, type: "text-start" });
                   streamState.activeText = true;
                 }
                 if (textBlockId) {
                   controller.enqueue({
-                    type: "text-delta",
+                    delta: deltaContent,
                     id: textBlockId,
-                    delta: deltaContent
+                    type: "text-delta"
                   });
                 }
               }
@@ -30770,11 +30498,11 @@ var SAPAIChatLanguageModel = class {
                   }
                   if (!toolCallsInProgress.has(index)) {
                     toolCallsInProgress.set(index, {
-                      id: toolCallChunk.id ?? `tool_${String(index)}`,
-                      toolName: toolCallChunk.function?.name,
                       arguments: "",
+                      didEmitCall: false,
                       didEmitInputStart: false,
-                      didEmitCall: false
+                      id: toolCallChunk.id ?? `tool_${String(index)}`,
+                      toolName: toolCallChunk.function?.name
                     });
                   }
                   const tc = toolCallsInProgress.get(index);
@@ -30789,9 +30517,9 @@ var SAPAIChatLanguageModel = class {
                   if (!tc.didEmitInputStart && tc.toolName) {
                     tc.didEmitInputStart = true;
                     controller.enqueue({
-                      type: "tool-input-start",
                       id: tc.id,
-                      toolName: tc.toolName
+                      toolName: tc.toolName,
+                      type: "tool-input-start"
                     });
                   }
                   const argumentsDelta = toolCallChunk.function?.arguments;
@@ -30799,9 +30527,9 @@ var SAPAIChatLanguageModel = class {
                     tc.arguments += argumentsDelta;
                     if (tc.didEmitInputStart) {
                       controller.enqueue({
-                        type: "tool-input-delta",
+                        delta: argumentsDelta,
                         id: tc.id,
-                        delta: argumentsDelta
+                        type: "tool-input-delta"
                       });
                     }
                   }
@@ -30819,28 +30547,28 @@ var SAPAIChatLanguageModel = class {
                     if (!tc.didEmitInputStart) {
                       tc.didEmitInputStart = true;
                       controller.enqueue({
-                        type: "tool-input-start",
                         id: tc.id,
-                        toolName: tc.toolName ?? ""
+                        toolName: tc.toolName ?? "",
+                        type: "tool-input-start"
                       });
                     }
                     if (!tc.toolName) {
                       warningsOut.push({
-                        type: "other",
-                        message: "Received tool-call delta without a tool name. Emitting tool-call with an empty tool name."
+                        message: "Received tool-call delta without a tool name. Emitting tool-call with an empty tool name.",
+                        type: "other"
                       });
                     }
                     tc.didEmitCall = true;
-                    controller.enqueue({ type: "tool-input-end", id: tc.id });
+                    controller.enqueue({ id: tc.id, type: "tool-input-end" });
                     controller.enqueue({
-                      type: "tool-call",
+                      input: tc.arguments,
                       toolCallId: tc.id,
                       toolName: tc.toolName ?? "",
-                      input: tc.arguments
+                      type: "tool-call"
                     });
                   }
                   if (streamState.activeText && textBlockId) {
-                    controller.enqueue({ type: "text-end", id: textBlockId });
+                    controller.enqueue({ id: textBlockId, type: "text-end" });
                     streamState.activeText = false;
                   }
                 }
@@ -30855,109 +30583,399 @@ var SAPAIChatLanguageModel = class {
               if (!tc.didEmitInputStart) {
                 tc.didEmitInputStart = true;
                 controller.enqueue({
-                  type: "tool-input-start",
                   id: tc.id,
-                  toolName: tc.toolName ?? ""
+                  toolName: tc.toolName ?? "",
+                  type: "tool-input-start"
                 });
               }
               if (!tc.toolName) {
                 warningsOut.push({
-                  type: "other",
-                  message: "Received tool-call delta without a tool name. Emitting tool-call with an empty tool name."
+                  message: "Received tool-call delta without a tool name. Emitting tool-call with an empty tool name.",
+                  type: "other"
                 });
               }
               didEmitAnyToolCalls = true;
               tc.didEmitCall = true;
-              controller.enqueue({ type: "tool-input-end", id: tc.id });
+              controller.enqueue({ id: tc.id, type: "tool-input-end" });
               controller.enqueue({
-                type: "tool-call",
+                input: tc.arguments,
                 toolCallId: tc.id,
                 toolName: tc.toolName ?? "",
-                input: tc.arguments
+                type: "tool-call"
               });
             }
             if (streamState.activeText && textBlockId) {
-              controller.enqueue({ type: "text-end", id: textBlockId });
+              controller.enqueue({ id: textBlockId, type: "text-end" });
             }
             const finalFinishReason = streamResponse.getFinishReason();
             if (finalFinishReason) {
               streamState.finishReason = mapFinishReason(finalFinishReason);
             } else if (didEmitAnyToolCalls) {
               streamState.finishReason = {
-                unified: "tool-calls",
-                raw: void 0
+                raw: void 0,
+                unified: "tool-calls"
               };
             }
-            const finalUsage = streamResponse.getTokenUsage();
-            if (finalUsage) {
-              streamState.usage.inputTokens.total = finalUsage.prompt_tokens;
-              streamState.usage.inputTokens.noCache = finalUsage.prompt_tokens;
-              streamState.usage.outputTokens.total = finalUsage.completion_tokens;
-              streamState.usage.outputTokens.text = finalUsage.completion_tokens;
+            const finalUsage = streamResponse.getTokenUsage();
+            if (finalUsage) {
+              streamState.usage.inputTokens.total = finalUsage.prompt_tokens;
+              streamState.usage.inputTokens.noCache = finalUsage.prompt_tokens;
+              streamState.usage.outputTokens.total = finalUsage.completion_tokens;
+              streamState.usage.outputTokens.text = finalUsage.completion_tokens;
+            }
+            controller.enqueue({
+              finishReason: streamState.finishReason,
+              type: "finish",
+              usage: streamState.usage
+            });
+            controller.close();
+          } catch (error) {
+            const aiError = convertToAISDKError(error, {
+              operation: "doStream",
+              requestBody: createAISDKRequestBodySummary(options),
+              url: "sap-ai:orchestration"
+            });
+            controller.enqueue({
+              error: aiError instanceof Error ? aiError : new Error(String(aiError)),
+              type: "error"
+            });
+            controller.close();
+          }
+        }
+      });
+      return {
+        request: {
+          body: requestBody
+        },
+        stream: transformedStream
+      };
+    } catch (error) {
+      throw convertToAISDKError(error, {
+        operation: "doStream",
+        requestBody: createAISDKRequestBodySummary(options),
+        url: "sap-ai:orchestration"
+      });
+    }
+  }
+  /**
+   * Checks if a URL is supported for file/image uploads.
+   *
+   * @param url - The URL to check
+   * @returns True if the URL protocol is HTTPS or data with valid image format
+   */
+  supportsUrl(url) {
+    if (url.protocol === "https:") return true;
+    if (url.protocol === "data:") {
+      return /^data:image\//i.test(url.href);
+    }
+    return false;
+  }
+  /**
+   * Builds orchestration module config for SAP AI SDK.
+   *
+   * @param options - Call options from the AI SDK
+   * @returns Object containing orchestration config, messages, and warnings
+   * @internal
+   */
+  buildOrchestrationConfig(options) {
+    const providerOptions = options.providerOptions?.sap ?? {};
+    const warnings = [];
+    const messages = convertToSAPMessages(options.prompt, {
+      includeReasoning: providerOptions.includeReasoning ?? this.settings.includeReasoning ?? false
+    });
+    let tools;
+    const settingsTools = providerOptions.tools ?? this.settings.tools;
+    const optionsTools = options.tools;
+    const shouldUseSettingsTools = settingsTools && settingsTools.length > 0 && (!optionsTools || optionsTools.length === 0);
+    const shouldUseOptionsTools = !!(optionsTools && optionsTools.length > 0);
+    if (settingsTools && settingsTools.length > 0 && optionsTools && optionsTools.length > 0) {
+      warnings.push({
+        message: "Both settings.tools and call options.tools were provided; preferring call options.tools.",
+        type: "other"
+      });
+    }
+    if (shouldUseSettingsTools) {
+      tools = settingsTools;
+    } else {
+      const availableTools = shouldUseOptionsTools ? optionsTools : void 0;
+      tools = availableTools?.map((tool) => {
+        if (tool.type === "function") {
+          const inputSchema = tool.inputSchema;
+          const toolWithParams = tool;
+          let parameters;
+          if (toolWithParams.parameters && isZodSchema(toolWithParams.parameters)) {
+            try {
+              const jsonSchema = zodToJsonSchema(
+                toolWithParams.parameters,
+                {
+                  $refStrategy: "none"
+                }
+              );
+              const schemaRecord = jsonSchema;
+              delete schemaRecord.$schema;
+              parameters = buildSAPToolParameters(schemaRecord);
+            } catch (error) {
+              warnings.push({
+                details: `Failed to convert tool Zod schema: ${error instanceof Error ? error.message : String(error)}. Falling back to empty object schema.`,
+                feature: `tool schema conversion for ${tool.name}`,
+                type: "unsupported"
+              });
+              parameters = buildSAPToolParameters({});
+            }
+          } else if (inputSchema && Object.keys(inputSchema).length > 0) {
+            const hasProperties = inputSchema.properties && typeof inputSchema.properties === "object" && Object.keys(inputSchema.properties).length > 0;
+            if (hasProperties) {
+              parameters = buildSAPToolParameters(inputSchema);
+            } else {
+              parameters = buildSAPToolParameters({});
             }
-            controller.enqueue({
-              type: "finish",
-              finishReason: streamState.finishReason,
-              usage: streamState.usage
-            });
-            controller.close();
-          } catch (error) {
-            const aiError = convertToAISDKError(error, {
-              operation: "doStream",
-              url: "sap-ai:orchestration",
-              requestBody: createAISDKRequestBodySummary(options)
-            });
-            controller.enqueue({
-              type: "error",
-              error: aiError instanceof Error ? aiError : new Error(String(aiError))
-            });
-            controller.close();
-          }
-        },
-        cancel(reason) {
-          if (reason) {
-            console.debug("SAP AI stream cancelled:", reason);
+          } else {
+            parameters = buildSAPToolParameters({});
           }
+          return {
+            function: {
+              description: tool.description,
+              name: tool.name,
+              parameters
+            },
+            type: "function"
+          };
+        } else {
+          warnings.push({
+            details: "Only 'function' tool type is supported.",
+            feature: `tool type for ${tool.name}`,
+            type: "unsupported"
+          });
+          return null;
         }
+      }).filter((t) => t !== null);
+    }
+    const supportsN = !this.modelId.startsWith("amazon--") && !this.modelId.startsWith("anthropic--");
+    const modelParams = {};
+    const maxTokens = options.maxOutputTokens ?? providerOptions.modelParams?.maxTokens ?? this.settings.modelParams?.maxTokens;
+    if (maxTokens !== void 0) modelParams.max_tokens = maxTokens;
+    const temperature = options.temperature ?? providerOptions.modelParams?.temperature ?? this.settings.modelParams?.temperature;
+    if (temperature !== void 0) modelParams.temperature = temperature;
+    const topP = options.topP ?? providerOptions.modelParams?.topP ?? this.settings.modelParams?.topP;
+    if (topP !== void 0) modelParams.top_p = topP;
+    if (options.topK !== void 0) modelParams.top_k = options.topK;
+    const frequencyPenalty = options.frequencyPenalty ?? providerOptions.modelParams?.frequencyPenalty ?? this.settings.modelParams?.frequencyPenalty;
+    if (frequencyPenalty !== void 0) {
+      modelParams.frequency_penalty = frequencyPenalty;
+    }
+    const presencePenalty = options.presencePenalty ?? providerOptions.modelParams?.presencePenalty ?? this.settings.modelParams?.presencePenalty;
+    if (presencePenalty !== void 0) {
+      modelParams.presence_penalty = presencePenalty;
+    }
+    if (supportsN) {
+      const nValue = providerOptions.modelParams?.n ?? this.settings.modelParams?.n;
+      if (nValue !== void 0) {
+        modelParams.n = nValue;
+      }
+    }
+    const parallelToolCalls = providerOptions.modelParams?.parallel_tool_calls ?? this.settings.modelParams?.parallel_tool_calls;
+    if (parallelToolCalls !== void 0) {
+      modelParams.parallel_tool_calls = parallelToolCalls;
+    }
+    if (options.stopSequences && options.stopSequences.length > 0) {
+      modelParams.stop = options.stopSequences;
+    }
+    if (options.seed !== void 0) {
+      modelParams.seed = options.seed;
+    }
+    validateModelParameters(
+      {
+        frequencyPenalty,
+        maxTokens,
+        n: modelParams.n,
+        presencePenalty,
+        temperature,
+        topP
+      },
+      warnings
+    );
+    if (options.toolChoice && options.toolChoice.type !== "auto") {
+      warnings.push({
+        details: `SAP AI SDK does not support toolChoice '${options.toolChoice.type}'. Using default 'auto' behavior.`,
+        feature: "toolChoice",
+        type: "unsupported"
       });
-      return {
-        stream: transformedStream,
-        request: {
-          body: requestBody
-        }
-      };
-    } catch (error) {
-      throw convertToAISDKError(error, {
-        operation: "doStream",
-        url: "sap-ai:orchestration",
-        requestBody: createAISDKRequestBodySummary(options)
+    }
+    if (options.responseFormat?.type === "json") {
+      warnings.push({
+        message: "responseFormat JSON mode is forwarded to the underlying model; support and schema adherence depend on the model/deployment.",
+        type: "other"
       });
     }
+    const responseFormat = options.responseFormat?.type === "json" ? options.responseFormat.schema ? {
+      json_schema: {
+        description: options.responseFormat.description,
+        name: options.responseFormat.name ?? "response",
+        schema: options.responseFormat.schema,
+        strict: null
+      },
+      type: "json_schema"
+    } : { type: "json_object" } : void 0;
+    const orchestrationConfig = {
+      promptTemplating: {
+        model: {
+          name: this.modelId,
+          params: modelParams,
+          version: providerOptions.modelVersion ?? this.settings.modelVersion ?? "latest"
+        },
+        prompt: {
+          template: [],
+          tools: tools && tools.length > 0 ? tools : void 0,
+          ...responseFormat ? { response_format: responseFormat } : {}
+        }
+      },
+      ...(() => {
+        const masking = providerOptions.masking ?? this.settings.masking;
+        return masking && Object.keys(masking).length > 0 ? { masking } : {};
+      })(),
+      ...(() => {
+        const filtering = providerOptions.filtering ?? this.settings.filtering;
+        return filtering && Object.keys(filtering).length > 0 ? { filtering } : {};
+      })(),
+      ...(() => {
+        const grounding = providerOptions.grounding ?? this.settings.grounding;
+        return grounding && Object.keys(grounding).length > 0 ? { grounding } : {};
+      })(),
+      ...(() => {
+        const translation = providerOptions.translation ?? this.settings.translation;
+        return translation && Object.keys(translation).length > 0 ? { translation } : {};
+      })()
+    };
+    return { messages, orchestrationConfig, warnings };
+  }
+  /**
+   * Creates an OrchestrationClient instance.
+   *
+   * @param config - Orchestration module configuration
+   * @returns OrchestrationClient instance
+   * @internal
+   */
+  createClient(config) {
+    return new OrchestrationClient(
+      config,
+      this.config.deploymentConfig,
+      this.config.destination
+    );
   }
 };
+function buildSAPToolParameters(schema) {
+  const schemaType = schema.type;
+  if (schemaType !== void 0 && schemaType !== "object") {
+    return {
+      properties: {},
+      required: [],
+      type: "object"
+    };
+  }
+  const properties = schema.properties && typeof schema.properties === "object" ? schema.properties : {};
+  const required = Array.isArray(schema.required) && schema.required.every((item) => typeof item === "string") ? schema.required : [];
+  const additionalFields = Object.fromEntries(
+    Object.entries(schema).filter(
+      ([key]) => key !== "type" && key !== "properties" && key !== "required"
+    )
+  );
+  return {
+    properties,
+    required,
+    type: "object",
+    ...additionalFields
+  };
+}
+function createAISDKRequestBodySummary(options) {
+  return {
+    hasImageParts: options.prompt.some(
+      (message) => message.role === "user" && message.content.some(
+        (part) => part.type === "file" && part.mediaType.startsWith("image/")
+      )
+    ),
+    maxOutputTokens: options.maxOutputTokens,
+    promptMessages: options.prompt.length,
+    responseFormatType: options.responseFormat?.type,
+    seed: options.seed,
+    stopSequences: options.stopSequences?.length,
+    temperature: options.temperature,
+    toolChoiceType: options.toolChoice?.type,
+    tools: options.tools?.length ?? 0,
+    topK: options.topK,
+    topP: options.topP
+  };
+}
+function hasCallableParse(obj) {
+  return typeof obj.parse === "function";
+}
+function isZodSchema(obj) {
+  if (obj === null || typeof obj !== "object") {
+    return false;
+  }
+  const record = obj;
+  return "_def" in record && "parse" in record && hasCallableParse(record);
+}
 function mapFinishReason(reason) {
   const raw = reason;
-  if (!reason) return { unified: "other", raw };
+  if (!reason) return { raw, unified: "other" };
   switch (reason.toLowerCase()) {
-    case "stop":
+    case "content_filter":
+      return { raw, unified: "content-filter" };
     case "end_turn":
-    case "stop_sequence":
     case "eos":
-      return { unified: "stop", raw };
+    case "stop":
+    case "stop_sequence":
+      return { raw, unified: "stop" };
+    case "error":
+      return { raw, unified: "error" };
+    case "function_call":
+    case "tool_call":
+    case "tool_calls":
+      return { raw, unified: "tool-calls" };
     case "length":
     case "max_tokens":
     case "max_tokens_reached":
-      return { unified: "length", raw };
-    case "tool_calls":
-    case "tool_call":
-    case "function_call":
-      return { unified: "tool-calls", raw };
-    case "content_filter":
-      return { unified: "content-filter", raw };
-    case "error":
-      return { unified: "error", raw };
+      return { raw, unified: "length" };
     default:
-      return { unified: "other", raw };
+      return { raw, unified: "other" };
+  }
+}
+function validateModelParameters(params, warnings) {
+  if (params.temperature !== void 0 && (params.temperature < 0 || params.temperature > 2)) {
+    warnings.push({
+      message: `temperature=${String(params.temperature)} is outside typical range [0, 2]. The API may reject this value.`,
+      type: "other"
+    });
+  }
+  if (params.topP !== void 0 && (params.topP < 0 || params.topP > 1)) {
+    warnings.push({
+      message: `topP=${String(params.topP)} is outside valid range [0, 1]. The API may reject this value.`,
+      type: "other"
+    });
+  }
+  if (params.frequencyPenalty !== void 0 && (params.frequencyPenalty < -2 || params.frequencyPenalty > 2)) {
+    warnings.push({
+      message: `frequencyPenalty=${String(params.frequencyPenalty)} is outside typical range [-2, 2]. The API may reject this value.`,
+      type: "other"
+    });
+  }
+  if (params.presencePenalty !== void 0 && (params.presencePenalty < -2 || params.presencePenalty > 2)) {
+    warnings.push({
+      message: `presencePenalty=${String(params.presencePenalty)} is outside typical range [-2, 2]. The API may reject this value.`,
+      type: "other"
+    });
+  }
+  if (params.maxTokens !== void 0 && params.maxTokens <= 0) {
+    warnings.push({
+      message: `maxTokens=${String(params.maxTokens)} must be positive. The API will likely reject this value.`,
+      type: "other"
+    });
+  }
+  if (params.n !== void 0 && params.n <= 0) {
+    warnings.push({
+      message: `n=${String(params.n)} must be positive. The API will likely reject this value.`,
+      type: "other"
+    });
   }
 }
 
@@ -30975,19 +30993,19 @@ function createSAPAIProvider(options = {}) {
     const mergedSettings = {
       ...options.defaultSettings,
       ...settings,
+      filtering: settings.filtering ?? options.defaultSettings?.filtering,
+      // Complex objects: override, do not merge
+      masking: settings.masking ?? options.defaultSettings?.masking,
       modelParams: {
         ...options.defaultSettings?.modelParams ?? {},
         ...settings.modelParams ?? {}
       },
-      // Complex objects: override, do not merge
-      masking: settings.masking ?? options.defaultSettings?.masking,
-      filtering: settings.filtering ?? options.defaultSettings?.filtering,
       tools: settings.tools ?? options.defaultSettings?.tools
     };
-    return new SAPAIChatLanguageModel(modelId, mergedSettings, {
-      provider: "sap-ai",
+    return new SAPAILanguageModel(modelId, mergedSettings, {
       deploymentConfig,
-      destination: options.destination
+      destination: options.destination,
+      provider: "sap-ai"
     });
   };
   const provider = function(modelId, settings) {
@@ -31003,23 +31021,19 @@ function createSAPAIProvider(options = {}) {
 }
 var sapai = createSAPAIProvider();
 
-// src/sap-ai-chat-settings.ts
+// src/sap-ai-settings.ts
 import {
-  buildDpiMaskingProvider,
   buildAzureContentSafetyFilter,
-  buildLlamaGuard38BFilter,
   buildDocumentGroundingConfig,
-  buildTranslationConfig
+  buildDpiMaskingProvider,
+  buildLlamaGuard38BFilter,
+  buildTranslationConfig,
+  isConfigReference
 } from "@sap-ai-sdk/orchestration";
-
-// src/types/completion-request.ts
-import { isConfigReference } from "@sap-ai-sdk/orchestration";
-
-// src/types/completion-response.ts
 import {
   OrchestrationResponse,
-  OrchestrationStreamResponse,
-  OrchestrationStreamChunkResponse
+  OrchestrationStreamChunkResponse,
+  OrchestrationStreamResponse
 } from "@sap-ai-sdk/orchestration";
 
 // src/index.ts