noverload-mcp 0.6.0 → 0.7.0

package/dist/tools/implementations/goals.d.ts

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

package/dist/tools/implementations/goals.d.ts.map

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

package/dist/tools/implementations/goals.js

@@ -0,0 +1,22 @@
+export const listGoalsTool = {
+    name: "list_goals",
+    description: "List user's goals (Health, Wealth, Relationships)",
+    inputSchema: {
+        type: "object",
+        properties: {},
+    },
+    modifies: false,
+    handler: async (client) => {
+        const goals = await client.listGoals();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Found ${goals.length} goals`,
+                },
+            ],
+            data: goals,
+        };
+    },
+};
+//# sourceMappingURL=goals.js.map

package/dist/tools/implementations/goals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goals.js","sourceRoot":"","sources":["../../../src/tools/implementations/goals.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,mDAAmD;IAChE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;KACf;IACD,QAAQ,EAAE,KAAK;IACf,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACxB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QACvC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,SAAS,KAAK,CAAC,MAAM,QAAQ;iBACpC;aACF;YACD,IAAI,EAAE,KAAK;SACZ,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/implementations/instructions.d.ts

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

package/dist/tools/implementations/instructions.d.ts.map

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

package/dist/tools/implementations/instructions.js

@@ -0,0 +1,88 @@
+import { z } from "zod";
+import { generateLLMInstructions } from "../../llm-instructions.js";
+export const getInstructionsTool = {
+    name: "get_instructions",
+    description: "Get instructions for optimal MCP usage, including capabilities, best practices, and example workflows",
+    inputSchema: {
+        type: "object",
+        properties: {
+            topic: {
+                type: "string",
+                description: "Specific topic for instructions (optional)",
+                enum: ["search", "synthesis", "retrieval", "general"],
+            },
+            includeExamples: {
+                type: "boolean",
+                description: "Include workflow examples",
+                default: true,
+            },
+        },
+    },
+    modifies: false,
+    handler: async (client, args) => {
+        const schema = z.object({
+            topic: z.enum(["search", "synthesis", "retrieval", "general"]).optional(),
+            includeExamples: z.boolean().optional().default(true),
+        });
+        const params = schema.parse(args);
+        const instructions = generateLLMInstructions();
+        let responseText = `# Noverload MCP Usage Instructions\n\n`;
+        responseText += `## Version: ${instructions.version}\n\n`;
+        if (!params.topic || params.topic === "general") {
+            // Show all capabilities
+            responseText += `## Capabilities Overview\n\n`;
+            for (const [key, capability] of Object.entries(instructions.capabilities)) {
+                responseText += `### ${key.charAt(0).toUpperCase() + key.slice(1)}\n`;
+                responseText += `${capability.description}\n\n`;
+                responseText += `**Strengths:**\n`;
+                capability.strengths.forEach((s) => responseText += `- ${s}\n`);
+                responseText += `\n**When to use:**\n`;
+                capability.whenToUse.forEach((w) => responseText += `- ${w}\n`);
+                responseText += `\n`;
+            }
+            responseText += `## Best Practices\n\n`;
+            for (const [scenario, practice] of Object.entries(instructions.bestPractices)) {
+                responseText += `**${scenario.replace(/([A-Z])/g, ' $1').toLowerCase()}:** ${practice}\n`;
+            }
+            responseText += `\n`;
+        }
+        else {
+            // Show specific capability
+            const capability = instructions.capabilities[params.topic];
+            if (capability) {
+                responseText += `## ${params.topic.charAt(0).toUpperCase() + params.topic.slice(1)} Capability\n\n`;
+                responseText += `${capability.description}\n\n`;
+                responseText += `### Strengths\n`;
+                capability.strengths.forEach(s => responseText += `- ${s}\n`);
+                responseText += `\n### Limitations\n`;
+                capability.limitations.forEach(l => responseText += `- ${l}\n`);
+                responseText += `\n### When to Use\n`;
+                capability.whenToUse.forEach(w => responseText += `- ${w}\n`);
+            }
+        }
+        if (params.includeExamples && instructions.exampleWorkflows.length > 0) {
+            responseText += `\n## Example Workflows\n\n`;
+            instructions.exampleWorkflows.forEach((example, idx) => {
+                responseText += `### ${idx + 1}. ${example.scenario}\n`;
+                responseText += `**Steps:**\n`;
+                example.steps.forEach((step, i) => responseText += `${i + 1}. ${step}\n`);
+                responseText += `**Expected Outcome:** ${example.expectedOutcome}\n\n`;
+            });
+        }
+        responseText += `## Token Management\n\n`;
+        responseText += `- Search results limit: ${instructions.tokenManagement.searchResultsLimit}\n`;
+        responseText += `- Use chunking: ${instructions.tokenManagement.useChunking ? 'Yes' : 'No'}\n`;
+        responseText += `- Get summaries first: ${instructions.tokenManagement.summaryFirst ? 'Yes' : 'No'}\n`;
+        responseText += `- Max content per query: ${instructions.tokenManagement.maxContentPerQuery.toLocaleString()} tokens\n`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: responseText,
+                },
+            ],
+            data: instructions,
+        };
+    },
+};
+//# sourceMappingURL=instructions.js.map

