@onivoro/server-mcp-llm-adapter 24.34.0

package/README.md

@@ -0,0 +1,242 @@
+# @onivoro/server-mcp-llm-adapter
+
+Generic adapter for [`@onivoro/server-mcp`](https://www.npmjs.com/package/@onivoro/server-mcp). Converts MCP tool registry entries to any LLM provider's tool definition format and provides a unified execution path. Ships with prebuilt configs for AWS Bedrock Converse, OpenAI, Anthropic, Google Gemini, and Mistral.
+
+## Install
+
+```bash
+npm install @onivoro/server-mcp-llm-adapter
+```
+
+### Peer dependencies
+
+| Package | Version |
+|---------|---------|
+| `@nestjs/common` | `^10.0.0 \|\| ^11.0.0` |
+
+`@onivoro/server-mcp` is a hard dependency — installed automatically.
+
+## Choosing the right config
+
+Configs map to **the API you are calling**, not the model or hosting platform. A model hosted on AWS Bedrock can be called through different APIs, each with its own tool format.
+
+| API you are calling | Config | Module method |
+|---------------------|--------|---------------|
+| AWS Bedrock **Converse / ConverseStream** | `BEDROCK_CONVERSE_CONFIG` | `forBedrockConverse()` |
+| OpenAI **Chat Completions** (also xAI, Groq, Together) | `OPENAI_CONFIG` | `forOpenAi()` |
+| Anthropic **Messages** | `CLAUDE_CONFIG` | `forClaude()` |
+| Google **Gemini** | `GEMINI_CONFIG` | `forGemini()` |
+| Mistral **La Plateforme** | `MISTRAL_CONFIG` | `forMistral()` |
+
+### Bedrock examples
+
+If you use Bedrock's **Converse API**, all models (Claude, Mistral, Llama, etc.) share the same `toolSpec` envelope — use `BEDROCK_CONVERSE_CONFIG`.
+
+If you use Bedrock's **InvokeModel API** (passing the raw request body), the tool format is model-specific:
+
+| Scenario | Config |
+|----------|--------|
+| Any model via Bedrock **Converse** | `BEDROCK_CONVERSE_CONFIG` |
+| Claude on Bedrock via **InvokeModel** | `CLAUDE_CONFIG` |
+| Mistral on Bedrock via **InvokeModel** | `MISTRAL_CONFIG` |
+
+The same principle applies outside Bedrock — pick the config that matches the API format, not where the model is hosted.
+
+## Usage
+
+Import `LlmAdapterModule` alongside whichever MCP module provides the tool registry:
+
+```typescript
+import { Module } from '@nestjs/common';
+import { McpRegistryModule } from '@onivoro/server-mcp';
+import { LlmAdapterModule } from '@onivoro/server-mcp-llm-adapter';
+import { EmojiToolService } from './services/emoji-tool.service';
+import { ChatService } from './services/chat.service';
+
+@Module({
+  imports: [
+    McpRegistryModule.registerOnly(),
+    LlmAdapterModule.forBedrockConverse(),
+  ],
+  providers: [EmojiToolService, ChatService],
+})
+export class AppModule {}
+```
+
+Then inject `LlmToolAdapter` wherever you need provider-specific functionality:
+
+```typescript
+import { Injectable } from '@nestjs/common';
+import { LlmToolAdapter } from '@onivoro/server-mcp-llm-adapter';
+
+@Injectable()
+export class ChatService {
+  constructor(private readonly adapter: LlmToolAdapter) {}
+
+  async chat(userMessage: string) {
+    // Build provider tool definitions from the registry
+    const tools = this.adapter.toProviderTools();
+
+    // ... call the LLM provider with tools ...
+
+    // When the provider returns a tool call:
+    const result = await this.adapter.executeToolForProvider(
+      toolCall.name,
+      toolCall.input,
+    );
+  }
+}
+```
+
+## Batch execution
+
+LLM providers can return multiple tool calls in a single turn — OpenAI returns an array of `tool_calls`, Claude returns multiple `tool_use` content blocks, Bedrock returns multiple `toolUse` entries. This is not an MCP spec concept (the MCP protocol's `tools/call` is always a single tool per request), but it's a universal pattern at the LLM API layer that this adapter sits in front of.
+
+`executeToolsForProvider` handles the boilerplate: parallel execution via `Promise.allSettled`, independent per-call error handling (one failure doesn't block siblings), and `id` passthrough for the correlation every provider requires.
+
+```typescript
+// LLM returned multiple tool calls in one turn
+const results = await this.adapter.executeToolsForProvider(
+  toolCalls.map(tc => ({
+    providerName: tc.name,
+    params: tc.input,
+    id: tc.id,  // OpenAI tool_call.id, Claude tool_use.id, Bedrock toolUseId
+  })),
+  authInfo,
+);
+
+// Build tool result messages for the next LLM turn
+for (const r of results) {
+  messages.push({
+    role: 'tool',
+    tool_call_id: r.id,
+    content: r.success ? r.result : `Error: ${r.error}`,
+  });
+}
+```
+
+Each tool call goes through the full `@onivoro/server-mcp` execution pipeline independently (guards, validation, interceptors, handler) via `registry.executeToolRaw()`. The core MCP library is unchanged — the batch coordination lives entirely in the adapter.
+
+## Output schemas
+
+MCP tools can declare an `outputSchema` for structured result validation. No current LLM provider API supports per-tool output schemas in their tool definition format, so the built-in configs don't forward them. However, the adapter exposes them for consumers that need output schemas at the API call level (e.g., OpenAI `response_format`) or for custom result validation.
+
+```typescript
+// Get output schemas for tools that define them
+const outputSchemas = this.adapter.getOutputSchemas();
+// Map<string, Record<string, unknown>> — provider tool name → JSON Schema
+
+// Use with OpenAI response_format, your own validation, etc.
+for (const [toolName, schema] of outputSchemas) {
+  console.log(`${toolName} returns:`, schema);
+}
+```
+
+For custom providers that support per-tool output schemas, use `formatToolWithOutput` in your config:
+
+```typescript
+const MY_CONFIG: LlmAdapterConfig<MyToolDef> = {
+  aliasKey: 'myProvider',
+  formatTool: (name, description, inputSchema) => ({
+    name, description, inputSchema,
+  }),
+  // Called instead of formatTool when the tool has an outputSchema
+  formatToolWithOutput: (name, description, inputSchema, outputSchema) => ({
+    name, description, inputSchema, outputSchema,
+  }),
+};
+```
+
+When `formatToolWithOutput` is defined and the tool has an `outputSchema`, it is called instead of `formatTool`. Otherwise `formatTool` is used — existing configs are unaffected.
+
+## Custom providers
+
+Use `LlmAdapterModule.forProvider()` with a custom config for any provider not included out of the box:
+
+```typescript
+import { LlmAdapterModule, LlmAdapterConfig } from '@onivoro/server-mcp-llm-adapter';
+
+interface MyToolDef {
+  name: string;
+  desc: string;
+  params: Record<string, unknown>;
+}
+
+const MY_CONFIG: LlmAdapterConfig<MyToolDef> = {
+  aliasKey: 'myProvider',
+  sanitizeName: (name) => name.toUpperCase(),
+  formatTool: (name, description, jsonSchema) => ({
+    name,
+    desc: description,
+    params: jsonSchema,
+  }),
+};
+
+LlmAdapterModule.forProvider(MY_CONFIG);
+```
+
+## LlmToolAdapter API
+
+| Method | Description |
+|--------|-------------|
+| `toProviderTools()` | Returns `T[]` — tool definitions in the provider's format |
+| `getOutputSchemas()` | Returns `Map<string, Record<string, unknown>>` — provider tool names to output JSON Schemas (only tools with `outputSchema`) |
+| `resolveProviderToolName(providerName)` | Maps a provider-specific tool name back to the MCP tool name, or `undefined` |
+| `executeToolForProvider(providerName, params, authInfo?)` | Resolves name, executes tool, returns stringified result |
+| `executeToolCallForProvider(toolCall, authInfo?)` | Executes a single `ProviderToolCall`, returns `ProviderToolCallResult` with id passthrough |
+| `executeToolsForProvider(toolCalls, authInfo?)` | Executes multiple tool calls in parallel. Returns `ProviderToolCallResult[]` with per-call success/error |
+
+## Name handling
+
+Each config has an `aliasKey` (e.g., `'bedrock'`, `'openai'`) used to look up per-provider name overrides from the `@McpTool` decorator's `aliases` parameter.
+
+Resolution order:
+1. **Explicit alias** — `aliases[aliasKey]` if present
+2. **Sanitized name** — `sanitizeName(mcpName)` if the config defines a sanitizer
+3. **MCP name as-is** — used directly when no alias or sanitizer applies
+
+```typescript
+// Explicit alias for Bedrock Converse
+@McpTool('insert-emojis', 'Insert emojis', schema, { bedrock: 'insertEmojis' })
+
+// No alias needed for OpenAI (hyphens are valid)
+@McpTool('insert-emojis', 'Insert emojis', schema)
+```
+
+Providers that require name sanitization (Bedrock Converse, Gemini) apply it automatically — hyphens are replaced with underscores.
+
+## Exports
+
+```typescript
+// Module
+LlmAdapterModule                // NestJS module — forProvider(), forBedrockConverse(), forOpenAi(), forClaude(), forGemini(), forMistral()
+
+// Adapter
+LlmToolAdapter                  // Injectable — toProviderTools(), getOutputSchemas(), resolveProviderToolName(), executeToolForProvider(), executeToolCallForProvider(), executeToolsForProvider()
+ProviderToolCall                // Input type for single/batch execution — { providerName, params, id? }
+ProviderToolCallResult          // Output type for single/batch execution — { providerName, id?, result?, error?, success }
+
+// Config
+LlmAdapterConfig                // Interface for custom provider configs
+LLM_ADAPTER_CONFIG              // Injection token
+resolveProviderName             // Utility: resolves provider name from metadata + config
+
+// Prebuilt configs
+BEDROCK_CONVERSE_CONFIG          // AWS Bedrock Converse API
+OPENAI_CONFIG                    // OpenAI Chat Completions API
+CLAUDE_CONFIG                    // Anthropic Messages API
+GEMINI_CONFIG                    // Google Gemini API
+MISTRAL_CONFIG                   // Mistral La Plateforme API
+
+// Types
+BedrockConverseToolDefinition    // { toolSpec: { name, description, inputSchema: { json } } }
+OpenAiToolDefinition             // { type: 'function', function: { name, description, parameters } }
+ClaudeToolDefinition             // { name, description, input_schema }
+GeminiToolDefinition             // { name, description, parameters }
+```
+
+## Related libraries
+
+| Library | Purpose |
+|---------|---------|
+| [`@onivoro/server-mcp`](https://www.npmjs.com/package/@onivoro/server-mcp) | Transport-agnostic MCP tool registry, decorators, HTTP and stdio transports |

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@onivoro/server-mcp-llm-adapter",
+  "version": "24.34.0",
+  "license": "MIT",
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/onivoro/monorepo.git"
+  },
+  "dependencies": {
+    "@onivoro/server-mcp": "^24.34.0",
+    "tslib": "^2.3.0"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^10.0.0 || ^11.0.0"
+  },
+  "files": [
+    "**/*.js",
+    "**/*.d.ts",
+    "**/*.js.map",
+    "README.md"
+  ]
+}

package/src/index.d.ts

@@ -0,0 +1,5 @@
+export { LlmToolAdapter, ProviderToolCall, ProviderToolCallResult } from './lib/llm-tool-adapter';
+export { LlmAdapterModule } from './lib/llm-adapter.module';
+export { LlmAdapterConfig, LLM_ADAPTER_CONFIG, resolveProviderName, } from './lib/llm-adapter.config';
+export { BEDROCK_CONVERSE_CONFIG, BedrockConverseToolDefinition, OPENAI_CONFIG, OpenAiToolDefinition, CLAUDE_CONFIG, ClaudeToolDefinition, GEMINI_CONFIG, GeminiToolDefinition, MISTRAL_CONFIG, } from './lib/provider-configs';
+//# sourceMappingURL=index.d.ts.map

package/src/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MISTRAL_CONFIG = exports.GEMINI_CONFIG = exports.CLAUDE_CONFIG = exports.OPENAI_CONFIG = exports.BEDROCK_CONVERSE_CONFIG = exports.resolveProviderName = exports.LLM_ADAPTER_CONFIG = exports.LlmAdapterModule = exports.LlmToolAdapter = void 0;
+var llm_tool_adapter_1 = require("./lib/llm-tool-adapter");
+Object.defineProperty(exports, "LlmToolAdapter", { enumerable: true, get: function () { return llm_tool_adapter_1.LlmToolAdapter; } });
+var llm_adapter_module_1 = require("./lib/llm-adapter.module");
+Object.defineProperty(exports, "LlmAdapterModule", { enumerable: true, get: function () { return llm_adapter_module_1.LlmAdapterModule; } });
+var llm_adapter_config_1 = require("./lib/llm-adapter.config");
+Object.defineProperty(exports, "LLM_ADAPTER_CONFIG", { enumerable: true, get: function () { return llm_adapter_config_1.LLM_ADAPTER_CONFIG; } });
+Object.defineProperty(exports, "resolveProviderName", { enumerable: true, get: function () { return llm_adapter_config_1.resolveProviderName; } });
+var provider_configs_1 = require("./lib/provider-configs");
+Object.defineProperty(exports, "BEDROCK_CONVERSE_CONFIG", { enumerable: true, get: function () { return provider_configs_1.BEDROCK_CONVERSE_CONFIG; } });
+Object.defineProperty(exports, "OPENAI_CONFIG", { enumerable: true, get: function () { return provider_configs_1.OPENAI_CONFIG; } });
+Object.defineProperty(exports, "CLAUDE_CONFIG", { enumerable: true, get: function () { return provider_configs_1.CLAUDE_CONFIG; } });
+Object.defineProperty(exports, "GEMINI_CONFIG", { enumerable: true, get: function () { return provider_configs_1.GEMINI_CONFIG; } });
+Object.defineProperty(exports, "MISTRAL_CONFIG", { enumerable: true, get: function () { return provider_configs_1.MISTRAL_CONFIG; } });
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/server/mcp-llm-adapter/src/index.ts"],"names":[],"mappings":";;;AAAA,2DAAkG;AAAzF,kHAAA,cAAc,OAAA;AACvB,+DAA4D;AAAnD,sHAAA,gBAAgB,OAAA;AACzB,+DAIkC;AAFhC,wHAAA,kBAAkB,OAAA;AAClB,yHAAA,mBAAmB,OAAA;AAErB,2DAUgC;AAT9B,2HAAA,uBAAuB,OAAA;AAEvB,iHAAA,aAAa,OAAA;AAEb,iHAAA,aAAa,OAAA;AAEb,iHAAA,aAAa,OAAA;AAEb,kHAAA,cAAc,OAAA"}

package/src/lib/llm-adapter.config.d.ts

@@ -0,0 +1,10 @@
+import type { McpToolMetadata } from '@onivoro/server-mcp';
+export declare const LLM_ADAPTER_CONFIG: unique symbol;
+export interface LlmAdapterConfig<T = unknown> {
+    aliasKey: string;
+    sanitizeName?: (name: string) => string;
+    formatTool: (name: string, description: string, jsonSchema: Record<string, unknown>) => T;
+    formatToolWithOutput?: (name: string, description: string, inputSchema: Record<string, unknown>, outputSchema: Record<string, unknown>) => T;
+}
+export declare function resolveProviderName(metadata: McpToolMetadata, config: LlmAdapterConfig): string;
+//# sourceMappingURL=llm-adapter.config.d.ts.map

package/src/lib/llm-adapter.config.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLM_ADAPTER_CONFIG = void 0;
+exports.resolveProviderName = resolveProviderName;
+exports.LLM_ADAPTER_CONFIG = Symbol('LLM_ADAPTER_CONFIG');
+function resolveProviderName(metadata, config) {
+    const alias = metadata.aliases?.[config.aliasKey];
+    if (alias)
+        return alias;
+    return config.sanitizeName
+        ? config.sanitizeName(metadata.name)
+        : metadata.name;
+}
+//# sourceMappingURL=llm-adapter.config.js.map

package/src/lib/llm-adapter.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-adapter.config.js","sourceRoot":"","sources":["../../../../../../libs/server/mcp-llm-adapter/src/lib/llm-adapter.config.ts"],"names":[],"mappings":";;;AA6BA,kDASC;AApCY,QAAA,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AA2B/D,SAAgB,mBAAmB,CACjC,QAAyB,EACzB,MAAwB;IAExB,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,MAAM,CAAC,YAAY;QACxB,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;AACpB,CAAC"}

package/src/lib/llm-adapter.module.d.ts

@@ -0,0 +1,11 @@
+import { DynamicModule } from '@nestjs/common';
+import { LlmAdapterConfig } from './llm-adapter.config';
+export declare class LlmAdapterModule {
+    static forProvider<T>(config: LlmAdapterConfig<T>): DynamicModule;
+    static forBedrockConverse(): DynamicModule;
+    static forOpenAi(): DynamicModule;
+    static forClaude(): DynamicModule;
+    static forGemini(): DynamicModule;
+    static forMistral(): DynamicModule;
+}
+//# sourceMappingURL=llm-adapter.module.d.ts.map

package/src/lib/llm-adapter.module.js

@@ -0,0 +1,41 @@
+"use strict";
+var LlmAdapterModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LlmAdapterModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const llm_tool_adapter_1 = require("./llm-tool-adapter");
+const llm_adapter_config_1 = require("./llm-adapter.config");
+const provider_configs_1 = require("./provider-configs");
+let LlmAdapterModule = LlmAdapterModule_1 = class LlmAdapterModule {
+    static forProvider(config) {
+        return {
+            module: LlmAdapterModule_1,
+            providers: [
+                llm_tool_adapter_1.LlmToolAdapter,
+                { provide: llm_adapter_config_1.LLM_ADAPTER_CONFIG, useValue: config },
+            ],
+            exports: [llm_tool_adapter_1.LlmToolAdapter],
+        };
+    }
+    static forBedrockConverse() {
+        return this.forProvider(provider_configs_1.BEDROCK_CONVERSE_CONFIG);
+    }
+    static forOpenAi() {
+        return this.forProvider(provider_configs_1.OPENAI_CONFIG);
+    }
+    static forClaude() {
+        return this.forProvider(provider_configs_1.CLAUDE_CONFIG);
+    }
+    static forGemini() {
+        return this.forProvider(provider_configs_1.GEMINI_CONFIG);
+    }
+    static forMistral() {
+        return this.forProvider(provider_configs_1.MISTRAL_CONFIG);
+    }
+};
+exports.LlmAdapterModule = LlmAdapterModule;
+exports.LlmAdapterModule = LlmAdapterModule = LlmAdapterModule_1 = tslib_1.__decorate([
+    (0, common_1.Module)({})
+], LlmAdapterModule);
+//# sourceMappingURL=llm-adapter.module.js.map

package/src/lib/llm-adapter.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-adapter.module.js","sourceRoot":"","sources":["../../../../../../libs/server/mcp-llm-adapter/src/lib/llm-adapter.module.ts"],"names":[],"mappings":";;;;;AAAA,2CAAuD;AACvD,yDAAoD;AACpD,6DAA4E;AAC5E,yDAM4B;AAGrB,IAAM,gBAAgB,wBAAtB,MAAM,gBAAgB;IAC3B,MAAM,CAAC,WAAW,CAAI,MAA2B;QAC/C,OAAO;YACL,MAAM,EAAE,kBAAgB;YACxB,SAAS,EAAE;gBACT,iCAAc;gBACd,EAAE,OAAO,EAAE,uCAAkB,EAAE,QAAQ,EAAE,MAAM,EAAE;aAClD;YACD,OAAO,EAAE,CAAC,iCAAc,CAAC;SAC1B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,kBAAkB;QACvB,OAAO,IAAI,CAAC,WAAW,CAAC,0CAAuB,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,CAAC,SAAS;QACd,OAAO,IAAI,CAAC,WAAW,CAAC,gCAAa,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,SAAS;QACd,OAAO,IAAI,CAAC,WAAW,CAAC,gCAAa,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,SAAS;QACd,OAAO,IAAI,CAAC,WAAW,CAAC,gCAAa,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,UAAU;QACf,OAAO,IAAI,CAAC,WAAW,CAAC,iCAAc,CAAC,CAAC;IAC1C,CAAC;CACF,CAAA;AA/BY,4CAAgB;2BAAhB,gBAAgB;IAD5B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,gBAAgB,CA+B5B"}

package/src/lib/llm-tool-adapter.d.ts

@@ -0,0 +1,31 @@
+import { OnModuleInit } from '@nestjs/common';
+import { McpToolRegistry, McpAuthInfo } from '@onivoro/server-mcp';
+import { LlmAdapterConfig } from './llm-adapter.config';
+export interface ProviderToolCall {
+    providerName: string;
+    params: Record<string, unknown>;
+    id?: string;
+}
+export interface ProviderToolCallResult {
+    providerName: string;
+    id?: string;
+    result?: string;
+    error?: string;
+    success: boolean;
+}
+export declare class LlmToolAdapter<T = unknown> implements OnModuleInit {
+    private readonly registry;
+    private readonly config;
+    private nameMapCache;
+    private unsubscribe?;
+    constructor(registry: McpToolRegistry, config: LlmAdapterConfig<T>);
+    onModuleInit(): void;
+    private getNameMap;
+    toProviderTools(): T[];
+    getOutputSchemas(): Map<string, Record<string, unknown>>;
+    resolveProviderToolName(providerName: string): string | undefined;
+    executeToolForProvider(providerName: string, params: Record<string, unknown>, authInfo?: McpAuthInfo): Promise<string>;
+    executeToolCallForProvider(toolCall: ProviderToolCall, authInfo?: McpAuthInfo): Promise<ProviderToolCallResult>;
+    executeToolsForProvider(toolCalls: ProviderToolCall[], authInfo?: McpAuthInfo): Promise<ProviderToolCallResult[]>;
+}
+//# sourceMappingURL=llm-tool-adapter.d.ts.map

package/src/lib/llm-tool-adapter.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LlmToolAdapter = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const server_mcp_1 = require("@onivoro/server-mcp");
+const llm_adapter_config_1 = require("./llm-adapter.config");
+let LlmToolAdapter = class LlmToolAdapter {
+    registry;
+    config;
+    nameMapCache = null;
+    unsubscribe;
+    constructor(registry, config) {
+        this.registry = registry;
+        this.config = config;
+    }
+    onModuleInit() {
+        this.unsubscribe = this.registry.onRegistrationChange(() => {
+            this.nameMapCache = null;
+        });
+    }
+    getNameMap() {
+        if (!this.nameMapCache) {
+            const map = new Map();
+            for (const { metadata } of this.registry.getTools()) {
+                map.set((0, llm_adapter_config_1.resolveProviderName)(metadata, this.config), metadata.name);
+            }
+            this.nameMapCache = map;
+        }
+        return this.nameMapCache;
+    }
+    toProviderTools() {
+        return this.registry.getTools().map(({ metadata }) => {
+            const name = (0, llm_adapter_config_1.resolveProviderName)(metadata, this.config);
+            const inputSchema = (0, server_mcp_1.mcpSchemaToJsonSchema)(metadata.schema);
+            if (this.config.formatToolWithOutput && metadata.outputSchema) {
+                const outputSchema = (0, server_mcp_1.mcpSchemaToJsonSchema)(metadata.outputSchema);
+                return this.config.formatToolWithOutput(name, metadata.description, inputSchema, outputSchema);
+            }
+            return this.config.formatTool(name, metadata.description, inputSchema);
+        });
+    }
+    getOutputSchemas() {
+        const result = new Map();
+        for (const { metadata } of this.registry.getTools()) {
+            if (metadata.outputSchema) {
+                const providerName = (0, llm_adapter_config_1.resolveProviderName)(metadata, this.config);
+                result.set(providerName, (0, server_mcp_1.mcpSchemaToJsonSchema)(metadata.outputSchema));
+            }
+        }
+        return result;
+    }
+    resolveProviderToolName(providerName) {
+        return this.getNameMap().get(providerName);
+    }
+    async executeToolForProvider(providerName, params, authInfo) {
+        const mcpName = this.getNameMap().get(providerName);
+        if (!mcpName) {
+            throw new Error(`No MCP tool found for provider name "${providerName}".`);
+        }
+        const result = await this.registry.executeToolRaw(mcpName, params, authInfo);
+        return typeof result === 'string' ? result : JSON.stringify(result);
+    }
+    async executeToolCallForProvider(toolCall, authInfo) {
+        const [result] = await this.executeToolsForProvider([toolCall], authInfo);
+        return result;
+    }
+    async executeToolsForProvider(toolCalls, authInfo) {
+        const nameMap = this.getNameMap();
+        const settled = await Promise.allSettled(toolCalls.map(async ({ providerName, params, id }) => {
+            const mcpName = nameMap.get(providerName);
+            if (!mcpName) {
+                throw new Error(`No MCP tool found for provider name "${providerName}".`);
+            }
+            const rawResult = await this.registry.executeToolRaw(mcpName, params, authInfo);
+            const result = typeof rawResult === 'string' ? rawResult : JSON.stringify(rawResult);
+            return { providerName, id, result, success: true };
+        }));
+        return settled.map((outcome, i) => {
+            if (outcome.status === 'fulfilled') {
+                return outcome.value;
+            }
+            const call = toolCalls[i];
+            return {
+                providerName: call.providerName,
+                id: call.id,
+                error: outcome.reason instanceof Error ? outcome.reason.message : String(outcome.reason),
+                success: false,
+            };
+        });
+    }
+};
+exports.LlmToolAdapter = LlmToolAdapter;
+exports.LlmToolAdapter = LlmToolAdapter = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(1, (0, common_1.Inject)(llm_adapter_config_1.LLM_ADAPTER_CONFIG)),
+    tslib_1.__metadata("design:paramtypes", [server_mcp_1.McpToolRegistry, Object])
+], LlmToolAdapter);
+//# sourceMappingURL=llm-tool-adapter.js.map

