kemdicode-mcp 1.15.0

package/dist/tools/recursive/invoke-batch.tool.js

@@ -0,0 +1,99 @@
+/**
+ * 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/>.
+ */
+/**
+ * Invoke Batch Tool
+ *
+ * Invoke multiple tools in a batch (parallel or sequential).
+ *
+ * @module tools/recursive/invoke-batch
+ */
+import { z } from 'zod';
+import { v4 as uuidv4 } from 'uuid';
+import { Logger } from '../../utils/logger.js';
+import { checkRateLimit } from '../../utils/validation.js';
+import { invokeBatch, DEFAULT_POLICY } from '../../recursive/index.js';
+const operationSchema = z.object({
+    toolName: z.string().min(1).describe('Tool name'),
+    args: z.record(z.string(), z.unknown()).describe('Tool arguments'),
+    id: z.string().optional().describe('Operation ID for tracking'),
+});
+const schema = z.object({
+    operations: z.array(operationSchema).min(1).max(10).describe('Operations to execute (1-10)'),
+    agentId: z.string().min(1).describe('Agent ID'),
+    sessionId: z.string().min(1).describe('Session ID'),
+    parallel: z.boolean().default(true).describe('Execute in parallel (true) or sequential (false)'),
+    stopOnError: z.boolean().default(false).describe('Stop on first error (sequential only)'),
+});
+export const invokeBatchTool = {
+    name: 'invoke-batch',
+    description: 'Invoke multiple tools in a batch (parallel or sequential execution)',
+    zodSchema: schema,
+    execute: async (args) => {
+        const input = args;
+        if (!checkRateLimit('recursive-operations', { maxRequests: 50, windowMs: 60000 })) {
+            return JSON.stringify({
+                success: false,
+                error: 'Rate limit exceeded for recursive operations',
+                code: 'RATE_LIMIT_EXCEEDED',
+            });
+        }
+        try {
+            const requests = input.operations.map((op) => ({
+                invocationId: uuidv4(),
+                agentId: input.agentId,
+                sessionId: input.sessionId,
+                toolName: op.toolName,
+                args: op.args,
+                timestamp: Date.now(),
+            }));
+            const startTime = Date.now();
+            const results = await invokeBatch(requests, DEFAULT_POLICY, input.parallel);
+            const totalDuration = Date.now() - startTime;
+            const successCount = results.filter((r) => r.success).length;
+            const failureCount = results.length - successCount;
+            Logger.debug(`invoke-batch: ${successCount}/${results.length} succeeded in ${totalDuration}ms`);
+            return JSON.stringify({
+                success: failureCount === 0,
+                totalOperations: results.length,
+                successCount,
+                failureCount,
+                totalDuration,
+                parallel: input.parallel,
+                results: results.map((r, i) => ({
+                    operationId: input.operations[i].id || `op-${i}`,
+                    toolName: input.operations[i].toolName,
+                    success: r.success,
+                    result: r.result,
+                    error: r.error,
+                    duration: r.duration,
+                    depth: r.depth,
+                })),
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            Logger.error(`invoke-batch error: ${errorMessage}`);
+            return JSON.stringify({
+                success: false,
+                error: errorMessage,
+                code: 'BATCH_ERROR',
+            });
+        }
+    },
+};
+//# sourceMappingURL=invoke-batch.tool.js.map

package/dist/tools/recursive/invoke-batch.tool.js.map

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

package/dist/tools/recursive/invoke-tool.tool.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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 { UnifiedTool } from '../registry.js';
+export declare const invokeToolTool: UnifiedTool;
+//# sourceMappingURL=invoke-tool.tool.d.ts.map

package/dist/tools/recursive/invoke-tool.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke-tool.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/recursive/invoke-tool.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAYH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAmB7C,eAAO,MAAM,cAAc,EAAE,WAkE5B,CAAC"}

package/dist/tools/recursive/invoke-tool.tool.js

@@ -0,0 +1,100 @@
+/**
+ * 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/>.
+ */
+/**
+ * Invoke Tool Tool
+ *
+ * Allows agents to invoke other MCP tools recursively.
+ *
+ * @module tools/recursive/invoke-tool
+ */
+import { z } from 'zod';
+import { v4 as uuidv4 } from 'uuid';
+import { Logger } from '../../utils/logger.js';
+import { checkRateLimit } from '../../utils/validation.js';
+import { invokeTool, checkSafety, DEFAULT_POLICY } from '../../recursive/index.js';
+const schema = z.object({
+    toolName: z.string().min(1).describe('Name of the tool to invoke'),
+    args: z.record(z.string(), z.unknown()).describe('Arguments to pass to the tool'),
+    agentId: z.string().min(1).describe('Agent ID making the invocation'),
+    sessionId: z.string().min(1).describe('Session ID'),
+    reason: z.string().optional().describe('Reason for invoking this tool'),
+    dryRun: z
+        .boolean()
+        .default(false)
+        .describe('Check if invocation would be allowed without executing'),
+});
+export const invokeToolTool = {
+    name: 'invoke-tool',
+    description: 'Invoke another MCP tool from within an agent context (recursive tool usage)',
+    zodSchema: schema,
+    execute: async (args) => {
+        const input = args;
+        if (!checkRateLimit('recursive-operations', { maxRequests: 50, windowMs: 60000 })) {
+            return JSON.stringify({
+                success: false,
+                error: 'Rate limit exceeded for recursive operations',
+                code: 'RATE_LIMIT_EXCEEDED',
+            });
+        }
+        const request = {
+            invocationId: uuidv4(),
+            agentId: input.agentId,
+            sessionId: input.sessionId,
+            toolName: input.toolName,
+            args: input.args,
+            reason: input.reason,
+            timestamp: Date.now(),
+        };
+        try {
+            // Dry run - just check if it would be allowed
+            if (input.dryRun) {
+                const safety = await checkSafety(request, DEFAULT_POLICY);
+                return JSON.stringify({
+                    success: true,
+                    dryRun: true,
+                    allowed: safety.allowed,
+                    reason: safety.reason,
+                    requiresApproval: safety.requiresSupervisorApproval,
+                    currentDepth: safety.currentDepth,
+                    rateLimit: safety.rateLimit,
+                });
+            }
+            // Actually invoke the tool
+            const result = await invokeTool(request, DEFAULT_POLICY);
+            Logger.debug(`invoke-tool: ${input.toolName} invoked by ${input.agentId}`);
+            return JSON.stringify({
+                success: result.success,
+                invocationId: result.invocationId,
+                result: result.result,
+                error: result.error,
+                duration: result.duration,
+                depth: result.depth,
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            Logger.error(`invoke-tool error: ${errorMessage}`);
+            return JSON.stringify({
+                success: false,
+                error: errorMessage,
+                code: 'INVOCATION_ERROR',
+            });
+        }
+    },
+};
+//# sourceMappingURL=invoke-tool.tool.js.map

package/dist/tools/recursive/invoke-tool.tool.js.map

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

package/dist/tools/registry.d.ts

@@ -0,0 +1,261 @@
+/**
+ * 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/>.
+ */
+/**
+ * Tool Registry Module
+ *
+ * Centralized registry for all MCP tools. Handles tool registration,
+ * schema conversion to JSON Schema, execution with validation, and
+ * automatic context sharing to Redis.
+ *
+ * @module tools/registry
+ */
+import { Tool, Prompt } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import type { BaseToolArguments } from '../types/tool-types.js';
+/**
+ * Type alias for tool arguments
+ * Uses the strongly-typed BaseToolArguments from types module
+ */
+export type ToolArguments = BaseToolArguments;
+export { McpError, InputValidationError, ToolExecutionError, TimeoutError, FileNotFoundError, PermissionError, CommandError, DangerousOperationError, formatErrorResponse, fromNodeError, errorToJsonString, } from '../utils/errors.js';
+/**
+ * Generic Zod schema type
+ * Using z.ZodTypeAny which is the proper Zod 4 type for any schema
+ */
+type ZodSchema = z.ZodTypeAny;
+/**
+ * Progress callback function type
+ */
+export type ProgressCallback = (output: string) => void;
+/**
+ * Tool executor function type
+ * Uses ToolArguments by default for backward compatibility
+ */
+export type ToolExecutor<T = ToolArguments> = (args: T, onProgress?: ProgressCallback) => Promise<string>;
+/**
+ * Unified tool interface for MCP tool registration
+ *
+ * When using the generic parameter (UnifiedTool<typeof schema>), the execute
+ * function will receive properly typed arguments. Without the generic parameter,
+ * args will be typed as ToolArguments for backward compatibility.
+ *
+ * @interface UnifiedTool
+ * @template TSchema - Zod schema type for input validation (defaults to ZodSchema)
+ *
+ * @example
+ * ```typescript
+ * // Typed tool (recommended for new tools)
+ * const schema = z.object({ files: z.string() });
+ * const typedTool: UnifiedTool<typeof schema> = {
+ *   name: 'my-tool',
+ *   zodSchema: schema,
+ *   execute: async (args) => args.files  // args.files is typed as string
+ * };
+ *
+ * // Untyped tool (backward compatible)
+ * const untypedTool: UnifiedTool = {
+ *   name: 'old-tool',
+ *   zodSchema: schema,
+ *   execute: async (args) => String(args.files)  // args has ToolArguments type
+ * };
+ * ```
+ */
+export interface UnifiedTool<TSchema extends ZodSchema = ZodSchema> {
+    /** Unique tool name (used in MCP protocol) */
+    name: string;
+    /** Human-readable tool description */
+    description: string;
+    /** Zod schema for input validation */
+    zodSchema: TSchema;
+    /** Optional prompt configuration for prompt-based invocation */
+    prompt?: {
+        description: string;
+    };
+    /** Set to true to skip auto-sharing context for this tool */
+    skipContextShare?: boolean;
+    /**
+     * Tool execution function
+     * When TSchema is explicitly provided, args is typed as z.infer<TSchema>
+     * Otherwise, args defaults to ToolArguments for backward compatibility
+     */
+    execute: TSchema extends ZodSchema ? ToolExecutor<z.infer<TSchema> extends infer U ? (unknown extends U ? ToolArguments : U) : ToolArguments> : ToolExecutor<ToolArguments>;
+}
+/**
+ * Helper type to create a typed tool definition
+ * This allows TypeScript to infer the argument type from the Zod schema
+ *
+ * @example
+ * ```typescript
+ * const mySchema = z.object({ files: z.string() });
+ * type MyTool = TypedTool<typeof mySchema>;
+ * // MyTool.execute receives { files: string } as first argument
+ * ```
+ */
+export type TypedTool<TSchema extends ZodSchema> = UnifiedTool<TSchema>;
+/**
+ * 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 declare function createTypedTool<TSchema extends ZodSchema>(definition: UnifiedTool<TSchema>): UnifiedTool<TSchema>;
+/**
+ * @deprecated Use registryManager methods instead. Kept for backward compatibility.
+ * @description Direct access to the tool registry array
+ */
+export declare const toolRegistry: readonly UnifiedTool[];
+/**
+ * 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 declare const registerTool: (tool: UnifiedTool) => void;
+/**
+ * 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 declare const toolExists: (name: string) => boolean;
+/**
+ * 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 declare const getToolByName: (name: string) => UnifiedTool | undefined;
+/**
+ * Internal tool names that should skip context sharing
+ * @enum {string}
+ */
+export declare enum InternalToolName {
+    PING = "ping",
+    HELP = "Help",
+    TIMEOUT_TEST = "timeout-test",
+    GET_SHARED_CONTEXT = "get-shared-context",
+    AGENT_LIST = "agent-list",
+    AGENT_REGISTER = "agent-register",
+    AGENT_WATCH = "agent-watch",
+    AGENT_ALERT = "agent-alert",
+    AGENT_INJECT = "agent-inject",
+    AGENT_HISTORY = "agent-history"
+}
+/**
+ * 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 declare function getToolDefinitions(): Tool[];
+/**
+ * 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 declare function getPromptDefinitions(): Prompt[];
+/**
+ * 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 declare function executeTool(name: string, args: ToolArguments, onProgress?: (output: string) => void): Promise<string>;
+/**
+ * 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 declare function getPromptMessage(name: string, args: Record<string, unknown>): string;
+//# sourceMappingURL=registry.d.ts.map

package/dist/tools/registry.d.ts.map

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