@jerome-benoit/sap-ai-provider 4.1.0 → 4.1.2

package/dist/index.cjs

@@ -29765,6 +29765,17 @@ var import_orchestration = require("@sap-ai-sdk/orchestration");
 // src/sap-ai-error.ts
 var import_provider = require("@ai-sdk/provider");
 var import_util = __toESM(require_dist(), 1);
+var HTTP_STATUS = {
+  BAD_REQUEST: 400,
+  CONFLICT: 409,
+  FORBIDDEN: 403,
+  INTERNAL_ERROR: 500,
+  NOT_FOUND: 404,
+  RATE_LIMIT: 429,
+  REQUEST_TIMEOUT: 408,
+  SERVICE_UNAVAILABLE: 503,
+  UNAUTHORIZED: 401
+};
 function convertSAPErrorToAPICallError(errorResponse, context) {
   const error = errorResponse.error;
   let message;
@@ -29793,7 +29804,7 @@ function convertSAPErrorToAPICallError(errorResponse, context) {
     }
   });
   let enhancedMessage = message;
-  if (statusCode === 401 || statusCode === 403) {
+  if (statusCode === HTTP_STATUS.UNAUTHORIZED || statusCode === HTTP_STATUS.FORBIDDEN) {
     enhancedMessage += "\n\nAuthentication failed. Verify your AICORE_SERVICE_KEY environment variable is set correctly.\nSee: https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/create-service-key";
     if (requestId) {
       enhancedMessage += `
@@ -29803,7 +29814,7 @@ Request ID: ${requestId}`;
       message: enhancedMessage
     });
   }
-  if (statusCode === 404) {
+  if (statusCode === HTTP_STATUS.NOT_FOUND) {
     enhancedMessage += "\n\nResource not found. The model or deployment may not exist in your SAP AI Core instance.\nSee: https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/create-deployment-for-orchestration";
     if (requestId) {
       enhancedMessage += `
@@ -29816,9 +29827,9 @@ Request ID: ${requestId}`;
       modelType: "languageModel"
     });
   }
-  if (statusCode === 429) {
+  if (statusCode === HTTP_STATUS.RATE_LIMIT) {
     enhancedMessage += "\n\nRate limit exceeded. Please try again later or contact your SAP administrator.\nSee: https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/rate-limits";
-  } else if (statusCode >= 500) {
+  } else if (statusCode >= HTTP_STATUS.INTERNAL_ERROR) {
     enhancedMessage += "\n\nSAP AI Core service error. This is typically a temporary issue. The request will be retried automatically.\nSee: https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/troubleshooting";
   } else if (location) {
     enhancedMessage += `
@@ -29878,7 +29889,7 @@ See: https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/create-serv
         message: `Network error connecting to SAP AI Core: ${originalMsg}`,
         requestBodyValues: context?.requestBody,
         responseHeaders,
-        statusCode: 503,
+        statusCode: HTTP_STATUS.SERVICE_UNAVAILABLE,
         url: context?.url ?? ""
       });
     }
@@ -29891,7 +29902,7 @@ See: https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/create-serv
 Check your destination configuration or provide a valid destinationName.`,
         requestBodyValues: context?.requestBody,
         responseHeaders,
-        statusCode: 500,
+        statusCode: HTTP_STATUS.BAD_REQUEST,
         url: context?.url ?? ""
       });
     }
@@ -29915,7 +29926,7 @@ See: https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/create-depl
 The model's response was blocked by content safety filters. Try a different prompt.`,
         requestBodyValues: context?.requestBody,
         responseHeaders,
-        statusCode: 400,
+        statusCode: HTTP_STATUS.BAD_REQUEST,
         url: context?.url ?? ""
       });
     }
@@ -29932,14 +29943,91 @@ The model's response was blocked by content safety filters. Try a different prom
         url: context?.url ?? ""
       });
     }
