@rekog/mcp-nest 1.9.4 → 1.9.6

package/dist/mcp/utils/normalize-endpoint.spec.js

@@ -1,40 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const normalize_endpoint_1 = require("./normalize-endpoint");
-describe('normalizeEndpoint', () => {
-    it('returns empty string for null or undefined', () => {
-        expect((0, normalize_endpoint_1.normalizeEndpoint)(null)).toBe('');
-        expect((0, normalize_endpoint_1.normalizeEndpoint)(undefined)).toBe('');
-    });
-    it('collapses multiple slashes in the path', () => {
-        const input = 'foo//bar///baz';
-        const expected = 'foo/bar/baz';
-        expect((0, normalize_endpoint_1.normalizeEndpoint)(input)).toBe(expected);
-    });
-    it('removes leading slash', () => {
-        const input = '/foo/bar';
-        const expected = 'foo/bar';
-        expect((0, normalize_endpoint_1.normalizeEndpoint)(input)).toBe(expected);
-    });
-    it('preserves http protocol and collapses slashes after domain', () => {
-        const input = 'http://localhost:3000//remote-auth/auth/callback';
-        const expected = 'http://localhost:3000/remote-auth/auth/callback';
-        expect((0, normalize_endpoint_1.normalizeEndpoint)(input)).toBe(expected);
-    });
-    it('preserves https protocol and collapses slashes after domain', () => {
-        const input = 'https://example.com///path///to';
-        const expected = 'https://example.com/path/to';
-        expect((0, normalize_endpoint_1.normalizeEndpoint)(input)).toBe(expected);
-    });
-    it('preserves other protocols (ftp)', () => {
-        const input = 'ftp://example.com//dir/file';
-        const expected = 'ftp://example.com/dir/file';
-        expect((0, normalize_endpoint_1.normalizeEndpoint)(input)).toBe(expected);
-    });
-    it('handles no protocol and leading double slashes', () => {
-        const input = '//foo//bar';
-        const expected = 'foo/bar';
-        expect((0, normalize_endpoint_1.normalizeEndpoint)(input)).toBe(expected);
-    });
-});
-//# sourceMappingURL=normalize-endpoint.spec.js.map

package/dist/mcp/utils/normalize-endpoint.spec.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"normalize-endpoint.spec.js","sourceRoot":"","sources":["../../../src/mcp/utils/normalize-endpoint.spec.ts"],"names":[],"mappings":";;AAAA,6DAAyD;AAEzD,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,IAAA,sCAAiB,EAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzC,MAAM,CAAC,IAAA,sCAAiB,EAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,KAAK,GAAG,gBAAgB,CAAC;QAC/B,MAAM,QAAQ,GAAG,aAAa,CAAC;QAC/B,MAAM,CAAC,IAAA,sCAAiB,EAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,KAAK,GAAG,UAAU,CAAC;QACzB,MAAM,QAAQ,GAAG,SAAS,CAAC;QAC3B,MAAM,CAAC,IAAA,sCAAiB,EAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,KAAK,GAAG,kDAAkD,CAAC;QACjE,MAAM,QAAQ,GAAG,iDAAiD,CAAC;QACnE,MAAM,CAAC,IAAA,sCAAiB,EAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,KAAK,GAAG,iCAAiC,CAAC;QAChD,MAAM,QAAQ,GAAG,6BAA6B,CAAC;QAC/C,MAAM,CAAC,IAAA,sCAAiB,EAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,KAAK,GAAG,6BAA6B,CAAC;QAC5C,MAAM,QAAQ,GAAG,4BAA4B,CAAC;QAC9C,MAAM,CAAC,IAAA,sCAAiB,EAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,KAAK,GAAG,YAAY,CAAC;QAC3B,MAAM,QAAQ,GAAG,SAAS,CAAC;QAC3B,MAAM,CAAC,IAAA,sCAAiB,EAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { normalizeEndpoint } from './normalize-endpoint';\n\ndescribe('normalizeEndpoint', () => {\n  it('returns empty string for null or undefined', () => {\n    expect(normalizeEndpoint(null)).toBe('');\n    expect(normalizeEndpoint(undefined)).toBe('');\n  });\n\n  it('collapses multiple slashes in the path', () => {\n    const input = 'foo//bar///baz';\n    const expected = 'foo/bar/baz';\n    expect(normalizeEndpoint(input)).toBe(expected);\n  });\n\n  it('removes leading slash', () => {\n    const input = '/foo/bar';\n    const expected = 'foo/bar';\n    expect(normalizeEndpoint(input)).toBe(expected);\n  });\n\n  it('preserves http protocol and collapses slashes after domain', () => {\n    const input = 'http://localhost:3000//remote-auth/auth/callback';\n    const expected = 'http://localhost:3000/remote-auth/auth/callback';\n    expect(normalizeEndpoint(input)).toBe(expected);\n  });\n\n  it('preserves https protocol and collapses slashes after domain', () => {\n    const input = 'https://example.com///path///to';\n    const expected = 'https://example.com/path/to';\n    expect(normalizeEndpoint(input)).toBe(expected);\n  });\n\n  it('preserves other protocols (ftp)', () => {\n    const input = 'ftp://example.com//dir/file';\n    const expected = 'ftp://example.com/dir/file';\n    expect(normalizeEndpoint(input)).toBe(expected);\n  });\n\n  it('handles no protocol and leading double slashes', () => {\n    const input = '//foo//bar';\n    const expected = 'foo/bar';\n    expect(normalizeEndpoint(input)).toBe(expected);\n  });\n});\n"]}

