mcp-researchpowerpack 3.6.9

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;;;GAGG;AA0DH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CA6CjB;AAMD,UAAU,qBAAqB;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAyBD,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,CAmHjB"}

package/dist/tools/reddit.js

@@ -0,0 +1,213 @@
+/**
+ * Reddit Tools - Search and Fetch
+ * NEVER throws - always returns structured response for graceful degradation
+ */
+import { SearchClient } from '../clients/search.js';
+import { RedditClient, calculateCommentAllocation } from '../clients/reddit.js';
+import { aggregateAndRankReddit, generateRedditEnhancedOutput } from '../utils/url-aggregator.js';
+import { REDDIT } from '../config/index.js';
+import { classifyError } from '../utils/errors.js';
+import { createLLMProcessor, processContentWithLLM } from '../services/llm-processor.js';
+import { getToolConfig } from '../config/loader.js';
+import { mcpLog, formatSuccess, formatError, formatBatchHeader, TOKEN_BUDGETS, } from './utils.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) {
+    try {
+        const limited = queries.slice(0, 50);
+        const client = new SearchClient(apiKey);
+        const results = await client.searchRedditMultiple(limited, dateAfter);
+        // Check if any results were found
+        let totalResults = 0;
+        for (const items of results.values()) {
+            totalResults += items.length;
+        }
+        if (totalResults === 0) {
+            return formatError({
+                code: 'NO_RESULTS',
+                message: `No results found for any of the ${limited.length} queries`,
+                toolName: 'search_reddit',
+                howToFix: [
+                    'Try broader or simpler search terms',
+                    'Check spelling of technical terms',
+                    'Remove date filters if using them',
+                ],
+                alternatives: [
+                    'web_search(keywords=[...]) for general web results',
+                    'deep_research(questions=[...]) for synthesized analysis',
+                ],
+            });
+        }
+        // Aggregate and rank results by CTR
+        const aggregation = aggregateAndRankReddit(results, 3);
+        // Generate enhanced output with consensus highlighting AND per-query raw results
+        return generateRedditEnhancedOutput(aggregation, limited, results);
+    }
+    catch (error) {
+        const structuredError = classifyError(error);
+        return formatError({
+            code: structuredError.code,
+            message: structuredError.message,
+            retryable: structuredError.retryable,
+            toolName: 'search_reddit',
+            howToFix: ['Verify SERPER_API_KEY is set correctly'],
+            alternatives: ['web_search(keywords=[...]) as backup'],
+        });
+    }
+}
+// Get extraction suffix from YAML config (fallback to hardcoded if not found)
+function getExtractionSuffix() {
+    const config = getToolConfig('get_reddit_post');
+    return config?.limits?.extraction_suffix || `
+---
+
+⚠️ IMPORTANT: Extract and synthesize the key insights, opinions, and recommendations from these Reddit discussions. Focus on:
+- Common themes and consensus across posts
+- Specific recommendations with context
+- Contrasting viewpoints and debates
+- Real-world experiences and lessons learned
+- Technical details and implementation tips
+
+Be comprehensive but concise. Prioritize actionable insights.
+
+---`;
+}
+function enhanceExtractionInstruction(instruction) {
+    const base = instruction || 'Extract key insights, recommendations, and community consensus from these Reddit discussions.';
+    return `${base}\n\n${getExtractionSuffix()}`;
+}
+export async function handleGetRedditPosts(urls, clientId, clientSecret, maxComments = 100, options = {}) {
+    try {
+        const { fetchComments = true, maxCommentsOverride, use_llm = false, what_to_extract } = options;
+        if (urls.length < REDDIT.MIN_POSTS) {
+            return formatError({
+                code: 'MIN_POSTS',
+                message: `Minimum ${REDDIT.MIN_POSTS} Reddit posts required. Received: ${urls.length}`,
+                toolName: 'get_reddit_post',
+                howToFix: [`Add at least ${REDDIT.MIN_POSTS - urls.length} more Reddit URL(s)`],
+            });
+        }
+        if (urls.length > REDDIT.MAX_POSTS) {
+            return formatError({
+                code: 'MAX_POSTS',
+                message: `Maximum ${REDDIT.MAX_POSTS} Reddit posts allowed. Received: ${urls.length}`,
+                toolName: 'get_reddit_post',
+                howToFix: [`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;
+        // Initialize LLM processor if needed
+        const llmProcessor = use_llm ? createLLMProcessor() : null;
+        const tokensPerUrl = use_llm ? Math.floor(TOKEN_BUDGETS.RESEARCH / urls.length) : 0;
+        const enhancedInstruction = use_llm ? enhanceExtractionInstruction(what_to_extract) : undefined;
+        let successful = 0;
+        let failed = 0;
+        let llmErrors = 0;
+        const contents = [];
+        for (const [url, result] of results) {
+            if (result instanceof Error) {
+                failed++;
+                contents.push(`## ❌ Failed: ${url}\n\n_${result.message}_`);
+            }
+            else {
+                successful++;
+                let postContent = formatPost(result, fetchComments);
+                // Apply LLM extraction per-URL if enabled
+                if (use_llm && llmProcessor) {
+                    mcpLog('info', `[${successful}/${urls.length}] Applying LLM extraction to ${url}`, 'reddit');
+                    const llmResult = await processContentWithLLM(postContent, { use_llm: true, what_to_extract: enhancedInstruction, max_tokens: tokensPerUrl }, llmProcessor);
+                    if (llmResult.processed) {
+                        postContent = `## LLM Analysis: ${result.post.title}\n\n**r/${result.post.subreddit}** • u/${result.post.author} • ⬆️ ${result.post.score} • 💬 ${result.post.commentCount} comments\n🔗 ${result.post.url}\n\n${llmResult.content}`;
+                        mcpLog('debug', `[${successful}/${urls.length}] LLM extraction complete`, 'reddit');
+                    }
+                    else {
+                        llmErrors++;
+                        mcpLog('warning', `[${successful}/${urls.length}] LLM extraction failed: ${llmResult.error || 'unknown'}`, 'reddit');
+                    }
+                }
+                contents.push(postContent);
+            }
+        }
+        // Build 70/20/10 response
+        const batchHeader = formatBatchHeader({
+            title: `Reddit Posts`,
+            totalItems: urls.length,
+            successful,
+            failed,
+            ...(fetchComments ? { extras: { 'Comments/post': commentsPerPost } } : {}),
+            ...(use_llm ? { tokensPerItem: tokensPerUrl } : {}),
+            batches: totalBatches,
+        });
+        const statusExtras = [];
+        if (batchResult.rateLimitHits > 0) {
+            statusExtras.push(`⚠️ ${batchResult.rateLimitHits} rate limit retries`);
+        }
+        if (use_llm && !llmProcessor) {
+            statusExtras.push('⚠️ LLM unavailable (OPENROUTER_API_KEY not set)');
+        }
+        else if (llmErrors > 0) {
+            statusExtras.push(`⚠️ ${llmErrors} LLM extraction failures`);
+        }
+        const nextSteps = [
+            successful > 0 ? 'Research further: deep_research(questions=[{question: "Based on Reddit discussion..."}])' : null,
+            failed > 0 ? 'Retry failed URLs individually' : null,
+            'Search related topics: search_reddit(queries=[...related terms...])',
+        ].filter(Boolean);
+        const extraStatus = statusExtras.length > 0 ? `\n${statusExtras.join(' | ')}` : '';
+        return formatSuccess({
+            title: `Reddit Posts Fetched (${successful}/${urls.length})`,
+            summary: batchHeader + extraStatus,
+            data: contents.join('\n\n---\n\n'),
+            nextSteps,
+        });
+    }
+    catch (error) {
+        const structuredError = classifyError(error);
+        return formatError({
+            code: structuredError.code,
+            message: structuredError.message,
+            retryable: structuredError.retryable,
+            toolName: 'get_reddit_post',
+            howToFix: ['Verify REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET are set'],
+        });
+    }
+}
+//# 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/registry.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Handler Registry - Central tool registration and execution
+ * Eliminates repetitive if/else routing with declarative registration
+ */
+import { z } from 'zod';
+import { type Capabilities } from '../config/index.js';
+/**
+ * MCP-compliant tool result with index signature for SDK compatibility
+ */
+export interface CallToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Configuration for a registered tool
+ */
+export interface ToolRegistration {
+    name: string;
+    capability?: keyof Capabilities;
+    schema: z.ZodSchema;
+    handler: (params: unknown) => Promise<string>;
+    postValidate?: (params: unknown) => string | undefined;
+    transformResponse?: (result: string) => {
+        content: string;
+        isError?: boolean;
+    };
+}
+/**
+ * Registry type
+ */
+export type ToolRegistry = Record<string, ToolRegistration>;
+/**
+ * Central registry of all MCP tools
+ */
+export declare const toolRegistry: ToolRegistry;
+/**
+ * Execute a tool by name with full middleware chain
+ *
+ * Middleware steps:
+ * 1. Lookup tool in registry (throw McpError if not found)
+ * 2. Check capability (return error response if missing)
+ * 3. Validate params with Zod (return error response if invalid)
+ * 4. Execute handler (catch and format any errors)
+ * 5. Transform response if needed
+ *
+ * @param name - Tool name from request
+ * @param args - Raw arguments from request
+ * @param capabilities - Current capabilities from getCapabilities()
+ * @returns MCP-compliant tool result
+ */
+export declare function executeTool(name: string, args: unknown, capabilities: Capabilities): Promise<CallToolResult>;
+/**
+ * Get list of all registered tool names
+ */
+export declare function getRegisteredToolNames(): string[];
+/**
+ * Check if a tool is registered
+ */
+export declare function isToolRegistered(name: string): boolean;
+/**
+ * Get tool capabilities for logging
+ */
+export declare function getToolCapabilities(): {
+    enabled: string[];
+    disabled: string[];
+};
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAY,MAAM,KAAK,CAAC;AAGlC,OAAO,EAAmD,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAkBxG;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,YAAY,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC;IACpB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IACvD,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAChF;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAgF5D;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,YA+C1B,CAAC;AAMF;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,cAAc,CAAC,CAuEzB;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAEjD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAe/E"}

package/dist/tools/registry.js

@@ -0,0 +1,242 @@
+/**
+ * Handler Registry - Central tool registration and execution
+ * Eliminates repetitive if/else routing with declarative registration
+ */
+import { z, ZodError } from 'zod';
+import { McpError, ErrorCode as McpErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { parseEnv, getCapabilities, getMissingEnvMessage } from '../config/index.js';
+import { classifyError, createToolErrorFromStructured } from '../utils/errors.js';
+// Import schemas
+import { deepResearchParamsSchema } from '../schemas/deep-research.js';
+import { scrapeLinksParamsSchema } from '../schemas/scrape-links.js';
+import { webSearchParamsSchema } from '../schemas/web-search.js';
+// Import handlers
+import { handleSearchReddit, handleGetRedditPosts } from './reddit.js';
+import { handleDeepResearch } from './research.js';
+import { handleScrapeLinks } from './scrape.js';
+import { handleWebSearch } from './search.js';
+// ============================================================================
+// Schemas for Simple Tools (inline definitions)
+// ============================================================================
+const searchRedditParamsSchema = z.object({
+    queries: z.array(z.string()).min(10).max(50),
+    date_after: z.string().optional(),
+});
+const getRedditPostParamsSchema = z.object({
+    urls: z.array(z.string()).min(2).max(50),
+    fetch_comments: z.boolean().default(true),
+    max_comments: z.number().default(100),
+    use_llm: z.boolean().default(false),
+    what_to_extract: z.string().optional(),
+});
+// ============================================================================
+// Handler Wrappers
+// ============================================================================
+const env = parseEnv();
+/**
+ * Wrapper for search_reddit handler
+ */
+async function searchRedditHandler(params) {
+    const p = params;
+    return handleSearchReddit(p.queries, env.SEARCH_API_KEY || '', p.date_after);
+}
+/**
+ * Wrapper for get_reddit_post handler
+ */
+async function getRedditPostHandler(params) {
+    const p = params;
+    return handleGetRedditPosts(p.urls, env.REDDIT_CLIENT_ID || '', env.REDDIT_CLIENT_SECRET || '', p.max_comments, {
+        fetchComments: p.fetch_comments,
+        maxCommentsOverride: p.max_comments !== 100 ? p.max_comments : undefined,
+        use_llm: p.use_llm,
+        what_to_extract: p.what_to_extract,
+    });
+}
+/**
+ * Wrapper for deep_research handler
+ */
+async function deepResearchHandler(params) {
+    const { content } = await handleDeepResearch(params);
+    return content;
+}
+/**
+ * Wrapper for scrape_links handler
+ */
+async function scrapeLinksHandler(params) {
+    const { content } = await handleScrapeLinks(params);
+    return content;
+}
+/**
+ * Wrapper for web_search handler
+ */
+async function webSearchHandler(params) {
+    const { content } = await handleWebSearch(params);
+    return content;
+}
+// ============================================================================
+// Tool Registry
+// ============================================================================
+/**
+ * Central registry of all MCP tools
+ */
+export const toolRegistry = {
+    search_reddit: {
+        name: 'search_reddit',
+        capability: 'search',
+        schema: searchRedditParamsSchema,
+        handler: searchRedditHandler,
+    },
+    get_reddit_post: {
+        name: 'get_reddit_post',
+        capability: 'reddit',
+        schema: getRedditPostParamsSchema,
+        handler: getRedditPostHandler,
+    },
+    deep_research: {
+        name: 'deep_research',
+        capability: 'deepResearch',
+        schema: deepResearchParamsSchema,
+        handler: deepResearchHandler,
+        transformResponse: (result) => ({
+            content: result,
+            isError: result.includes('# ❌ Error'),
+        }),
+    },
+    scrape_links: {
+        name: 'scrape_links',
+        capability: 'scraping',
+        schema: scrapeLinksParamsSchema,
+        handler: scrapeLinksHandler,
+        transformResponse: (result) => ({
+            content: result,
+            isError: result.includes('# ❌ Scraping Failed'),
+        }),
+    },
+    web_search: {
+        name: 'web_search',
+        capability: 'search',
+        schema: webSearchParamsSchema,
+        handler: webSearchHandler,
+        transformResponse: (result) => ({
+            content: result,
+            isError: result.includes('# ❌ web_search'),
+        }),
+    },
+};
+// ============================================================================
+// Execute Tool (Main Entry Point)
+// ============================================================================
+/**
+ * Execute a tool by name with full middleware chain
+ *
+ * Middleware steps:
+ * 1. Lookup tool in registry (throw McpError if not found)
+ * 2. Check capability (return error response if missing)
+ * 3. Validate params with Zod (return error response if invalid)
+ * 4. Execute handler (catch and format any errors)
+ * 5. Transform response if needed
+ *
+ * @param name - Tool name from request
+ * @param args - Raw arguments from request
+ * @param capabilities - Current capabilities from getCapabilities()
+ * @returns MCP-compliant tool result
+ */
+export async function executeTool(name, args, capabilities) {
+    // Step 1: Lookup tool
+    const tool = toolRegistry[name];
+    if (!tool) {
+        throw new McpError(McpErrorCode.MethodNotFound, `Method not found: ${name}. Available tools: ${Object.keys(toolRegistry).join(', ')}`);
+    }
+    // Step 2: Check capability
+    if (tool.capability && !capabilities[tool.capability]) {
+        return {
+            content: [{ type: 'text', text: getMissingEnvMessage(tool.capability) }],
+            isError: true,
+        };
+    }
+    // Step 3: Validate params with Zod
+    let validatedParams;
+    try {
+        validatedParams = tool.schema.parse(args);
+    }
+    catch (error) {
+        if (error instanceof ZodError) {
+            const issues = error.issues
+                .map((i) => `- **${i.path.join('.') || 'root'}**: ${i.message}`)
+                .join('\n');
+            return {
+                content: [{ type: 'text', text: `# ❌ Validation Error\n\n${issues}` }],
+                isError: true,
+            };
+        }
+        // Non-Zod validation error
+        const structured = classifyError(error);
+        return createToolErrorFromStructured(structured);
+    }
+    // Step 3.5: Optional post-validation
+    if (tool.postValidate) {
+        const postError = tool.postValidate(validatedParams);
+        if (postError) {
+            return {
+                content: [{ type: 'text', text: `# ❌ Validation Error\n\n${postError}` }],
+                isError: true,
+            };
+        }
+    }
+    // Step 4: Execute handler
+    let result;
+    try {
+        result = await tool.handler(validatedParams);
+    }
+    catch (error) {
+        // Handler threw (shouldn't happen if handlers follow "never throw" pattern)
+        const structured = classifyError(error);
+        return createToolErrorFromStructured(structured);
+    }
+    // Step 5: Transform response
+    if (tool.transformResponse) {
+        const transformed = tool.transformResponse(result);
+        return {
+            content: [{ type: 'text', text: transformed.content }],
+            isError: transformed.isError,
+        };
+    }
+    // Default: success response
+    return {
+        content: [{ type: 'text', text: result }],
+    };
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Get list of all registered tool names
+ */
+export function getRegisteredToolNames() {
+    return Object.keys(toolRegistry);
+}
+/**
+ * Check if a tool is registered
+ */
+export function isToolRegistered(name) {
+    return name in toolRegistry;
+}
+/**
+ * Get tool capabilities for logging
+ */
+export function getToolCapabilities() {
+    const caps = getCapabilities();
+    const enabled = [];
+    const disabled = [];
+    for (const [name, tool] of Object.entries(toolRegistry)) {
+        const capKey = tool.capability;
+        if (!capKey || caps[capKey]) {
+            enabled.push(name);
+        }
+        else {
+            disabled.push(name);
+        }
+    }
+    return { enabled, disabled };
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.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
+ * Implements robust error handling that NEVER crashes
+ */
+import type { DeepResearchParams } from '../schemas/deep-research.js';
+/**
+ * Handle deep research request
+ * NEVER throws - always returns a valid response
+ */
+export declare function handleDeepResearch(params: DeepResearchParams): Promise<{
+    content: string;
+    structuredContent: object;
+}>;
+//# 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;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AA8CtE;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAAC,CA6KzD"}