package/dist/tools/implementations/instructions.js.map

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

package/dist/tools/implementations/knowledge-graph.d.ts

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

package/dist/tools/implementations/knowledge-graph.d.ts.map

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

package/dist/tools/implementations/knowledge-graph.js

@@ -0,0 +1,278 @@
+import { z } from "zod";
+export const buildKnowledgeGraphTool = {
+    name: "build_knowledge_graph",
+    description: "Create a knowledge graph showing relationships between concepts, topics, and content in your saved knowledge base",
+    inputSchema: {
+        type: "object",
+        properties: {
+            topic: {
+                type: "string",
+                description: "Central topic for the knowledge graph",
+            },
+            maxNodes: {
+                type: "number",
+                description: "Maximum number of nodes in the graph",
+                default: 20,
+            },
+            depth: {
+                type: "number",
+                description: "How many levels of connections to explore (1-3)",
+                default: 2,
+            },
+            includeStats: {
+                type: "boolean",
+                description: "Include statistics about connections",
+                default: true,
+            },
+        },
+        required: ["topic"],
+    },
+    modifies: false,
+    handler: async (client, args) => {
+        const schema = z.object({
+            topic: z.string(),
+            maxNodes: z.number().optional().default(20),
+            depth: z.number().min(1).max(3).optional().default(2),
+            includeStats: z.boolean().optional().default(true),
+        });
+        const params = schema.parse(args);
+        // Search for content related to the topic
+        const searchResults = await client.searchContent(params.topic, {
+            limit: params.maxNodes * 2, // Get extra for better graph
+            enableConceptExpansion: true,
+        });
+        if (!searchResults || searchResults.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No content found for topic: "${params.topic}". Cannot build knowledge graph without saved content.`,
+                    },
+                ],
+                data: null,
+            };
+        }
+        // Build the graph structure
+        const nodes = new Map();
+        const edges = new Map();
+        // Add central topic node
+        nodes.set(params.topic.toLowerCase(), {
+            id: params.topic.toLowerCase(),
+            label: params.topic,
+            type: "central",
+            weight: searchResults.length,
+        });
+        // Process search results to extract concepts and relationships
+        searchResults.forEach((item) => {
+            // Add content as a node
+            const contentId = `content_${item.id}`;
+            nodes.set(contentId, {
+                id: contentId,
+                label: item.title || "Untitled",
+                type: "content",
+                contentType: item.contentType,
+                url: item.url,
+                weight: 1,
+            });
+            // Connect content to central topic
+            if (!edges.has(params.topic.toLowerCase())) {
+                edges.set(params.topic.toLowerCase(), new Set());
+            }
+            edges.get(params.topic.toLowerCase()).add(contentId);
+            // Extract and add concept nodes from tags and summary
+            if (item.tags && Array.isArray(item.tags)) {
+                item.tags.forEach((tag) => {
+                    const tagId = `tag_${tag.toLowerCase()}`;
+                    if (!nodes.has(tagId)) {
+                        nodes.set(tagId, {
+                            id: tagId,
+                            label: tag,
+                            type: "concept",
+                            weight: 0,
+                        });
+                    }
+                    // Increase weight for repeated concepts
+                    nodes.get(tagId).weight++;
+                    // Connect tag to content
+                    if (!edges.has(contentId)) {
+                        edges.set(contentId, new Set());
+                    }
+                    edges.get(contentId).add(tagId);
+                    // Connect tag to central topic
+                    edges.get(params.topic.toLowerCase()).add(tagId);
+                });
+            }
+            // Extract key concepts from summary if available
+            if (item.summary) {
+                const summary = typeof item.summary === 'string'
+                    ? item.summary
+                    : item.summary.one_sentence || item.summary.text || "";
+                // Simple concept extraction (words that appear to be important)
+                const words = summary.toLowerCase().split(/\s+/);
+                const importantWords = words
+                    .filter((w) => w.length > 6 && !['through', 'between', 'because', 'without'].includes(w))
+                    .slice(0, 3);
+                importantWords.forEach((word) => {
+                    const conceptId = `concept_${word}`;
+                    if (!nodes.has(conceptId) && nodes.size < params.maxNodes) {
+                        nodes.set(conceptId, {
+                            id: conceptId,
+                            label: word,
+                            type: "derived",
+                            weight: 1,
+                        });
+                        // Connect to content
+                        if (!edges.has(contentId)) {
+                            edges.set(contentId, new Set());
+                        }
+                        edges.get(contentId).add(conceptId);
+                    }
+                });
+            }
+        });
+        // For depth > 1, find second-level connections
+        if (params.depth > 1) {
+            const firstLevelNodes = Array.from(edges.get(params.topic.toLowerCase()) || []);
+            for (const nodeId of firstLevelNodes.slice(0, 10)) { // Limit for performance
+                if (nodeId.startsWith('tag_') || nodeId.startsWith('concept_')) {
+                    // Find content that shares this concept
+                    const concept = nodes.get(nodeId)?.label;
+                    if (concept) {
+                        const relatedResults = await client.searchContent(concept, {
+                            limit: 5,
+                            enableConceptExpansion: false,
+                        });
+                        relatedResults?.forEach((item) => {
+                            const relatedId = `related_${item.id}`;
+                            if (!nodes.has(relatedId) && nodes.size < params.maxNodes) {
+                                nodes.set(relatedId, {
+                                    id: relatedId,
+                                    label: item.title || "Related Content",
+                                    type: "related",
+                                    contentType: item.contentType,
+                                    url: item.url,
+                                    weight: 1,
+                                });
+                                // Connect to the concept
+                                if (!edges.has(nodeId)) {
+                                    edges.set(nodeId, new Set());
+                                }
+                                edges.get(nodeId).add(relatedId);
+                            }
+                        });
+                    }
+                }
+            }
+        }
+        // Format response
+        let responseText = `# 🕸️ Knowledge Graph: "${params.topic}"\n`;
+        responseText += `**Nodes:** ${nodes.size} | **Depth:** ${params.depth}\n\n`;
+        // Node breakdown
+        const nodeTypes = new Map();
+        nodes.forEach(node => {
+            nodeTypes.set(node.type, (nodeTypes.get(node.type) || 0) + 1);
+        });
+        responseText += `## 📊 Graph Structure\n`;
+        responseText += `- **Central Topic:** ${params.topic}\n`;
+        nodeTypes.forEach((count, type) => {
+            const typeEmoji = {
+                content: "📄",
+                concept: "💡",
+                derived: "🔍",
+                related: "🔗",
+                central: "🎯",
+            };
+            responseText += `- **${typeEmoji[type] || "•"} ${type}:** ${count} nodes\n`;
+        });
+        responseText += `\n`;
+        // Key concepts (highest weight nodes)
+        const conceptNodes = Array.from(nodes.values())
+            .filter(n => n.type === 'concept' || n.type === 'derived')
+            .sort((a, b) => b.weight - a.weight)
+            .slice(0, 10);
+        if (conceptNodes.length > 0) {
+            responseText += `## 💡 Key Concepts\n`;
+            conceptNodes.forEach((node, idx) => {
+                responseText += `${idx + 1}. **${node.label}** (strength: ${node.weight})\n`;
+            });
+            responseText += `\n`;
+        }
+        // Content clusters
+        const contentNodes = Array.from(nodes.values())
+            .filter(n => n.type === 'content')
+            .slice(0, 10);
+        if (contentNodes.length > 0) {
+            responseText += `## 📚 Core Content\n`;
+            contentNodes.forEach((node, idx) => {
+                const typeIcons = {
+                    youtube: "📺",
+                    x_twitter: "𝕏",
+                    reddit: "🔗",
+                    article: "📄",
+                    pdf: "📑"
+                };
+                const icon = typeIcons[node.contentType] || "📄";
+                responseText += `${idx + 1}. ${icon} [${node.label}](${node.url})\n`;
+            });
+            responseText += `\n`;
+        }
+        // Connection statistics
+        if (params.includeStats) {
+            responseText += `## 🔗 Connection Statistics\n`;
+            // Find most connected nodes
+            const connectionCounts = new Map();
+            edges.forEach((connections, nodeId) => {
+                connectionCounts.set(nodeId, connections.size);
+            });
+            const mostConnected = Array.from(connectionCounts.entries())
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, 5);
+            responseText += `**Most Connected Nodes:**\n`;
+            mostConnected.forEach(([nodeId, count]) => {
+                const node = nodes.get(nodeId);
+                if (node) {
+                    responseText += `- ${node.label}: ${count} connections\n`;
+                }
+            });
+            responseText += `\n`;
+            // Graph density
+            const possibleEdges = nodes.size * (nodes.size - 1) / 2;
+            const actualEdges = Array.from(edges.values()).reduce((sum, set) => sum + set.size, 0);
+            const density = ((actualEdges / possibleEdges) * 100).toFixed(1);
+            responseText += `**Graph Metrics:**\n`;
+            responseText += `- Density: ${density}%\n`;
+            responseText += `- Average connections: ${(actualEdges / nodes.size).toFixed(1)}\n`;
+            responseText += `- Total edges: ${actualEdges}\n`;
+        }
+        // Visualization suggestion
+        responseText += `\n## 🎨 Visualization\n`;
+        responseText += `The knowledge graph contains:\n`;
+        responseText += `- ${nodes.size} nodes representing concepts and content\n`;
+        responseText += `- ${Array.from(edges.values()).reduce((sum, set) => sum + set.size, 0)} edges showing relationships\n\n`;
+        responseText += `💡 **Tip:** Use the graph data in the response to create visual representations with tools like D3.js or Graphviz.\n`;
+        // Convert to serializable format
+        const graphData = {
+            nodes: Array.from(nodes.values()),
+            edges: Array.from(edges.entries()).flatMap(([source, targets]) => Array.from(targets).map(target => ({ source, target }))),
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: responseText,
+                },
+            ],
+            data: {
+                topic: params.topic,
+                graph: graphData,
+                statistics: {
+                    nodeCount: nodes.size,
+                    edgeCount: graphData.edges.length,
+                    nodeTypes: Object.fromEntries(nodeTypes),
+                    depth: params.depth,
+                },
+            },
+        };
+    },
+};
+//# sourceMappingURL=knowledge-graph.js.map

