mcp-researchpowerpack 3.6.9

package/dist/index.js

@@ -0,0 +1,271 @@
+#!/usr/bin/env node
+/**
+ * Research Powerpack MCP Server
+ * Implements robust error handling - server NEVER crashes on tool failures
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { TOOLS } from './tools/definitions.js';
+import { executeTool, getToolCapabilities } from './tools/registry.js';
+import { classifyError, createToolErrorFromStructured } from './utils/errors.js';
+import { SERVER, getCapabilities } from './config/index.js';
+import { initLogger } from './utils/logger.js';
+// ============================================================================
+// Capability Detection (uses registry for tool capability mapping)
+// ============================================================================
+const capabilities = getCapabilities();
+const { enabled: enabledTools, disabled: disabledTools } = getToolCapabilities();
+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: {}, logging: {} } });
+initLogger(server);
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+/**
+ * Tool execution handler - uses registry pattern for clean routing
+ * All capability checks, validation, and error handling are in executeTool
+ */
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        // All routing handled by registry - no more if/else blocks!
+        return await executeTool(name, args, capabilities);
+    }
+    catch (error) {
+        // McpError propagates to client as protocol error
+        if (error instanceof McpError) {
+            throw error;
+        }
+        // Unexpected error - format as tool error
+        const structuredError = classifyError(error);
+        console.error(`[MCP Server] Tool "${name}" error:`, {
+            code: structuredError.code,
+            message: structuredError.message,
+            retryable: structuredError.retryable,
+        });
+        return createToolErrorFromStructured(structuredError);
+    }
+});
+// ============================================================================
+// Global Error Handlers - MUST EXIT on fatal errors per Node.js best practices
+// See: https://nodejs.org/api/process.html#warning-using-uncaughtexception-correctly
+// ============================================================================
+// Track shutdown state to prevent double shutdown
+let isShuttingDown = false;
+/**
+ * Graceful shutdown handler - closes server and exits
+ * @param exitCode - Exit code (0 for clean shutdown, 1 for error)
+ */
+async function gracefulShutdown(exitCode) {
+    if (isShuttingDown)
+        return;
+    isShuttingDown = true;
+    try {
+        await server.close();
+        console.error(`[MCP Server] Server closed at ${new Date().toISOString()}`);
+    }
+    catch (closeError) {
+        console.error('[MCP Server] Error closing server:', closeError);
+    }
+    finally {
+        process.exit(exitCode);
+    }
+}
+/**
+ * Safely extract error information without triggering another exception
+ * Prevents infinite loops when error objects have problematic getters
+ */
+function safeErrorString(error) {
+    try {
+        if (error instanceof Error) {
+            // Try to get message and stack safely
+            const message = String(error.message || 'Unknown error');
+            try {
+                const stack = String(error.stack || '');
+                if (!stack) {
+                    return message;
+                }
+                // Avoid duplicating the message when the stack already includes it
+                return stack.includes(message) ? stack : `${message}\n${stack}`;
+            }
+            catch {
+                return message; // Stack serialization failed, just return message
+            }
+        }
+        return String(error);
+    }
+    catch {
+        // Even String() can fail on some objects
+        return '[Error: Unable to serialize error object]';
+    }
+}
+// Handle uncaught exceptions - MUST EXIT per Node.js docs
+// The VM is in an unstable state after uncaught exception
+process.on('uncaughtException', (error) => {
+    try {
+        console.error(`[MCP Server] FATAL uncaughtException at ${new Date().toISOString()}:`);
+        console.error(safeErrorString(error));
+    }
+    catch {
+        // Even logging failed - just exit
+        console.error('[MCP Server] FATAL uncaughtException (unable to log details)');
+    }
+    gracefulShutdown(1);
+});
+// Handle unhandled promise rejections - MUST EXIT (Node v15+ behavior)
+// Suppressing this risks memory leaks and corrupted state
+process.on('unhandledRejection', (reason) => {
+    try {
+        const error = classifyError(reason);
+        console.error(`[MCP Server] FATAL unhandledRejection at ${new Date().toISOString()}:`);
+        console.error(`  Message: ${error.message}`);
+        console.error(`  Code: ${error.code}`);
+    }
+    catch {
+        // classifyError or logging failed, use safeErrorString as fallback
+        console.error('[MCP Server] FATAL unhandledRejection (unable to classify error):');
+        console.error(safeErrorString(reason));
+    }
+    gracefulShutdown(1);
+});
+// Handle SIGTERM gracefully (Docker/Kubernetes stop signal)
+process.on('SIGTERM', () => {
+    console.error(`[MCP Server] Received SIGTERM at ${new Date().toISOString()}, shutting down gracefully`);
+    gracefulShutdown(0);
+});
+// Handle SIGINT gracefully (Ctrl+C) - use once() to prevent double-fire
+process.once('SIGINT', () => {
+    console.error(`[MCP Server] Received SIGINT at ${new Date().toISOString()}, shutting down gracefully`);
+    gracefulShutdown(0);
+});
+// ============================================================================
+// Stdin disconnect detection
+// The MCP SDK's StdioServerTransport does NOT listen for stdin 'close'/'end'.
+// When the parent process disconnects (closes the pipe), stdin emits these
+// events but nobody handles them — Node.js keeps polling the dead fd at 100%
+// CPU. We fix this by detecting the disconnect and exiting cleanly.
+// ============================================================================
+process.stdin.on('close', () => {
+    console.error(`[MCP Server] stdin closed (parent disconnected) at ${new Date().toISOString()}, shutting down`);
+    gracefulShutdown(0);
+});
+process.stdin.on('end', () => {
+    console.error(`[MCP Server] stdin ended (parent disconnected) at ${new Date().toISOString()}, shutting down`);
+    gracefulShutdown(0);
+});
+// Also handle stdout errors (broken pipe when parent is gone)
+process.stdout.on('error', (err) => {
+    if (err.code === 'EPIPE' || err.code === 'ERR_STREAM_DESTROYED') {
+        console.error(`[MCP Server] stdout broken pipe at ${new Date().toISOString()}, shutting down`);
+        gracefulShutdown(0);
+    }
+});
+// ============================================================================
+// Start Server — STDIO (default) or HTTP Streamable (MCP_TRANSPORT=http)
+// ============================================================================
+const transportMode = (process.env.MCP_TRANSPORT || 'stdio').toLowerCase();
+if (transportMode === 'http') {
+    // HTTP Streamable transport — stateful sessions over HTTP
+    const { StreamableHTTPServerTransport } = await import('@modelcontextprotocol/sdk/server/streamableHttp.js');
+    const { createServer: createHttpServer } = await import('node:http');
+    const { randomUUID } = await import('node:crypto');
+    const PORT = parseInt(process.env.MCP_PORT || '3000', 10);
+    // Map of session ID → transport for multi-session support
+    const sessions = new Map();
+    const httpServer = createHttpServer(async (req, res) => {
+        const url = new URL(req.url || '/', `http://localhost:${PORT}`);
+        // Health check
+        if (url.pathname === '/health') {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ status: 'ok', name: SERVER.NAME, version: SERVER.VERSION }));
+            return;
+        }
+        // MCP endpoint
+        if (url.pathname === '/mcp') {
+            // Handle DELETE — session termination
+            if (req.method === 'DELETE') {
+                const sessionId = req.headers['mcp-session-id'];
+                if (sessionId && sessions.has(sessionId)) {
+                    const transport = sessions.get(sessionId);
+                    await transport.handleRequest(req, res);
+                    sessions.delete(sessionId);
+                }
+                else {
+                    res.writeHead(404).end('Session not found');
+                }
+                return;
+            }
+            // For GET/POST — find existing session or create new one
+            const sessionId = req.headers['mcp-session-id'];
+            if (sessionId && sessions.has(sessionId)) {
+                // Existing session
+                await sessions.get(sessionId).handleRequest(req, res);
+            }
+            else if (!sessionId && req.method === 'POST') {
+                // New session (initialization)
+                const transport = new StreamableHTTPServerTransport({
+                    sessionIdGenerator: () => randomUUID(),
+                    onsessioninitialized: (id) => {
+                        sessions.set(id, transport);
+                        console.error(`[HTTP] Session ${id} initialized`);
+                    },
+                    onsessionclosed: (id) => {
+                        sessions.delete(id);
+                        console.error(`[HTTP] Session ${id} closed`);
+                    },
+                });
+                // Each new transport needs its own server instance connected
+                const sessionServer = new Server({ name: SERVER.NAME, version: SERVER.VERSION }, { capabilities: { tools: {}, logging: {} } });
+                initLogger(sessionServer);
+                sessionServer.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+                sessionServer.setRequestHandler(CallToolRequestSchema, async (request) => {
+                    const { name, arguments: args } = request.params;
+                    try {
+                        return await executeTool(name, args, capabilities);
+                    }
+                    catch (error) {
+                        if (error instanceof McpError)
+                            throw error;
+                        const structuredError = classifyError(error);
+                        console.error(`[HTTP] Tool "${name}" error:`, structuredError.message);
+                        return createToolErrorFromStructured(structuredError);
+                    }
+                });
+                await sessionServer.connect(transport);
+                await transport.handleRequest(req, res);
+            }
+            else {
+                res.writeHead(400).end('Bad request — missing session ID');
+            }
+            return;
+        }
+        res.writeHead(404).end('Not found');
+    });
+    httpServer.listen(PORT, () => {
+        console.error(`🚀 ${SERVER.NAME} v${SERVER.VERSION} listening on http://localhost:${PORT}/mcp`);
+    });
+}
+else {
+    // STDIO transport (default)
+    const transport = new StdioServerTransport();
+    try {
+        server.connect(transport);
+        console.error(`🚀 ${SERVER.NAME} v${SERVER.VERSION} ready (stdio)`);
+    }
+    catch (error) {
+        const err = classifyError(error);
+        console.error(`[MCP Server] Failed to start: ${err.message}`);
+        process.exit(1);
+    }
+}
+//# 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,64 @@
+/**
+ * Deep research schema - batch research with dynamic token allocation
+ * Enhanced with comprehensive prompting for bugs, programming questions, and general research
+ */
+import { z } from 'zod';
+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;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA4OxB,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,224 @@
+/**
+ * Deep research schema - batch research with dynamic token allocation
+ * Enhanced with comprehensive prompting for bugs, programming questions, and general research
+ */
+import { z } from 'zod';
+// File attachment schema with comprehensive descriptions to guide LLM usage
+const fileAttachmentSchema = z.object({
+    path: z
+        .string({ required_error: 'deep_research: File path is required' })
+        .min(1, { message: 'deep_research: File path cannot be empty' })
+        .describe(`**[REQUIRED] Absolute file path to attach.**
+
+⚠️ **YOU MUST USE ABSOLUTE PATHS** - e.g., "/Users/john/project/src/utils/auth.ts" NOT "src/utils/auth.ts"
+
+The file will be read from the filesystem and included as context for the research question. This is CRITICAL for:
+- Bug investigations (attach the failing code)
+- Code reviews (attach the code to review)
+- Refactoring questions (attach current implementation)
+- Architecture decisions (attach relevant modules)
+- Performance issues (attach the slow code path)
+
+**IMPORTANT:** Always use the full absolute path as shown in your IDE or terminal.`),
+    start_line: z
+        .number({ invalid_type_error: 'deep_research: start_line must be a number' })
+        .int({ message: 'deep_research: start_line must be an integer' })
+        .positive({ message: 'deep_research: start_line must be a positive integer (1-indexed)' })
+        .optional()
+        .describe(`**[OPTIONAL] Start line number (1-indexed).**
+
+Use this to focus on a specific section of a large file. If omitted, reads from line 1.
+Example: start_line=50 with end_line=100 reads lines 50-100 only.`),
+    end_line: z
+        .number({ invalid_type_error: 'deep_research: end_line must be a number' })
+        .int({ message: 'deep_research: end_line must be an integer' })
+        .positive({ message: 'deep_research: end_line must be a positive integer (1-indexed)' })
+        .optional()
+        .describe(`**[OPTIONAL] End line number (1-indexed).**
+
+Use this to limit the scope to relevant code sections. If omitted, reads to end of file.
+For large files (>500 lines), consider specifying a range to focus the research.`),
+    description: z
+        .string()
+        .optional()
+        .describe(`**[HIGHLY RECOMMENDED] Comprehensive description of why this file is attached and what to focus on.**
+
+⚠️ **THIS IS CRITICAL FOR EFFECTIVE RESEARCH.** Write a detailed description explaining:
+
+1. **What this file is:** "This is the main authentication middleware that handles JWT validation"
+2. **Why it's relevant:** "The bug occurs when tokens expire during long-running requests"
+3. **What to focus on:** "Pay attention to the refreshToken() function on lines 45-80"
+4. **Known issues/context:** "We suspect the race condition happens in the async validation"
+5. **Related files:** "This interacts with /src/services/token-service.ts for token refresh"
+
+**GOOD EXAMPLE:**
+"This is our Redis caching layer (cache-service.ts). The bug manifests as stale data being returned after cache invalidation. Focus on the invalidatePattern() method (lines 120-150) and how it interacts with the pub/sub mechanism. We're using Redis Cluster and suspect the issue is related to cross-node invalidation timing."
+
+**BAD EXAMPLE:**
+"cache file" ← Too vague, research will be unfocused`),
+});
+// Research question schema with structured template guidance
+const researchQuestionSchema = z.object({
+    question: z
+        .string({ required_error: 'deep_research: Question is required' })
+        .min(10, { message: 'deep_research: Question must be at least 10 characters' })
+        .describe(`**[REQUIRED] Your research question - MUST follow this structured template:**
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📋 **STRUCTURED QUESTION TEMPLATE** (You MUST use this format)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**1. 🎯 WHAT I NEED:**
+[Clearly state what you're trying to achieve, solve, or understand]
+
+**2. 🤔 WHY I'M RESEARCHING THIS:**
+[Explain the context - what decision does this inform? What problem are you solving?]
+
+**3. 📚 WHAT I ALREADY KNOW:**
+[Share your current understanding so research fills gaps, not repeats basics]
+
+**4. 🔧 HOW I PLAN TO USE THIS:**
+[Describe the practical application - implementation, debugging, architecture, etc.]
+
+**5. ❓ SPECIFIC QUESTIONS (2-5):**
+- Question 1: [Specific, pointed question]
+- Question 2: [Another specific question]
+- Question 3: [etc.]
+
+**6. 🌐 PRIORITY SOURCES (optional):**
+[Sites/docs to prioritize: "Prefer official React docs, GitHub issues, Stack Overflow"]
+
+**7. ⚡ PRIORITY INFO (optional):**
+[What matters most: "Focus on performance implications" or "Prioritize security best practices"]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**EXAMPLE FOR BUG INVESTIGATION:**
+"🎯 WHAT I NEED: Debug why our WebSocket connections drop after exactly 60 seconds of inactivity.
+
+🤔 WHY: Production users are losing real-time updates, causing data sync issues and support tickets.
+
+📚 WHAT I KNOW: We use Socket.io v4.6 with Redis adapter. The 60s timeout suggests a proxy/load balancer issue, but we've checked nginx configs.
+
+🔧 HOW I'LL USE THIS: Implement the fix in our connection-manager.ts (attached) and update our deployment configs.
+
+❓ SPECIFIC QUESTIONS:
+1. What are common causes of exactly 60-second WebSocket timeouts?
+2. How should Socket.io heartbeat/ping intervals be configured to prevent this?
+3. Are there AWS ALB-specific settings we need to consider?
+4. How do other production apps handle WebSocket keep-alive?
+
+🌐 PRIORITY: Socket.io official docs, AWS documentation, GitHub issues with similar problems
+
+⚡ FOCUS: Production-ready solutions, not development workarounds"
+
+**EXAMPLE FOR ARCHITECTURE RESEARCH:**
+"🎯 WHAT I NEED: Best practices for implementing CQRS pattern with Event Sourcing in Node.js/TypeScript.
+
+🤔 WHY: Our monolithic API is hitting scaling limits. We need to separate read/write paths for our order processing system.
+
+📚 WHAT I KNOW: Familiar with basic event-driven architecture, used RabbitMQ before. New to full CQRS/ES implementation.
+
+🔧 HOW I'LL USE THIS: Design the new order-service architecture, select appropriate libraries, plan migration strategy.
+
+❓ SPECIFIC QUESTIONS:
+1. What are the recommended Node.js libraries for CQRS/ES? (Pros/cons of each)
+2. How should we handle eventual consistency in read models?
+3. What's the best event store for our scale (~10k events/day)?
+4. How do we handle schema evolution for events over time?
+5. What are common pitfalls teams encounter when adopting CQRS/ES?
+
+🌐 PRIORITY: Microsoft docs (they coined CQRS), Martin Fowler, real-world case studies
+
+⚡ FOCUS: Production patterns, not theoretical explanations. Include code examples."`),
+    file_attachments: z
+        .array(fileAttachmentSchema)
+        .optional()
+        .describe(`**[CRITICAL FOR BUGS/CODE QUESTIONS] File attachments to include as research context.**
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+⚠️ **YOU MUST ATTACH FILES WHEN:**
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+✅ **MANDATORY file attachment scenarios:**
+- 🐛 **Bug investigation** → Attach the buggy code file(s)
+- 🔍 **Code review** → Attach the code to be reviewed
+- ♻️ **Refactoring** → Attach current implementation
+- 🏗️ **Architecture questions about YOUR code** → Attach relevant modules
+- ⚡ **Performance issues** → Attach the slow code paths
+- 🔒 **Security review** → Attach the security-sensitive code
+- 🧪 **Testing questions** → Attach both the code AND test files
+- 🔗 **Integration issues** → Attach files from both sides of the integration
+
+❌ **File attachments NOT needed for:**
+- General concept questions ("What is CQRS?")
+- Technology comparisons ("React vs Vue")
+- Best practices research (unless about your specific code)
+- Documentation lookups
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📎 **HOW TO ATTACH FILES:**
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**Each attachment requires:**
+1. \`path\` (REQUIRED): **Absolute path** like "/Users/dev/project/src/auth.ts"
+2. \`start_line\` (optional): Focus on specific section
+3. \`end_line\` (optional): Limit scope for large files
+4. \`description\` (HIGHLY RECOMMENDED): Explain what this file is and why it matters
+
+**EXAMPLE - Bug with multiple related files:**
+\`\`\`json
+{
+  "question": "🎯 WHAT I NEED: Fix the race condition in our order processing...",
+  "file_attachments": [
+    {
+      "path": "/Users/dev/ecommerce/src/services/order-processor.ts",
+      "description": "Main order processing service. The race condition occurs in processOrder() when two requests hit simultaneously. Lines 45-120 contain the critical section."
+    },
+    {
+      "path": "/Users/dev/ecommerce/src/repositories/inventory-repo.ts",
+      "start_line": 30,
+      "end_line": 80,
+      "description": "Inventory repository - the decrementStock() method (lines 30-80) is called by order-processor and we suspect it's not properly locked."
+    },
+    {
+      "path": "/Users/dev/ecommerce/src/utils/db-transaction.ts",
+      "description": "Our transaction wrapper utility. Need to verify if it properly handles concurrent transactions."
+    }
+  ]
+}
+\`\`\`
+
+**Attach as many files as needed for complete context - there is no limit!**`),
+});
+// Shape object for external consumers who need individual field schemas
+const deepResearchParamsShape = {
+    questions: z
+        .array(researchQuestionSchema, {
+        required_error: 'deep_research: Questions array is required',
+        invalid_type_error: 'deep_research: Questions must be an array'
+    })
+        .min(1, { message: 'deep_research: At least 1 question is required (recommend 2-7 for optimal depth)' })
+        .max(10, { message: 'deep_research: Maximum 10 questions allowed per batch' })
+        .describe(`**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.`),
+};
+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;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,4EAA4E;AAC5E,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC;SACJ,MAAM,CAAC,EAAE,cAAc,EAAE,sCAAsC,EAAE,CAAC;SAClE,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;SAC/D,QAAQ,CACP;;;;;;;;;;;mFAW6E,CAC9E;IACH,UAAU,EAAE,CAAC;SACV,MAAM,CAAC,EAAE,kBAAkB,EAAE,4CAA4C,EAAE,CAAC;SAC5E,GAAG,CAAC,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC;SAChE,QAAQ,CAAC,EAAE,OAAO,EAAE,kEAAkE,EAAE,CAAC;SACzF,QAAQ,EAAE;SACV,QAAQ,CACP;;;kEAG4D,CAC7D;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC,EAAE,kBAAkB,EAAE,0CAA0C,EAAE,CAAC;SAC1E,GAAG,CAAC,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC;SAC9D,QAAQ,CAAC,EAAE,OAAO,EAAE,gEAAgE,EAAE,CAAC;SACvF,QAAQ,EAAE;SACV,QAAQ,CACP;;;iFAG2E,CAC5E;IACH,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP;;;;;;;;;;;;;;qDAc+C,CAChD;CACJ,CAAC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC,EAAE,cAAc,EAAE,qCAAqC,EAAE,CAAC;SACjE,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,wDAAwD,EAAE,CAAC;SAC9E,QAAQ,CACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oFAoE8E,CAC/E;IACH,gBAAgB,EAAE,CAAC;SAChB,KAAK,CAAC,oBAAoB,CAAC;SAC3B,QAAQ,EAAE;SACV,QAAQ,CACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6EAuDuE,CACxE;CACJ,CAAC,CAAC;AAEH,wEAAwE;AACxE,MAAM,uBAAuB,GAAG;IAC9B,SAAS,EAAE,CAAC;SACT,KAAK,CAAC,sBAAsB,EAAE;QAC7B,cAAc,EAAE,4CAA4C;QAC5D,kBAAkB,EAAE,2CAA2C;KAChE,CAAC;SACD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,kFAAkF,EAAE,CAAC;SACvG,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,uDAAuD,EAAE,CAAC;SAC7E,QAAQ,CACP;;;;;;;;;;;;;;;;;;2IAkBqI,CACtI;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,32 @@
+import { z } from 'zod';
+export declare const scrapeLinksParamsSchema: z.ZodObject<{
+    urls: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "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;AAsCxB,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"}

