@jerome-benoit/sap-ai-provider 4.6.9 → 4.7.1

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -531,29 +531,15 @@ const dpiConfig = buildDpiMaskingProvider({
 
 ### Content Filtering
 
-```typescript
-import "dotenv/config"; // Load environment variables
-import { buildAzureContentSafetyFilter, createSAPAIProvider } from "@jerome-benoit/sap-ai-provider";
-
-const provider = createSAPAIProvider({
-  defaultSettings: {
-    filtering: {
-      input: {
-        filters: [
-          buildAzureContentSafetyFilter("input", {
-            hate: "ALLOW_SAFE",
-            violence: "ALLOW_SAFE_LOW_MEDIUM",
-          }),
-        ],
-      },
-    },
-  },
-});
-```
+Content filtering is available through the Orchestration API.
 
+**Complete example:**
+[examples/example-content-filtering.ts](./examples/example-content-filtering.ts)\
 **Complete documentation:**
 [API Reference - Content Filtering](./API_REFERENCE.md#buildazurecontentsafetyfiltertype-config)
 
+**Run it:** `npx tsx examples/example-content-filtering.ts`
+
 ### Document Grounding (RAG)
 
 Ground LLM responses in your own documents using vector databases.
@@ -567,24 +553,27 @@ Ground LLM responses in your own documents using vector databases.
 const provider = createSAPAIProvider({
   defaultSettings: {
     grounding: buildDocumentGroundingConfig({
-      filters: [
-        {
-          id: "vector-store-1", // Your vector database ID
-          data_repositories: ["*"], // Search all repositories
-        },
-      ],
-      placeholders: {
-        input: ["?question"],
-        output: "groundingOutput",
-      },
+      filters: [{ id: "vector-store-1", data_repositories: ["*"] }],
+      placeholders: { input: ["groundingRequest"], output: "groundingOutput" },
     }),
   },
 });
 
-// Queries are now grounded in your documents
-const model = provider("gpt-4.1");
+const result = await generateText({
+  model: provider("gpt-4.1"),
+  prompt: "Question: {{?groundingRequest}}\nContext: {{?groundingOutput}}",
+  providerOptions: {
+    "sap-ai": {
+      escapeTemplatePlaceholders: false,
+      placeholderValues: { groundingRequest: "What is SAP?" },
+    },
+  },
+});
 ```
 
+Set `escapeTemplatePlaceholders` to `false` only when intentionally sending SAP
+or Jinja placeholders in prompts or messages.
+
 **Run it:** `npx tsx examples/example-document-grounding.ts`
 
 ### Translation
@@ -736,6 +725,7 @@ features:
 | `example-streaming-chat.ts`         | Streaming responses         | Real-time text generation, SSE          |
 | `example-image-recognition.ts`      | Multi-modal with images     | Vision models, image analysis           |
 | `example-data-masking.ts`           | Data privacy integration    | DPI masking, anonymization              |
+| `example-content-filtering.ts`      | Content filtering           | Azure Content Safety, orchestration     |
 | `example-document-grounding.ts`     | Document grounding (RAG)    | Vector store, retrieval-augmented gen   |
 | `example-translation.ts`            | Input/output translation    | Multi-language support, SAP translation |
 | `example-embeddings.ts`             | Text embeddings             | Vector generation, semantic similarity  |
@@ -847,4 +837,4 @@ for details.
 
 ## License
 
-Apache License 2.0 - see [LICENSE](./LICENSE.md) for details.
+Apache License 2.0 - see [LICENSE](./LICENSE) for details.

package/dist/{chunk-EXOXZ5OU.js → chunk-4JIMBRMV.js}

@@ -17,6 +17,9 @@ function safeJsonStringify(value) {
     return String(value);
   }
 }
+function wrapAsTextContent(text, cacheControl) {
+  return cacheControl ? { cache_control: cacheControl, text, type: "text" } : { text, type: "text" };
+}
 var JINJA2_DELIMITERS_PATTERN = /\{(?=[{%#])/g;
 var JINJA2_DELIMITERS_ESCAPED_PATTERN = new RegExp(`\\{${ZERO_WIDTH_SPACE}([{%#])`, "g");
 function convertToSAPMessages(prompt, options = {}) {
@@ -24,24 +27,47 @@ function convertToSAPMessages(prompt, options = {}) {
   const includeReasoning = options.includeReasoning ?? false;
   const escapeTemplatePlaceholders = options.escapeTemplatePlaceholders ?? true;
   const maybeEscape = (text) => escapeTemplatePlaceholders ? escapeOrchestrationPlaceholders(text) : text;
+  const parser = options.parsePartProviderOptions;
+  const parsePart = parser ? (providerOptions) => parser(providerOptions, options.warnings) : () => void 0;
   for (const message of prompt) {
     switch (message.role) {
       case "assistant": {
         let text = "";
+        const textParts = [];
+        let anyCacheControl = false;
         const toolCalls = [];
         for (const part of message.content) {
           switch (part.type) {
             case "reasoning": {
               if (includeReasoning && part.text) {
-                text += `<think>${maybeEscape(part.text)}</think>`;
+                const escaped = `<think>${maybeEscape(part.text)}</think>`;
+                text += escaped;
+                textParts.push({ text: escaped });
               }
               break;
             }
             case "text": {
-              text += maybeEscape(part.text);
+              const escaped = maybeEscape(part.text);
+              if (!escaped) break;
+              const partOpts = parsePart(part.providerOptions);
+              const cacheControl = partOpts?.cacheControl;
+              text += escaped;
+              textParts.push(cacheControl ? { cacheControl, text: escaped } : { text: escaped });
+              if (cacheControl) anyCacheControl = true;
               break;
             }
             case "tool-call": {
+              const partOpts = parsePart(part.providerOptions);
+              if (partOpts?.cacheControl && options.warnings) {
+                const feature = "cacheControl on assistant tool-call";
+                if (!options.warnings.some((w) => w.feature === feature)) {
+                  options.warnings.push({
+                    details: "SAP orchestration does not expose cache_control on the assistant tool-call envelope.",
+                    feature,
+                    type: "unsupported"
+                  });
+                }
+              }
               let argumentsJson;
               if (typeof part.input === "string") {
                 argumentsJson = part.input;
@@ -62,7 +88,7 @@ function convertToSAPMessages(prompt, options = {}) {
         }
         if (text || toolCalls.length > 0) {
           const assistantMessage = {
-            content: text,
+            content: anyCacheControl ? textParts.map((p) => wrapAsTextContent(p.text, p.cacheControl)) : text,
             role: "assistant",
             tool_calls: toolCalls.length > 0 ? toolCalls : void 0
           };
@@ -71,8 +97,11 @@ function convertToSAPMessages(prompt, options = {}) {
         break;
       }
       case "system": {
+        const partOpts = parsePart(message.providerOptions);
+        const cacheControl = partOpts?.cacheControl;
+        const text = maybeEscape(message.content);
         const systemMessage = {
-          content: maybeEscape(message.content),
+          content: cacheControl ? [wrapAsTextContent(text, cacheControl)] : text,
           role: "system"
         };
         messages.push(systemMessage);
@@ -81,9 +110,12 @@ function convertToSAPMessages(prompt, options = {}) {
       case "tool": {
         for (const part of message.content) {
           if (part.type === "tool-result") {
+            const partOpts = parsePart(part.providerOptions);
+            const cacheControl = partOpts?.cacheControl;
             const serializedOutput = safeJsonStringify(part.output);
+            const escaped = maybeEscape(serializedOutput);
             const toolMessage = {
-              content: maybeEscape(serializedOutput),
+              content: cacheControl ? [wrapAsTextContent(escaped, cacheControl)] : escaped,
               role: "tool",
               tool_call_id: part.toolCallId
             };
@@ -95,6 +127,8 @@ function convertToSAPMessages(prompt, options = {}) {
       case "user": {
         const contentParts = [];
         for (const part of message.content) {
+          const partOpts = parsePart(part.providerOptions);
+          const cacheControl = partOpts?.cacheControl;
           switch (part.type) {
             case "file": {
               const fileDataUrl = buildDataUrl(part);
@@ -112,6 +146,7 @@ function convertToSAPMessages(prompt, options = {}) {
                   );
                 }
                 contentParts.push({
+                  ...cacheControl ? { cache_control: cacheControl } : {},
                   image_url: {
                     url: fileDataUrl
                   },
@@ -119,6 +154,7 @@ function convertToSAPMessages(prompt, options = {}) {
                 });
               } else {
                 contentParts.push({
+                  ...cacheControl ? { cache_control: cacheControl } : {},
                   file: {
                     file_data: fileDataUrl,
                     ...part.filename ? { filename: part.filename } : {}
@@ -130,6 +166,7 @@ function convertToSAPMessages(prompt, options = {}) {
             }
             case "text": {
               contentParts.push({
+                ...cacheControl ? { cache_control: cacheControl } : {},
                 text: maybeEscape(part.text),
                 type: "text"
               });
@@ -143,7 +180,7 @@ function convertToSAPMessages(prompt, options = {}) {
           }
         }
         const firstPart = contentParts[0];
-        const userMessage = contentParts.length === 1 && firstPart?.type === "text" ? {
+        const userMessage = contentParts.length === 1 && firstPart?.type === "text" && firstPart.cache_control === void 0 ? {
           content: firstPart.text ?? "",
           role: "user"
         } : {
@@ -202,4 +239,4 @@ export {
   escapeOrchestrationPlaceholders,
   unescapeOrchestrationPlaceholders
 };
-//# sourceMappingURL=chunk-EXOXZ5OU.js.map
+//# sourceMappingURL=chunk-4JIMBRMV.js.map

package/dist/chunk-4JIMBRMV.js.map

@@ -0,0 +1 @@
+{"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  type SharedV3Warning,\n  UnsupportedFunctionalityError,\n} from \"@ai-sdk/provider\";\nimport { Buffer } from \"node:buffer\";\n\nimport type { CacheControl, ParsePartProviderOptions } from \"./sap-ai-provider-options.js\";\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   * Optional callback that reads per-part `providerOptions['sap-ai']` (e.g. Anthropic\n   * `cacheControl`) and forwards the result onto the SAP message item. Strategies that\n   * do not honour part-level directives (Foundation Models) leave this undefined.\n   * @default undefined\n   */\n  readonly parsePartProviderOptions?: ParsePartProviderOptions;\n  /**\n   * Optional sink for validation warnings raised by `parsePartProviderOptions`.\n   * Each invalid `cacheControl` directive (or other future per-part option)\n   * surfaces here so the strategy layer can forward the warning to the AI SDK\n   * call result rather than dropping it silently.\n   */\n  readonly warnings?: SharedV3Warning[];\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 * Wraps a text payload as a SAP `TextContent` block, attaching `cache_control` when set.\n * @param text - Pre-escaped text payload.\n * @param cacheControl - Optional Anthropic prompt-cache directive.\n * @returns SAP `TextContent` block.\n */\nfunction wrapAsTextContent(\n  text: string,\n  cacheControl: CacheControl | undefined,\n): { cache_control?: CacheControl; text: string; type: \"text\" } {\n  return cacheControl\n    ? { cache_control: cacheControl, text, type: \"text\" }\n    : { text, type: \"text\" };\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 cache_control?: { ttl?: \"1h\" | \"5m\"; type: \"ephemeral\" };\n  readonly file?: {\n    readonly file_data: string;\n    readonly filename?: 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 * @param options.parsePartProviderOptions - Optional callback to read per-part `providerOptions['sap-ai']`. Strategies opt in to honour part-level directives such as Anthropic `cacheControl`.\n * @param options.warnings - Optional sink the parser pushes Zod validation issues into.\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  const parser = options.parsePartProviderOptions;\n  const parsePart = parser\n    ? (providerOptions: unknown) => parser(providerOptions, options.warnings)\n    : () => undefined;\n\n  for (const message of prompt) {\n    switch (message.role) {\n      case \"assistant\": {\n        let text = \"\";\n        const textParts: {\n          cacheControl?: { ttl?: \"1h\" | \"5m\"; type: \"ephemeral\" };\n          text: string;\n        }[] = [];\n        let anyCacheControl = false;\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                const escaped = `<think>${maybeEscape(part.text)}</think>`;\n                text += escaped;\n                textParts.push({ text: escaped });\n              }\n              break;\n            }\n            case \"text\": {\n              const escaped = maybeEscape(part.text);\n              if (!escaped) break;\n              const partOpts = parsePart(part.providerOptions);\n              const cacheControl = partOpts?.cacheControl;\n              text += escaped;\n              textParts.push(cacheControl ? { cacheControl, text: escaped } : { text: escaped });\n              if (cacheControl) anyCacheControl = true;\n              break;\n            }\n            case \"tool-call\": {\n              const partOpts = parsePart(part.providerOptions);\n              if (partOpts?.cacheControl && options.warnings) {\n                const feature = \"cacheControl on assistant tool-call\";\n                if (\n                  !options.warnings.some((w) => (w as { feature?: string }).feature === feature)\n                ) {\n                  options.warnings.push({\n                    details:\n                      \"SAP orchestration does not expose cache_control on the assistant tool-call envelope.\",\n                    feature,\n                    type: \"unsupported\",\n                  });\n                }\n              }\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: anyCacheControl\n              ? textParts.map((p) => wrapAsTextContent(p.text, p.cacheControl))\n              : 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 partOpts = parsePart(message.providerOptions);\n        const cacheControl = partOpts?.cacheControl;\n        const text = maybeEscape(message.content);\n        const systemMessage: SystemChatMessage = {\n          content: cacheControl ? [wrapAsTextContent(text, cacheControl)] : text,\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 partOpts = parsePart(part.providerOptions);\n            const cacheControl = partOpts?.cacheControl;\n            const serializedOutput = safeJsonStringify(part.output);\n            const escaped = maybeEscape(serializedOutput);\n            const toolMessage: ToolChatMessage = {\n              content: cacheControl ? [wrapAsTextContent(escaped, cacheControl)] : escaped,\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          const partOpts = parsePart(part.providerOptions);\n          const cacheControl = partOpts?.cacheControl;\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                  ...(cacheControl ? { cache_control: cacheControl } : {}),\n                  image_url: {\n                    url: fileDataUrl,\n                  },\n                  type: \"image_url\",\n                });\n              } else {\n                contentParts.push({\n                  ...(cacheControl ? { cache_control: cacheControl } : {}),\n                  file: {\n                    file_data: fileDataUrl,\n                    ...(part.filename ? { filename: part.filename } : {}),\n                  },\n                  type: \"file\",\n                });\n              }\n              break;\n            }\n            case \"text\": {\n              contentParts.push({\n                ...(cacheControl ? { cache_control: cacheControl } : {}),\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 &&\n          firstPart?.type === \"text\" &&\n          firstPart.cache_control === undefined\n            ? {\n                content: firstPart.text ?? \"\",\n                role: \"user\",\n              }\n            : {\n                content: contentParts,\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":"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","names":[]}