package/dist/tools/implementations/knowledge-graph.js.map

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

package/dist/tools/implementations/list-content.d.ts

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

package/dist/tools/implementations/list-content.d.ts.map

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

package/dist/tools/implementations/list-content.js

@@ -0,0 +1,87 @@
+import { z } from "zod";
+export const listSavedContentTool = {
+    name: "list_saved_content",
+    description: "List saved content from Noverload with full details including titles, summaries, and insights. Optionally filter by status or content type.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            status: {
+                type: "string",
+                enum: ["pending", "processing", "completed", "failed"],
+                description: "Filter by processing status",
+            },
+            contentType: {
+                type: "string",
+                enum: ["youtube", "x_twitter", "reddit", "article", "pdf"],
+                description: "Filter by content type",
+            },
+            limit: {
+                type: "number",
+                description: "Maximum number of items to return",
+                default: 20,
+            },
+        },
+    },
+    modifies: false,
+    handler: async (client, args) => {
+        const schema = z.object({
+            status: z.enum(["pending", "processing", "completed", "failed"]).optional(),
+            contentType: z.enum(["youtube", "x_twitter", "reddit", "article", "pdf"]).optional(),
+            limit: z.number().optional().default(20),
+        });
+        const params = schema.parse(args);
+        const content = await client.listContent(params);
+        // Build detailed response
+        let responseText = `# Saved Content Library\n`;
+        responseText += `Found ${content.length} items`;
+        const filters = [];
+        if (params.status)
+            filters.push(`status: ${params.status}`);
+        if (params.contentType)
+            filters.push(`type: ${params.contentType}`);
+        if (filters.length > 0) {
+            responseText += ` (filtered by ${filters.join(', ')})`;
+        }
+        responseText += `\n\n`;
+        if (content.length > 0) {
+            content.forEach((item, idx) => {
+                responseText += `## ${idx + 1}. ${item.title || 'Untitled'}\n`;
+                responseText += `**ID:** ${item.id}\n`;
+                responseText += `**Type:** ${item.contentType} | **Status:** ${item.status}`;
+                if (item.tokenCount) {
+                    responseText += ` | **Size:** ${item.tokenCount.toLocaleString()} tokens`;
+                    if (item.tokenCount > 50000) {
+                        responseText += ` 🚨`;
+                    }
+                    else if (item.tokenCount > 10000) {
+                        responseText += ` ⚠️`;
+                    }
+                }
+                responseText += `\n**URL:** ${item.url}\n`;
+                if (item.summary) {
+                    const summaryObj = typeof item.summary === 'string'
+                        ? { text: item.summary }
+                        : item.summary;
+                    if (summaryObj.one_sentence) {
+                        responseText += `**Summary:** ${summaryObj.one_sentence}\n`;
+                    }
+                }
+                responseText += `**Saved:** ${new Date(item.createdAt).toLocaleDateString()}\n`;
+                responseText += '\n---\n\n';
+            });
+        }
+        else {
+            responseText += "No content found matching the specified filters.";
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: responseText,
+                },
+            ],
+            data: content,
+        };
+    },
+};
+//# sourceMappingURL=list-content.js.map