package/dist/schemas/scrape-links.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+// URL schema with protocol validation
+const urlSchema = z
+    .string({ required_error: 'scrape_links: URL is required' })
+    .url({ message: 'scrape_links: Invalid URL format' })
+    .refine(url => url.startsWith('http://') || url.startsWith('https://'), { message: 'scrape_links: URL must use http:// or https:// protocol' });
+// Input schema for scrape_links tool
+const scrapeLinksParamsShape = {
+    urls: z
+        .array(urlSchema, {
+        required_error: 'scrape_links: URLs array is required',
+        invalid_type_error: 'scrape_links: URLs must be an array'
+    })
+        .min(1, { message: 'scrape_links: At least 1 URL is required' })
+        .max(50, { message: 'scrape_links: Maximum 50 URLs allowed per request' })
+        .describe('URLs to scrape (1-50). Recommend 3-5 URLs for balanced depth/breadth. More URLs = broader coverage but fewer tokens per URL. 3 URLs: ~10K tokens each (deep); 10 URLs: ~3K tokens each (balanced); 50 URLs: ~640 tokens each (scan).'),
+    timeout: z
+        .number({ invalid_type_error: 'scrape_links: Timeout must be a number' })
+        .min(5, { message: 'scrape_links: Timeout must be at least 5 seconds' })
+        .max(120, { message: 'scrape_links: Timeout cannot exceed 120 seconds' })
+        .default(30)
+        .describe('Timeout in seconds for each URL'),
+    use_llm: z
+        .boolean({ invalid_type_error: 'scrape_links: use_llm must be a boolean' })
+        .default(false)
+        .describe('Enable AI processing for content extraction (requires OPENROUTER_API_KEY)'),
+    what_to_extract: z
+        .string()
+        .max(1000, { message: 'scrape_links: Extraction instructions too long (max 1000 characters)' })
+        .optional()
+        .describe('Specific content extraction instructions for AI. Will be enhanced with conciseness suffix automatically.'),
+};
+export const scrapeLinksParamsSchema = z.object(scrapeLinksParamsShape);
+//# sourceMappingURL=scrape-links.js.map