@ibm/ibmi-mcp-server 0.1.0

package/dist/ibmi-mcp-server/utils/config/toolConfigBuilder.d.ts

@@ -0,0 +1,143 @@
+/**
+ * @fileoverview Tool Configuration Builder - Standardized tool configuration creation
+ * Unifies all tool configuration creation logic into a single, consistent class
+ * Eliminates duplicate logic between cached and regular tool creation paths
+ *
+ * @module src/ibmi-mcp-server/utils/yaml/toolConfigBuilder
+ */
+import { z } from "zod";
+import { ProcessedSQLTool, CachedToolConfig, ConfigSource, ConfigBuildResult } from "./types.js";
+import { SqlToolConfig, SqlToolParameter } from "../../schemas/index.js";
+import { RequestContext } from "../../../utils/internal/requestContext.js";
+/**
+ * Configuration merging options
+ */
+export interface ConfigMergeOptions {
+    /** Whether to merge arrays (true) or replace them (false) */
+    mergeArrays?: boolean;
+    /** Whether to allow duplicate tool names */
+    allowDuplicateTools?: boolean;
+    /** Whether to allow duplicate source names */
+    allowDuplicateSources?: boolean;
+    /** Whether to validate merged config */
+    validateMerged?: boolean;
+}
+/**
+ * Tool Configuration Builder
+ * Standardized tool configuration creation with consistent error handling,
+ * schema generation, and handler creation logic
+ */
+export declare class ToolConfigBuilder {
+    private static instance;
+    /**
+     * Get the singleton instance
+     */
+    static getInstance(): ToolConfigBuilder;
+    /**
+     * Generate a Zod schema from SQL parameter definitions
+     * @param parameters - SQL parameter definitions (using standardized types)
+     * @param toolName - Tool name for error reporting
+     * @returns Generated Zod schema
+     */
+    generateZodSchema(parameters: SqlToolParameter[], toolName: string): z.ZodObject<Record<string, z.ZodTypeAny>>;
+    /**
+     * Filter processed tools by allowed toolsets
+     * @param processedTools - Array of processed tools to filter
+     * @param allowedToolsets - List of toolset names to include
+     * @returns Filtered array containing only tools that belong to allowed toolsets
+     */
+    filterToolsByToolsets(processedTools: ProcessedSQLTool[], allowedToolsets: string[]): ProcessedSQLTool[];
+    /**
+     * Build a complete tool configuration
+     * This is the single, unified method for creating all tool configurations
+     * @param toolName - Name of the tool
+     * @param config - Tool configuration from YAML
+     * @param toolsets - Toolsets this tool belongs to
+     * @param context - Request context
+     * @returns Complete cached tool configuration
+     */
+    buildToolConfig(toolName: string, config: SqlToolConfig, toolsets: string[], context: RequestContext): Promise<CachedToolConfig>;
+    /**
+     * Create a unified tool handler function
+     * This replaces the duplicate handler logic in yamlToolFactory
+     * @param toolName - Name of the tool
+     * @param config - Tool configuration
+     * @param context - Request context
+     * @returns Tool handler function
+     * @private
+     */
+    private createToolLogic;
+    /**
+     * Determines the appropriate response formatter based on tool configuration.
+     * For SQL formatters, extracts and passes formatting configuration (tableFormat, maxDisplayRows).
+     */
+    private getResponseFormatter;
+    private buildAnnotations;
+    private mergeCustomMetadata;
+    /**
+     * Format tool name into a human-readable title
+     * @param toolName - Tool name
+     * @returns Formatted title
+     * @private
+     */
+    private formatToolTitle;
+    /**
+     * Build configuration from multiple sources
+     * @param sources - Array of configuration sources
+     * @param options - Merge options
+     * @param context - Request context
+     * @returns Built configuration
+     */
+    buildFromSources(sources: ConfigSource[], options?: ConfigMergeOptions, context?: RequestContext): Promise<ConfigBuildResult>;
+    /**
+     * Resolve all file paths from sources
+     * @private
+     */
+    private resolveAllFilePaths;
+    /**
+     * Resolve paths for a single source
+     * @private
+     */
+    private resolveSourcePaths;
+    /**
+     * Resolve a single file path
+     * @private
+     */
+    private resolveFilePath;
+    /**
+     * Resolve directory paths
+     * @private
+     */
+    private resolveDirectoryPaths;
+    /**
+     * Resolve glob paths
+     * @private
+     */
+    private resolveGlobPaths;
+    /**
+     * Load all configurations from file paths
+     * @private
+     */
+    private loadAllConfigurations;
+    /**
+     * Merge multiple configurations
+     * Uses environment-configured merge options from config.yamlMergeOptions as defaults
+     * @private
+     */
+    private mergeConfigurations;
+    /**
+     * Merge a configuration into the target
+     * @private
+     */
+    private mergeIntoTarget;
+    /**
+     * Validate the merged configuration
+     * @private
+     */
+    private validateMergedConfiguration;
+    static fromFile(filePath: string, context?: RequestContext): Promise<ConfigBuildResult>;
+    static fromFiles(filePaths: string[], context?: RequestContext): Promise<ConfigBuildResult>;
+    static fromDirectory(directoryPath: string, context?: RequestContext): Promise<ConfigBuildResult>;
+    static fromGlob(pattern: string, baseDir?: string, context?: RequestContext): Promise<ConfigBuildResult>;
+}
+//# sourceMappingURL=toolConfigBuilder.d.ts.map

package/dist/ibmi-mcp-server/utils/config/toolConfigBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolConfigBuilder.d.ts","sourceRoot":"","sources":["../../../../src/ibmi-mcp-server/utils/config/toolConfigBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,aAAa,EACb,gBAAgB,EAIjB,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAEL,cAAc,EACf,MAAM,oCAAoC,CAAC;AAU5C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4CAA4C;IAC5C,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,8CAA8C;IAC9C,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,wCAAwC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoB;IAE3C;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,iBAAiB;IAOvC;;;;;OAKG;IACH,iBAAiB,CACf,UAAU,EAAE,gBAAgB,EAAE,EAC9B,QAAQ,EAAE,MAAM,GACf,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IAgM5C;;;;;OAKG;IACH,qBAAqB,CACnB,cAAc,EAAE,gBAAgB,EAAE,EAClC,eAAe,EAAE,MAAM,EAAE,GACxB,gBAAgB,EAAE;IAcrB;;;;;;;;OAQG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,gBAAgB,CAAC;IA8D5B;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;IAoFvB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,gBAAgB;IA2DxB,OAAO,CAAC,mBAAmB;IAgB3B;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAWvB;;;;;;OAMG;IACG,gBAAgB,CACpB,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,CAAC,EAAE,kBAAkB,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,iBAAiB,CAAC;IA2D7B;;;OAGG;YACW,mBAAmB;IAyBjC;;;OAGG;YACW,kBAAkB;IAmBhC;;;OAGG;IACH,OAAO,CAAC,eAAe;IAWvB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAa7B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;OAGG;YACW,qBAAqB;IA+BnC;;;;OAIG;YACW,mBAAmB;IAoDjC;;;OAGG;YACW,eAAe;IAoF7B;;;OAGG;YACW,2BAA2B;WAoC5B,QAAQ,CACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,iBAAiB,CAAC;WAShB,SAAS,CACpB,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,iBAAiB,CAAC;WAUhB,aAAa,CACxB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,iBAAiB,CAAC;WAShB,QAAQ,CACnB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,iBAAiB,CAAC;CAQ9B"}