better-gemini-mcp 1.0.0

package/dist/tools/fetch-chunk.tool.js

@@ -0,0 +1,123 @@
+/**
+ * Fetch Chunk Tool
+ * Retrieve a specific chunk of a large response that was previously split
+ * (PRD §5.7)
+ */
+import { z } from "zod";
+import { ERROR_CODES, ERROR_MESSAGES } from "../constants.js";
+import { getResponse, getChunk, getCacheMetadata, Logger } from "../utils/index.js";
+// ============================================================================
+// Schema
+// ============================================================================
+const fetchChunkSchema = z.object({
+    cacheKey: z.string().describe("Cache key returned in initial chunked response"),
+    chunkIndex: z
+        .number()
+        .int()
+        .positive()
+        .describe("1-based index of chunk to retrieve"),
+});
+// ============================================================================
+// Tool Implementation
+// ============================================================================
+export const fetchChunkTool = {
+    name: "fetch_chunk",
+    description: "Retrieve continuation of a large response. Use when a previous tool response included 'chunks' metadata indicating more content available. Example: {cacheKey: 'cache_abc123', chunkIndex: 2}",
+    zodSchema: fetchChunkSchema,
+    category: "utility",
+    execute: async (args, _onProgress) => {
+        const { cacheKey, chunkIndex } = args;
+        Logger.info(`fetch_chunk: Fetching chunk ${chunkIndex} for cacheKey=${cacheKey}`);
+        // Validate cacheKey
+        if (!cacheKey || typeof cacheKey !== "string") {
+            return JSON.stringify({
+                error: {
+                    code: ERROR_CODES.INVALID_ARGUMENT,
+                    message: "cacheKey must be a non-empty string",
+                    details: { field: "cacheKey" },
+                },
+            }, null, 2);
+        }
+        // Validate chunkIndex
+        if (!Number.isInteger(chunkIndex) || chunkIndex < 1) {
+            return JSON.stringify({
+                error: {
+                    code: ERROR_CODES.INVALID_ARGUMENT,
+                    message: "chunkIndex must be a positive integer (1-based)",
+                    details: { field: "chunkIndex", provided: chunkIndex },
+                },
+            }, null, 2);
+        }
+        // Check if cache entry exists
+        const cacheEntry = getResponse(cacheKey);
+        if (!cacheEntry) {
+            Logger.warn(`fetch_chunk: Cache key not found or expired: ${cacheKey}`);
+            return JSON.stringify({
+                error: {
+                    code: ERROR_CODES.CACHE_EXPIRED,
+                    message: ERROR_MESSAGES.CACHE_EXPIRED,
+                    details: {
+                        cacheKey,
+                        nextStep: "Cache expired (1-hour TTL). Re-run the original query to regenerate the response.",
+                    },
+                },
+            }, null, 2);
+        }
+        // Get cache metadata for total chunks
+        const metadata = getCacheMetadata(cacheKey);
+        if (!metadata) {
+            return JSON.stringify({
+                error: {
+                    code: ERROR_CODES.CACHE_EXPIRED,
+                    message: ERROR_MESSAGES.CACHE_EXPIRED,
+                    details: {
+                        cacheKey,
+                        nextStep: "Cache expired (1-hour TTL). Re-run the original query to regenerate the response.",
+                    },
+                },
+            }, null, 2);
+        }
+        // Validate chunk index is within range
+        if (chunkIndex > metadata.totalChunks) {
+            Logger.warn(`fetch_chunk: Chunk index ${chunkIndex} out of range (total: ${metadata.totalChunks})`);
+            return JSON.stringify({
+                error: {
+                    code: ERROR_CODES.INVALID_CHUNK_INDEX,
+                    message: ERROR_MESSAGES.INVALID_CHUNK_INDEX,
+                    details: {
+                        requestedIndex: chunkIndex,
+                        totalChunks: metadata.totalChunks,
+                        nextStep: `Request a chunk index between 1 and ${metadata.totalChunks}`,
+                    },
+                },
+            }, null, 2);
+        }
+        // Get the specific chunk
+        const chunk = getChunk(cacheKey, chunkIndex);
+        if (!chunk) {
+            return JSON.stringify({
+                error: {
+                    code: ERROR_CODES.INTERNAL,
+                    message: "Failed to retrieve chunk from cache",
+                    details: { cacheKey, chunkIndex },
+                },
+            }, null, 2);
+        }
+        // Build response
+        const response = {
+            tool: "fetch_chunk",
+            cacheKey,
+            chunk: {
+                index: chunkIndex,
+                total: metadata.totalChunks,
+                content: chunk.content,
+            },
+            meta: {
+                expiresAt: metadata.expiresAt.toISOString(),
+            },
+        };
+        Logger.info(`fetch_chunk: Successfully retrieved chunk ${chunkIndex}/${metadata.totalChunks}`);
+        return JSON.stringify(response, null, 2);
+    },
+};
+//# sourceMappingURL=fetch-chunk.tool.js.map

