mcp-server-gemini 1.1.0

package/dist/tools/analyze-codebase.js

@@ -0,0 +1,373 @@
+/**
+ * Tool 6: gemini_analyze_codebase
+ * Codebase analysis tool - Leveraging 1M token context to analyze entire codebase
+ * Priority: P1 - Phase 3
+ *
+ * Upgrade notes (v1.1):
+ * - Added directory parameter: Support direct directory path input
+ * - Added filePaths parameter: Support file path list input
+ * - Added include/exclude parameters: Support glob pattern filtering
+ * - Retained files parameter: Backward compatible with original usage
+ */
+import { GoogleGenAI } from '@google/genai';
+import { validateRequired, validateArray } from '../utils/validators.js';
+import { handleAPIError, logError } from '../utils/error-handler.js';
+import { readDirectory, readFiles } from '../utils/file-reader.js';
+import { SecurityError } from '../utils/security.js';
+// Codebase analysis system prompt
+const CODEBASE_ANALYSIS_SYSTEM_PROMPT = `You are a senior software architect with expertise in:
+- System architecture and design patterns
+- Code quality and best practices
+- Security vulnerabilities and threats
+- Performance optimization
+- Dependency management
+
+Analysis approach:
+1. Overview:
+   - Understand the overall structure
+   - Identify main components and their relationships
+   - Recognize architectural patterns
+
+2. Deep dive (based on focus):
+   - Architecture: Layers, modules, data flow
+   - Security: Vulnerabilities, exposure points
+   - Performance: Bottlenecks, inefficiencies
+   - Dependencies: Version conflicts, outdated packages
+   - Patterns: Design patterns, anti-patterns
+
+3. Recommendations:
+   - Prioritize by impact and effort
+   - Provide actionable suggestions
+   - Include code examples when helpful
+
+Output quality:
+- Be thorough but concise
+- Use clear, professional language
+- Include file paths and line numbers
+- Visualize architecture with Mermaid diagrams
+- Focus on high-impact findings`;
+/**
+ * Detect programming language of file
+ */
+function detectLanguage(filePath) {
+    const ext = filePath.split('.').pop()?.toLowerCase() || '';
+    const languageMap = {
+        'ts': 'TypeScript',
+        'tsx': 'TypeScript (React)',
+        'js': 'JavaScript',
+        'jsx': 'JavaScript (React)',
+        'py': 'Python',
+        'java': 'Java',
+        'kt': 'Kotlin',
+        'go': 'Go',
+        'rs': 'Rust',
+        'cpp': 'C++',
+        'c': 'C',
+        'h': 'C/C++ Header',
+        'hpp': 'C++ Header',
+        'cs': 'C#',
+        'rb': 'Ruby',
+        'php': 'PHP',
+        'swift': 'Swift',
+        'scala': 'Scala',
+        'vue': 'Vue',
+        'svelte': 'Svelte',
+        'html': 'HTML',
+        'css': 'CSS',
+        'scss': 'SCSS',
+        'less': 'LESS',
+        'json': 'JSON',
+        'yaml': 'YAML',
+        'yml': 'YAML',
+        'xml': 'XML',
+        'md': 'Markdown',
+        'sql': 'SQL',
+        'sh': 'Shell',
+        'bash': 'Bash',
+        'ps1': 'PowerShell',
+        'dockerfile': 'Dockerfile',
+    };
+    return languageMap[ext] || 'Unknown';
+}
+/**
+ * Build codebase analysis prompt
+ */
+function buildCodebasePrompt(params, metrics, outputFormat) {
+    let prompt = `# Codebase Analysis Request\n\n`;
+    prompt += `## Codebase Overview\n`;
+    prompt += `- Total Files: ${metrics.totalFiles}\n`;
+    prompt += `- Total Lines: ${metrics.totalLines}\n`;
+    prompt += `- Languages: ${metrics.languages.join(', ')}\n\n`;
+    if (params.focus) {
+        prompt += `## Analysis Focus\n`;
+        switch (params.focus) {
+            case 'architecture':
+                prompt += `Focus on system architecture:
+- Identify architectural patterns (MVC, MVVM, Clean Architecture, etc.)
+- Analyze module/component structure
+- Map data flow and dependencies
+- Identify layers and boundaries
+- Create architecture diagram using Mermaid\n\n`;
+                break;
+            case 'security':
+                prompt += `Focus on security analysis:
+- Identify potential vulnerabilities (OWASP Top 10)
+- Check for hardcoded secrets/credentials
+- Analyze authentication/authorization patterns
+- Review input validation and sanitization
+- Check for SQL injection, XSS, CSRF vulnerabilities\n\n`;
+                break;
+            case 'performance':
+                prompt += `Focus on performance analysis:
+- Identify potential bottlenecks
+- Check for N+1 queries, memory leaks
+- Analyze async/await patterns
+- Review caching strategies
+- Check for inefficient algorithms\n\n`;
+                break;
+            case 'dependencies':
+                prompt += `Focus on dependency analysis:
+- Check for outdated dependencies
+- Identify unused dependencies
+- Look for version conflicts
+- Review dependency tree
+- Check for known vulnerabilities in dependencies\n\n`;
+                break;
+            case 'patterns':
+                prompt += `Focus on design patterns:
+- Identify design patterns used
+- Look for anti-patterns
+- Check for code smells
+- Review naming conventions
+- Analyze code organization\n\n`;
+                break;
+        }
+    }
+    else {
+        prompt += `## Analysis Focus\nPerform a comprehensive analysis covering architecture, security, performance, and code quality.\n\n`;
+    }
+    if (params.deepThink) {
+        prompt += `## Deep Think Mode\nPerform an extra thorough analysis. Take your time to reason through complex issues. Consider edge cases and subtle problems.\n\n`;
+    }
+    prompt += `## Output Format\n`;
+    if (outputFormat === 'json') {
+        prompt += `Provide your response as valid JSON with the following structure:
+{
+  "summary": "Overall summary of the codebase",
+  "findings": [
+    {
+      "category": "security|performance|architecture|patterns|dependencies",
+      "severity": "high|medium|low",
+      "description": "Description of the finding",
+      "location": "file path and line numbers if applicable",
+      "suggestion": "Recommended fix or improvement"
+    }
+  ],
+  "visualization": "Mermaid diagram code for architecture visualization"
+}\n\n`;
+    }
+    else {
+        prompt += `Use Markdown formatting:
+- Start with an executive summary
+- Group findings by category
+- Use severity badges: 🔴 High, 🟡 Medium, 🟢 Low
+- Include code snippets for examples
+- Add a Mermaid diagram for architecture visualization\n\n`;
+    }
+    prompt += `## Files to Analyze\n\n`;
+    // Add all file contents (params.files is guaranteed to have value before this call)
+    for (const file of params.files) {
+        const language = detectLanguage(file.path);
+        prompt += `### ${file.path} (${language})\n`;
+        prompt += `\`\`\`${language.toLowerCase().split(' ')[0]}\n`;
+        prompt += file.content;
+        prompt += `\n\`\`\`\n\n`;
+    }
+    return prompt;
+}
+/**
+ * Convert FileContent array to internal file format
+ */
+function convertFileContents(fileContents) {
+    return fileContents.map(fc => ({
+        path: fc.path,
+        content: fc.content
+    }));
+}
+/**
+ * Handle gemini_analyze_codebase tool call
+ *
+ * Supports three input methods (priority: directory > filePaths > files):
+ * 1. directory: Pass directory path, automatically read files in directory
+ * 2. filePaths: Pass file path list, automatically read these files
+ * 3. files: Pass file content array directly (backward compatible)
+ */
+export async function handleAnalyzeCodebase(params, client) {
+    try {
+        // ===== 1. Parameter validation =====
+        const hasDirectory = !!params.directory;
+        const hasFilePaths = params.filePaths && params.filePaths.length > 0;
+        const hasFiles = params.files && params.files.length > 0;
+        // Validate at least one input method is provided
+        if (!hasDirectory && !hasFilePaths && !hasFiles) {
+            throw new Error('One of directory, filePaths, or files parameter is required. ' +
+                'Use directory to pass a directory path, filePaths to pass a file path list, or files to pass a file content array.');
+        }
+        // Validate optional enum parameters
+        const validFocusAreas = ['architecture', 'security', 'performance', 'dependencies', 'patterns'];
+        const validFormats = ['markdown', 'json'];
+        if (params.focus && !validFocusAreas.includes(params.focus)) {
+            throw new Error(`Invalid focus: ${params.focus}. Must be one of: ${validFocusAreas.join(', ')}`);
+        }
+        if (params.outputFormat && !validFormats.includes(params.outputFormat)) {
+            throw new Error(`Invalid outputFormat: ${params.outputFormat}. Must be one of: ${validFormats.join(', ')}`);
+        }
+        // ===== 2. Get file contents =====
+        let filesToAnalyze;
+        if (hasDirectory) {
+            // Method 1: Read files from directory
+            console.log(`[analyze_codebase] Reading directory: ${params.directory}`);
+            try {
+                const fileContents = await readDirectory(params.directory, {
+                    include: params.include,
+                    exclude: params.exclude
+                });
+                if (fileContents.length === 0) {
+                    throw new Error(`No matching files found in directory "${params.directory}".` +
+                        (params.include ? ` Include patterns: ${params.include.join(', ')}` : '') +
+                        (params.exclude ? ` Exclude patterns: ${params.exclude.join(', ')}` : ''));
+                }
+                filesToAnalyze = convertFileContents(fileContents);
+                console.log(`[analyze_codebase] Successfully read ${filesToAnalyze.length} files`);
+            }
+            catch (error) {
+                // Handle security errors
+                if (error instanceof SecurityError) {
+                    throw new Error(`Security validation failed: ${error.message}`);
+                }
+                throw error;
+            }
+        }
+        else if (hasFilePaths) {
+            // Method 2: Read from file path list
+            console.log(`[analyze_codebase] Reading ${params.filePaths.length} files`);
+            try {
+                const fileContents = await readFiles(params.filePaths);
+                if (fileContents.length === 0) {
+                    throw new Error('All specified files could not be read. Please check if file paths are correct.');
+                }
+                filesToAnalyze = convertFileContents(fileContents);
+                console.log(`[analyze_codebase] Successfully read ${filesToAnalyze.length} files`);
+            }
+            catch (error) {
+                if (error instanceof SecurityError) {
+                    throw new Error(`Security validation failed: ${error.message}`);
+                }
+                throw error;
+            }
+        }
+        else {
+            // Method 3: Use files parameter directly (backward compatible)
+            validateRequired(params.files, 'files');
+            validateArray(params.files, 'files', 1);
+            // Validate each file has path and content
+            for (let i = 0; i < params.files.length; i++) {
+                const file = params.files[i];
+                if (!file.path || typeof file.path !== 'string') {
+                    throw new Error(`File at index ${i} is missing required 'path' property`);
+                }
+                if (!file.content || typeof file.content !== 'string') {
+                    throw new Error(`File at index ${i} is missing required 'content' property`);
+                }
+            }
+            filesToAnalyze = params.files;
+        }
+        // ===== 3. Set defaults and calculate metrics =====
+        const outputFormat = params.outputFormat || 'markdown';
+        const deepThink = params.deepThink || false;
+        // Calculate codebase metrics
+        const languages = new Set();
+        let totalLines = 0;
+        for (const file of filesToAnalyze) {
+            languages.add(detectLanguage(file.path));
+            totalLines += file.content.split('\n').length;
+        }
+        const metrics = {
+            totalFiles: filesToAnalyze.length,
+            totalLines,
+            languages: Array.from(languages).filter(l => l !== 'Unknown')
+        };
+        // ===== 4. Build prompt and call API =====
+        // Create temporary params object for building prompt
+        const promptParams = {
+            ...params,
+            files: filesToAnalyze
+        };
+        const prompt = buildCodebasePrompt(promptParams, metrics, outputFormat);
+        // Determine thinking level (default high for complex analysis)
+        const thinkingLevel = params.thinkingLevel || 'high';
+        let response;
+        // Always use thinking mode with direct GoogleGenAI call
+        const apiKey = process.env.GEMINI_API_KEY;
+        if (!apiKey) {
+            throw new Error('GEMINI_API_KEY environment variable is not set');
+        }
+        const ai = new GoogleGenAI({ apiKey });
+        const config = {
+            thinkingConfig: { thinkingLevel },
+            systemInstruction: CODEBASE_ANALYSIS_SYSTEM_PROMPT,
+        };
+        const contents = [{
+                role: 'user',
+                parts: [{ text: prompt }]
+            }];
+        const apiResult = await ai.models.generateContent({
+            model: 'gemini-3-pro-preview',
+            config,
+            contents,
+        });
+        response = apiResult.text || '';
+        // ===== 5. Build return result =====
+        const result = {
+            summary: '',
+            findings: [],
+            metrics,
+            analysisDepth: deepThink ? 'deep' : 'standard'
+        };
+        // Parse response
+        if (outputFormat === 'json') {
+            try {
+                // Extract JSON content
+                let jsonContent = response;
+                const jsonMatch = response.match(/```(?:json)?\s*([\s\S]*?)```/);
+                if (jsonMatch) {
+                    jsonContent = jsonMatch[1].trim();
+                }
+                const parsed = JSON.parse(jsonContent);
+                result.summary = parsed.summary || response;
+                result.findings = parsed.findings || [];
+                if (parsed.visualization) {
+                    result.visualization = parsed.visualization;
+                }
+            }
+            catch {
+                // JSON parsing failed, use raw response
+                result.summary = response;
+            }
+        }
+        else {
+            result.summary = response;
+            // Try to extract Mermaid diagram
+            const mermaidMatch = response.match(/```mermaid\s*([\s\S]*?)```/);
+            if (mermaidMatch) {
+                result.visualization = mermaidMatch[1].trim();
+            }
+        }
+        return result;
+    }
+    catch (error) {
+        logError('analyzeCodebase', error);
+        throw handleAPIError(error);
+    }
+}
+//# sourceMappingURL=analyze-codebase.js.map

