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

package/dist/orchestration-language-model-strategy-4TKRZK7U.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 {\n  ChatCompletionTool,\n  ChatMessage,\n  OrchestrationClient,\n  OrchestrationConfigRef,\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  type ParamMapping,\n  type SAPToolChoice,\n  type SDKCitation,\n  type SDKResponse,\n  type SDKStreamChunk,\n} from \"./strategy-utils.js\";\n\n/**\n * Extended prompt templating interface for type-safe access.\n * @internal\n */\ninterface ExtendedPromptTemplating {\n  prompt: {\n    response_format?: unknown;\n    template?: unknown[];\n    template_ref?: unknown;\n    tools?: unknown;\n  };\n}\n\n/** @internal */\ntype OrchestrationClientInstance = InstanceType<typeof OrchestrationClient>;\n\n/**\n * Orchestration request body type.\n * @internal\n */\ntype OrchestrationRequest = Record<string, unknown>;\n\n/**\n * Typed resolved state for values computed in buildCommonParts and consumed in buildRequest/createClient.\n * @internal\n */\ninterface OrchestrationResolvedState {\n  readonly configRef: OrchestrationConfigRef | undefined;\n  readonly promptTemplateRef: PromptTemplateRef | 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  \"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 OrchestrationConfigRef.\n * @param value - The value to check.\n * @returns True if the value is a valid OrchestrationConfigRef.\n * @internal\n */\nfunction isOrchestrationConfigRef(value: unknown): value is 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  OrchestrationRequest,\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: OrchestrationRequest; 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, configRef, warnings);\n    }\n\n    return this.buildStandardRequest(config, settings, options, 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, tools } =\n      commonParts.resolvedState as OrchestrationResolvedState;\n\n    if (configRef) {\n      return new this.ClientClass(configRef, config.deploymentConfig, config.destination);\n    }\n\n    const promptConfig = promptTemplateRef\n      ? this.buildTemplateRefPromptConfig(promptTemplateRef, tools)\n      : this.buildInlineTemplateConfig(tools, undefined);\n\n    const clientConfig: OrchestrationModuleConfig = {\n      promptTemplating: {\n        model: {\n          name: config.modelId,\n          ...(settings.modelVersion ? { version: settings.modelVersion } : {}),\n        },\n        prompt: promptConfig,\n      },\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: OrchestrationRequest,\n    abortSignal: AbortSignal | undefined,\n  ): Promise<SDKResponse> {\n    const response = await client.chatCompletion(\n      request,\n      abortSignal ? { signal: abortSignal } : undefined,\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: OrchestrationRequest,\n    abortSignal: AbortSignal | undefined,\n    settings: OrchestrationModelSettings,\n  ): Promise<StreamCallResponse> {\n    const sdkStreamOptions = this.buildSdkStreamOptions(settings.streamOptions);\n    const streamResponse = await client.stream(request, abortSignal, sdkStreamOptions);\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);\n    const promptTemplateRef = this.resolvePromptTemplateRef(sapOptions, settings);\n\n    if (configRef === undefined) {\n      validateMaskingProvidersDeprecation(settings, warnings);\n    }\n\n    const tools = this.resolveTools(settings, options, warnings);\n\n    return { configRef, promptTemplateRef, 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 _configRef - The config reference (unused, passed for signature consistency).\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    _configRef: OrchestrationConfigRef,\n    warnings: SharedV3Warning[],\n  ): { readonly request: OrchestrationRequest; 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: OrchestrationRequest = {\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    // Include tool_choice in model.params because the SDK filters request-level options.\n    // Workaround for SAP AI SDK issue (may be fixed in future SDK versions).\n    // See: https://github.com/SAP/ai-sdk-js/issues/1500\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 the final request body for the orchestration API.\n   * @param messages - Chat messages.\n   * @param orchestrationConfig - Module configuration.\n   * @param placeholderValues - Optional placeholder values.\n   * @param hasTemplateRef - Whether template_ref mode is active.\n   * @returns Request body.\n   * @internal\n   */\n  private buildRequestBody(\n    messages: ChatMessage[],\n    orchestrationConfig: OrchestrationModuleConfig,\n    placeholderValues: Record<string, string> | undefined,\n    hasTemplateRef: boolean,\n  ): Record<string, unknown> {\n    const promptTemplating = orchestrationConfig.promptTemplating as ExtendedPromptTemplating;\n\n    // In template_ref mode, SDK uses messagesHistory (not messages)\n    // In inline template mode, SDK adds messages to the template array\n    const messagesField = hasTemplateRef ? { messagesHistory: messages } : { messages };\n\n    // Note: tool_choice is passed via model.params (not request level) because the SDK\n    // filters out request-level options. Workaround may be removed when SDK is fixed.\n    // See: https://github.com/SAP/ai-sdk-js/issues/1500\n    const requestBody: Record<string, unknown> = {\n      ...messagesField,\n      model: {\n        ...orchestrationConfig.promptTemplating.model,\n      },\n      ...(placeholderValues ? { placeholderValues } : {}),\n      ...(promptTemplating.prompt.tools ? { tools: promptTemplating.prompt.tools } : {}),\n      ...(promptTemplating.prompt.response_format\n        ? { response_format: promptTemplating.prompt.response_format }\n        : {}),\n    };\n\n    copyOrchestrationModules(\n      requestBody,\n      orchestrationConfig as unknown as Record<string, unknown>,\n    );\n\n    return requestBody;\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 config - Strategy configuration.\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 buildStandardRequest(\n    config: LanguageModelStrategyConfig,\n    settings: OrchestrationModelSettings,\n    options: LanguageModelV3CallOptions,\n    commonParts: CommonBuildResult<ChatMessage[], SAPToolChoice | undefined>,\n    warnings: SharedV3Warning[],\n  ): { readonly request: OrchestrationRequest; readonly warnings: SharedV3Warning[] } {\n    const { promptTemplateRef, tools } = commonParts.resolvedState as OrchestrationResolvedState;\n\n    const { responseFormat, warning: responseFormatWarning } = convertResponseFormat(\n      options.responseFormat,\n      settings.responseFormat,\n    );\n    if (responseFormatWarning) {\n      warnings.push(responseFormatWarning);\n    }\n\n    const { toolChoice } = commonParts;\n\n    const orchestrationConfig = this.buildOrchestrationModuleConfig(config, settings, {\n      modelParams: commonParts.modelParams,\n      promptTemplateRef,\n      responseFormat,\n      toolChoice,\n      tools,\n    });\n\n    const placeholderValues = resolvePlaceholderValues(settings, commonParts.sapOptions);\n\n    const request = this.buildRequestBody(\n      commonParts.messages,\n      orchestrationConfig,\n      placeholderValues,\n      Boolean(promptTemplateRef),\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    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.\n   * @param sapOptions - Parsed provider options from commonParts.\n   * @param settings - The model settings.\n   * @returns The resolved config reference or undefined.\n   * @internal\n   */\n  private resolveConfigRef(\n    sapOptions: Record<string, unknown> | undefined,\n    settings: OrchestrationModelSettings,\n  ): OrchestrationConfigRef | undefined {\n    const configRefCandidate =\n      sapOptions?.orchestrationConfigRef ?? settings.orchestrationConfigRef;\n\n    if (configRefCandidate && isOrchestrationConfigRef(configRefCandidate)) {\n      return configRefCandidate;\n    }\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",
-  "version": "4.6.9",
+  "version": "4.7.0",
   "type": "module",
   "description": "SAP AI Provider for Vercel AI SDK (powered by @sap-ai-sdk/orchestration and @sap-ai-sdk/foundation-models)",
   "keywords": [
@@ -27,7 +27,7 @@
   "license": "Apache-2.0",
   "author": "jerome-benoit",
   "volta": {
-    "node": "24.15.0"
+    "node": "24.16.0"
   },
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -45,9 +45,11 @@
   "files": [
     "dist/**/*",
     "README.md",
-    "LICENSE.md"
+    "LICENSE"
   ],
   "scripts": {
+    "prepare": "lefthook install",
+    "postinstall": "patch-package",
     "build": "tsup",
     "build:watch": "tsup --watch",
     "build:v2": "tsup --config tsup.config.v2.ts",
@@ -73,34 +75,38 @@
     "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.10",
-    "@ai-sdk/provider-utils": "^4.0.26",
-    "@sap-ai-sdk/foundation-models": "^2.10.0",
-    "@sap-ai-sdk/orchestration": "^2.10.0",
-    "zod": "^4.4.2"
+    "@ai-sdk/provider-utils": "^4.0.27",
+    "@sap-ai-sdk/foundation-models": "^2.11.0",
+    "@sap-ai-sdk/orchestration": "^2.11.0",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
+    "@ai-hero/sandcastle": "^0.6.5",
     "@edge-runtime/vm": "^5.0.0",
     "@eslint/js": "^10.0.1",
-    "@types/node": "^25.6.0",
-    "@vitest/coverage-v8": "^4.1.5",
+    "@types/node": "^25.9.1",
+    "@vitest/coverage-v8": "^4.1.7",
     "dotenv": "^17.4.2",
-    "eslint": "^10.3.0",
-    "eslint-plugin-jsdoc": "^62.9.0",
+    "eslint": "^10.4.0",
+    "eslint-plugin-jsdoc": "^63.0.0",
     "eslint-plugin-perfectionist": "^5.9.0",
     "globals": "^17.6.0",
+    "lefthook": "^2.1.8",
     "markdown-link-check": "^3.14.2",
     "markdownlint-cli2": "^0.22.1",
     "mermaid-validate": "^1.3.2",
+    "patch-package": "^8.0.1",
     "prettier": "^3.8.3",
     "tsup": "^8.5.1",
-    "tsx": "^4.21.0",
+    "tsx": "^4.22.3",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.59.1",
-    "vitest": "^4.1.5"
+    "typescript-eslint": "^8.60.0",
+    "vitest": "^4.1.7"
   },
   "peerDependencies": {
     "ai": "^5.0.0 || ^6.0.0"

package/LICENSE.md

@@ -1,187 +0,0 @@
-             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 2026 Jérôme Benoit
-
-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/dist/chunk-4RRRJBEL.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/strategy-utils.ts"],"sourcesContent":["/**\n * Shared utilities for SAP AI Core strategy implementations.\n */\nimport type {\n  EmbeddingModelV3CallOptions,\n  EmbeddingModelV3Embedding,\n  EmbeddingModelV3Result,\n  JSONArray,\n  LanguageModelV3CallOptions,\n  LanguageModelV3Content,\n  LanguageModelV3FinishReason,\n  LanguageModelV3FunctionTool,\n  LanguageModelV3GenerateResult,\n  LanguageModelV3StreamPart,\n  LanguageModelV3Usage,\n  SharedV3ProviderMetadata,\n  SharedV3Warning,\n} from \"@ai-sdk/provider\";\nimport type { DeploymentIdConfig, ResourceGroupConfig } from \"@sap-ai-sdk/ai-api/internal.js\";\nimport type { ZodType } from \"zod\";\n\nimport { TooManyEmbeddingValuesForCallError } from \"@ai-sdk/provider\";\nimport { convertAsyncIteratorToReadableStream, parseProviderOptions } from \"@ai-sdk/provider-utils\";\nimport { z } from \"zod\";\n\nimport { deepMerge } from \"./deep-merge.js\";\nimport { getProviderName, sapAIEmbeddingProviderOptions } from \"./sap-ai-provider-options.js\";\nimport { validateModelParamsWithWarnings } from \"./sap-ai-provider-options.js\";\n\n/**\n * @internal\n */\nexport interface AISDKTool {\n  description?: string;\n  inputSchema?: unknown;\n  name: string;\n  type: string;\n}\n\n/**\n * @internal\n */\nexport type AISDKToolChoice =\n  | { toolName: string; type: \"tool\" }\n  | { type: \"auto\" }\n  | { type: \"none\" }\n  | { type: \"required\" };\n\n/**\n * @internal\n */\nexport interface BaseEmbeddingConfig {\n  readonly maxEmbeddingsPerCall: number;\n  readonly modelId: string;\n  readonly provider: string;\n}\n\n/**\n * @internal\n */\nexport interface BaseModelDeploymentConfig {\n  readonly deploymentConfig: DeploymentIdConfig | ResourceGroupConfig;\n  readonly modelId: string;\n}\n\n/**\n * @internal\n */\nexport interface BuildModelParamsConfig {\n  readonly options: LanguageModelV3CallOptions;\n  readonly paramMappings: readonly ParamMapping[];\n  readonly providerModelParams?: Record<string, unknown>;\n  readonly settingsModelParams?: Record<string, unknown>;\n}\n\n/**\n * @internal\n */\nexport interface BuildModelParamsResult {\n  readonly modelParams: Record<string, unknown>;\n  readonly warnings: SharedV3Warning[];\n}\n\n/**\n * @internal\n */\nexport interface ConvertedResponseFormatResult {\n  readonly responseFormat: SAPResponseFormat | undefined;\n  readonly warning: SharedV3Warning | undefined;\n}\n\n/**\n * @internal\n */\nexport interface ConvertedToolsResult<T> {\n  readonly tools: T[] | undefined;\n  readonly warnings: SharedV3Warning[];\n}\n\n/**\n * Parsed embedding provider options from AI SDK call.\n * @internal\n */\nexport interface EmbeddingProviderOptions {\n  readonly modelParams?: Record<string, unknown>;\n  readonly type?: EmbeddingType;\n}\n\n/**\n * @internal\n */\nexport interface EmbeddingResultConfig {\n  readonly embeddings: EmbeddingModelV3Embedding[];\n  readonly modelId: string;\n  readonly providerName: string;\n  readonly totalTokens: number;\n  readonly version: string;\n}\n\n/**\n * Valid embedding types for orchestration API.\n * @internal\n */\nexport type EmbeddingType = \"document\" | \"query\" | \"text\";\n\n/**\n * @internal\n */\nexport interface ExtractedToolParameters {\n  readonly parameters: SAPToolParameters;\n  readonly warning?: SharedV3Warning;\n}\n\n/**\n * @internal\n */\nexport interface FunctionToolWithParameters extends LanguageModelV3FunctionTool {\n  readonly parameters?: unknown;\n}\n\n/**\n * @internal\n */\nexport interface GenerateResultConfig {\n  readonly modelId: string;\n  readonly providerName: string;\n  readonly requestBody: unknown;\n  readonly response: SDKResponse;\n  readonly responseHeaders: Record<string, string> | undefined;\n  readonly version: string;\n  readonly warnings: SharedV3Warning[];\n}\n\n/**\n * Parameter mapping for AI SDK options → SAP model params.\n * @internal\n */\nexport interface ParamMapping {\n  readonly camelCaseKey?: string;\n  readonly optionKey?: string;\n  readonly outputKey: string;\n}\n\n/**\n * @internal\n */\nexport type SAPResponseFormat =\n  | {\n      json_schema: {\n        description?: string;\n        name: string;\n        schema: Record<string, unknown>;\n        strict: boolean | null;\n      };\n      type: \"json_schema\";\n    }\n  | { type: \"json_object\" }\n  | { type: \"text\" };\n\n/**\n * @internal\n */\nexport interface SAPTool<P = SAPToolParameters> {\n  function: {\n    description?: string;\n    name: string;\n    parameters?: P;\n  };\n  type: \"function\";\n}\n\n/**\n * @internal\n */\nexport type SAPToolChoice =\n  | \"auto\"\n  | \"none\"\n  | \"required\"\n  | { function: { name: string }; type: \"function\" };\n\n/**\n * @internal\n */\nexport type SAPToolParameters = Record<string, unknown> & {\n  properties: Record<string, unknown>;\n  required: string[];\n  type: \"object\";\n};\n\n/**\n * @internal\n */\nexport interface SDKCitation {\n  end_index?: number;\n  ref_id?: number;\n  start_index?: number;\n  title: string;\n  url: string;\n}\n\n/**\n * @internal\n */\nexport interface SDKDeltaToolCall {\n  function?: { arguments?: string; name?: string };\n  id?: string;\n  index?: number;\n}\n\n/**\n * @internal\n */\nexport interface SDKResponse {\n  getCitations?(): SDKCitation[] | undefined;\n  getContent(): null | string | undefined;\n  getFinishReason(): null | string | undefined;\n  getIntermediateFailures?(): undefined | unknown[];\n  getTokenUsage(): SDKTokenUsage | undefined;\n  getToolCalls(): null | SDKToolCall[] | undefined;\n  rawResponse: { headers: Headers | Record<string, string> };\n  responseId?: string;\n}\n\n/**\n * @internal\n */\nexport interface SDKStreamChunk {\n  _data?: unknown;\n  getDeltaContent(): null | string | undefined;\n  getDeltaToolCalls(): null | SDKDeltaToolCall[] | undefined;\n  getFinishReason(): null | string | undefined;\n}\n\n/**\n * Token usage shape returned by SAP AI SDK responses.\n *\n * Shared by both doGenerate and doStream paths, this type captures the\n * superset of fields exposed by the Orchestration (`TokenUsage`) and\n * Foundation Models (`AzureOpenAiCompletionUsage`) SDKs.\n * @internal\n */\nexport interface SDKTokenUsage {\n  completion_tokens?: number;\n  completion_tokens_details?: {\n    reasoning_tokens?: number;\n  };\n  prompt_tokens?: number;\n  prompt_tokens_details?: {\n    cached_tokens?: number;\n  };\n}\n\n/**\n * @internal\n */\nexport interface SDKToolCall {\n  function: { arguments: string; name: string };\n  id: string;\n}\n\n/**\n * @internal\n */\nexport interface StreamState {\n  activeText: boolean;\n  finishReason: LanguageModelV3FinishReason;\n  isFirstChunk: boolean;\n  usage: {\n    inputTokens: {\n      cacheRead: number | undefined;\n      cacheWrite: number | undefined;\n      noCache: number | undefined;\n      total: number | undefined;\n    };\n    outputTokens: {\n      reasoning: number | undefined;\n      text: number | undefined;\n      total: number | undefined;\n    };\n  };\n}\n\n/**\n * @internal\n */\nexport interface StreamTransformerConfig {\n  readonly convertToAISDKError: (\n    error: unknown,\n    context: { operation: string; requestBody: unknown; url: string },\n  ) => unknown;\n  readonly idGenerator: StreamIdGenerator;\n  readonly includeRawChunks: boolean;\n  readonly modelId: string;\n  readonly options: LanguageModelV3CallOptions;\n  readonly providerName: string;\n  readonly responseHeaders?: Record<string, string>;\n  readonly responseId: string;\n  readonly sdkStream: AsyncIterable<SDKStreamChunk>;\n  readonly streamResponseGetCitations?: () => SDKCitation[] | undefined;\n  readonly streamResponseGetFinishReason: () => null | string | undefined;\n  readonly streamResponseGetIntermediateFailures?: () => undefined | unknown[];\n  readonly streamResponseGetTokenUsage: () => null | SDKTokenUsage | undefined;\n  readonly url: string;\n  readonly version: string;\n  readonly warnings: readonly SharedV3Warning[];\n}\n\n/**\n * @internal\n */\nexport interface ToolCallInProgress {\n  arguments: string;\n  didEmitCall: boolean;\n  didEmitInputStart: boolean;\n  id: string | undefined;\n  toolName?: string;\n}\n\n/**\n * @internal\n */\nexport class StreamIdGenerator {\n  /**\n   * @returns A UUID string for identifying the response.\n   */\n  generateResponseId(): string {\n    return crypto.randomUUID();\n  }\n\n  /**\n   * @returns A UUID string for identifying a text block.\n   */\n  generateTextBlockId(): string {\n    return crypto.randomUUID();\n  }\n\n  /**\n   * @returns A UUID string for identifying a tool call when the API does not provide one.\n   */\n  generateToolCallId(): string {\n    return crypto.randomUUID();\n  }\n}\n\n/**\n * Applies parameter overrides from AI SDK options and modelParams.\n * @param modelParams - The model parameters object to modify.\n * @param options - AI SDK call options.\n * @param sapModelParams - Provider options model params.\n * @param settingsModelParams - Settings model params.\n * @param mappings - Parameter mappings for this strategy.\n * @internal\n */\nexport function applyParameterOverrides(\n  modelParams: Record<string, unknown>,\n  options: Record<string, unknown>,\n  sapModelParams: Record<string, unknown> | undefined,\n  settingsModelParams: Record<string, unknown> | undefined,\n  mappings: readonly ParamMapping[],\n): void {\n  for (const mapping of mappings) {\n    const value =\n      (mapping.optionKey ? options[mapping.optionKey] : undefined) ??\n      (mapping.camelCaseKey ? sapModelParams?.[mapping.camelCaseKey] : undefined) ??\n      (mapping.camelCaseKey ? settingsModelParams?.[mapping.camelCaseKey] : undefined);\n\n    if (value !== undefined) {\n      modelParams[mapping.outputKey] = value;\n    }\n\n    if (mapping.camelCaseKey && mapping.camelCaseKey !== mapping.outputKey) {\n      // eslint-disable-next-line @typescript-eslint/no-dynamic-delete\n      delete modelParams[mapping.camelCaseKey];\n    }\n  }\n}\n\n/**\n * Builds an EmbeddingModelV3Result from embedding data.\n * @param config - Configuration with embeddings and metadata.\n * @returns Complete embedding result for AI SDK.\n * @internal\n */\nexport function buildEmbeddingResult(config: EmbeddingResultConfig): EmbeddingModelV3Result {\n  const { embeddings, modelId, providerName, totalTokens, version } = config;\n\n  const providerMetadata: SharedV3ProviderMetadata = {\n    [providerName]: {\n      model: modelId,\n      version,\n    },\n  };\n\n  return {\n    embeddings,\n    providerMetadata,\n    usage: { tokens: totalTokens },\n    warnings: [],\n  };\n}\n\n/**\n * Builds a LanguageModelV3GenerateResult from SDK response.\n * @param config - Configuration with response and metadata.\n * @returns Complete generate result for AI SDK.\n * @internal\n */\nexport function buildGenerateResult(config: GenerateResultConfig): LanguageModelV3GenerateResult {\n  const { modelId, providerName, requestBody, response, responseHeaders, version, warnings } =\n    config;\n\n  const content = extractResponseContent(response);\n\n  const tokenUsage = response.getTokenUsage();\n  const finishReasonRaw = response.getFinishReason();\n  const finishReason = mapFinishReason(finishReasonRaw);\n\n  const textContent = response.getContent();\n  const toolCalls = response.getToolCalls();\n\n  const rawResponseBody = {\n    content: textContent,\n    finishReason: finishReasonRaw,\n    tokenUsage,\n    toolCalls,\n  };\n\n  const citations = response.getCitations?.();\n  if (citations?.length) {\n    for (const citation of citations) {\n      content.push({\n        id: String(citation.ref_id ?? citation.url),\n        sourceType: \"url\" as const,\n        title: citation.title,\n        type: \"source\" as const,\n        url: citation.url,\n      });\n    }\n  }\n\n  const intermediateFailures = response.getIntermediateFailures?.();\n\n  return {\n    content,\n    finishReason,\n    providerMetadata: {\n      [providerName]: {\n        finishReason: finishReasonRaw ?? \"unknown\",\n        finishReasonMapped: finishReason,\n        ...(intermediateFailures?.length\n          ? { intermediateFailures: intermediateFailures as JSONArray }\n          : {}),\n        ...(typeof responseHeaders?.[\"x-request-id\"] === \"string\"\n          ? { requestId: responseHeaders[\"x-request-id\"] }\n          : {}),\n        version,\n      },\n    },\n    request: {\n      body: requestBody,\n    },\n    response: {\n      body: rawResponseBody,\n      headers: responseHeaders,\n      id: response.responseId,\n      modelId,\n      timestamp: new Date(),\n    },\n    usage: mapTokenUsage(tokenUsage),\n    warnings,\n  };\n}\n\n/**\n * Builds a ModelDeployment object for the Foundation Models API SDK.\n * @param config - The strategy configuration containing deployment info and model ID.\n * @param modelVersion - Optional model version for model-based resolution.\n * @returns A ModelDeployment object for the Foundation Models API SDK.\n * @internal\n */\nexport function buildModelDeployment(\n  config: BaseModelDeploymentConfig,\n  modelVersion?: string,\n): { deploymentId: string } | { modelName: string; modelVersion?: string; resourceGroup?: string } {\n  const deploymentConfig = config.deploymentConfig;\n\n  if (\"deploymentId\" in deploymentConfig) {\n    return { deploymentId: deploymentConfig.deploymentId };\n  }\n\n  const resourceGroup =\n    \"resourceGroup\" in deploymentConfig ? deploymentConfig.resourceGroup : undefined;\n\n  return {\n    modelName: config.modelId,\n    ...(modelVersion && { modelVersion }),\n    ...(resourceGroup && { resourceGroup }),\n  };\n}\n\n/**\n * Builds and validates model parameters from multiple sources.\n * @param config - Configuration with options, mappings, and source parameters.\n * @returns The merged model parameters and validation warnings.\n * @internal\n */\nexport function buildModelParams(config: BuildModelParamsConfig): BuildModelParamsResult {\n  const { options, paramMappings, providerModelParams, settingsModelParams } = config;\n  const warnings: SharedV3Warning[] = [];\n\n  const modelParams: Record<string, unknown> = deepMerge(\n    settingsModelParams ?? {},\n    providerModelParams ?? {},\n  );\n\n  applyParameterOverrides(\n    modelParams,\n    options,\n    providerModelParams,\n    settingsModelParams,\n    paramMappings,\n  );\n\n  if (options.stopSequences && options.stopSequences.length > 0) {\n    modelParams.stop = options.stopSequences;\n  }\n\n  validateModelParamsWithWarnings(\n    {\n      frequencyPenalty: options.frequencyPenalty,\n      maxTokens: options.maxOutputTokens,\n      presencePenalty: options.presencePenalty,\n      temperature: options.temperature,\n      topP: options.topP,\n    },\n    warnings,\n  );\n\n  return { modelParams, warnings };\n}\n\n/**\n * Builds SAP AI SDK-compatible tool parameters from a JSON schema.\n * @param schema - The JSON schema to convert.\n * @returns The SAP-compatible tool parameters object.\n * @internal\n */\nexport function buildSAPToolParameters(schema: Record<string, unknown>): SAPToolParameters {\n  const schemaType = schema.type;\n\n  if (schemaType !== undefined && schemaType !== \"object\") {\n    return {\n      properties: {},\n      required: [],\n      type: \"object\",\n    };\n  }\n\n  const properties =\n    schema.properties && typeof schema.properties === \"object\"\n      ? (schema.properties as Record<string, unknown>)\n      : {};\n\n  const required =\n    Array.isArray(schema.required) && schema.required.every((item) => typeof item === \"string\")\n      ? schema.required\n      : [];\n\n  const additionalFields = Object.fromEntries(\n    Object.entries(schema).filter(\n      ([key]) => key !== \"type\" && key !== \"properties\" && key !== \"required\",\n    ),\n  );\n\n  return {\n    properties,\n    required,\n    type: \"object\",\n    ...additionalFields,\n  };\n}\n\n/**\n * Converts AI SDK response format to SAP-compatible format.\n * @param optionsResponseFormat - The AI SDK response format from call options.\n * @param settingsResponseFormat - The fallback response format from settings.\n * @returns The converted response format and any warning.\n * @internal\n */\nexport function convertResponseFormat(\n  optionsResponseFormat: LanguageModelV3CallOptions[\"responseFormat\"],\n  settingsResponseFormat?: unknown,\n): ConvertedResponseFormatResult {\n  let responseFormat: SAPResponseFormat | undefined;\n  let warning: SharedV3Warning | undefined;\n\n  if (optionsResponseFormat?.type === \"json\") {\n    responseFormat = optionsResponseFormat.schema\n      ? {\n          json_schema: {\n            description: optionsResponseFormat.description,\n            name: optionsResponseFormat.name ?? \"response\",\n            schema: optionsResponseFormat.schema as Record<string, unknown>,\n            strict: null,\n          },\n          type: \"json_schema\" as const,\n        }\n      : { type: \"json_object\" as const };\n  } else if (settingsResponseFormat) {\n    responseFormat = settingsResponseFormat as SAPResponseFormat;\n  }\n\n  if (responseFormat && responseFormat.type !== \"text\") {\n    warning = {\n      message:\n        \"responseFormat JSON mode is forwarded to the underlying model; support and schema adherence depend on the model/deployment.\",\n      type: \"other\",\n    };\n  }\n\n  return { responseFormat, warning };\n}\n\n/**\n * Converts AI SDK tools to SAP-compatible tool format.\n * @param tools - The AI SDK tools to convert.\n * @returns The converted tools and any warnings.\n * @internal\n */\nexport function convertToolsToSAPFormat<T extends SAPTool<unknown>>(\n  tools: AISDKTool[] | undefined,\n): ConvertedToolsResult<T> {\n  const warnings: SharedV3Warning[] = [];\n\n  if (!tools || tools.length === 0) {\n    return { tools: undefined, warnings };\n  }\n\n  const convertedTools = tools\n    .map((tool): null | T => {\n      if (tool.type === \"function\") {\n        const { parameters, warning } = extractToolParameters(tool as LanguageModelV3FunctionTool);\n        if (warning) {\n          warnings.push(warning);\n        }\n\n        return {\n          function: {\n            name: tool.name,\n            parameters,\n            ...(tool.description ? { description: tool.description } : {}),\n          },\n          type: \"function\",\n        } as T;\n      } else {\n        warnings.push({\n          details: \"Only 'function' tool type is supported.\",\n          feature: `tool type for ${tool.name}`,\n          type: \"unsupported\",\n        });\n        return null;\n      }\n    })\n    .filter((t): t is T => t !== null);\n\n  return {\n    tools: convertedTools.length > 0 ? convertedTools : undefined,\n    warnings,\n  };\n}\n\n/**\n * Creates a summary of Vercel AI SDK request options for error context.\n * @param options - The language model call options to summarize.\n * @returns An object summarizing the request for debugging.\n * @internal\n */\nexport function createAISDKRequestBodySummary(options: LanguageModelV3CallOptions): {\n  hasImageParts: boolean;\n  maxOutputTokens?: number;\n  promptMessages: number;\n  responseFormatType?: string;\n  seed?: number;\n  stopSequences?: number;\n  temperature?: number;\n  toolChoiceType?: string;\n  tools: number;\n  topK?: number;\n  topP?: number;\n} {\n  return {\n    hasImageParts: options.prompt.some(\n      (message) =>\n        message.role === \"user\" &&\n        message.content.some((part) => part.type === \"file\" && part.mediaType.startsWith(\"image/\")),\n    ),\n    maxOutputTokens: options.maxOutputTokens,\n    promptMessages: options.prompt.length,\n    responseFormatType: options.responseFormat?.type,\n    seed: options.seed,\n    stopSequences: options.stopSequences?.length,\n    temperature: options.temperature,\n    toolChoiceType: options.toolChoice?.type,\n    tools: options.tools?.length ?? 0,\n    topK: options.topK,\n    topP: options.topP,\n  };\n}\n\n/**\n * Creates the initial stream state for processing streaming responses.\n * @returns The initial stream state object.\n * @internal\n */\nexport function createInitialStreamState(): StreamState {\n  return {\n    activeText: false,\n    finishReason: {\n      raw: undefined,\n      unified: \"other\" as const,\n    },\n    isFirstChunk: true,\n    usage: {\n      inputTokens: {\n        cacheRead: undefined,\n        cacheWrite: undefined,\n        noCache: undefined,\n        total: undefined,\n      },\n      outputTokens: {\n        reasoning: undefined,\n        text: undefined,\n        total: undefined,\n      },\n    },\n  };\n}\n\n/**\n * Creates a ReadableStream that transforms SAP AI SDK streaming responses\n * into Vercel AI SDK LanguageModelV3StreamPart events.\n * @param config - The stream transformer configuration containing all dependencies.\n * @returns A ReadableStream of LanguageModelV3StreamPart events.\n * @internal\n */\nexport function createStreamTransformer(\n  config: StreamTransformerConfig,\n): ReadableStream<LanguageModelV3StreamPart> {\n  const {\n    convertToAISDKError,\n    idGenerator,\n    includeRawChunks,\n    modelId,\n    options,\n    providerName,\n    responseHeaders,\n    responseId,\n    sdkStream,\n    streamResponseGetCitations,\n    streamResponseGetFinishReason,\n    streamResponseGetIntermediateFailures,\n    streamResponseGetTokenUsage,\n    url,\n    version,\n    warnings,\n  } = config;\n\n  let textBlockId: null | string = null;\n  const streamState = createInitialStreamState();\n  const toolCallsInProgress = new Map<number, ToolCallInProgress>();\n\n  /**\n   * Emits tool-input-start and replays any buffered arguments as a delta.\n   * @param tc - The in-progress tool call state.\n   * @param controller - The transform stream controller to enqueue events into.\n   */\n  function emitToolInputStart(\n    tc: ToolCallInProgress,\n    controller: TransformStreamDefaultController<LanguageModelV3StreamPart>,\n  ): void {\n    if (tc.didEmitInputStart || tc.id == null) return;\n    tc.didEmitInputStart = true;\n    controller.enqueue({\n      id: tc.id,\n      toolName: tc.toolName ?? \"\",\n      type: \"tool-input-start\",\n    });\n    if (tc.arguments.length > 0) {\n      controller.enqueue({\n        delta: tc.arguments,\n        id: tc.id,\n        type: \"tool-input-delta\",\n      });\n    }\n  }\n\n  return convertAsyncIteratorToReadableStream(\n    safeIterate(sdkStream)[Symbol.asyncIterator](),\n  ).pipeThrough(\n    new TransformStream<Error | SDKStreamChunk, LanguageModelV3StreamPart>({\n      flush(controller) {\n        const toolCalls = Array.from(toolCallsInProgress.values());\n        let didEmitAnyToolCalls = false;\n\n        for (const tc of toolCalls) {\n          if (tc.didEmitCall) {\n            continue;\n          }\n\n          tc.id ??= idGenerator.generateToolCallId();\n          emitToolInputStart(tc, controller);\n\n          didEmitAnyToolCalls = true;\n          tc.didEmitCall = true;\n          controller.enqueue({ id: tc.id, type: \"tool-input-end\" });\n          controller.enqueue({\n            input: tc.arguments,\n            toolCallId: tc.id,\n            toolName: tc.toolName ?? \"\",\n            type: \"tool-call\",\n          });\n        }\n\n        if (streamState.activeText && textBlockId) {\n          controller.enqueue({ id: textBlockId, type: \"text-end\" });\n        }\n\n        const finalFinishReason = streamResponseGetFinishReason();\n        if (finalFinishReason) {\n          streamState.finishReason = mapFinishReason(finalFinishReason);\n        } else if (didEmitAnyToolCalls) {\n          streamState.finishReason = {\n            raw: undefined,\n            unified: \"tool-calls\",\n          };\n        }\n\n        const finalUsage = streamResponseGetTokenUsage();\n        if (finalUsage) {\n          const mapped = mapTokenUsage(finalUsage);\n          streamState.usage.inputTokens = mapped.inputTokens;\n          streamState.usage.outputTokens = mapped.outputTokens;\n        }\n\n        const streamCitations = streamResponseGetCitations?.();\n        if (streamCitations?.length) {\n          for (const citation of streamCitations) {\n            controller.enqueue({\n              id: String(citation.ref_id ?? citation.url),\n              sourceType: \"url\" as const,\n              title: citation.title,\n              type: \"source\",\n              url: citation.url,\n            });\n          }\n        }\n\n        const streamIntermediateFailures = streamResponseGetIntermediateFailures?.();\n\n        controller.enqueue({\n          finishReason: streamState.finishReason,\n          providerMetadata: {\n            [providerName]: {\n              finishReason: streamState.finishReason.raw,\n              ...(streamIntermediateFailures?.length\n                ? {\n                    intermediateFailures: streamIntermediateFailures as JSONArray,\n                  }\n                : {}),\n              ...(typeof responseHeaders?.[\"x-request-id\"] === \"string\"\n                ? { requestId: responseHeaders[\"x-request-id\"] }\n                : {}),\n              responseId,\n              version,\n            },\n          },\n          type: \"finish\",\n          usage: streamState.usage,\n        });\n      },\n\n      start(controller) {\n        controller.enqueue({\n          type: \"stream-start\",\n          warnings: [...warnings],\n        });\n      },\n\n      transform(chunk, controller) {\n        if (chunk instanceof Error) {\n          const aiError = convertToAISDKError(chunk, {\n            operation: \"doStream\",\n            requestBody: createAISDKRequestBodySummary(options),\n            url,\n          });\n          controller.enqueue({\n            error: aiError instanceof Error ? aiError : new Error(String(aiError)),\n            type: \"error\",\n          });\n          controller.terminate();\n          return;\n        }\n\n        if (includeRawChunks) {\n          controller.enqueue({\n            rawValue: (chunk as { _data?: unknown })._data ?? chunk,\n            type: \"raw\",\n          });\n        }\n\n        if (streamState.isFirstChunk) {\n          streamState.isFirstChunk = false;\n          controller.enqueue({\n            id: responseId,\n            modelId,\n            timestamp: new Date(),\n            type: \"response-metadata\",\n          });\n        }\n\n        const deltaToolCalls = chunk.getDeltaToolCalls();\n        if (Array.isArray(deltaToolCalls) && deltaToolCalls.length > 0) {\n          streamState.finishReason = {\n            raw: undefined,\n            unified: \"tool-calls\",\n          };\n        }\n\n        const deltaContent = chunk.getDeltaContent();\n        if (\n          typeof deltaContent === \"string\" &&\n          deltaContent.length > 0 &&\n          streamState.finishReason.unified !== \"tool-calls\"\n        ) {\n          if (!streamState.activeText) {\n            textBlockId = idGenerator.generateTextBlockId();\n            controller.enqueue({ id: textBlockId, type: \"text-start\" });\n            streamState.activeText = true;\n          }\n          if (textBlockId) {\n            controller.enqueue({\n              delta: deltaContent,\n              id: textBlockId,\n              type: \"text-delta\",\n            });\n          }\n        }\n\n        if (Array.isArray(deltaToolCalls) && deltaToolCalls.length > 0) {\n          for (const toolCallChunk of deltaToolCalls) {\n            const index = toolCallChunk.index;\n            if (typeof index !== \"number\" || !Number.isFinite(index)) {\n              continue;\n            }\n\n            if (!toolCallsInProgress.has(index)) {\n              toolCallsInProgress.set(index, {\n                arguments: \"\",\n                didEmitCall: false,\n                didEmitInputStart: false,\n                id:\n                  typeof toolCallChunk.id === \"string\" && toolCallChunk.id.length > 0\n                    ? toolCallChunk.id\n                    : undefined,\n                toolName: toolCallChunk.function?.name,\n              });\n            }\n\n            const tc = toolCallsInProgress.get(index);\n            if (!tc) continue;\n\n            if (\n              typeof toolCallChunk.id === \"string\" &&\n              toolCallChunk.id.length > 0 &&\n              tc.id === undefined\n            ) {\n              tc.id = toolCallChunk.id;\n            }\n\n            const nextToolName = toolCallChunk.function?.name;\n            if (typeof nextToolName === \"string\" && nextToolName.length > 0) {\n              tc.toolName = nextToolName;\n            }\n\n            if (!tc.didEmitInputStart && tc.toolName != null && tc.id != null) {\n              emitToolInputStart(tc, controller);\n            }\n\n            const argumentsDelta = toolCallChunk.function?.arguments;\n            if (typeof argumentsDelta === \"string\" && argumentsDelta.length > 0) {\n              tc.arguments += argumentsDelta;\n\n              if (tc.didEmitInputStart && tc.id != null) {\n                controller.enqueue({\n                  delta: argumentsDelta,\n                  id: tc.id,\n                  type: \"tool-input-delta\",\n                });\n              }\n            }\n          }\n        }\n\n        const chunkFinishReason = chunk.getFinishReason();\n        if (chunkFinishReason) {\n          streamState.finishReason = mapFinishReason(chunkFinishReason);\n\n          if (streamState.finishReason.unified === \"tool-calls\") {\n            const toolCalls = Array.from(toolCallsInProgress.values());\n            for (const tc of toolCalls) {\n              if (tc.didEmitCall) {\n                continue;\n              }\n\n              tc.id ??= idGenerator.generateToolCallId();\n              emitToolInputStart(tc, controller);\n\n              tc.didEmitCall = true;\n              controller.enqueue({ id: tc.id, type: \"tool-input-end\" });\n              controller.enqueue({\n                input: tc.arguments,\n                toolCallId: tc.id,\n                toolName: tc.toolName ?? \"\",\n                type: \"tool-call\",\n              });\n            }\n\n            if (streamState.activeText && textBlockId) {\n              controller.enqueue({ id: textBlockId, type: \"text-end\" });\n              streamState.activeText = false;\n            }\n          }\n        }\n      },\n    }),\n  );\n}\n\n/**\n * Extracts content (text and tool calls) from SDK response.\n * @param response - SDK response object.\n * @returns Content array for LanguageModelV3GenerateResult.\n * @internal\n */\nexport function extractResponseContent(response: SDKResponse): LanguageModelV3Content[] {\n  const content: LanguageModelV3Content[] = [];\n\n  const textContent = response.getContent();\n  if (textContent) {\n    content.push({\n      text: textContent,\n      type: \"text\",\n    });\n  }\n\n  const toolCalls = response.getToolCalls();\n  if (toolCalls) {\n    for (const toolCall of toolCalls) {\n      content.push({\n        input: toolCall.function.arguments,\n        toolCallId: toolCall.id,\n        toolName: toolCall.function.name,\n        type: \"tool-call\",\n      });\n    }\n  }\n\n  return content;\n}\n\n/**\n * Extracts SAP-compatible tool parameters from an AI SDK function tool.\n * @param tool - The AI SDK function tool to extract parameters from.\n * @returns The extracted parameters and optional warning.\n * @internal\n */\nexport function extractToolParameters(tool: LanguageModelV3FunctionTool): ExtractedToolParameters {\n  const inputSchema = tool.inputSchema as Record<string, unknown> | undefined;\n  const toolWithParams = tool as FunctionToolWithParameters;\n\n  if (toolWithParams.parameters && isZodSchema(toolWithParams.parameters)) {\n    try {\n      const jsonSchema = z.toJSONSchema(toolWithParams.parameters);\n      const schemaRecord = jsonSchema as Record<string, unknown>;\n      delete schemaRecord.$schema;\n      return { parameters: buildSAPToolParameters(schemaRecord) };\n    } catch (error) {\n      return {\n        parameters: buildSAPToolParameters({}),\n        warning: {\n          details: `Failed to convert tool Zod schema: ${error instanceof Error ? error.message : String(error)}. Falling back to empty object schema.`,\n          feature: `tool schema conversion for ${tool.name}`,\n          type: \"unsupported\",\n        },\n      };\n    }\n  }\n\n  if (inputSchema && hasKeys(inputSchema)) {\n    const hasProperties =\n      inputSchema.properties &&\n      typeof inputSchema.properties === \"object\" &&\n      hasKeys(inputSchema.properties);\n\n    if (hasProperties) {\n      return { parameters: buildSAPToolParameters(inputSchema) };\n    }\n  }\n\n  return { parameters: buildSAPToolParameters({}) };\n}\n\n/**\n * Checks if an object has a callable parse method.\n * @param obj - The object to check for a parse method.\n * @returns True if the object has a callable parse method.\n * @internal\n */\nexport function hasCallableParse(\n  obj: Record<string, unknown>,\n): obj is Record<string, unknown> & { parse: (...args: unknown[]) => unknown } {\n  return typeof obj.parse === \"function\";\n}\n\n/**\n * Checks if an object has at least one own enumerable property.\n * @param obj - The object to check.\n * @returns True if the object has one or more keys.\n * @internal\n */\nexport function hasKeys(obj: object): boolean {\n  return Object.keys(obj).length > 0;\n}\n\n/**\n * Type guard for Zod schema objects.\n * @param obj - The object to check.\n * @returns True if the object is a Zod schema.\n * @internal\n */\nexport function isZodSchema(obj: unknown): obj is ZodType {\n  if (obj === null || typeof obj !== \"object\") {\n    return false;\n  }\n  const record = obj as Record<string, unknown>;\n  return \"_def\" in record && \"parse\" in record && hasCallableParse(record);\n}\n\n/**\n * Maps provider finish reasons to Vercel AI SDK LanguageModelV3FinishReason.\n * @param reason - The raw finish reason string from the provider.\n * @returns The unified finish reason with both raw and unified representations.\n * @internal\n */\nexport function mapFinishReason(reason: null | string | undefined): LanguageModelV3FinishReason {\n  const raw = reason ?? undefined;\n\n  if (!reason) {\n    return { raw, unified: \"other\" };\n  }\n\n  switch (reason.toLowerCase()) {\n    case \"content_filter\":\n      return { raw, unified: \"content-filter\" };\n    case \"end_turn\":\n    case \"eos\":\n    case \"stop\":\n    case \"stop_sequence\":\n      return { raw, unified: \"stop\" };\n    case \"error\":\n      return { raw, unified: \"error\" };\n    case \"function_call\":\n    case \"tool_call\":\n    case \"tool_calls\":\n      return { raw, unified: \"tool-calls\" };\n    case \"length\":\n    case \"max_tokens\":\n    case \"max_tokens_reached\":\n      return { raw, unified: \"length\" };\n    default:\n      return { raw, unified: \"other\" };\n  }\n}\n\n/**\n * Maps SAP AI SDK token usage to Vercel AI SDK LanguageModelV3Usage.\n * @param tokenUsage - Raw token usage from the SAP SDK response.\n * @returns Mapped usage with input/output token breakdowns.\n * @internal\n */\nexport function mapTokenUsage(tokenUsage: null | SDKTokenUsage | undefined): LanguageModelV3Usage {\n  const cachedTokens = tokenUsage?.prompt_tokens_details?.cached_tokens;\n  const reasoningTokens = tokenUsage?.completion_tokens_details?.reasoning_tokens;\n\n  return {\n    inputTokens: {\n      cacheRead: cachedTokens,\n      cacheWrite: undefined,\n      noCache:\n        cachedTokens != null\n          ? (tokenUsage?.prompt_tokens ?? 0) - cachedTokens\n          : tokenUsage?.prompt_tokens,\n      total: tokenUsage?.prompt_tokens,\n    },\n    outputTokens: {\n      reasoning: reasoningTokens,\n      text:\n        reasoningTokens != null\n          ? (tokenUsage?.completion_tokens ?? 0) - reasoningTokens\n          : tokenUsage?.completion_tokens,\n      total: tokenUsage?.completion_tokens,\n    },\n  };\n}\n\n/**\n * Maps Vercel AI SDK toolChoice to SAP Foundation Models SDK tool_choice format.\n * @param toolChoice - The Vercel AI SDK tool choice.\n * @returns The SAP SDK tool_choice format, or undefined if no mapping needed.\n * @internal\n */\nexport function mapToolChoice(toolChoice: AISDKToolChoice | undefined): SAPToolChoice | undefined {\n  if (!toolChoice) {\n    return undefined;\n  }\n\n  switch (toolChoice.type) {\n    case \"auto\":\n      return \"auto\";\n    case \"none\":\n      return \"none\";\n    case \"required\":\n      return \"required\";\n    case \"tool\":\n      return {\n        function: { name: toolChoice.toolName },\n        type: \"function\",\n      };\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Converts SAP AI SDK embedding to Vercel AI SDK format.\n * @param embedding - The embedding as number array or base64 string.\n * @returns The normalized embedding as a number array.\n * @internal\n */\nexport function normalizeEmbedding(embedding: number[] | string): EmbeddingModelV3Embedding {\n  if (Array.isArray(embedding)) {\n    return embedding;\n  }\n  const buffer = Buffer.from(embedding, \"base64\");\n  const float32Array = new Float32Array(\n    buffer.buffer,\n    buffer.byteOffset,\n    buffer.length / Float32Array.BYTES_PER_ELEMENT,\n  );\n  return Array.from(float32Array);\n}\n\n/**\n * Prepares embedding call by parsing provider options and validating input count.\n * @param config - Base embedding configuration.\n * @param options - Embedding model call options.\n * @returns Parsed SAP options and provider name.\n * @throws {TooManyEmbeddingValuesForCallError} When input count exceeds maximum.\n * @internal\n */\nexport async function prepareEmbeddingCall(\n  config: BaseEmbeddingConfig,\n  options: EmbeddingModelV3CallOptions,\n): Promise<{ embeddingOptions: EmbeddingProviderOptions | undefined; providerName: string }> {\n  const { maxEmbeddingsPerCall, modelId, provider } = config;\n  const { providerOptions, values } = options;\n\n  const providerName = getProviderName(provider);\n  const sapOptions = await parseProviderOptions({\n    provider: providerName,\n    providerOptions,\n    schema: sapAIEmbeddingProviderOptions,\n  });\n\n  if (values.length > maxEmbeddingsPerCall) {\n    throw new TooManyEmbeddingValuesForCallError({\n      maxEmbeddingsPerCall,\n      modelId,\n      provider,\n      values,\n    });\n  }\n\n  return { embeddingOptions: sapOptions, providerName };\n}\n\n/**\n * Wraps an async iterable to catch iteration errors and yield them as values.\n * @param iterable - The async iterable to wrap.\n * @yields {Error | T} Original values or Error instances for caught exceptions.\n * @internal\n */\nasync function* safeIterate<T>(iterable: AsyncIterable<T>): AsyncGenerator<Error | T> {\n  try {\n    yield* iterable;\n  } catch (error) {\n    yield error instanceof Error ? error : new Error(String(error));\n  }\n}\n"],"mappings":";;;;;;;;;AAqBA,SAAS,0CAA0C;AACnD,SAAS,sCAAsC,4BAA4B;AAC3E,SAAS,SAAS;AA8TX,IAAM,oBAAN,MAAwB;AAAA;AAAA;AAAA;AAAA,EAI7B,qBAA6B;AAC3B,WAAO,OAAO,WAAW;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA,EAKA,sBAA8B;AAC5B,WAAO,OAAO,WAAW;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA,EAKA,qBAA6B;AAC3B,WAAO,OAAO,WAAW;AAAA,EAC3B;AACF;AAWO,SAAS,wBACd,aACA,SACA,gBACA,qBACA,UACM;AACN,aAAW,WAAW,UAAU;AAC9B,UAAM,SACH,QAAQ,YAAY,QAAQ,QAAQ,SAAS,IAAI,YACjD,QAAQ,eAAe,iBAAiB,QAAQ,YAAY,IAAI,YAChE,QAAQ,eAAe,sBAAsB,QAAQ,YAAY,IAAI;AAExE,QAAI,UAAU,QAAW;AACvB,kBAAY,QAAQ,SAAS,IAAI;AAAA,IACnC;AAEA,QAAI,QAAQ,gBAAgB,QAAQ,iBAAiB,QAAQ,WAAW;AAEtE,aAAO,YAAY,QAAQ,YAAY;AAAA,IACzC;AAAA,EACF;AACF;AAQO,SAAS,qBAAqB,QAAuD;AAC1F,QAAM,EAAE,YAAY,SAAS,cAAc,aAAa,QAAQ,IAAI;AAEpE,QAAM,mBAA6C;AAAA,IACjD,CAAC,YAAY,GAAG;AAAA,MACd,OAAO;AAAA,MACP;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,OAAO,EAAE,QAAQ,YAAY;AAAA,IAC7B,UAAU,CAAC;AAAA,EACb;AACF;AAQO,SAAS,oBAAoB,QAA6D;AAC/F,QAAM,EAAE,SAAS,cAAc,aAAa,UAAU,iBAAiB,SAAS,SAAS,IACvF;AAEF,QAAM,UAAU,uBAAuB,QAAQ;AAE/C,QAAM,aAAa,SAAS,cAAc;AAC1C,QAAM,kBAAkB,SAAS,gBAAgB;AACjD,QAAM,eAAe,gBAAgB,eAAe;AAEpD,QAAM,cAAc,SAAS,WAAW;AACxC,QAAM,YAAY,SAAS,aAAa;AAExC,QAAM,kBAAkB;AAAA,IACtB,SAAS;AAAA,IACT,cAAc;AAAA,IACd;AAAA,IACA;AAAA,EACF;AAEA,QAAM,YAAY,SAAS,eAAe;AAC1C,MAAI,WAAW,QAAQ;AACrB,eAAW,YAAY,WAAW;AAChC,cAAQ,KAAK;AAAA,QACX,IAAI,OAAO,SAAS,UAAU,SAAS,GAAG;AAAA,QAC1C,YAAY;AAAA,QACZ,OAAO,SAAS;AAAA,QAChB,MAAM;AAAA,QACN,KAAK,SAAS;AAAA,MAChB,CAAC;AAAA,IACH;AAAA,EACF;AAEA,QAAM,uBAAuB,SAAS,0BAA0B;AAEhE,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,kBAAkB;AAAA,MAChB,CAAC,YAAY,GAAG;AAAA,QACd,cAAc,mBAAmB;AAAA,QACjC,oBAAoB;AAAA,QACpB,GAAI,sBAAsB,SACtB,EAAE,qBAAwD,IAC1D,CAAC;AAAA,QACL,GAAI,OAAO,kBAAkB,cAAc,MAAM,WAC7C,EAAE,WAAW,gBAAgB,cAAc,EAAE,IAC7C,CAAC;AAAA,QACL;AAAA,MACF;AAAA,IACF;AAAA,IACA,SAAS;AAAA,MACP,MAAM;AAAA,IACR;AAAA,IACA,UAAU;AAAA,MACR,MAAM;AAAA,MACN,SAAS;AAAA,MACT,IAAI,SAAS;AAAA,MACb;AAAA,MACA,WAAW,oBAAI,KAAK;AAAA,IACtB;AAAA,IACA,OAAO,cAAc,UAAU;AAAA,IAC/B;AAAA,EACF;AACF;AASO,SAAS,qBACd,QACA,cACiG;AACjG,QAAM,mBAAmB,OAAO;AAEhC,MAAI,kBAAkB,kBAAkB;AACtC,WAAO,EAAE,cAAc,iBAAiB,aAAa;AAAA,EACvD;AAEA,QAAM,gBACJ,mBAAmB,mBAAmB,iBAAiB,gBAAgB;AAEzE,SAAO;AAAA,IACL,WAAW,OAAO;AAAA,IAClB,GAAI,gBAAgB,EAAE,aAAa;AAAA,IACnC,GAAI,iBAAiB,EAAE,cAAc;AAAA,EACvC;AACF;AAQO,SAAS,iBAAiB,QAAwD;AACvF,QAAM,EAAE,SAAS,eAAe,qBAAqB,oBAAoB,IAAI;AAC7E,QAAM,WAA8B,CAAC;AAErC,QAAM,cAAuC;AAAA,IAC3C,uBAAuB,CAAC;AAAA,IACxB,uBAAuB,CAAC;AAAA,EAC1B;AAEA;AAAA,IACE;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,MAAI,QAAQ,iBAAiB,QAAQ,cAAc,SAAS,GAAG;AAC7D,gBAAY,OAAO,QAAQ;AAAA,EAC7B;AAEA;AAAA,IACE;AAAA,MACE,kBAAkB,QAAQ;AAAA,MAC1B,WAAW,QAAQ;AAAA,MACnB,iBAAiB,QAAQ;AAAA,MACzB,aAAa,QAAQ;AAAA,MACrB,MAAM,QAAQ;AAAA,IAChB;AAAA,IACA;AAAA,EACF;AAEA,SAAO,EAAE,aAAa,SAAS;AACjC;AAQO,SAAS,uBAAuB,QAAoD;AACzF,QAAM,aAAa,OAAO;AAE1B,MAAI,eAAe,UAAa,eAAe,UAAU;AACvD,WAAO;AAAA,MACL,YAAY,CAAC;AAAA,MACb,UAAU,CAAC;AAAA,MACX,MAAM;AAAA,IACR;AAAA,EACF;AAEA,QAAM,aACJ,OAAO,cAAc,OAAO,OAAO,eAAe,WAC7C,OAAO,aACR,CAAC;AAEP,QAAM,WACJ,MAAM,QAAQ,OAAO,QAAQ,KAAK,OAAO,SAAS,MAAM,CAAC,SAAS,OAAO,SAAS,QAAQ,IACtF,OAAO,WACP,CAAC;AAEP,QAAM,mBAAmB,OAAO;AAAA,IAC9B,OAAO,QAAQ,MAAM,EAAE;AAAA,MACrB,CAAC,CAAC,GAAG,MAAM,QAAQ,UAAU,QAAQ,gBAAgB,QAAQ;AAAA,IAC/D;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,MAAM;AAAA,IACN,GAAG;AAAA,EACL;AACF;AASO,SAAS,sBACd,uBACA,wBAC+B;AAC/B,MAAI;AACJ,MAAI;AAEJ,MAAI,uBAAuB,SAAS,QAAQ;AAC1C,qBAAiB,sBAAsB,SACnC;AAAA,MACE,aAAa;AAAA,QACX,aAAa,sBAAsB;AAAA,QACnC,MAAM,sBAAsB,QAAQ;AAAA,QACpC,QAAQ,sBAAsB;AAAA,QAC9B,QAAQ;AAAA,MACV;AAAA,MACA,MAAM;AAAA,IACR,IACA,EAAE,MAAM,cAAuB;AAAA,EACrC,WAAW,wBAAwB;AACjC,qBAAiB;AAAA,EACnB;AAEA,MAAI,kBAAkB,eAAe,SAAS,QAAQ;AACpD,cAAU;AAAA,MACR,SACE;AAAA,MACF,MAAM;AAAA,IACR;AAAA,EACF;AAEA,SAAO,EAAE,gBAAgB,QAAQ;AACnC;AAQO,SAAS,wBACd,OACyB;AACzB,QAAM,WAA8B,CAAC;AAErC,MAAI,CAAC,SAAS,MAAM,WAAW,GAAG;AAChC,WAAO,EAAE,OAAO,QAAW,SAAS;AAAA,EACtC;AAEA,QAAM,iBAAiB,MACpB,IAAI,CAAC,SAAmB;AACvB,QAAI,KAAK,SAAS,YAAY;AAC5B,YAAM,EAAE,YAAY,QAAQ,IAAI,sBAAsB,IAAmC;AACzF,UAAI,SAAS;AACX,iBAAS,KAAK,OAAO;AAAA,MACvB;AAEA,aAAO;AAAA,QACL,UAAU;AAAA,UACR,MAAM,KAAK;AAAA,UACX;AAAA,UACA,GAAI,KAAK,cAAc,EAAE,aAAa,KAAK,YAAY,IAAI,CAAC;AAAA,QAC9D;AAAA,QACA,MAAM;AAAA,MACR;AAAA,IACF,OAAO;AACL,eAAS,KAAK;AAAA,QACZ,SAAS;AAAA,QACT,SAAS,iBAAiB,KAAK,IAAI;AAAA,QACnC,MAAM;AAAA,MACR,CAAC;AACD,aAAO;AAAA,IACT;AAAA,EACF,CAAC,EACA,OAAO,CAAC,MAAc,MAAM,IAAI;AAEnC,SAAO;AAAA,IACL,OAAO,eAAe,SAAS,IAAI,iBAAiB;AAAA,IACpD;AAAA,EACF;AACF;AAQO,SAAS,8BAA8B,SAY5C;AACA,SAAO;AAAA,IACL,eAAe,QAAQ,OAAO;AAAA,MAC5B,CAAC,YACC,QAAQ,SAAS,UACjB,QAAQ,QAAQ,KAAK,CAAC,SAAS,KAAK,SAAS,UAAU,KAAK,UAAU,WAAW,QAAQ,CAAC;AAAA,IAC9F;AAAA,IACA,iBAAiB,QAAQ;AAAA,IACzB,gBAAgB,QAAQ,OAAO;AAAA,IAC/B,oBAAoB,QAAQ,gBAAgB;AAAA,IAC5C,MAAM,QAAQ;AAAA,IACd,eAAe,QAAQ,eAAe;AAAA,IACtC,aAAa,QAAQ;AAAA,IACrB,gBAAgB,QAAQ,YAAY;AAAA,IACpC,OAAO,QAAQ,OAAO,UAAU;AAAA,IAChC,MAAM,QAAQ;AAAA,IACd,MAAM,QAAQ;AAAA,EAChB;AACF;AAOO,SAAS,2BAAwC;AACtD,SAAO;AAAA,IACL,YAAY;AAAA,IACZ,cAAc;AAAA,MACZ,KAAK;AAAA,MACL,SAAS;AAAA,IACX;AAAA,IACA,cAAc;AAAA,IACd,OAAO;AAAA,MACL,aAAa;AAAA,QACX,WAAW;AAAA,QACX,YAAY;AAAA,QACZ,SAAS;AAAA,QACT,OAAO;AAAA,MACT;AAAA,MACA,cAAc;AAAA,QACZ,WAAW;AAAA,QACX,MAAM;AAAA,QACN,OAAO;AAAA,MACT;AAAA,IACF;AAAA,EACF;AACF;AASO,SAAS,wBACd,QAC2C;AAC3C,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AAEJ,MAAI,cAA6B;AACjC,QAAM,cAAc,yBAAyB;AAC7C,QAAM,sBAAsB,oBAAI,IAAgC;AAOhE,WAAS,mBACP,IACA,YACM;AACN,QAAI,GAAG,qBAAqB,GAAG,MAAM,KAAM;AAC3C,OAAG,oBAAoB;AACvB,eAAW,QAAQ;AAAA,MACjB,IAAI,GAAG;AAAA,MACP,UAAU,GAAG,YAAY;AAAA,MACzB,MAAM;AAAA,IACR,CAAC;AACD,QAAI,GAAG,UAAU,SAAS,GAAG;AAC3B,iBAAW,QAAQ;AAAA,QACjB,OAAO,GAAG;AAAA,QACV,IAAI,GAAG;AAAA,QACP,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AAAA,IACL,YAAY,SAAS,EAAE,OAAO,aAAa,EAAE;AAAA,EAC/C,EAAE;AAAA,IACA,IAAI,gBAAmE;AAAA,MACrE,MAAM,YAAY;AAChB,cAAM,YAAY,MAAM,KAAK,oBAAoB,OAAO,CAAC;AACzD,YAAI,sBAAsB;AAE1B,mBAAW,MAAM,WAAW;AAC1B,cAAI,GAAG,aAAa;AAClB;AAAA,UACF;AAEA,aAAG,OAAO,YAAY,mBAAmB;AACzC,6BAAmB,IAAI,UAAU;AAEjC,gCAAsB;AACtB,aAAG,cAAc;AACjB,qBAAW,QAAQ,EAAE,IAAI,GAAG,IAAI,MAAM,iBAAiB,CAAC;AACxD,qBAAW,QAAQ;AAAA,YACjB,OAAO,GAAG;AAAA,YACV,YAAY,GAAG;AAAA,YACf,UAAU,GAAG,YAAY;AAAA,YACzB,MAAM;AAAA,UACR,CAAC;AAAA,QACH;AAEA,YAAI,YAAY,cAAc,aAAa;AACzC,qBAAW,QAAQ,EAAE,IAAI,aAAa,MAAM,WAAW,CAAC;AAAA,QAC1D;AAEA,cAAM,oBAAoB,8BAA8B;AACxD,YAAI,mBAAmB;AACrB,sBAAY,eAAe,gBAAgB,iBAAiB;AAAA,QAC9D,WAAW,qBAAqB;AAC9B,sBAAY,eAAe;AAAA,YACzB,KAAK;AAAA,YACL,SAAS;AAAA,UACX;AAAA,QACF;AAEA,cAAM,aAAa,4BAA4B;AAC/C,YAAI,YAAY;AACd,gBAAM,SAAS,cAAc,UAAU;AACvC,sBAAY,MAAM,cAAc,OAAO;AACvC,sBAAY,MAAM,eAAe,OAAO;AAAA,QAC1C;AAEA,cAAM,kBAAkB,6BAA6B;AACrD,YAAI,iBAAiB,QAAQ;AAC3B,qBAAW,YAAY,iBAAiB;AACtC,uBAAW,QAAQ;AAAA,cACjB,IAAI,OAAO,SAAS,UAAU,SAAS,GAAG;AAAA,cAC1C,YAAY;AAAA,cACZ,OAAO,SAAS;AAAA,cAChB,MAAM;AAAA,cACN,KAAK,SAAS;AAAA,YAChB,CAAC;AAAA,UACH;AAAA,QACF;AAEA,cAAM,6BAA6B,wCAAwC;AAE3E,mBAAW,QAAQ;AAAA,UACjB,cAAc,YAAY;AAAA,UAC1B,kBAAkB;AAAA,YAChB,CAAC,YAAY,GAAG;AAAA,cACd,cAAc,YAAY,aAAa;AAAA,cACvC,GAAI,4BAA4B,SAC5B;AAAA,gBACE,sBAAsB;AAAA,cACxB,IACA,CAAC;AAAA,cACL,GAAI,OAAO,kBAAkB,cAAc,MAAM,WAC7C,EAAE,WAAW,gBAAgB,cAAc,EAAE,IAC7C,CAAC;AAAA,cACL;AAAA,cACA;AAAA,YACF;AAAA,UACF;AAAA,UACA,MAAM;AAAA,UACN,OAAO,YAAY;AAAA,QACrB,CAAC;AAAA,MACH;AAAA,MAEA,MAAM,YAAY;AAChB,mBAAW,QAAQ;AAAA,UACjB,MAAM;AAAA,UACN,UAAU,CAAC,GAAG,QAAQ;AAAA,QACxB,CAAC;AAAA,MACH;AAAA,MAEA,UAAU,OAAO,YAAY;AAC3B,YAAI,iBAAiB,OAAO;AAC1B,gBAAM,UAAU,oBAAoB,OAAO;AAAA,YACzC,WAAW;AAAA,YACX,aAAa,8BAA8B,OAAO;AAAA,YAClD;AAAA,UACF,CAAC;AACD,qBAAW,QAAQ;AAAA,YACjB,OAAO,mBAAmB,QAAQ,UAAU,IAAI,MAAM,OAAO,OAAO,CAAC;AAAA,YACrE,MAAM;AAAA,UACR,CAAC;AACD,qBAAW,UAAU;AACrB;AAAA,QACF;AAEA,YAAI,kBAAkB;AACpB,qBAAW,QAAQ;AAAA,YACjB,UAAW,MAA8B,SAAS;AAAA,YAClD,MAAM;AAAA,UACR,CAAC;AAAA,QACH;AAEA,YAAI,YAAY,cAAc;AAC5B,sBAAY,eAAe;AAC3B,qBAAW,QAAQ;AAAA,YACjB,IAAI;AAAA,YACJ;AAAA,YACA,WAAW,oBAAI,KAAK;AAAA,YACpB,MAAM;AAAA,UACR,CAAC;AAAA,QACH;AAEA,cAAM,iBAAiB,MAAM,kBAAkB;AAC/C,YAAI,MAAM,QAAQ,cAAc,KAAK,eAAe,SAAS,GAAG;AAC9D,sBAAY,eAAe;AAAA,YACzB,KAAK;AAAA,YACL,SAAS;AAAA,UACX;AAAA,QACF;AAEA,cAAM,eAAe,MAAM,gBAAgB;AAC3C,YACE,OAAO,iBAAiB,YACxB,aAAa,SAAS,KACtB,YAAY,aAAa,YAAY,cACrC;AACA,cAAI,CAAC,YAAY,YAAY;AAC3B,0BAAc,YAAY,oBAAoB;AAC9C,uBAAW,QAAQ,EAAE,IAAI,aAAa,MAAM,aAAa,CAAC;AAC1D,wBAAY,aAAa;AAAA,UAC3B;AACA,cAAI,aAAa;AACf,uBAAW,QAAQ;AAAA,cACjB,OAAO;AAAA,cACP,IAAI;AAAA,cACJ,MAAM;AAAA,YACR,CAAC;AAAA,UACH;AAAA,QACF;AAEA,YAAI,MAAM,QAAQ,cAAc,KAAK,eAAe,SAAS,GAAG;AAC9D,qBAAW,iBAAiB,gBAAgB;AAC1C,kBAAM,QAAQ,cAAc;AAC5B,gBAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,GAAG;AACxD;AAAA,YACF;AAEA,gBAAI,CAAC,oBAAoB,IAAI,KAAK,GAAG;AACnC,kCAAoB,IAAI,OAAO;AAAA,gBAC7B,WAAW;AAAA,gBACX,aAAa;AAAA,gBACb,mBAAmB;AAAA,gBACnB,IACE,OAAO,cAAc,OAAO,YAAY,cAAc,GAAG,SAAS,IAC9D,cAAc,KACd;AAAA,gBACN,UAAU,cAAc,UAAU;AAAA,cACpC,CAAC;AAAA,YACH;AAEA,kBAAM,KAAK,oBAAoB,IAAI,KAAK;AACxC,gBAAI,CAAC,GAAI;AAET,gBACE,OAAO,cAAc,OAAO,YAC5B,cAAc,GAAG,SAAS,KAC1B,GAAG,OAAO,QACV;AACA,iBAAG,KAAK,cAAc;AAAA,YACxB;AAEA,kBAAM,eAAe,cAAc,UAAU;AAC7C,gBAAI,OAAO,iBAAiB,YAAY,aAAa,SAAS,GAAG;AAC/D,iBAAG,WAAW;AAAA,YAChB;AAEA,gBAAI,CAAC,GAAG,qBAAqB,GAAG,YAAY,QAAQ,GAAG,MAAM,MAAM;AACjE,iCAAmB,IAAI,UAAU;AAAA,YACnC;AAEA,kBAAM,iBAAiB,cAAc,UAAU;AAC/C,gBAAI,OAAO,mBAAmB,YAAY,eAAe,SAAS,GAAG;AACnE,iBAAG,aAAa;AAEhB,kBAAI,GAAG,qBAAqB,GAAG,MAAM,MAAM;AACzC,2BAAW,QAAQ;AAAA,kBACjB,OAAO;AAAA,kBACP,IAAI,GAAG;AAAA,kBACP,MAAM;AAAA,gBACR,CAAC;AAAA,cACH;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAEA,cAAM,oBAAoB,MAAM,gBAAgB;AAChD,YAAI,mBAAmB;AACrB,sBAAY,eAAe,gBAAgB,iBAAiB;AAE5D,cAAI,YAAY,aAAa,YAAY,cAAc;AACrD,kBAAM,YAAY,MAAM,KAAK,oBAAoB,OAAO,CAAC;AACzD,uBAAW,MAAM,WAAW;AAC1B,kBAAI,GAAG,aAAa;AAClB;AAAA,cACF;AAEA,iBAAG,OAAO,YAAY,mBAAmB;AACzC,iCAAmB,IAAI,UAAU;AAEjC,iBAAG,cAAc;AACjB,yBAAW,QAAQ,EAAE,IAAI,GAAG,IAAI,MAAM,iBAAiB,CAAC;AACxD,yBAAW,QAAQ;AAAA,gBACjB,OAAO,GAAG;AAAA,gBACV,YAAY,GAAG;AAAA,gBACf,UAAU,GAAG,YAAY;AAAA,gBACzB,MAAM;AAAA,cACR,CAAC;AAAA,YACH;AAEA,gBAAI,YAAY,cAAc,aAAa;AACzC,yBAAW,QAAQ,EAAE,IAAI,aAAa,MAAM,WAAW,CAAC;AACxD,0BAAY,aAAa;AAAA,YAC3B;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AACF;AAQO,SAAS,uBAAuB,UAAiD;AACtF,QAAM,UAAoC,CAAC;AAE3C,QAAM,cAAc,SAAS,WAAW;AACxC,MAAI,aAAa;AACf,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,MAAM;AAAA,IACR,CAAC;AAAA,EACH;AAEA,QAAM,YAAY,SAAS,aAAa;AACxC,MAAI,WAAW;AACb,eAAW,YAAY,WAAW;AAChC,cAAQ,KAAK;AAAA,QACX,OAAO,SAAS,SAAS;AAAA,QACzB,YAAY,SAAS;AAAA,QACrB,UAAU,SAAS,SAAS;AAAA,QAC5B,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AACT;AAQO,SAAS,sBAAsB,MAA4D;AAChG,QAAM,cAAc,KAAK;AACzB,QAAM,iBAAiB;AAEvB,MAAI,eAAe,cAAc,YAAY,eAAe,UAAU,GAAG;AACvE,QAAI;AACF,YAAM,aAAa,EAAE,aAAa,eAAe,UAAU;AAC3D,YAAM,eAAe;AACrB,aAAO,aAAa;AACpB,aAAO,EAAE,YAAY,uBAAuB,YAAY,EAAE;AAAA,IAC5D,SAAS,OAAO;AACd,aAAO;AAAA,QACL,YAAY,uBAAuB,CAAC,CAAC;AAAA,QACrC,SAAS;AAAA,UACP,SAAS,sCAAsC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,UACrG,SAAS,8BAA8B,KAAK,IAAI;AAAA,UAChD,MAAM;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,MAAI,eAAe,QAAQ,WAAW,GAAG;AACvC,UAAM,gBACJ,YAAY,cACZ,OAAO,YAAY,eAAe,YAClC,QAAQ,YAAY,UAAU;AAEhC,QAAI,eAAe;AACjB,aAAO,EAAE,YAAY,uBAAuB,WAAW,EAAE;AAAA,IAC3D;AAAA,EACF;AAEA,SAAO,EAAE,YAAY,uBAAuB,CAAC,CAAC,EAAE;AAClD;AAQO,SAAS,iBACd,KAC6E;AAC7E,SAAO,OAAO,IAAI,UAAU;AAC9B;AAQO,SAAS,QAAQ,KAAsB;AAC5C,SAAO,OAAO,KAAK,GAAG,EAAE,SAAS;AACnC;AAQO,SAAS,YAAY,KAA8B;AACxD,MAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU;AAC3C,WAAO;AAAA,EACT;AACA,QAAM,SAAS;AACf,SAAO,UAAU,UAAU,WAAW,UAAU,iBAAiB,MAAM;AACzE;AAQO,SAAS,gBAAgB,QAAgE;AAC9F,QAAM,MAAM,UAAU;AAEtB,MAAI,CAAC,QAAQ;AACX,WAAO,EAAE,KAAK,SAAS,QAAQ;AAAA,EACjC;AAEA,UAAQ,OAAO,YAAY,GAAG;AAAA,IAC5B,KAAK;AACH,aAAO,EAAE,KAAK,SAAS,iBAAiB;AAAA,IAC1C,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO,EAAE,KAAK,SAAS,OAAO;AAAA,IAChC,KAAK;AACH,aAAO,EAAE,KAAK,SAAS,QAAQ;AAAA,IACjC,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO,EAAE,KAAK,SAAS,aAAa;AAAA,IACtC,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO,EAAE,KAAK,SAAS,SAAS;AAAA,IAClC;AACE,aAAO,EAAE,KAAK,SAAS,QAAQ;AAAA,EACnC;AACF;AAQO,SAAS,cAAc,YAAoE;AAChG,QAAM,eAAe,YAAY,uBAAuB;AACxD,QAAM,kBAAkB,YAAY,2BAA2B;AAE/D,SAAO;AAAA,IACL,aAAa;AAAA,MACX,WAAW;AAAA,MACX,YAAY;AAAA,MACZ,SACE,gBAAgB,QACX,YAAY,iBAAiB,KAAK,eACnC,YAAY;AAAA,MAClB,OAAO,YAAY;AAAA,IACrB;AAAA,IACA,cAAc;AAAA,MACZ,WAAW;AAAA,MACX,MACE,mBAAmB,QACd,YAAY,qBAAqB,KAAK,kBACvC,YAAY;AAAA,MAClB,OAAO,YAAY;AAAA,IACrB;AAAA,EACF;AACF;AAQO,SAAS,cAAc,YAAoE;AAChG,MAAI,CAAC,YAAY;AACf,WAAO;AAAA,EACT;AAEA,UAAQ,WAAW,MAAM;AAAA,IACvB,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,QACL,UAAU,EAAE,MAAM,WAAW,SAAS;AAAA,QACtC,MAAM;AAAA,MACR;AAAA,IACF;AACE,aAAO;AAAA,EACX;AACF;AAQO,SAAS,mBAAmB,WAAyD;AAC1F,MAAI,MAAM,QAAQ,SAAS,GAAG;AAC5B,WAAO;AAAA,EACT;AACA,QAAM,SAAS,OAAO,KAAK,WAAW,QAAQ;AAC9C,QAAM,eAAe,IAAI;AAAA,IACvB,OAAO;AAAA,IACP,OAAO;AAAA,IACP,OAAO,SAAS,aAAa;AAAA,EAC/B;AACA,SAAO,MAAM,KAAK,YAAY;AAChC;AAUA,eAAsB,qBACpB,QACA,SAC2F;AAC3F,QAAM,EAAE,sBAAsB,SAAS,SAAS,IAAI;AACpD,QAAM,EAAE,iBAAiB,OAAO,IAAI;AAEpC,QAAM,eAAe,gBAAgB,QAAQ;AAC7C,QAAM,aAAa,MAAM,qBAAqB;AAAA,IAC5C,UAAU;AAAA,IACV;AAAA,IACA,QAAQ;AAAA,EACV,CAAC;AAED,MAAI,OAAO,SAAS,sBAAsB;AACxC,UAAM,IAAI,mCAAmC;AAAA,MAC3C;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AAEA,SAAO,EAAE,kBAAkB,YAAY,aAAa;AACtD;AAQA,gBAAgB,YAAe,UAAuD;AACpF,MAAI;AACF,WAAO;AAAA,EACT,SAAS,OAAO;AACd,UAAM,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAAA,EAChE;AACF;","names":[]}