package/dist/tools/fetch-chunk.tool.js.map

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

package/dist/tools/health-check.tool.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Health Check Tool
+ * Confirm the MCP server is running and validate Gemini CLI setup
+ * (PRD §5.6)
+ */
+import type { UnifiedTool } from "./registry.js";
+export declare const healthCheckTool: UnifiedTool;
+//# sourceMappingURL=health-check.tool.d.ts.map

package/dist/tools/health-check.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.tool.d.ts","sourceRoot":"","sources":["../../src/tools/health-check.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AA2BjD,eAAO,MAAM,eAAe,EAAE,WA8G7B,CAAC"}

package/dist/tools/health-check.tool.js

@@ -0,0 +1,113 @@
+/**
+ * Health Check Tool
+ * Confirm the MCP server is running and validate Gemini CLI setup
+ * (PRD §5.6)
+ */
+import { z } from "zod";
+import { SERVER_INFO, ERROR_CODES } from "../constants.js";
+import { isGeminiCLIInstalled, getGeminiVersion, checkGeminiAuth, getProjectRoot, Logger, } from "../utils/index.js";
+// ============================================================================
+// Schema
+// ============================================================================
+const healthCheckSchema = z.object({
+    includeDiagnostics: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Include detailed diagnostics (Gemini CLI version, auth status, etc.)"),
+});
+// ============================================================================
+// Tool Implementation
+// ============================================================================
+export const healthCheckTool = {
+    name: "health_check",
+    description: "Verify server status and Gemini CLI configuration. Use for troubleshooting connection issues or confirming setup. Example: {includeDiagnostics: true}",
+    zodSchema: healthCheckSchema,
+    category: "utility",
+    execute: async (args, _onProgress) => {
+        const { includeDiagnostics } = args;
+        const projectRoot = getProjectRoot();
+        Logger.info(`health_check: Starting with includeDiagnostics=${includeDiagnostics}`);
+        // Basic health check - just verify the server is running
+        const baseResponse = {
+            tool: "health_check",
+            status: "ok",
+            server: {
+                name: SERVER_INFO.NAME,
+                version: SERVER_INFO.VERSION,
+            },
+        };
+        // If diagnostics not requested, return basic response
+        if (!includeDiagnostics) {
+            Logger.info("health_check: Basic check completed successfully");
+            return JSON.stringify(baseResponse, null, 2);
+        }
+        // Run diagnostics
+        Logger.debug("health_check: Running diagnostics...");
+        try {
+            // Check Gemini CLI installation
+            const geminiOnPath = await isGeminiCLIInstalled();
+            // Get version if installed
+            let geminiVersion = null;
+            if (geminiOnPath) {
+                geminiVersion = await getGeminiVersion();
+            }
+            // Check authentication
+            let authConfigured = false;
+            let authMethod;
+            if (geminiOnPath) {
+                const auth = await checkGeminiAuth();
+                authConfigured = auth.configured;
+                authMethod = auth.method;
+            }
+            // Build diagnostics response
+            const diagnostics = {
+                projectRoot,
+                geminiOnPath,
+                geminiVersion,
+                authConfigured,
+                readOnlyModeEnforced: true, // We never use --yolo flag
+            };
+            // Add auth method if available
+            if (authMethod) {
+                diagnostics.authMethod = authMethod;
+            }
+            // Add warnings if there are issues
+            const warnings = [];
+            if (!geminiOnPath) {
+                warnings.push("Gemini CLI not found on PATH. Install with: npm install -g @google/gemini-cli");
+            }
+            if (geminiOnPath && !authConfigured) {
+                warnings.push("Gemini CLI authentication not configured. Run 'gemini' and select 'Login with Google'.");
+            }
+            if (warnings.length > 0) {
+                diagnostics.warnings = warnings;
+            }
+            // Determine overall status
+            const status = geminiOnPath && authConfigured ? "ok" : "degraded";
+            const response = {
+                tool: "health_check",
+                status,
+                server: {
+                    name: SERVER_INFO.NAME,
+                    version: SERVER_INFO.VERSION,
+                },
+                diagnostics,
+            };
+            Logger.info(`health_check: Diagnostics completed - status=${status}`);
+            return JSON.stringify(response, null, 2);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            Logger.error(`health_check: Diagnostics failed - ${errorMessage}`);
+            return JSON.stringify({
+                error: {
+                    code: ERROR_CODES.INTERNAL,
+                    message: `Health check failed: ${errorMessage}`,
+                    details: { phase: "diagnostics" },
+                },
+            }, null, 2);
+        }
+    },
+};
+//# sourceMappingURL=health-check.tool.js.map

