noverload-mcp 0.6.0 → 0.7.0

package/dist/tools/implementations/expand-search.js

@@ -0,0 +1,223 @@
+import { z } from "zod";
+const inputSchema = z.object({
+    originalQuery: z.string().describe("The original search query that returned few/no results"),
+    noResultsFound: z.boolean().optional().default(false).describe("Whether the original search returned no results"),
+    context: z.string().optional().describe("Additional context about what the user is looking for"),
+    limit: z.number().optional().default(5).describe("Maximum number of expanded queries to return"),
+});
+// Concept mapping for semantic expansion
+const CONCEPT_MAP = {
+    // Business & Growth
+    "storytelling": ["narrative", "pitch", "story", "presentation", "messaging", "communication", "branding"],
+    "growth": ["scaling", "expansion", "increase", "development", "progress", "evolution", "traction"],
+    "marketing": ["promotion", "advertising", "branding", "outreach", "campaign", "content", "social media"],
+    "sales": ["selling", "revenue", "conversion", "closing", "pipeline", "deals", "customers"],
+    "startup": ["founder", "entrepreneur", "venture", "bootstrap", "launch", "MVP", "product-market fit"],
+    // Technology
+    "ai": ["artificial intelligence", "machine learning", "ML", "deep learning", "neural network", "LLM", "GPT"],
+    "framework": ["methodology", "system", "process", "structure", "approach", "model", "pattern"],
+    "api": ["interface", "endpoint", "integration", "webhook", "REST", "GraphQL", "service"],
+    "database": ["DB", "SQL", "NoSQL", "data storage", "postgres", "mongodb", "schema"],
+    // Content & Learning
+    "tutorial": ["guide", "how-to", "walkthrough", "instruction", "lesson", "course", "training"],
+    "example": ["case study", "instance", "sample", "demonstration", "illustration", "use case", "scenario"],
+    "best practices": ["guidelines", "standards", "recommendations", "tips", "advice", "patterns", "conventions"],
+    // Strategy & Planning
+    "strategy": ["plan", "approach", "tactics", "roadmap", "blueprint", "methodology", "framework"],
+    "metrics": ["KPIs", "analytics", "measurements", "data", "statistics", "tracking", "performance"],
+    "optimization": ["improvement", "enhancement", "efficiency", "performance", "refinement", "tuning"],
+    // Product & Development
+    "feature": ["functionality", "capability", "component", "module", "tool", "service", "option"],
+    "bug": ["issue", "problem", "error", "defect", "glitch", "fault", "failure"],
+    "design": ["UX", "UI", "interface", "layout", "architecture", "structure", "pattern"],
+};
+// Reverse mapping for bidirectional expansion
+const REVERSE_MAP = new Map();
+for (const [key, values] of Object.entries(CONCEPT_MAP)) {
+    for (const value of values) {
+        if (!REVERSE_MAP.has(value)) {
+            REVERSE_MAP.set(value, []);
+        }
+        REVERSE_MAP.get(value).push(key);
+    }
+}
+function expandConcepts(query) {
+    const queryLower = query.toLowerCase();
+    const words = queryLower.split(/\s+/);
+    const expandedTerms = new Set();
+    // For each word in the query
+    for (const word of words) {
+        // Check direct mappings
+        if (CONCEPT_MAP[word]) {
+            CONCEPT_MAP[word].forEach(term => expandedTerms.add(term));
+        }
+        // Check reverse mappings
+        if (REVERSE_MAP.has(word)) {
+            REVERSE_MAP.get(word).forEach(term => expandedTerms.add(term));
+        }
+        // Check if word is part of any concept
+        for (const [concept, related] of Object.entries(CONCEPT_MAP)) {
+            if (concept.includes(word) || word.includes(concept)) {
+                related.forEach(term => expandedTerms.add(term));
+            }
+            for (const rel of related) {
+                if (rel.includes(word) || word.includes(rel)) {
+                    expandedTerms.add(concept);
+                    related.forEach(term => expandedTerms.add(term));
+                }
+            }
+        }
+    }
+    // Remove original words and return unique expansions
+    words.forEach(w => expandedTerms.delete(w));
+    return Array.from(expandedTerms);
+}
+function generateRelatedQueries(originalQuery, expansions) {
+    const queries = [];
+    const words = originalQuery.toLowerCase().split(/\s+/);
+    // Replace each word with its expansions
+    for (let i = 0; i < words.length; i++) {
+        for (const expansion of expansions.slice(0, 3)) { // Limit to top 3 expansions per word
+            const newWords = [...words];
+            newWords[i] = expansion;
+            queries.push(newWords.join(' '));
+        }
+    }
+    // Add queries with appended expansions
+    for (const expansion of expansions.slice(0, 3)) {
+        queries.push(`${originalQuery} ${expansion}`);
+        queries.push(`${expansion} ${originalQuery}`);
+    }
+    // Remove duplicates and original
+    return [...new Set(queries)].filter(q => q.toLowerCase() !== originalQuery.toLowerCase());
+}
+export const expandSearchTool = {
+    name: "noverload_expand_search",
+    description: "Intelligently expand search queries to find related content when original searches return few results. Uses concept mapping and semantic expansion.",
+    inputSchema: inputSchema.strict(),
+    modifies: false,
+    handler: async (client, args) => {
+        const input = inputSchema.parse(args);
+        try {
+            // Step 1: Expand concepts from the original query
+            const conceptExpansions = expandConcepts(input.originalQuery);
+            // Step 2: Generate related queries
+            const expandedQueries = generateRelatedQueries(input.originalQuery, conceptExpansions);
+            // Step 3: Determine search strategies based on context
+            const strategies = [];
+            if (input.noResultsFound) {
+                strategies.push("Try broader terms");
+                strategies.push("Check for typos or alternative spellings");
+                strategies.push("Use category searches instead of specific terms");
+            }
+            else {
+                strategies.push("Add more specific terms");
+                strategies.push("Try related concepts");
+                strategies.push("Search by content type");
+            }
+            // Step 4: Generate smart suggestions
+            const suggestions = [];
+            // Add top expanded queries with rationale
+            for (const query of expandedQueries.slice(0, input.limit)) {
+                // Determine why this expansion might help
+                let rationale = "Related concept that might have relevant content";
+                let confidence = "medium";
+                // Check if this expansion is a direct concept mapping
+                const queryWords = query.toLowerCase().split(/\s+/);
+                for (const word of queryWords) {
+                    if (CONCEPT_MAP[word]) {
+                        rationale = `Expands to related ${word} concepts`;
+                        confidence = "high";
+                        break;
+                    }
+                }
+                suggestions.push({ query, rationale, confidence });
+            }
+            // Step 5: Try to understand intent and add specific suggestions
+            const queryLower = input.originalQuery.toLowerCase();
+            if (queryLower.includes("how") || queryLower.includes("guide") || queryLower.includes("tutorial")) {
+                suggestions.push({
+                    query: `${input.originalQuery} step by step`,
+                    rationale: "Looking for instructional content",
+                    confidence: "high"
+                });
+            }
+            if (queryLower.includes("example") || queryLower.includes("case")) {
+                suggestions.push({
+                    query: `${input.originalQuery} case study success story`,
+                    rationale: "Looking for real-world examples",
+                    confidence: "high"
+                });
+            }
+            if (queryLower.includes("best") || queryLower.includes("top")) {
+                suggestions.push({
+                    query: `${input.originalQuery} recommendations tips`,
+                    rationale: "Looking for curated advice",
+                    confidence: "medium"
+                });
+            }
+            // Format response
+            let responseText = `🔍 **Search Expansion for: "${input.originalQuery}"**\n\n`;
+            if (input.noResultsFound) {
+                responseText += `⚠️ Original search returned no results. Here are alternative searches:\n\n`;
+            }
+            else {
+                responseText += `💡 Expanding your search to find more relevant content:\n\n`;
+            }
+            // Add expanded concepts
+            if (conceptExpansions.length > 0) {
+                responseText += `**Related Concepts Found:**\n`;
+                responseText += `${conceptExpansions.slice(0, 10).join(', ')}\n\n`;
+            }
+            // Add suggested queries
+            responseText += `**Suggested Searches:**\n\n`;
+            for (const suggestion of suggestions.slice(0, input.limit)) {
+                const icon = suggestion.confidence === "high" ? "🎯" :
+                    suggestion.confidence === "medium" ? "🔹" : "◽";
+                responseText += `${icon} **"${suggestion.query}"**\n`;
+                responseText += `   *${suggestion.rationale}*\n\n`;
+            }
+            // Add search strategies
+            responseText += `**Search Strategies:**\n`;
+            for (const strategy of strategies) {
+                responseText += `- ${strategy}\n`;
+            }
+            // Add tips
+            responseText += `\n**💡 Pro Tips:**\n`;
+            responseText += `- Use quotes for exact phrases: "${input.originalQuery}"\n`;
+            responseText += `- Try content type filters: YouTube, Articles, Reddit\n`;
+            responseText += `- Search by tags or categories instead of keywords\n`;
+            if (input.context) {
+                responseText += `\n**Context considered:** ${input.context}\n`;
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: responseText
+                    }
+                ],
+                data: {
+                    originalQuery: input.originalQuery,
+                    expandedConcepts: conceptExpansions,
+                    suggestedQueries: suggestions,
+                    totalExpansions: expandedQueries.length,
+                    strategies: strategies
+                }
+            };
+        }
+        catch (error) {
+            console.error("Search expansion error:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ Error expanding search: ${error instanceof Error ? error.message : 'Unknown error'}`
+                    }
+                ],
+                error: true
+            };
+        }
+    }
+};
+//# sourceMappingURL=expand-search.js.map

