@jerome-benoit/sap-ai-provider-v2 4.9.0 → 5.0.0

package/dist/{orchestration-language-model-strategy-UE7OQO5K.js → orchestration-language-model-strategy-X4FZNLSA.js}

@@ -1,22 +1,22 @@
 import {createRequire as __createRequire} from 'module';var require=__createRequire(import.meta.url);
 import {
   validateMaskingProvidersDeprecation
-} from "./chunk-4SQ5HC6Y.js";
+} from "./chunk-TXZZURBA.js";
 import {
   BaseLanguageModelStrategy
-} from "./chunk-3KCERYUB.js";
-import "./chunk-4JIMBRMV.js";
+} from "./chunk-WNR7DC4V.js";
+import "./chunk-QDUZRLMI.js";
 import {
   convertResponseFormat,
   convertToolsToSAPFormat,
   hasKeys,
   mergeRequestConfig
-} from "./chunk-33WLQYKB.js";
+} from "./chunk-Q5JV4I6D.js";
 import {
   deepMerge,
   orchestrationConfigRefSchema,
   parseSAPPartProviderOptions
-} from "./chunk-4PLJVJX4.js";
+} from "./chunk-BIBSYTMU.js";
 
 // src/orchestration-language-model-strategy.ts
 function buildTemplateRefObject(ref) {
@@ -72,13 +72,13 @@ var OrchestrationLanguageModelStrategy = class extends BaseLanguageModelStrategy
     super();
     this.ClientClass = ClientClass;
   }