package/dist/tools/health-check.tool.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tool Registry Exports for Better Gemini MCP Server
+ *
+ * This file registers all tools and exports registry functions.
+ * Tools are imported and added to the toolRegistry array here.
+ */
+import { toolRegistry } from "./registry.js";
+export * from "./registry.js";
+export { toolRegistry };
+export { quickQueryTool } from "./quick-query.tool.js";
+export { deepResearchTool } from "./deep-research.tool.js";
+export { analyzeDirectoryTool } from "./analyze-directory.tool.js";
+export { validatePathsTool } from "./validate-paths.tool.js";
+export { healthCheckTool } from "./health-check.tool.js";
+export { fetchChunkTool } from "./fetch-chunk.tool.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AA+B7C,cAAc,eAAe,CAAC;AAG9B,OAAO,EAAE,YAAY,EAAE,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,35 @@
+/**
+ * Tool Registry Exports for Better Gemini MCP Server
+ *
+ * This file registers all tools and exports registry functions.
+ * Tools are imported and added to the toolRegistry array here.
+ */
+import { toolRegistry } from "./registry.js";
+// ============================================================================
+// Tool Imports
+// ============================================================================
+import { quickQueryTool } from "./quick-query.tool.js";
+import { deepResearchTool } from "./deep-research.tool.js";
+import { analyzeDirectoryTool } from "./analyze-directory.tool.js";
+import { validatePathsTool } from "./validate-paths.tool.js";
+import { healthCheckTool } from "./health-check.tool.js";
+import { fetchChunkTool } from "./fetch-chunk.tool.js";
+// ============================================================================
+// Tool Registration
+// ============================================================================
+toolRegistry.push(quickQueryTool, deepResearchTool, analyzeDirectoryTool, validatePathsTool, healthCheckTool, fetchChunkTool);
+// ============================================================================
+// Exports
+// ============================================================================
+// Re-export everything from registry
+export * from "./registry.js";
+// Export the registry for direct access if needed
+export { toolRegistry };
+// Export individual tools for direct access
+export { quickQueryTool } from "./quick-query.tool.js";
+export { deepResearchTool } from "./deep-research.tool.js";
+export { analyzeDirectoryTool } from "./analyze-directory.tool.js";
+export { validatePathsTool } from "./validate-paths.tool.js";
+export { healthCheckTool } from "./health-check.tool.js";
+export { fetchChunkTool } from "./fetch-chunk.tool.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,YAAY,CAAC,IAAI,CACf,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,cAAc,CACf,CAAC;AAEF,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,qCAAqC;AACrC,cAAc,eAAe,CAAC;AAE9B,kDAAkD;AAClD,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,4CAA4C;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/tools/quick-query.tool.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Quick Query Tool
+ * Send a lightweight research prompt to Gemini CLI for fast analysis
+ * Uses flash model for speed (PRD §5.2)
+ */
+import type { UnifiedTool } from "./registry.js";
+export declare const quickQueryTool: UnifiedTool;
+//# sourceMappingURL=quick-query.tool.d.ts.map

package/dist/tools/quick-query.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-query.tool.d.ts","sourceRoot":"","sources":["../../src/tools/quick-query.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAwDjD,eAAO,MAAM,cAAc,EAAE,WAuI5B,CAAC"}

package/dist/tools/quick-query.tool.js