-    if (errorMsg.includes("iterate over") || errorMsg.includes("consumed stream") || errorMsg.includes("parse message into json") || errorMsg.includes("no body")) {
+    if (errorMsg.includes("consumed stream")) {
+      return new import_provider.APICallError({
+        cause: error,
+        isRetryable: false,
+        message: `SAP AI Core stream consumption error: ${originalMsg}`,
+        requestBodyValues: context?.requestBody,
+        responseHeaders,
+        statusCode: HTTP_STATUS.INTERNAL_ERROR,
+        url: context?.url ?? ""
+      });
+    }
+    if (errorMsg.includes("iterating over") || errorMsg.includes("parse message into json") || errorMsg.includes("received from") || errorMsg.includes("no body") || errorMsg.includes("invalid sse payload")) {
       return new import_provider.APICallError({
         cause: error,
         isRetryable: true,
         message: `SAP AI Core streaming error: ${originalMsg}`,
         requestBodyValues: context?.requestBody,
         responseHeaders,
-        statusCode: 500,
+        statusCode: HTTP_STATUS.INTERNAL_ERROR,
+        url: context?.url ?? ""
+      });
+    }
+    if (errorMsg.includes("prompt template or messages must be defined") || errorMsg.includes("filtering parameters cannot be empty") || errorMsg.includes("templating yaml string must be non-empty") || errorMsg.includes("could not access response data") || errorMsg.includes("could not parse json") || errorMsg.includes("error parsing yaml") || errorMsg.includes("yaml does not conform") || errorMsg.includes("validation errors")) {
+      return new import_provider.APICallError({
+        cause: error,
+        isRetryable: false,
+        message: `SAP AI Core configuration error: ${originalMsg}`,
+        requestBodyValues: context?.requestBody,
+        responseHeaders,
+        statusCode: HTTP_STATUS.BAD_REQUEST,
+        url: context?.url ?? ""
+      });
+    }
+    if (errorMsg.includes("buffer is not available as globals")) {
+      return new import_provider.APICallError({
+        cause: error,
+        isRetryable: false,
+        message: `SAP AI Core environment error: ${originalMsg}`,
+        requestBodyValues: context?.requestBody,
+        responseHeaders,
+        statusCode: HTTP_STATUS.INTERNAL_ERROR,
+        url: context?.url ?? ""
+      });
+    }
+    if (errorMsg.includes("response stream is undefined")) {
+      return new import_provider.APICallError({
+        cause: error,
+        isRetryable: false,
+        message: `SAP AI Core response stream error: ${originalMsg}`,
+        requestBodyValues: context?.requestBody,
+        responseHeaders,
+        statusCode: HTTP_STATUS.INTERNAL_ERROR,
+        url: context?.url ?? ""
+      });
+    }
+    if (errorMsg.includes("response is required to process") || errorMsg.includes("stream is still open") || errorMsg.includes("data is not available yet")) {
+      return new import_provider.APICallError({
+        cause: error,
+        isRetryable: true,
+        message: `SAP AI Core response processing error: ${originalMsg}`,
+        requestBodyValues: context?.requestBody,
+        responseHeaders,
+        statusCode: HTTP_STATUS.INTERNAL_ERROR,
+        url: context?.url ?? ""
+      });
+    }
+    if (errorMsg.includes("failed to fetch the list of deployments")) {
+      return new import_provider.APICallError({
+        cause: error,
+        isRetryable: true,
+        message: `SAP AI Core deployment retrieval error: ${originalMsg}`,
+        requestBodyValues: context?.requestBody,
+        responseHeaders,
+        statusCode: HTTP_STATUS.SERVICE_UNAVAILABLE,
+        url: context?.url ?? ""
+      });
+    }
+    if (errorMsg.includes("received non-uint8array")) {
+      return new import_provider.APICallError({
+        cause: error,
+        isRetryable: false,
+        message: `SAP AI Core stream buffer error: ${originalMsg}`,
+        requestBodyValues: context?.requestBody,
+        responseHeaders,
+        statusCode: HTTP_STATUS.INTERNAL_ERROR,
         url: context?.url ?? ""
       });
     }
@@ -29952,7 +30040,7 @@ The model's response was blocked by content safety filters. Try a different prom
     message: fullMessage,
     requestBodyValues: context?.requestBody,
     responseHeaders,
-    statusCode: 500,
+    statusCode: HTTP_STATUS.INTERNAL_ERROR,
     url: context?.url ?? ""
   });
 }
