@jerome-benoit/sap-ai-provider-v2 4.6.1 → 4.6.3

package/dist/{orchestration-language-model-strategy-FI5HLHWP.js → orchestration-language-model-strategy-TSZQCLG3.js}

@@ -1,24 +1,24 @@
 import {createRequire as __createRequire} from 'module';var require=__createRequire(import.meta.url);
 import {
   BaseLanguageModelStrategy
-} from "./chunk-IAXILSPQ.js";
+} from "./chunk-RHZV73MM.js";
 import {
   convertToSAPMessages
-} from "./chunk-DQXZH6CW.js";
+} from "./chunk-IIBSUXGT.js";
 import {
   buildModelParams,
   convertResponseFormat,
   convertToolsToSAPFormat,
   hasKeys,
   mapToolChoice
-} from "./chunk-U2HDUNO7.js";
+} from "./chunk-WLW2XIIX.js";
 import {
   deepMerge,
   getProviderName,
   normalizeHeaders,
   orchestrationConfigRefSchema,
   sapAILanguageModelProviderOptions
-} from "./chunk-I5ZTK7M5.js";
+} from "./chunk-7ZKPZONG.js";
 
 // src/orchestration-language-model-strategy.ts
 import { parseProviderOptions } from "@ai-sdk/provider-utils";
@@ -505,4 +505,4 @@ var OrchestrationLanguageModelStrategy = class extends BaseLanguageModelStrategy
 export {
   OrchestrationLanguageModelStrategy
 };