@@ -0,0 +1,154 @@
+/**
+ * Quick Query Tool
+ * Send a lightweight research prompt to Gemini CLI for fast analysis
+ * Uses flash model for speed (PRD §5.2)
+ */
+import { z } from "zod";
+import { ERROR_CODES, ERROR_MESSAGES } from "../constants.js";
+import { executeGeminiCLI, getProjectRoot, checkPromptPathsValid, chunkResponse, needsChunking, cacheResponse, Logger, } from "../utils/index.js";
+// ============================================================================
+// Schema
+// ============================================================================
+const quickQuerySchema = z.object({
+    prompt: z.string().describe("Research question or analysis request"),
+    focus: z
+        .enum(["security", "architecture", "performance", "general"])
+        .optional()
+        .describe("Optional focus area to guide analysis"),
+    responseStyle: z
+        .enum(["concise", "normal", "detailed"])
+        .optional()
+        .default("normal")
+        .describe("Desired verbosity of response"),
+});
+// ============================================================================
+// Focus Area Instructions
+// ============================================================================
+const FOCUS_INSTRUCTIONS = {
+    security: "Focus on security implications, vulnerabilities, attack vectors, and security best practices.",
+    architecture: "Focus on architectural patterns, design decisions, component relationships, and structural concerns.",
+    performance: "Focus on performance characteristics, bottlenecks, optimization opportunities, and efficiency.",
+    general: "", // No additional focus instructions
+};
+// ============================================================================
+// Response Style Instructions
+// ============================================================================
+const STYLE_INSTRUCTIONS = {
+    concise: "Provide a brief, focused response with only essential information.",
+    normal: "Provide a balanced response with key details and explanations.",
+    detailed: "Provide a comprehensive response with thorough analysis and examples.",
+};
+// ============================================================================
+// Tool Implementation
+// ============================================================================
+export const quickQueryTool = {
+    name: "quick_query",
+    description: "Analyze code/files quickly using Gemini's large context window. Preferred when questions mention specific files or require reading repository code. Example: {prompt: 'Explain @src/auth.ts security approach', focus: 'security', responseStyle: 'concise'}",
+    zodSchema: quickQuerySchema,
+    category: "query",
+    execute: async (args, onProgress) => {
+        const startTime = Date.now();
+        const { prompt, focus, responseStyle } = args;
+        const projectRoot = getProjectRoot();
+        Logger.info(`quick_query: Starting with focus=${focus || "none"}, style=${responseStyle || "normal"}`);
+        // Validate prompt
+        if (!prompt || prompt.trim().length === 0) {
+            return JSON.stringify({
+                error: {
+                    code: ERROR_CODES.INVALID_ARGUMENT,
+                    message: ERROR_MESSAGES.NO_PROMPT_PROVIDED,
+                    details: { field: "prompt" },
+                },
+            }, null, 2);
+        }
+        // Pre-validate @path references (optional but recommended)
+        const pathValidation = checkPromptPathsValid(prompt, projectRoot);
+        if (!pathValidation.isValid) {
+            return JSON.stringify({
+                error: {
+                    code: ERROR_CODES.PATH_NOT_ALLOWED,
+                    message: "Invalid @path references in prompt",
+                    details: {
+                        invalidPaths: pathValidation.invalidPaths,
+                        nextStep: "Use validate_paths tool to check which paths are accessible, or adjust paths to be within project root",
+                    },
+                },
+            }, null, 2);
+        }
+        // Build the full prompt with focus and style instructions
+        let fullPrompt = prompt;
+        if (focus && focus !== "general") {
+            fullPrompt = `${FOCUS_INSTRUCTIONS[focus]}\n\n${fullPrompt}`;
+        }
+        if (responseStyle && responseStyle !== "normal") {
+            fullPrompt = `${STYLE_INSTRUCTIONS[responseStyle]}\n\n${fullPrompt}`;
+        }
+        try {
+            // Execute Gemini CLI
+            const result = await executeGeminiCLI(fullPrompt, "quick_query", onProgress);
+            // Handle chunking if needed
+            let answer = result.answer;
+            let chunks;
+            if (needsChunking(result.answer)) {
+                const chunked = chunkResponse(result.answer);
+                const cacheKey = cacheResponse(chunked);
+                chunks = { cacheKey, current: 1, total: chunked.length };
+                answer = chunked[0].content;
+                Logger.debug(`quick_query: Response chunked into ${chunked.length} chunks, cacheKey=${cacheKey}`);
+            }
+            const latencyMs = Date.now() - startTime;
+            // Build response
+            const response = {
+                tool: "quick_query",
+                model: result.model,
+                focus: focus || "general",
+                responseStyle: responseStyle || "normal",
+                answer,
+                filesAccessed: result.filesAccessed,
+                stats: {
+                    tokensUsed: result.stats.tokensUsed,
+                    toolCalls: result.stats.toolCalls,
+                    latencyMs,
+                },
+                ...(chunks && { chunks }),
+                meta: {
+                    projectRoot,
+                    truncated: false,
+                    warnings: chunks ? ["Response chunked due to size. Use fetch_chunk tool to retrieve remaining content."] : [],
+                },
+            };
+            Logger.info(`quick_query: Completed in ${latencyMs}ms`);
+            return JSON.stringify(response, null, 2);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            Logger.error(`quick_query: Failed - ${errorMessage}`);
+            // Determine error code and provide recovery hints
+            let code = ERROR_CODES.GEMINI_CLI_ERROR;
+            let nextStep = "Check server logs for details";
+            if (errorMessage.includes("not found") || errorMessage.includes("ENOENT")) {
+                code = ERROR_CODES.GEMINI_CLI_NOT_FOUND;
+                nextStep = "Install Gemini CLI: npm install -g @google/gemini-cli, or run setup wizard: npx better-gemini-mcp init";
+            }
+            else if (errorMessage.includes("auth") || errorMessage.includes("login")) {
+                code = ERROR_CODES.AUTH_MISSING;
+                nextStep = "Authenticate Gemini CLI: run 'gemini' and select 'Login with Google', or set GEMINI_API_KEY environment variable";
+            }
+            else if (errorMessage.includes("quota")) {
+                code = ERROR_CODES.QUOTA_EXCEEDED;
+                nextStep = "Quota exhausted after fallback. Wait for quota reset or upgrade plan. Consider using quick_query for lighter tasks.";
+            }
+            return JSON.stringify({
+                error: {
+                    code,
+                    message: errorMessage,
+                    details: {
+                        tool: "quick_query",
+                        nextStep,
+                    },
+                },
+            }, null, 2);
+        }
+    },
+};
+//# sourceMappingURL=quick-query.tool.js.map

