@jerome-benoit/sap-ai-provider 4.7.1 → 4.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -0
- package/dist/{chunk-XIWHF23D.js → chunk-3ZSXTKOK.js} +399 -117
- package/dist/{chunk-XIWHF23D.js.map → chunk-3ZSXTKOK.js.map} +1 -1
- package/dist/{chunk-OA6TJHD2.js → chunk-BVDSJ4IZ.js} +10 -4
- package/dist/chunk-BVDSJ4IZ.js.map +1 -0
- package/dist/{chunk-BZWUUBX2.js → chunk-H5KD4EPO.js} +8 -2
- package/dist/chunk-H5KD4EPO.js.map +1 -0
- package/dist/{chunk-HDOSHLV6.js → chunk-KVOLFUQJ.js} +2 -2
- package/dist/{chunk-RUCURXS7.js → chunk-TQXCNZBC.js} +11 -5
- package/dist/chunk-TQXCNZBC.js.map +1 -0
- package/dist/{foundation-models-embedding-model-strategy-TACUPFS2.js → foundation-models-embedding-model-strategy-SWRJNFD4.js} +7 -6
- package/dist/foundation-models-embedding-model-strategy-SWRJNFD4.js.map +1 -0
- package/dist/{foundation-models-language-model-strategy-LLWYUGA3.js → foundation-models-language-model-strategy-LRAC25ZY.js} +14 -9
- package/dist/foundation-models-language-model-strategy-LRAC25ZY.js.map +1 -0
- package/dist/index.cjs +447 -135
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +22 -1
- package/dist/index.d.ts +22 -1
- package/dist/index.js +14 -10
- package/dist/index.js.map +1 -1
- package/dist/{orchestration-embedding-model-strategy-RYI3HWRZ.js → orchestration-embedding-model-strategy-C5G735Q2.js} +8 -7
- package/dist/orchestration-embedding-model-strategy-C5G735Q2.js.map +1 -0
- package/dist/{orchestration-language-model-strategy-NIUPRYDW.js → orchestration-language-model-strategy-NUHYRIXH.js} +16 -10
- package/dist/orchestration-language-model-strategy-NUHYRIXH.js.map +1 -0
- package/package.json +18 -18
- package/dist/chunk-BZWUUBX2.js.map +0 -1
- package/dist/chunk-OA6TJHD2.js.map +0 -1
- package/dist/chunk-RUCURXS7.js.map +0 -1
- package/dist/foundation-models-embedding-model-strategy-TACUPFS2.js.map +0 -1
- package/dist/foundation-models-language-model-strategy-LLWYUGA3.js.map +0 -1
- package/dist/orchestration-embedding-model-strategy-RYI3HWRZ.js.map +0 -1
- package/dist/orchestration-language-model-strategy-NIUPRYDW.js.map +0 -1
- /package/dist/{chunk-HDOSHLV6.js.map → chunk-KVOLFUQJ.js.map} +0 -0
|
@@ -0,0 +1 @@
|
|
|
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 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 mergeRequestConfig,\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 \"fallbackModuleConfigs\",\n \"promptTemplateRef\",\n \"responseFormat\",\n \"tools\",\n \"modelParams\",\n \"modelVersion\",\n] as const;\n\n/**\n * Provider options that are ignored when using orchestrationConfigRef.\n * Subset of CONFIG_REF_IGNORED_MODULES that can be passed via providerOptions.\n * @internal\n */\nconst CONFIG_REF_IGNORED_PROVIDER_OPTIONS = [\"promptTemplateRef\", \"modelParams\"] as const;\n\n/**\n * Copies non-empty orchestration modules from source to target.\n * @param target - Target object to copy modules into.\n * @param source - Source object containing module configurations.\n * @internal\n */\nfunction copyOrchestrationModules(\n target: Record<string, unknown>,\n source: Record<string, unknown>,\n): void {\n for (const key of ORCHESTRATION_MODULE_KEYS) {\n const value = source[key];\n if (value && hasKeys(value)) {\n target[key] = value;\n }\n }\n}\n\n/**\n * Checks if a value is a valid 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 requestConfig: CustomRequestConfig | undefined,\n ): Promise<SDKResponse> {\n const response = await client.chatCompletion(\n request,\n mergeRequestConfig(requestConfig, abortSignal),\n );\n\n const { requestId, responseId } = this.extractMetadata(response);\n\n return {\n getCitations: () =>\n (response as { getCitations?: () => SDKCitation[] | undefined }).getCitations?.(),\n getContent: () => response.getContent(),\n getFinishReason: () => response.getFinishReason(),\n getIntermediateFailures: () =>\n (\n response as { getIntermediateFailures?: () => undefined | unknown[] }\n ).getIntermediateFailures?.(),\n getTokenUsage: () => response.getTokenUsage(),\n getToolCalls: () => response.getToolCalls(),\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment -- SAP SDK types headers as any\n rawResponse: { headers: response.rawResponse.headers },\n requestId,\n responseId,\n };\n }\n\n protected async executeStreamCall(\n client: OrchestrationClientInstance,\n request: OrchestrationRequest,\n abortSignal: AbortSignal | undefined,\n settings: OrchestrationModelSettings,\n requestConfig: CustomRequestConfig | undefined,\n ): Promise<StreamCallResponse> {\n const sdkStreamOptions = this.buildSdkStreamOptions(settings.streamOptions);\n const streamResponse = await client.stream(\n request,\n abortSignal,\n sdkStreamOptions,\n mergeRequestConfig(requestConfig, undefined),\n );\n\n const { requestId, responseHeaders, responseId } = this.extractMetadata(streamResponse);\n\n return {\n getCitations: () =>\n (streamResponse as { getCitations?: () => SDKCitation[] | undefined }).getCitations?.(),\n getFinishReason: () => streamResponse.getFinishReason(),\n getIntermediateFailures: () =>\n (\n streamResponse as { getIntermediateFailures?: () => undefined | unknown[] }\n ).getIntermediateFailures?.(),\n getTokenUsage: () => streamResponse.getTokenUsage(),\n requestId,\n responseHeaders,\n responseId,\n stream: streamResponse.stream as AsyncIterable<SDKStreamChunk>,\n };\n }\n\n protected getCompletionIdPath(): readonly string[] {\n return [\"final_result\", \"id\"];\n }\n\n protected getEscapeTemplatePlaceholders(\n sapOptions: Record<string, unknown> | undefined,\n settings: OrchestrationModelSettings,\n ): boolean {\n return (\n (sapOptions?.escapeTemplatePlaceholders as boolean | undefined) ??\n settings.escapeTemplatePlaceholders ??\n true\n );\n }\n\n protected getParamMappings(): readonly ParamMapping[] {\n return ORCHESTRATION_PARAM_MAPPINGS;\n }\n\n protected override getPartProviderOptionsParser(): ParsePartProviderOptions | undefined {\n return parseSAPPartProviderOptions;\n }\n\n protected getUrl(): string {\n return \"sap-ai:orchestration\";\n }\n\n /**\n * Resolves orchestration-specific extra state: `configRef`, `promptTemplateRef`,\n * and `tools`. Pushes the masking-providers deprecation warning when masking\n * is locally configured (skipped under `configRef` because the server-side\n * configuration overrides it).\n * @param _config - Strategy configuration (unused).\n * @param settings - Model settings.\n * @param sapOptions - Parsed provider options.\n * @param options - AI SDK call options.\n * @param warnings - Shared warnings sink.\n * @returns Resolved orchestration state.\n * @internal\n */\n protected override resolveAdditionalState(\n _config: LanguageModelStrategyConfig,\n settings: OrchestrationModelSettings,\n sapOptions: Record<string, unknown> | undefined,\n options: LanguageModelV3CallOptions,\n warnings: SharedV3Warning[],\n ): OrchestrationResolvedState {\n const configRef = this.resolveConfigRef(sapOptions, settings);\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
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@jerome-benoit/sap-ai-provider",
|
|
3
|
-
"version": "4.
|
|
3
|
+
"version": "4.8.0",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "SAP AI Provider for Vercel AI SDK (powered by @sap-ai-sdk/orchestration and @sap-ai-sdk/foundation-models)",
|
|
6
6
|
"keywords": [
|
|
@@ -27,7 +27,7 @@
|
|
|
27
27
|
"license": "Apache-2.0",
|
|
28
28
|
"author": "jerome-benoit",
|
|
29
29
|
"volta": {
|
|
30
|
-
"node": "24.
|
|
30
|
+
"node": "24.18.0"
|
|
31
31
|
},
|
|
32
32
|
"main": "./dist/index.cjs",
|
|
33
33
|
"module": "./dist/index.js",
|
|
@@ -78,33 +78,33 @@
|
|
|
78
78
|
"type-check": "tsc --noEmit"
|
|
79
79
|
},
|
|
80
80
|
"dependencies": {
|
|
81
|
-
"@ai-sdk/provider": "^3.0.
|
|
82
|
-
"@ai-sdk/provider-utils": "^4.0.
|
|
83
|
-
"@sap-ai-sdk/foundation-models": "^2.
|
|
84
|
-
"@sap-ai-sdk/orchestration": "^2.
|
|
81
|
+
"@ai-sdk/provider": "^3.0.13",
|
|
82
|
+
"@ai-sdk/provider-utils": "^4.0.35",
|
|
83
|
+
"@sap-ai-sdk/foundation-models": "^2.12.0",
|
|
84
|
+
"@sap-ai-sdk/orchestration": "^2.12.0",
|
|
85
85
|
"zod": "^4.4.3"
|
|
86
86
|
},
|
|
87
87
|
"devDependencies": {
|
|
88
|
-
"@ai-hero/sandcastle": "^0.
|
|
88
|
+
"@ai-hero/sandcastle": "^0.12.0",
|
|
89
89
|
"@edge-runtime/vm": "^5.0.0",
|
|
90
90
|
"@eslint/js": "^10.0.1",
|
|
91
|
-
"@types/node": "^25.9.
|
|
92
|
-
"@vitest/coverage-v8": "^4.1.
|
|
91
|
+
"@types/node": "^25.9.4",
|
|
92
|
+
"@vitest/coverage-v8": "^4.1.9",
|
|
93
93
|
"dotenv": "^17.4.2",
|
|
94
|
-
"eslint": "^10.
|
|
95
|
-
"eslint-plugin-jsdoc": "^63.0.
|
|
96
|
-
"eslint-plugin-perfectionist": "^5.9.
|
|
97
|
-
"globals": "^17.
|
|
94
|
+
"eslint": "^10.6.0",
|
|
95
|
+
"eslint-plugin-jsdoc": "^63.0.10",
|
|
96
|
+
"eslint-plugin-perfectionist": "^5.9.1",
|
|
97
|
+
"globals": "^17.7.0",
|
|
98
98
|
"lefthook": "^2.1.9",
|
|
99
99
|
"markdown-link-check": "^3.14.2",
|
|
100
|
-
"markdownlint-cli2": "^0.
|
|
100
|
+
"markdownlint-cli2": "^0.23.0",
|
|
101
101
|
"mermaid-validate": "^1.3.2",
|
|
102
|
-
"prettier": "^3.
|
|
102
|
+
"prettier": "^3.9.4",
|
|
103
103
|
"tsup": "^8.5.1",
|
|
104
|
-
"tsx": "^4.22.
|
|
104
|
+
"tsx": "^4.22.5",
|
|
105
105
|
"typescript": "^6.0.3",
|
|
106
|
-
"typescript-eslint": "^8.
|
|
107
|
-
"vitest": "^4.1.
|
|
106
|
+
"typescript-eslint": "^8.62.1",
|
|
107
|
+
"vitest": "^4.1.9"
|
|
108
108
|
},
|
|
109
109
|
"peerDependencies": {
|
|
110
110
|
"ai": "^5.0.0 || ^6.0.0"
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/strategy-utils.ts","../src/stream-transformer.ts"],"sourcesContent":["/**\n * Shared utilities for SAP AI Core strategy implementations.\n */\nimport type {\n EmbeddingModelV3CallOptions,\n EmbeddingModelV3Embedding,\n EmbeddingModelV3Result,\n JSONArray,\n JSONObject,\n LanguageModelV3CallOptions,\n LanguageModelV3Content,\n LanguageModelV3FinishReason,\n LanguageModelV3FunctionTool,\n LanguageModelV3GenerateResult,\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 { parseProviderOptions } from \"@ai-sdk/provider-utils\";\nimport { z } from \"zod\";\n\nimport type { ParsePartProviderOptions } from \"./sap-ai-provider-options.js\";\n\nimport { deepMerge } from \"./deep-merge.js\";\nimport { normalizeHeaders } from \"./sap-ai-error.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 * Anthropic prompt-cache breakdown surfaced via `providerMetadata['sap-ai'].cacheUsage`.\n *\n * Mirrors the per-TTL ephemeral bucket shape returned by the SAP AI SDK token usage\n * payload (`prompt_tokens_details.cache_creation_token_details`).\n * @internal\n */\nexport type AnthropicCacheUsage = NonNullable<\n NonNullable<SDKTokenUsage[\"prompt_tokens_details\"]>[\"cache_creation_token_details\"]\n>;\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 * Optional plumbing accepted by `convertToolsToSAPFormat`.\n *\n * Strategies that honour per-tool `providerOptions['sap-ai']` (e.g. orchestration\n * Anthropic `cacheControl`) supply a `parser`; Foundation Models omits it.\n * @internal\n */\nexport interface ConvertToolsOptions {\n readonly parser?: ParsePartProviderOptions;\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 requestId?: string;\n readonly responseHeaders?: Record<string, string>;\n readonly totalTokens: number;\n readonly version: string;\n readonly warnings?: readonly SharedV3Warning[];\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 /** SAP-pipeline request id resolved by `extractResponseMetadata`. */\n readonly requestId?: string;\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 * Response metadata extracted from an SDK response: server-provided request id\n * and normalised HTTP headers.\n * @internal\n */\nexport interface ResponseMetadata {\n readonly headers: Record<string, string> | undefined;\n readonly requestId: string | undefined;\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 cache_control?: { ttl?: \"1h\" | \"5m\"; type: \"ephemeral\" };\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 /** SAP-pipeline request id resolved by `extractResponseMetadata`. */\n requestId?: string;\n responseId?: string;\n}\n\nexport {\n createInitialStreamState,\n createStreamTransformer,\n StreamIdGenerator,\n type StreamState,\n type StreamTransformerConfig,\n type ToolCallInProgress,\n} from \"./stream-transformer.js\";\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 accepted_prediction_tokens?: number;\n audio_tokens?: number;\n reasoning_tokens?: number;\n rejected_prediction_tokens?: number;\n };\n prompt_tokens?: number;\n prompt_tokens_details?: {\n audio_tokens?: number;\n cache_creation_token_details?: {\n ephemeral_1h_input_tokens?: number;\n ephemeral_5m_input_tokens?: number;\n };\n cache_creation_tokens?: number;\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 * 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 * Returns the Anthropic prompt-caching slice of `providerMetadata[provider]` as a\n * spread-ready fragment.\n *\n * Returns `{ cacheUsage }` when at least one ephemeral TTL bucket is populated;\n * otherwise `{}` so callers can `...` it unconditionally.\n * @param tokenUsage - Raw token usage from the SAP SDK response.\n * @returns Spread-ready provider-metadata fragment.\n * @internal\n */\nexport function buildAnthropicCacheMetadata(tokenUsage: null | SDKTokenUsage | undefined): {\n cacheUsage?: AnthropicCacheUsage;\n} {\n const details = tokenUsage?.prompt_tokens_details?.cache_creation_token_details;\n if (\n !details ||\n ((details.ephemeral_5m_input_tokens ?? 0) === 0 &&\n (details.ephemeral_1h_input_tokens ?? 0) === 0)\n ) {\n return {};\n }\n return { cacheUsage: details };\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 {\n embeddings,\n modelId,\n providerName,\n requestId,\n responseHeaders,\n totalTokens,\n version,\n warnings,\n } = config;\n\n const providerMetadata: SharedV3ProviderMetadata = {\n [providerName]: {\n model: modelId,\n ...(requestId ? { requestId } : {}),\n version,\n },\n };\n\n return {\n embeddings,\n providerMetadata,\n ...(responseHeaders ? { response: { headers: responseHeaders } } : {}),\n usage: { tokens: totalTokens },\n warnings: warnings ? [...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 {\n modelId,\n providerName,\n requestBody,\n requestId,\n response,\n responseHeaders,\n version,\n 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 ...buildAnthropicCacheMetadata(tokenUsage),\n finishReason: finishReasonRaw ?? \"unknown\",\n finishReasonMapped: finishReason,\n ...(intermediateFailures?.length\n ? { intermediateFailures: sanitizeAsJSONArray(intermediateFailures) }\n : {}),\n ...(requestId ? { requestId } : {}),\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 * Computes the non-cached prompt tokens from a prompt-token total and its cache slices.\n *\n * Returns `undefined` when the total is unknown. Returns the total unchanged when no\n * cache breakdown is reported. Otherwise subtracts both cache buckets and clamps the\n * result at zero to defend against inconsistent SDK token counts where\n * `cached + cacheWrite > prompt`.\n * @param promptTokens - Total prompt tokens reported by the SDK.\n * @param cachedTokens - Tokens served from the prompt cache.\n * @param cacheWriteTokens - Tokens written to the prompt cache.\n * @returns The non-cached prompt token count, or `undefined` when unknown.\n * @internal\n */\nexport function computeNoCache(\n promptTokens: number | undefined,\n cachedTokens: number | undefined,\n cacheWriteTokens: number | undefined,\n): number | undefined {\n if (promptTokens == null) {\n return undefined;\n }\n if (cachedTokens == null && cacheWriteTokens == null) {\n return promptTokens;\n }\n return Math.max(0, promptTokens - (cachedTokens ?? 0) - (cacheWriteTokens ?? 0));\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 * @param options - Optional per-tool parsing config.\n * @param options.parser - Reads per-tool `providerOptions['sap-ai']` and returns parsed directives, or `undefined` when none apply.\n * @param options.warnings - Sink for Zod validation issues raised while parsing.\n * @returns The converted tools and any warnings.\n * @internal\n */\nexport function convertToolsToSAPFormat<T extends SAPTool<unknown>>(\n tools: AISDKTool[] | undefined,\n options: ConvertToolsOptions = {},\n): ConvertedToolsResult<T> {\n const { parser, warnings: parserWarnings } = options;\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 functionTool = tool as LanguageModelV3FunctionTool;\n const { parameters, warning } = extractToolParameters(functionTool);\n if (warning) {\n warnings.push(warning);\n }\n\n const cacheControl = parser?.(functionTool.providerOptions, parserWarnings)?.cacheControl;\n\n return {\n ...(cacheControl ? { cache_control: cacheControl } : {}),\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 * Resolves the SDK completion identifier from an internal `_data` payload, falling back to\n * the pipeline request id reported by `getRequestId()` when the path is not present.\n *\n * Tolerates SDKs that omit `_data` entirely or expose `getRequestId()` as a non-function.\n * @param response - SDK response object exposing `_data` and optionally `getRequestId()`.\n * @param response._data - Internal SDK payload that holds the completion id under `dataPath`.\n * @param response.getRequestId - Function returning the SAP AI Core pipeline request id.\n * @param dataPath - Dotted property path traversed under `_data` (e.g. `[\"final_result\",\"id\"]`).\n * @returns The first non-empty completion id found along the path, or `undefined`.\n * @internal\n */\nexport function extractCompletionId(\n response: { _data?: unknown; getRequestId?: () => string | undefined },\n dataPath: readonly string[],\n): string | undefined {\n let cursor: unknown = response._data;\n for (const key of dataPath) {\n if (cursor !== null && typeof cursor === \"object\" && key in cursor) {\n cursor = (cursor as Record<string, unknown>)[key];\n } else {\n cursor = undefined;\n break;\n }\n }\n if (typeof cursor === \"string\" && cursor.length > 0) {\n return cursor;\n }\n const fn = response.getRequestId;\n if (typeof fn !== \"function\") {\n return undefined;\n }\n try {\n const rid = fn.call(response);\n return typeof rid === \"string\" && rid.length > 0 ? rid : undefined;\n } catch {\n return undefined;\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 the request id and normalised headers from an SDK response.\n *\n * Resolves `requestId` from `getRequestId()` first; when absent, falls back to the\n * `x-request-id` header. Tolerates SDKs that omit `getRequestId`, expose it as a\n * non-function, or raise from the `headers` accessor. `field` selects the underlying\n * HttpResponse wrapper (`rawResponse` for foundation-models, `response` for orchestration).\n * @param response - SDK response object.\n * @param field - Property containing the underlying HttpResponse wrapper.\n * @returns Combined `{ requestId, headers }` with both fields defensively gathered.\n * @internal\n */\nexport function extractResponseMetadata(\n response: unknown,\n field: \"rawResponse\" | \"response\",\n): ResponseMetadata {\n let requestId: string | undefined;\n const fn = (response as null | { getRequestId?: unknown })?.getRequestId;\n if (typeof fn === \"function\") {\n try {\n const value = (fn as () => string | undefined).call(response);\n requestId = typeof value === \"string\" && value.length > 0 ? value : undefined;\n } catch {\n requestId = undefined;\n }\n }\n\n let rawHeaders: unknown;\n try {\n const wrapper = (response as null | Record<string, unknown>)?.[field] as\n | undefined\n | { headers?: unknown };\n rawHeaders = wrapper?.headers;\n } catch {\n rawHeaders = undefined;\n }\n const headers = rawHeaders === undefined ? undefined : normalizeHeaders(rawHeaders);\n\n if (requestId === undefined && typeof headers?.[\"x-request-id\"] === \"string\") {\n requestId = headers[\"x-request-id\"];\n }\n\n return { headers, requestId };\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 case \"guardrail_intervened\":\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 case \"tool_use\":\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 *\n * `usage.raw` is populated only when the SDK reports fields not represented in\n * `inputTokens` / `outputTokens` (audio or prediction-token buckets); otherwise omitted.\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 cacheWriteTokens = tokenUsage?.prompt_tokens_details?.cache_creation_tokens;\n const reasoningTokens = tokenUsage?.completion_tokens_details?.reasoning_tokens;\n const promptTokens = tokenUsage?.prompt_tokens;\n\n const promptDetails = tokenUsage?.prompt_tokens_details;\n const completionDetails = tokenUsage?.completion_tokens_details;\n const hasUnmappedFields =\n promptDetails?.audio_tokens != null ||\n completionDetails?.audio_tokens != null ||\n completionDetails?.accepted_prediction_tokens != null ||\n completionDetails?.rejected_prediction_tokens != null;\n\n return {\n inputTokens: {\n cacheRead: cachedTokens,\n cacheWrite: cacheWriteTokens,\n noCache: computeNoCache(promptTokens, cachedTokens, cacheWriteTokens),\n total: promptTokens,\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 ...(hasUnmappedFields && tokenUsage ? { raw: sanitizeAsJSONObject(tokenUsage) } : {}),\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\nconst jsonReplacer = (_key: string, value: unknown): unknown =>\n typeof value === \"bigint\" ? value.toString() : value;\n\n/**\n * Coerces an array into a JSON-conformant payload suitable for `providerMetadata` values.\n *\n * Non-serialisable entries (functions, symbols, `undefined`) are dropped or replaced\n * by `null` per `JSON.stringify` defaults. Bigint values become decimal strings.\n * Returns an empty array when the entire payload cannot be serialised (e.g. circular\n * references).\n * @param value - Candidate array.\n * @returns JSON-safe array.\n * @internal\n */\nexport function sanitizeAsJSONArray(value: readonly unknown[]): JSONArray {\n try {\n return JSON.parse(JSON.stringify(value, jsonReplacer)) as JSONArray;\n } catch {\n return [];\n }\n}\n\n/**\n * Coerces an object into a JSON-conformant payload suitable for `providerMetadata` or\n * `LanguageModelV3Usage.raw`.\n *\n * Non-serialisable values are dropped per `JSON.stringify` defaults. Bigint values\n * become decimal strings. Returns an empty object when the entire payload cannot be\n * serialised.\n * @param value - Candidate object.\n * @returns JSON-safe object.\n * @internal\n */\nexport function sanitizeAsJSONObject(value: object): JSONObject {\n try {\n return JSON.parse(JSON.stringify(value, jsonReplacer)) as JSONObject;\n } catch {\n return {};\n }\n}\n","/**\n * Stream transformer for converting SAP AI SDK streaming responses\n * into Vercel AI SDK LanguageModelV3StreamPart events.\n */\nimport type {\n LanguageModelV3CallOptions,\n LanguageModelV3FinishReason,\n LanguageModelV3StreamPart,\n LanguageModelV3Usage,\n SharedV3Warning,\n} from \"@ai-sdk/provider\";\n\nimport { convertAsyncIteratorToReadableStream } from \"@ai-sdk/provider-utils\";\n\nimport type {\n SDKCitation,\n SDKDeltaToolCall,\n SDKStreamChunk,\n SDKTokenUsage,\n} from \"./strategy-utils.js\";\n\nimport {\n buildAnthropicCacheMetadata,\n createAISDKRequestBodySummary,\n mapFinishReason,\n mapTokenUsage,\n sanitizeAsJSONArray,\n} from \"./strategy-utils.js\";\n\n/**\n * @internal\n */\nexport interface StreamState {\n activeText: boolean;\n finishReason: LanguageModelV3FinishReason;\n isFirstChunk: boolean;\n usage: LanguageModelV3Usage;\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 /** SAP-pipeline request id resolved by `extractResponseMetadata`. */\n readonly requestId?: 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 * 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 requestId,\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 didEmitAnyToolCalls = finalizeToolCalls(\n controller,\n toolCallsInProgress,\n idGenerator,\n emitToolInputStart,\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 streamState.usage = mapTokenUsage(finalUsage);\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 ...buildAnthropicCacheMetadata(finalUsage),\n finishReason: streamState.finishReason.raw ?? \"unknown\",\n finishReasonMapped: streamState.finishReason,\n ...(streamIntermediateFailures?.length\n ? {\n intermediateFailures: sanitizeAsJSONArray(streamIntermediateFailures),\n }\n : {}),\n ...(requestId ? { requestId } : {}),\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 handleStreamError(chunk, controller, convertToAISDKError, options, url);\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 textBlockId = handleTextDelta(\n deltaContent,\n controller,\n streamState,\n textBlockId,\n idGenerator,\n );\n }\n\n if (Array.isArray(deltaToolCalls) && deltaToolCalls.length > 0) {\n handleToolCallDeltas(deltaToolCalls, controller, toolCallsInProgress, emitToolInputStart);\n }\n\n const chunkFinishReason = chunk.getFinishReason();\n if (chunkFinishReason) {\n streamState.finishReason = mapFinishReason(chunkFinishReason);\n\n if (streamState.finishReason.unified === \"tool-calls\") {\n finalizeToolCalls(controller, toolCallsInProgress, idGenerator, emitToolInputStart);\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 * Finalizes pending tool calls by emitting tool-input-end and tool-call events.\n * @param controller - The transform stream controller.\n * @param toolCallsInProgress - Map of in-progress tool calls.\n * @param idGenerator - ID generator for tool calls without IDs.\n * @param emitToolInputStart - Function to emit tool-input-start events.\n * @returns Whether any tool calls were finalized.\n * @internal\n */\nfunction finalizeToolCalls(\n controller: TransformStreamDefaultController<LanguageModelV3StreamPart>,\n toolCallsInProgress: Map<number, ToolCallInProgress>,\n idGenerator: StreamIdGenerator,\n emitToolInputStart: (\n tc: ToolCallInProgress,\n ctrl: TransformStreamDefaultController<LanguageModelV3StreamPart>,\n ) => void,\n): boolean {\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 return didEmitAnyToolCalls;\n}\n\n/**\n * Handles a stream error by converting it and enqueuing an error event.\n * @param error - The error from the stream iteration.\n * @param controller - The transform stream controller.\n * @param convertToAISDKError - Error conversion function.\n * @param options - Language model call options for context.\n * @param url - The request URL for error context.\n * @internal\n */\nfunction handleStreamError(\n error: Error,\n controller: TransformStreamDefaultController<LanguageModelV3StreamPart>,\n convertToAISDKError: StreamTransformerConfig[\"convertToAISDKError\"],\n options: LanguageModelV3CallOptions,\n url: string,\n): void {\n const aiError = convertToAISDKError(error, {\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}\n\n/**\n * Handles a text delta by managing text block lifecycle.\n * @param deltaContent - The text delta content.\n * @param controller - The transform stream controller.\n * @param streamState - The current stream state.\n * @param currentTextBlockId - The current text block ID (or null).\n * @param idGenerator - ID generator for new text blocks.\n * @returns The current text block ID (may be newly created).\n * @internal\n */\nfunction handleTextDelta(\n deltaContent: string,\n controller: TransformStreamDefaultController<LanguageModelV3StreamPart>,\n streamState: StreamState,\n currentTextBlockId: null | string,\n idGenerator: StreamIdGenerator,\n): string {\n let textBlockId = currentTextBlockId;\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 return textBlockId;\n }\n return currentTextBlockId ?? idGenerator.generateTextBlockId();\n}\n\n/**\n * Handles tool call delta chunks by assembling tool calls progressively.\n * @param deltaToolCalls - The tool call delta chunks from the stream.\n * @param controller - The transform stream controller.\n * @param toolCallsInProgress - Map of in-progress tool calls by index.\n * @param emitToolInputStart - Function to emit tool-input-start events.\n * @internal\n */\nfunction handleToolCallDeltas(\n deltaToolCalls: SDKDeltaToolCall[],\n controller: TransformStreamDefaultController<LanguageModelV3StreamPart>,\n toolCallsInProgress: Map<number, ToolCallInProgress>,\n emitToolInputStart: (\n tc: ToolCallInProgress,\n ctrl: TransformStreamDefaultController<LanguageModelV3StreamPart>,\n ) => void,\n): void {\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/**\n * Wraps an async iterable to catch iteration errors and yield them as values.\n *\n * Intentionally single-error: after yielding the first Error, this generator completes.\n * The downstream TransformStream terminates via `controller.error()` on receiving an Error,\n * so no further values would be consumed. This is a cooperative contract — the stream\n * pipeline guarantees no reads after the first error event.\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":"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","names":[]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/base-embedding-model-strategy.ts"],"sourcesContent":["/** Base class for embedding model strategies using the Template Method pattern. */\nimport type {\n EmbeddingModelV3CallOptions,\n EmbeddingModelV3Embedding,\n EmbeddingModelV3Result,\n SharedV3Warning,\n} from \"@ai-sdk/provider\";\n\nimport { TooManyEmbeddingValuesForCallError } from \"@ai-sdk/provider\";\n\nimport type { SAPAIEmbeddingSettings } from \"./sap-ai-settings.js\";\nimport type { EmbeddingModelAPIStrategy, EmbeddingModelStrategyConfig } from \"./sap-ai-strategy.js\";\n\nimport { deepMerge } from \"./deep-merge.js\";\nimport { convertToAISDKError } from \"./sap-ai-error.js\";\nimport {\n buildEmbeddingResult,\n type EmbeddingProviderOptions,\n type EmbeddingType,\n prepareEmbeddingCall,\n type ResponseMetadata,\n} from \"./strategy-utils.js\";\nimport { VERSION } from \"./version.js\";\n\n/**\n * Abstract base class for embedding model strategies using the Template Method pattern.\n * @template TClient - The SDK client type (e.g., AzureOpenAiEmbeddingClient, OrchestrationEmbeddingClient).\n * @template TResponse - The API response type from the SDK client.\n * @internal\n */\nexport abstract class BaseEmbeddingModelStrategy<\n TClient,\n TResponse,\n> implements EmbeddingModelAPIStrategy {\n /**\n * Template method implementing the shared embedding algorithm.\n * @param config - Strategy configuration.\n * @param settings - Embedding model settings.\n * @param options - AI SDK call options.\n * @param maxEmbeddingsPerCall - Maximum embeddings per call.\n * @returns Complete embedding result for AI SDK.\n * @internal\n */\n async doEmbed(\n config: EmbeddingModelStrategyConfig,\n settings: SAPAIEmbeddingSettings,\n options: EmbeddingModelV3CallOptions,\n maxEmbeddingsPerCall: number,\n ): Promise<EmbeddingModelV3Result> {\n const { abortSignal, values } = options;\n\n try {\n const { embeddingOptions, providerName } = await prepareEmbeddingCall(\n { maxEmbeddingsPerCall, modelId: config.modelId, provider: config.provider },\n options,\n );\n\n const embeddingType = embeddingOptions?.type ?? settings.type ?? \"text\";\n\n const warnings: SharedV3Warning[] = [];\n this.resolveWarnings(settings, warnings);\n\n const client = this.createClient(config, settings, embeddingOptions);\n\n const response = await this.executeCall(client, values, embeddingType, abortSignal);\n\n const embeddings = this.extractEmbeddings(response);\n const totalTokens = this.extractTokenCount(response);\n const { headers: responseHeaders, requestId } = this.extractResponseMetadata(response);\n\n return buildEmbeddingResult({\n embeddings,\n modelId: config.modelId,\n providerName,\n requestId,\n responseHeaders,\n totalTokens,\n version: VERSION,\n warnings,\n });\n } catch (error) {\n if (error instanceof TooManyEmbeddingValuesForCallError) {\n throw error;\n }\n throw convertToAISDKError(error, {\n operation: \"doEmbed\",\n requestBody: { values: values.length },\n url: this.getUrl(),\n });\n }\n }\n\n /**\n * Creates the appropriate SDK client for this API.\n * @param config - Strategy configuration.\n * @param settings - Embedding model settings.\n * @param embeddingOptions - Parsed provider options from the call.\n * @returns SDK client instance.\n * @internal\n */\n protected abstract createClient(\n config: EmbeddingModelStrategyConfig,\n settings: SAPAIEmbeddingSettings,\n embeddingOptions: EmbeddingProviderOptions | undefined,\n ): TClient;\n\n /**\n * Executes the embedding API call.\n * @param client - SDK client instance.\n * @param values - Input strings to embed.\n * @param embeddingType - Type of embedding (text, query, document).\n * @param abortSignal - Optional abort signal.\n * @returns SDK response containing embeddings.\n * @internal\n */\n protected abstract executeCall(\n client: TClient,\n values: string[],\n embeddingType: EmbeddingType,\n abortSignal: AbortSignal | undefined,\n ): Promise<TResponse>;\n\n /**\n * Extracts embeddings from the SDK response.\n * @param response - SDK response containing embedding data.\n * @returns Array of normalized embedding vectors.\n * @internal\n */\n protected abstract extractEmbeddings(response: TResponse): EmbeddingModelV3Embedding[];\n\n /**\n * Extracts response metadata (request id and HTTP headers) from the SDK response.\n *\n * Default returns both fields as `undefined`; subclasses override to extract from the SDK response.\n * @param _response - SDK response.\n * @returns Combined `{ headers, requestId }` metadata.\n * @internal\n */\n protected extractResponseMetadata(_response: TResponse): ResponseMetadata {\n return { headers: undefined, requestId: undefined };\n }\n\n /**\n * Extracts total token count from the SDK response.\n * @param response - SDK response containing usage data.\n * @returns Total token count used for the embedding request.\n * @internal\n */\n protected abstract extractTokenCount(response: TResponse): number;\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 protected mergeModelParams(\n settings: SAPAIEmbeddingSettings,\n embeddingOptions: EmbeddingProviderOptions | undefined,\n ): Record<string, unknown> {\n return deepMerge(\n (settings.modelParams as Record<string, unknown> | undefined) ?? {},\n embeddingOptions?.modelParams ?? {},\n );\n }\n\n /**\n * Pushes API-specific deprecation or migration warnings into the shared\n * sink. Default no-op; subclasses override to surface settings-level\n * warnings (e.g. orchestration's masking_providers deprecation).\n * @param _settings - Embedding model settings.\n * @param _warnings - Shared warnings sink for the current call.\n * @internal\n */\n protected resolveWarnings(_settings: SAPAIEmbeddingSettings, _warnings: SharedV3Warning[]): void {\n return;\n }\n}\n"],"mappings":";;;;;;;;;;;;AAQA,SAAS,0CAA0C;AAsB5C,IAAe,6BAAf,MAGgC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUrC,MAAM,QACJ,QACA,UACA,SACA,sBACiC;AACjC,UAAM,EAAE,aAAa,OAAO,IAAI;AAEhC,QAAI;AACF,YAAM,EAAE,kBAAkB,aAAa,IAAI,MAAM;AAAA,QAC/C,EAAE,sBAAsB,SAAS,OAAO,SAAS,UAAU,OAAO,SAAS;AAAA,QAC3E;AAAA,MACF;AAEA,YAAM,gBAAgB,kBAAkB,QAAQ,SAAS,QAAQ;AAEjE,YAAM,WAA8B,CAAC;AACrC,WAAK,gBAAgB,UAAU,QAAQ;AAEvC,YAAM,SAAS,KAAK,aAAa,QAAQ,UAAU,gBAAgB;AAEnE,YAAM,WAAW,MAAM,KAAK,YAAY,QAAQ,QAAQ,eAAe,WAAW;AAElF,YAAM,aAAa,KAAK,kBAAkB,QAAQ;AAClD,YAAM,cAAc,KAAK,kBAAkB,QAAQ;AACnD,YAAM,EAAE,SAAS,iBAAiB,UAAU,IAAI,KAAK,wBAAwB,QAAQ;AAErF,aAAO,qBAAqB;AAAA,QAC1B;AAAA,QACA,SAAS,OAAO;AAAA,QAChB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,SAAS;AAAA,QACT;AAAA,MACF,CAAC;AAAA,IACH,SAAS,OAAO;AACd,UAAI,iBAAiB,oCAAoC;AACvD,cAAM;AAAA,MACR;AACA,YAAM,oBAAoB,OAAO;AAAA,QAC/B,WAAW;AAAA,QACX,aAAa,EAAE,QAAQ,OAAO,OAAO;AAAA,QACrC,KAAK,KAAK,OAAO;AAAA,MACnB,CAAC;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgDU,wBAAwB,WAAwC;AACxE,WAAO,EAAE,SAAS,QAAW,WAAW,OAAU;AAAA,EACpD;AAAA,EAiBU,iBACR,UACA,kBACyB;AACzB,WAAO;AAAA,MACJ,SAAS,eAAuD,CAAC;AAAA,MAClE,kBAAkB,eAAe,CAAC;AAAA,IACpC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUU,gBAAgB,WAAmC,WAAoC;AAC/F;AAAA,EACF;AACF;","names":[]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"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 { ParsePartProviderOptions } from \"./sap-ai-provider-options.js\";\nimport type { SAPAIModelSettings } from \"./sap-ai-settings.js\";\nimport type { LanguageModelAPIStrategy, LanguageModelStrategyConfig } from \"./sap-ai-strategy.js\";\n\nimport { convertToSAPMessages } from \"./convert-to-sap-messages.js\";\nimport { convertToAISDKError, normalizeHeaders } from \"./sap-ai-error.js\";\nimport { getProviderName, sapAILanguageModelProviderOptions } from \"./sap-ai-provider-options.js\";\nimport {\n buildGenerateResult,\n buildModelParams,\n createAISDKRequestBodySummary,\n createStreamTransformer,\n extractCompletionId,\n extractResponseMetadata,\n mapToolChoice,\n type ParamMapping,\n type SAPToolChoice,\n type SDKCitation,\n type SDKResponse,\n type SDKStreamChunk,\n type SDKTokenUsage,\n StreamIdGenerator,\n} from \"./strategy-utils.js\";\nimport { VERSION } from \"./version.js\";\n\n/**\n * Result of building common parts for a language model request.\n * @template TMessages - The message array type (e.g., `ChatMessage[]`, `AzureOpenAiChatCompletionRequestMessage[]`)\n * @template TToolChoice - The tool choice type (e.g., `SAPToolChoice`)\n * @internal\n */\nexport interface CommonBuildResult<TMessages extends unknown[] = unknown[], TToolChoice = unknown> {\n readonly messages: TMessages;\n readonly modelParams: Record<string, unknown>;\n readonly providerName: string;\n readonly resolvedState?: unknown;\n readonly sapOptions: Record<string, unknown> | undefined;\n readonly toolChoice: TToolChoice;\n readonly warnings: SharedV3Warning[];\n}\n\n/**\n * Stream response shape returned by executeStreamCall.\n * @internal\n */\nexport interface StreamCallResponse {\n readonly getCitations?: () => SDKCitation[] | undefined;\n readonly getFinishReason: () => null | string | undefined;\n readonly getIntermediateFailures?: () => undefined | unknown[];\n readonly getTokenUsage: () => null | SDKTokenUsage | undefined;\n /** SAP-pipeline request id resolved by `extractResponseMetadata`. */\n readonly requestId?: string;\n readonly responseHeaders?: Record<string, string>;\n /** Server-provided completion ID extracted from _data, if available. */\n readonly responseId?: string;\n readonly stream: AsyncIterable<SDKStreamChunk>;\n}\n\n/**\n * Abstract base class for language model strategies using the Template Method pattern.\n * @template TClient - The SDK client type (e.g., AzureOpenAiChatClient, OrchestrationClient).\n * @template TRequest - The API request type (e.g., AzureOpenAiChatCompletionParameters).\n * @template TSettings - The model settings type extending SAPAIModelSettings.\n * @internal\n */\nexport abstract class BaseLanguageModelStrategy<\n TClient,\n TRequest,\n TSettings extends SAPAIModelSettings = SAPAIModelSettings,\n> implements LanguageModelAPIStrategy<TSettings> {\n /**\n * Common parameter mappings for language model APIs.\n * @internal\n */\n static readonly COMMON_PARAM_MAPPINGS: readonly ParamMapping[] = [\n { camelCaseKey: \"maxTokens\", optionKey: \"maxOutputTokens\", outputKey: \"max_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 requestId: response.requestId,\n response,\n responseHeaders: normalizeHeaders(response.rawResponse.headers),\n version: VERSION,\n warnings: [...commonParts.warnings, ...warnings],\n });\n } catch (error) {\n throw convertToAISDKError(error, {\n operation: \"doGenerate\",\n requestBody: createAISDKRequestBodySummary(options),\n url: this.getUrl(),\n });\n }\n }\n\n async doStream(\n config: LanguageModelStrategyConfig,\n settings: TSettings,\n options: LanguageModelV3CallOptions,\n ): Promise<LanguageModelV3StreamResult> {\n try {\n const commonParts = await this.buildCommonParts(config, settings, options);\n const { request, warnings } = this.buildRequest(config, settings, options, commonParts);\n\n const client = this.createClient(config, settings, commonParts);\n\n const streamResponse = await this.executeStreamCall(\n client,\n request,\n options.abortSignal ?? undefined,\n settings,\n );\n\n const idGenerator = new StreamIdGenerator();\n const responseId = streamResponse.responseId ?? idGenerator.generateResponseId();\n\n const streamWarnings = this.collectStreamWarnings(settings, commonParts.sapOptions);\n\n const transformedStream = createStreamTransformer({\n convertToAISDKError,\n idGenerator,\n includeRawChunks: options.includeRawChunks ?? false,\n modelId: config.modelId,\n options,\n providerName: commonParts.providerName,\n requestId: streamResponse.requestId,\n responseId,\n sdkStream: streamResponse.stream,\n streamResponseGetCitations: streamResponse.getCitations,\n streamResponseGetFinishReason: streamResponse.getFinishReason,\n streamResponseGetIntermediateFailures: streamResponse.getIntermediateFailures,\n streamResponseGetTokenUsage: streamResponse.getTokenUsage,\n url: this.getUrl(),\n version: VERSION,\n warnings: [...commonParts.warnings, ...warnings, ...streamWarnings],\n });\n\n return {\n request: {\n body: request,\n },\n response: {\n headers: streamResponse.responseHeaders,\n },\n stream: transformedStream,\n };\n } catch (error) {\n throw convertToAISDKError(error, {\n operation: \"doStream\",\n requestBody: createAISDKRequestBodySummary(options),\n url: this.getUrl(),\n });\n }\n }\n\n /**\n * Builds common parts shared between doGenerate and doStream.\n * @param config - Strategy configuration.\n * @param settings - Model settings.\n * @param options - AI SDK call options.\n * @returns Common build result with typed messages and tool choice.\n * @internal\n */\n protected async buildCommonParts(\n config: LanguageModelStrategyConfig,\n settings: TSettings,\n options: LanguageModelV3CallOptions,\n ): Promise<CommonBuildResult<ChatMessage[], SAPToolChoice | undefined>> {\n const providerName = getProviderName(config.provider);\n\n const sapOptions = await parseProviderOptions({\n provider: providerName,\n providerOptions: options.providerOptions,\n schema: sapAILanguageModelProviderOptions,\n });\n\n const warnings: SharedV3Warning[] = [];\n\n const resolvedState = this.resolveAdditionalState(\n config,\n settings,\n sapOptions,\n options,\n warnings,\n );\n\n const messages = convertToSAPMessages(options.prompt, {\n escapeTemplatePlaceholders: this.getEscapeTemplatePlaceholders(sapOptions, settings),\n includeReasoning: this.getIncludeReasoning(sapOptions, settings),\n parsePartProviderOptions: this.getPartProviderOptionsParser(),\n warnings,\n });\n\n const { modelParams, warnings: paramWarnings } = buildModelParams({\n options,\n paramMappings: this.getParamMappings(),\n providerModelParams: sapOptions?.modelParams,\n settingsModelParams: settings.modelParams,\n });\n warnings.push(...paramWarnings);\n\n const toolChoice = mapToolChoice(options.toolChoice);\n\n return {\n messages,\n modelParams,\n providerName,\n resolvedState,\n sapOptions,\n toolChoice,\n warnings,\n };\n }\n\n /**\n * Builds the API-specific request body.\n * @param config - Strategy configuration.\n * @param settings - Model settings.\n * @param options - AI SDK call options.\n * @param commonParts - Common build result from base class.\n * @returns Request body and accumulated warnings.\n * @internal\n */\n protected abstract buildRequest(\n config: LanguageModelStrategyConfig,\n settings: TSettings,\n options: LanguageModelV3CallOptions,\n commonParts: CommonBuildResult<ChatMessage[], SAPToolChoice | undefined>,\n ): { readonly request: TRequest; readonly warnings: SharedV3Warning[] };\n\n /**\n * Collects stream-specific warnings.\n * Override in subclasses to add API-specific streaming warnings.\n * @param _settings - Model settings (unused in base implementation).\n * @param _sapOptions - Provider options (unused in base implementation).\n * @returns Array of warnings for streaming operations.\n * @internal\n */\n protected collectStreamWarnings(\n _settings: TSettings,\n _sapOptions?: Record<string, unknown>,\n ): SharedV3Warning[] {\n return [];\n }\n\n /**\n * Creates the appropriate SDK client for this API.\n * @param config - Strategy configuration.\n * @param settings - Model settings.\n * @param commonParts - Common build result (messages, options, etc.).\n * @returns SDK client instance.\n * @internal\n */\n protected abstract createClient(\n config: LanguageModelStrategyConfig,\n settings: TSettings,\n commonParts: CommonBuildResult<ChatMessage[], SAPToolChoice | undefined>,\n ): TClient;\n\n /**\n * Executes the non-streaming API call.\n * @param client - SDK client instance.\n * @param request - Request body.\n * @param abortSignal - Optional abort signal.\n * @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 * Resolves request id, completion id, and normalised headers from an SDK response.\n * @param response - Raw SDK response or stream response.\n * @returns Combined metadata fragment.\n * @internal\n */\n protected extractMetadata(response: unknown): {\n requestId?: string;\n responseHeaders?: Record<string, string>;\n responseId?: string;\n } {\n const responseId = extractCompletionId(\n response as { _data?: unknown; getRequestId?: () => string | undefined },\n this.getCompletionIdPath(),\n );\n const { headers, requestId } = extractResponseMetadata(response, \"rawResponse\");\n return { requestId, responseHeaders: headers, responseId };\n }\n\n /**\n * Returns the API-specific dotted path used to read the completion id off\n * the SDK response's internal `_data` payload.\n * @returns Path traversed under `_data` (e.g. `[\"final_result\",\"id\"]`, `[\"id\"]`).\n * @internal\n */\n protected abstract getCompletionIdPath(): readonly string[];\n\n /**\n * Returns whether to escape template placeholders for this API.\n * @param _sapOptions - Parsed provider options (unused in base implementation).\n * @param _settings - Model settings (unused in base implementation).\n * @returns false by default; Orchestration strategy overrides to return true.\n * @internal\n */\n protected getEscapeTemplatePlaceholders(\n _sapOptions: Record<string, unknown> | undefined,\n _settings: TSettings,\n ): boolean {\n return false;\n }\n\n /**\n * Returns whether to include reasoning in the response.\n * @param sapOptions - Parsed provider options.\n * @param settings - Model settings.\n * @returns Whether to include reasoning (checks sapOptions then settings, defaults to false).\n * @internal\n */\n protected getIncludeReasoning(\n sapOptions: Record<string, unknown> | undefined,\n settings: TSettings,\n ): boolean {\n return (\n (sapOptions?.includeReasoning as boolean | undefined) ?? settings.includeReasoning ?? false\n );\n }\n\n /**\n * Returns the parameter mappings specific to this API strategy.\n * @returns Array of parameter mappings.\n * @internal\n */\n protected abstract getParamMappings(): readonly ParamMapping[];\n\n /**\n * Returns a parser for per-message-part `providerOptions['sap-ai']`.\n *\n * Default returns `undefined`; strategies honouring part-level directives\n * (e.g. Anthropic `cacheControl` on orchestration) override to return a parser.\n * @returns Parser callback, or undefined to disable per-part plumbing.\n * @internal\n */\n protected getPartProviderOptionsParser(): ParsePartProviderOptions | undefined {\n return undefined;\n }\n\n /**\n * Returns the URL identifier for this API (used in error messages).\n * @returns URL string identifier.\n * @internal\n */\n protected abstract getUrl(): string;\n\n /**\n * Resolves API-specific extra state shared between doGenerate and doStream\n * (e.g. orchestration `configRef` / `promptTemplateRef` / `tools`). Override\n * to add API-specific deprecation checks or pre-resolve auxiliary inputs.\n * Pushed warnings flow into the shared sink.\n * @param _config - Strategy configuration.\n * @param _settings - Model settings.\n * @param _sapOptions - Parsed provider options, or `undefined`.\n * @param _options - AI SDK call options.\n * @param _warnings - Shared warnings sink for the current call.\n * @returns Strategy-specific resolved state, or `undefined` (default).\n * @internal\n */\n protected resolveAdditionalState(\n _config: LanguageModelStrategyConfig,\n _settings: TSettings,\n _sapOptions: Record<string, unknown> | undefined,\n _options: LanguageModelV3CallOptions,\n _warnings: SharedV3Warning[],\n ): unknown {\n return undefined;\n }\n}\n"],"mappings":"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","names":[]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"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":[]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"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":[]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"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":[]}
|
|
@@ -1 +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 \"fallbackModuleConfigs\",\n \"promptTemplateRef\",\n \"responseFormat\",\n \"tools\",\n \"modelParams\",\n \"modelVersion\",\n] as const;\n\n/**\n * Provider options that are ignored when using orchestrationConfigRef.\n * Subset of CONFIG_REF_IGNORED_MODULES that can be passed via providerOptions.\n * @internal\n */\nconst CONFIG_REF_IGNORED_PROVIDER_OPTIONS = [\"promptTemplateRef\", \"modelParams\"] as const;\n\n/**\n * Copies non-empty orchestration modules from source to target.\n * @param target - Target object to copy modules into.\n * @param source - Source object containing module configurations.\n * @internal\n */\nfunction copyOrchestrationModules(\n target: Record<string, unknown>,\n source: Record<string, unknown>,\n): void {\n for (const key of ORCHESTRATION_MODULE_KEYS) {\n const value = source[key];\n if (value && hasKeys(value)) {\n target[key] = value;\n }\n }\n}\n\n/**\n * Checks if a value is a valid 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":[]}
|
|
File without changes
|