package/dist/tools/implementations/expand-search.js.map

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

package/dist/tools/implementations/explore-topic.d.ts

@@ -0,0 +1,3 @@
+import { Tool } from "../types.js";
+export declare const exploreTopicTool: Tool;
+//# sourceMappingURL=explore-topic.d.ts.map

package/dist/tools/implementations/explore-topic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore-topic.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/explore-topic.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC,eAAO,MAAM,gBAAgB,EAAE,IA6I9B,CAAC"}

package/dist/tools/implementations/explore-topic.js

@@ -0,0 +1,137 @@
+import { z } from "zod";
+export const exploreTopicTool = {
+    name: "explore_topic",
+    description: "Deep exploration of a topic across all saved content. Provides comprehensive understanding with multiple perspectives, evolution over time, and key concepts.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            topic: {
+                type: "string",
+                description: "The topic to explore comprehensively",
+            },
+            depth: {
+                type: "string",
+                enum: ["surface", "comprehensive", "expert"],
+                description: "Depth of exploration",
+                default: "comprehensive",
+            },
+            includeTimeline: {
+                type: "boolean",
+                description: "Include chronological evolution of the topic",
+                default: true,
+            },
+            includeConnections: {
+                type: "boolean",
+                description: "Find connections to related topics",
+                default: true,
+            },
+            maxSources: {
+                type: "number",
+                description: "Maximum number of sources to analyze",
+                default: 20,
+            },
+        },
+        required: ["topic"],
+    },
+    modifies: false,
+    handler: async (client, args) => {
+        const schema = z.object({
+            topic: z.string(),
+            depth: z.enum(["surface", "comprehensive", "expert"]).optional().default("comprehensive"),
+            includeTimeline: z.boolean().optional().default(true),
+            includeConnections: z.boolean().optional().default(true),
+            maxSources: z.number().optional().default(20),
+        });
+        const params = schema.parse(args);
+        // Search for all content related to the topic
+        const searchResults = await client.searchContent(params.topic, {
+            limit: params.maxSources,
+            enableConceptExpansion: true,
+            fuzzyMatch: true,
+        });
+        if (!searchResults || searchResults.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No content found for topic: "${params.topic}". Try saving relevant content first or use a different search term.`,
+                    },
+                ],
+                data: null,
+            };
+        }
+        // Synthesize the content for deep understanding
+        const synthesis = await client.synthesizeContent({
+            query: `Comprehensive exploration of ${params.topic}`,
+            contentIds: searchResults.slice(0, params.maxSources).map((r) => r.id),
+            synthesisMode: params.depth === "expert" ? "deep" : params.depth === "surface" ? "overview" : "actionable",
+            findConnections: params.includeConnections,
+            findContradictions: true,
+        });
+        let responseText = `# 🔍 Topic Exploration: "${params.topic}"\n`;
+        responseText += `**Depth:** ${params.depth} | **Sources Analyzed:** ${searchResults.length}\n\n`;
+        // Overview Section
+        responseText += `## 📋 Overview\n`;
+        if (synthesis.synthesis?.summary) {
+            responseText += `${synthesis.synthesis.summary}\n\n`;
+        }
+        else {
+            responseText += `Analysis of ${searchResults.length} pieces of content about ${params.topic}.\n\n`;
+        }
+        // Key Insights
+        if (synthesis.synthesis?.insights && synthesis.synthesis.insights.length > 0) {
+            responseText += `## 💡 Key Insights\n`;
+            synthesis.synthesis.insights.slice(0, 10).forEach((insight, idx) => {
+                const text = typeof insight === 'string' ? insight : insight.text;
+                responseText += `${idx + 1}. ${text}\n`;
+            });
+            responseText += `\n`;
+        }
+        // Connections (if found)
+        if (params.includeConnections && synthesis.synthesis?.connections) {
+            responseText += `## 🔗 Related Topics & Connections\n`;
+            synthesis.synthesis.connections.slice(0, 8).forEach((conn) => {
+                if (typeof conn === 'string') {
+                    responseText += `- ${conn}\n`;
+                }
+                else if (conn.concept) {
+                    responseText += `- **${conn.concept}**`;
+                    if (conn.strength) {
+                        responseText += ` (strength: ${conn.strength})`;
+                    }
+                    responseText += `\n`;
+                }
+            });
+            responseText += `\n`;
+        }
+        // Sources
+        responseText += `## 📚 Top Sources\n`;
+        searchResults.slice(0, 5).forEach((source, idx) => {
+            const typeIcons = {
+                youtube: "📺",
+                x_twitter: "𝕏",
+                reddit: "🔗",
+                article: "📄",
+                pdf: "📑"
+            };
+            const icon = typeIcons[source.contentType] || "📄";
+            responseText += `${idx + 1}. ${icon} [${source.title || "Untitled"}](${source.url})\n`;
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: responseText,
+                },
+            ],
+            data: {
+                topic: params.topic,
+                depth: params.depth,
+                sourcesAnalyzed: searchResults.length,
+                synthesis: synthesis.synthesis,
+                sources: searchResults,
+            },
+        };
+    },
+};
+//# sourceMappingURL=explore-topic.js.map