package/dist/tools/quick-query.tool.js.map

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

package/dist/tools/registry.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Tool Registry for Better Gemini MCP Server
+ * Defines the UnifiedTool interface and provides tool execution functionality
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { ZodTypeAny } from "zod";
+import type { ToolArguments, ProgressCallback } from "../types.js";
+/**
+ * Unified tool definition interface
+ * Each tool in the registry follows this structure
+ */
+export interface UnifiedTool {
+    /** Tool name (snake_case, e.g., 'quick_query') */
+    name: string;
+    /** Human-readable description for MCP tools/list */
+    description: string;
+    /** Zod schema for input validation */
+    zodSchema: ZodTypeAny;
+    /** Execute the tool with validated arguments */
+    execute: (args: ToolArguments, onProgress?: ProgressCallback) => Promise<string>;
+    /** Optional category for grouping */
+    category?: "query" | "utility";
+}
+/**
+ * Registry of all available tools
+ * Tools are added to this array in src/tools/index.ts
+ */
+export declare const toolRegistry: UnifiedTool[];
+/**
+ * Check if a tool exists in the registry
+ */
+export declare function toolExists(toolName: string): boolean;
+/**
+ * Get MCP Tool definitions from the registry
+ * Converts Zod schemas to JSON Schema format for MCP protocol
+ */
+export declare function getToolDefinitions(): Tool[];
+/**
+ * Execute a tool by name with the given arguments
+ * Validates arguments against the tool's Zod schema before execution
+ */
+export declare function executeTool(toolName: string, args: ToolArguments, onProgress?: ProgressCallback): Promise<string>;
+/**
+ * Get a tool by name from the registry
+ */
+export declare function getTool(toolName: string): UnifiedTool | undefined;
+/**
+ * Register a new tool in the registry
+ * This is an alternative to directly pushing to toolRegistry
+ */
+export declare function registerTool(tool: UnifiedTool): void;
+//# 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":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,KAAK,CAAC;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAMnE;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IAEb,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IAEpB,sCAAsC;IACtC,SAAS,EAAE,UAAU,CAAC;IAEtB,gDAAgD;IAChD,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjF,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC;AAMD;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,WAAW,EAAO,CAAC;AAM9C;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,EAAE,CAsB3C;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,aAAa,EACnB,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAcD;;GAEG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEjE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAKpD"}