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

package/dist/index.cjs

@@ -24766,7 +24766,7 @@ var require_form_data = __commonJS({
     var parseUrl = require("url").parse;
     var fs = require("fs");
     var Stream = require("stream").Stream;
-    var crypto = require("crypto");
+    var crypto2 = require("crypto");
     var mime = require_mime_types();
     var asynckit = require_asynckit();
     var setToStringTag = require_es_set_tostringtag();
@@ -24972,7 +24972,7 @@ var require_form_data = __commonJS({
       return Buffer.concat([dataBuffer, Buffer.from(this._lastBoundary())]);
     };
     FormData2.prototype._generateBoundary = function() {
-      this._boundary = "--------------------------" + crypto.randomBytes(12).toString("hex");
+      this._boundary = "--------------------------" + crypto2.randomBytes(12).toString("hex");
     };
     FormData2.prototype.getLengthSync = function() {
       var knownLength = this._overheadLength + this._valueLength;
@@ -26202,7 +26202,7 @@ var require_axios = __commonJS({
   "node_modules/axios/dist/node/axios.cjs"(exports2, module2) {
     "use strict";
     var FormData$1 = require_form_data();
-    var crypto = require("crypto");
+    var crypto2 = require("crypto");
     var url = require("url");
     var proxyFromEnv = require_proxy_from_env();
     var http = require("http");
@@ -26217,7 +26217,7 @@ var require_axios = __commonJS({
       return e && typeof e === "object" && "default" in e ? e : { "default": e };
     }
     var FormData__default = /* @__PURE__ */ _interopDefaultLegacy(FormData$1);
-    var crypto__default = /* @__PURE__ */ _interopDefaultLegacy(crypto);
+    var crypto__default = /* @__PURE__ */ _interopDefaultLegacy(crypto2);
     var url__default = /* @__PURE__ */ _interopDefaultLegacy(url);
     var proxyFromEnv__default = /* @__PURE__ */ _interopDefaultLegacy(proxyFromEnv);
     var http__default = /* @__PURE__ */ _interopDefaultLegacy(http);
@@ -29737,22 +29737,22 @@ var require_dist = __commonJS({
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  OrchestrationClient: () => import_orchestration5.OrchestrationClient,
-  OrchestrationResponse: () => import_orchestration4.OrchestrationResponse,
-  OrchestrationStreamChunkResponse: () => import_orchestration4.OrchestrationStreamChunkResponse,
-  OrchestrationStreamResponse: () => import_orchestration4.OrchestrationStreamResponse,
+  OrchestrationClient: () => import_orchestration4.OrchestrationClient,
+  OrchestrationResponse: () => import_orchestration3.OrchestrationResponse,
+  OrchestrationStreamChunkResponse: () => import_orchestration3.OrchestrationStreamChunkResponse,
+  OrchestrationStreamResponse: () => import_orchestration3.OrchestrationStreamResponse,
   buildAzureContentSafetyFilter: () => import_orchestration2.buildAzureContentSafetyFilter,
   buildDocumentGroundingConfig: () => import_orchestration2.buildDocumentGroundingConfig,
   buildDpiMaskingProvider: () => import_orchestration2.buildDpiMaskingProvider,
   buildLlamaGuard38BFilter: () => import_orchestration2.buildLlamaGuard38BFilter,
   buildTranslationConfig: () => import_orchestration2.buildTranslationConfig,
   createSAPAIProvider: () => createSAPAIProvider,
-  isConfigReference: () => import_orchestration3.isConfigReference,
+  isConfigReference: () => import_orchestration2.isConfigReference,
   sapai: () => sapai
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/sap-ai-chat-language-model.ts
+// src/sap-ai-language-model.ts
 var import_orchestration = require("@sap-ai-sdk/orchestration");
 var import_zod_to_json_schema = require("zod-to-json-schema");
 
@@ -29764,25 +29764,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 import_provider.UnsupportedFunctionalityError({
@@ -29824,10 +29877,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;
             }
@@ -29839,73 +29899,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) {
-          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(
@@ -29920,16 +29922,6 @@ function convertToSAPMessages(prompt, options = {}) {
 // src/sap-ai-error.ts
 var import_provider2 = require("@ai-sdk/provider");
 var import_util = __toESM(require_dist(), 1);
-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;
@@ -29951,9 +29943,9 @@ function convertSAPErrorToAPICallError(errorResponse, context) {
   const statusCode = getStatusCodeFromSAPError(code);
   const responseBody = JSON.stringify({
     error: {
-      message,
       code,
       location,
+      message,
       request_id: requestId
     }
   });
@@ -29976,53 +29968,14 @@ Error location: ${location}`;
 Request ID: ${requestId}`;
   }
   return new import_provider2.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 import_provider2.APICallError || error instanceof import_provider2.LoadAPIKeyError) {
@@ -30047,167 +30000,92 @@ 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 import_provider2.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 import_provider2.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 ?? ""
   });
 }
-
-// src/sap-ai-chat-language-model.ts
-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 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 hasCallableParse(obj) {
-  return typeof obj.parse === "function";
+function getStatusCodeFromSAPError(code) {
+  if (!code) return 500;
+  if (code >= 100 && code < 600) {
+    return code;
+  }
+  return 500;
 }
-function isZodSchema(obj) {
-  if (obj === null || typeof obj !== "object") {
+function isOrchestrationErrorResponse(error) {
+  if (error === null || typeof error !== "object" || !("error" in error)) {
     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 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"
+    );
   }
-  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
-  };
+  return typeof innerError === "object" && innerError !== null && "message" in innerError && typeof innerError.message === "string";
 }
-var SAPAIChatLanguageModel = class {
-  specificationVersion = "v2";
-  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 (content-type rules are enforced via supportedUrls)
-   */
-  supportsUrl(url) {
-    return url.protocol === "https:" || url.protocol === "data:";
-  }
-  /**
-   * Returns supported URL patterns for different content types.
-   *
-   * @returns Record of content types to regex patterns
-   */
-  get supportedUrls() {
-    return {
-      "image/*": [/^https:\/\/.+$/i, /^data:image\/.*$/]
-    };
-  }
+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-language-model.ts
+var StreamIdGenerator = class {
   /**
-   * Gets the provider identifier.
+   * Generates a unique ID for a text block.
    *
-   * @returns The provider name ('sap-ai')
+   * @returns RFC 4122-compliant UUID string
    */
-  get provider() {
-    return this.config.provider;
+  generateTextBlockId() {
+    return crypto.randomUUID();
   }
+};
+var SAPAILanguageModel = class {
+  modelId;
+  specificationVersion = "v3";
   /**
    * Model capabilities.
    *
@@ -30216,203 +30094,91 @@ var SAPAIChatLanguageModel = class {
    * 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;
+  /** Streaming responses. */
+  supportsStreaming = true;
+  /** Structured JSON outputs (json_schema response format). */
+  supportsStructuredOutputs = true;
+  /** Tool/function calling. */
+  supportsToolCalls = true;
   /**
-   * Builds orchestration module config for SAP AI SDK.
+   * Generates text completion using SAP AI Core's Orchestration API.
    *
-   * @param options - Call options from the AI SDK
-   * @returns Object containing orchestration config, messages, and warnings
-   * @internal
+   * This method implements the `LanguageModelV3.doGenerate` interface,
+   * providing synchronous (non-streaming) text generation with support for:
+   * - Multi-turn conversations with system/user/assistant messages
+   * - Tool calling (function calling) with structured outputs
+   * - Multi-modal inputs (text + images)
+   * - Data masking via SAP DPI
+   * - Content filtering via Azure Content Safety or Llama Guard
+   *
+   * **Return Structure:**
+   * - Finish reason: `{ unified: string, raw?: string }`
+   * - Usage: Nested structure with token breakdown `{ inputTokens: { total, ... }, outputTokens: { total, ... } }`
+   * - Warnings: Array of warnings with `type` and optional `feature` field
+   *
+   * @param options - Generation options including prompt, tools, temperature, etc.
+   * @returns Promise resolving to generation result with content, usage, and metadata
+   *
+   * @throws {InvalidPromptError} If prompt format is invalid
+   * @throws {InvalidArgumentError} If arguments are malformed
+   * @throws {APICallError} If the SAP AI Core API call fails
+   *
+   * @example
+   * ```typescript
+   * const result = await model.doGenerate({
+   *   prompt: [
+   *     { role: 'user', content: [{ type: 'text', text: 'Hello!' }] }
+   *   ],
+   *   temperature: 0.7,
+   *   maxTokens: 100
+   * });
+   *
+   * console.log(result.content); // Array of V3 content parts
+   * console.log(result.finishReason.unified); // "stop", "length", "tool-calls", etc.
+   * console.log(result.usage.inputTokens.total); // Total input tokens
+   * ```
+   *
+   * @since 1.0.0
+   * @since 4.0.0 Updated to LanguageModelV3 interface
    */
-  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 = (0, import_zod_to_json_schema.zodToJsonSchema)(
-                toolWithParams.parameters,
-                {
-                  $refStrategy: "none"
-                }
-              );
-              const schemaRecord = jsonSchema;
-              delete schemaRecord.$schema;
-              parameters = buildSAPToolParameters(schemaRecord);
-            } catch {
-              warnings.push({
-                type: "unsupported-tool",
-                tool,
-                details: "Failed to convert tool Zod schema to JSON Schema. 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-tool",
-            tool
-          });
-          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-setting",
-        setting: "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 provider() {
+    return this.config.provider;
+  }
+  /**
+   * Returns supported URL patterns for different content types.
+   *
+   * @returns Record of content types to regex patterns
+   */
+  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 import_orchestration.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).
    *
-   * This method implements the `LanguageModelV2.doGenerate` interface,
+   * This method implements the `LanguageModelV3.doGenerate` interface,
    * sending a request to SAP AI Core and returning the complete response.
    *
    * **Features:**
@@ -30420,6 +30186,13 @@ var SAPAIChatLanguageModel = class {
    * - Multi-modal input (text + images)
    * - Data masking (if configured)
    * - Content filtering (if configured)
+   * - Abort signal support (via Promise.race)
+   *
+   * **Note on Abort Signal:**
+   * The abort signal implementation uses Promise.race to reject the promise when
+   * the signal is aborted. However, this does not cancel the underlying HTTP request
+   * to SAP AI Core - the request continues executing on the server. This is a
+   * limitation of the SAP AI SDK's chatCompletion API.
    *
    * @param options - Generation options including prompt, tools, and settings
    * @returns Promise resolving to the generation result with content, usage, and metadata
@@ -30438,7 +30211,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 = {
@@ -30455,6 +30228,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 () => {
@@ -30492,7 +30273,7 @@ var SAPAIChatLanguageModel = class {
         Object.entries(responseHeadersRaw).flatMap(([key, value]) => {
           if (typeof value === "string") return [[key, value]];
           if (Array.isArray(value)) {
-            const strings = value.filter((item) => typeof item === "string").join(",");
+            const strings = value.filter((item) => typeof item === "string").join("; ");
             return strings.length > 0 ? [[key, strings]] : [];
           }
           if (typeof value === "number" || typeof value === "boolean") {
@@ -30505,18 +30286,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"
           });
         }
       }
@@ -30525,18 +30306,13 @@ var SAPAIChatLanguageModel = class {
       const finishReason = mapFinishReason(finishReasonRaw);
       const rawResponseBody = {
         content: textContent,
-        toolCalls,
+        finishReason: finishReasonRaw,
         tokenUsage,
-        finishReason: finishReasonRaw
+        toolCalls
       };
       return {
         content,
         finishReason,
-        usage: {
-          inputTokens: tokenUsage.prompt_tokens,
-          outputTokens: tokenUsage.completion_tokens,
-          totalTokens: tokenUsage.total_tokens
-        },
         providerMetadata: {
           "sap-ai": {
             finishReason: finishReasonRaw ?? "unknown",
@@ -30548,37 +30324,61 @@ 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"
       });
     }
   }
   /**
    * Generates a streaming completion.
    *
-   * This method implements the `LanguageModelV2.doStream` interface,
+   * This method implements the `LanguageModelV3.doStream` interface,
    * sending a streaming request to SAP AI Core and returning a stream of response parts.
    *
    * **Stream Events:**
-   * - `stream-start` - Stream initialization
+   * - `stream-start` - Stream initialization with warnings
    * - `response-metadata` - Response metadata (model, timestamp)
-   * - `text-start` - Text generation starts
-   * - `text-delta` - Incremental text chunks
-   * - `text-end` - Text generation completes
-   * - `tool-call` - Tool call detected
+   * - `text-start` - Text block begins (with unique ID)
+   * - `text-delta` - Incremental text chunks (with block ID)
+   * - `text-end` - Text block completes (with accumulated text)
+   * - `tool-input-start` - Tool input begins
+   * - `tool-input-delta` - Tool input chunk
+   * - `tool-input-end` - Tool input completes
+   * - `tool-call` - Complete tool call
    * - `finish` - Stream completes with usage and finish reason
    * - `error` - Error occurred
    *
+   * **Stream Structure:**
+   * - Text blocks have explicit lifecycle with unique IDs
+   * - Finish reason format: `{ unified: string, raw?: string }`
+   * - 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
    *
@@ -30594,12 +30394,17 @@ var SAPAIChatLanguageModel = class {
    *   if (part.type === 'text-delta') {
    *     process.stdout.write(part.delta);
    *   }
+   *   if (part.type === 'text-end') {
+   *     console.log('Block complete:', part.id, part.text);
+   *   }
    * }
    * ```
+   *
+   * @since 4.0.0
    */
   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 = {
@@ -30623,15 +30428,28 @@ var SAPAIChatLanguageModel = class {
         options.abortSignal,
         { promptTemplating: { include_usage: true } }
       );
+      const idGenerator = new StreamIdGenerator();
+      let textBlockId = null;
       const streamState = {
-        finishReason: "unknown",
-        usage: {
-          inputTokens: void 0,
-          outputTokens: void 0,
-          totalTokens: void 0
+        activeText: false,
+        finishReason: {
+          raw: void 0,
+          unified: "other"
         },
         isFirstChunk: true,
-        activeText: false
+        usage: {
+          inputTokens: {
+            cacheRead: void 0,
+            cacheWrite: void 0,
+            noCache: void 0,
+            total: void 0
+          },
+          outputTokens: {
+            reasoning: void 0,
+            text: void 0,
+            total: void 0
+          }
+        }
       };
       const toolCallsInProgress = /* @__PURE__ */ new Map();
       const sdkStream = streamResponse.stream;
@@ -30639,6 +30457,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",
@@ -30649,26 +30472,32 @@ 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 = "tool-calls";
+                streamState.finishReason = {
+                  raw: void 0,
+                  unified: "tool-calls"
+                };
               }
               const deltaContent = chunk.getDeltaContent();
-              if (typeof deltaContent === "string" && deltaContent.length > 0 && streamState.finishReason !== "tool-calls") {
+              if (typeof deltaContent === "string" && deltaContent.length > 0 && streamState.finishReason.unified !== "tool-calls") {
                 if (!streamState.activeText) {
-                  controller.enqueue({ type: "text-start", id: "0" });
+                  textBlockId = idGenerator.generateTextBlockId();
+                  controller.enqueue({ id: textBlockId, type: "text-start" });
                   streamState.activeText = true;
                 }
-                controller.enqueue({
-                  type: "text-delta",
-                  id: "0",
-                  delta: deltaContent
-                });
+                if (textBlockId) {
+                  controller.enqueue({
+                    delta: deltaContent,
+                    id: textBlockId,
+                    type: "text-delta"
+                  });
+                }
               }
               if (Array.isArray(deltaToolCalls) && deltaToolCalls.length > 0) {
                 for (const toolCallChunk of deltaToolCalls) {
@@ -30678,11 +30507,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);
@@ -30697,9 +30526,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;
@@ -30707,9 +30536,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"
                       });
                     }
                   }
@@ -30718,7 +30547,7 @@ var SAPAIChatLanguageModel = class {
               const chunkFinishReason = chunk.getFinishReason();
               if (chunkFinishReason) {
                 streamState.finishReason = mapFinishReason(chunkFinishReason);
-                if (streamState.finishReason === "tool-calls") {
+                if (streamState.finishReason.unified === "tool-calls") {
                   const toolCalls2 = Array.from(toolCallsInProgress.values());
                   for (const tc of toolCalls2) {
                     if (tc.didEmitCall) {
@@ -30727,28 +30556,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) {
-                    controller.enqueue({ type: "text-end", id: "0" });
+                  if (streamState.activeText && textBlockId) {
+                    controller.enqueue({ id: textBlockId, type: "text-end" });
                     streamState.activeText = false;
                   }
                 }
@@ -30763,105 +30592,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({ id: textBlockId, type: "text-end" });
+            }
+            const finalFinishReason = streamResponse.getFinishReason();
+            if (finalFinishReason) {
+              streamState.finishReason = mapFinishReason(finalFinishReason);
+            } else if (didEmitAnyToolCalls) {
+              streamState.finishReason = {
+                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;
+            }
+            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 = (0, import_zod_to_json_schema.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({});
             }
-            if (streamState.activeText) {
-              controller.enqueue({ type: "text-end", id: "0" });
-            }
-            const finalFinishReason = streamResponse.getFinishReason();
-            if (finalFinishReason) {
-              streamState.finishReason = mapFinishReason(finalFinishReason);
-            } else if (didEmitAnyToolCalls) {
-              streamState.finishReason = "tool-calls";
-            }
-            const finalUsage = streamResponse.getTokenUsage();
-            if (finalUsage) {
-              streamState.usage.inputTokens = finalUsage.prompt_tokens;
-              streamState.usage.outputTokens = finalUsage.completion_tokens;
-              streamState.usage.totalTokens = finalUsage.total_tokens;
+          } 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
-        },
-        warnings: warningsOut
-      };
-    } 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 import_orchestration.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) {
-  if (!reason) return "unknown";
+  const raw = reason;
+  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 "stop";
+    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 "length";
-    case "tool_calls":
-    case "tool_call":
-    case "function_call":
-      return "tool-calls";
-    case "content_filter":
-      return "content-filter";
-    case "error":
-      return "error";
+      return { raw, unified: "length" };
     default:
-      return "other";
+      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"
+    });
   }
 }
 
@@ -30879,19 +31002,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) {
@@ -30907,17 +31030,12 @@ function createSAPAIProvider(options = {}) {
 }
 var sapai = createSAPAIProvider();
 
-// src/sap-ai-chat-settings.ts
+// src/sap-ai-settings.ts
 var import_orchestration2 = require("@sap-ai-sdk/orchestration");
-
-// src/types/completion-request.ts
 var import_orchestration3 = require("@sap-ai-sdk/orchestration");
 
-// src/types/completion-response.ts
-var import_orchestration4 = require("@sap-ai-sdk/orchestration");
-
 // src/index.ts
-var import_orchestration5 = require("@sap-ai-sdk/orchestration");
+var import_orchestration4 = require("@sap-ai-sdk/orchestration");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   OrchestrationClient,