package/src/lib/llm-tool-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-tool-adapter.js","sourceRoot":"","sources":["../../../../../../libs/server/mcp-llm-adapter/src/lib/llm-tool-adapter.ts"],"names":[],"mappings":"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"}

package/src/lib/provider-configs.d.ts

@@ -0,0 +1,34 @@
+import type { LlmAdapterConfig } from './llm-adapter.config';
+export interface BedrockConverseToolDefinition {
+    toolSpec: {
+        name: string;
+        description: string;
+        inputSchema: {
+            json: Record<string, unknown>;
+        };
+    };
+}
+export declare const BEDROCK_CONVERSE_CONFIG: LlmAdapterConfig<BedrockConverseToolDefinition>;
+export interface OpenAiToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+export declare const OPENAI_CONFIG: LlmAdapterConfig<OpenAiToolDefinition>;
+export interface ClaudeToolDefinition {
+    name: string;
+    description: string;
+    input_schema: Record<string, unknown>;
+}
+export declare const CLAUDE_CONFIG: LlmAdapterConfig<ClaudeToolDefinition>;
+export interface GeminiToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+export declare const GEMINI_CONFIG: LlmAdapterConfig<GeminiToolDefinition>;
+export declare const MISTRAL_CONFIG: LlmAdapterConfig<OpenAiToolDefinition>;
+//# sourceMappingURL=provider-configs.d.ts.map

