better-gemini-mcp 1.0.0

package/dist/utils/geminiExecutor.js

@@ -0,0 +1,281 @@
+/**
+ * Gemini CLI executor utility
+ * Handles all interactions with the Gemini CLI binary
+ * Implements 3-tier model fallback strategy (PRD §7.3)
+ */
+import { SYSTEM_PROMPT, MODEL_TIERS, CLI, ERROR_MESSAGES, STATUS_MESSAGES } from "../constants.js";
+import { Logger } from "./logger.js";
+import { executeCommand, commandExists, getCommandVersion } from "./commandExecutor.js";
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Get model tiers for a specific tool
+ *
+ * @param toolName - The tool requesting Gemini execution
+ * @returns Array of model names to try in order (null = auto-select)
+ */
+function getModelTiers(toolName) {
+    const config = MODEL_TIERS[toolName] ?? MODEL_TIERS.quick_query;
+    return [config.tier1, config.tier2, config.tier3];
+}
+/**
+ * Check if an error is a quota/capacity error that should trigger fallback
+ *
+ * @param error - The error to check
+ * @returns true if this is a quota error
+ */
+function isQuotaError(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    const message = error.message.toLowerCase();
+    return (message.includes("quota") ||
+        message.includes("resource_exhausted") ||
+        message.includes("rate limit") ||
+        message.includes("capacity") ||
+        message.includes("too many requests") ||
+        message.includes("429"));
+}
+/**
+ * Build Gemini CLI arguments
+ *
+ * @param prompt - The full prompt to send
+ * @param model - Model name or null for auto-select
+ * @returns Array of CLI arguments
+ */
+function buildGeminiArgs(prompt, model) {
+    const args = [];
+    // Add model flag if specified (Tier 3 uses auto-select with no -m flag)
+    if (model !== null) {
+        args.push(CLI.FLAGS.MODEL, model);
+    }
+    // Required flags for headless mode
+    args.push(CLI.FLAGS.YES); // Auto-approve file reads
+    args.push(CLI.FLAGS.OUTPUT_FORMAT, CLI.OUTPUT_FORMATS.JSON);
+    // Add prompt
+    args.push(CLI.FLAGS.PROMPT, prompt);
+    // NEVER add --yolo flag (read-only enforcement)
+    return args;
+}
+/**
+ * Parse JSON output from Gemini CLI
+ *
+ * @param output - Raw stdout from Gemini CLI
+ * @returns Parsed response data
+ */
+function parseGeminiOutput(output) {
+    try {
+        // Try to parse as JSON
+        const parsed = JSON.parse(output);
+        // Handle different possible response structures
+        if (typeof parsed === "object" && parsed !== null) {
+            // Look for common response fields
+            const text = parsed.response ||
+                parsed.text ||
+                parsed.content ||
+                parsed.answer ||
+                parsed.result ||
+                (typeof parsed === "string" ? parsed : JSON.stringify(parsed, null, 2));
+            return {
+                text: String(text),
+                tokensUsed: parsed.usage?.totalTokens || parsed.tokensUsed || parsed.tokens,
+                toolCalls: parsed.toolCalls || parsed.tool_calls?.length || 0,
+                filesAccessed: extractFilesFromResponse(parsed),
+            };
+        }
+        return { text: output };
+    }
+    catch {
+        // If not valid JSON, return raw output
+        // This handles cases where Gemini outputs plain text
+        return { text: output };
+    }
+}
+/**
+ * Extract file paths from Gemini response
+ *
+ * @param response - Parsed Gemini response object
+ * @returns Array of file paths that were accessed
+ */
+function extractFilesFromResponse(response) {
+    const files = [];
+    if (typeof response !== "object" || response === null) {
+        return files;
+    }
+    const obj = response;
+    // Check common fields for file references
+    if (Array.isArray(obj.filesAccessed)) {
+        files.push(...obj.filesAccessed);
+    }
+    if (Array.isArray(obj.files)) {
+        files.push(...obj.files);
+    }
+    // Extract from tool calls if present
+    if (Array.isArray(obj.tool_calls)) {
+        for (const call of obj.tool_calls) {
+            if (call.name === "read_file" && typeof call.path === "string") {
+                files.push(call.path);
+            }
+        }
+    }
+    // Parse "Files Referenced" section from text if present
+    const text = String(obj.response || obj.text || obj.content || "");
+    const fileMatches = text.match(/## Files Referenced\n([\s\S]*?)(?:\n##|$)/);
+    if (fileMatches) {
+        const fileLines = fileMatches[1]
+            .split("\n")
+            .map((line) => line.replace(/^[-*]\s*/, "").trim())
+            .filter((line) => line.length > 0 && !line.startsWith("#"));
+        files.push(...fileLines);
+    }
+    // Deduplicate
+    return [...new Set(files)];
+}
+// ============================================================================
+// Main Execution Function
+// ============================================================================
+/**
+ * Execute a prompt using Gemini CLI with model fallback
+ *
+ * @param prompt - The user's research prompt
+ * @param toolName - The tool initiating this request (determines model selection)
+ * @param onProgress - Optional callback for progress updates
+ * @returns GeminiResponse with the answer and metadata
+ */
+export async function executeGeminiCLI(prompt, toolName, onProgress) {
+    const startTime = Date.now();
+    // Prepend system prompt
+    const finalPrompt = `${SYSTEM_PROMPT}\n\n---\n\nUSER REQUEST:\n${prompt}`;
+    // Get model tiers for this tool
+    const modelTiers = getModelTiers(toolName);
+    Logger.info(`Executing Gemini CLI for tool: ${toolName}`);
+    // Try each tier with fallback
+    let lastError = null;
+    for (let i = 0; i < modelTiers.length; i++) {
+        const model = modelTiers[i];
+        const tierName = model ?? "auto-select";
+        try {
+            Logger.debug(`Attempting tier ${i + 1} with model: ${tierName}`);
+            if (i > 0) {
+                // Log fallback attempt
+                const message = i === 1 ? STATUS_MESSAGES.FALLBACK_RETRY : STATUS_MESSAGES.AUTO_SELECT_RETRY;
+                Logger.warn(message);
+                onProgress?.(message + "\n");
+            }
+            const args = buildGeminiArgs(finalPrompt, model);
+            const output = await executeCommand(CLI.COMMANDS.GEMINI, args, onProgress);
+            // Parse the output
+            const parsed = parseGeminiOutput(output);
+            const latencyMs = Date.now() - startTime;
+            Logger.info(`Gemini CLI completed in ${latencyMs}ms with model: ${tierName}`);
+            if (i > 0) {
+                Logger.info(STATUS_MESSAGES.FALLBACK_SUCCESS);
+            }
+            return {
+                answer: parsed.text,
+                filesAccessed: parsed.filesAccessed || [],
+                stats: {
+                    tokensUsed: parsed.tokensUsed || 0,
+                    toolCalls: parsed.toolCalls || 0,
+                    latencyMs,
+                },
+                model: model ?? "auto",
+            };
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            // Check if this is a quota error and we have more tiers to try
+            if (isQuotaError(error) && i < modelTiers.length - 1) {
+                Logger.warn(`${ERROR_MESSAGES.QUOTA_EXCEEDED_SHORT} (tier ${i + 1})`);
+                continue; // Try next tier
+            }
+            // Not a quota error or no more tiers - throw
+            Logger.error(`Gemini CLI failed: ${lastError.message}`);
+            throw lastError;
+        }
+    }
+    // Should not reach here, but just in case
+    throw lastError ?? new Error("Gemini CLI execution failed");
+}
+// ============================================================================
+// Validation Functions
+// ============================================================================
+/**
+ * Check if Gemini CLI is installed and accessible
+ *
+ * @returns true if gemini command exists on PATH
+ */
+export async function isGeminiCLIInstalled() {
+    return commandExists(CLI.COMMANDS.GEMINI);
+}
+/**
+ * Get Gemini CLI version
+ *
+ * @returns Version string or null if not installed
+ */
+export async function getGeminiVersion() {
+    return getCommandVersion(CLI.COMMANDS.GEMINI);
+}
+/**
+ * Check if Gemini CLI authentication is configured
+ * Checks for GEMINI_API_KEY env var or existing authenticated session
+ *
+ * @returns Object with auth status
+ */
+export async function checkGeminiAuth() {
+    // Check for API key
+    if (process.env.GEMINI_API_KEY) {
+        return { configured: true, method: "api_key" };
+    }
+    // Check for Vertex AI credentials
+    if (process.env.GOOGLE_APPLICATION_CREDENTIALS || process.env.VERTEX_AI_PROJECT) {
+        return { configured: true, method: "vertex_ai" };
+    }
+    // Try a minimal test invocation to check for Google login session
+    try {
+        await executeCommand(CLI.COMMANDS.GEMINI, [
+            CLI.FLAGS.PROMPT,
+            "test",
+            CLI.FLAGS.OUTPUT_FORMAT,
+            CLI.OUTPUT_FORMATS.JSON,
+        ]);
+        return { configured: true, method: "google_login" };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (message.includes("auth") || message.includes("login") || message.includes("credential")) {
+            return { configured: false };
+        }
+        // Other errors might still mean auth is configured
+        return { configured: true, method: "google_login" };
+    }
+}
+/**
+ * Validate Gemini CLI setup (installation + auth)
+ *
+ * @returns Object with validation results
+ */
+export async function validateGeminiSetup() {
+    const errors = [];
+    // Check installation
+    const installed = await isGeminiCLIInstalled();
+    if (!installed) {
+        errors.push(ERROR_MESSAGES.GEMINI_CLI_NOT_FOUND);
+    }
+    // Get version
+    const version = installed ? await getGeminiVersion() : null;
+    // Check auth
+    const auth = installed ? await checkGeminiAuth() : { configured: false };
+    if (installed && !auth.configured) {
+        errors.push(ERROR_MESSAGES.AUTH_MISSING);
+    }
+    return {
+        installed,
+        version,
+        authenticated: auth.configured,
+        authMethod: auth.method,
+        errors,
+    };
+}
+//# sourceMappingURL=geminiExecutor.js.map

package/dist/utils/geminiExecutor.js.map

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

package/dist/utils/ignorePatterns.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Ignore patterns utility for directory enumeration
+ * Respects .gitignore and hard-coded exclusions (PRD §6.3)
+ */
+import { type Ignore } from "ignore";
+/**
+ * Hard-coded ignore patterns that are always applied
+ * These are common directories that should never be sent to Gemini
+ */
+export declare const HARD_CODED_IGNORES: readonly string[];
+/**
+ * Parse .gitignore file and return an ignore instance
+ *
+ * @param projectRoot - The project root directory
+ * @returns Ignore instance configured with .gitignore rules
+ */
+export declare function parseGitignore(projectRoot: string): Ignore;
+/**
+ * Check if a file path should be ignored
+ *
+ * @param filePath - Relative file path (from project root)
+ * @param projectRoot - The project root directory
+ * @returns true if the file should be ignored
+ */
+export declare function isIgnored(filePath: string, projectRoot: string): boolean;
+/**
+ * Create an ignore filter function
+ *
+ * @param projectRoot - The project root directory
+ * @returns Function that returns true if a path should be ignored
+ */
+export declare function createIgnoreFilter(projectRoot: string): (filePath: string) => boolean;
+/**
+ * Directory entry for enumeration results
+ */
+export interface DirectoryEnumerationEntry {
+    path: string;
+    relativePath: string;
+    isDirectory: boolean;
+}
+/**
+ * Enumerate files in a directory, respecting ignore rules
+ *
+ * @param dirPath - Absolute path to directory to enumerate
+ * @param projectRoot - The project root directory
+ * @param maxFiles - Maximum number of files to return (default: 500)
+ * @param maxDepth - Maximum traversal depth (default: unlimited = -1)
+ * @returns Array of file entries with relative paths
+ */
+export declare function enumerateDirectory(dirPath: string, projectRoot: string, maxFiles?: number, maxDepth?: number): Promise<{
+    entries: DirectoryEnumerationEntry[];
+    truncated: boolean;
+    warnings: string[];
+}>;
+/**
+ * Get only file entries (not directories) from enumeration
+ *
+ * @param dirPath - Absolute path to directory to enumerate
+ * @param projectRoot - The project root directory
+ * @param maxFiles - Maximum number of files to return
+ * @param maxDepth - Maximum traversal depth
+ * @returns Array of file paths (relative to project root)
+ */
+export declare function enumerateFiles(dirPath: string, projectRoot: string, maxFiles?: number, maxDepth?: number): Promise<{
+    files: string[];
+    truncated: boolean;
+    warnings: string[];
+}>;
+//# sourceMappingURL=ignorePatterns.d.ts.map

package/dist/utils/ignorePatterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignorePatterns.d.ts","sourceRoot":"","sources":["../../src/utils/ignorePatterns.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAe,EAAE,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AAO7C;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAA4B,CAAC;AAE7E;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAkB1D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAKxE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAMrF;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,MAAY,EACtB,QAAQ,GAAE,MAAW,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA6F3F;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,MAAY,EACtB,QAAQ,GAAE,MAAW,GACpB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAYtE"}

package/dist/utils/ignorePatterns.js

@@ -0,0 +1,178 @@
+/**
+ * Ignore patterns utility for directory enumeration
+ * Respects .gitignore and hard-coded exclusions (PRD §6.3)
+ */
+import * as fs from "fs";
+import * as path from "path";
+import ignore from "ignore";
+import { DEFAULT_IGNORE_PATTERNS } from "../constants.js";
+import { isWithinProjectRoot } from "./pathValidator.js";
+// Cast the import to the correct type (ESM interop workaround)
+const createIgnore = ignore;
+/**
+ * Hard-coded ignore patterns that are always applied
+ * These are common directories that should never be sent to Gemini
+ */
+export const HARD_CODED_IGNORES = DEFAULT_IGNORE_PATTERNS;
+/**
+ * Parse .gitignore file and return an ignore instance
+ *
+ * @param projectRoot - The project root directory
+ * @returns Ignore instance configured with .gitignore rules
+ */
+export function parseGitignore(projectRoot) {
+    const ig = createIgnore();
+    // Always add hard-coded patterns first
+    ig.add(HARD_CODED_IGNORES);
+    // Try to read .gitignore
+    const gitignorePath = path.join(projectRoot, ".gitignore");
+    try {
+        if (fs.existsSync(gitignorePath)) {
+            const content = fs.readFileSync(gitignorePath, "utf-8");
+            ig.add(content);
+        }
+    }
+    catch {
+        // Silently ignore errors reading .gitignore
+    }
+    return ig;
+}
+/**
+ * Check if a file path should be ignored
+ *
+ * @param filePath - Relative file path (from project root)
+ * @param projectRoot - The project root directory
+ * @returns true if the file should be ignored
+ */
+export function isIgnored(filePath, projectRoot) {
+    const ig = parseGitignore(projectRoot);
+    // Normalize path to use forward slashes for ignore matching
+    const normalizedPath = filePath.replace(/\\/g, "/");
+    return ig.ignores(normalizedPath);
+}
+/**
+ * Create an ignore filter function
+ *
+ * @param projectRoot - The project root directory
+ * @returns Function that returns true if a path should be ignored
+ */
+export function createIgnoreFilter(projectRoot) {
+    const ig = parseGitignore(projectRoot);
+    return (filePath) => {
+        const normalizedPath = filePath.replace(/\\/g, "/");
+        return ig.ignores(normalizedPath);
+    };
+}
+/**
+ * Enumerate files in a directory, respecting ignore rules
+ *
+ * @param dirPath - Absolute path to directory to enumerate
+ * @param projectRoot - The project root directory
+ * @param maxFiles - Maximum number of files to return (default: 500)
+ * @param maxDepth - Maximum traversal depth (default: unlimited = -1)
+ * @returns Array of file entries with relative paths
+ */
+export async function enumerateDirectory(dirPath, projectRoot, maxFiles = 500, maxDepth = -1) {
+    const entries = [];
+    const warnings = [];
+    const ignoreFilter = createIgnoreFilter(projectRoot);
+    // Validate that dirPath is within project root
+    if (!isWithinProjectRoot(dirPath, projectRoot)) {
+        warnings.push(`Directory ${dirPath} is outside project root`);
+        return { entries, truncated: false, warnings };
+    }
+    // Check directory exists
+    try {
+        const stats = fs.statSync(dirPath);
+        if (!stats.isDirectory()) {
+            warnings.push(`${dirPath} is not a directory`);
+            return { entries, truncated: false, warnings };
+        }
+    }
+    catch {
+        warnings.push(`Directory ${dirPath} does not exist or is not accessible`);
+        return { entries, truncated: false, warnings };
+    }
+    // Recursive enumeration with depth tracking
+    async function enumerateRecursive(currentPath, currentDepth) {
+        // Check depth limit
+        if (maxDepth >= 0 && currentDepth > maxDepth) {
+            return;
+        }
+        // Check file limit
+        if (entries.length >= maxFiles) {
+            return;
+        }
+        try {
+            const items = fs.readdirSync(currentPath, { withFileTypes: true });
+            for (const item of items) {
+                // Check file limit again for each item
+                if (entries.length >= maxFiles) {
+                    break;
+                }
+                const absolutePath = path.join(currentPath, item.name);
+                const relativePath = path.relative(projectRoot, absolutePath);
+                const normalizedRelative = relativePath.replace(/\\/g, "/");
+                // Check if this path should be ignored
+                // For directories, check with trailing slash
+                const checkPath = item.isDirectory()
+                    ? normalizedRelative + "/"
+                    : normalizedRelative;
+                if (ignoreFilter(checkPath)) {
+                    continue;
+                }
+                if (item.isDirectory()) {
+                    // Add directory entry and recurse
+                    entries.push({
+                        path: absolutePath,
+                        relativePath: normalizedRelative,
+                        isDirectory: true,
+                    });
+                    // Recurse into subdirectory
+                    await enumerateRecursive(absolutePath, currentDepth + 1);
+                }
+                else if (item.isFile()) {
+                    entries.push({
+                        path: absolutePath,
+                        relativePath: normalizedRelative,
+                        isDirectory: false,
+                    });
+                }
+            }
+        }
+        catch (err) {
+            const error = err;
+            // Log permission errors but continue
+            if (error.code === "EACCES" || error.code === "EPERM") {
+                warnings.push(`Permission denied: ${currentPath}`);
+            }
+        }
+    }
+    await enumerateRecursive(dirPath, 0);
+    const truncated = entries.length >= maxFiles;
+    if (truncated) {
+        warnings.push(`Exceeded maxFiles limit; showing first ${maxFiles} files only`);
+    }
+    return { entries, truncated, warnings };
+}
+/**
+ * Get only file entries (not directories) from enumeration
+ *
+ * @param dirPath - Absolute path to directory to enumerate
+ * @param projectRoot - The project root directory
+ * @param maxFiles - Maximum number of files to return
+ * @param maxDepth - Maximum traversal depth
+ * @returns Array of file paths (relative to project root)
+ */
+export async function enumerateFiles(dirPath, projectRoot, maxFiles = 500, maxDepth = -1) {
+    const result = await enumerateDirectory(dirPath, projectRoot, maxFiles, maxDepth);
+    const files = result.entries
+        .filter((e) => !e.isDirectory)
+        .map((e) => e.relativePath);
+    return {
+        files,
+        truncated: result.truncated,
+        warnings: result.warnings,
+    };
+}
+//# sourceMappingURL=ignorePatterns.js.map

package/dist/utils/ignorePatterns.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Utility module exports for Better Gemini MCP Server
+ */
+export { Logger } from "./logger.js";
+export { executeCommand, commandExists, getCommandVersion, } from "./commandExecutor.js";
+export { executeGeminiCLI, isGeminiCLIInstalled, getGeminiVersion, checkGeminiAuth, validateGeminiSetup, type GeminiResponse, type ToolName, } from "./geminiExecutor.js";
+export { validatePath, isWithinProjectRoot, extractAtPathReferences, validatePromptPaths, checkPromptPathsValid, getProjectRoot, } from "./pathValidator.js";
+export { HARD_CODED_IGNORES, parseGitignore, isIgnored, createIgnoreFilter, enumerateDirectory, enumerateFiles, type DirectoryEnumerationEntry, } from "./ignorePatterns.js";
+export { generateCacheKey, cacheResponse, getResponse, getChunk, hasValidCache, getCacheMetadata, deleteCache, clearExpired, clearAll, getCacheStats, } from "./responseCache.js";
+export { chunkResponse, needsChunking, estimateChunkCount, getChunkSizeKB, } from "./responseChunker.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EACL,cAAc,EACd,aAAa,EACb,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,QAAQ,GACd,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,KAAK,yBAAyB,GAC/B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,aAAa,GACd,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,cAAc,GACf,MAAM,sBAAsB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,18 @@
+/**
+ * Utility module exports for Better Gemini MCP Server
+ */
+// Logging
+export { Logger } from "./logger.js";
+// Command execution
+export { executeCommand, commandExists, getCommandVersion, } from "./commandExecutor.js";
+// Gemini CLI execution
+export { executeGeminiCLI, isGeminiCLIInstalled, getGeminiVersion, checkGeminiAuth, validateGeminiSetup, } from "./geminiExecutor.js";
+// Path validation
+export { validatePath, isWithinProjectRoot, extractAtPathReferences, validatePromptPaths, checkPromptPathsValid, getProjectRoot, } from "./pathValidator.js";
+// Ignore patterns
+export { HARD_CODED_IGNORES, parseGitignore, isIgnored, createIgnoreFilter, enumerateDirectory, enumerateFiles, } from "./ignorePatterns.js";
+// Response caching
+export { generateCacheKey, cacheResponse, getResponse, getChunk, hasValidCache, getCacheMetadata, deleteCache, clearExpired, clearAll, getCacheStats, } from "./responseCache.js";
+// Response chunking
+export { chunkResponse, needsChunking, estimateChunkCount, getChunkSizeKB, } from "./responseChunker.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,UAAU;AACV,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,oBAAoB;AACpB,OAAO,EACL,cAAc,EACd,aAAa,EACb,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,uBAAuB;AACvB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GAGpB,MAAM,qBAAqB,CAAC;AAE7B,kBAAkB;AAClB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,kBAAkB;AAClB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,GAEf,MAAM,qBAAqB,CAAC;AAE7B,mBAAmB;AACnB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,oBAAoB;AACpB,OAAO,EACL,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,cAAc,GACf,MAAM,sBAAsB,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Structured logging utility for Better Gemini MCP Server
+ * Implements logging with levels: error, warn, info, debug
+ * NEVER logs sensitive credentials like GEMINI_API_KEY
+ */
+/**
+ * Logger class for structured logging
+ */
+export declare class Logger {
+    /**
+     * Log an error message (always logged)
+     */
+    static error(message: string, ...args: unknown[]): void;
+    /**
+     * Log a warning message (always logged)
+     */
+    static warn(message: string, ...args: unknown[]): void;
+    /**
+     * Log an info message (always logged)
+     */
+    static info(message: string, ...args: unknown[]): void;
+    /**
+     * Log a debug message (only when DEBUG env var is set)
+     */
+    static debug(message: string, ...args: unknown[]): void;
+    /**
+     * Log a tool invocation (sanitized parameters, excludes full prompts)
+     */
+    static toolInvocation(toolName: string, args: Record<string, unknown>): void;
+    /**
+     * Log command execution (command args, not output)
+     */
+    static commandExecution(command: string, args: string[], startTime: number): void;
+    /**
+     * Log command completion with timing
+     */
+    static commandComplete(startTime: number, exitCode: number | null, outputLength?: number): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiEH;;GAEG;AACH,qBAAa,MAAM;IACjB;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAUvD;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAUtD;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAUtD;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAYvD;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAS5E;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAYjF;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;CAOhG"}