-//# sourceMappingURL=orchestration-language-model-strategy-FI5HLHWP.js.map
+//# sourceMappingURL=orchestration-language-model-strategy-TSZQCLG3.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jerome-benoit/sap-ai-provider-v2",
-  "version": "4.6.1",
+  "version": "4.6.3",
   "type": "module",
   "description": "SAP AI Provider for Vercel AI SDK (LanguageModelV2/EmbeddingModelV2 interfaces)",
   "keywords": [
@@ -33,7 +33,7 @@
   "license": "Apache-2.0",
   "author": "jerome-benoit",
   "volta": {
-    "node": "24.14.0"
+    "node": "24.14.1"
   },
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -92,10 +92,10 @@
     "@edge-runtime/vm": "^5.0.0",
     "@eslint/js": "^10.0.1",
     "@types/node": "^25.5.0",
-    "@vitest/coverage-v8": "^4.1.0",
+    "@vitest/coverage-v8": "^4.1.2",
     "dotenv": "^17.3.1",
     "eslint": "^10.1.0",
-    "eslint-plugin-jsdoc": "^62.8.0",
+    "eslint-plugin-jsdoc": "^62.8.1",
     "eslint-plugin-perfectionist": "^5.7.0",
     "globals": "^17.4.0",
     "markdown-link-check": "^3.14.2",
@@ -105,8 +105,8 @@
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.57.1",
-    "vitest": "^4.1.0"
+    "typescript-eslint": "^8.57.2",
+    "vitest": "^4.1.2"
   },
   "peerDependencies": {
     "ai": "^5.0.0 || ^6.0.0"

package/dist/chunk-DQXZH6CW.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/convert-to-sap-messages.ts"],"sourcesContent":["import type {\n  AssistantChatMessage,\n  ChatMessage,\n  SystemChatMessage,\n  ToolChatMessage,\n  UserChatMessage,\n} from \"@sap-ai-sdk/orchestration\";\n\nimport {\n  InvalidPromptError,\n  LanguageModelV3Prompt,\n  UnsupportedFunctionalityError,\n} from \"@ai-sdk/provider\";\nimport { Buffer } from \"node:buffer\";\n\n/**\n * Options for converting Vercel AI SDK prompts to SAP AI SDK messages.\n * @see {@link convertToSAPMessages}\n */\nexport interface ConvertToSAPMessagesOptions {\n  /**\n   * Whether to escape Jinja2 template delimiters (`{{`, `{%`, `{#`) in message content.\n   * This prevents SAP orchestration from interpreting user content as template syntax.\n   * @default true\n   */\n  readonly escapeTemplatePlaceholders?: boolean;\n  /**\n   * Whether to include assistant reasoning parts (wrapped in `<think>` tags).\n   * @default false\n   */\n  readonly includeReasoning?: boolean;\n}\n\n/**\n * @internal\n */\nconst ZERO_WIDTH_SPACE = \"\\u200B\";\n\n/**\n * Safely serializes a value to JSON string, handling edge cases that would cause JSON.stringify to throw.\n *\n * Handles:\n * - Circular references (objects that reference themselves)\n * - BigInt values (converted to string representation)\n * - Undefined values and symbols (handled by JSON.stringify's default behavior)\n * @param value - The value to serialize.\n * @returns JSON string representation, or a fallback string representation if serialization fails.\n * @internal\n */\nfunction safeJsonStringify(value: unknown): string {\n  try {\n    return JSON.stringify(value, (_key, val) =>\n      typeof val === \"bigint\" ? val.toString() : (val as unknown),\n    );\n  } catch {\n    return String(value);\n  }\n}\n\n/**\n * @internal\n */\nconst JINJA2_DELIMITERS_PATTERN = /\\{(?=[{%#])/g;\n\n/**\n * @internal\n */\nconst JINJA2_DELIMITERS_ESCAPED_PATTERN = new RegExp(`\\\\{${ZERO_WIDTH_SPACE}([{%#])`, \"g\");\n\n/**\n * @internal\n */\ninterface UserContentItem {\n  readonly file?: {\n    readonly file_data: string;\n  };\n  readonly image_url?: {\n    readonly url: string;\n  };\n  readonly text?: string;\n  readonly type: \"file\" | \"image_url\" | \"text\";\n}\n\n/**\n * Converts Vercel AI SDK prompt to SAP AI SDK ChatMessage array.\n *\n * Handles all Vercel AI SDK message types:\n * - `system` → `SystemChatMessage`\n * - `user` (text/images) → `UserChatMessage`\n * - `assistant` (text/tool-calls) → `AssistantChatMessage`\n * - `tool` (tool results) → `ToolChatMessage`\n * @param prompt - The Vercel AI SDK LanguageModelV3Prompt to convert.\n * @param options - Conversion options.\n * @param options.escapeTemplatePlaceholders - Whether to escape Jinja2 template delimiters (default: true).\n * @param options.includeReasoning - Whether to include assistant reasoning parts (default: false).\n * @returns SAP AI SDK ChatMessage array ready for orchestration requests.\n * @throws {UnsupportedFunctionalityError} When encountering unsupported content types or file formats.\n * @throws {InvalidPromptError} When encountering unsupported message roles.\n */\nexport function convertToSAPMessages(\n  prompt: LanguageModelV3Prompt,\n  options: ConvertToSAPMessagesOptions = {},\n): ChatMessage[] {\n  const messages: ChatMessage[] = [];\n  const includeReasoning = options.includeReasoning ?? false;\n  const escapeTemplatePlaceholders = options.escapeTemplatePlaceholders ?? true;\n\n  const maybeEscape = (text: string): string =>\n    escapeTemplatePlaceholders ? escapeOrchestrationPlaceholders(text) : text;\n\n  for (const message of prompt) {\n    switch (message.role) {\n      case \"assistant\": {\n        let text = \"\";\n        const toolCalls: {\n          function: { arguments: string; name: string };\n          id: string;\n          type: \"function\";\n        }[] = [];\n\n        for (const part of message.content) {\n          switch (part.type) {\n            case \"reasoning\": {\n              if (includeReasoning && part.text) {\n                text += `<think>${maybeEscape(part.text)}</think>`;\n              }\n              break;\n            }\n            case \"text\": {\n              text += maybeEscape(part.text);\n              break;\n            }\n            case \"tool-call\": {\n              // Normalize tool call input to JSON string (Vercel AI SDK provides strings or objects)\n              let argumentsJson: string;\n              if (typeof part.input === \"string\") {\n                argumentsJson = part.input;\n              } else {\n                argumentsJson = JSON.stringify(part.input);\n              }\n\n              // Escape tool call arguments if needed (they may contain placeholder syntax)\n              toolCalls.push({\n                function: {\n                  arguments: maybeEscape(argumentsJson),\n                  name: part.toolName,\n                },\n                id: part.toolCallId,\n                type: \"function\",\n              });\n              break;\n            }\n          }\n        }\n\n        if (text || toolCalls.length > 0) {\n          const assistantMessage: AssistantChatMessage = {\n            content: text,\n            role: \"assistant\",\n            tool_calls: toolCalls.length > 0 ? toolCalls : undefined,\n          };\n          messages.push(assistantMessage);\n        }\n        break;\n      }\n\n      case \"system\": {\n        const systemMessage: SystemChatMessage = {\n          content: maybeEscape(message.content),\n          role: \"system\",\n        };\n        messages.push(systemMessage);\n        break;\n      }\n\n      case \"tool\": {\n        for (const part of message.content) {\n          if (part.type === \"tool-result\") {\n            const serializedOutput = safeJsonStringify(part.output);\n            const toolMessage: ToolChatMessage = {\n              content: maybeEscape(serializedOutput),\n              role: \"tool\",\n              tool_call_id: part.toolCallId,\n            };\n            messages.push(toolMessage);\n          }\n        }\n        break;\n      }\n\n      case \"user\": {\n        const contentParts: UserContentItem[] = [];\n\n        for (const part of message.content) {\n          switch (part.type) {\n            case \"file\": {\n              const fileDataUrl = buildDataUrl(part);\n\n              if (part.mediaType.startsWith(\"image/\")) {\n                const supportedFormats = [\n                  \"image/png\",\n                  \"image/jpeg\",\n                  \"image/jpg\",\n                  \"image/gif\",\n                  \"image/webp\",\n                ];\n                if (!supportedFormats.includes(part.mediaType.toLowerCase())) {\n                  console.warn(\n                    `Image format ${part.mediaType} may not be supported by all models. ` +\n                      `Recommended formats: PNG, JPEG, GIF, WebP`,\n                  );\n                }\n\n                contentParts.push({\n                  image_url: {\n                    url: fileDataUrl,\n                  },\n                  type: \"image_url\",\n                });\n              } else {\n                contentParts.push({\n                  file: {\n                    file_data: fileDataUrl,\n                  },\n                  type: \"file\",\n                });\n              }\n              break;\n            }\n            case \"text\": {\n              contentParts.push({\n                text: maybeEscape(part.text),\n                type: \"text\",\n              });\n              break;\n            }\n            default: {\n              throw new UnsupportedFunctionalityError({\n                functionality: `Content type ${(part as { type: string }).type}`,\n              });\n            }\n          }\n        }\n\n        const firstPart = contentParts[0];\n        const userMessage: UserChatMessage =\n          contentParts.length === 1 && firstPart?.type === \"text\"\n            ? {\n                content: firstPart.text ?? \"\",\n                role: \"user\",\n              }\n            : {\n                content: contentParts as UserChatMessage[\"content\"],\n                role: \"user\",\n              };\n\n        messages.push(userMessage);\n        break;\n      }\n\n      default: {\n        const _exhaustiveCheck: never = message;\n        throw new InvalidPromptError({\n          message: `Unsupported role: ${(_exhaustiveCheck as { role: string }).role}`,\n          prompt: JSON.stringify(message),\n        });\n      }\n    }\n  }\n\n  return messages;\n}\n\n/**\n * Escapes Jinja2 template delimiters by inserting zero-width spaces.\n *\n * Converts `{{`, `{%`, `{#` to `{\\u200B{`, `{\\u200B%`, `{\\u200B#` respectively.\n * This prevents SAP orchestration from interpreting user content as template syntax.\n * @param text - The text to escape.\n * @returns The escaped text with zero-width spaces inserted.\n * @see {@link unescapeOrchestrationPlaceholders} for the reverse operation.\n */\nexport function escapeOrchestrationPlaceholders(text: string): string {\n  if (!text) return text;\n  return text.replaceAll(JINJA2_DELIMITERS_PATTERN, `{${ZERO_WIDTH_SPACE}`);\n}\n\n/**\n * Reverses escaping by removing zero-width spaces from template delimiters.\n *\n * Useful for processing model responses that may contain escaped delimiters.\n * @param text - The text to unescape.\n * @returns The unescaped text with zero-width spaces removed.\n * @see {@link escapeOrchestrationPlaceholders} for the escaping operation.\n */\nexport function unescapeOrchestrationPlaceholders(text: string): string {\n  if (!text) return text;\n  return text.replaceAll(JINJA2_DELIMITERS_ESCAPED_PATTERN, \"{$1\");\n}\n\n/**\n * Builds a data URL from a file part's data and media type.\n *\n * Supports URL, base64 string, Uint8Array, Buffer, and buffer-like objects.\n * @internal\n * @param part - The file part containing data and mediaType.\n * @param part.data - The file data as URL, base64 string, or Uint8Array.\n * @param part.mediaType - The MIME type of the file.\n * @returns The data URL string.\n * @throws {UnsupportedFunctionalityError} If the data type is not supported.\n */\nfunction buildDataUrl(part: { data: string | Uint8Array | URL; mediaType: string }): string {\n  if (part.data instanceof URL) {\n    return part.data.toString();\n  }\n\n  if (typeof part.data === \"string\") {\n    return `data:${part.mediaType};base64,${part.data}`;\n  }\n\n  if (part.data instanceof Uint8Array) {\n    const base64Data = Buffer.from(part.data).toString(\"base64\");\n    return `data:${part.mediaType};base64,${base64Data}`;\n  }\n\n  if (Buffer.isBuffer(part.data)) {\n    const base64Data = Buffer.from(part.data).toString(\"base64\");\n    return `data:${part.mediaType};base64,${base64Data}`;\n  }\n\n  const maybeBufferLike = part.data as unknown;\n\n  if (\n    maybeBufferLike !== null &&\n    typeof maybeBufferLike === \"object\" &&\n    \"toString\" in (maybeBufferLike as Record<string, unknown>)\n  ) {\n    const base64Data = (\n      maybeBufferLike as {\n        toString: (encoding?: string) => string;\n      }\n    ).toString(\"base64\");\n    return `data:${part.mediaType};base64,${base64Data}`;\n  }\n\n  throw new UnsupportedFunctionalityError({\n    functionality: \"Unsupported file data type. Expected URL, base64 string, or Uint8Array.\",\n  });\n}\n"],"mappings":";;;AAQA;AAAA,EACE;AAAA,EAEA;AAAA,OACK;AACP,SAAS,cAAc;AAuBvB,IAAM,mBAAmB;AAazB,SAAS,kBAAkB,OAAwB;AACjD,MAAI;AACF,WAAO,KAAK;AAAA,MAAU;AAAA,MAAO,CAAC,MAAM,QAClC,OAAO,QAAQ,WAAW,IAAI,SAAS,IAAK;AAAA,IAC9C;AAAA,EACF,QAAQ;AACN,WAAO,OAAO,KAAK;AAAA,EACrB;AACF;AAKA,IAAM,4BAA4B;AAKlC,IAAM,oCAAoC,IAAI,OAAO,MAAM,gBAAgB,WAAW,GAAG;AAgClF,SAAS,qBACd,QACA,UAAuC,CAAC,GACzB;AACf,QAAM,WAA0B,CAAC;AACjC,QAAM,mBAAmB,QAAQ,oBAAoB;AACrD,QAAM,6BAA6B,QAAQ,8BAA8B;AAEzE,QAAM,cAAc,CAAC,SACnB,6BAA6B,gCAAgC,IAAI,IAAI;AAEvE,aAAW,WAAW,QAAQ;AAC5B,YAAQ,QAAQ,MAAM;AAAA,MACpB,KAAK,aAAa;AAChB,YAAI,OAAO;AACX,cAAM,YAIA,CAAC;AAEP,mBAAW,QAAQ,QAAQ,SAAS;AAClC,kBAAQ,KAAK,MAAM;AAAA,YACjB,KAAK,aAAa;AAChB,kBAAI,oBAAoB,KAAK,MAAM;AACjC,wBAAQ,UAAU,YAAY,KAAK,IAAI,CAAC;AAAA,cAC1C;AACA;AAAA,YACF;AAAA,YACA,KAAK,QAAQ;AACX,sBAAQ,YAAY,KAAK,IAAI;AAC7B;AAAA,YACF;AAAA,YACA,KAAK,aAAa;AAEhB,kBAAI;AACJ,kBAAI,OAAO,KAAK,UAAU,UAAU;AAClC,gCAAgB,KAAK;AAAA,cACvB,OAAO;AACL,gCAAgB,KAAK,UAAU,KAAK,KAAK;AAAA,cAC3C;AAGA,wBAAU,KAAK;AAAA,gBACb,UAAU;AAAA,kBACR,WAAW,YAAY,aAAa;AAAA,kBACpC,MAAM,KAAK;AAAA,gBACb;AAAA,gBACA,IAAI,KAAK;AAAA,gBACT,MAAM;AAAA,cACR,CAAC;AACD;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAEA,YAAI,QAAQ,UAAU,SAAS,GAAG;AAChC,gBAAM,mBAAyC;AAAA,YAC7C,SAAS;AAAA,YACT,MAAM;AAAA,YACN,YAAY,UAAU,SAAS,IAAI,YAAY;AAAA,UACjD;AACA,mBAAS,KAAK,gBAAgB;AAAA,QAChC;AACA;AAAA,MACF;AAAA,MAEA,KAAK,UAAU;AACb,cAAM,gBAAmC;AAAA,UACvC,SAAS,YAAY,QAAQ,OAAO;AAAA,UACpC,MAAM;AAAA,QACR;AACA,iBAAS,KAAK,aAAa;AAC3B;AAAA,MACF;AAAA,MAEA,KAAK,QAAQ;AACX,mBAAW,QAAQ,QAAQ,SAAS;AAClC,cAAI,KAAK,SAAS,eAAe;AAC/B,kBAAM,mBAAmB,kBAAkB,KAAK,MAAM;AACtD,kBAAM,cAA+B;AAAA,cACnC,SAAS,YAAY,gBAAgB;AAAA,cACrC,MAAM;AAAA,cACN,cAAc,KAAK;AAAA,YACrB;AACA,qBAAS,KAAK,WAAW;AAAA,UAC3B;AAAA,QACF;AACA;AAAA,MACF;AAAA,MAEA,KAAK,QAAQ;AACX,cAAM,eAAkC,CAAC;AAEzC,mBAAW,QAAQ,QAAQ,SAAS;AAClC,kBAAQ,KAAK,MAAM;AAAA,YACjB,KAAK,QAAQ;AACX,oBAAM,cAAc,aAAa,IAAI;AAErC,kBAAI,KAAK,UAAU,WAAW,QAAQ,GAAG;AACvC,sBAAM,mBAAmB;AAAA,kBACvB;AAAA,kBACA;AAAA,kBACA;AAAA,kBACA;AAAA,kBACA;AAAA,gBACF;AACA,oBAAI,CAAC,iBAAiB,SAAS,KAAK,UAAU,YAAY,CAAC,GAAG;AAC5D,0BAAQ;AAAA,oBACN,gBAAgB,KAAK,SAAS;AAAA,kBAEhC;AAAA,gBACF;AAEA,6BAAa,KAAK;AAAA,kBAChB,WAAW;AAAA,oBACT,KAAK;AAAA,kBACP;AAAA,kBACA,MAAM;AAAA,gBACR,CAAC;AAAA,cACH,OAAO;AACL,6BAAa,KAAK;AAAA,kBAChB,MAAM;AAAA,oBACJ,WAAW;AAAA,kBACb;AAAA,kBACA,MAAM;AAAA,gBACR,CAAC;AAAA,cACH;AACA;AAAA,YACF;AAAA,YACA,KAAK,QAAQ;AACX,2BAAa,KAAK;AAAA,gBAChB,MAAM,YAAY,KAAK,IAAI;AAAA,gBAC3B,MAAM;AAAA,cACR,CAAC;AACD;AAAA,YACF;AAAA,YACA,SAAS;AACP,oBAAM,IAAI,8BAA8B;AAAA,gBACtC,eAAe,gBAAiB,KAA0B,IAAI;AAAA,cAChE,CAAC;AAAA,YACH;AAAA,UACF;AAAA,QACF;AAEA,cAAM,YAAY,aAAa,CAAC;AAChC,cAAM,cACJ,aAAa,WAAW,KAAK,WAAW,SAAS,SAC7C;AAAA,UACE,SAAS,UAAU,QAAQ;AAAA,UAC3B,MAAM;AAAA,QACR,IACA;AAAA,UACE,SAAS;AAAA,UACT,MAAM;AAAA,QACR;AAEN,iBAAS,KAAK,WAAW;AACzB;AAAA,MACF;AAAA,MAEA,SAAS;AACP,cAAM,mBAA0B;AAChC,cAAM,IAAI,mBAAmB;AAAA,UAC3B,SAAS,qBAAsB,iBAAsC,IAAI;AAAA,UACzE,QAAQ,KAAK,UAAU,OAAO;AAAA,QAChC,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAWO,SAAS,gCAAgC,MAAsB;AACpE,MAAI,CAAC,KAAM,QAAO;AAClB,SAAO,KAAK,WAAW,2BAA2B,IAAI,gBAAgB,EAAE;AAC1E;AAUO,SAAS,kCAAkC,MAAsB;AACtE,MAAI,CAAC,KAAM,QAAO;AAClB,SAAO,KAAK,WAAW,mCAAmC,KAAK;AACjE;AAaA,SAAS,aAAa,MAAsE;AAC1F,MAAI,KAAK,gBAAgB,KAAK;AAC5B,WAAO,KAAK,KAAK,SAAS;AAAA,EAC5B;AAEA,MAAI,OAAO,KAAK,SAAS,UAAU;AACjC,WAAO,QAAQ,KAAK,SAAS,WAAW,KAAK,IAAI;AAAA,EACnD;AAEA,MAAI,KAAK,gBAAgB,YAAY;AACnC,UAAM,aAAa,OAAO,KAAK,KAAK,IAAI,EAAE,SAAS,QAAQ;AAC3D,WAAO,QAAQ,KAAK,SAAS,WAAW,UAAU;AAAA,EACpD;AAEA,MAAI,OAAO,SAAS,KAAK,IAAI,GAAG;AAC9B,UAAM,aAAa,OAAO,KAAK,KAAK,IAAI,EAAE,SAAS,QAAQ;AAC3D,WAAO,QAAQ,KAAK,SAAS,WAAW,UAAU;AAAA,EACpD;AAEA,QAAM,kBAAkB,KAAK;AAE7B,MACE,oBAAoB,QACpB,OAAO,oBAAoB,YAC3B,cAAe,iBACf;AACA,UAAM,aACJ,gBAGA,SAAS,QAAQ;AACnB,WAAO,QAAQ,KAAK,SAAS,WAAW,UAAU;AAAA,EACpD;AAEA,QAAM,IAAI,8BAA8B;AAAA,IACtC,eAAe;AAAA,EACjB,CAAC;AACH;","names":[]}