research-powerpack-mcp 3.0.0

package/dist/tools/definitions.js

@@ -0,0 +1,125 @@
+/**
+ * MCP Tool Definitions
+ * Extracted from index.ts for cleaner separation
+ */
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { deepResearchParamsSchema } from '../schemas/deep-research.js';
+import { scrapeLinksParamsSchema } from '../schemas/scrape-links.js';
+import { webSearchParamsSchema } from '../schemas/web-search.js';
+export const TOOLS = [
+    // === REDDIT TOOLS ===
+    {
+        name: 'search_reddit',
+        description: `Search Reddit via Google (10 results/query). MUST call get_reddit_post after. Supports: intitle:, "exact", OR, -exclude. Auto-adds site:reddit.com. Call this tool first to find relevant posts, then call get_reddit_post with the URLs you find. Try to add all distinct relevant searches, try to bring max 10 search but effectively utilize limits by distinct queries like given example. Only use date_after if recent content needed`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                queries: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Distinct queries (max 10). Maximize count for multiple perspectives. eg: ["best IDE 2025", "best AI features on IDEs", "best IDE for Python", "top alternatives to vscode", "top alternatives to intitle:cursor -windsurf", "intitle:comparison of top IDEs","new IDEs like intitle:zed"]',
+                },
+                date_after: {
+                    type: 'string',
+                    description: 'Filter results after date (YYYY-MM-DD). Optional.',
+                },
+            },
+            required: ['queries'],
+        },
+    },
+    {
+        name: 'get_reddit_post',
+        description: `**Fetch Reddit posts with smart comment allocation (2-50 posts supported).**
+
+**SMART COMMENT BUDGET:** 1,000 comments distributed across all posts automatically.
+- 2 posts: ~500 comments/post (deep dive)
+- 10 posts: 100 comments/post
+- 50 posts: 20 comments/post (quick scan)
+
+**PARAMETERS:**
+- \`urls\`: 2-50 Reddit post URLs. More posts = broader community perspective.
+- \`fetch_comments\`: Set to false for post-only queries (faster). Default: true.
+- \`max_comments\`: Override auto-allocation if needed.
+
+**USE:** After search_reddit. Maximize post count for research breadth. Comment allocation is automatic and optimized.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                urls: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Reddit URLs (2-50). More posts = broader community perspective.',
+                },
+                fetch_comments: {
+                    type: 'boolean',
+                    description: 'Fetch comments? Set false for quick post overview. Default: true',
+                    default: true,
+                },
+                max_comments: {
+                    type: 'number',
+                    description: 'Override auto-allocation. Leave empty for smart allocation.',
+                    default: 100,
+                },
+            },
+            required: ['urls'],
+        },
+    },
+    // === DEEP RESEARCH TOOL ===
+    {
+        name: 'deep_research',
+        description: `**Batch deep research (2-10 questions) with dynamic token allocation.**
+
+**TOKEN BUDGET:** 32,000 tokens distributed across all questions:
+- 2 questions: 16,000 tokens/question (deep dive)
+- 5 questions: 6,400 tokens/question (balanced)
+- 10 questions: 3,200 tokens/question (rapid multi-topic)
+
+**WHEN TO USE:**
+- Need multi-perspective analysis on related topics
+- Researching a domain from multiple angles
+- Validating understanding across different aspects
+- Comparing approaches/technologies side-by-side
+
+**EACH QUESTION SHOULD INCLUDE:**
+- Topic & context (what decision it informs)
+- Your current understanding (to fill gaps)
+- Specific sub-questions (2-5 per topic)
+
+**USE:** Maximize question count for comprehensive coverage. All questions run in parallel. Group related questions for coherent research.`,
+        inputSchema: zodToJsonSchema(deepResearchParamsSchema, { $refStrategy: 'none' }),
+    },
+    // === SCRAPE LINKS TOOL ===
+    {
+        name: 'scrape_links',
+        description: `**Universal URL content extraction (3-50 URLs) with dynamic token allocation.**
+
+**TOKEN ALLOCATION:** 32,000 tokens distributed across all URLs automatically.
+- 3 URLs: ~10,666 tokens/URL (deep extraction)
+- 10 URLs: 3,200 tokens/URL (detailed)
+- 50 URLs: 640 tokens/URL (high-level scan)
+
+**AUTOMATIC FALLBACK:** Basic → JavaScript → JavaScript+US geo-targeting.
+
+**AI EXTRACTION:** Set use_llm=true with what_to_extract for intelligent filtering. Extraction is concise + comprehensive (high info density).
+
+**BATCHING:** Max 30 concurrent requests. 50 URLs = [30] then [20] batches.
+
+**USE:** Provide 3-50 URLs. More URLs = broader coverage, fewer tokens per URL. Choose based on research scope. Maximize URL count for comprehensive research.`,
+        inputSchema: zodToJsonSchema(scrapeLinksParamsSchema, { $refStrategy: 'none' }),
+    },
+    // === WEB SEARCH TOOL ===
+    {
+        name: 'web_search',
+        description: `**Batch web search** using Google via SERPER API. Search up to 100 keywords in parallel, get top 10 results per keyword with snippets, links, and related searches.
+
+**FEATURES:**
+- Supports Google search operators (site:, -exclusion, "exact phrase", filetype:)
+- Returns clickable markdown links with snippets
+- Provides related search suggestions
+- Identifies frequently appearing URLs across queries
+
+**USE:** For research tasks requiring multiple perspectives. Use distinct keywords to maximize coverage. Follow up with scrape_links to extract full content from promising URLs.`,
+        inputSchema: zodToJsonSchema(webSearchParamsSchema, { $refStrategy: 'none' }),
+    },
+];
+//# sourceMappingURL=definitions.js.map

package/dist/tools/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,uBAAuB;IACvB;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,8aAA8a;QAC3b,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,2RAA2R;iBACzS;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mDAAmD;iBACjE;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;KACF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE;;;;;;;;;;;;uHAYsG;QACnH,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,iEAAiE;iBAC/E;gBACD,cAAc,EAAE;oBACd,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,kEAAkE;oBAC/E,OAAO,EAAE,IAAI;iBACd;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6DAA6D;oBAC1E,OAAO,EAAE,GAAG;iBACb;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;KACF;IAED,6BAA6B;IAC7B;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE;;;;;;;;;;;;;;;;;;2IAkB0H;QACvI,WAAW,EAAE,eAAe,CAAC,wBAAwB,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;KACjF;IAED,4BAA4B;IAC5B;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE;;;;;;;;;;;;;+JAa8I;QAC3J,WAAW,EAAE,eAAe,CAAC,uBAAuB,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;KAChF;IAED,0BAA0B;IAC1B;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE;;;;;;;;kLAQiK;QAC9K,WAAW,EAAE,eAAe,CAAC,qBAAqB,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;KAC9E;CACF,CAAC"}

package/dist/tools/reddit.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Reddit Tools - Search and Fetch
+ */
+export declare function handleSearchReddit(queries: string[], apiKey: string, dateAfter?: string): Promise<string>;
+export interface GetRedditPostsOptions {
+    fetchComments?: boolean;
+    maxCommentsOverride?: number;
+}
+export declare function handleGetRedditPosts(urls: string[], clientId: string, clientSecret: string, maxComments?: number, options?: GetRedditPostsOptions): Promise<string>;
+//# sourceMappingURL=reddit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reddit.d.ts","sourceRoot":"","sources":["../../src/tools/reddit.ts"],"names":[],"mappings":"AAAA;;GAEG;AA+CH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAMD,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,WAAW,SAAM,EACjB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,MAAM,CAAC,CAgDjB"}

package/dist/tools/reddit.js

@@ -0,0 +1,105 @@
+/**
+ * Reddit Tools - Search and Fetch
+ */
+import { SearchClient } from '../clients/search.js';
+import { RedditClient, calculateCommentAllocation } from '../clients/reddit.js';
+import { REDDIT } from '../config/index.js';
+// ============================================================================
+// Formatters
+// ============================================================================
+function formatComments(comments) {
+    let md = '';
+    for (const c of comments) {
+        const indent = '  '.repeat(c.depth);
+        const op = c.isOP ? ' **[OP]**' : '';
+        const score = c.score >= 0 ? `+${c.score}` : `${c.score}`;
+        md += `${indent}- **u/${c.author}**${op} _(${score})_\n`;
+        const bodyLines = c.body.split('\n').map(line => `${indent}  ${line}`).join('\n');
+        md += `${bodyLines}\n\n`;
+    }
+    return md;
+}
+function formatPost(result, fetchComments) {
+    const { post, comments, allocatedComments } = result;
+    let md = `## ${post.title}\n\n`;
+    md += `**r/${post.subreddit}** • u/${post.author} • ⬆️ ${post.score} • 💬 ${post.commentCount} comments\n`;
+    md += `🔗 ${post.url}\n\n`;
+    if (post.body) {
+        md += `### Post Content\n\n${post.body}\n\n`;
+    }
+    if (fetchComments && comments.length > 0) {
+        md += `### Top Comments (${comments.length}/${post.commentCount} shown, allocated: ${allocatedComments})\n\n`;
+        md += formatComments(comments);
+    }
+    else if (!fetchComments) {
+        md += `_Comments not fetched (fetch_comments=false)_\n\n`;
+    }
+    return md;
+}
+// ============================================================================
+// Search Reddit Handler
+// ============================================================================
+export async function handleSearchReddit(queries, apiKey, dateAfter) {
+    const limited = queries.slice(0, 10);
+    const client = new SearchClient(apiKey);
+    const results = await client.searchRedditMultiple(limited, dateAfter);
+    let md = '';
+    for (const [query, items] of results) {
+        md += `## 🔍 "${query}"${dateAfter ? ` (after ${dateAfter})` : ''}\n\n`;
+        if (items.length === 0) {
+            md += '_No results found_\n\n';
+            continue;
+        }
+        for (let i = 0; i < items.length; i++) {
+            const r = items[i];
+            const dateStr = r.date ? ` • 📅 ${r.date}` : '';
+            md += `**${i + 1}. ${r.title}**${dateStr}\n`;
+            md += `${r.url}\n`;
+            md += `> ${r.snippet}\n\n`;
+        }
+    }
+    return md.trim();
+}
+export async function handleGetRedditPosts(urls, clientId, clientSecret, maxComments = 100, options = {}) {
+    const { fetchComments = true, maxCommentsOverride } = options;
+    if (urls.length < REDDIT.MIN_POSTS) {
+        return `# ❌ Error\n\nMinimum ${REDDIT.MIN_POSTS} Reddit posts required. Received: ${urls.length}`;
+    }
+    if (urls.length > REDDIT.MAX_POSTS) {
+        return `# ❌ Error\n\nMaximum ${REDDIT.MAX_POSTS} Reddit posts allowed. Received: ${urls.length}. Please remove ${urls.length - REDDIT.MAX_POSTS} URL(s) and retry.`;
+    }
+    const allocation = calculateCommentAllocation(urls.length);
+    const commentsPerPost = fetchComments ? (maxCommentsOverride || allocation.perPostCapped) : 0;
+    const totalBatches = Math.ceil(urls.length / REDDIT.BATCH_SIZE);
+    const client = new RedditClient(clientId, clientSecret);
+    const batchResult = await client.batchGetPosts(urls, commentsPerPost, fetchComments);
+    const results = batchResult.results;
+    let md = `# Reddit Posts (${urls.length} posts)\n\n`;
+    if (fetchComments) {
+        md += `**Comment Allocation:** ${commentsPerPost} comments/post (${urls.length} posts, ${REDDIT.MAX_COMMENT_BUDGET} total budget)\n`;
+    }
+    else {
+        md += `**Comments:** Not fetched (fetch_comments=false)\n`;
+    }
+    md += `**Status:** 📦 ${totalBatches} batch(es) processed\n\n`;
+    md += `---\n\n`;
+    let successful = 0;
+    let failed = 0;
+    for (const [url, result] of results) {
+        if (result instanceof Error) {
+            failed++;
+            md += `## ❌ Failed: ${url}\n\n_${result.message}_\n\n---\n\n`;
+        }
+        else {
+            successful++;
+            md += formatPost(result, fetchComments);
+            md += '\n---\n\n';
+        }
+    }
+    md += `\n**Summary:** ✅ ${successful} successful | ❌ ${failed} failed`;
+    if (batchResult.rateLimitHits > 0) {
+        md += ` | ⚠️ ${batchResult.rateLimitHits} rate limit retries`;
+    }
+    return md.trim();
+}
+//# sourceMappingURL=reddit.js.map

