@jerome-benoit/sap-ai-provider-v2 5.0.3 → 5.1.0

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

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