package/src/mcp/services/mcp-tool-builder.service.ts

@@ -1,151 +0,0 @@
-import { Injectable, Inject, Logger } from '@nestjs/common';
-import { z } from 'zod';
-import {
-  DynamicToolDefinition,
-  DynamicToolHandler,
-} from '../interfaces/dynamic-tool.interface';
-import { McpRegistryService } from './mcp-registry.service';
-import type { McpOptions } from '../interfaces';
-import { createMcpLogger } from '../utils/mcp-logger.factory';
-import { ToolMetadata } from '../decorators/tool.decorator';
-
-/**
- * Symbol used to identify dynamic tools in the registry.
- * When a tool's providerClass equals this token, it's a dynamic tool.
- */
-export const DYNAMIC_TOOL_HANDLER_TOKEN = Symbol('DYNAMIC_TOOL_HANDLER');
-
-/**
- * Global map of dynamic tool handlers, scoped by moduleId.
- * Using a module-level Map ensures handlers persist across different
- * McpToolBuilder instances that may be created by the DI container.
- */
-const globalHandlers = new Map<string, Map<string, DynamicToolHandler>>();
-
-/**
- * Service for programmatically registering MCP tools at runtime.
- *
- * Use this to register tools with descriptions/parameters from databases
- * or other dynamic sources during application bootstrap.
- *
- * @example
- * ```typescript
- * @Injectable()
- * export class DynamicToolsService implements OnModuleInit {
- *   constructor(
- *     private readonly toolBuilder: McpToolBuilder,
- *     private readonly dbService: DatabaseService,
- *   ) {}
- *
- *   async onModuleInit() {
- *     const collections = await this.dbService.getCollections();
- *
- *     this.toolBuilder.registerTool({
- *       name: 'search-knowledge',
- *       description: `Search collections: ${collections.join(', ')}`,
- *       parameters: z.object({ query: z.string() }),
- *       handler: async (args, context) => {
- *         const results = await this.dbService.search(args.query);
- *         return { content: [{ type: 'text', text: JSON.stringify(results) }] };
- *       },
- *     });
- *   }
- * }
- * ```
- */
-@Injectable()
-export class McpToolBuilder {
-  private readonly logger: Logger;
-
-  constructor(
-    private readonly registry: McpRegistryService,
-    @Inject('MCP_MODULE_ID') private readonly mcpModuleId: string,
-    @Inject('MCP_OPTIONS') private readonly options: McpOptions,
-  ) {
-    this.logger = createMcpLogger(McpToolBuilder.name, this.options);
-    // Initialize handler map for this module if it doesn't exist
-    if (!globalHandlers.has(mcpModuleId)) {
-      globalHandlers.set(mcpModuleId, new Map());
-    }
-  }
-
-  /**
-   * Register a dynamic tool for the current MCP server.
-   *
-   * Tools registered here will appear in the `tools/list` response and
-   * can be called via `tools/call` just like decorator-based tools.
-   *
-   * @param definition - The tool definition including name, description, parameters, and handler
-   *
-   * @example
-   * ```typescript
-   * toolBuilder.registerTool({
-   *   name: 'search-knowledge',
-   *   description: await getDescriptionFromDB(),
-   *   parameters: z.object({ query: z.string() }),
-   *   handler: async (args, context) => {
-   *     const results = await searchService.search(args.query);
-   *     return { content: [{ type: 'text', text: JSON.stringify(results) }] };
-   *   },
-   * });
-   * ```
-   */
-  registerTool(definition: DynamicToolDefinition): void {
-    this.logger.debug(`Registering dynamic tool: ${definition.name}`);
-
-    // Store the handler for later execution (scoped by moduleId)
-    const moduleHandlers = globalHandlers.get(this.mcpModuleId)!;
-    moduleHandlers.set(definition.name, definition.handler);
-
-    // Default to empty object schema if no parameters provided (matches @Tool decorator behavior)
-    const parameters = definition.parameters ?? z.object({});
-
-    // Build metadata matching ToolMetadata interface
-    const metadata: ToolMetadata = {
-      name: definition.name,
-      description: definition.description,
-      parameters,
-      outputSchema: definition.outputSchema,
-      annotations: definition.annotations,
-      _meta: definition._meta,
-      isPublic: definition.isPublic,
-      requiredScopes: definition.requiredScopes,
-      requiredRoles: definition.requiredRoles,
-    };
-
-    // Register with the registry
-    this.registry.registerDynamicTool(this.mcpModuleId, {
-      type: 'tool',
-      metadata,
-      providerClass: DYNAMIC_TOOL_HANDLER_TOKEN,
-      methodName: definition.name,
-    });
-  }
-
-  /**
-   * Get the handler function for a dynamic tool.
-   * Used internally by McpToolsHandler to execute dynamic tools.
-   *
-   * @param toolName - The name of the tool
-   * @returns The handler function, or undefined if not found
-   */
-  getHandler(toolName: string): DynamicToolHandler | undefined {
-    return globalHandlers.get(this.mcpModuleId)?.get(toolName);
-  }
-
-  /**
-   * Get the handler function for a dynamic tool by module ID.
-   * Static method used when the module ID is known but the correct
-   * McpToolBuilder instance may not be available.
-   *
-   * @param mcpModuleId - The module ID to look up handlers for
-   * @param toolName - The name of the tool
-   * @returns The handler function, or undefined if not found
-   */
-  static getHandlerByModuleId(
-    mcpModuleId: string,
-    toolName: string,
-  ): DynamicToolHandler | undefined {
-    return globalHandlers.get(mcpModuleId)?.get(toolName);
-  }
-}