package/dist/tools/analyze-codebase.js.map

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

package/dist/tools/analyze-content.js

@@ -0,0 +1,295 @@
+/**
+ * Tool 5: gemini_analyze_content
+ * General content analysis tool - Analyze code snippets, documents, data
+ * Priority: P1 - Phase 3
+ *
+ * Upgrade notes (v1.1):
+ * - Added filePath parameter: Support direct file path input, tool automatically reads content
+ * - Retained content parameter: Backward compatible with original calling method
+ */
+import { validateRequired, validateString, validateArray } from '../utils/validators.js';
+import { handleAPIError, logError } from '../utils/error-handler.js';
+import { readFile } from '../utils/file-reader.js';
+import { SecurityError } from '../utils/security.js';
+// Content analysis system prompt
+const ANALYZE_CONTENT_SYSTEM_PROMPT = `You are a versatile code and document analyst with expertise in:
+- Code quality analysis (any programming language)
+- Document summarization and understanding
+- Data structure analysis and optimization
+- Technical writing review
+
+Analysis approach:
+1. Auto-detect content type (code, document, data)
+2. Understand the context and purpose
+3. Perform requested task:
+   - Summarize: Create concise summary with key points
+   - Review: Analyze quality, find issues, suggest improvements
+   - Explain: Break down complex content into understandable parts
+   - Optimize: Suggest performance and efficiency improvements
+   - Debug: Identify potential bugs and logic errors
+
+Output requirements:
+- Be clear and actionable
+- Prioritize findings by importance
+- Provide specific examples
+- Use appropriate technical terminology
+- Format output for readability
+
+When analyzing code:
+- Identify the language automatically
+- Check for common patterns and anti-patterns
+- Suggest best practices
+- Highlight security concerns
+
+When analyzing documents:
+- Extract main themes and ideas
+- Identify structure and organization
+- Suggest improvements for clarity
+- Highlight important points
+
+When analyzing data:
+- Understand the structure
+- Identify patterns and anomalies
+- Suggest optimizations
+- Explain relationships`;
+/**
+ * Auto-detect content type
+ */
+function detectContentType(content, language) {
+    // If programming language is specified, consider it as code
+    if (language) {
+        return 'code';
+    }
+    const trimmedContent = content.trim();
+    // Check if it's JSON/data
+    if (trimmedContent.startsWith('{') || trimmedContent.startsWith('[')) {
+        try {
+            JSON.parse(trimmedContent);
+            return 'data';
+        }
+        catch {
+            // Not valid JSON, continue checking
+        }
+    }
+    // Check XML/HTML data
+    if (trimmedContent.startsWith('<?xml') || trimmedContent.match(/^<\w+[^>]*>/)) {
+        // If it looks like a complete HTML page, it might be code
+        if (trimmedContent.includes('<!DOCTYPE html>') || trimmedContent.includes('<script')) {
+            return 'code';
+        }
+        return 'data';
+    }
+    // Check code characteristics
+    const codePatterns = [
+        /function\s+\w+\s*\(/, // JavaScript/TypeScript function
+        /const\s+\w+\s*=/, // const declaration
+        /let\s+\w+\s*=/, // let declaration
+        /var\s+\w+\s*=/, // var declaration
+        /class\s+\w+/, // class declaration
+        /import\s+.*from\s+['"`]/, // ES6 import
+        /export\s+(default\s+)?/, // ES6 export
+        /def\s+\w+\s*\(/, // Python function
+        /class\s+\w+\s*:/, // Python class
+        /public\s+(static\s+)?class/, // Java/C# class
+        /private\s+\w+/, // Java/C# private
+        /<\?php/, // PHP
+        /package\s+\w+/, // Go/Java package
+        /func\s+\w+\s*\(/, // Go function
+        /fn\s+\w+\s*\(/, // Rust function
+        /#include\s*<\w+>/, // C/C++ include
+        /using\s+namespace/, // C++ using
+        /impl\s+\w+/, // Rust impl
+        /struct\s+\w+\s*\{/, // Rust/Go/C struct
+        /interface\s+\w+\s*\{/, // TypeScript/Go interface
+        /=>\s*\{/, // Arrow function
+        /async\s+function/, // Async function
+        /await\s+\w+/, // Await expression
+    ];
+    if (codePatterns.some(pattern => pattern.test(content))) {
+        return 'code';
+    }
+    // Check if it contains a lot of code-related symbols
+    const codeSymbols = (content.match(/[{}\[\]();=><]/g) || []).length;
+    const totalChars = content.length;
+    if (codeSymbols / totalChars > 0.05) {
+        return 'code';
+    }
+    // Default to document
+    return 'document';
+}
+/**
+ * Build analysis prompt
+ * @param params Parameter object
+ * @param detectedType Detected content type
+ * @param task Analysis task
+ * @param outputFormat Output format
+ * @param contentToAnalyze Content to analyze (provided by caller, read from file or directly passed in)
+ */
+function buildAnalysisPrompt(params, detectedType, task, outputFormat, contentToAnalyze) {
+    let prompt = `# Content Analysis Task\n\n`;
+    prompt += `## Content Type\n${detectedType}\n\n`;
+    if (params.language) {
+        prompt += `## Programming Language\n${params.language}\n\n`;
+    }
+    prompt += `## Analysis Task\n`;
+    switch (task) {
+        case 'summarize':
+            prompt += `Create a concise summary of the content, highlighting key points and main ideas.\n\n`;
+            break;
+        case 'review':
+            prompt += `Perform a thorough review. Identify issues, suggest improvements, and evaluate quality.\n\n`;
+            break;
+        case 'explain':
+            prompt += `Explain the content in detail. Break down complex parts into understandable segments.\n\n`;
+            break;
+        case 'optimize':
+            prompt += `Analyze for optimization opportunities. Focus on performance, efficiency, and best practices.\n\n`;
+            break;
+        case 'debug':
+            prompt += `Identify potential bugs, logic errors, and issues. Suggest fixes for each problem found.\n\n`;
+            break;
+    }
+    if (params.focus && params.focus.length > 0) {
+        prompt += `## Focus Areas\n`;
+        params.focus.forEach(area => {
+            prompt += `- ${area}\n`;
+        });
+        prompt += '\n';
+    }
+    prompt += `## Output Format\n`;
+    if (outputFormat === 'json') {
+        prompt += `Provide your response as valid JSON with the following structure:
+{
+  "summary": "Brief summary",
+  "analysis": "Detailed analysis",
+  "issues": [{"severity": "high|medium|low", "description": "...", "location": "..."}],
+  "suggestions": ["suggestion1", "suggestion2"]
+}\n\n`;
+    }
+    else if (outputFormat === 'markdown') {
+        prompt += `Use Markdown formatting for better readability. Include headers, lists, and code blocks where appropriate.\n\n`;
+    }
+    else {
+        prompt += `Provide plain text output.\n\n`;
+    }
+    prompt += `## Content to Analyze\n\`\`\`\n${contentToAnalyze}\n\`\`\``;
+    return prompt;
+}
+/**
+ * Handle gemini_analyze_content tool call
+ *
+ * Supports two input methods (priority: filePath > content):
+ * 1. filePath: Pass file path, automatically read file content
+ * 2. content: Direct content input (backward compatible)
+ */
+export async function handleAnalyzeContent(params, client) {
+    try {
+        // ===== 1. Parameter validation =====
+        const hasFilePath = !!params.filePath;
+        const hasContent = !!params.content;
+        // Validate that at least one input method is provided
+        if (!hasFilePath && !hasContent) {
+            throw new Error('One of filePath or content parameter is required. ' +
+                'Please use filePath to pass a file path, or use content to pass content directly.');
+        }
+        // Validate optional enum parameters
+        const validTypes = ['code', 'document', 'data', 'auto'];
+        const validTasks = ['summarize', 'review', 'explain', 'optimize', 'debug'];
+        const validFormats = ['text', 'json', 'markdown'];
+        if (params.type && !validTypes.includes(params.type)) {
+            throw new Error(`Invalid type: ${params.type}. Must be one of: ${validTypes.join(', ')}`);
+        }
+        if (params.task && !validTasks.includes(params.task)) {
+            throw new Error(`Invalid task: ${params.task}. Must be one of: ${validTasks.join(', ')}`);
+        }
+        if (params.outputFormat && !validFormats.includes(params.outputFormat)) {
+            throw new Error(`Invalid outputFormat: ${params.outputFormat}. Must be one of: ${validFormats.join(', ')}`);
+        }
+        if (params.focus) {
+            validateArray(params.focus, 'focus', 1);
+        }
+        // ===== 2. Get content =====
+        let contentToAnalyze;
+        let detectedLanguage = params.language;
+        if (hasFilePath) {
+            // Method 1: Read content from file
+            console.log(`[analyze_content] Reading file: ${params.filePath}`);
+            try {
+                const fileContent = await readFile(params.filePath);
+                contentToAnalyze = fileContent.content;
+                // If no language specified, use detected language
+                if (!detectedLanguage && fileContent.language) {
+                    detectedLanguage = fileContent.language;
+                }
+                console.log(`[analyze_content] Successfully read file, size: ${fileContent.size} bytes`);
+            }
+            catch (error) {
+                if (error instanceof SecurityError) {
+                    throw new Error(`Security validation failed: ${error.message}`);
+                }
+                throw error;
+            }
+        }
+        else {
+            // Method 2: Direct use of content parameter (backward compatible)
+            validateRequired(params.content, 'content');
+            validateString(params.content, 'content', 10);
+            contentToAnalyze = params.content;
+        }
+        // ===== 3. Set defaults and detect type =====
+        const type = params.type || 'auto';
+        const task = params.task || 'summarize';
+        const outputFormat = params.outputFormat || 'markdown';
+        // Auto-detect content type
+        const detectedType = type === 'auto'
+            ? detectContentType(contentToAnalyze, detectedLanguage)
+            : type;
+        // ===== 4. Build prompt =====
+        // Create temporary parameter object for building prompt
+        const promptParams = {
+            ...params,
+            content: contentToAnalyze,
+            language: detectedLanguage
+        };
+        const prompt = buildAnalysisPrompt(promptParams, detectedType, task, outputFormat, contentToAnalyze);
+        // Call Gemini API (using default model gemini-3-pro-preview)
+        const response = await client.generate(prompt, {
+            systemInstruction: ANALYZE_CONTENT_SYSTEM_PROMPT,
+            temperature: 0.5,
+            maxTokens: 8192
+        });
+        // Build return result
+        const result = {
+            analysis: response,
+            contentType: detectedType,
+            task: task
+        };
+        // If JSON format, try to parse and extract structured data
+        if (outputFormat === 'json') {
+            try {
+                // Extract JSON content (may be wrapped in markdown code block)
+                let jsonContent = response;
+                const jsonMatch = response.match(/```(?:json)?\s*([\s\S]*?)```/);
+                if (jsonMatch) {
+                    jsonContent = jsonMatch[1].trim();
+                }
+                const parsed = JSON.parse(jsonContent);
+                if (parsed.summary)
+                    result.summary = parsed.summary;
+                if (parsed.suggestions)
+                    result.suggestions = parsed.suggestions;
+                if (parsed.issues)
+                    result.issues = parsed.issues;
+            }
+            catch {
+                // JSON parsing failed, keep original response
+            }
+        }
+        return result;
+    }
+    catch (error) {
+        logError('analyzeContent', error);
+        throw handleAPIError(error);
+    }
+}
+//# sourceMappingURL=analyze-content.js.map