@ibm/ibmi-mcp-server 0.1.0

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

@@ -0,0 +1,126 @@
+/**
+ * @fileoverview Toolset manager for YAML-based tools
+ * Replaces the suite system with toolset-based organization
+ *
+ * @module src/utils/yaml/toolsetManager
+ */
+import { SqlToolsetConfig, SqlToolsConfig } from "../../schemas/index.js";
+import { RequestContext } from "../../../utils/internal/requestContext.js";
+/**
+ * Global tools that are automatically added to all toolsets
+ * These tools are typically TypeScript-based tools that provide universal functionality
+ */
+export declare const GLOBAL_TOOLS: readonly ["describe_sql_object"];
+/**
+ * Toolset information for MCP tool metadata
+ */
+export interface ToolsetInfo {
+    /** Tool name */
+    toolName: string;
+    /** Toolsets this tool belongs to */
+    toolsets: string[];
+    /** Toolset metadata for MCP */
+    toolsetMetadata: Record<string, SqlToolsetConfig>;
+}
+/**
+ * Toolset statistics
+ */
+export interface ToolsetStats {
+    /** Total number of toolsets */
+    totalToolsets: number;
+    /** Total number of tools */
+    totalTools: number;
+    /** Tools that belong to multiple toolsets */
+    multiToolsetTools: string[];
+    /** Toolsets with their tool counts */
+    toolsetCounts: Record<string, number>;
+}
+/**
+ * Toolset manager for YAML-based tools
+ * Manages toolset organization and metadata for MCP tools
+ */
+export declare class ToolsetManager {
+    private static instance;
+    private toolsetConfig;
+    private toolToToolsets;
+    private toolsetToTools;
+    /**
+     * Get the singleton instance of the ToolsetManager
+     */
+    static getInstance(): ToolsetManager;
+    /**
+     * Initialize the toolset manager with YAML configuration
+     * @param config - YAML configuration with toolsets (can be enhanced with TypeScript tools)
+     * @param context - Request context for logging
+     */
+    initialize(config: SqlToolsConfig, context?: RequestContext): Promise<void>;
+    /**
+     * Get toolset information for a specific tool
+     * @param toolName - Name of the tool
+     * @returns Toolset information for the tool
+     */
+    getToolsetInfo(toolName: string): ToolsetInfo;
+    /**
+     * Get all tools in a specific toolset
+     * @param toolsetName - Name of the toolset
+     * @returns Array of tool names in the toolset
+     */
+    getToolsInToolset(toolsetName: string): string[];
+    /**
+     * Get all toolset names
+     * @returns Array of toolset names
+     */
+    getAllToolsetNames(): string[];
+    /**
+     * Get toolset configuration
+     * @param toolsetName - Name of the toolset
+     * @returns Toolset configuration or undefined if not found
+     */
+    getToolsetConfig(toolsetName: string): SqlToolsetConfig | undefined;
+    /**
+     * Get statistics about toolsets
+     * @returns Toolset statistics
+     */
+    getToolsetStats(): ToolsetStats;
+    /**
+     * Check if a tool belongs to a specific toolset
+     * @param toolName - Name of the tool
+     * @param toolsetName - Name of the toolset
+     * @returns True if the tool belongs to the toolset
+     */
+    isToolInToolset(toolName: string, toolsetName: string): boolean;
+    /**
+     * Get all tools with their toolset memberships
+     * @returns Map of tool names to their toolset arrays
+     */
+    getAllToolToolsetMappings(): Map<string, string[]>;
+    /**
+     * Filter tools by toolset
+     * @param toolsetName - Name of the toolset to filter by
+     * @param allTools - Array of all tool names
+     * @returns Array of tool names that belong to the toolset
+     */
+    filterToolsByToolset(toolsetName: string, allTools: string[]): string[];
+    /**
+     * Generate MCP tool metadata with toolset information
+     * @param toolName - Name of the tool
+     * @param additionalMetadata - Additional metadata to merge
+     * @returns Metadata object suitable for MCP tool registration
+     */
+    generateToolMetadata(toolName: string, additionalMetadata?: Record<string, unknown>): Record<string, unknown>;
+    /**
+     * Clear all toolset data (for testing)
+     */
+    clearAll(): void;
+    /**
+     * Get a summary of the toolset manager state
+     * @returns Summary object with current state
+     */
+    getSummary(): {
+        toolsetCount: number;
+        toolCount: number;
+        totalMappings: number;
+        toolsWithMultipleToolsets: number;
+    };
+}
+//# sourceMappingURL=toolsetManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolsetManager.d.ts","sourceRoot":"","sources":["../../../../src/ibmi-mcp-server/utils/config/toolsetManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,gBAAgB,EAChB,cAAc,EACf,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAEL,cAAc,EACf,MAAM,oCAAoC,CAAC;AAI5C;;;GAGG;AACH,eAAO,MAAM,YAAY,kCAEf,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,+BAA+B;IAC/B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6B;IACpD,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,cAAc,CAAoC;IAE1D;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,cAAc;IAOpC;;;;OAIG;IACG,UAAU,CACd,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IA4FhB;;;;OAIG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW;IA4B7C;;;;OAIG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAIhD;;;OAGG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;;;OAIG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAInE;;;OAGG;IACH,eAAe,IAAI,YAAY;IAwB/B;;;;;OAKG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAK/D;;;OAGG;IACH,yBAAyB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAIlD;;;;;OAKG;IACH,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAKvE;;;;;OAKG;IACH,oBAAoB,CAClB,QAAQ,EAAE,MAAM,EAChB,kBAAkB,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAC/C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAW1B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAMhB;;;OAGG;IACH,UAAU,IAAI;QACZ,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,yBAAyB,EAAE,MAAM,CAAC;KACnC;CAaF"}