package/dist/tools/implementations/explore-topic.js.map

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

package/dist/tools/implementations/extract-frameworks.d.ts

@@ -0,0 +1,3 @@
+import { Tool } from "../types.js";
+export declare const extractFrameworksTool: Tool;
+//# sourceMappingURL=extract-frameworks.d.ts.map

package/dist/tools/implementations/extract-frameworks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-frameworks.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/extract-frameworks.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AA0CnC,eAAO,MAAM,qBAAqB,EAAE,IA+MnC,CAAC"}

package/dist/tools/implementations/extract-frameworks.js

@@ -0,0 +1,192 @@
+import { z } from "zod";
+const inputSchema = z.object({
+    query: z.string().optional().describe("Optional: specific framework type to find"),
+    contentTypes: z.array(z.enum(["youtube", "x_twitter", "reddit", "article", "pdf"]))
+        .optional()
+        .describe("Filter by content types"),
+    minConfidence: z.number().min(0).max(1).optional().default(0.7)
+        .describe("Minimum confidence score for frameworks (0-1)"),
+    limit: z.number().optional().default(20)
+        .describe("Maximum number of frameworks to return"),
+});
+export const extractFrameworksTool = {
+    name: "noverload_extract_frameworks",
+    description: "Extract methodologies, frameworks, and step-by-step processes from your saved content. Finds structured approaches, patterns, and repeatable techniques.",
+    inputSchema: inputSchema.strict(),
+    modifies: false,
+    handler: async (client, args) => {
+        const input = inputSchema.parse(args);
+        try {
+            // First, get content that might contain frameworks
+            const searchQuery = input.query || "framework methodology process steps guide how to tutorial";
+            // Search for relevant content
+            const searchResults = await client.searchContentV2({
+                query: searchQuery,
+                mode: "any",
+                limit: 30, // Get more results to find frameworks
+                contentTypes: input.contentTypes,
+            });
+            if (!searchResults.results || searchResults.results.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "🔍 No content found that might contain frameworks. Try saving content about methodologies, tutorials, or how-to guides first."
+                        }
+                    ],
+                    data: {
+                        frameworks: [],
+                        totalFound: 0,
+                        searchQuery: searchQuery
+                    }
+                };
+            }
+            // Collect all frameworks from content with ai_insights
+            const allFrameworks = [];
+            const contentWithFrameworks = [];
+            for (const result of searchResults.results) {
+                // Check if this content has ai_insights with frameworks
+                if (result.aiInsights?.frameworks) {
+                    const frameworks = result.aiInsights.frameworks;
+                    for (const fw of frameworks) {
+                        if (fw.confidence >= input.minConfidence) {
+                            allFrameworks.push({
+                                ...fw,
+                                sourceContent: {
+                                    id: result.id,
+                                    title: result.title || "Untitled",
+                                    url: result.url,
+                                    type: result.contentType
+                                }
+                            });
+                        }
+                    }
+                    if (frameworks.length > 0) {
+                        contentWithFrameworks.push(result.id);
+                    }
+                }
+            }
+            // If no frameworks found in ai_insights, trigger extraction for top results
+            if (allFrameworks.length === 0) {
+                // Extract frameworks from top 5 most relevant results
+                const topResults = searchResults.results.slice(0, 5);
+                let extractionMessage = "🔄 No pre-extracted frameworks found. Analyzing content for frameworks...\n\n";
+                for (const content of topResults) {
+                    if (!content.rawText && !content.summary) {
+                        continue;
+                    }
+                    // Note: In production, this would call the extract-frameworks Edge Function
+                    // For now, we'll indicate that extraction is needed
+                    extractionMessage += `📝 ${content.title} - Needs framework extraction\n`;
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: extractionMessage + "\n💡 Tip: Content processing will extract frameworks automatically. Try again in a few moments, or use the 'noverload_process_content' tool to trigger processing."
+                        }
+                    ],
+                    data: {
+                        frameworks: [],
+                        totalFound: 0,
+                        contentNeedingExtraction: topResults.map((r) => r.id),
+                        searchQuery: searchQuery
+                    }
+                };
+            }
+            // Sort frameworks by confidence and limit
+            allFrameworks.sort((a, b) => b.confidence - a.confidence);
+            const limitedFrameworks = allFrameworks.slice(0, input.limit);
+            // Format response
+            let responseText = `🎯 **Found ${allFrameworks.length} frameworks**\n\n`;
+            if (input.query) {
+                responseText += `Search: "${input.query}"\n`;
+            }
+            responseText += `Minimum confidence: ${input.minConfidence}\n\n`;
+            // Group frameworks by type
+            const byType = limitedFrameworks.reduce((acc, fw) => {
+                if (!acc[fw.type])
+                    acc[fw.type] = [];
+                acc[fw.type].push(fw);
+                return acc;
+            }, {});
+            for (const [type, frameworks] of Object.entries(byType)) {
+                responseText += `\n## ${type.charAt(0).toUpperCase() + type.slice(1)}s\n\n`;
+                for (const fw of frameworks) {
+                    responseText += `### 📋 ${fw.name}\n`;
+                    responseText += `*Confidence: ${(fw.confidence * 100).toFixed(0)}%*\n`;
+                    responseText += `${fw.description}\n\n`;
+                    // Add steps if available
+                    if (fw.steps && fw.steps.length > 0) {
+                        responseText += `**Steps:**\n`;
+                        for (const step of fw.steps) {
+                            responseText += `${step.order}. **${step.title}**: ${step.description}\n`;
+                            if (step.example) {
+                                responseText += `   *Example: ${step.example}*\n`;
+                            }
+                        }
+                        responseText += `\n`;
+                    }
+                    // Add components if available
+                    if (fw.components && fw.components.length > 0) {
+                        responseText += `**Components:**\n`;
+                        for (const comp of fw.components) {
+                            const importance = comp.importance === 'critical' ? '🔴' :
+                                comp.importance === 'important' ? '🟡' : '⚪';
+                            responseText += `- ${importance} **${comp.name}**: ${comp.description}\n`;
+                        }
+                        responseText += `\n`;
+                    }
+                    // Add use cases
+                    if (fw.useCases && fw.useCases.length > 0) {
+                        responseText += `**Use Cases:** ${fw.useCases.join(', ')}\n`;
+                    }
+                    // Add source
+                    if (fw.sourceContent) {
+                        const icon = fw.sourceContent.type === 'youtube' ? '📺' :
+                            fw.sourceContent.type === 'x_twitter' ? '𝕏' :
+                                fw.sourceContent.type === 'reddit' ? '🟠' :
+                                    fw.sourceContent.type === 'pdf' ? '📄' : '📖';
+                        responseText += `*Source: ${icon} [${fw.sourceContent.title}](${fw.sourceContent.url})*\n\n`;
+                    }
+                }
+            }
+            // Add summary statistics
+            responseText += `\n---\n📊 **Summary:**\n`;
+            responseText += `- Total frameworks found: ${allFrameworks.length}\n`;
+            responseText += `- High confidence (>90%): ${allFrameworks.filter(f => f.confidence > 0.9).length}\n`;
+            responseText += `- Content sources analyzed: ${contentWithFrameworks.length}\n`;
+            if (allFrameworks.length > input.limit) {
+                responseText += `\n*Showing top ${input.limit} frameworks. Increase limit to see more.*`;
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: responseText
+                    }
+                ],
+                data: {
+                    frameworks: limitedFrameworks,
+                    totalFound: allFrameworks.length,
+                    byType: Object.fromEntries(Object.entries(byType).map(([type, fws]) => [type, fws.length])),
+                    contentSources: contentWithFrameworks,
+                    searchQuery: searchQuery
+                }
+            };
+        }
+        catch (error) {
+            console.error("Framework extraction error:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ Error extracting frameworks: ${error instanceof Error ? error.message : 'Unknown error'}`
+                    }
+                ],
+                error: true
+            };
+        }
+    }
+};
+//# sourceMappingURL=extract-frameworks.js.map

package/dist/tools/implementations/extract-frameworks.js.map

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

package/dist/tools/implementations/extract-insights.d.ts

@@ -0,0 +1,3 @@
+import { Tool } from "../types.js";
+export declare const extractInsightsTool: Tool;
+//# sourceMappingURL=extract-insights.d.ts.map

package/dist/tools/implementations/extract-insights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-insights.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/extract-insights.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGnC,eAAO,MAAM,mBAAmB,EAAE,IAsIjC,CAAC"}