package/src/lib/provider-configs.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MISTRAL_CONFIG = exports.GEMINI_CONFIG = exports.CLAUDE_CONFIG = exports.OPENAI_CONFIG = exports.BEDROCK_CONVERSE_CONFIG = void 0;
+exports.BEDROCK_CONVERSE_CONFIG = {
+    aliasKey: 'bedrock',
+    sanitizeName: (name) => name.replace(/[^a-zA-Z0-9_]/g, '_'),
+    formatTool: (name, description, jsonSchema) => ({
+        toolSpec: { name, description, inputSchema: { json: jsonSchema } },
+    }),
+};
+exports.OPENAI_CONFIG = {
+    aliasKey: 'openai',
+    formatTool: (name, description, jsonSchema) => ({
+        type: 'function',
+        function: { name, description, parameters: jsonSchema },
+    }),
+};
+exports.CLAUDE_CONFIG = {
+    aliasKey: 'claude',
+    formatTool: (name, description, jsonSchema) => ({
+        name,
+        description,
+        input_schema: jsonSchema,
+    }),
+};
+exports.GEMINI_CONFIG = {
+    aliasKey: 'gemini',
+    sanitizeName: (name) => name.replace(/[^a-zA-Z0-9_]/g, '_'),
+    formatTool: (name, description, jsonSchema) => ({
+        name,
+        description,
+        parameters: jsonSchema,
+    }),
+};
+exports.MISTRAL_CONFIG = {
+    aliasKey: 'mistral',
+    formatTool: (name, description, jsonSchema) => ({
+        type: 'function',
+        function: { name, description, parameters: jsonSchema },
+    }),
+};
+//# sourceMappingURL=provider-configs.js.map

