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

package/dist/chunk-WDUOKIKD.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/sap-ai-validation.ts"],"sourcesContent":["/** Validation and resolution functions for SAP AI API-specific features. */\nimport type { SharedV3Warning } from \"@ai-sdk/provider\";\n\nimport type {\n  FoundationModelsModelSettings,\n  OrchestrationModelSettings,\n  SAPAIApiType,\n  SAPAIEmbeddingSettings,\n  SAPAIModelSettings,\n  SAPAISettings,\n} from \"./sap-ai-settings.js\";\n\nimport { deepMerge } from \"./deep-merge.js\";\nimport { ApiSwitchError, UnsupportedFeatureError } from \"./sap-ai-error.js\";\n\n/**\n * Type guard for Foundation Models API settings.\n * @param settings - Settings to check.\n * @returns True if settings are for Foundation Models API.\n */\nexport function isFoundationModelsSettings(\n  settings: SAPAIModelSettings | SAPAISettings,\n): settings is FoundationModelsModelSettings {\n  return settings.api === \"foundation-models\";\n}\n\n/**\n * Type guard for Orchestration API settings.\n * @param settings - Settings to check.\n * @returns True if settings are for Orchestration API.\n */\nexport function isOrchestrationSettings(\n  settings: SAPAIModelSettings | SAPAISettings,\n): settings is OrchestrationModelSettings {\n  return settings.api === undefined || settings.api === \"orchestration\";\n}\n\n/**\n * Validates escapeTemplatePlaceholders option based on API type.\n *\n * Jinja2 template escaping is only supported by the Orchestration API.\n * @param api - SAP AI API type.\n * @param escapeTemplatePlaceholders - Whether to escape template placeholders.\n * @throws {UnsupportedFeatureError} When escapeTemplatePlaceholders is true with Foundation Models API.\n * @internal\n */\nfunction validateEscapeTemplatePlaceholders(\n  api: SAPAIApiType,\n  escapeTemplatePlaceholders: boolean | undefined,\n): void {\n  if (api === \"foundation-models\" && escapeTemplatePlaceholders === true) {\n    throw new UnsupportedFeatureError(\n      ESCAPE_TEMPLATE_PLACEHOLDERS_DESCRIPTION,\n      \"foundation-models\",\n      \"orchestration\",\n    );\n  }\n}\n\n/**\n * Validates that Foundation Models-only options are not used with Orchestration API.\n *\n * Foundation Models-only features:\n * - `dataSources` - Azure On Your Data configuration\n * @param settings - Settings to validate.\n * @throws {UnsupportedFeatureError} When dataSources is set with Orchestration API.\n * @internal\n */\nfunction validateFoundationModelsOnlyOptions(\n  settings: SAPAIModelSettings | SAPAISettings | undefined,\n): void {\n  if (!settings) return;\n\n  const fmSettings = settings as FoundationModelsModelSettings;\n\n  for (const feature of FOUNDATION_MODELS_ONLY_FEATURE_KEYS) {\n    if (fmSettings[feature] !== undefined) {\n      throw new UnsupportedFeatureError(\n        FOUNDATION_MODELS_ONLY_FEATURES[feature],\n        \"orchestration\",\n        \"foundation-models\",\n      );\n    }\n  }\n}\n\n/**\n * Validates that Orchestration-only embedding options are not used with Foundation Models API.\n *\n * Orchestration-only embedding features:\n * - `masking` - Data masking module\n * @param settings - Embedding settings to validate.\n * @throws {UnsupportedFeatureError} When masking is set with Foundation Models API.\n * @internal\n */\nfunction validateOrchestrationOnlyEmbeddingOptions(\n  settings: SAPAIEmbeddingSettings | undefined,\n): void {\n  if (!settings) return;\n\n  for (const feature of ORCHESTRATION_ONLY_EMBEDDING_FEATURE_KEYS) {\n    if (settings[feature] !== undefined) {\n      throw new UnsupportedFeatureError(\n        ORCHESTRATION_ONLY_EMBEDDING_FEATURES[feature],\n        \"foundation-models\",\n        \"orchestration\",\n      );\n    }\n  }\n}\n\n/**\n * Validates that Orchestration-only options are not used with Foundation Models API.\n *\n * Orchestration-only features:\n * - `filtering` - Content filtering module\n * - `grounding` - Document grounding module\n * - `masking` - Data masking module\n * - `orchestrationConfigRef` - Prompt Registry configuration reference\n * - `placeholderValues` - Jinja2 template placeholder values\n * - `promptTemplateRef` - Prompt Registry template reference\n * - `tools` - SAP-format tool definitions (use AI SDK tools instead)\n * - `translation` - Translation module\n * @param settings - Settings to validate.\n * @throws {UnsupportedFeatureError} When any Orchestration-only feature is set with Foundation Models API.\n * @internal\n */\nfunction validateOrchestrationOnlyOptions(\n  settings: SAPAIModelSettings | SAPAISettings | undefined,\n): void {\n  if (!settings) return;\n\n  const orchSettings = settings as OrchestrationModelSettings;\n\n  for (const feature of ORCHESTRATION_ONLY_FEATURE_KEYS) {\n    if (orchSettings[feature] !== undefined) {\n      throw new UnsupportedFeatureError(\n        ORCHESTRATION_ONLY_FEATURES[feature],\n        \"foundation-models\",\n        \"orchestration\",\n      );\n    }\n  }\n}\n\n/**\n * Keys for Orchestration-only features.\n * @internal\n */\nconst ORCHESTRATION_ONLY_FEATURE_KEYS = [\n  \"filtering\",\n  \"grounding\",\n  \"masking\",\n  \"orchestrationConfigRef\",\n  \"placeholderValues\",\n  \"promptTemplateRef\",\n  \"streamOptions\",\n  \"tools\",\n  \"translation\",\n] as const;\n\n/**\n * Mapping of Orchestration-only feature keys to human-readable descriptions.\n * Used for generating consistent error messages.\n * @internal\n */\nconst ORCHESTRATION_ONLY_FEATURES: Readonly<\n  Record<(typeof ORCHESTRATION_ONLY_FEATURE_KEYS)[number], string>\n> = {\n  filtering: \"Content filtering\",\n  grounding: \"Document grounding\",\n  masking: \"Data masking\",\n  orchestrationConfigRef: \"Orchestration config reference (orchestrationConfigRef)\",\n  placeholderValues: \"Placeholder values (placeholderValues)\",\n  promptTemplateRef: \"Prompt template reference (promptTemplateRef)\",\n  streamOptions: \"Stream options for post-LLM modules\",\n  tools: \"SAP-format tool definitions (use AI SDK tools instead)\",\n  translation: \"Translation\",\n} as const;\n\n/**\n * Keys for Foundation Models-only features.\n * @internal\n */\nconst FOUNDATION_MODELS_ONLY_FEATURE_KEYS = [\"dataSources\"] as const;\n\n/**\n * Mapping of Foundation Models-only feature keys to human-readable descriptions.\n * Used for generating consistent error messages.\n * @internal\n */\nconst FOUNDATION_MODELS_ONLY_FEATURES: Readonly<\n  Record<(typeof FOUNDATION_MODELS_ONLY_FEATURE_KEYS)[number], string>\n> = {\n  dataSources: \"Azure On Your Data (dataSources)\",\n} as const;\n\n/**\n * Subset of Orchestration-only features that can be set at invocation level.\n * @internal\n */\nconst ORCHESTRATION_ONLY_INVOCATION_FEATURE_KEYS = [\n  \"orchestrationConfigRef\",\n  \"placeholderValues\",\n  \"promptTemplateRef\",\n] as const;\n\n/**\n * Keys for Orchestration-only embedding features.\n * @internal\n */\nconst ORCHESTRATION_ONLY_EMBEDDING_FEATURE_KEYS = [\"masking\"] as const;\n\n/**\n * Mapping of Orchestration-only embedding feature keys to human-readable descriptions.\n * Uses the same descriptions as the main ORCHESTRATION_ONLY_FEATURES for consistency.\n * @internal\n */\nconst ORCHESTRATION_ONLY_EMBEDDING_FEATURES: Readonly<\n  Record<(typeof ORCHESTRATION_ONLY_EMBEDDING_FEATURE_KEYS)[number], string>\n> = {\n  masking: ORCHESTRATION_ONLY_FEATURES.masking,\n} as const;\n\n/**\n * Human-readable description for escapeTemplatePlaceholders feature.\n * Used for generating consistent error messages.\n * @internal\n */\nconst ESCAPE_TEMPLATE_PLACEHOLDERS_DESCRIPTION =\n  \"escapeTemplatePlaceholders (Jinja2 template escaping)\";\n\n/**\n * Validates that switching APIs at invocation time is allowed.\n *\n * API switching is blocked when the model was configured with features\n * that are specific to one API and incompatible with the target API.\n * @param fromApi - Source API type (configured at model creation).\n * @param toApi - Target API type (requested at invocation time).\n * @param modelSettings - Model settings to validate for conflicts.\n * @throws {ApiSwitchError} When the model has features incompatible with the target API.\n * @internal\n */\nfunction validateApiSwitch(\n  fromApi: SAPAIApiType,\n  toApi: SAPAIApiType,\n  modelSettings: SAPAIModelSettings | SAPAISettings | undefined,\n): void {\n  if (fromApi === toApi) return;\n  if (!modelSettings) return;\n\n  if (fromApi === \"orchestration\" && toApi === \"foundation-models\") {\n    const orchSettings = modelSettings as OrchestrationModelSettings;\n\n    for (const feature of ORCHESTRATION_ONLY_FEATURE_KEYS) {\n      if (orchSettings[feature] !== undefined) {\n        throw new ApiSwitchError(fromApi, toApi, feature);\n      }\n    }\n  }\n\n  if (fromApi === \"foundation-models\" && toApi === \"orchestration\") {\n    const fmSettings = modelSettings as FoundationModelsModelSettings;\n\n    for (const feature of FOUNDATION_MODELS_ONLY_FEATURE_KEYS) {\n      if (fmSettings[feature] !== undefined) {\n        throw new ApiSwitchError(fromApi, toApi, feature);\n      }\n    }\n  }\n}\n\n/**\n * @internal\n */\nconst VALID_API_TYPES: readonly SAPAIApiType[] = [\"orchestration\", \"foundation-models\"];\n\n/** Options for the main validation function. */\nexport interface ValidateSettingsOptions {\n  readonly api: SAPAIApiType;\n  readonly embeddingSettings?: SAPAIEmbeddingSettings;\n  readonly invocationSettings?: {\n    readonly api?: SAPAIApiType;\n    readonly escapeTemplatePlaceholders?: boolean;\n    readonly orchestrationConfigRef?: unknown;\n    readonly placeholderValues?: unknown;\n    readonly promptTemplateRef?: unknown;\n  };\n  readonly modelApi?: SAPAIApiType;\n  readonly modelSettings?: SAPAIModelSettings | SAPAISettings;\n}\n\n/**\n * Gets the effective escapeTemplatePlaceholders value based on API and settings.\n * @param api - SAP AI API type.\n * @param modelSettings - Model settings.\n * @param invocationEscape - Invocation-level escape setting.\n * @returns Effective escapeTemplatePlaceholders value.\n */\nexport function getEffectiveEscapeTemplatePlaceholders(\n  api: SAPAIApiType,\n  modelSettings: SAPAIModelSettings | SAPAISettings | undefined,\n  invocationEscape: boolean | undefined,\n): boolean {\n  if (api === \"foundation-models\") {\n    return false;\n  }\n\n  if (invocationEscape !== undefined) {\n    return invocationEscape;\n  }\n\n  const modelValue = (modelSettings as OrchestrationModelSettings | undefined)\n    ?.escapeTemplatePlaceholders;\n  if (modelValue !== undefined) {\n    return modelValue;\n  }\n\n  return true;\n}\n\n/**\n * Merges settings with proper API precedence (callSettings > defaultSettings > fallbackApi).\n * @param defaultSettings - Provider-level default settings.\n * @param callSettings - Per-call settings that override defaults.\n * @param fallbackApi - Fallback API type when neither settings specify one.\n * @returns Merged settings with correct API precedence.\n * @internal\n */\nexport function mergeSettingsWithApi<T extends { api?: string }>(\n  defaultSettings: Record<string, unknown> | undefined,\n  callSettings: Partial<T>,\n  fallbackApi: string,\n): T {\n  return {\n    ...deepMerge(defaultSettings, callSettings as Record<string, unknown>),\n    api: callSettings.api ?? (defaultSettings?.api as string | undefined) ?? fallbackApi,\n  } as T;\n}\n\n/**\n * Resolves the effective API type using the full precedence chain.\n * @param providerApi - Provider-level API type.\n * @param modelApi - Model-level API type.\n * @param invocationApi - Invocation-level API type.\n * @returns Resolved API type.\n */\nexport function resolveApi(\n  providerApi: SAPAIApiType | undefined,\n  modelApi: SAPAIApiType | undefined,\n  invocationApi: SAPAIApiType | undefined,\n): SAPAIApiType {\n  return invocationApi ?? modelApi ?? providerApi ?? \"orchestration\";\n}\n\n/**\n * Validates that the API value is a valid SAPAIApiType.\n * @param api - API value to validate.\n */\nexport function validateApiInput(api: unknown): void {\n  if (api === undefined) return;\n\n  if (typeof api !== \"string\" || !VALID_API_TYPES.includes(api as SAPAIApiType)) {\n    throw new Error(\n      `Invalid API type: ${JSON.stringify(api)}. ` +\n        `Valid values are: ${VALID_API_TYPES.map((t) => `\"${t}\"`).join(\", \")}`,\n    );\n  }\n}\n\n/**\n * Pushes a deprecation warning when `settings.masking` carries `masking_providers`\n * without a `providers` block.\n * @param modelSettings - Resolved model settings (LM or embedding) that may carry a `masking` module.\n * @param warnings - Sink that collects the deprecation warning when it applies.\n * @internal\n */\nexport function validateMaskingProvidersDeprecation(\n  modelSettings: undefined | { masking?: unknown },\n  warnings: SharedV3Warning[],\n): void {\n  const masking = modelSettings?.masking;\n  if (!masking || typeof masking !== \"object\") {\n    return;\n  }\n  const maskingRecord = masking as Record<string, unknown>;\n  const hasDeprecated = maskingRecord.masking_providers !== undefined;\n  const hasPreferred = maskingRecord.providers !== undefined;\n  if (hasDeprecated && !hasPreferred) {\n    warnings.push({\n      message:\n        \"settings.masking.masking_providers is deprecated and will be removed by SAP on 2027-03-20. \" +\n        \"Migrate to settings.masking.providers.\",\n      type: \"other\",\n    });\n  }\n}\n\n/**\n * Main validation function that performs all API-specific validations.\n *\n * This function orchestrates all validation checks:\n * 1. Validates API type inputs\n * 2. Checks for API switching conflicts\n * 3. Validates API-specific feature usage\n * 4. Validates template placeholder escaping\n * @param options - Validation options.\n * @throws {Error} When an invalid API type is provided.\n * @throws {ApiSwitchError} When attempting to switch APIs with incompatible settings.\n * @throws {UnsupportedFeatureError} When using features not supported by the current API.\n * @see {@link ApiSwitchError}\n * @see {@link UnsupportedFeatureError}\n */\nexport function validateSettings(options: ValidateSettingsOptions): void {\n  const { api, embeddingSettings, invocationSettings, modelApi, modelSettings } = options;\n\n  validateApiInput(api);\n  if (invocationSettings?.api !== undefined) {\n    validateApiInput(invocationSettings.api);\n  }\n\n  if (invocationSettings?.api !== undefined) {\n    const effectiveModelApi = modelApi ?? \"orchestration\";\n    if (effectiveModelApi !== invocationSettings.api) {\n      validateApiSwitch(effectiveModelApi, invocationSettings.api, modelSettings);\n    }\n  }\n\n  if (api === \"foundation-models\") {\n    validateOrchestrationOnlyOptions(modelSettings);\n    validateOrchestrationOnlyInvocationOptions(invocationSettings);\n    validateOrchestrationOnlyEmbeddingOptions(embeddingSettings);\n  } else {\n    validateFoundationModelsOnlyOptions(modelSettings);\n  }\n\n  const modelEscape = (modelSettings as OrchestrationModelSettings | undefined)\n    ?.escapeTemplatePlaceholders;\n  const invocationEscape = invocationSettings?.escapeTemplatePlaceholders;\n  const effectiveEscape = invocationEscape ?? modelEscape;\n  validateEscapeTemplatePlaceholders(api, effectiveEscape);\n}\n\n/**\n * Validates that Orchestration-only options are not passed at invocation level with Foundation Models API.\n * @param invocationSettings - Invocation-level settings to validate.\n * @throws {UnsupportedFeatureError} When any Orchestration-only feature is set at invocation level.\n * @internal\n */\nfunction validateOrchestrationOnlyInvocationOptions(\n  invocationSettings: ValidateSettingsOptions[\"invocationSettings\"],\n): void {\n  if (!invocationSettings) return;\n\n  for (const feature of ORCHESTRATION_ONLY_INVOCATION_FEATURE_KEYS) {\n    if (invocationSettings[feature] !== undefined) {\n      throw new UnsupportedFeatureError(\n        ORCHESTRATION_ONLY_FEATURES[feature],\n        \"foundation-models\",\n        \"orchestration\",\n      );\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/foundation-models-embedding-model-strategy-YWPDIJEN.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/foundation-models-embedding-model-strategy.ts"],"sourcesContent":["/** Foundation Models embedding model strategy using `@sap-ai-sdk/foundation-models`. */\nimport type { EmbeddingModelV3Embedding } from \"@ai-sdk/provider\";\nimport type {\n  AzureOpenAiEmbeddingClient,\n  AzureOpenAiEmbeddingParameters,\n  AzureOpenAiEmbeddingResponse,\n} from \"@sap-ai-sdk/foundation-models\";\n\nimport type { SAPAIEmbeddingSettings } from \"./sap-ai-settings.js\";\nimport type { EmbeddingModelStrategyConfig } from \"./sap-ai-strategy.js\";\nimport type { EmbeddingProviderOptions, ResponseMetadata } from \"./strategy-utils.js\";\n\nimport { BaseEmbeddingModelStrategy } from \"./base-embedding-model-strategy.js\";\nimport {\n  buildModelDeployment,\n  extractResponseMetadata,\n  hasKeys,\n  normalizeEmbedding,\n} from \"./strategy-utils.js\";\n\n/**\n * Client with pre-merged params for thread-safe concurrent requests.\n * @internal\n */\ninterface FMEmbeddingClientWithContext {\n  client: AzureOpenAiEmbeddingClient;\n  mergedParams: Record<string, unknown> | undefined;\n}\n\n/** @internal */\ntype FoundationModelsEmbeddingClientClass = typeof AzureOpenAiEmbeddingClient;\n\n/**\n * Embedding model strategy for the Foundation Models API.\n *\n * Provides direct access to Azure OpenAI embedding models.\n * @internal\n */\nexport class FoundationModelsEmbeddingModelStrategy extends BaseEmbeddingModelStrategy<\n  FMEmbeddingClientWithContext,\n  AzureOpenAiEmbeddingResponse\n> {\n  private readonly ClientClass: FoundationModelsEmbeddingClientClass;\n\n  constructor(ClientClass: FoundationModelsEmbeddingClientClass) {\n    super();\n    this.ClientClass = ClientClass;\n  }\n\n  protected createClient(\n    config: EmbeddingModelStrategyConfig,\n    settings: SAPAIEmbeddingSettings,\n    embeddingOptions: EmbeddingProviderOptions | undefined,\n  ): FMEmbeddingClientWithContext {\n    const mergedParams = this.mergeModelParams(settings, embeddingOptions);\n\n    return {\n      client: new this.ClientClass(\n        buildModelDeployment(config, settings.modelVersion),\n        config.destination,\n      ),\n      mergedParams: hasKeys(mergedParams) ? mergedParams : undefined,\n    };\n  }\n\n  protected async executeCall(\n    clientWithContext: FMEmbeddingClientWithContext,\n    values: string[],\n    _embeddingType: unknown,\n    abortSignal: AbortSignal | undefined,\n  ): Promise<AzureOpenAiEmbeddingResponse> {\n    const request = this.buildRequest(values, clientWithContext.mergedParams);\n    return clientWithContext.client.run(request, abortSignal ? { signal: abortSignal } : undefined);\n  }\n\n  protected extractEmbeddings(response: AzureOpenAiEmbeddingResponse): EmbeddingModelV3Embedding[] {\n    // SDK types include `& Record<string, any>` which requires explicit extraction\n    const embeddingData = response._data.data;\n    const sortedEmbeddings = embeddingData.slice().sort((a, b) => a.index - b.index);\n    return sortedEmbeddings.map((item) => normalizeEmbedding(item.embedding as number[]));\n  }\n\n  protected override extractResponseMetadata(\n    response: AzureOpenAiEmbeddingResponse,\n  ): ResponseMetadata {\n    return extractResponseMetadata(response, \"rawResponse\");\n  }\n\n  protected extractTokenCount(response: AzureOpenAiEmbeddingResponse): number {\n    return response._data.usage.total_tokens;\n  }\n\n  protected getUrl(): string {\n    return \"sap-ai:foundation-models/embeddings\";\n  }\n\n  private buildRequest(\n    values: string[],\n    mergedParams: Record<string, unknown> | undefined,\n  ): AzureOpenAiEmbeddingParameters {\n    return {\n      input: values,\n      ...(mergedParams ?? {}),\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAsCO,IAAM,yCAAN,cAAqD,2BAG1D;AAAA,EACiB;AAAA,EAEjB,YAAY,aAAmD;AAC7D,UAAM;AACN,SAAK,cAAc;AAAA,EACrB;AAAA,EAEU,aACR,QACA,UACA,kBAC8B;AAC9B,UAAM,eAAe,KAAK,iBAAiB,UAAU,gBAAgB;AAErE,WAAO;AAAA,MACL,QAAQ,IAAI,KAAK;AAAA,QACf,qBAAqB,QAAQ,SAAS,YAAY;AAAA,QAClD,OAAO;AAAA,MACT;AAAA,MACA,cAAc,QAAQ,YAAY,IAAI,eAAe;AAAA,IACvD;AAAA,EACF;AAAA,EAEA,MAAgB,YACd,mBACA,QACA,gBACA,aACuC;AACvC,UAAM,UAAU,KAAK,aAAa,QAAQ,kBAAkB,YAAY;AACxE,WAAO,kBAAkB,OAAO,IAAI,SAAS,cAAc,EAAE,QAAQ,YAAY,IAAI,MAAS;AAAA,EAChG;AAAA,EAEU,kBAAkB,UAAqE;AAE/F,UAAM,gBAAgB,SAAS,MAAM;AACrC,UAAM,mBAAmB,cAAc,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK;AAC/E,WAAO,iBAAiB,IAAI,CAAC,SAAS,mBAAmB,KAAK,SAAqB,CAAC;AAAA,EACtF;AAAA,EAEmB,wBACjB,UACkB;AAClB,WAAO,wBAAwB,UAAU,aAAa;AAAA,EACxD;AAAA,EAEU,kBAAkB,UAAgD;AAC1E,WAAO,SAAS,MAAM,MAAM;AAAA,EAC9B;AAAA,EAEU,SAAiB;AACzB,WAAO;AAAA,EACT;AAAA,EAEQ,aACN,QACA,cACgC;AAChC,WAAO;AAAA,MACL,OAAO;AAAA,MACP,GAAI,gBAAgB,CAAC;AAAA,IACvB;AAAA,EACF;AACF;","names":[]}