package/dist/ibmi-mcp-server/utils/config/toolsetManager.js

@@ -0,0 +1,240 @@
+/**
+ * @fileoverview Toolset manager for YAML-based tools
+ * Replaces the suite system with toolset-based organization
+ *
+ * @module src/utils/yaml/toolsetManager
+ */
+import { ErrorHandler, logger } from "../../../utils/internal/index.js";
+import { requestContextService, } from "../../../utils/internal/requestContext.js";
+import { JsonRpcErrorCode, McpError } from "../../../types-global/errors.js";
+import { TOOL_NAME } from "../../tools/generateSql/registration.js";
+/**
+ * Global tools that are automatically added to all toolsets
+ * These tools are typically TypeScript-based tools that provide universal functionality
+ */
+export const GLOBAL_TOOLS = [
+    TOOL_NAME, // SQL DDL generation tool - available to all toolsets
+];
+/**
+ * Toolset manager for YAML-based tools
+ * Manages toolset organization and metadata for MCP tools
+ */
+export class ToolsetManager {
+    static instance;
+    toolsetConfig = {};
+    toolToToolsets = new Map();
+    toolsetToTools = new Map();
+    /**
+     * Get the singleton instance of the ToolsetManager
+     */
+    static getInstance() {
+        if (!ToolsetManager.instance) {
+            ToolsetManager.instance = new ToolsetManager();
+        }
+        return ToolsetManager.instance;
+    }
+    /**
+     * Initialize the toolset manager with YAML configuration
+     * @param config - YAML configuration with toolsets (can be enhanced with TypeScript tools)
+     * @param context - Request context for logging
+     */
+    async initialize(config, context) {
+        const operationContext = context ||
+            requestContextService.createRequestContext({
+                operation: "InitializeToolsetManager",
+            });
+        return ErrorHandler.tryCatch(async () => {
+            logger.info({
+                ...operationContext,
+                toolsetCount: config.toolsets
+                    ? Object.keys(config.toolsets).length
+                    : 0,
+                toolCount: Object.keys(config.tools || {}).length,
+            }, "Initializing toolset manager");
+            // Clear existing data
+            this.toolsetConfig = {};
+            this.toolToToolsets.clear();
+            this.toolsetToTools.clear();
+            // Log global tools that will be added to all toolsets
+            logger.debug({
+                ...operationContext,
+                globalTools: GLOBAL_TOOLS,
+            }, "Global tools will be automatically added to all toolsets");
+            // Process toolsets if they exist
+            if (config.toolsets) {
+                this.toolsetConfig = { ...config.toolsets };
+                // Build toolset-to-tool mappings with global tools
+                for (const [toolsetName, toolset] of Object.entries(config.toolsets)) {
+                    // Combine toolset-specific tools with global tools
+                    const allToolsForToolset = [...toolset.tools, ...GLOBAL_TOOLS];
+                    this.toolsetToTools.set(toolsetName, allToolsForToolset);
+                    // Build tool-to-toolset mappings for both regular and global tools
+                    for (const toolName of allToolsForToolset) {
+                        if (!this.toolToToolsets.has(toolName)) {
+                            this.toolToToolsets.set(toolName, []);
+                        }
+                        this.toolToToolsets.get(toolName).push(toolsetName);
+                    }
+                }
+            }
+            // Validate that all tools referenced in toolsets exist
+            const allToolNames = [
+                ...Object.keys(config.tools || {}), // Regular YAML tools
+                ...GLOBAL_TOOLS, // Global tools (TypeScript-based)
+            ];
+            for (const [toolsetName, toolset] of Object.entries(this.toolsetConfig)) {
+                for (const toolName of toolset.tools) {
+                    if (!allToolNames.includes(toolName)) {
+                        throw new McpError(JsonRpcErrorCode.ValidationError, `Toolset '${toolsetName}' references unknown tool '${toolName}'. Available tools: ${allToolNames.join(", ")}`, { toolsetName, toolName, availableTools: allToolNames });
+                    }
+                }
+            }
+            logger.info({
+                ...operationContext,
+                toolsetCount: Object.keys(this.toolsetConfig).length,
+                toolCount: this.toolToToolsets.size,
+            }, "Toolset manager initialized successfully");
+        }, {
+            operation: "InitializeToolsetManager",
+            context: operationContext,
+            errorCode: JsonRpcErrorCode.InitializationFailed,
+        });
+    }
+    /**
+     * Get toolset information for a specific tool
+     * @param toolName - Name of the tool
+     * @returns Toolset information for the tool
+     */
+    getToolsetInfo(toolName) {
+        let toolsets = this.toolToToolsets.get(toolName) || [];
+        // If this is a global tool but not in the mapping, add it to all toolsets
+        if (GLOBAL_TOOLS.includes(toolName) &&
+            toolsets.length === 0) {
+            toolsets = Object.keys(this.toolsetConfig);
+        }
+        const toolsetMetadata = {};
+        // Build toolset metadata for the tool
+        for (const toolsetName of toolsets) {
+            const toolset = this.toolsetConfig[toolsetName];
+            if (toolset) {
+                toolsetMetadata[toolsetName] = toolset;
+            }
+        }
+        return {
+            toolName,
+            toolsets,
+            toolsetMetadata,
+        };
+    }
+    /**
+     * Get all tools in a specific toolset
+     * @param toolsetName - Name of the toolset
+     * @returns Array of tool names in the toolset
+     */
+    getToolsInToolset(toolsetName) {
+        return this.toolsetToTools.get(toolsetName) || [];
+    }
+    /**
+     * Get all toolset names
+     * @returns Array of toolset names
+     */
+    getAllToolsetNames() {
+        return Object.keys(this.toolsetConfig);
+    }
+    /**
+     * Get toolset configuration
+     * @param toolsetName - Name of the toolset
+     * @returns Toolset configuration or undefined if not found
+     */
+    getToolsetConfig(toolsetName) {
+        return this.toolsetConfig[toolsetName];
+    }
+    /**
+     * Get statistics about toolsets
+     * @returns Toolset statistics
+     */
+    getToolsetStats() {
+        const multiToolsetTools = [];
+        const toolsetCounts = {};
+        // Find tools that belong to multiple toolsets
+        for (const [toolName, toolsets] of this.toolToToolsets) {
+            if (toolsets.length > 1) {
+                multiToolsetTools.push(toolName);
+            }
+        }
+        // Count tools per toolset
+        for (const [toolsetName, tools] of this.toolsetToTools) {
+            toolsetCounts[toolsetName] = tools.length;
+        }
+        return {
+            totalToolsets: Object.keys(this.toolsetConfig).length,
+            totalTools: this.toolToToolsets.size,
+            multiToolsetTools,
+            toolsetCounts,
+        };
+    }
+    /**
+     * Check if a tool belongs to a specific toolset
+     * @param toolName - Name of the tool
+     * @param toolsetName - Name of the toolset
+     * @returns True if the tool belongs to the toolset
+     */
+    isToolInToolset(toolName, toolsetName) {
+        const toolsets = this.toolToToolsets.get(toolName) || [];
+        return toolsets.includes(toolsetName);
+    }
+    /**
+     * Get all tools with their toolset memberships
+     * @returns Map of tool names to their toolset arrays
+     */
+    getAllToolToolsetMappings() {
+        return new Map(this.toolToToolsets);
+    }
+    /**
+     * Filter tools by toolset
+     * @param toolsetName - Name of the toolset to filter by
+     * @param allTools - Array of all tool names
+     * @returns Array of tool names that belong to the toolset
+     */
+    filterToolsByToolset(toolsetName, allTools) {
+        const toolsInToolset = this.getToolsInToolset(toolsetName);
+        return allTools.filter((toolName) => toolsInToolset.includes(toolName));
+    }
+    /**
+     * Generate MCP tool metadata with toolset information
+     * @param toolName - Name of the tool
+     * @param additionalMetadata - Additional metadata to merge
+     * @returns Metadata object suitable for MCP tool registration
+     */
+    generateToolMetadata(toolName, additionalMetadata = {}) {
+        const toolsetInfo = this.getToolsetInfo(toolName);
+        return {
+            ...additionalMetadata,
+            toolsets: toolsetInfo.toolsets,
+            toolsetMetadata: toolsetInfo.toolsetMetadata,
+            toolsetCount: toolsetInfo.toolsets.length,
+        };
+    }
+    /**
+     * Clear all toolset data (for testing)
+     */
+    clearAll() {
+        this.toolsetConfig = {};
+        this.toolToToolsets.clear();
+        this.toolsetToTools.clear();
+    }
+    /**
+     * Get a summary of the toolset manager state
+     * @returns Summary object with current state
+     */
+    getSummary() {
+        const stats = this.getToolsetStats();
+        return {
+            toolsetCount: stats.totalToolsets,
+            toolCount: stats.totalTools,
+            totalMappings: Array.from(this.toolToToolsets.values()).reduce((sum, toolsets) => sum + toolsets.length, 0),
+            toolsWithMultipleToolsets: stats.multiToolsetTools.length,
+        };
+    }
+}
+//# sourceMappingURL=toolsetManager.js.map

