research-powerpack-mcp 3.0.0

package/dist/clients/search.js

@@ -0,0 +1,91 @@
+/**
+ * Web Search Client
+ * Generic interface for web search via Google (Serper implementation)
+ */
+import { parseEnv } from '../config/index.js';
+export class SearchClient {
+    apiKey;
+    baseURL = 'https://google.serper.dev';
+    constructor(apiKey) {
+        const env = parseEnv();
+        this.apiKey = apiKey || env.SEARCH_API_KEY || '';
+        if (!this.apiKey) {
+            throw new Error('SERPER_API_KEY is required for search functionality');
+        }
+    }
+    /**
+     * Search multiple keywords in parallel
+     */
+    async searchMultiple(keywords) {
+        const startTime = Date.now();
+        try {
+            const searchQueries = keywords.map(keyword => ({ q: keyword }));
+            const response = await fetch(`${this.baseURL}/search`, {
+                method: 'POST',
+                headers: {
+                    'X-API-KEY': this.apiKey,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(searchQueries),
+            });
+            if (!response.ok) {
+                const errorText = await response.text().catch(() => '');
+                throw new Error(`Search API error: ${response.status} ${errorText}`);
+            }
+            const data = await response.json();
+            const responses = Array.isArray(data) ? data : [data];
+            const searches = responses.map((resp, index) => {
+                const organic = (resp.organic || []);
+                const results = organic.map((item, idx) => ({
+                    title: item.title || 'No title',
+                    link: item.link || '#',
+                    snippet: item.snippet || '',
+                    date: item.date,
+                    position: item.position || idx + 1,
+                }));
+                const searchInfo = resp.searchInformation;
+                const totalResults = searchInfo?.totalResults
+                    ? parseInt(String(searchInfo.totalResults).replace(/,/g, ''), 10)
+                    : results.length;
+                const relatedSearches = (resp.relatedSearches || []);
+                const related = relatedSearches.map((r) => r.query || '');
+                return { keyword: keywords[index] || '', results, totalResults, related };
+            });
+            return { searches, totalKeywords: keywords.length, executionTime: Date.now() - startTime };
+        }
+        catch (error) {
+            throw new Error(`Failed to search: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Search Reddit via Google (adds site:reddit.com automatically)
+     */
+    async searchReddit(query, dateAfter) {
+        let q = /site:\s*reddit\.com/i.test(query) ? query : `${query} site:reddit.com`;
+        if (dateAfter) {
+            q += ` after:${dateAfter}`;
+        }
+        const res = await fetch(`${this.baseURL}/search`, {
+            method: 'POST',
+            headers: { 'X-API-KEY': this.apiKey, 'Content-Type': 'application/json' },
+            body: JSON.stringify({ q, num: 10 }),
+        });
+        if (!res.ok)
+            throw new Error(`Search error: ${res.status}`);
+        const data = await res.json();
+        return (data.organic || []).map((r) => ({
+            title: r.title.replace(/ : r\/\w+$/, '').replace(/ - Reddit$/, ''),
+            url: r.link,
+            snippet: r.snippet,
+            date: r.date,
+        }));
+    }
+    /**
+     * Search Reddit with multiple queries in parallel
+     */
+    async searchRedditMultiple(queries, dateAfter) {
+        const results = await Promise.all(queries.map(q => this.searchReddit(q, dateAfter).catch(() => [])));
+        return new Map(queries.map((q, i) => [q, results[i]]));
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/clients/search.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Consolidated configuration
+ * All environment variables, constants, and LLM config in one place
+ */
+export interface EnvConfig {
+    SCRAPER_API_KEY: string;
+    SEARCH_API_KEY: string | undefined;
+    REDDIT_CLIENT_ID: string | undefined;
+    REDDIT_CLIENT_SECRET: string | undefined;
+}
+export declare function parseEnv(): EnvConfig;
+export declare const RESEARCH: {
+    readonly BASE_URL: string;
+    readonly MODEL: string;
+    readonly API_KEY: string;
+    readonly TIMEOUT_MS: number;
+    readonly REASONING_EFFORT: "low" | "medium" | "high";
+    readonly MAX_URLS: number;
+};
+export declare const SERVER: {
+    readonly NAME: "research-powerpack-mcp";
+    readonly VERSION: "3.0.0";
+    readonly DESCRIPTION: "The ultimate research MCP toolkit with modular capabilities";
+};
+export interface Capabilities {
+    reddit: boolean;
+    search: boolean;
+    scraping: boolean;
+    deepResearch: boolean;
+    llmExtraction: boolean;
+}
+export declare function getCapabilities(): Capabilities;
+export declare function getMissingEnvMessage(capability: keyof Capabilities): string;
+export declare const SCRAPER: {
+    readonly MAX_CONCURRENT: 30;
+    readonly BATCH_SIZE: 30;
+    readonly MAX_TOKENS_BUDGET: 32000;
+    readonly MIN_URLS: 3;
+    readonly MAX_URLS: 50;
+    readonly RETRY_COUNT: 3;
+    readonly RETRY_DELAYS: readonly [2000, 4000, 8000];
+    readonly EXTRACTION_SUFFIX: "Try to answer this information as comprehensive as possible while keeping info density super high without adding unnecessary words but satisfy the scope defined by previous instructions even more.";
+};
+export declare const REDDIT: {
+    readonly MAX_CONCURRENT: 10;
+    readonly BATCH_SIZE: 10;
+    readonly MAX_COMMENT_BUDGET: 1000;
+    readonly MAX_COMMENTS_PER_POST: 200;
+    readonly MIN_POSTS: 2;
+    readonly MAX_POSTS: 50;
+    readonly RETRY_COUNT: 5;
+    readonly RETRY_DELAYS: readonly [2000, 4000, 8000, 16000, 32000];
+};
+export declare const CTR_WEIGHTS: Record<number, number>;
+export declare const LLM_EXTRACTION: {
+    readonly MODEL: string;
+    readonly MAX_TOKENS: 4000;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,SAAS;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,wBAAgB,QAAQ,IAAI,SAAS,CAOpC;AAMD,eAAO,MAAM,QAAQ;;;;;;;CAOX,CAAC;AAMX,eAAO,MAAM,MAAM;;;;CAIT,CAAC;AAMX,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,eAAe,IAAI,YAAY,CAS9C;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,YAAY,GAAG,MAAM,CAS3E;AAMD,eAAO,MAAM,OAAO;;;;;;;;;CASV,CAAC;AAMX,eAAO,MAAM,MAAM;;;;;;;;;CAST,CAAC;AAMX,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAWrC,CAAC;AAMX,eAAO,MAAM,cAAc;;;CAGjB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,100 @@
+/**
+ * Consolidated configuration
+ * All environment variables, constants, and LLM config in one place
+ */
+export function parseEnv() {
+    return {
+        SCRAPER_API_KEY: process.env.SCRAPEDO_API_KEY || '',
+        SEARCH_API_KEY: process.env.SERPER_API_KEY || undefined,
+        REDDIT_CLIENT_ID: process.env.REDDIT_CLIENT_ID || undefined,
+        REDDIT_CLIENT_SECRET: process.env.REDDIT_CLIENT_SECRET || undefined,
+    };
+}
+// ============================================================================
+// Research API Configuration
+// ============================================================================
+export const RESEARCH = {
+    BASE_URL: process.env.OPENROUTER_BASE_URL || 'https://openrouter.ai/api/v1',
+    MODEL: process.env.RESEARCH_MODEL || 'perplexity/sonar-deep-research',
+    API_KEY: process.env.OPENROUTER_API_KEY || '',
+    TIMEOUT_MS: parseInt(process.env.API_TIMEOUT_MS || '1800000', 10),
+    REASONING_EFFORT: process.env.DEFAULT_REASONING_EFFORT || 'high',
+    MAX_URLS: parseInt(process.env.DEFAULT_MAX_URLS || '100', 10),
+};
+// ============================================================================
+// MCP Server Configuration
+// ============================================================================
+export const SERVER = {
+    NAME: 'research-powerpack-mcp',
+    VERSION: '3.0.0',
+    DESCRIPTION: 'The ultimate research MCP toolkit with modular capabilities',
+};
+export function getCapabilities() {
+    const env = parseEnv();
+    return {
+        reddit: !!(env.REDDIT_CLIENT_ID && env.REDDIT_CLIENT_SECRET),
+        search: !!env.SEARCH_API_KEY,
+        scraping: !!env.SCRAPER_API_KEY,
+        deepResearch: !!RESEARCH.API_KEY,
+        llmExtraction: !!RESEARCH.API_KEY, // Reuses OPENROUTER for LLM extraction
+    };
+}
+export function getMissingEnvMessage(capability) {
+    const messages = {
+        reddit: '❌ **Reddit tools unavailable.** Set `REDDIT_CLIENT_ID` and `REDDIT_CLIENT_SECRET` to enable.\n\n👉 Create a Reddit app at: https://www.reddit.com/prefs/apps (select "script" type)',
+        search: '❌ **Search unavailable.** Set `SERPER_API_KEY` to enable web search and Reddit search.\n\n👉 Get your free API key at: https://serper.dev (2,500 free queries)',
+        scraping: '❌ **Web scraping unavailable.** Set `SCRAPEDO_API_KEY` to enable URL content extraction.\n\n👉 Sign up at: https://scrape.do (1,000 free credits)',
+        deepResearch: '❌ **Deep research unavailable.** Set `OPENROUTER_API_KEY` to enable AI-powered research.\n\n👉 Get your API key at: https://openrouter.ai/keys',
+        llmExtraction: '⚠️ **AI extraction disabled.** The `use_llm` and `what_to_extract` features require `OPENROUTER_API_KEY`.\n\nScraping will work but without intelligent content filtering.',
+    };
+    return messages[capability];
+}
+// ============================================================================
+// Scraper Configuration (Scrape.do implementation)
+// ============================================================================
+export const SCRAPER = {
+    MAX_CONCURRENT: 30,
+    BATCH_SIZE: 30,
+    MAX_TOKENS_BUDGET: 32000,
+    MIN_URLS: 3,
+    MAX_URLS: 50,
+    RETRY_COUNT: 3,
+    RETRY_DELAYS: [2000, 4000, 8000],
+    EXTRACTION_SUFFIX: 'Try to answer this information as comprehensive as possible while keeping info density super high without adding unnecessary words but satisfy the scope defined by previous instructions even more.',
+};
+// ============================================================================
+// Reddit Configuration
+// ============================================================================
+export const REDDIT = {
+    MAX_CONCURRENT: 10,
+    BATCH_SIZE: 10,
+    MAX_COMMENT_BUDGET: 1000,
+    MAX_COMMENTS_PER_POST: 200,
+    MIN_POSTS: 2,
+    MAX_POSTS: 50,
+    RETRY_COUNT: 5,
+    RETRY_DELAYS: [2000, 4000, 8000, 16000, 32000],
+};
+// ============================================================================
+// CTR Weights for URL Ranking
+// ============================================================================
+export const CTR_WEIGHTS = {
+    1: 100.00,
+    2: 60.00,
+    3: 48.89,
+    4: 33.33,
+    5: 28.89,
+    6: 26.44,
+    7: 24.44,
+    8: 17.78,
+    9: 13.33,
+    10: 12.56,
+};
+// ============================================================================
+// LLM Extraction Model (uses OPENROUTER for scrape_links AI extraction)
+// ============================================================================
+export const LLM_EXTRACTION = {
+    MODEL: process.env.LLM_EXTRACTION_MODEL || 'anthropic/claude-3.5-sonnet',
+    MAX_TOKENS: 4000,
+};
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { TOOLS } from './tools/definitions.js';
+import { handleSearchReddit, handleGetRedditPosts } from './tools/reddit.js';
+import { handleDeepResearch } from './tools/research.js';
+import { handleScrapeLinks } from './tools/scrape.js';
+import { handleWebSearch } from './tools/search.js';
+import { deepResearchParamsSchema } from './schemas/deep-research.js';
+import { scrapeLinksParamsSchema } from './schemas/scrape-links.js';
+import { webSearchParamsSchema } from './schemas/web-search.js';
+import { createSimpleError } from './utils/errors.js';
+import { parseEnv, SERVER, getCapabilities, getMissingEnvMessage } from './config/index.js';
+// ============================================================================
+// Capability Detection (no ENV required - tools fail gracefully when called)
+// ============================================================================
+const env = parseEnv();
+const capabilities = getCapabilities();
+// Log available capabilities for debugging
+const enabledTools = [];
+const disabledTools = [];
+if (capabilities.search) {
+    enabledTools.push('web_search', 'search_reddit');
+}
+else {
+    disabledTools.push('web_search', 'search_reddit');
+}
+if (capabilities.reddit) {
+    enabledTools.push('get_reddit_post');
+}
+else {
+    disabledTools.push('get_reddit_post');
+}
+if (capabilities.scraping) {
+    enabledTools.push('scrape_links');
+}
+else {
+    disabledTools.push('scrape_links');
+}
+if (capabilities.deepResearch) {
+    enabledTools.push('deep_research');
+}
+else {
+    disabledTools.push('deep_research');
+}
+if (enabledTools.length > 0) {
+    console.error(`✅ Enabled tools: ${enabledTools.join(', ')}`);
+}
+if (disabledTools.length > 0) {
+    console.error(`⚠️ Disabled tools (missing ENV): ${disabledTools.join(', ')}`);
+}
+if (capabilities.scraping && !capabilities.llmExtraction) {
+    console.error(`ℹ️ scrape_links: AI extraction (use_llm) disabled - set OPENROUTER_API_KEY to enable`);
+}
+// ============================================================================
+// Server Setup
+// ============================================================================
+const server = new Server({ name: SERVER.NAME, version: SERVER.VERSION }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        // ========== SEARCH_REDDIT ==========
+        if (name === 'search_reddit') {
+            // Check capability
+            if (!capabilities.search) {
+                return { content: [{ type: 'text', text: getMissingEnvMessage('search') }], isError: true };
+            }
+            const { queries, date_after } = args;
+            if (!Array.isArray(queries) || queries.length === 0) {
+                return { content: [{ type: 'text', text: 'Error: queries must be a non-empty array of strings' }], isError: true };
+            }
+            const result = await handleSearchReddit(queries, env.SEARCH_API_KEY, date_after);
+            return { content: [{ type: 'text', text: result }] };
+        }
+        // ========== GET_REDDIT_POST ==========
+        if (name === 'get_reddit_post') {
+            // Check capability
+            if (!capabilities.reddit) {
+                return { content: [{ type: 'text', text: getMissingEnvMessage('reddit') }], isError: true };
+            }
+            const { urls, max_comments = 100, fetch_comments = true } = args;
+            if (!Array.isArray(urls) || urls.length === 0) {
+                return { content: [{ type: 'text', text: 'Error: urls must be a non-empty array of Reddit post URLs' }], isError: true };
+            }
+            const result = await handleGetRedditPosts(urls, env.REDDIT_CLIENT_ID, env.REDDIT_CLIENT_SECRET, max_comments, {
+                fetchComments: fetch_comments,
+                maxCommentsOverride: max_comments !== 100 ? max_comments : undefined,
+            });
+            return { content: [{ type: 'text', text: result }] };
+        }
+        // ========== DEEP_RESEARCH ==========
+        if (name === 'deep_research') {
+            // Check capability
+            if (!capabilities.deepResearch) {
+                return { content: [{ type: 'text', text: getMissingEnvMessage('deepResearch') }], isError: true };
+            }
+            const validatedParams = deepResearchParamsSchema.parse(args);
+            const { content, structuredContent } = await handleDeepResearch(validatedParams);
+            if (structuredContent && typeof structuredContent === 'object' && 'error' in structuredContent && structuredContent.error) {
+                return { content: [{ type: 'text', text: content }], isError: true };
+            }
+            return { content: [{ type: 'text', text: content }] };
+        }
+        // ========== SCRAPE_LINKS ==========
+        if (name === 'scrape_links') {
+            // Check capability
+            if (!capabilities.scraping) {
+                return { content: [{ type: 'text', text: getMissingEnvMessage('scraping') }], isError: true };
+            }
+            const validatedParams = scrapeLinksParamsSchema.parse(args);
+            // Warn if use_llm requested but LLM not available
+            if (validatedParams.use_llm && !capabilities.llmExtraction) {
+                console.error('[scrape_links] use_llm requested but OPENROUTER_API_KEY not set - proceeding without AI extraction');
+                validatedParams.use_llm = false;
+            }
+            const { content, structuredContent } = await handleScrapeLinks(validatedParams);
+            if (structuredContent.metadata.failed === structuredContent.metadata.total_urls) {
+                return { content: [{ type: 'text', text: content }], isError: true };
+            }
+            return { content: [{ type: 'text', text: content }] };
+        }
+        // ========== WEB_SEARCH ==========
+        if (name === 'web_search') {
+            // Check capability
+            if (!capabilities.search) {
+                return { content: [{ type: 'text', text: getMissingEnvMessage('search') }], isError: true };
+            }
+            const validatedParams = webSearchParamsSchema.parse(args);
+            const { content, structuredContent } = await handleWebSearch(validatedParams);
+            if (structuredContent.metadata.total_results === 0) {
+                return { content: [{ type: 'text', text: content }], isError: true };
+            }
+            return { content: [{ type: 'text', text: content }] };
+        }
+        return { content: [{ type: 'text', text: `⚠️ **Unknown tool:** \`${name}\`\n\nAvailable tools: search_reddit, get_reddit_post, deep_research, scrape_links, web_search` }], isError: true };
+    }
+    catch (error) {
+        const simpleError = createSimpleError(error);
+        // Format error as helpful markdown
+        const errorText = `## ❌ Error\n\n**${simpleError.code}:** ${simpleError.message}\n\nPlease check your input parameters and try again.`;
+        return { content: [{ type: 'text', text: errorText }], isError: true };
+    }
+});
+// ============================================================================
+// Start Server
+// ============================================================================
+const transport = new StdioServerTransport();
+server.connect(transport);
+console.error(`🚀 ${SERVER.NAME} v${SERVER.VERSION} ready`);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/schemas/deep-research.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Deep research schema - batch research with dynamic token allocation
+ */
+import { z } from 'zod';
+export declare const deepResearchParamsShape: {
+    questions: z.ZodArray<z.ZodObject<{
+        question: z.ZodString;
+        file_attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            start_line: z.ZodOptional<z.ZodNumber>;
+            end_line: z.ZodOptional<z.ZodNumber>;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+            description?: string | undefined;
+        }, {
+            path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+            description?: string | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        question: string;
+        file_attachments?: {
+            path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+    }, {
+        question: string;
+        file_attachments?: {
+            path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+    }>, "many">;
+};
+export declare const deepResearchParamsSchema: z.ZodObject<{
+    questions: z.ZodArray<z.ZodObject<{
+        question: z.ZodString;
+        file_attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            start_line: z.ZodOptional<z.ZodNumber>;
+            end_line: z.ZodOptional<z.ZodNumber>;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+            description?: string | undefined;
+        }, {
+            path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+            description?: string | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        question: string;
+        file_attachments?: {
+            path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+    }, {
+        question: string;
+        file_attachments?: {
+            path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    questions: {
+        question: string;
+        file_attachments?: {
+            path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+    }[];
+}, {
+    questions: {
+        question: string;
+        file_attachments?: {
+            path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+    }[];
+}>;
+export type DeepResearchParams = z.infer<typeof deepResearchParamsSchema>;
+//# sourceMappingURL=deep-research.d.ts.map

package/dist/schemas/deep-research.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-research.d.ts","sourceRoot":"","sources":["../../src/schemas/deep-research.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCnC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAoC,CAAC;AAC1E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/schemas/deep-research.js

@@ -0,0 +1,57 @@
+/**
+ * Deep research schema - batch research with dynamic token allocation
+ */
+import { z } from 'zod';
+const researchQuestionSchema = z.object({
+    question: z
+        .string()
+        .min(10, 'Research question must be at least 10 characters')
+        .describe('A specific research question with context, scope, and what you need answered.'),
+    file_attachments: z
+        .array(z.object({
+        path: z.string().describe('File path (absolute or relative)'),
+        start_line: z.number().int().positive().optional().describe('Start line (1-indexed)'),
+        end_line: z.number().int().positive().optional().describe('End line (1-indexed)'),
+        description: z.string().optional().describe('What to focus on'),
+    }))
+        .optional()
+        .describe('Optional file attachments for this specific question'),
+});
+export const deepResearchParamsShape = {
+    questions: z
+        .array(researchQuestionSchema)
+        .min(2, 'Minimum 2 research questions required for comprehensive analysis')
+        .max(10, 'Maximum 10 research questions per batch')
+        .describe(`**BATCH 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 (quick multi-topic scan)
+
+**EACH QUESTION SHOULD INCLUDE:**
+1. **Topic & Why:** What you're researching and what decision it informs
+2. **Your Understanding:** What you know (so it fills gaps, not repeats)
+3. **Scope:** Depth needed, format preferred, examples wanted
+4. **Specific Questions:** 2-5 pointed questions you need answered
+
+**BEST PRACTICES:**
+- Use 2-3 questions for deep dives on related topics
+- Use 5-7 questions for broad research across a domain
+- Use 8-10 questions for rapid multi-topic scanning
+- Group related questions together for coherent research
+
+**EXAMPLE:**
+\`\`\`json
+{
+  "questions": [
+    { "question": "What are best practices for MCP server authentication in TypeScript? Cover OAuth2, API keys, session management. Include code examples." },
+    { "question": "How do production MCP servers handle rate limiting and error recovery? Looking for patterns from Anthropic, Microsoft, and community servers." }
+  ]
+}
+\`\`\`
+
+Maximize question count for comprehensive coverage. Each question runs in parallel.`),
+};
+export const deepResearchParamsSchema = z.object(deepResearchParamsShape);
+//# sourceMappingURL=deep-research.js.map

package/dist/schemas/deep-research.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-research.js","sourceRoot":"","sources":["../../src/schemas/deep-research.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,EAAE,kDAAkD,CAAC;SAC3D,QAAQ,CAAC,+EAA+E,CAAC;IAC5F,gBAAgB,EAAE,CAAC;SAChB,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QAC7D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QACrF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACjF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;KAChE,CAAC,CACH;SACA,QAAQ,EAAE;SACV,QAAQ,CAAC,sDAAsD,CAAC;CACpE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,SAAS,EAAE,CAAC;SACT,KAAK,CAAC,sBAAsB,CAAC;SAC7B,GAAG,CAAC,CAAC,EAAE,kEAAkE,CAAC;SAC1E,GAAG,CAAC,EAAE,EAAE,yCAAyC,CAAC;SAClD,QAAQ,CACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oFA6B8E,CAC/E;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC"}

package/dist/schemas/scrape-links.d.ts

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+export declare const scrapeLinksParamsShape: {
+    urls: z.ZodArray<z.ZodString, "many">;
+    timeout: z.ZodDefault<z.ZodNumber>;
+    use_llm: z.ZodDefault<z.ZodBoolean>;
+    what_to_extract: z.ZodOptional<z.ZodString>;
+};
+export declare const scrapeLinksParamsSchema: z.ZodObject<{
+    urls: z.ZodArray<z.ZodString, "many">;
+    timeout: z.ZodDefault<z.ZodNumber>;
+    use_llm: z.ZodDefault<z.ZodBoolean>;
+    what_to_extract: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    urls: string[];
+    timeout: number;
+    use_llm: boolean;
+    what_to_extract?: string | undefined;
+}, {
+    urls: string[];
+    timeout?: number | undefined;
+    use_llm?: boolean | undefined;
+    what_to_extract?: string | undefined;
+}>;
+export type ScrapeLinksParams = z.infer<typeof scrapeLinksParamsSchema>;
+export interface ScrapeLinksOutput {
+    content: string;
+    metadata: {
+        total_urls: number;
+        successful: number;
+        failed: number;
+        total_credits: number;
+        execution_time_ms: number;
+        tokens_per_url?: number;
+        total_token_budget?: number;
+        batches_processed?: number;
+    };
+}
+//# sourceMappingURL=scrape-links.d.ts.map

package/dist/schemas/scrape-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrape-links.d.ts","sourceRoot":"","sources":["../../src/schemas/scrape-links.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,sBAAsB;;;;;CAqBlC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAAmC,CAAC;AACxE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAGxE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH"}