package/dist/tools/reddit.js.map

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

package/dist/tools/research.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Deep Research Tool Handler - Batch processing with dynamic token allocation
+ */
+import type { DeepResearchParams } from '../schemas/deep-research.js';
+interface ResearchOptions {
+    sessionId?: string;
+    logger?: (level: 'info' | 'error' | 'debug', message: string, sessionId: string) => Promise<void>;
+}
+export declare function handleDeepResearch(params: DeepResearchParams, options?: ResearchOptions): Promise<{
+    content: string;
+    structuredContent: object;
+}>;
+export {};
+//# sourceMappingURL=research.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../src/tools/research.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAWtE,UAAU,eAAe;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnG;AA+BD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAAC,CA2GzD"}

package/dist/tools/research.js

@@ -0,0 +1,126 @@
+/**
+ * Deep Research Tool Handler - Batch processing with dynamic token allocation
+ */
+import { ResearchClient } from '../clients/research.js';
+import { FileAttachmentService } from '../services/file-attachment.js';
+import { RESEARCH } from '../config/index.js';
+import { createSimpleError } from '../utils/errors.js';
+// Constants
+const TOTAL_TOKEN_BUDGET = 32000;
+const MIN_QUESTIONS = 2;
+const MAX_QUESTIONS = 10;
+function calculateTokenAllocation(questionCount) {
+    return Math.floor(TOTAL_TOKEN_BUDGET / questionCount);
+}
+const SYSTEM_PROMPT = `You are an expert research consultant. Provide evidence-based, multi-perspective analysis.
+
+METHODOLOGY:
+- SOURCE DIVERSITY: Official docs, papers, blogs, case studies
+- CURRENT + HISTORICAL: Latest developments AND context
+- MULTIPLE PERSPECTIVES: Different approaches with pros/cons
+- EVIDENCE-BASED: Claims backed by citations
+
+FORMAT (high info density):
+- CURRENT STATE: Status quo, what we know
+- KEY INSIGHTS: Most important findings with evidence
+- TRADE-OFFS: Competing priorities honestly analyzed
+- PRACTICAL IMPLICATIONS: Real-world application
+- WHAT'S CHANGING: Recent developments
+
+Be dense with insights, light on filler. Use examples and citations.`;
+export async function handleDeepResearch(params, options = {}) {
+    const { sessionId, logger } = options;
+    const questions = params.questions;
+    // Validation
+    if (questions.length < MIN_QUESTIONS) {
+        return {
+            content: `# ❌ Error\n\nMinimum ${MIN_QUESTIONS} research questions required. Received: ${questions.length}`,
+            structuredContent: { error: true, message: `Minimum ${MIN_QUESTIONS} questions required` },
+        };
+    }
+    if (questions.length > MAX_QUESTIONS) {
+        return {
+            content: `# ❌ Error\n\nMaximum ${MAX_QUESTIONS} research questions allowed. Received: ${questions.length}`,
+            structuredContent: { error: true, message: `Maximum ${MAX_QUESTIONS} questions allowed` },
+        };
+    }
+    const tokensPerQuestion = calculateTokenAllocation(questions.length);
+    if (sessionId && logger) {
+        await logger('info', `Starting batch research: ${questions.length} questions, ${tokensPerQuestion.toLocaleString()} tokens/question`, sessionId);
+    }
+    const client = new ResearchClient();
+    const fileService = new FileAttachmentService();
+    const results = [];
+    // Process all questions in parallel
+    const researchPromises = questions.map(async (q, index) => {
+        try {
+            // Enhance question with file attachments if present
+            let enhancedQuestion = q.question;
+            if (q.file_attachments && q.file_attachments.length > 0) {
+                const attachmentsMarkdown = await fileService.formatAttachments(q.file_attachments);
+                enhancedQuestion = q.question + attachmentsMarkdown;
+            }
+            const response = await client.research({
+                question: enhancedQuestion,
+                systemPrompt: SYSTEM_PROMPT,
+                reasoningEffort: RESEARCH.REASONING_EFFORT,
+                maxSearchResults: Math.min(RESEARCH.MAX_URLS, 20),
+                maxTokens: tokensPerQuestion,
+            });
+            return {
+                question: q.question,
+                content: response.content,
+                success: true,
+                tokensUsed: response.usage?.totalTokens,
+            };
+        }
+        catch (error) {
+            const simpleError = createSimpleError(error);
+            return {
+                question: q.question,
+                content: '',
+                success: false,
+                error: simpleError.message,
+            };
+        }
+    });
+    const allResults = await Promise.all(researchPromises);
+    results.push(...allResults);
+    // Build markdown output
+    const successful = results.filter(r => r.success);
+    const failed = results.filter(r => !r.success);
+    const totalTokens = successful.reduce((sum, r) => sum + (r.tokensUsed || 0), 0);
+    let markdown = `# Deep Research Results (${questions.length} questions)\n\n`;
+    markdown += `**Token Allocation:** ${tokensPerQuestion.toLocaleString()} tokens/question (${questions.length} questions, ${TOTAL_TOKEN_BUDGET.toLocaleString()} total budget)\n`;
+    markdown += `**Status:** ✅ ${successful.length} successful | ❌ ${failed.length} failed | 📊 ${totalTokens.toLocaleString()} tokens used\n\n`;
+    markdown += `---\n\n`;
+    for (let i = 0; i < results.length; i++) {
+        const r = results[i];
+        markdown += `## Question ${i + 1}: ${r.question.substring(0, 100)}${r.question.length > 100 ? '...' : ''}\n\n`;
+        if (r.success) {
+            markdown += r.content + '\n\n';
+            if (r.tokensUsed) {
+                markdown += `_Tokens used: ${r.tokensUsed.toLocaleString()}_\n\n`;
+            }
+        }
+        else {
+            markdown += `**❌ Error:** ${r.error}\n\n`;
+        }
+        markdown += `---\n\n`;
+    }
+    if (sessionId && logger) {
+        await logger('info', `Research completed: ${successful.length}/${questions.length} successful, ${totalTokens.toLocaleString()} tokens`, sessionId);
+    }
+    return {
+        content: markdown.trim(),
+        structuredContent: {
+            totalQuestions: questions.length,
+            successful: successful.length,
+            failed: failed.length,
+            tokensPerQuestion,
+            totalTokensUsed: totalTokens,
+            results,
+        },
+    };
+}
+//# sourceMappingURL=research.js.map