package/dist/ibmi-mcp-server/utils/config/toolsetManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolsetManager.js","sourceRoot":"","sources":["../../../../src/ibmi-mcp-server/utils/config/toolsetManager.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,74 @@
+/**
+ * @fileoverview Schema-derived type definitions
+ * All types are inferred from Zod schemas to ensure consistency between validation and TypeScript types
+ *
+ * @module src/ibmi-mcp-server/utils/config/types
+ */
+import { z } from "zod";
+import type { ToolDefinition } from "./toolDefinitions.js";
+import { standardSqlToolOutputSchema } from "./toolDefinitions.js";
+import type { SourceConfig, SqlToolConfig, SqlToolsConfig } from "../../schemas/config.js";
+/**
+ * Configuration source specification
+ */
+export interface ConfigSource {
+    /** Source type identifier */
+    type: "file" | "directory" | "glob";
+    /** Path or pattern */
+    path: string;
+    /** Optional base directory for relative paths */
+    baseDir?: string;
+    /** Whether this source is required */
+    required?: boolean;
+}
+/**
+ * Configuration build result
+ */
+export interface ConfigBuildResult {
+    /** Whether build was successful */
+    success: boolean;
+    /** Merged configuration */
+    config?: SqlToolsConfig;
+    /** Build errors */
+    errors?: string[];
+    /** Build warnings */
+    warnings?: string[];
+    /** Build statistics */
+    stats?: {
+        sourcesLoaded: number;
+        sourcesMerged: number;
+        toolsTotal: number;
+        toolsetsTotal: number;
+        sourcesTotal: number;
+    };
+    /** Resolved file paths that contributed to this build */
+    resolvedFilePaths?: string[];
+}
+/**
+ * Processed tool information after YAML parsing
+ * Includes resolved source and generated metadata
+ */
+export interface ProcessedSQLTool {
+    /** Tool name */
+    name: string;
+    /** Tool configuration from YAML */
+    config: SqlToolConfig;
+    /** Resolved source configuration */
+    source: SourceConfig;
+    /** Toolsets this tool belongs to */
+    toolsets: string[];
+    /** Generated tool metadata compatible with existing system */
+    metadata: {
+        name: string;
+        description: string;
+        domain?: string;
+        category?: string;
+        toolsets: string[];
+    };
+}
+/**
+ * Cached tool configuration that contains all pre-processed data needed for fast registration
+ */
+export type SqlToolDefinition = ToolDefinition<z.ZodObject<Record<string, z.ZodTypeAny>>, typeof standardSqlToolOutputSchema>;
+export type CachedToolConfig = SqlToolDefinition;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/ibmi-mcp-server/utils/config/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACf,MAAM,qCAAqC,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACpC,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,mBAAmB;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,uBAAuB;IACvB,KAAK,CAAC,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,MAAM,EAAE,aAAa,CAAC;IACtB,oCAAoC;IACpC,MAAM,EAAE,YAAY,CAAC;IACrB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8DAA8D;IAC9D,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAC5C,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,EACzC,OAAO,2BAA2B,CACnC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,CAAC"}