-  buildRequest(config, settings, options, commonParts) {
+  buildRequest(_config, settings, options, commonParts) {
     const warnings = [];
     const { configRef } = commonParts.resolvedState;
     if (configRef) {
-      return this.buildConfigRefRequest(settings, options, commonParts, configRef, warnings);
+      return this.buildConfigRefRequest(settings, options, commonParts, warnings);
     }
-    return this.buildStandardRequest(config, settings, options, commonParts, warnings);
+    return this.buildStandardRequest(settings, commonParts, warnings);
   }
   /**
    * Collects stream-specific warnings for orchestration.
@@ -104,20 +104,17 @@ var OrchestrationLanguageModelStrategy = class extends BaseLanguageModelStrategy
     return warnings;
   }
   createClient(config, settings, commonParts) {
-    const { configRef, promptTemplateRef, tools } = commonParts.resolvedState;
+    const { configRef, promptTemplateRef, responseFormat, tools } = commonParts.resolvedState;
     if (configRef) {
       return new this.ClientClass(configRef, config.deploymentConfig, config.destination);
     }
-    const promptConfig = promptTemplateRef ? this.buildTemplateRefPromptConfig(promptTemplateRef, tools) : this.buildInlineTemplateConfig(tools, void 0);
-    const clientConfig = {
-      promptTemplating: {
-        model: {
-          name: config.modelId,
-          ...settings.modelVersion ? { version: settings.modelVersion } : {}
-        },
-        prompt: promptConfig
-      }
-    };
+    const clientConfig = this.buildOrchestrationModuleConfig(config, settings, {
+      modelParams: commonParts.modelParams,
+      promptTemplateRef,
+      responseFormat,
+      toolChoice: commonParts.toolChoice,
+      tools
+    });
     if (settings.fallbackModuleConfigs && settings.fallbackModuleConfigs.length > 0) {
       const configList = [
         clientConfig,
@@ -195,13 +192,17 @@ var OrchestrationLanguageModelStrategy = class extends BaseLanguageModelStrategy
    * @internal
    */
   resolveAdditionalState(_config, settings, sapOptions, options, warnings) {
-    const configRef = this.resolveConfigRef(sapOptions, settings);
+    const configRef = this.resolveConfigRef(sapOptions, settings, warnings);
     const promptTemplateRef = this.resolvePromptTemplateRef(sapOptions, settings);
+    let responseFormat;
     if (configRef === void 0) {
       validateMaskingProvidersDeprecation(settings, warnings);
+      const converted = convertResponseFormat(options.responseFormat, settings.responseFormat);
+      responseFormat = converted.responseFormat;
+      if (converted.warning) warnings.push(converted.warning);
     }
     const tools = this.resolveTools(settings, options, warnings);
-    return { configRef, promptTemplateRef, tools };
+    return { configRef, promptTemplateRef, responseFormat, tools };
   }
   /**
    * Builds request for orchestrationConfigRef mode.
@@ -211,12 +212,11 @@ var OrchestrationLanguageModelStrategy = class extends BaseLanguageModelStrategy
    * @param settings - Model settings.
    * @param options - Call options.
    * @param commonParts - Common build result.
-   * @param _configRef - The config reference (unused, passed for signature consistency).
    * @param warnings - Warnings array to populate.
    * @returns Request body and warnings.
    * @internal
    */
-  buildConfigRefRequest(settings, options, commonParts, _configRef, warnings) {
+  buildConfigRefRequest(settings, options, commonParts, warnings) {
     warnings.push(
       ...this.collectConfigRefIgnoredWarnings(settings, options, commonParts.sapOptions)
     );
@@ -274,33 +274,6 @@ var OrchestrationLanguageModelStrategy = class extends BaseLanguageModelStrategy
     );
     return moduleConfig;
   }
-  /**
-   * Builds the final request body for the orchestration API.
-   * @param messages - Chat messages.
-   * @param orchestrationConfig - Module configuration.
-   * @param placeholderValues - Optional placeholder values.
-   * @param hasTemplateRef - Whether template_ref mode is active.
-   * @returns Request body.
-   * @internal
-   */
-  buildRequestBody(messages, orchestrationConfig, placeholderValues, hasTemplateRef) {
-    const promptTemplating = orchestrationConfig.promptTemplating;
-    const messagesField = hasTemplateRef ? { messagesHistory: messages } : { messages };
-    const requestBody = {
-      ...messagesField,
-      model: {
-        ...orchestrationConfig.promptTemplating.model
-      },
-      ...placeholderValues ? { placeholderValues } : {},
-      ...promptTemplating.prompt.tools ? { tools: promptTemplating.prompt.tools } : {},
-      ...promptTemplating.prompt.response_format ? { response_format: promptTemplating.prompt.response_format } : {}
-    };
-    copyOrchestrationModules(
-      requestBody,
-      orchestrationConfig
-    );
-    return requestBody;
-  }
   /**
    * Builds SAP SDK stream options from user-facing stream options.
    * @param streamOptions - User-provided stream options.
@@ -328,38 +301,19 @@ var OrchestrationLanguageModelStrategy = class extends BaseLanguageModelStrategy
   }
   /**
    * Builds request for standard (non-configRef) mode.
-   * @param config - Strategy configuration.
    * @param settings - Model settings.
-   * @param options - Call options.
    * @param commonParts - Common build result.
    * @param warnings - Warnings array to populate.
    * @returns Request body and warnings.
    * @internal
    */
-  buildStandardRequest(config, settings, options, commonParts, warnings) {
-    const { promptTemplateRef, tools } = commonParts.resolvedState;
-    const { responseFormat, warning: responseFormatWarning } = convertResponseFormat(
-      options.responseFormat,
-      settings.responseFormat
-    );
-    if (responseFormatWarning) {
-      warnings.push(responseFormatWarning);
-    }
-    const { toolChoice } = commonParts;
-    const orchestrationConfig = this.buildOrchestrationModuleConfig(config, settings, {
-      modelParams: commonParts.modelParams,
-      promptTemplateRef,
-      responseFormat,
-      toolChoice,
-      tools
-    });
+  buildStandardRequest(settings, commonParts, warnings) {
+    const { promptTemplateRef } = commonParts.resolvedState;
     const placeholderValues = resolvePlaceholderValues(settings, commonParts.sapOptions);
-    const request = this.buildRequestBody(
-      commonParts.messages,
-      orchestrationConfig,
-      placeholderValues,
-      Boolean(promptTemplateRef)
-    );
+    const request = {
+      ...promptTemplateRef ? { messagesHistory: commonParts.messages } : { messages: commonParts.messages },
+      ...placeholderValues ? { placeholderValues } : {}
+    };
     return { request, warnings };
   }
   /**
@@ -402,6 +356,15 @@ var OrchestrationLanguageModelStrategy = class extends BaseLanguageModelStrategy
         ignoredSettings.push(`providerOptions.${key}`);
       }
     }
+    const optionValues = options;
+    for (const { optionKey } of this.getParamMappings()) {
+      if (optionKey && optionValues[optionKey] !== void 0) {
+        ignoredSettings.push(`options.${optionKey}`);
+      }
+    }
+    if (options.stopSequences && options.stopSequences.length > 0) {
+      ignoredSettings.push("options.stopSequences");
+    }
     if (options.tools && options.tools.length > 0) {
       ignoredSettings.push("options.tools");
     }
@@ -421,17 +384,26 @@ var OrchestrationLanguageModelStrategy = class extends BaseLanguageModelStrategy
   }
   /**
    * Resolves the orchestrationConfigRef from provider options or settings.
-   * Provider options take priority over settings.
+   * Provider options take priority over settings. A present-but-invalid reference is
+   * ignored with a warning instead of failing the request.
    * @param sapOptions - Parsed provider options from commonParts.
    * @param settings - The model settings.
+   * @param warnings - Shared warnings sink for degradation signals.
    * @returns The resolved config reference or undefined.
    * @internal
    */
-  resolveConfigRef(sapOptions, settings) {
+  resolveConfigRef(sapOptions, settings, warnings) {
     const configRefCandidate = sapOptions?.orchestrationConfigRef ?? settings.orchestrationConfigRef;
-    if (configRefCandidate && isOrchestrationConfigRef(configRefCandidate)) {
+    if (!configRefCandidate) {
+      return void 0;
+    }
+    if (isOrchestrationConfigRef(configRefCandidate)) {
       return configRefCandidate;
     }
+    warnings.push({
+      message: "orchestrationConfigRef is invalid and was ignored; falling back to local module settings.",
+      type: "other"
+    });
     return void 0;
   }
   /**
@@ -487,4 +459,4 @@ var OrchestrationLanguageModelStrategy = class extends BaseLanguageModelStrategy
 export {
   OrchestrationLanguageModelStrategy
 };
-//# sourceMappingURL=orchestration-language-model-strategy-UE7OQO5K.js.map
+//# sourceMappingURL=orchestration-language-model-strategy-X4FZNLSA.js.map

package/dist/orchestration-language-model-strategy-X4FZNLSA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/orchestration-language-model-strategy.ts"],"sourcesContent":["/** Orchestration language model strategy using `@sap-ai-sdk/orchestration`. */\nimport type { LanguageModelV3CallOptions, SharedV3Warning } from \"@ai-sdk/provider\";\nimport type { CustomRequestConfig } from \"@sap-ai-sdk/core\";\nimport type {\n  ChatCompletionRequest,\n  ChatCompletionTool,\n  ChatMessage,\n  OrchestrationClient,\n  OrchestrationModuleConfig,\n  OrchestrationModuleConfigList,\n} from \"@sap-ai-sdk/orchestration\";\n\nimport type { ParsePartProviderOptions } from \"./sap-ai-provider-options.js\";\nimport type {\n  OrchestrationModelSettings,\n  PromptTemplateRef,\n  PromptTemplateRefByID,\n} from \"./sap-ai-settings.js\";\nimport type { LanguageModelStrategyConfig } from \"./sap-ai-strategy.js\";\n\nimport {\n  BaseLanguageModelStrategy,\n  type CommonBuildResult,\n  type StreamCallResponse,\n} from \"./base-language-model-strategy.js\";\nimport { deepMerge } from \"./deep-merge.js\";\nimport {\n  orchestrationConfigRefSchema,\n  parseSAPPartProviderOptions,\n} from \"./sap-ai-provider-options.js\";\nimport { validateMaskingProvidersDeprecation } from \"./sap-ai-validation.js\";\nimport {\n  convertResponseFormat,\n  convertToolsToSAPFormat,\n  hasKeys,\n  mergeRequestConfig,\n  type ParamMapping,\n  type SAPResponseFormat,\n  type SAPToolChoice,\n  type SDKCitation,\n  type SDKResponse,\n  type SDKStreamChunk,\n} from \"./strategy-utils.js\";\n\n/** @internal */\ntype OrchestrationClientInstance = InstanceType<typeof OrchestrationClient>;\n\n/**\n * Typed resolved state for values computed in buildCommonParts and consumed in buildRequest/createClient.\n * @internal\n */\ninterface OrchestrationResolvedState {\n  readonly configRef: OrchestrationModelSettings[\"orchestrationConfigRef\"];\n  readonly promptTemplateRef: PromptTemplateRef | undefined;\n  readonly responseFormat: SAPResponseFormat | undefined;\n  readonly tools: ChatCompletionTool[] | undefined;\n}\n\n/**\n * Builds the template_ref object from a PromptTemplateRef.\n * @param ref - Template reference (by ID or by name/scenario/version).\n * @returns The template_ref object for SDK consumption.\n * @internal\n */\nfunction buildTemplateRefObject(ref: PromptTemplateRef): Record<string, unknown> {\n  return isTemplateRefById(ref)\n    ? {\n        id: ref.id,\n        ...(ref.scope && { scope: ref.scope }),\n      }\n    : {\n        name: ref.name,\n        scenario: ref.scenario,\n        version: ref.version,\n        ...(ref.scope && { scope: ref.scope }),\n      };\n}\n\n/**\n * Type guard for template reference by ID.\n * @param ref - Template reference.\n * @returns True if reference is by ID.\n * @internal\n */\nfunction isTemplateRefById(ref: PromptTemplateRef): ref is PromptTemplateRefByID {\n  return \"id\" in ref;\n}\n\n/**\n * Merges and resolves placeholder values from settings and provider options.\n * @param settings - Model settings containing placeholderValues.\n * @param sapOptions - Provider options containing placeholderValues.\n * @returns Merged placeholder values or undefined if empty.\n * @internal\n */\nfunction resolvePlaceholderValues(\n  settings: OrchestrationModelSettings,\n  sapOptions: Record<string, unknown> | undefined,\n): Record<string, string> | undefined {\n  const merged = deepMerge(\n    settings.placeholderValues as Record<string, unknown> | undefined,\n    sapOptions?.placeholderValues as Record<string, unknown> | undefined,\n  ) as Record<string, string>;\n\n  return hasKeys(merged) ? merged : undefined;\n}\n\n/**\n * Module keys for orchestration configuration.\n * @internal\n */\nconst ORCHESTRATION_MODULE_KEYS = [\"masking\", \"filtering\", \"grounding\", \"translation\"] as const;\n\n/**\n * Module settings that are ignored when using orchestrationConfigRef.\n * @internal\n */\nconst CONFIG_REF_IGNORED_MODULES = [\n  ...ORCHESTRATION_MODULE_KEYS,\n  \"fallbackModuleConfigs\",\n  \"promptTemplateRef\",\n  \"responseFormat\",\n  \"tools\",\n  \"modelParams\",\n  \"modelVersion\",\n] as const;\n\n/**\n * Provider options that are ignored when using orchestrationConfigRef.\n * Subset of CONFIG_REF_IGNORED_MODULES that can be passed via providerOptions.\n * @internal\n */\nconst CONFIG_REF_IGNORED_PROVIDER_OPTIONS = [\"promptTemplateRef\", \"modelParams\"] as const;\n\n/**\n * Copies non-empty orchestration modules from source to target.\n * @param target - Target object to copy modules into.\n * @param source - Source object containing module configurations.\n * @internal\n */\nfunction copyOrchestrationModules(\n  target: Record<string, unknown>,\n  source: Record<string, unknown>,\n): void {\n  for (const key of ORCHESTRATION_MODULE_KEYS) {\n    const value = source[key];\n    if (value && hasKeys(value)) {\n      target[key] = value;\n    }\n  }\n}\n\n/**\n * Checks if a value is a valid orchestration configuration reference.\n * @param value - The value to check.\n * @returns True if the value is a valid orchestration configuration reference.\n * @internal\n */\nfunction isOrchestrationConfigRef(\n  value: unknown,\n): value is NonNullable<OrchestrationModelSettings[\"orchestrationConfigRef\"]> {\n  return orchestrationConfigRefSchema.safeParse(value).success;\n}\n\n/**\n * Orchestration API parameter mappings.\n * @internal\n */\nconst ORCHESTRATION_PARAM_MAPPINGS: readonly ParamMapping[] = [\n  ...BaseLanguageModelStrategy.COMMON_PARAM_MAPPINGS,\n  { camelCaseKey: \"topK\", optionKey: \"topK\", outputKey: \"top_k\" },\n] as const;\n\n/**\n * Language model strategy for the Orchestration API.\n *\n * Provides support for:\n * - Content filtering\n * - Data masking\n * - Document grounding\n * - Translation\n * - Prompt templates\n * - Orchestration config references\n * @internal\n */\nexport class OrchestrationLanguageModelStrategy extends BaseLanguageModelStrategy<\n  OrchestrationClientInstance,\n  ChatCompletionRequest,\n  OrchestrationModelSettings\n> {\n  private readonly ClientClass: typeof OrchestrationClient;\n\n  constructor(ClientClass: typeof OrchestrationClient) {\n    super();\n    this.ClientClass = ClientClass;\n  }\n\n  protected buildRequest(\n    _config: LanguageModelStrategyConfig,\n    settings: OrchestrationModelSettings,\n    options: LanguageModelV3CallOptions,\n    commonParts: CommonBuildResult<ChatMessage[], SAPToolChoice | undefined>,\n  ): { readonly request: ChatCompletionRequest; readonly warnings: SharedV3Warning[] } {\n    const warnings: SharedV3Warning[] = [];\n\n    const { configRef } = commonParts.resolvedState as OrchestrationResolvedState;\n\n    if (configRef) {\n      return this.buildConfigRefRequest(settings, options, commonParts, warnings);\n    }\n\n    return this.buildStandardRequest(settings, commonParts, warnings);\n  }\n\n  /**\n   * Collects stream-specific warnings for orchestration.\n   * @param settings - Model settings.\n   * @param sapOptions - Provider options.\n   * @returns Array of warnings for streaming operations.\n   * @internal\n   */\n  protected override collectStreamWarnings(\n    settings: OrchestrationModelSettings,\n    sapOptions?: Record<string, unknown>,\n  ): SharedV3Warning[] {\n    const warnings: SharedV3Warning[] = [];\n\n    // Skip warning if a valid orchestrationConfigRef is set in settings or providerOptions\n    // (local module settings are ignored when using server-side config)\n    const configRefCandidate =\n      sapOptions?.orchestrationConfigRef ?? settings.orchestrationConfigRef;\n    if (configRefCandidate && isOrchestrationConfigRef(configRefCandidate)) {\n      return warnings;\n    }\n\n    if (settings.translation && hasKeys(settings.translation)) {\n      if (!settings.streamOptions?.delimiters || settings.streamOptions.delimiters.length === 0) {\n        warnings.push({\n          message:\n            \"Translation module is configured but streamOptions.delimiters is not set. \" +\n            \"For proper sentence boundary detection during streaming with translation, \" +\n            \"consider setting delimiters (e.g., ['.', '!', '?', '\\\\n']).\",\n          type: \"other\",\n        });\n      }\n    }\n\n    return warnings;\n  }\n\n  protected createClient(\n    config: LanguageModelStrategyConfig,\n    settings: OrchestrationModelSettings,\n    commonParts: CommonBuildResult<ChatMessage[], SAPToolChoice | undefined>,\n  ): OrchestrationClientInstance {\n    const { configRef, promptTemplateRef, responseFormat, tools } =\n      commonParts.resolvedState as OrchestrationResolvedState;\n\n    if (configRef) {\n      return new this.ClientClass(configRef, config.deploymentConfig, config.destination);\n    }\n\n    const clientConfig = this.buildOrchestrationModuleConfig(config, settings, {\n      modelParams: commonParts.modelParams,\n      promptTemplateRef,\n      responseFormat,\n      toolChoice: commonParts.toolChoice,\n      tools,\n    });\n\n    if (settings.fallbackModuleConfigs && settings.fallbackModuleConfigs.length > 0) {\n      const configList = [\n        clientConfig,\n        ...settings.fallbackModuleConfigs,\n      ] as OrchestrationModuleConfigList;\n      return new this.ClientClass(configList, config.deploymentConfig, config.destination);\n    }\n\n    return new this.ClientClass(clientConfig, config.deploymentConfig, config.destination);\n  }\n\n  protected async executeApiCall(\n    client: OrchestrationClientInstance,\n    request: ChatCompletionRequest,\n    abortSignal: AbortSignal | undefined,\n    requestConfig: CustomRequestConfig | undefined,\n  ): Promise<SDKResponse> {\n    const response = await client.chatCompletion(\n      request,\n      mergeRequestConfig(requestConfig, abortSignal),\n    );\n\n    const { requestId, responseId } = this.extractMetadata(response);\n\n    return {\n      getCitations: () =>\n        (response as { getCitations?: () => SDKCitation[] | undefined }).getCitations?.(),\n      getContent: () => response.getContent(),\n      getFinishReason: () => response.getFinishReason(),\n      getIntermediateFailures: () =>\n        (\n          response as { getIntermediateFailures?: () => undefined | unknown[] }\n        ).getIntermediateFailures?.(),\n      getTokenUsage: () => response.getTokenUsage(),\n      getToolCalls: () => response.getToolCalls(),\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment -- SAP SDK types headers as any\n      rawResponse: { headers: response.rawResponse.headers },\n      requestId,\n      responseId,\n    };\n  }\n\n  protected async executeStreamCall(\n    client: OrchestrationClientInstance,\n    request: ChatCompletionRequest,\n    abortSignal: AbortSignal | undefined,\n    settings: OrchestrationModelSettings,\n    requestConfig: CustomRequestConfig | undefined,\n  ): Promise<StreamCallResponse> {\n    const sdkStreamOptions = this.buildSdkStreamOptions(settings.streamOptions);\n    const streamResponse = await client.stream(\n      request,\n      abortSignal,\n      sdkStreamOptions,\n      mergeRequestConfig(requestConfig, undefined),\n    );\n\n    const { requestId, responseHeaders, responseId } = this.extractMetadata(streamResponse);\n\n    return {\n      getCitations: () =>\n        (streamResponse as { getCitations?: () => SDKCitation[] | undefined }).getCitations?.(),\n      getFinishReason: () => streamResponse.getFinishReason(),\n      getIntermediateFailures: () =>\n        (\n          streamResponse as { getIntermediateFailures?: () => undefined | unknown[] }\n        ).getIntermediateFailures?.(),\n      getTokenUsage: () => streamResponse.getTokenUsage(),\n      requestId,\n      responseHeaders,\n      responseId,\n      stream: streamResponse.stream as AsyncIterable<SDKStreamChunk>,\n    };\n  }\n\n  protected getCompletionIdPath(): readonly string[] {\n    return [\"final_result\", \"id\"];\n  }\n\n  protected getEscapeTemplatePlaceholders(\n    sapOptions: Record<string, unknown> | undefined,\n    settings: OrchestrationModelSettings,\n  ): boolean {\n    return (\n      (sapOptions?.escapeTemplatePlaceholders as boolean | undefined) ??\n      settings.escapeTemplatePlaceholders ??\n      true\n    );\n  }\n\n  protected getParamMappings(): readonly ParamMapping[] {\n    return ORCHESTRATION_PARAM_MAPPINGS;\n  }\n\n  protected override getPartProviderOptionsParser(): ParsePartProviderOptions | undefined {\n    return parseSAPPartProviderOptions;\n  }\n\n  protected getUrl(): string {\n    return \"sap-ai:orchestration\";\n  }\n\n  /**\n   * Resolves orchestration-specific extra state: `configRef`, `promptTemplateRef`,\n   * and `tools`. Pushes the masking-providers deprecation warning when masking\n   * is locally configured (skipped under `configRef` because the server-side\n   * configuration overrides it).\n   * @param _config - Strategy configuration (unused).\n   * @param settings - Model settings.\n   * @param sapOptions - Parsed provider options.\n   * @param options - AI SDK call options.\n   * @param warnings - Shared warnings sink.\n   * @returns Resolved orchestration state.\n   * @internal\n   */\n  protected override resolveAdditionalState(\n    _config: LanguageModelStrategyConfig,\n    settings: OrchestrationModelSettings,\n    sapOptions: Record<string, unknown> | undefined,\n    options: LanguageModelV3CallOptions,\n    warnings: SharedV3Warning[],\n  ): OrchestrationResolvedState {\n    const configRef = this.resolveConfigRef(sapOptions, settings, warnings);\n    const promptTemplateRef = this.resolvePromptTemplateRef(sapOptions, settings);\n\n    let responseFormat: SAPResponseFormat | undefined;\n    if (configRef === undefined) {\n      validateMaskingProvidersDeprecation(settings, warnings);\n      const converted = convertResponseFormat(options.responseFormat, settings.responseFormat);\n      responseFormat = converted.responseFormat;\n      if (converted.warning) warnings.push(converted.warning);\n    }\n\n    const tools = this.resolveTools(settings, options, warnings);\n\n    return { configRef, promptTemplateRef, responseFormat, tools };\n  }\n\n  /**\n   * Builds request for orchestrationConfigRef mode.\n   *\n   * In configRef mode, the full configuration is managed server-side.\n   * We only send messages and placeholderValues.\n   * @param settings - Model settings.\n   * @param options - Call options.\n   * @param commonParts - Common build result.\n   * @param warnings - Warnings array to populate.\n   * @returns Request body and warnings.\n   * @internal\n   */\n  private buildConfigRefRequest(\n    settings: OrchestrationModelSettings,\n    options: LanguageModelV3CallOptions,\n    commonParts: CommonBuildResult<ChatMessage[], SAPToolChoice | undefined>,\n    warnings: SharedV3Warning[],\n  ): { readonly request: ChatCompletionRequest; readonly warnings: SharedV3Warning[] } {\n    warnings.push(\n      ...this.collectConfigRefIgnoredWarnings(settings, options, commonParts.sapOptions),\n    );\n\n    const placeholderValues = resolvePlaceholderValues(settings, commonParts.sapOptions);\n\n    // In configRef mode, SDK uses messagesHistory (not messages)\n    const request: ChatCompletionRequest = {\n      messagesHistory: commonParts.messages,\n      ...(placeholderValues ? { placeholderValues } : {}),\n    };\n\n    return { request, warnings };\n  }\n\n  /**\n   * Builds inline template configuration.\n   * @param tools - Optional tools.\n   * @param responseFormat - Optional response format.\n   * @returns Prompt configuration.\n   * @internal\n   */\n  private buildInlineTemplateConfig(\n    tools: ChatCompletionTool[] | undefined,\n    responseFormat: unknown,\n  ): Record<string, unknown> {\n    return {\n      template: [],\n      ...(tools && tools.length > 0 ? { tools } : {}),\n      ...(responseFormat ? { response_format: responseFormat } : {}),\n    };\n  }\n\n  /**\n   * Builds the orchestration module configuration.\n   * @param config - Strategy configuration.\n   * @param settings - Model settings.\n   * @param params - Build parameters.\n   * @param params.modelParams - LLM model parameters.\n   * @param params.promptTemplateRef - Optional prompt template reference.\n   * @param params.responseFormat - Optional response format specification.\n   * @param params.toolChoice - Optional tool choice specification.\n   * @param params.tools - Optional tools for function calling.\n   * @returns Orchestration module configuration.\n   * @internal\n   */\n  private buildOrchestrationModuleConfig(\n    config: LanguageModelStrategyConfig,\n    settings: OrchestrationModelSettings,\n    params: {\n      readonly modelParams: Record<string, unknown>;\n      readonly promptTemplateRef?: PromptTemplateRef;\n      readonly responseFormat?: unknown;\n      readonly toolChoice?: SAPToolChoice;\n      readonly tools?: ChatCompletionTool[];\n    },\n  ): OrchestrationModuleConfig {\n    const { modelParams, promptTemplateRef, responseFormat, toolChoice, tools } = params;\n\n    const promptConfig = promptTemplateRef\n      ? this.buildTemplateRefPromptConfig(promptTemplateRef, tools, responseFormat)\n      : this.buildInlineTemplateConfig(tools, responseFormat);\n\n    // The SDK accepts model-specific options such as tool_choice only in model.params.\n    const effectiveModelParams = toolChoice\n      ? { ...modelParams, tool_choice: toolChoice }\n      : modelParams;\n\n    const moduleConfig: OrchestrationModuleConfig = {\n      promptTemplating: {\n        model: {\n          name: config.modelId,\n          params: effectiveModelParams,\n          ...(settings.modelVersion ? { version: settings.modelVersion } : {}),\n        },\n        prompt: promptConfig,\n      },\n    };\n\n    copyOrchestrationModules(\n      moduleConfig as unknown as Record<string, unknown>,\n      settings as unknown as Record<string, unknown>,\n    );\n\n    return moduleConfig;\n  }\n\n  /**\n   * Builds SAP SDK stream options from user-facing stream options.\n   * @param streamOptions - User-provided stream options.\n   * @returns SDK-compatible stream options object.\n   * @internal\n   */\n  private buildSdkStreamOptions(streamOptions: OrchestrationModelSettings[\"streamOptions\"]): {\n    global?: { chunk_size?: number; delimiters?: string[] };\n    outputFiltering?: { overlap: number };\n    promptTemplating: { include_usage: boolean };\n  } {\n    const delimiters = streamOptions?.delimiters;\n    const hasNonEmptyDelimiters = Array.isArray(delimiters) && delimiters.length > 0;\n    const hasGlobalOptions = streamOptions?.chunkSize !== undefined || hasNonEmptyDelimiters;\n\n    return {\n      promptTemplating: { include_usage: true },\n      ...(hasGlobalOptions && {\n        global: {\n          ...(streamOptions?.chunkSize !== undefined && { chunk_size: streamOptions.chunkSize }),\n          ...(hasNonEmptyDelimiters && {\n            delimiters: Array.from(delimiters),\n          }),\n        },\n      }),\n      ...(streamOptions?.outputFilteringOverlap !== undefined && {\n        outputFiltering: { overlap: streamOptions.outputFilteringOverlap },\n      }),\n    };\n  }\n\n  /**\n   * Builds request for standard (non-configRef) mode.\n   * @param settings - Model settings.\n   * @param commonParts - Common build result.\n   * @param warnings - Warnings array to populate.\n   * @returns Request body and warnings.\n   * @internal\n   */\n  private buildStandardRequest(\n    settings: OrchestrationModelSettings,\n    commonParts: CommonBuildResult<ChatMessage[], SAPToolChoice | undefined>,\n    warnings: SharedV3Warning[],\n  ): { readonly request: ChatCompletionRequest; readonly warnings: SharedV3Warning[] } {\n    const { promptTemplateRef } = commonParts.resolvedState as OrchestrationResolvedState;\n    const placeholderValues = resolvePlaceholderValues(settings, commonParts.sapOptions);\n    const request: ChatCompletionRequest = {\n      ...(promptTemplateRef\n        ? { messagesHistory: commonParts.messages }\n        : { messages: commonParts.messages }),\n      ...(placeholderValues ? { placeholderValues } : {}),\n    };\n\n    return { request, warnings };\n  }\n\n  /**\n   * Builds prompt configuration for template reference with optional tools/response_format.\n   * @param ref - Template reference.\n   * @param tools - Optional tools.\n   * @param responseFormat - Optional response format.\n   * @returns Prompt configuration.\n   * @internal\n   */\n  private buildTemplateRefPromptConfig(\n    ref: PromptTemplateRef,\n    tools?: ChatCompletionTool[],\n    responseFormat?: unknown,\n  ): Record<string, unknown> {\n    return {\n      template_ref: buildTemplateRefObject(ref),\n      ...(tools && tools.length > 0 ? { tools } : {}),\n      ...(responseFormat ? { response_format: responseFormat } : {}),\n    };\n  }\n\n  /**\n   * Collects warnings for settings that will be ignored when using orchestrationConfigRef.\n   * @param settings - The orchestration model settings.\n   * @param options - The call options (for tools and responseFormat).\n   * @param sapOptions - Parsed provider options (for promptTemplateRef in providerOptions).\n   * @returns Array of warnings for ignored settings.\n   * @internal\n   */\n  private collectConfigRefIgnoredWarnings(\n    settings: OrchestrationModelSettings,\n    options: LanguageModelV3CallOptions,\n    sapOptions: Record<string, unknown> | undefined,\n  ): SharedV3Warning[] {\n    const warnings: SharedV3Warning[] = [];\n    const ignoredSettings: string[] = [];\n\n    for (const key of CONFIG_REF_IGNORED_MODULES) {\n      const value = settings[key as keyof OrchestrationModelSettings];\n      if (value !== undefined) {\n        if (typeof value === \"object\" && Object.keys(value).length === 0) {\n          continue; // Skip empty objects\n        }\n        ignoredSettings.push(key);\n      }\n    }\n\n    for (const key of CONFIG_REF_IGNORED_PROVIDER_OPTIONS) {\n      if (sapOptions?.[key] && !settings[key as keyof OrchestrationModelSettings]) {\n        ignoredSettings.push(`providerOptions.${key}`);\n      }\n    }\n\n    const optionValues: Record<string, unknown> = options;\n    for (const { optionKey } of this.getParamMappings()) {\n      if (optionKey && optionValues[optionKey] !== undefined) {\n        ignoredSettings.push(`options.${optionKey}`);\n      }\n    }\n    if (options.stopSequences && options.stopSequences.length > 0) {\n      ignoredSettings.push(\"options.stopSequences\");\n    }\n\n    if (options.tools && options.tools.length > 0) {\n      ignoredSettings.push(\"options.tools\");\n    }\n    if (options.responseFormat) {\n      ignoredSettings.push(\"options.responseFormat\");\n    }\n    if (options.toolChoice) {\n      ignoredSettings.push(\"options.toolChoice\");\n    }\n\n    if (ignoredSettings.length > 0) {\n      warnings.push({\n        message: `orchestrationConfigRef is set; the following local settings are ignored: ${ignoredSettings.join(\", \")}. The full configuration is managed by the referenced config.`,\n        type: \"other\",\n      });\n    }\n\n    return warnings;\n  }\n\n  /**\n   * Resolves the orchestrationConfigRef from provider options or settings.\n   * Provider options take priority over settings. A present-but-invalid reference is\n   * ignored with a warning instead of failing the request.\n   * @param sapOptions - Parsed provider options from commonParts.\n   * @param settings - The model settings.\n   * @param warnings - Shared warnings sink for degradation signals.\n   * @returns The resolved config reference or undefined.\n   * @internal\n   */\n  private resolveConfigRef(\n    sapOptions: Record<string, unknown> | undefined,\n    settings: OrchestrationModelSettings,\n    warnings: SharedV3Warning[],\n  ): OrchestrationModelSettings[\"orchestrationConfigRef\"] {\n    const configRefCandidate =\n      sapOptions?.orchestrationConfigRef ?? settings.orchestrationConfigRef;\n\n    if (!configRefCandidate) {\n      return undefined;\n    }\n\n    if (isOrchestrationConfigRef(configRefCandidate)) {\n      return configRefCandidate;\n    }\n\n    warnings.push({\n      message:\n        \"orchestrationConfigRef is invalid and was ignored; falling back to local module settings.\",\n      type: \"other\",\n    });\n    return undefined;\n  }\n\n  /**\n   * Resolves promptTemplateRef from provider options or settings.\n   *\n   * Provider options take priority over settings.\n   * @param sapOptions - Parsed provider options from commonParts.\n   * @param settings - The model settings.\n   * @returns The resolved prompt template reference or undefined.\n   * @internal\n   */\n  private resolvePromptTemplateRef(\n    sapOptions: Record<string, unknown> | undefined,\n    settings: OrchestrationModelSettings,\n  ): PromptTemplateRef | undefined {\n    const rawTemplateRef = sapOptions?.promptTemplateRef ?? settings.promptTemplateRef;\n\n    if (\n      rawTemplateRef &&\n      typeof rawTemplateRef === \"object\" &&\n      (\"id\" in rawTemplateRef || \"name\" in rawTemplateRef)\n    ) {\n      return rawTemplateRef as PromptTemplateRef;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Resolves tools from settings or options with orchestration-specific priority.\n   *\n   * Orchestration allows tools to be defined in settings (unlike Foundation Models),\n   * with options.tools taking priority.\n   * @param settings - Model settings.\n   * @param options - Call options.\n   * @param warnings - Warnings array to populate.\n   * @returns Resolved tools or undefined.\n   * @internal\n   */\n  private resolveTools(\n    settings: OrchestrationModelSettings,\n    options: LanguageModelV3CallOptions,\n    warnings: SharedV3Warning[],\n  ): ChatCompletionTool[] | undefined {\n    const settingsTools = settings.tools;\n    const optionsTools = options.tools;\n\n    if (settingsTools && settingsTools.length > 0 && optionsTools && optionsTools.length > 0) {\n      warnings.push({\n        message:\n          \"Both settings.tools and call options.tools were provided; preferring call options.tools.\",\n        type: \"other\",\n      });\n    }\n\n    // Use settingsTools directly if available and no optionsTools\n    // (settingsTools are already in SAP format)\n    if (settingsTools && settingsTools.length > 0 && (!optionsTools || optionsTools.length === 0)) {\n      return settingsTools;\n    }\n\n    if (optionsTools && optionsTools.length > 0) {\n      const result = convertToolsToSAPFormat<ChatCompletionTool>(optionsTools, {\n        parser: parseSAPPartProviderOptions,\n        warnings,\n      });\n      warnings.push(...result.warnings);\n      return result.tools;\n    }\n\n    return undefined;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jerome-benoit/sap-ai-provider-v2",
-  "version": "4.9.0",
+  "version": "5.0.0",
   "type": "module",
   "description": "SAP AI Provider for Vercel AI SDK (LanguageModelV2/EmbeddingModelV2 interfaces)",
   "keywords": [
@@ -33,16 +33,21 @@
   "license": "Apache-2.0",
   "author": "jerome-benoit",
   "volta": {
-    "node": "24.19.0"
+    "node": "24.21.0"
   },
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     }
   },
   "directories": {
@@ -59,8 +64,9 @@
     "build:watch": "tsup --watch",
     "build:v2": "tsup --config tsup.config.v2.ts",
     "build:v2:watch": "tsup --config tsup.config.v2.ts --watch",
-    "check-build": "ls -la dist/ && test -f dist/index.js && test -f dist/index.cjs && test -f dist/index.d.ts",
-    "check-build:v2": "ls -la dist/ && test -f dist/index-v2.js && test -f dist/index-v2.cjs && test -f dist/index-v2.d.ts",
+    "check-build": "ls -la dist/ && test -f dist/index.js && test -f dist/index.cjs && test -f dist/index.d.ts && test -f dist/index.d.cts && test -f dist/index-v2.js && test -f dist/index-v2.cjs && test -f dist/index-v2.d.ts && test -f dist/index-v2.d.cts && test -f dist/index-v4.js && test -f dist/index-v4.cjs && test -f dist/index-v4.d.ts && test -f dist/index-v4.d.cts && tsx scripts/check-package-exports.ts",
+    "check-build:v2": "ls -la dist/ && test -f dist/index-v2.js && test -f dist/index-v2.cjs && test -f dist/index-v2.d.ts && test -f dist/index-v2.d.cts",
+    "check-build:v4": "ls -la dist/ && test -f dist/index-v4.js && test -f dist/index-v4.cjs && test -f dist/index-v4.d.ts && test -f dist/index-v4.d.cts",
     "clean": "rm -rf dist",
     "lint": "npm run lint:md:all && eslint . --cache",
     "lint-fix": "npm run lint:md:fix && eslint . --fix --cache",
@@ -71,7 +77,7 @@
     "lint:md:mermaid": "find . -name '*.md' -not -path './node_modules/*' -exec mermaid-validate validate-md {} \\; 2>&1 | grep -v 'No Mermaid code blocks'",
     "lint:md:toc": "tsx scripts/check-toc.ts",
     "prepare:v2": "tsx scripts/prepare-v2-package.ts",
-    "prepublishOnly": "if [ \"$AI_SDK_VERSION\" = \"v2\" ]; then npm run build:v2 && npm run check-build:v2 && npm run prepare:v2; else npm run build && npm run check-build; fi",
+    "prepublishOnly": "if [ \"$AI_SDK_VERSION\" = \"v2\" ]; then npm run build:v2 && npm run check-build:v2 && npm run prepare:v2; else npm run build && npm run check-build && npm run check-build:v2 && npm run check-build:v4; fi",
     "prettier-check": "prettier --cache --check .",
     "prettier-fix": "prettier --cache --write .",
     "test": "vitest run",
@@ -80,43 +86,43 @@
     "test:node": "vitest --config vitest.node.config.ts --run",
     "test:node:watch": "vitest --config vitest.node.config.ts",
     "test:watch": "vitest",
-    "sandcastle": "tsx .sandcastle/main.ts",
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@ai-sdk/provider": "^3.0.15",
-    "@ai-sdk/provider-utils": "^4.0.46",
+    "@ai-sdk/provider": "^4.0.13",
+    "@ai-sdk/provider-utils": "^5.0.39",
     "@sap-ai-sdk/foundation-models": "^2.15.0",
     "@sap-ai-sdk/orchestration": "^2.15.0",
-    "zod": "^4.4.3"
+    "zod": "^4.6.2"
   },
   "devDependencies": {
-    "@ai-hero/sandcastle": "^0.12.0",
+    "@ai-sdk/provider-v2": "npm:@ai-sdk/provider@^2.0.4",
     "@edge-runtime/vm": "^5.0.0",
     "@eslint/js": "^10.0.1",
-    "@types/node": "^25.9.5",
-    "@vitest/coverage-v8": "^4.1.11",
+    "@types/node": "^25.9.6",
+    "@vitest/coverage-v8": "^5.0.0",
+    "ai": "^7.0.97",
     "dotenv": "^17.4.2",
-    "eslint": "^10.9.0",
-    "eslint-plugin-jsdoc": "^64.2.1",
-    "eslint-plugin-perfectionist": "^5.10.1",
-    "globals": "^17.11.0",
-    "lefthook": "^2.1.10",
+    "eslint": "^10.10.0",
+    "eslint-plugin-jsdoc": "^64.3.9",
+    "eslint-plugin-perfectionist": "^5.11.0",
+    "globals": "^17.12.0",
+    "lefthook": "^2.1.12",
     "markdown-link-check": "^3.15.0",
     "markdownlint-cli2": "^0.23.2",
     "mermaid-validate": "^1.3.2",
     "prettier": "^3.9.6",
     "tsup": "^8.5.1",
-    "tsx": "^4.23.12",
+    "tsx": "^4.23.13",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.67.0",
-    "vitest": "^4.1.11"
+    "typescript-eslint": "^8.70.0",
+    "vitest": "^5.0.0"
   },
   "peerDependencies": {
     "ai": "^5.0.0 || ^6.0.0"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22.12.0"
   },
   "publishConfig": {
     "access": "public"

package/dist/chunk-3KCERYUB.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/base-language-model-strategy.ts"],"sourcesContent":["/** Base class for language model strategies using the Template Method pattern. */\nimport type {\n  LanguageModelV3CallOptions,\n  LanguageModelV3GenerateResult,\n  LanguageModelV3StreamResult,\n  SharedV3Warning,\n} from \"@ai-sdk/provider\";\nimport type { CustomRequestConfig } from \"@sap-ai-sdk/core\";\nimport type { ChatMessage } from \"@sap-ai-sdk/orchestration\";\n\nimport { parseProviderOptions } from \"@ai-sdk/provider-utils\";\n\nimport type { ParsePartProviderOptions } from \"./sap-ai-provider-options.js\";\nimport type { SAPAIModelSettings } from \"./sap-ai-settings.js\";\nimport type { LanguageModelAPIStrategy, LanguageModelStrategyConfig } from \"./sap-ai-strategy.js\";\n\nimport { convertToSAPMessages } from \"./convert-to-sap-messages.js\";\nimport { convertToAISDKError, normalizeHeaders } from \"./sap-ai-error.js\";\nimport { getProviderName, sapAILanguageModelProviderOptions } from \"./sap-ai-provider-options.js\";\nimport {\n  buildGenerateResult,\n  buildModelParams,\n  createAISDKRequestBodySummary,\n  createStreamTransformer,\n  extractCompletionId,\n  extractResponseMetadata,\n  mapToolChoice,\n  type ParamMapping,\n  type SAPToolChoice,\n  type SDKCitation,\n  type SDKResponse,\n  type SDKStreamChunk,\n  type SDKTokenUsage,\n  StreamIdGenerator,\n} from \"./strategy-utils.js\";\nimport { VERSION } from \"./version.js\";\n\n/**\n * Result of building common parts for a language model request.\n * @template TMessages - The message array type (e.g., `ChatMessage[]`, `AzureOpenAiChatCompletionRequestMessage[]`)\n * @template TToolChoice - The tool choice type (e.g., `SAPToolChoice`)\n * @internal\n */\nexport interface CommonBuildResult<TMessages extends unknown[] = unknown[], TToolChoice = unknown> {\n  readonly messages: TMessages;\n  readonly modelParams: Record<string, unknown>;\n  readonly providerName: string;\n  readonly resolvedState?: unknown;\n  readonly sapOptions: Record<string, unknown> | undefined;\n  readonly toolChoice: TToolChoice;\n  readonly warnings: SharedV3Warning[];\n}\n\n/**\n * Stream response shape returned by executeStreamCall.\n * @internal\n */\nexport interface StreamCallResponse {\n  readonly getCitations?: () => SDKCitation[] | undefined;\n  readonly getFinishReason: () => null | string | undefined;\n  readonly getIntermediateFailures?: () => undefined | unknown[];\n  readonly getTokenUsage: () => null | SDKTokenUsage | undefined;\n  /** SAP-pipeline request id resolved by `extractResponseMetadata`. */\n  readonly requestId?: string;\n  readonly responseHeaders?: Record<string, string>;\n  /** Server-provided completion ID extracted from _data, if available. */\n  readonly responseId?: string;\n  readonly stream: AsyncIterable<SDKStreamChunk>;\n}\n\n/**\n * Abstract base class for language model strategies using the Template Method pattern.\n * @template TClient - The SDK client type (e.g., AzureOpenAiChatClient, OrchestrationClient).\n * @template TRequest - The API request type (e.g., AzureOpenAiChatCompletionParameters).\n * @template TSettings - The model settings type extending SAPAIModelSettings.\n * @internal\n */\nexport abstract class BaseLanguageModelStrategy<\n  TClient,\n  TRequest,\n  TSettings extends SAPAIModelSettings = SAPAIModelSettings,\n> implements LanguageModelAPIStrategy<TSettings> {\n  /**\n   * Common parameter mappings for language model APIs.\n   * @internal\n   */\n  static readonly COMMON_PARAM_MAPPINGS: readonly ParamMapping[] = [\n    { camelCaseKey: \"maxTokens\", optionKey: \"maxOutputTokens\", outputKey: \"max_completion_tokens\" },\n    { camelCaseKey: \"temperature\", optionKey: \"temperature\", outputKey: \"temperature\" },\n    { camelCaseKey: \"topP\", optionKey: \"topP\", outputKey: \"top_p\" },\n    {\n      camelCaseKey: \"frequencyPenalty\",\n      optionKey: \"frequencyPenalty\",\n      outputKey: \"frequency_penalty\",\n    },\n    {\n      camelCaseKey: \"presencePenalty\",\n      optionKey: \"presencePenalty\",\n      outputKey: \"presence_penalty\",\n    },\n    { camelCaseKey: \"seed\", optionKey: \"seed\", outputKey: \"seed\" },\n    { camelCaseKey: \"parallel_tool_calls\", outputKey: \"parallel_tool_calls\" },\n  ] as const;\n\n  async doGenerate(\n    config: LanguageModelStrategyConfig,\n    settings: TSettings,\n    options: LanguageModelV3CallOptions,\n  ): Promise<LanguageModelV3GenerateResult> {\n    try {\n      const commonParts = await this.buildCommonParts(config, settings, options);\n      const { request, warnings } = this.buildRequest(config, settings, options, commonParts);\n\n      const client = this.createClient(config, settings, commonParts);\n\n      const response = await this.executeApiCall(\n        client,\n        request,\n        options.abortSignal ?? undefined,\n        config.requestConfig,\n      );\n\n      return buildGenerateResult({\n        modelId: config.modelId,\n        providerName: commonParts.providerName,\n        requestBody: request,\n        requestId: response.requestId,\n        response,\n        responseHeaders: normalizeHeaders(response.rawResponse.headers),\n        version: VERSION,\n        warnings: [...commonParts.warnings, ...warnings],\n      });\n    } catch (error) {\n      throw convertToAISDKError(error, {\n        operation: \"doGenerate\",\n        requestBody: createAISDKRequestBodySummary(options),\n        url: this.getUrl(),\n      });\n    }\n  }\n\n  async doStream(\n    config: LanguageModelStrategyConfig,\n    settings: TSettings,\n    options: LanguageModelV3CallOptions,\n  ): Promise<LanguageModelV3StreamResult> {\n    try {\n      const commonParts = await this.buildCommonParts(config, settings, options);\n      const { request, warnings } = this.buildRequest(config, settings, options, commonParts);\n\n      const client = this.createClient(config, settings, commonParts);\n\n      const streamResponse = await this.executeStreamCall(\n        client,\n        request,\n        options.abortSignal ?? undefined,\n        settings,\n        config.requestConfig,\n      );\n\n      const idGenerator = new StreamIdGenerator();\n      const responseId = streamResponse.responseId ?? idGenerator.generateResponseId();\n\n      const streamWarnings = this.collectStreamWarnings(settings, commonParts.sapOptions);\n\n      const transformedStream = createStreamTransformer({\n        convertToAISDKError,\n        idGenerator,\n        includeRawChunks: options.includeRawChunks ?? false,\n        modelId: config.modelId,\n        options,\n        providerName: commonParts.providerName,\n        requestId: streamResponse.requestId,\n        responseId,\n        sdkStream: streamResponse.stream,\n        streamResponseGetCitations: streamResponse.getCitations,\n        streamResponseGetFinishReason: streamResponse.getFinishReason,\n        streamResponseGetIntermediateFailures: streamResponse.getIntermediateFailures,\n        streamResponseGetTokenUsage: streamResponse.getTokenUsage,\n        url: this.getUrl(),\n        version: VERSION,\n        warnings: [...commonParts.warnings, ...warnings, ...streamWarnings],\n      });\n\n      return {\n        request: {\n          body: request,\n        },\n        response: {\n          headers: streamResponse.responseHeaders,\n        },\n        stream: transformedStream,\n      };\n    } catch (error) {\n      throw convertToAISDKError(error, {\n        operation: \"doStream\",\n        requestBody: createAISDKRequestBodySummary(options),\n        url: this.getUrl(),\n      });\n    }\n  }\n\n  /**\n   * Builds common parts shared between doGenerate and doStream.\n   * @param config - Strategy configuration.\n   * @param settings - Model settings.\n   * @param options - AI SDK call options.\n   * @returns Common build result with typed messages and tool choice.\n   * @internal\n   */\n  protected async buildCommonParts(\n    config: LanguageModelStrategyConfig,\n    settings: TSettings,\n    options: LanguageModelV3CallOptions,\n  ): Promise<CommonBuildResult<ChatMessage[], SAPToolChoice | undefined>> {\n    const providerName = getProviderName(config.provider);\n\n    const sapOptions = await parseProviderOptions({\n      provider: providerName,\n      providerOptions: options.providerOptions,\n      schema: sapAILanguageModelProviderOptions,\n    });\n\n    const warnings: SharedV3Warning[] = [];\n\n    const resolvedState = this.resolveAdditionalState(\n      config,\n      settings,\n      sapOptions,\n      options,\n      warnings,\n    );\n\n    const messages = convertToSAPMessages(options.prompt, {\n      escapeTemplatePlaceholders: this.getEscapeTemplatePlaceholders(sapOptions, settings),\n      includeReasoning: this.getIncludeReasoning(sapOptions, settings),\n      parsePartProviderOptions: this.getPartProviderOptionsParser(),\n      warnings,\n    });\n\n    const { modelParams, warnings: paramWarnings } = buildModelParams({\n      options,\n      paramMappings: this.getParamMappings(),\n      providerModelParams: sapOptions?.modelParams,\n      settingsModelParams: settings.modelParams,\n    });\n    warnings.push(...paramWarnings);\n\n    const toolChoice = mapToolChoice(options.toolChoice);\n\n    return {\n      messages,\n      modelParams,\n      providerName,\n      resolvedState,\n      sapOptions,\n      toolChoice,\n      warnings,\n    };\n  }\n\n  /**\n   * Builds the API-specific request body.\n   * @param config - Strategy configuration.\n   * @param settings - Model settings.\n   * @param options - AI SDK call options.\n   * @param commonParts - Common build result from base class.\n   * @returns Request body and accumulated warnings.\n   * @internal\n   */\n  protected abstract buildRequest(\n    config: LanguageModelStrategyConfig,\n    settings: TSettings,\n    options: LanguageModelV3CallOptions,\n    commonParts: CommonBuildResult<ChatMessage[], SAPToolChoice | undefined>,\n  ): { readonly request: TRequest; readonly warnings: SharedV3Warning[] };\n\n  /**\n   * Collects stream-specific warnings.\n   * Override in subclasses to add API-specific streaming warnings.\n   * @param _settings - Model settings (unused in base implementation).\n   * @param _sapOptions - Provider options (unused in base implementation).\n   * @returns Array of warnings for streaming operations.\n   * @internal\n   */\n  protected collectStreamWarnings(\n    _settings: TSettings,\n    _sapOptions?: Record<string, unknown>,\n  ): SharedV3Warning[] {\n    return [];\n  }\n\n  /**\n   * Creates the appropriate SDK client for this API.\n   * @param config - Strategy configuration.\n   * @param settings - Model settings.\n   * @param commonParts - Common build result (messages, options, etc.).\n   * @returns SDK client instance.\n   * @internal\n   */\n  protected abstract createClient(\n    config: LanguageModelStrategyConfig,\n    settings: TSettings,\n    commonParts: CommonBuildResult<ChatMessage[], SAPToolChoice | undefined>,\n  ): TClient;\n\n  /**\n   * Executes the non-streaming API call.\n   * @param client - SDK client instance.\n   * @param request - Request body.\n   * @param abortSignal - Optional abort signal.\n   * @param requestConfig - Optional custom request configuration (e.g. custom headers).\n   * @returns SDK response.\n   * @internal\n   */\n  protected abstract executeApiCall(\n    client: TClient,\n    request: TRequest,\n    abortSignal: AbortSignal | undefined,\n    requestConfig: CustomRequestConfig | undefined,\n  ): Promise<SDKResponse>;\n\n  /**\n   * Executes the streaming API call.\n   * @param client - SDK client instance.\n   * @param request - Request body.\n   * @param abortSignal - Optional abort signal.\n   * @param settings - Model settings for API-specific stream options.\n   * @param requestConfig - Optional custom request configuration (e.g. custom headers).\n   * @returns Stream response with accessors.\n   * @internal\n   */\n  protected abstract executeStreamCall(\n    client: TClient,\n    request: TRequest,\n    abortSignal: AbortSignal | undefined,\n    settings: TSettings,\n    requestConfig: CustomRequestConfig | undefined,\n  ): Promise<StreamCallResponse>;\n\n  /**\n   * Resolves request id, completion id, and normalised headers from an SDK response.\n   * @param response - Raw SDK response or stream response.\n   * @returns Combined metadata fragment.\n   * @internal\n   */\n  protected extractMetadata(response: unknown): {\n    requestId?: string;\n    responseHeaders?: Record<string, string>;\n    responseId?: string;\n  } {\n    const responseId = extractCompletionId(\n      response as { _data?: unknown; getRequestId?: () => string | undefined },\n      this.getCompletionIdPath(),\n    );\n    const { headers, requestId } = extractResponseMetadata(response, \"rawResponse\");\n    return { requestId, responseHeaders: headers, responseId };\n  }\n\n  /**\n   * Returns the API-specific dotted path used to read the completion id off\n   * the SDK response's internal `_data` payload.\n   * @returns Path traversed under `_data` (e.g. `[\"final_result\",\"id\"]`, `[\"id\"]`).\n   * @internal\n   */\n  protected abstract getCompletionIdPath(): readonly string[];\n\n  /**\n   * Returns whether to escape template placeholders for this API.\n   * @param _sapOptions - Parsed provider options (unused in base implementation).\n   * @param _settings - Model settings (unused in base implementation).\n   * @returns false by default; Orchestration strategy overrides to return true.\n   * @internal\n   */\n  protected getEscapeTemplatePlaceholders(\n    _sapOptions: Record<string, unknown> | undefined,\n    _settings: TSettings,\n  ): boolean {\n    return false;\n  }\n\n  /**\n   * Returns whether to include reasoning in the response.\n   * @param sapOptions - Parsed provider options.\n   * @param settings - Model settings.\n   * @returns Whether to include reasoning (checks sapOptions then settings, defaults to false).\n   * @internal\n   */\n  protected getIncludeReasoning(\n    sapOptions: Record<string, unknown> | undefined,\n    settings: TSettings,\n  ): boolean {\n    return (\n      (sapOptions?.includeReasoning as boolean | undefined) ?? settings.includeReasoning ?? false\n    );\n  }\n\n  /**\n   * Returns the parameter mappings specific to this API strategy.\n   * @returns Array of parameter mappings.\n   * @internal\n   */\n  protected abstract getParamMappings(): readonly ParamMapping[];\n\n  /**\n   * Returns a parser for per-message-part `providerOptions['sap-ai']`.\n   *\n   * Default returns `undefined`; strategies honouring part-level directives\n   * (e.g. Anthropic `cacheControl` on orchestration) override to return a parser.\n   * @returns Parser callback, or undefined to disable per-part plumbing.\n   * @internal\n   */\n  protected getPartProviderOptionsParser(): ParsePartProviderOptions | undefined {\n    return undefined;\n  }\n\n  /**\n   * Returns the URL identifier for this API (used in error messages).\n   * @returns URL string identifier.\n   * @internal\n   */\n  protected abstract getUrl(): string;\n\n  /**\n   * Resolves API-specific extra state shared between doGenerate and doStream\n   * (e.g. orchestration `configRef` / `promptTemplateRef` / `tools`). Override\n   * to add API-specific deprecation checks or pre-resolve auxiliary inputs.\n   * Pushed warnings flow into the shared sink.\n   * @param _config - Strategy configuration.\n   * @param _settings - Model settings.\n   * @param _sapOptions - Parsed provider options, or `undefined`.\n   * @param _options - AI SDK call options.\n   * @param _warnings - Shared warnings sink for the current call.\n   * @returns Strategy-specific resolved state, or `undefined` (default).\n   * @internal\n   */\n  protected resolveAdditionalState(\n    _config: LanguageModelStrategyConfig,\n    _settings: TSettings,\n    _sapOptions: Record<string, unknown> | undefined,\n    _options: LanguageModelV3CallOptions,\n    _warnings: SharedV3Warning[],\n  ): unknown {\n    return undefined;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-4JIMBRMV.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  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":[]}