@jerome-benoit/sap-ai-provider 4.4.8 → 4.4.9

package/README.md

@@ -67,7 +67,7 @@ SAP's enterprise-grade AI models through the familiar Vercel AI SDK interface.
 - 🔒 **Data Masking** - Built-in SAP DPI integration for privacy
 - 🛡️ **Content Filtering** - Azure Content Safety and Llama Guard support
 - 🔧 **TypeScript Support** - Full type safety and IntelliSense
-- 🎨 **Multiple Models** - Support for GPT-4, Claude, Gemini, Nova, and more
+- 🎨 **Multiple Models** - Support for OpenAI, Claude, Gemini, Nova, and more
 - ⚡ **Language Model V3** - Latest Vercel AI SDK specification with enhanced
   streaming
 - 📊 **Text Embeddings** - Generate vector embeddings for RAG and semantic
@@ -93,9 +93,9 @@ import { APICallError } from "@ai-sdk/provider";
 const provider = createSAPAIProvider();
 
 try {
-  // Generate text with gpt-4o
+  // Generate text with gpt-4.1
   const result = await generateText({
-    model: provider("gpt-4o"),
+    model: provider("gpt-4.1"),
     prompt: "Explain quantum computing in simple terms.",
   });
 
@@ -120,12 +120,12 @@ try {
 | **Install**         | `npm install @jerome-benoit/sap-ai-provider ai`                  | [Installation](#installation)                                 |
 | **Auth Setup**      | Add `AICORE_SERVICE_KEY` to `.env`                               | [Environment Setup](./ENVIRONMENT_SETUP.md)                   |
 | **Create Provider** | `createSAPAIProvider()` or use `sapai`                           | [Provider Creation](#provider-creation)                       |
-| **Text Generation** | `generateText({ model: provider("gpt-4o"), prompt })`            | [Basic Usage](#text-generation)                               |
-| **Streaming**       | `streamText({ model: provider("gpt-4o"), prompt })`              | [Streaming](#streaming-responses)                             |
+| **Text Generation** | `generateText({ model: provider("gpt-4.1"), prompt })`           | [Basic Usage](#text-generation)                               |
+| **Streaming**       | `streamText({ model: provider("gpt-4.1"), prompt })`             | [Streaming](#streaming-responses)                             |
 | **Tool Calling**    | `generateText({ tools: { myTool: tool({...}) } })`               | [Tool Calling](#tool-calling)                                 |
 | **Error Handling**  | `catch (error instanceof APICallError)`                          | [API Reference](./API_REFERENCE.md#error-handling--reference) |
 | **Choose Model**    | See 80+ models (GPT, Claude, Gemini, Llama)                      | [Models](./API_REFERENCE.md#models)                           |
-| **Embeddings**      | `embed({ model: provider.embedding("text-embedding-ada-002") })` | [Embeddings](#embeddings)                                     |
+| **Embeddings**      | `embed({ model: provider.embedding("text-embedding-3-small") })` | [Embeddings](#embeddings)                                     |
 
 ## Installation
 
@@ -184,13 +184,13 @@ const provider = createSAPAIProvider({
 });
 
 // Model-level API override
-const model = provider("gpt-4o", {
+const model = provider("gpt-4.1", {
   api: "orchestration", // Override for this model only
 });
 
 // Per-call API override via providerOptions
 const result = await generateText({
-  model: provider("gpt-4o"),
+  model: provider("gpt-4.1"),
   prompt: "Hello",
   providerOptions: {
     [SAP_AI_PROVIDER_NAME]: {
@@ -215,7 +215,7 @@ import { generateText } from "ai";
 
 // Use directly with auto-detected configuration
 const result = await generateText({
-  model: sapai("gpt-4o"),
+  model: sapai("gpt-4.1"),
   prompt: "Hello!",
 });
 ```
@@ -229,11 +229,11 @@ The provider is callable and also exposes explicit methods:
 
 ```typescript
 // Callable syntax (creates language model)
-const chatModel = provider("gpt-4o");
+const chatModel = provider("gpt-4.1");
 
 // Explicit method syntax
-const chatModel = provider.chat("gpt-4o");
-const embeddingModel = provider.embedding("text-embedding-ada-002");
+const chatModel = provider.chat("gpt-4.1");
+const embeddingModel = provider.embedding("text-embedding-3-small");
 ```
 
 All methods accept an optional second parameter for model-specific settings.
@@ -255,7 +255,7 @@ instructions, SAP BTP deployment, and troubleshooting.
 
 ```typescript
 const result = await generateText({
-  model: provider("gpt-4o"),
+  model: provider("gpt-4.1"),
   prompt: "Write a short story about a robot learning to paint.",
 });
 console.log(result.text);
@@ -274,7 +274,7 @@ console.log(result.text);
 
 ```typescript
 const result = await generateText({
-  model: provider("anthropic--claude-3.5-sonnet"),
+  model: provider("anthropic--claude-4.5-sonnet"),
   messages: [
     { role: "system", content: "You are a helpful coding assistant." },
     {
@@ -298,7 +298,7 @@ import { APICallError } from "@ai-sdk/provider";
 
 try {
   const result = streamText({
-    model: provider("gpt-4o"),
+    model: provider("gpt-4.1"),
     prompt: "Explain machine learning concepts.",
   });
 
@@ -333,7 +333,7 @@ import { generateText } from "ai";
 
 const provider = createSAPAIProvider();
 
-const model = provider("gpt-4o", {
+const model = provider("gpt-4.1", {
   // Optional: include assistant reasoning parts (chain-of-thought).
   // Best practice is to keep this disabled.
   includeReasoning: false,
@@ -367,7 +367,7 @@ const provider = createSAPAIProvider();
 
 // Single embedding
 const { embedding } = await embed({
-  model: provider.embedding("text-embedding-ada-002"),
+  model: provider.embedding("text-embedding-3-small"),
   value: "What is machine learning?",
 });
 
@@ -380,43 +380,24 @@ const { embeddings } = await embedMany({
 
 **Run it:** `npx tsx examples/example-embeddings.ts`
 
-**Common embedding models:**
-
-- `text-embedding-ada-002` - OpenAI Ada v2 (cost-effective)
-- `text-embedding-3-small` - OpenAI v3 small (balanced)
-- `text-embedding-3-large` - OpenAI v3 large (highest quality)
-
-> **Note:** Model availability depends on your SAP AI Core tenant configuration.
+> **Note:** Embedding model availability depends on your SAP AI Core tenant
+> configuration. Common providers include OpenAI, Amazon Titan, and NVIDIA.
 
 For complete embedding API documentation, see
 **[API Reference: Embeddings](./API_REFERENCE.md#embeddings)**.
 
 ## Supported Models
 
-This provider supports all models available through SAP AI Core, including:
-
-**Popular models:**
-
-- **OpenAI**: gpt-4o, gpt-4o-mini, gpt-4.1, o1, o3, o4-mini (recommended for
-  multi-tool apps)
-- **Anthropic Claude**: anthropic--claude-3.5-sonnet, anthropic--claude-4-opus
-- **Google Gemini**: gemini-2.5-pro, gemini-2.0-flash
-
-- **Amazon Nova**: amazon--nova-pro, amazon--nova-lite
-- **Open Source**: mistralai--mistral-large-instruct,
-  meta--llama3.1-70b-instruct
+This provider supports all models available through SAP AI Core, including models
+from **OpenAI**, **Anthropic Claude**, **Google Gemini**, **Amazon Nova**,
+**Mistral AI**, **Cohere**, and **SAP** (ABAP, RPT).
 
 > **Note:** Model availability depends on your SAP AI Core tenant configuration,
-> region, and subscription.
-
-**To discover available models in your environment:**
-
-```bash
-curl "https://<AI_API_URL>/v2/lm/deployments" -H "Authorization: Bearer $TOKEN"
-```
+> region, and subscription. Use `provider("model-name")` with any model ID
+> available in your environment.
 
-For complete model details, capabilities comparison, and limitations, see
-**[API Reference: SAPAIModelId](./API_REFERENCE.md#sapaimodelid)**.
+For details on discovering available models, see
+**[API Reference: Supported Models](./API_REFERENCE.md#supported-models)**.
 
 ## Advanced Features
 
@@ -450,7 +431,7 @@ const weatherTool = tool({
 });
 
 const result = await generateText({
-  model: provider("gpt-4o"),
+  model: provider("gpt-4.1"),
   prompt: "What's the weather in Tokyo?",
   tools: { getWeather: weatherTool },
   maxSteps: 3,
@@ -470,7 +451,7 @@ for the complete comparison table.
 
 ```typescript
 const result = await generateText({
-  model: provider("gpt-4o"),
+  model: provider("gpt-4.1"),
   messages: [
     {
       role: "user",
@@ -558,7 +539,7 @@ const provider = createSAPAIProvider({
 });
 
 // Queries are now grounded in your documents
-const model = provider("gpt-4o");
+const model = provider("gpt-4.1");
 ```
 
 **Run it:** `npx tsx examples/example-document-grounding.ts`
@@ -590,7 +571,7 @@ const provider = createSAPAIProvider({
 });
 
 // Model handles German input/output automatically
-const model = provider("gpt-4o");
+const model = provider("gpt-4.1");
 ```
 
 **Run it:** `npx tsx examples/example-translation.ts`
@@ -607,7 +588,7 @@ import { createSAPAIProvider, SAP_AI_PROVIDER_NAME } from "@jerome-benoit/sap-ai
 const provider = createSAPAIProvider();
 
 const result = await generateText({
-  model: provider("gpt-4o"),
+  model: provider("gpt-4.1"),
   prompt: "Explain quantum computing",
   providerOptions: {
     [SAP_AI_PROVIDER_NAME]: {

package/dist/{chunk-PF3ZCJ3H.js → chunk-7VLWN7WJ.js}

@@ -29921,6 +29921,111 @@ var HTTP_STATUS = {
   SERVICE_UNAVAILABLE: 503,
   UNAUTHORIZED: 401
 };
+var ERROR_MATCHERS = [
+  {
+    category: "network",
+    isRetryable: true,
+    keywords: ["econnrefused", "enotfound", "network", "timeout"],
+    statusCode: HTTP_STATUS.SERVICE_UNAVAILABLE
+  },
+  {
+    category: "destination",
+    isRetryable: false,
+    keywords: ["could not resolve destination"],
+    message: (original) => `SAP AI Core destination error: ${original}
+
+Check your destination configuration or provide a valid destinationName.`,
+    statusCode: HTTP_STATUS.BAD_REQUEST
+  },
+  {
+    category: "content filtered",
+    isRetryable: false,
+    keywords: ["filtered by the output filter"],
+    message: (original) => `Content was filtered: ${original}
+
+The model's response was blocked by content safety filters. Try a different prompt.`,
+    statusCode: HTTP_STATUS.BAD_REQUEST
+  },
+  {
+    category: "stream consumption",
+    isRetryable: false,
+    keywords: ["consumed stream"],
+    statusCode: HTTP_STATUS.INTERNAL_ERROR
+  },
+  {
+    category: "streaming",
+    isRetryable: true,
+    keywords: [
+      "iterating over",
+      "parse message into json",
+      "received from",
+      "no body",
+      "invalid sse payload"
+    ],
+    statusCode: HTTP_STATUS.INTERNAL_ERROR
+  },
+  {
+    category: "configuration",
+    isRetryable: false,
+    keywords: [
+      "prompt template or messages must be defined",
+      "filtering parameters cannot be empty",
+      "templating yaml string must be non-empty",
+      "could not access response data",
+      "could not parse json",
+      "error parsing yaml",
+      "yaml does not conform",
+      "validation errors"
+    ],
+    statusCode: HTTP_STATUS.BAD_REQUEST
+  },
+  {
+    category: "environment",
+    isRetryable: false,
+    keywords: ["buffer is not available as globals"],
+    statusCode: HTTP_STATUS.INTERNAL_ERROR
+  },
+  {
+    category: "response stream",
+    isRetryable: false,
+    keywords: ["response stream is undefined"],
+    statusCode: HTTP_STATUS.INTERNAL_ERROR
+  },
+  {
+    category: "response processing",
+    isRetryable: true,
+    keywords: [
+      "response is required to process",
+      "stream is still open",
+      "data is not available yet"
+    ],
+    statusCode: HTTP_STATUS.INTERNAL_ERROR
+  },
+  {
+    category: "deployment retrieval",
+    isRetryable: true,
+    keywords: ["failed to fetch the list of deployments"],
+    statusCode: HTTP_STATUS.SERVICE_UNAVAILABLE
+  },
+  {
+    category: "stream buffer",
+    isRetryable: false,
+    keywords: ["received non-uint8array"],
+    statusCode: HTTP_STATUS.INTERNAL_ERROR
+  }
+];
+var AUTHENTICATION_ERROR_KEYWORDS = [
+  "authentication",
+  "unauthorized",
+  "aicore_service_key",
+  "invalid credentials",
+  "service credentials",
+  "service binding"
+];
+var DEPLOYMENT_ERROR_KEYWORDS = [
+  "failed to resolve deployment",
+  "no deployment matched"
+];
 var ApiSwitchError = class extends Error {
   /**
    * Creates a new ApiSwitchError.
@@ -30058,7 +30163,7 @@ function convertToAISDKError(error, context) {
   if (rootError instanceof Error) {
     const errorMsg = rootError.message.toLowerCase();
     const originalErrorMsg = rootError.message;
-    if (errorMsg.includes("authentication") || errorMsg.includes("unauthorized") || errorMsg.includes("aicore_service_key") || errorMsg.includes("invalid credentials") || errorMsg.includes("service credentials") || errorMsg.includes("service binding")) {
+    if (AUTHENTICATION_ERROR_KEYWORDS.some((keyword) => errorMsg.includes(keyword))) {
       return new LoadAPIKeyError({
         message: `SAP AI Core authentication failed: ${originalErrorMsg}
 
@@ -30066,31 +30171,7 @@ Make sure your AICORE_SERVICE_KEY environment variable is set correctly.
 See: https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/create-service-key`
       });
     }
-    if (errorMsg.includes("econnrefused") || errorMsg.includes("enotfound") || errorMsg.includes("network") || errorMsg.includes("timeout")) {
-      return createAPICallError(
-        error,
-        {
-          isRetryable: true,
-          message: `Network error connecting to SAP AI Core: ${originalErrorMsg}`,
-          statusCode: HTTP_STATUS.SERVICE_UNAVAILABLE
-        },
-        context
-      );
-    }
-    if (errorMsg.includes("could not resolve destination")) {
-      return createAPICallError(
-        error,
-        {
-          isRetryable: false,
-          message: `SAP AI Core destination error: ${originalErrorMsg}
-
-Check your destination configuration or provide a valid destinationName.`,
-          statusCode: HTTP_STATUS.BAD_REQUEST
-        },
-        context
-      );
-    }
-    if (errorMsg.includes("failed to resolve deployment") || errorMsg.includes("no deployment matched")) {
+    if (DEPLOYMENT_ERROR_KEYWORDS.some((keyword) => errorMsg.includes(keyword))) {
       const modelId = extractModelIdentifier(originalErrorMsg);
       return new NoSuchModelError({
         message: `SAP AI Core deployment error: ${originalErrorMsg}
@@ -30101,19 +30182,6 @@ See: https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/create-depl
         modelType: "languageModel"
       });
     }
-    if (errorMsg.includes("filtered by the output filter")) {
-      return createAPICallError(
-        error,
-        {
-          isRetryable: false,
-          message: `Content was filtered: ${originalErrorMsg}
-
-The model's response was blocked by content safety filters. Try a different prompt.`,
-          statusCode: HTTP_STATUS.BAD_REQUEST
-        },
-        context
-      );
-    }
     const statusMatch = /status code (\d+)/i.exec(originalErrorMsg);
     if (statusMatch?.[1]) {
       const extractedStatus = Number.parseInt(statusMatch[1], 10);
@@ -30127,93 +30195,19 @@ The model's response was blocked by content safety filters. Try a different prom
         context
       );
     }
-    if (errorMsg.includes("consumed stream")) {
-      return createAPICallError(
-        error,
-        {
-          isRetryable: false,
-          message: `SAP AI Core stream consumption error: ${originalErrorMsg}`,
-          statusCode: HTTP_STATUS.INTERNAL_ERROR
-        },
-        context
-      );
-    }
-    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 createAPICallError(
-        error,
-        {
-          isRetryable: true,
-          message: `SAP AI Core streaming error: ${originalErrorMsg}`,
-          statusCode: HTTP_STATUS.INTERNAL_ERROR
-        },
-        context
-      );
-    }
-    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 createAPICallError(
-        error,
-        {
-          isRetryable: false,
-          message: `SAP AI Core configuration error: ${originalErrorMsg}`,
-          statusCode: HTTP_STATUS.BAD_REQUEST
-        },
-        context
-      );
-    }
-    if (errorMsg.includes("buffer is not available as globals")) {
-      return createAPICallError(
-        error,
-        {
-          isRetryable: false,
-          message: `SAP AI Core environment error: ${originalErrorMsg}`,
-          statusCode: HTTP_STATUS.INTERNAL_ERROR
-        },
-        context
-      );
-    }
-    if (errorMsg.includes("response stream is undefined")) {
-      return createAPICallError(
-        error,
-        {
-          isRetryable: false,
-          message: `SAP AI Core response stream error: ${originalErrorMsg}`,
-          statusCode: HTTP_STATUS.INTERNAL_ERROR
-        },
-        context
-      );
-    }
-    if (errorMsg.includes("response is required to process") || errorMsg.includes("stream is still open") || errorMsg.includes("data is not available yet")) {
-      return createAPICallError(
-        error,
-        {
-          isRetryable: true,
-          message: `SAP AI Core response processing error: ${originalErrorMsg}`,
-          statusCode: HTTP_STATUS.INTERNAL_ERROR
-        },
-        context
-      );
-    }
-    if (errorMsg.includes("failed to fetch the list of deployments")) {
-      return createAPICallError(
-        error,
-        {
-          isRetryable: true,
-          message: `SAP AI Core deployment retrieval error: ${originalErrorMsg}`,
-          statusCode: HTTP_STATUS.SERVICE_UNAVAILABLE
-        },
-        context
-      );
-    }
-    if (errorMsg.includes("received non-uint8array")) {
-      return createAPICallError(
-        error,
-        {
-          isRetryable: false,
-          message: `SAP AI Core stream buffer error: ${originalErrorMsg}`,
-          statusCode: HTTP_STATUS.INTERNAL_ERROR
-        },
-        context
-      );
+    for (const matcher of ERROR_MATCHERS) {
+      if (matcher.keywords.some((keyword) => errorMsg.includes(keyword))) {
+        const message2 = "message" in matcher ? matcher.message(originalErrorMsg) : `SAP AI Core ${matcher.category} error: ${originalErrorMsg}`;
+        return createAPICallError(
+          error,
+          {
+            isRetryable: matcher.isRetryable,
+            message: message2,
+            statusCode: matcher.statusCode
+          },
+          context
+        );
+      }
     }
   }
   const message = rootError instanceof Error ? rootError.message : typeof rootError === "string" ? rootError : "Unknown error occurred";
@@ -30381,7 +30375,7 @@ function tryExtractSAPErrorFromMessage(message) {
 }
 
 // src/version.ts
-var VERSION = true ? "4.4.8" : "0.0.0-test";
+var VERSION = true ? "4.4.9" : "0.0.0-test";
 
 export {
   __toESM,
@@ -30434,4 +30428,4 @@ mime-types/index.js:
 axios/dist/node/axios.cjs:
   (*! Axios v1.13.4 Copyright (c) 2026 Matt Zabriskie and contributors *)
 */
-//# sourceMappingURL=chunk-PF3ZCJ3H.js.map
+//# sourceMappingURL=chunk-7VLWN7WJ.js.map