package/dist/tools/implementations/list-content.js.map

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

package/dist/tools/implementations/plan-query.d.ts

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

package/dist/tools/implementations/plan-query.d.ts.map

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

package/dist/tools/implementations/plan-query.js

@@ -0,0 +1,63 @@
+import { z } from "zod";
+import { planQueryStrategy, estimateTokenUsage } from "../../llm-instructions.js";
+export const planQueryTool = {
+    name: "plan_query",
+    description: "Plan an optimal query strategy for complex requests, with token estimates",
+    inputSchema: {
+        type: "object",
+        properties: {
+            request: {
+                type: "string",
+                description: "The user's request to plan for",
+            },
+        },
+        required: ["request"],
+    },
+    modifies: false,
+    handler: async (client, args) => {
+        const schema = z.object({
+            request: z.string(),
+        });
+        const { request } = schema.parse(args);
+        const availableTools = [
+            "search_content",
+            "get_content_details",
+            "synthesize_content",
+            "find_similar_content",
+            "list_saved_content"
+        ];
+        const plan = planQueryStrategy(request, availableTools);
+        let responseText = `# Query Plan for: "${request}"\n\n`;
+        responseText += `## Strategy: ${plan.strategy}\n`;
+        responseText += `## Estimated Tokens: ~${plan.estimatedTokens.toLocaleString()}\n\n`;
+        responseText += `## Execution Steps:\n\n`;
+        plan.steps.forEach((step, idx) => {
+            responseText += `### Step ${idx + 1}: ${step.tool}\n`;
+            responseText += `**Purpose:** ${step.purpose}\n`;
+            responseText += `**Parameters:**\n`;
+            for (const [key, value] of Object.entries(step.params)) {
+                responseText += `- ${key}: ${JSON.stringify(value)}\n`;
+            }
+            const tokenEstimate = estimateTokenUsage({ tool: step.tool, params: step.params });
+            responseText += `**Estimated Tokens:** ~${tokenEstimate.estimated.toLocaleString()}`;
+            if (tokenEstimate.warning) {
+                responseText += ` ⚠️ ${tokenEstimate.warning}`;
+            }
+            responseText += `\n`;
+            if (tokenEstimate.suggestion) {
+                responseText += `**Suggestion:** ${tokenEstimate.suggestion}\n`;
+            }
+            responseText += `\n`;
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: responseText,
+                },
+            ],
+            data: plan,
+        };
+    },
+};
+//# sourceMappingURL=plan-query.js.map

