kemdicode-mcp 1.15.0

package/dist/tools/registry.js

@@ -0,0 +1,462 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import { z, ZodError } from 'zod';
+import { shareContext, isContextEnabled } from '../context/index.js';
+import { Logger } from '../utils/logger.js';
+import { McpError, InputValidationError, ToolExecutionError } from '../utils/errors.js';
+/**
+ * Sensitive argument keys that should be masked in logs
+ */
+const SENSITIVE_KEYS = new Set([
+    'password',
+    'token',
+    'secret',
+    'apiKey',
+    'api_key',
+    'apikey',
+    'auth',
+    'authorization',
+    'credential',
+    'credentials',
+    'key',
+    'privateKey',
+    'private_key',
+]);
+/**
+ * Mask sensitive keys for logging
+ */
+function maskSensitiveKeys(keys) {
+    return keys.map((k) => (SENSITIVE_KEYS.has(k.toLowerCase()) ? '[REDACTED]' : k));
+}
+/**
+ * Mask sensitive data from stack traces before logging
+ */
+function maskStackTrace(stack) {
+    if (!stack)
+        return undefined;
+    // Remove potential secrets from stack trace
+    return stack
+        .replace(/password[=:]["']?[^"'\s]+["']?/gi, 'password=[REDACTED]')
+        .replace(/token[=:]["']?[^"'\s]+["']?/gi, 'token=[REDACTED]')
+        .replace(/apikey[=:]["']?[^"'\s]+["']?/gi, 'apiKey=[REDACTED]')
+        .replace(/secret[=:]["']?[^"'\s]+["']?/gi, 'secret=[REDACTED]')
+        .replace(/Bearer\s+[A-Za-z0-9\-._~+/]+=*/g, 'Bearer [REDACTED]');
+}
+// Re-export error types for tool implementations
+export { McpError, InputValidationError, ToolExecutionError, TimeoutError, FileNotFoundError, PermissionError, CommandError, DangerousOperationError, formatErrorResponse, fromNodeError, errorToJsonString, } from '../utils/errors.js';
+/**
+ * Helper function to create a typed tool with proper type inference
+ *
+ * @description Creates a tool definition with full TypeScript type inference
+ *              for the execute function's arguments based on the Zod schema
+ * @param definition - Tool definition with Zod schema
+ * @returns Typed UnifiedTool
+ * @example
+ * ```typescript
+ * const myTool = createTypedTool({
+ *   name: 'my-tool',
+ *   description: 'My tool',
+ *   zodSchema: z.object({ files: z.string() }),
+ *   execute: async (args) => {
+ *     // args.files is correctly typed as string
+ *     return args.files;
+ *   }
+ * });
+ * ```
+ */
+export function createTypedTool(definition) {
+    return definition;
+}
+/**
+ * Tool Registry Manager Class
+ *
+ * Encapsulates tool storage with controlled access methods.
+ * Provides a singleton pattern for centralized tool management.
+ *
+ * @class ToolRegistryManager
+ * @example
+ * ```typescript
+ * // Tools are registered via registerTool() function
+ * registerTool(myTool);
+ *
+ * // Access tools via exported functions
+ * const tools = getToolDefinitions();
+ * ```
+ */
+class ToolRegistryManager {
+    tools = [];
+    /**
+     * Register a new tool in the registry
+     *
+     * @description Adds a tool to the registry if it doesn't already exist.
+     *              Duplicate tools (same name) are silently skipped with a warning.
+     * @param {UnifiedTool} tool - The tool to register
+     * @returns {void}
+     * @example
+     * ```typescript
+     * registry.register({
+     *   name: 'my-tool',
+     *   description: 'My custom tool',
+     *   zodSchema: z.object({ input: z.string() }),
+     *   execute: async (args) => 'result'
+     * });
+     * ```
+     */
+    register(tool) {
+        if (this.exists(tool.name)) {
+            Logger.warn(`Tool '${tool.name}' already registered, skipping duplicate`);
+            return;
+        }
+        this.tools.push(tool);
+    }
+    /**
+     * Check if a tool exists in the registry
+     *
+     * @description Searches the registry for a tool with the given name
+     * @param {string} name - Tool name to check
+     * @returns {boolean} True if tool exists, false otherwise
+     */
+    exists(name) {
+        return this.tools.some((t) => t.name === name);
+    }
+    /**
+     * Find a tool by name
+     *
+     * @description Retrieves a tool from the registry by its unique name
+     * @param {string} name - Tool name to find
+     * @returns {UnifiedTool | undefined} The tool if found, undefined otherwise
+     */
+    find(name) {
+        return this.tools.find((t) => t.name === name);
+    }
+    /**
+     * Get all registered tools
+     *
+     * @description Returns a readonly array of all registered tools
+     * @returns {readonly UnifiedTool[]} Readonly array of all tools
+     */
+    getAll() {
+        return this.tools;
+    }
+    /**
+     * Get tools with prompt support
+     *
+     * @description Filters and returns only tools that have prompt configuration
+     * @returns {readonly UnifiedTool[]} Readonly array of tools with prompt support
+     */
+    getWithPrompts() {
+        return this.tools.filter((t) => t.prompt);
+    }
+    /**
+     * Get the total number of registered tools
+     *
+     * @description Returns the count of tools in the registry
+     * @returns {number} Number of registered tools
+     */
+    get count() {
+        return this.tools.length;
+    }
+}
+/** Singleton tool registry instance */
+const registryManager = new ToolRegistryManager();
+/**
+ * @deprecated Use registryManager methods instead. Kept for backward compatibility.
+ * @description Direct access to the tool registry array
+ */
+export const toolRegistry = registryManager.getAll();
+/**
+ * Register a tool in the registry
+ *
+ * @description Adds a new tool to the central registry. This is the primary
+ *              way to register tools during server initialization.
+ * @param {UnifiedTool} tool - The tool to register
+ * @returns {void}
+ * @example
+ * ```typescript
+ * import { registerTool } from './registry.js';
+ * import { myCustomTool } from './my-tool.js';
+ *
+ * registerTool(myCustomTool);
+ * ```
+ */
+export const registerTool = (tool) => registryManager.register(tool);
+/**
+ * Check if a tool exists in the registry
+ *
+ * @description Checks whether a tool with the given name is already registered
+ * @param {string} name - Tool name to check
+ * @returns {boolean} True if tool exists, false otherwise
+ * @example
+ * ```typescript
+ * if (toolExists('code-review')) {
+ *   console.log('Code review tool is available');
+ * }
+ * ```
+ */
+export const toolExists = (name) => registryManager.exists(name);
+/**
+ * Get a tool by name from the registry
+ *
+ * @description Retrieves a tool definition by its unique name
+ * @param {string} name - Tool name to find
+ * @returns {UnifiedTool | undefined} The tool if found, undefined otherwise
+ * @example
+ * ```typescript
+ * const tool = getToolByName('code-review');
+ * if (tool) {
+ *   console.log(tool.description);
+ * }
+ * ```
+ */
+export const getToolByName = (name) => registryManager.find(name);
+/**
+ * Internal tool names that should skip context sharing
+ * @enum {string}
+ */
+export var InternalToolName;
+(function (InternalToolName) {
+    InternalToolName["PING"] = "ping";
+    InternalToolName["HELP"] = "Help";
+    InternalToolName["TIMEOUT_TEST"] = "timeout-test";
+    InternalToolName["GET_SHARED_CONTEXT"] = "get-shared-context";
+    InternalToolName["AGENT_LIST"] = "agent-list";
+    InternalToolName["AGENT_REGISTER"] = "agent-register";
+    InternalToolName["AGENT_WATCH"] = "agent-watch";
+    InternalToolName["AGENT_ALERT"] = "agent-alert";
+    InternalToolName["AGENT_INJECT"] = "agent-inject";
+    InternalToolName["AGENT_HISTORY"] = "agent-history";
+})(InternalToolName || (InternalToolName = {}));
+/** Tools that should not auto-share their results */
+const SKIP_SHARE_TOOLS = new Set([
+    InternalToolName.PING,
+    InternalToolName.HELP,
+    InternalToolName.TIMEOUT_TEST,
+    InternalToolName.GET_SHARED_CONTEXT, // Avoid recursive context
+    // Agent monitoring tools (internal)
+    InternalToolName.AGENT_LIST,
+    InternalToolName.AGENT_REGISTER,
+    InternalToolName.AGENT_WATCH,
+    InternalToolName.AGENT_ALERT,
+    InternalToolName.AGENT_INJECT,
+    InternalToolName.AGENT_HISTORY,
+]);
+/**
+ * Validate that an object conforms to JsonSchemaShape
+ *
+ * @description Type guard to verify an unknown object matches the expected
+ *              JSON Schema structure with optional properties and required arrays
+ * @param {unknown} obj - Object to validate
+ * @returns {boolean} True if object is a valid JsonSchemaShape
+ */
+function isJsonSchemaShape(obj) {
+    if (typeof obj !== 'object' || obj === null)
+        return false;
+    const schema = obj;
+    const hasValidProperties = schema.properties === undefined ||
+        (typeof schema.properties === 'object' && schema.properties !== null);
+    const hasValidRequired = schema.required === undefined ||
+        (Array.isArray(schema.required) && schema.required.every((r) => typeof r === 'string'));
+    return hasValidProperties && hasValidRequired;
+}
+/**
+ * Get MCP tool definitions for protocol registration
+ *
+ * @description Converts all registered tools to MCP Tool format by transforming
+ *              Zod schemas to JSON Schema format. Used during server initialization
+ *              to expose available tools to MCP clients.
+ * @returns {Tool[]} Array of MCP Tool definitions with inputSchema
+ * @example
+ * ```typescript
+ * const tools = getToolDefinitions();
+ * // Returns: [{ name: 'code-review', description: '...', inputSchema: {...} }, ...]
+ * ```
+ */
+export function getToolDefinitions() {
+    return toolRegistry.map((tool) => {
+        // Use native Zod 4 toJSONSchema with runtime validation
+        const rawSchema = z.toJSONSchema(tool.zodSchema, { target: 'draft-07' });
+        if (!isJsonSchemaShape(rawSchema)) {
+            Logger.warn(`Invalid schema shape for tool '${tool.name}', using empty schema`);
+            return {
+                name: tool.name,
+                description: tool.description,
+                inputSchema: { type: 'object', properties: {}, required: [] },
+            };
+        }
+        return {
+            name: tool.name,
+            description: tool.description,
+            inputSchema: {
+                type: 'object',
+                properties: rawSchema.properties || {},
+                required: rawSchema.required || [],
+            },
+        };
+    });
+}
+/**
+ * Get MCP prompt definitions for tools with prompt support
+ *
+ * @description Filters tools that have prompt configuration and returns them
+ *              as MCP Prompt definitions. Used for prompt-based tool invocation.
+ * @returns {Prompt[]} Array of MCP Prompt definitions with name and description
+ * @example
+ * ```typescript
+ * const prompts = getPromptDefinitions();
+ * // Returns: [{ name: 'plan', description: 'Structured analysis mode' }, ...]
+ * ```
+ */
+export function getPromptDefinitions() {
+    return toolRegistry
+        .filter((t) => t.prompt)
+        .map((t) => ({ name: t.name, description: t.prompt.description }));
+}
+/**
+ * Execute a tool by name with validated arguments
+ *
+ * @description Main entry point for tool execution. Validates arguments against
+ *              the tool's Zod schema, executes the tool, and automatically shares
+ *              results to Redis context for cross-server collaboration.
+ * @param {string} name - Tool name to execute (must match registered tool name)
+ * @param {ToolArguments} args - Tool arguments (will be validated against Zod schema)
+ * @param {Function} [onProgress] - Optional callback for streaming output during execution
+ * @returns {Promise<string>} Tool execution result as a string
+ * @throws {Error} If tool not found (Unknown tool: {name})
+ * @throws {Error} If arguments fail Zod validation (Invalid arguments: {details})
+ * @example
+ * ```typescript
+ * const result = await executeTool('code-review', {
+ *   files: '@src/index.ts',
+ *   focus: 'security'
+ * }, (output) => console.log(output));
+ * ```
+ */
+export async function executeTool(name, args, onProgress) {
+    const tool = toolRegistry.find((t) => t.name === name);
+    if (!tool)
+        throw new ToolExecutionError(name, `Unknown tool: ${name}`, {
+            availableTools: toolRegistry.map((t) => t.name).slice(0, 10),
+        });
+    // Start timing and log tool execution start
+    const startTime = Date.now();
+    Logger.toolExecution('start', name, undefined, {
+        argsKeys: maskSensitiveKeys(Object.keys(args)),
+        hasProgress: !!onProgress,
+    });
+    let result;
+    let isError = false;
+    try {
+        // Validate arguments against schema
+        const validatedArgs = tool.zodSchema.parse(args);
+        Logger.debug(() => `Tool ${name}: arguments validated`, { tool: name });
+        result = await tool.execute(validatedArgs, onProgress);
+        // Log successful completion with timing
+        const duration = Date.now() - startTime;
+        Logger.toolExecution('end', name, duration, {
+            resultLength: result.length,
+            success: true,
+        });
+    }
+    catch (error) {
+        isError = true;
+        const duration = Date.now() - startTime;
+        // Handle Zod validation errors
+        if (error instanceof ZodError) {
+            Logger.toolExecution('error', name, duration, {
+                errorType: 'validation',
+                issues: error.issues.length,
+            });
+            throw InputValidationError.fromZodIssues(error.issues);
+        }
+        // Re-throw McpError subclasses as-is (they already have proper context)
+        if (error instanceof McpError) {
+            // Add tool name to context if not already present
+            if (!error.context.toolName) {
+                error.context.toolName = name;
+            }
+            Logger.toolExecution('error', name, duration, {
+                errorType: error.code,
+                errorMessage: error.message,
+            });
+            throw error;
+        }
+        // Wrap unknown errors in ToolExecutionError
+        if (error instanceof Error) {
+            Logger.toolExecution('error', name, duration, {
+                errorType: 'unknown',
+                errorMessage: error.message,
+            });
+            throw new ToolExecutionError(name, error.message, {}, error);
+        }
+        // Handle non-Error throws
+        Logger.toolExecution('error', name, duration, {
+            errorType: 'non-error',
+            errorValue: String(error),
+        });
+        throw new ToolExecutionError(name, String(error));
+    }
+    // Auto-share context (async, don't block response)
+    if (isContextEnabled() && !tool.skipContextShare && !SKIP_SHARE_TOOLS.has(name)) {
+        shareContext(name, args, result, {
+            errorState: isError,
+        }).catch((err) => {
+            // Log with full context for debugging
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            const errorStack = err instanceof Error ? err.stack : undefined;
+            // Use error level for connection issues, warn for others
+            const isConnectionError = errorMessage.includes('ECONNREFUSED') || errorMessage.includes('ETIMEDOUT');
+            if (isConnectionError) {
+                Logger.error(`Context sharing failed for ${name} (Redis connection issue): ${errorMessage}`);
+            }
+            else {
+                Logger.warn(`Context sharing failed for ${name}: ${errorMessage}`, {
+                    tool: name,
+                    error: errorMessage,
+                    stack: maskStackTrace(errorStack),
+                });
+            }
+        });
+    }
+    return result;
+}
+/**
+ * Generate a human-readable prompt message for a tool invocation
+ *
+ * @description Creates a formatted string representing a tool invocation with
+ *              its parameters. Used for logging and prompt-based tool usage.
+ * @param {string} name - Tool name
+ * @param {Record<string, unknown>} args - Tool arguments
+ * @returns {string} Formatted prompt message (e.g., "Use code-review tool: (files: @src/index.ts) [verbose]")
+ * @throws {Error} If tool has no prompt configuration (No prompt for: {name})
+ * @example
+ * ```typescript
+ * const message = getPromptMessage('code-review', { files: '@src/index.ts', verbose: true });
+ * // Returns: "Use code-review tool: (files: @src/index.ts) [verbose]"
+ * ```
+ */
+export function getPromptMessage(name, args) {
+    const tool = toolRegistry.find((t) => t.name === name);
+    if (!tool?.prompt)
+        throw new Error(`No prompt for: ${name}`);
+    const params = Object.entries(args)
+        .filter(([, v]) => v !== undefined && v !== null && v !== false)
+        .map(([k, v]) => (typeof v === 'boolean' ? `[${k}]` : `(${k}: ${v})`))
+        .join(' ');
+    return `Use ${name} tool${params ? ': ' + params : ''}`;
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"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"}