@@ -29985,11 +30073,11 @@ function getAxiosResponseHeaders(error) {
   return normalizeHeaders(maybeAxios.response?.headers);
 }
 function getStatusCodeFromSAPError(code) {
-  if (!code) return 500;
+  if (!code) return HTTP_STATUS.INTERNAL_ERROR;
   if (code >= 100 && code < 600) {
     return code;
   }
-  return 500;
+  return HTTP_STATUS.INTERNAL_ERROR;
 }
 function isOrchestrationErrorResponse(error) {
   if (error === null || typeof error !== "object" || !("error" in error)) {
@@ -29999,14 +30087,34 @@ function isOrchestrationErrorResponse(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 innerError.every((entry) => {
+      if (entry === null || typeof entry !== "object" || !("message" in entry)) {
+        return false;
+      }
+      const errorEntry = entry;
+      if (typeof errorEntry.message !== "string") {
+        return false;
+      }
+      if ("code" in entry && typeof errorEntry.code !== "number") {
+        return false;
+      }
+      return true;
+    });
+  }
+  if (typeof innerError !== "object" || innerError === null || !("message" in innerError)) {
+    return false;
+  }
+  const errorObj = innerError;
+  if (typeof errorObj.message !== "string") {
+    return false;
+  }
+  if ("code" in innerError && typeof errorObj.code !== "number") {
+    return false;
   }
-  return typeof innerError === "object" && innerError !== null && "message" in innerError && typeof innerError.message === "string";
+  return true;
 }
 function isRetryable(statusCode) {
-  return statusCode === 408 || statusCode === 409 || statusCode === 429 || statusCode >= 500 && statusCode < 600;
+  return statusCode === HTTP_STATUS.REQUEST_TIMEOUT || statusCode === HTTP_STATUS.CONFLICT || statusCode === HTTP_STATUS.RATE_LIMIT || statusCode >= HTTP_STATUS.INTERNAL_ERROR && statusCode < 600;
 }
 function normalizeHeaders(headers) {
   if (!headers || typeof headers !== "object") return void 0;
@@ -30084,9 +30192,46 @@ var modelParamsSchema = import_zod.z.object({
    */
   topP: import_zod.z.number().min(0).max(1).optional()
 }).catchall(import_zod.z.unknown());
+var embeddingModelParamsSchema = import_zod.z.object({
+  /**
+   * The number of dimensions for output embeddings.
+   * Must be a positive integer. Support varies by model.
+   * - text-embedding-3-small: supports 512, 1536
+   * - text-embedding-3-large: supports 256, 1024, 3072
+   */
+  dimensions: import_zod.z.number().int().positive().optional(),
+  /**
+   * Encoding format for embeddings.
+   * - 'float': Array of floats (default)
+   * - 'base64': Base64-encoded binary
+   * - 'binary': Raw binary format
+   */
+  encoding_format: import_zod.z.enum(["base64", "binary", "float"]).optional(),
+  /**
+   * Whether to normalize the embedding vectors.
+   * When true, vectors are normalized to unit length.
+   */
+  normalize: import_zod.z.boolean().optional()
+}).catchall(import_zod.z.unknown());
+function validateEmbeddingModelParamsSettings(modelParams) {
+  return embeddingModelParamsSchema.parse(modelParams);
+}
 function validateModelParamsSettings(modelParams) {
   return modelParamsSchema.parse(modelParams);
 }
+function validateModelParamsWithWarnings(params, warnings) {
+  const result = modelParamsSchema.safeParse(params);
+  if (!result.success) {
+    for (const issue of result.error.issues) {
+      const path = issue.path.join(".");
+      const value = path ? params[path] : void 0;
+      warnings.push({
+        message: `${path}=${String(value)} is invalid: ${issue.message}. The API may reject this value.`,
+        type: "other"
+      });
+    }
+  }
+}
 var sapAILanguageModelProviderOptions = (0, import_provider_utils.lazySchema)(
   () => (0, import_provider_utils.zodSchema)(
     import_zod.z.object({
@@ -30112,8 +30257,14 @@ var sapAIEmbeddingProviderOptions = (0, import_provider_utils.lazySchema)(
       /**
        * Additional model parameters for this call.
        * Passed directly to the embedding API.
+       *
+       * Known parameters:
+       * - `dimensions`: Output embedding dimensions (model-dependent)
+       * - `encoding_format`: 'float' | 'base64' | 'binary'
+       * - `normalize`: Whether to normalize vectors
+       * @see {@link embeddingModelParamsSchema} for validation rules
        */
-      modelParams: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional(),
+      modelParams: embeddingModelParamsSchema.optional(),
       /**
        * Embedding task type for this specific call.
        * Overrides the constructor `type` setting.
@@ -30161,6 +30312,9 @@ var SAPAIEmbeddingModel = class {
    * @param config - Internal configuration from the provider
    */
   constructor(modelId, settings = {}, config) {
+    if (settings.modelParams) {
+      validateEmbeddingModelParamsSettings(settings.modelParams);
+    }
     this.modelId = modelId;
     this.settings = settings;
     this.config = config;
@@ -30298,7 +30452,7 @@ function convertToSAPMessages(prompt, options = {}) {
           switch (part.type) {
             case "reasoning": {
               if (includeReasoning && part.text) {
-                text += `<reasoning>${part.text}</reasoning>`;
+                text += `<think>${part.text}</think>`;
               }
               break;
             }
@@ -31142,7 +31296,7 @@ var SAPAILanguageModel = class {
     if (options.seed !== void 0) {
       modelParams.seed = options.seed;
     }
-    validateAISDKParameters(
+    validateModelParamsWithWarnings(
       {
         frequencyPenalty: options.frequencyPenalty,
         maxTokens: options.maxOutputTokens,
@@ -31291,38 +31445,6 @@ function mapFinishReason(reason) {
       return { raw, unified: "other" };
   }
 }
-function validateAISDKParameters(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"
-    });
-  }
-}
 
 // src/sap-ai-provider.ts
 function createSAPAIProvider(options = {}) {