package/src/lib/provider-configs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-configs.js","sourceRoot":"","sources":["../../../../../../libs/server/mcp-llm-adapter/src/lib/provider-configs.ts"],"names":[],"mappings":";;;AAYa,QAAA,uBAAuB,GAAoD;IACtF,QAAQ,EAAE,SAAS;IACnB,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;IAC3D,UAAU,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QAC9C,QAAQ,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;KACnE,CAAC;CACH,CAAC;AAaW,QAAA,aAAa,GAA2C;IACnE,QAAQ,EAAE,QAAQ;IAClB,UAAU,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QAC9C,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE;KACxD,CAAC;CACH,CAAC;AAUW,QAAA,aAAa,GAA2C;IACnE,QAAQ,EAAE,QAAQ;IAClB,UAAU,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QAC9C,IAAI;QACJ,WAAW;QACX,YAAY,EAAE,UAAU;KACzB,CAAC;CACH,CAAC;AAUW,QAAA,aAAa,GAA2C;IACnE,QAAQ,EAAE,QAAQ;IAClB,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;IAC3D,UAAU,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QAC9C,IAAI;QACJ,WAAW;QACX,UAAU,EAAE,UAAU;KACvB,CAAC;CACH,CAAC;AAIW,QAAA,cAAc,GAA2C;IACpE,QAAQ,EAAE,SAAS;IACnB,UAAU,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QAC9C,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE;KACxD,CAAC;CACH,CAAC"}