package/dist/tools/rl/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * RL Tools Index
+ *
+ * Export all RL-related tools.
+ */
+export { rlRewardStatsTool } from './rl-reward-stats.tool.js';
+export { rlDopamineLogTool } from './rl-dopamine-log.tool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/rl/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/rl/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/tools/rl/index.js

@@ -0,0 +1,25 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * RL Tools Index
+ *
+ * Export all RL-related tools.
+ */
+export { rlRewardStatsTool } from './rl-reward-stats.tool.js';
+export { rlDopamineLogTool } from './rl-dopamine-log.tool.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/rl/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/rl/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/tools/rl/rl-dopamine-log.tool.d.ts

@@ -0,0 +1,32 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * RL Dopamine Log Tool
+ *
+ * View dopamine signals for an agent.
+ */
+import { z } from 'zod';
+import { UnifiedTool } from '../registry.js';
+declare const schema: z.ZodObject<{
+    agentId: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    showStats: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const rlDopamineLogTool: UnifiedTool<typeof schema>;
+export {};
+//# sourceMappingURL=rl-dopamine-log.tool.d.ts.map

package/dist/tools/rl/rl-dopamine-log.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rl-dopamine-log.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/rl/rl-dopamine-log.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,QAAA,MAAM,MAAM;;;;iBAIV,CAAC;AAEH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,OAAO,MAAM,CA0GxD,CAAC"}