package/dist/foundation-models-language-model-strategy-WDSQWU64.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/foundation-models-language-model-strategy.ts"],"sourcesContent":["/** Foundation Models language model strategy using `@sap-ai-sdk/foundation-models`. */\nimport type { LanguageModelV3CallOptions, SharedV3Warning } from \"@ai-sdk/provider\";\nimport type {\n  AzureOpenAiChatClient,\n  AzureOpenAiChatCompletionParameters,\n  AzureOpenAiChatCompletionTool,\n} from \"@sap-ai-sdk/foundation-models\";\nimport type { ChatMessage } from \"@sap-ai-sdk/orchestration\";\n\nimport type { FoundationModelsModelSettings } 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 {\n  buildModelDeployment,\n  convertResponseFormat,\n  convertToolsToSAPFormat,\n  type ParamMapping,\n  type SAPToolChoice,\n  type SDKResponse,\n  type SDKStreamChunk,\n} from \"./strategy-utils.js\";\n\n/** @internal */\ntype FoundationModelsClient = InstanceType<typeof AzureOpenAiChatClient>;\n\n/**\n * Foundation Models API parameter mappings.\n * @internal\n */\nconst FOUNDATION_MODELS_PARAM_MAPPINGS: readonly ParamMapping[] = [\n  ...BaseLanguageModelStrategy.COMMON_PARAM_MAPPINGS,\n  { camelCaseKey: \"logprobs\", outputKey: \"logprobs\" },\n  { camelCaseKey: \"topLogprobs\", outputKey: \"top_logprobs\" },\n  { camelCaseKey: \"logitBias\", outputKey: \"logit_bias\" },\n  { camelCaseKey: \"user\", outputKey: \"user\" },\n  { camelCaseKey: \"n\", outputKey: \"n\" },\n] as const;\n\n/**\n * Language model strategy for the Foundation Models API.\n *\n * Provides direct access to Azure OpenAI models with parameters like:\n * - logprobs\n * - seed\n * - dataSources (On Your Data)\n * @internal\n */\nexport class FoundationModelsLanguageModelStrategy extends BaseLanguageModelStrategy<\n  FoundationModelsClient,\n  AzureOpenAiChatCompletionParameters,\n  FoundationModelsModelSettings\n> {\n  private readonly ClientClass: typeof AzureOpenAiChatClient;\n\n  constructor(ClientClass: typeof AzureOpenAiChatClient) {\n    super();\n    this.ClientClass = ClientClass;\n  }\n\n  protected buildRequest(\n    _config: LanguageModelStrategyConfig,\n    settings: FoundationModelsModelSettings,\n    options: LanguageModelV3CallOptions,\n    commonParts: CommonBuildResult<ChatMessage[], SAPToolChoice | undefined>,\n  ): {\n    readonly request: AzureOpenAiChatCompletionParameters;\n    readonly warnings: SharedV3Warning[];\n  } {\n    const warnings: SharedV3Warning[] = [];\n\n    const toolsResult = convertToolsToSAPFormat<AzureOpenAiChatCompletionTool>(options.tools);\n    warnings.push(...toolsResult.warnings);\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 request: AzureOpenAiChatCompletionParameters = {\n      messages: commonParts.messages as AzureOpenAiChatCompletionParameters[\"messages\"],\n      ...(commonParts.modelParams as Partial<AzureOpenAiChatCompletionParameters>),\n      ...(toolsResult.tools?.length ? { tools: toolsResult.tools } : {}),\n      ...(toolChoice ? { tool_choice: toolChoice } : {}),\n      ...(responseFormat ? { response_format: responseFormat } : {}),\n      ...(settings.dataSources?.length\n        ? {\n            data_sources: settings.dataSources,\n          }\n        : {}),\n    };\n\n    return { request, warnings };\n  }\n\n  protected createClient(\n    config: LanguageModelStrategyConfig,\n    settings: FoundationModelsModelSettings,\n    _commonParts: CommonBuildResult<ChatMessage[], SAPToolChoice | undefined>,\n  ): FoundationModelsClient {\n    const modelDeployment = buildModelDeployment(config, settings.modelVersion);\n    return new this.ClientClass(modelDeployment, config.destination);\n  }\n\n  protected async executeApiCall(\n    client: FoundationModelsClient,\n    request: AzureOpenAiChatCompletionParameters,\n    abortSignal: AbortSignal | undefined,\n  ): Promise<SDKResponse> {\n    const response = await client.run(request, abortSignal ? { signal: abortSignal } : undefined);\n\n    const { requestId, responseId } = this.extractMetadata(response);\n\n    return {\n      getContent: () => response.getContent(),\n      getFinishReason: () => response.getFinishReason(),\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: FoundationModelsClient,\n    request: AzureOpenAiChatCompletionParameters,\n    abortSignal: AbortSignal | undefined,\n    _settings: FoundationModelsModelSettings,\n  ): Promise<StreamCallResponse> {\n    const streamResponse = await client.stream(request, abortSignal);\n\n    const { requestId, responseHeaders, responseId } = this.extractMetadata(streamResponse);\n\n    return {\n      getFinishReason: () => streamResponse.getFinishReason(),\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 [\"id\"];\n  }\n\n  protected getParamMappings(): readonly ParamMapping[] {\n    return FOUNDATION_MODELS_PARAM_MAPPINGS;\n  }\n\n  protected getUrl(): string {\n    return \"sap-ai:foundation-models\";\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAkCA,IAAM,mCAA4D;AAAA,EAChE,GAAG,0BAA0B;AAAA,EAC7B,EAAE,cAAc,YAAY,WAAW,WAAW;AAAA,EAClD,EAAE,cAAc,eAAe,WAAW,eAAe;AAAA,EACzD,EAAE,cAAc,aAAa,WAAW,aAAa;AAAA,EACrD,EAAE,cAAc,QAAQ,WAAW,OAAO;AAAA,EAC1C,EAAE,cAAc,KAAK,WAAW,IAAI;AACtC;AAWO,IAAM,wCAAN,cAAoD,0BAIzD;AAAA,EACiB;AAAA,EAEjB,YAAY,aAA2C;AACrD,UAAM;AACN,SAAK,cAAc;AAAA,EACrB;AAAA,EAEU,aACR,SACA,UACA,SACA,aAIA;AACA,UAAM,WAA8B,CAAC;AAErC,UAAM,cAAc,wBAAuD,QAAQ,KAAK;AACxF,aAAS,KAAK,GAAG,YAAY,QAAQ;AAErC,UAAM,EAAE,gBAAgB,SAAS,sBAAsB,IAAI;AAAA,MACzD,QAAQ;AAAA,MACR,SAAS;AAAA,IACX;AACA,QAAI,uBAAuB;AACzB,eAAS,KAAK,qBAAqB;AAAA,IACrC;AAEA,UAAM,EAAE,WAAW,IAAI;AAEvB,UAAM,UAA+C;AAAA,MACnD,UAAU,YAAY;AAAA,MACtB,GAAI,YAAY;AAAA,MAChB,GAAI,YAAY,OAAO,SAAS,EAAE,OAAO,YAAY,MAAM,IAAI,CAAC;AAAA,MAChE,GAAI,aAAa,EAAE,aAAa,WAAW,IAAI,CAAC;AAAA,MAChD,GAAI,iBAAiB,EAAE,iBAAiB,eAAe,IAAI,CAAC;AAAA,MAC5D,GAAI,SAAS,aAAa,SACtB;AAAA,QACE,cAAc,SAAS;AAAA,MACzB,IACA,CAAC;AAAA,IACP;AAEA,WAAO,EAAE,SAAS,SAAS;AAAA,EAC7B;AAAA,EAEU,aACR,QACA,UACA,cACwB;AACxB,UAAM,kBAAkB,qBAAqB,QAAQ,SAAS,YAAY;AAC1E,WAAO,IAAI,KAAK,YAAY,iBAAiB,OAAO,WAAW;AAAA,EACjE;AAAA,EAEA,MAAgB,eACd,QACA,SACA,aACsB;AACtB,UAAM,WAAW,MAAM,OAAO,IAAI,SAAS,cAAc,EAAE,QAAQ,YAAY,IAAI,MAAS;AAE5F,UAAM,EAAE,WAAW,WAAW,IAAI,KAAK,gBAAgB,QAAQ;AAE/D,WAAO;AAAA,MACL,YAAY,MAAM,SAAS,WAAW;AAAA,MACtC,iBAAiB,MAAM,SAAS,gBAAgB;AAAA,MAChD,eAAe,MAAM,SAAS,cAAc;AAAA,MAC5C,cAAc,MAAM,SAAS,aAAa;AAAA;AAAA,MAE1C,aAAa,EAAE,SAAS,SAAS,YAAY,QAAQ;AAAA,MACrD;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAgB,kBACd,QACA,SACA,aACA,WAC6B;AAC7B,UAAM,iBAAiB,MAAM,OAAO,OAAO,SAAS,WAAW;AAE/D,UAAM,EAAE,WAAW,iBAAiB,WAAW,IAAI,KAAK,gBAAgB,cAAc;AAEtF,WAAO;AAAA,MACL,iBAAiB,MAAM,eAAe,gBAAgB;AAAA,MACtD,eAAe,MAAM,eAAe,cAAc;AAAA,MAClD;AAAA,MACA;AAAA,MACA;AAAA,MACA,QAAQ,eAAe;AAAA,IACzB;AAAA,EACF;AAAA,EAEU,sBAAyC;AACjD,WAAO,CAAC,IAAI;AAAA,EACd;AAAA,EAEU,mBAA4C;AACpD,WAAO;AAAA,EACT;AAAA,EAEU,SAAiB;AACzB,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/orchestration-embedding-model-strategy-66QYAO64.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/orchestration-embedding-model-strategy.ts"],"sourcesContent":["/** Orchestration embedding model strategy using `@sap-ai-sdk/orchestration`. */\nimport type { EmbeddingModelV3Embedding, SharedV3Warning } from \"@ai-sdk/provider\";\nimport type {\n  EmbeddingModelConfig,\n  EmbeddingModuleConfig,\n  MaskingModule,\n  OrchestrationEmbeddingClient,\n  OrchestrationEmbeddingResponse,\n} from \"@sap-ai-sdk/orchestration\";\n\nimport type { SAPAIEmbeddingSettings } from \"./sap-ai-settings.js\";\nimport type { EmbeddingModelStrategyConfig } from \"./sap-ai-strategy.js\";\n\nimport { BaseEmbeddingModelStrategy } from \"./base-embedding-model-strategy.js\";\nimport { validateMaskingProvidersDeprecation } from \"./sap-ai-validation.js\";\nimport {\n  type EmbeddingProviderOptions,\n  extractResponseMetadata,\n  hasKeys,\n  normalizeEmbedding,\n  type ResponseMetadata,\n} from \"./strategy-utils.js\";\n\n/** @internal */\ntype OrchestrationEmbeddingClientClass = typeof OrchestrationEmbeddingClient;\n\n/**\n * Embedding model strategy for the Orchestration API.\n *\n * Provides support for:\n * - Data masking\n * - Model parameters configuration\n * @internal\n */\nexport class OrchestrationEmbeddingModelStrategy extends BaseEmbeddingModelStrategy<\n  OrchestrationEmbeddingClient,\n  OrchestrationEmbeddingResponse\n> {\n  private readonly ClientClass: OrchestrationEmbeddingClientClass;\n\n  constructor(ClientClass: OrchestrationEmbeddingClientClass) {\n    super();\n    this.ClientClass = ClientClass;\n  }\n\n  protected createClient(\n    config: EmbeddingModelStrategyConfig,\n    settings: SAPAIEmbeddingSettings,\n    embeddingOptions: EmbeddingProviderOptions | undefined,\n  ): OrchestrationEmbeddingClient {\n    const mergedParams = this.mergeModelParams(settings, embeddingOptions);\n\n    const embeddingConfig: EmbeddingModelConfig = {\n      model: {\n        name: config.modelId,\n        ...(hasKeys(mergedParams) ? { params: mergedParams } : {}),\n        ...(settings.modelVersion ? { version: settings.modelVersion } : {}),\n      },\n    };\n\n    const moduleConfig: EmbeddingModuleConfig = {\n      embeddings: embeddingConfig,\n      ...(settings.masking && hasKeys(settings.masking)\n        ? { masking: settings.masking as MaskingModule }\n        : {}),\n    };\n\n    return new this.ClientClass(moduleConfig, config.deploymentConfig, config.destination);\n  }\n\n  protected async executeCall(\n    client: OrchestrationEmbeddingClient,\n    values: string[],\n    embeddingType: \"document\" | \"query\" | \"text\" | undefined,\n    abortSignal?: AbortSignal,\n  ): Promise<OrchestrationEmbeddingResponse> {\n    return client.embed(\n      { input: values, type: embeddingType },\n      abortSignal ? { signal: abortSignal } : undefined,\n    );\n  }\n\n  protected extractEmbeddings(\n    response: OrchestrationEmbeddingResponse,\n  ): EmbeddingModelV3Embedding[] {\n    const embeddingData = response.getEmbeddings();\n    const sortedEmbeddings = [...embeddingData].sort((a, b) => a.index - b.index);\n    return sortedEmbeddings.map((data) => normalizeEmbedding(data.embedding));\n  }\n\n  protected override extractResponseMetadata(\n    response: OrchestrationEmbeddingResponse,\n  ): ResponseMetadata {\n    return extractResponseMetadata(response, \"response\");\n  }\n\n  protected extractTokenCount(response: OrchestrationEmbeddingResponse): number {\n    const tokenUsage = response.getTokenUsage();\n    return tokenUsage.total_tokens;\n  }\n\n  protected getUrl(): string {\n    return \"sap-ai:orchestration/embeddings\";\n  }\n\n  protected override resolveWarnings(\n    settings: SAPAIEmbeddingSettings,\n    warnings: SharedV3Warning[],\n  ): void {\n    validateMaskingProvidersDeprecation(settings, warnings);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAkCO,IAAM,sCAAN,cAAkD,2BAGvD;AAAA,EACiB;AAAA,EAEjB,YAAY,aAAgD;AAC1D,UAAM;AACN,SAAK,cAAc;AAAA,EACrB;AAAA,EAEU,aACR,QACA,UACA,kBAC8B;AAC9B,UAAM,eAAe,KAAK,iBAAiB,UAAU,gBAAgB;AAErE,UAAM,kBAAwC;AAAA,MAC5C,OAAO;AAAA,QACL,MAAM,OAAO;AAAA,QACb,GAAI,QAAQ,YAAY,IAAI,EAAE,QAAQ,aAAa,IAAI,CAAC;AAAA,QACxD,GAAI,SAAS,eAAe,EAAE,SAAS,SAAS,aAAa,IAAI,CAAC;AAAA,MACpE;AAAA,IACF;AAEA,UAAM,eAAsC;AAAA,MAC1C,YAAY;AAAA,MACZ,GAAI,SAAS,WAAW,QAAQ,SAAS,OAAO,IAC5C,EAAE,SAAS,SAAS,QAAyB,IAC7C,CAAC;AAAA,IACP;AAEA,WAAO,IAAI,KAAK,YAAY,cAAc,OAAO,kBAAkB,OAAO,WAAW;AAAA,EACvF;AAAA,EAEA,MAAgB,YACd,QACA,QACA,eACA,aACyC;AACzC,WAAO,OAAO;AAAA,MACZ,EAAE,OAAO,QAAQ,MAAM,cAAc;AAAA,MACrC,cAAc,EAAE,QAAQ,YAAY,IAAI;AAAA,IAC1C;AAAA,EACF;AAAA,EAEU,kBACR,UAC6B;AAC7B,UAAM,gBAAgB,SAAS,cAAc;AAC7C,UAAM,mBAAmB,CAAC,GAAG,aAAa,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK;AAC5E,WAAO,iBAAiB,IAAI,CAAC,SAAS,mBAAmB,KAAK,SAAS,CAAC;AAAA,EAC1E;AAAA,EAEmB,wBACjB,UACkB;AAClB,WAAO,wBAAwB,UAAU,UAAU;AAAA,EACrD;AAAA,EAEU,kBAAkB,UAAkD;AAC5E,UAAM,aAAa,SAAS,cAAc;AAC1C,WAAO,WAAW;AAAA,EACpB;AAAA,EAEU,SAAiB;AACzB,WAAO;AAAA,EACT;AAAA,EAEmB,gBACjB,UACA,UACM;AACN,wCAAoC,UAAU,QAAQ;AAAA,EACxD;AACF;","names":[]}

package/dist/orchestration-language-model-strategy-4TKRZK7U.js.map

@@ -1 +0,0 @@
-{"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":[]}