package/dist/tools/implementations/plan-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-query.js","sourceRoot":"","sources":["../../../src/tools/implementations/plan-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAElF,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,2EAA2E;IACxF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gCAAgC;aAC9C;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,QAAQ,EAAE,KAAK;IACf,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;YACtB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;SACpB,CAAC,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEvC,MAAM,cAAc,GAAG;YACrB,gBAAgB;YAChB,qBAAqB;YACrB,oBAAoB;YACpB,sBAAsB;YACtB,oBAAoB;SACrB,CAAC;QAEF,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAExD,IAAI,YAAY,GAAG,sBAAsB,OAAO,OAAO,CAAC;QACxD,YAAY,IAAI,gBAAgB,IAAI,CAAC,QAAQ,IAAI,CAAC;QAClD,YAAY,IAAI,yBAAyB,IAAI,CAAC,eAAe,CAAC,cAAc,EAAE,MAAM,CAAC;QACrF,YAAY,IAAI,yBAAyB,CAAC;QAE1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;YAC/B,YAAY,IAAI,YAAY,GAAG,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC;YACtD,YAAY,IAAI,gBAAgB,IAAI,CAAC,OAAO,IAAI,CAAC;YACjD,YAAY,IAAI,mBAAmB,CAAC;YACpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvD,YAAY,IAAI,KAAK,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;YACzD,CAAC;YAED,MAAM,aAAa,GAAG,kBAAkB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACnF,YAAY,IAAI,0BAA0B,aAAa,CAAC,SAAS,CAAC,cAAc,EAAE,EAAE,CAAC;YACrF,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;gBAC1B,YAAY,IAAI,OAAO,aAAa,CAAC,OAAO,EAAE,CAAC;YACjD,CAAC;YACD,YAAY,IAAI,IAAI,CAAC;YACrB,IAAI,aAAa,CAAC,UAAU,EAAE,CAAC;gBAC7B,YAAY,IAAI,mBAAmB,aAAa,CAAC,UAAU,IAAI,CAAC;YAClE,CAAC;YACD,YAAY,IAAI,IAAI,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,YAAY;iBACnB;aACF;YACD,IAAI,EAAE,IAAI;SACX,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/implementations/raw-content.d.ts

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

package/dist/tools/implementations/raw-content.d.ts.map

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