package/dist/chunk-DYFBCE2W.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 { ChatMessage } from \"@sap-ai-sdk/orchestration\";\n\nimport { parseProviderOptions } from \"@ai-sdk/provider-utils\";\n\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  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 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  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_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(client, request, options.abortSignal ?? undefined);\n\n      return buildGenerateResult({\n        modelId: config.modelId,\n        providerName: commonParts.providerName,\n        requestBody: request,\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      );\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        responseHeaders: streamResponse.responseHeaders,\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 messages = convertToSAPMessages(options.prompt, {\n      escapeTemplatePlaceholders: this.getEscapeTemplatePlaceholders(sapOptions, settings),\n      includeReasoning: this.getIncludeReasoning(sapOptions, settings),\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      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   * @returns SDK response.\n   * @internal\n   */\n  protected abstract executeApiCall(\n    client: TClient,\n    request: TRequest,\n    abortSignal: AbortSignal | 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   * @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  ): Promise<StreamCallResponse>;\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 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"],"mappings":"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","names":[]}

package/dist/chunk-EXOXZ5OU.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/convert-to-sap-messages.ts"],"sourcesContent":["import type {\n  AssistantChatMessage,\n  ChatMessage,\n  SystemChatMessage,\n  ToolChatMessage,\n  UserChatMessage,\n} from \"@sap-ai-sdk/orchestration\";\n\nimport {\n  InvalidPromptError,\n  LanguageModelV3Prompt,\n  UnsupportedFunctionalityError,\n} from \"@ai-sdk/provider\";\nimport { Buffer } from \"node:buffer\";\n\n/**\n * Options for converting Vercel AI SDK prompts to SAP AI SDK messages.\n * @see {@link convertToSAPMessages}\n */\nexport interface ConvertToSAPMessagesOptions {\n  /**\n   * Whether to escape Jinja2 template delimiters (`{{`, `{%`, `{#`) in message content.\n   * This prevents SAP orchestration from interpreting user content as template syntax.\n   * @default true\n   */\n  readonly escapeTemplatePlaceholders?: boolean;\n  /**\n   * Whether to include assistant reasoning parts (wrapped in `<think>` tags).\n   * @default false\n   */\n  readonly includeReasoning?: boolean;\n}\n\n/**\n * @internal\n */\nconst ZERO_WIDTH_SPACE = \"\\u200B\";\n\n/**\n * Safely serializes a value to JSON string, handling edge cases that would cause JSON.stringify to throw.\n *\n * Handles:\n * - Circular references (objects that reference themselves)\n * - BigInt values (converted to string representation)\n * - Undefined values and symbols (handled by JSON.stringify's default behavior)\n * @param value - The value to serialize.\n * @returns JSON string representation, or a fallback string representation if serialization fails.\n * @internal\n */\nfunction safeJsonStringify(value: unknown): string {\n  try {\n    return JSON.stringify(value, (_key, val) =>\n      typeof val === \"bigint\" ? val.toString() : (val as unknown),\n    );\n  } catch {\n    return String(value);\n  }\n}\n\n/**\n * @internal\n */\nconst JINJA2_DELIMITERS_PATTERN = /\\{(?=[{%#])/g;\n\n/**\n * @internal\n */\nconst JINJA2_DELIMITERS_ESCAPED_PATTERN = new RegExp(`\\\\{${ZERO_WIDTH_SPACE}([{%#])`, \"g\");\n\n/**\n * @internal\n */\ninterface UserContentItem {\n  readonly file?: {\n    readonly file_data: string;\n    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 * @returns SAP AI SDK ChatMessage array ready for orchestration requests.\n * @throws {UnsupportedFunctionalityError} When encountering unsupported content types or file formats.\n * @throws {InvalidPromptError} When encountering unsupported message roles.\n */\nexport function convertToSAPMessages(\n  prompt: LanguageModelV3Prompt,\n  options: ConvertToSAPMessagesOptions = {},\n): ChatMessage[] {\n  const messages: ChatMessage[] = [];\n  const includeReasoning = options.includeReasoning ?? false;\n  const escapeTemplatePlaceholders = options.escapeTemplatePlaceholders ?? true;\n\n  const maybeEscape = (text: string): string =>\n    escapeTemplatePlaceholders ? escapeOrchestrationPlaceholders(text) : text;\n\n  for (const message of prompt) {\n    switch (message.role) {\n      case \"assistant\": {\n        let text = \"\";\n        const toolCalls: {\n          function: { arguments: string; name: string };\n          id: string;\n          type: \"function\";\n        }[] = [];\n\n        for (const part of message.content) {\n          switch (part.type) {\n            case \"reasoning\": {\n              if (includeReasoning && part.text) {\n                text += `<think>${maybeEscape(part.text)}</think>`;\n              }\n              break;\n            }\n            case \"text\": {\n              text += maybeEscape(part.text);\n              break;\n            }\n            case \"tool-call\": {\n              // Normalize tool call input to JSON string (Vercel AI SDK provides strings or objects)\n              let argumentsJson: string;\n              if (typeof part.input === \"string\") {\n                argumentsJson = part.input;\n              } else {\n                argumentsJson = JSON.stringify(part.input);\n              }\n\n              // Escape tool call arguments if needed (they may contain placeholder syntax)\n              toolCalls.push({\n                function: {\n                  arguments: maybeEscape(argumentsJson),\n                  name: part.toolName,\n                },\n                id: part.toolCallId,\n                type: \"function\",\n              });\n              break;\n            }\n          }\n        }\n\n        if (text || toolCalls.length > 0) {\n          const assistantMessage: AssistantChatMessage = {\n            content: text,\n            role: \"assistant\",\n            tool_calls: toolCalls.length > 0 ? toolCalls : undefined,\n          };\n          messages.push(assistantMessage);\n        }\n        break;\n      }\n\n      case \"system\": {\n        const systemMessage: SystemChatMessage = {\n          content: maybeEscape(message.content),\n          role: \"system\",\n        };\n        messages.push(systemMessage);\n        break;\n      }\n\n      case \"tool\": {\n        for (const part of message.content) {\n          if (part.type === \"tool-result\") {\n            const serializedOutput = safeJsonStringify(part.output);\n            const toolMessage: ToolChatMessage = {\n              content: maybeEscape(serializedOutput),\n              role: \"tool\",\n              tool_call_id: part.toolCallId,\n            };\n            messages.push(toolMessage);\n          }\n        }\n        break;\n      }\n\n      case \"user\": {\n        const contentParts: UserContentItem[] = [];\n\n        for (const part of message.content) {\n          switch (part.type) {\n            case \"file\": {\n              const fileDataUrl = buildDataUrl(part);\n\n              if (part.mediaType.startsWith(\"image/\")) {\n                const supportedFormats = [\n                  \"image/png\",\n                  \"image/jpeg\",\n                  \"image/jpg\",\n                  \"image/gif\",\n                  \"image/webp\",\n                ];\n                if (!supportedFormats.includes(part.mediaType.toLowerCase())) {\n                  console.warn(\n                    `Image format ${part.mediaType} may not be supported by all models. ` +\n                      `Recommended formats: PNG, JPEG, GIF, WebP`,\n                  );\n                }\n\n                contentParts.push({\n                  image_url: {\n                    url: fileDataUrl,\n                  },\n                  type: \"image_url\",\n                });\n              } else {\n                contentParts.push({\n                  file: {\n                    file_data: fileDataUrl,\n                    ...(part.filename ? { filename: part.filename } : {}),\n                  },\n                  type: \"file\",\n                });\n              }\n              break;\n            }\n            case \"text\": {\n              contentParts.push({\n                text: maybeEscape(part.text),\n                type: \"text\",\n              });\n              break;\n            }\n            default: {\n              throw new UnsupportedFunctionalityError({\n                functionality: `Content type ${(part as { type: string }).type}`,\n              });\n            }\n          }\n        }\n\n        const firstPart = contentParts[0];\n        const userMessage: UserChatMessage =\n          contentParts.length === 1 && firstPart?.type === \"text\"\n            ? {\n                content: firstPart.text ?? \"\",\n                role: \"user\",\n              }\n            : {\n                content: contentParts,\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":[]}