package/dist/ibmi-mcp-server/utils/config/types.js

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Schema-derived type definitions
+ * All types are inferred from Zod schemas to ensure consistency between validation and TypeScript types
+ *
+ * @module src/ibmi-mcp-server/utils/config/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ibmi-mcp-server/utils/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/ibmi-mcp-server/utils/config/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/ibmi-mcp-server/utils/security/sqlSecurityValidator.d.ts

@@ -0,0 +1,116 @@
+/**
+ * @fileoverview SQL Security Validator for validating SQL queries against security policies
+ * Provides both AST-based and regex-based validation with comprehensive security checks
+ *
+ * @module src/utils/security/sqlSecurityValidator
+ */
+import { RequestContext } from "../../../utils/internal/requestContext.js";
+import { SqlToolSecurityConfig } from "../../schemas/index.js";
+/**
+ * Security validation result
+ */
+export interface SecurityValidationResult {
+    /** Whether the validation passed */
+    isValid: boolean;
+    /** List of security violations found */
+    violations: string[];
+    /** Validation method used */
+    validationMethod: "ast" | "regex" | "combined";
+}
+/**
+ * Dangerous SQL operations that should be blocked in read-only mode
+ */
+export declare const DANGEROUS_OPERATIONS: readonly ["INSERT", "UPDATE", "DELETE", "REPLACE", "MERGE", "TRUNCATE", "DROP", "CREATE", "ALTER", "RENAME", "CALL", "EXEC", "EXECUTE", "SET", "DECLARE", "GRANT", "REVOKE", "DENY", "LOAD", "IMPORT", "EXPORT", "BULK", "SHUTDOWN", "RESTART", "KILL", "STOP", "START", "BACKUP", "RESTORE", "DUMP", "LOCK", "UNLOCK", "COMMIT", "ROLLBACK", "SAVEPOINT", "QCMDEXC", "SQL_EXECUTE_IMMEDIATE"];
+/**
+ * Dangerous SQL functions that should be monitored/blocked
+ */
+export declare const DANGEROUS_FUNCTIONS: readonly ["SYSTEM", "QCMDEXC", "SQL_EXECUTE_IMMEDIATE", "SQLCMD", "LOAD_EXTENSION", "EXEC", "EXECUTE_IMMEDIATE", "EVAL", "CONCAT", "CHAR", "VARCHAR"];
+/**
+ * Dangerous SQL patterns that should be detected
+ */
+export declare const DANGEROUS_PATTERNS: readonly [RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp];
+/**
+ * SQL Security Validator class for comprehensive SQL security validation
+ */
+export declare class SqlSecurityValidator {
+    private static parser;
+    /**
+     * Validate SQL query against security configuration
+     * @param query - SQL query to validate
+     * @param securityConfig - Security configuration
+     * @param context - Request context for logging
+     * @throws {McpError} If validation fails
+     */
+    static validateQuery(query: string, securityConfig: SqlToolSecurityConfig, context: RequestContext): void;
+    /**
+     * Validate query length against configured limits
+     * @param query - SQL query to validate
+     * @param securityConfig - Security configuration
+     * @private
+     */
+    private static validateQueryLength;
+    /**
+     * Validate forbidden keywords using both AST and regex approaches
+     * @param query - SQL query to validate
+     * @param securityConfig - Security configuration
+     * @param context - Request context for logging
+     * @private
+     */
+    private static validateForbiddenKeywords;
+    /**
+     * Validate read-only restrictions using comprehensive validation
+     * @param query - SQL query to validate
+     * @param context - Request context for logging
+     * @private
+     */
+    private static validateReadOnlyRestrictions;
+    /**
+     * Validate SQL query using AST parsing
+     * @param query - SQL query to validate
+     * @param context - Request context for logging
+     * @private
+     */
+    private static validateQueryAST;
+    /**
+     * Validate SQL query using regex patterns
+     * @param query - SQL query to validate
+     * @param _context - Request context for logging (unused but kept for consistency)
+     * @private
+     */
+    private static validateQueryRegex;
+    /**
+     * Validate forbidden keywords using AST parsing
+     * @param query - SQL query to validate
+     * @param forbiddenKeywords - List of forbidden keywords
+     * @param context - Request context for logging
+     * @private
+     */
+    private static validateForbiddenKeywordsAST;
+    /**
+     * Validate forbidden keywords using regex patterns
+     * @param query - SQL query to validate
+     * @param forbiddenKeywords - List of forbidden keywords
+     * @private
+     */
+    private static validateForbiddenKeywordsRegex;
+    /**
+     * Find dangerous functions anywhere in the AST
+     * @param node - AST node to analyze
+     * @private
+     */
+    private static findDangerousFunctionsInAST;
+    /**
+     * Find forbidden keywords anywhere in the AST
+     * @param node - AST node to analyze
+     * @param forbiddenKeywords - List of forbidden keywords
+     * @private
+     */
+    private static findForbiddenKeywordsInAST;
+    /**
+     * Check for UNION with dangerous statements
+     * @param statement - AST statement to check
+     * @private
+     */
+    private static hasUnionWithDangerousStatements;
+}
+//# sourceMappingURL=sqlSecurityValidator.d.ts.map

package/dist/ibmi-mcp-server/utils/security/sqlSecurityValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlSecurityValidator.d.ts","sourceRoot":"","sources":["../../../../src/ibmi-mcp-server/utils/security/sqlSecurityValidator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,6BAA6B;IAC7B,gBAAgB,EAAE,KAAK,GAAG,OAAO,GAAG,UAAU,CAAC;CAChD;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,gYAgDvB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,mBAAmB,uJAYtB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB,2EAcrB,CAAC;AAEX;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,MAAM,CAAgB;IAErC;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAClB,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,qBAAqB,EACrC,OAAO,EAAE,cAAc,GACtB,IAAI;IA8BP;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAkBlC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAgDxC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,4BAA4B;IAiC3C;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IA4E/B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAoCjC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,4BAA4B;IAsC3C;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,8BAA8B;IAuB7C;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,2BAA2B;IA+B1C;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAuCzC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,+BAA+B;CAmB/C"}