package/dist/tools/research.js.map

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

package/dist/tools/scrape.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Scrape Links Tool Handler
+ */
+import type { ScrapeLinksParams, ScrapeLinksOutput } from '../schemas/scrape-links.js';
+interface ToolOptions {
+    sessionId?: string;
+    logger?: (level: 'info' | 'error' | 'debug', message: string, sessionId: string) => Promise<void>;
+}
+export declare function handleScrapeLinks(params: ScrapeLinksParams, options?: ToolOptions): Promise<{
+    content: string;
+    structuredContent: ScrapeLinksOutput;
+}>;
+export {};
+//# sourceMappingURL=scrape.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scrape.d.ts","sourceRoot":"","sources":["../../src/tools/scrape.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAOvF,UAAU,WAAW;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnG;AAWD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAuHpE"}

package/dist/tools/scrape.js

@@ -0,0 +1,111 @@
+/**
+ * Scrape Links Tool Handler
+ */
+import { ScraperClient } from '../clients/scraper.js';
+import { MarkdownCleaner } from '../services/markdown-cleaner.js';
+import { createLLMProcessor, processContentWithLLM } from '../services/llm-processor.js';
+import { removeMetaTags } from '../utils/markdown-formatter.js';
+import { SCRAPER } from '../config/index.js';
+function calculateTokenAllocation(urlCount) {
+    return Math.floor(SCRAPER.MAX_TOKENS_BUDGET / urlCount);
+}
+function enhanceExtractionInstruction(instruction) {
+    const base = instruction || 'Extract the main content and key information from this page.';
+    return `${base}\n\n${SCRAPER.EXTRACTION_SUFFIX}`;
+}
+export async function handleScrapeLinks(params, options = {}) {
+    const { sessionId, logger } = options;
+    const startTime = Date.now();
+    try {
+        const tokensPerUrl = calculateTokenAllocation(params.urls.length);
+        const totalBatches = Math.ceil(params.urls.length / SCRAPER.BATCH_SIZE);
+        if (sessionId && logger) {
+            await logger('info', `Starting scrape: ${params.urls.length} URL(s), ${tokensPerUrl} tokens/URL, ${totalBatches} batch(es)`, sessionId);
+        }
+        const client = new ScraperClient();
+        const markdownCleaner = new MarkdownCleaner();
+        const llmProcessor = createLLMProcessor();
+        const enhancedInstruction = params.use_llm
+            ? enhanceExtractionInstruction(params.what_to_extract)
+            : undefined;
+        const results = await client.scrapeMultiple(params.urls, { timeout: params.timeout });
+        if (sessionId && logger) {
+            await logger('info', `Scraping complete. Processing ${results.length} results...`, sessionId);
+        }
+        let successful = 0;
+        let failed = 0;
+        let totalCredits = 0;
+        const contents = [];
+        for (let i = 0; i < results.length; i++) {
+            const result = results[i];
+            if (!result)
+                continue;
+            if (sessionId && logger) {
+                await logger('info', `[${i + 1}/${results.length}] Processing ${result.url}`, sessionId);
+            }
+            if (result.statusCode >= 200 && result.statusCode < 300) {
+                successful++;
+                totalCredits += result.credits;
+                let content = markdownCleaner.processContent(result.content);
+                if (params.use_llm && llmProcessor) {
+                    if (sessionId && logger) {
+                        await logger('info', `[${i + 1}/${results.length}] Applying LLM extraction (${tokensPerUrl} tokens)...`, sessionId);
+                    }
+                    const llmResult = await processContentWithLLM(content, { use_llm: params.use_llm, what_to_extract: enhancedInstruction, max_tokens: tokensPerUrl }, llmProcessor);
+                    content = llmResult.content;
+                    if (sessionId && logger) {
+                        await logger('info', `[${i + 1}/${results.length}] LLM processing ${llmResult.processed ? 'complete' : 'skipped'}`, sessionId);
+                    }
+                }
+                content = removeMetaTags(content);
+                contents.push(`## ${result.url}\n\n${content}`);
+            }
+            else {
+                failed++;
+                contents.push(`## ${result.url}\n\n❌ Failed to scrape: ${result.content}`);
+                if (sessionId && logger) {
+                    await logger('error', `[${i + 1}/${results.length}] Failed: ${result.statusCode}`, sessionId);
+                }
+            }
+        }
+        const executionTime = Date.now() - startTime;
+        if (sessionId && logger) {
+            await logger('info', `Completed: ${successful} successful, ${failed} failed, ${totalCredits} credits used`, sessionId);
+        }
+        const allocationHeader = `**Token Allocation:** ${tokensPerUrl.toLocaleString()} tokens/URL (${params.urls.length} URLs, ${SCRAPER.MAX_TOKENS_BUDGET.toLocaleString()} total budget)`;
+        const statusHeader = `**Status:** ✅ ${successful} successful | ❌ ${failed} failed | 📦 ${totalBatches} batch(es)`;
+        const formattedContent = `# Scraped Content (${params.urls.length} URLs)\n\n${allocationHeader}\n${statusHeader}\n\n---\n\n${contents.join('\n\n---\n\n')}`;
+        const metadata = {
+            total_urls: params.urls.length,
+            successful,
+            failed,
+            total_credits: totalCredits,
+            execution_time_ms: executionTime,
+            tokens_per_url: tokensPerUrl,
+            total_token_budget: SCRAPER.MAX_TOKENS_BUDGET,
+            batches_processed: totalBatches,
+        };
+        return { content: formattedContent, structuredContent: { content: formattedContent, metadata } };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (sessionId && logger) {
+            await logger('error', errorMessage, sessionId);
+        }
+        const executionTime = Date.now() - startTime;
+        return {
+            content: `# ❌ Scraping Failed\n\n${errorMessage}`,
+            structuredContent: {
+                content: `# ❌ Scraping Failed\n\n${errorMessage}`,
+                metadata: {
+                    total_urls: params.urls.length,
+                    successful: 0,
+                    failed: params.urls.length,
+                    total_credits: 0,
+                    execution_time_ms: executionTime,
+                },
+            },
+        };
+    }
+}
+//# sourceMappingURL=scrape.js.map

package/dist/tools/scrape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrape.js","sourceRoot":"","sources":["../../src/tools/scrape.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAO7C,SAAS,wBAAwB,CAAC,QAAgB;IAChD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,GAAG,QAAQ,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,4BAA4B,CAAC,WAA+B;IACnE,MAAM,IAAI,GAAG,WAAW,IAAI,8DAA8D,CAAC;IAC3F,OAAO,GAAG,IAAI,OAAO,OAAO,CAAC,iBAAiB,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAyB,EACzB,UAAuB,EAAE;IAEzB,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,wBAAwB,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QAExE,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;YACxB,MAAM,MAAM,CAAC,MAAM,EAAE,oBAAoB,MAAM,CAAC,IAAI,CAAC,MAAM,YAAY,YAAY,gBAAgB,YAAY,YAAY,EAAE,SAAS,CAAC,CAAC;QAC1I,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QACnC,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QAC9C,MAAM,YAAY,GAAG,kBAAkB,EAAE,CAAC;QAE1C,MAAM,mBAAmB,GAAG,MAAM,CAAC,OAAO;YACxC,CAAC,CAAC,4BAA4B,CAAC,MAAM,CAAC,eAAe,CAAC;YACtD,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAEtF,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;YACxB,MAAM,MAAM,CAAC,MAAM,EAAE,iCAAiC,OAAO,CAAC,MAAM,aAAa,EAAE,SAAS,CAAC,CAAC;QAChG,CAAC;QAED,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC,MAAM;gBAAE,SAAS;YAEtB,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;gBACxB,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,gBAAgB,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;YAC3F,CAAC;YAED,IAAI,MAAM,CAAC,UAAU,IAAI,GAAG,IAAI,MAAM,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;gBACxD,UAAU,EAAE,CAAC;gBACb,YAAY,IAAI,MAAM,CAAC,OAAO,CAAC;gBAE/B,IAAI,OAAO,GAAG,eAAe,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAE7D,IAAI,MAAM,CAAC,OAAO,IAAI,YAAY,EAAE,CAAC;oBACnC,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;wBACxB,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,8BAA8B,YAAY,aAAa,EAAE,SAAS,CAAC,CAAC;oBACtH,CAAC;oBAED,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAC3C,OAAO,EACP,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,UAAU,EAAE,YAAY,EAAE,EAC3F,YAAY,CACb,CAAC;oBACF,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;oBAE5B,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;wBACxB,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,oBAAoB,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,EAAE,EAAE,SAAS,CAAC,CAAC;oBACjI,CAAC;gBACH,CAAC;gBAED,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;gBAClC,QAAQ,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,GAAG,OAAO,OAAO,EAAE,CAAC,CAAC;YAClD,CAAC;iBAAM,CAAC;gBACN,MAAM,EAAE,CAAC;gBACT,QAAQ,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,GAAG,2BAA2B,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;gBAE3E,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;oBACxB,MAAM,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,aAAa,MAAM,CAAC,UAAU,EAAE,EAAE,SAAS,CAAC,CAAC;gBAChG,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAE7C,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;YACxB,MAAM,MAAM,CAAC,MAAM,EAAE,cAAc,UAAU,gBAAgB,MAAM,YAAY,YAAY,eAAe,EAAE,SAAS,CAAC,CAAC;QACzH,CAAC;QAED,MAAM,gBAAgB,GAAG,yBAAyB,YAAY,CAAC,cAAc,EAAE,gBAAgB,MAAM,CAAC,IAAI,CAAC,MAAM,UAAU,OAAO,CAAC,iBAAiB,CAAC,cAAc,EAAE,gBAAgB,CAAC;QACtL,MAAM,YAAY,GAAG,iBAAiB,UAAU,mBAAmB,MAAM,gBAAgB,YAAY,YAAY,CAAC;QAClH,MAAM,gBAAgB,GAAG,sBAAsB,MAAM,CAAC,IAAI,CAAC,MAAM,aAAa,gBAAgB,KAAK,YAAY,cAAc,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAE5J,MAAM,QAAQ,GAAG;YACf,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;YAC9B,UAAU;YACV,MAAM;YACN,aAAa,EAAE,YAAY;YAC3B,iBAAiB,EAAE,aAAa;YAChC,cAAc,EAAE,YAAY;YAC5B,kBAAkB,EAAE,OAAO,CAAC,iBAAiB;YAC7C,iBAAiB,EAAE,YAAY;SAChC,CAAC;QAEF,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,EAAE,CAAC;IACnG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE5E,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;YACxB,MAAM,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAE7C,OAAO;YACL,OAAO,EAAE,0BAA0B,YAAY,EAAE;YACjD,iBAAiB,EAAE;gBACjB,OAAO,EAAE,0BAA0B,YAAY,EAAE;gBACjD,QAAQ,EAAE;oBACR,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;oBAC9B,UAAU,EAAE,CAAC;oBACb,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;oBAC1B,aAAa,EAAE,CAAC;oBAChB,iBAAiB,EAAE,aAAa;iBACjC;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/search.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Web Search Tool Handler
+ */
+import type { WebSearchParams, WebSearchOutput } from '../schemas/web-search.js';
+interface ToolOptions {
+    sessionId?: string;
+    logger?: (level: 'info' | 'error' | 'debug', message: string, sessionId: string) => Promise<void>;
+}
+export declare function handleWebSearch(params: WebSearchParams, options?: ToolOptions): Promise<{
+    content: string;
+    structuredContent: WebSearchOutput;
+}>;
+export {};
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAWjF,UAAU,WAAW;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnG;AASD,wBAAsB,eAAe,CACnC,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,eAAe,CAAA;CAAE,CAAC,CA+IlE"}