mcp-researchpowerpack 3.6.9

package/dist/config/loader.js

@@ -0,0 +1,305 @@
+/**
+ * YAML Configuration Loader
+ * Loads tools.yaml and generates MCP-compatible tool definitions
+ */
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { parse as parseYaml } from 'yaml';
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+// Get directory of this file for relative YAML path
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Cached YAML config - loaded once, reused for all subsequent calls
+let cachedYamlConfig = null;
+// ============================================================================
+// YAML to Zod Schema Conversion
+// ============================================================================
+/**
+ * Convert YAML validation rules to Zod string schema
+ */
+function applyStringValidation(schema, validation) {
+    if (!validation)
+        return schema;
+    let result = schema;
+    if (validation.minLength !== undefined)
+        result = result.min(validation.minLength);
+    if (validation.maxLength !== undefined)
+        result = result.max(validation.maxLength);
+    if (validation.pattern)
+        result = result.regex(new RegExp(validation.pattern));
+    if (validation.format === 'uri')
+        result = result.url();
+    if (validation.format === 'email')
+        result = result.email();
+    if (validation.format === 'uuid')
+        result = result.uuid();
+    return result;
+}
+/**
+ * Convert YAML validation rules to Zod number schema
+ */
+function applyNumberValidation(schema, validation) {
+    if (!validation)
+        return schema;
+    let result = schema;
+    if (validation.min !== undefined)
+        result = result.min(validation.min);
+    if (validation.max !== undefined)
+        result = result.max(validation.max);
+    if (validation.int)
+        result = result.int();
+    if (validation.positive)
+        result = result.positive();
+    if (validation.negative)
+        result = result.negative();
+    return result;
+}
+/**
+ * Convert YAML validation rules to Zod array schema
+ */
+function applyArrayValidation(schema, validation) {
+    if (!validation)
+        return schema;
+    let result = schema;
+    if (validation.minItems !== undefined)
+        result = result.min(validation.minItems);
+    if (validation.maxItems !== undefined)
+        result = result.max(validation.maxItems);
+    return result;
+}
+/**
+ * Recursively convert YAML parameter to Zod schema
+ */
+function yamlParamToZod(param) {
+    let schema;
+    switch (param.type) {
+        case 'string': {
+            let strSchema = z.string();
+            strSchema = applyStringValidation(strSchema, param.validation);
+            if (param.description)
+                strSchema = strSchema.describe(param.description);
+            schema = strSchema;
+            break;
+        }
+        case 'number': {
+            let numSchema = z.number();
+            numSchema = applyNumberValidation(numSchema, param.validation);
+            if (param.description)
+                numSchema = numSchema.describe(param.description);
+            schema = numSchema;
+            break;
+        }
+        case 'boolean': {
+            let boolSchema = z.boolean();
+            if (param.description)
+                boolSchema = boolSchema.describe(param.description);
+            schema = boolSchema;
+            break;
+        }
+        case 'array': {
+            if (!param.items) {
+                throw new Error('Array parameter must have items definition');
+            }
+            const itemSchema = yamlParamToZod(param.items);
+            let arrSchema = z.array(itemSchema);
+            arrSchema = applyArrayValidation(arrSchema, param.validation);
+            if (param.description)
+                arrSchema = arrSchema.describe(param.description);
+            schema = arrSchema;
+            break;
+        }
+        case 'object': {
+            if (!param.properties) {
+                throw new Error('Object parameter must have properties definition');
+            }
+            const shape = {};
+            for (const [key, propDef] of Object.entries(param.properties)) {
+                let propSchema = yamlParamToZod(propDef);
+                if (propDef.required === false) {
+                    propSchema = propSchema.optional();
+                }
+                shape[key] = propSchema;
+            }
+            let objSchema = z.object(shape);
+            if (param.description)
+                objSchema = objSchema.describe(param.description);
+            schema = objSchema;
+            break;
+        }
+        default:
+            throw new Error(`Unknown parameter type: ${param.type}`);
+    }
+    // Apply optional/default
+    if (param.required === false && param.default !== undefined) {
+        schema = schema.default(param.default);
+    }
+    else if (param.required === false) {
+        schema = schema.optional();
+    }
+    return schema;
+}
+/**
+ * Convert YAML parameters to Zod object schema
+ */
+function yamlParamsToZodSchema(params) {
+    const shape = {};
+    for (const [key, param] of Object.entries(params)) {
+        let schema = yamlParamToZod(param);
+        // Note: required is handled in yamlParamToZod via optional()
+        shape[key] = schema;
+    }
+    return z.object(shape);
+}
+/**
+ * Convert Zod schema to JSON Schema for MCP inputSchema
+ */
+function zodToMcpInputSchema(schema) {
+    const jsonSchema = zodToJsonSchema(schema, { $refStrategy: 'none' });
+    // Extract properties and required from JSON Schema
+    if (typeof jsonSchema === 'object' && jsonSchema !== null) {
+        const obj = jsonSchema;
+        return {
+            type: 'object',
+            properties: obj.properties || {},
+            required: obj.required,
+        };
+    }
+    return { type: 'object', properties: {} };
+}
+// ============================================================================
+// Tool Loading
+// ============================================================================
+/**
+ * Load and parse tools.yaml
+ */
+export function loadYamlConfig() {
+    if (cachedYamlConfig)
+        return cachedYamlConfig;
+    const yamlPath = join(__dirname, 'yaml', 'tools.yaml');
+    const yamlContent = readFileSync(yamlPath, 'utf8');
+    cachedYamlConfig = parseYaml(yamlContent);
+    return cachedYamlConfig;
+}
+/**
+ * Convert a single YAML tool config to MCP Tool
+ * For tools with inline parameters only
+ */
+function yamlToolToMcpTool(toolConfig) {
+    if (!toolConfig.parameters) {
+        throw new Error(`Tool ${toolConfig.name} must have parameters or useZodSchema`);
+    }
+    const zodSchema = yamlParamsToZodSchema(toolConfig.parameters);
+    const inputSchema = zodToMcpInputSchema(zodSchema);
+    return {
+        name: toolConfig.name,
+        description: toolConfig.description.trim(),
+        inputSchema,
+        category: toolConfig.category,
+        capability: toolConfig.capability,
+        useZodSchema: false,
+    };
+}
+/**
+ * Create placeholder for tools using existing Zod schemas
+ * These will be enriched with actual schemas at runtime
+ */
+function createZodSchemaPlaceholder(toolConfig) {
+    return {
+        name: toolConfig.name,
+        description: toolConfig.description.trim(),
+        inputSchema: { type: 'object', properties: {} }, // Placeholder
+        category: toolConfig.category,
+        capability: toolConfig.capability,
+        useZodSchema: true,
+        zodSchemaRef: toolConfig.zodSchemaRef,
+    };
+}
+/**
+ * Load all tools from YAML configuration
+ */
+export function loadToolsFromYaml() {
+    const config = loadYamlConfig();
+    return config.tools.map((toolConfig) => {
+        if (toolConfig.useZodSchema) {
+            // Tool uses existing Zod schema - return placeholder
+            return createZodSchemaPlaceholder(toolConfig);
+        }
+        else {
+            // Tool has inline parameters - generate schema from YAML
+            return yamlToolToMcpTool(toolConfig);
+        }
+    });
+}
+/**
+ * Get tool configuration by name
+ */
+export function getToolConfig(name) {
+    const config = loadYamlConfig();
+    return config.tools.find((t) => t.name === name);
+}
+/**
+ * Get schema descriptions for a tool (for injecting into existing Zod schemas)
+ */
+export function getSchemaDescriptions(name) {
+    const tool = getToolConfig(name);
+    return tool?.schemaDescriptions;
+}
+// ============================================================================
+// Zod Schema Registry (for tools using existing schemas)
+// ============================================================================
+import { deepResearchParamsSchema } from '../schemas/deep-research.js';
+import { scrapeLinksParamsSchema } from '../schemas/scrape-links.js';
+import { webSearchParamsSchema } from '../schemas/web-search.js';
+/**
+ * Registry of existing Zod schemas for complex tools
+ */
+const zodSchemaRegistry = {
+    deepResearchParamsSchema,
+    scrapeLinksParamsSchema,
+    webSearchParamsSchema,
+};
+/**
+ * Get Zod schema by reference name
+ */
+export function getZodSchemaByRef(ref) {
+    return zodSchemaRegistry[ref];
+}
+/**
+ * Generate complete MCP tools list with all schemas resolved
+ */
+export function generateMcpTools() {
+    const loadedTools = loadToolsFromYaml();
+    return loadedTools.map((tool) => {
+        if (tool.useZodSchema && tool.zodSchemaRef) {
+            // Resolve the actual Zod schema
+            const schema = getZodSchemaByRef(tool.zodSchemaRef);
+            if (!schema) {
+                console.error(`[Loader] Schema not found: ${tool.zodSchemaRef}`);
+                return {
+                    name: tool.name,
+                    description: tool.description,
+                    inputSchema: { type: 'object', properties: {} },
+                };
+            }
+            const inputSchema = zodToMcpInputSchema(schema);
+            return {
+                name: tool.name,
+                description: tool.description,
+                inputSchema,
+            };
+        }
+        // Tool already has generated inputSchema
+        return {
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+        };
+    });
+}
+// ============================================================================
+// Exports
+// ============================================================================
+export { yamlParamsToZodSchema, yamlParamToZod };
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

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

package/dist/config/types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * TypeScript interfaces for YAML tool configuration
+ * Matches structure defined in yaml/tools.yaml
+ */
+import type { Capabilities } from './index.js';
+/**
+ * Validation rules for parameters
+ */
+export interface YamlValidation {
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: 'uri' | 'email' | 'uuid';
+    min?: number;
+    max?: number;
+    int?: boolean;
+    positive?: boolean;
+    negative?: boolean;
+    minItems?: number;
+    maxItems?: number;
+    nonempty?: boolean;
+}
+/**
+ * Parameter definition in YAML
+ */
+export interface YamlParameter {
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    required?: boolean;
+    default?: unknown;
+    description?: string;
+    validation?: YamlValidation;
+    items?: YamlParameter;
+    properties?: Record<string, YamlParameter>;
+}
+/**
+ * Tool definition in YAML
+ */
+export interface YamlToolConfig {
+    name: string;
+    category?: string;
+    capability?: keyof Capabilities;
+    description: string;
+    parameters?: Record<string, YamlParameter>;
+    useZodSchema?: boolean;
+    zodSchemaRef?: string;
+    schemaDescriptions?: Record<string, string>;
+    limits?: Record<string, string | number | boolean>;
+}
+/**
+ * Root YAML configuration structure
+ */
+export interface YamlConfig {
+    version: string;
+    metadata: {
+        name: string;
+        description: string;
+    };
+    tools: YamlToolConfig[];
+}
+/**
+ * MCP Tool definition (matches SDK)
+ */
+export interface McpTool {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+/**
+ * Loaded tool with additional metadata
+ */
+export interface LoadedTool extends McpTool {
+    category?: string;
+    capability?: keyof Capabilities;
+    useZodSchema?: boolean;
+    zodSchemaRef?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,cAAc;IAE7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IAGlC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAGnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,cAAc,CAAC;IAG5B,KAAK,CAAC,EAAE,aAAa,CAAC;IAGtB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,YAAY,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IAGpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAG3C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAG5C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,OAAO;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,YAAY,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/config/types.js

@@ -0,0 +1,6 @@
+/**
+ * TypeScript interfaces for YAML tool configuration
+ * Matches structure defined in yaml/tools.yaml
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/config/yaml/tools.yaml

@@ -0,0 +1,130 @@
+# Research Powerpack MCP - Tool Configuration
+# Optimized for LLM consumption - <1K tokens total
+version: "1.0"
+
+metadata:
+  name: "research-powerpack-mcp"
+  description: "Parallel research tools with AI extraction"
+
+# CORE PRINCIPLES (ALL TOOLS)
+shared:
+  philosophy: "MAXIMIZE inputs for parallel processing - NO time penalty for more items! More diverse inputs = better coverage = higher quality. Each input MUST target DIFFERENT angle - NO overlap/duplicates. ALWAYS use sequentialthinking between tool calls."
+
+  workflow: |
+    MANDATORY: THINK first (plan strategy) → EXECUTE with MAX diversity (use recommended counts) → THINK after (evaluate: what's missing? new angles discovered? gaps in coverage?) → ITERATE if needed (refine based on findings) → SYNTHESIZE final output.
+    KEY INSIGHT: First research pass usually incomplete - reveals what you SHOULD have asked! Results are feedback - use them to ask better questions next iteration.
+
+  iteration_triggers: "Iterate when: Results mention concepts you didn't research | Answers raise NEW questions | Initial scope too narrow | Related topics discovered you should explore"
+
+tools:
+  - name: search_reddit
+    category: reddit
+    capability: search
+    limits: {min_queries: 10, max_queries: 50, recommended: 20}
+
+    description: |
+      MIN 10 queries, REC 20+ (10q=100 results, 20q=200 results). Each query MUST target DIFFERENT angle - NO overlap! 10 categories: 1) direct topic 2) recommendations (best/top) 3) specific tools/repos/names 4) comparisons (vs) 5) alternatives 6) subreddit targeting (r/macapps, r/opensource) 7) problems/issues/crashes 8) year-specific (2024/2025) 9) features 10) dev/GitHub/electron. Operators: intitle:, "exact", OR, -exclude. Using 1-3 queries wastes parallel power. Auto adds site:reddit.com.
+
+    parameters:
+      queries:
+        type: array
+        required: true
+        items: {type: string}
+        validation: {minItems: 10, maxItems: 50}
+        description: "10-50 diverse queries. Each targets different angle: direct|best|tools|vs|alternative|r/sub|issues|2024|features|GitHub. NO overlap."
+      date_after:
+        type: string
+        required: false
+        description: "Filter after date (YYYY-MM-DD)"
+
+
+  - name: get_reddit_post
+    category: reddit
+    capability: reddit
+    limits: {min_urls: 2, max_urls: 50, recommended: 20, default_max_comments: 1000}
+    extraction_suffix: "Extract key insights: consensus, recommendations with reasoning, contrasting views, real experiences, technical details. Be comprehensive + concise, prioritize actionable info."
+
+    description: |
+      MIN 2 URLs, REC 10-20+. Auto comment budget: 1000 total (2 posts=500 each deep, 10=100 balanced, 20=50 broad coverage). Comments have BEST insights - always fetch_comments=true unless only need titles. use_llm=true for AI extraction (pennies, needs OPENROUTER_API_KEY) - synthesizes consensus, filters noise. Mix subreddits for diverse perspectives. Using 2-5 posts = narrow, missing consensus. 20-30 posts = comprehensive.
+
+    parameters:
+      urls:
+        type: array
+        required: true
+        items: {type: string}
+        validation: {minItems: 2, maxItems: 50}
+        description: "2-50 Reddit URLs. More = broader consensus. Get from search_reddit."
+      fetch_comments:
+        type: boolean
+        required: false
+        default: true
+        description: "Fetch comments (true recommended - best insights in comments)"
+      max_comments:
+        type: number
+        required: false
+        default: 100
+        description: "Override auto allocation. Leave empty for smart allocation."
+      use_llm:
+        type: boolean
+        required: false
+        default: false
+        description: "AI extraction (recommended). Extracts insights, consensus, filters noise. Needs OPENROUTER_API_KEY."
+      what_to_extract:
+        type: string
+        required: false
+        description: "Extraction instructions for AI. Be specific: 'Extract recommendations for X with pros/cons'. More specific = better quality."
+
+
+  - name: deep_research
+    category: research
+    capability: deepResearch
+    useZodSchema: true
+    zodSchemaRef: "deepResearchParamsSchema"
+    limits: {min_questions: 1, max_questions: 10, recommended: 5, min_length: 200, min_specific: 2}
+
+    description: |
+      MIN 2, REC 5-10 questions parallel. 32K tokens distributed (2q=16K/each deep, 5q=6.4K balanced, 10q=3.2K comprehensive). MANDATORY template per question:
+      "🎯 WHAT I NEED: [clear goal]
+      🤔 WHY: [decision/problem]
+      📚 WHAT I KNOW: [current understanding - so research fills gaps not basics]
+      🔧 HOW I'LL USE: [implementation/debugging/architecture]
+      ❓ SPECIFIC QUESTIONS: 1) [q1] 2) [q2] 3) [q3]
+      🌐 PRIORITY SOURCES: [optional - docs/sites]
+      ⚡ FOCUS: [optional - performance/security]"
+      ATTACH FILES for code Qs (bugs/perf/refactor/review/architecture) - MANDATORY or research is generic/unhelpful. Using 1-2 Qs wastes parallel capacity. First pass incomplete - iterate based on findings.
+
+    schemaDescriptions:
+      questions: "2-10 structured questions following template above. Each MUST cover different angle of topic. Attach files for ANY code-related Q (bugs/errors/perf/refactoring/review/architecture) - without code context, research is generic/useless."
+      file_attachments: "MANDATORY for code Qs: bugs→failing code, perf→slow code, refactor→current implementation, review→code to review, architecture→relevant modules. Format: {path: '/absolute/path', description: 'What file is, why relevant, focus areas, known issues', start_line?, end_line?}. Thorough description critical."
+
+
+  - name: scrape_links
+    category: scrape
+    capability: scraping
+    useZodSchema: true
+    zodSchemaRef: "scrapeLinksParamsSchema"
+    limits: {min_urls: 1, max_urls: 50, recommended: 5, min_extract_len: 50, min_targets: 3}
+    extraction_suffix: "MUST: Comprehensive extraction, high info density, no verbosity, satisfy scope, NEVER hallucinate, only extract grounded info from document. No confirmation messages."
+
+    description: |
+      REC 3-5 URLs. ALWAYS use_llm=true - AI extraction is this tool's superpower! use_llm=false gives raw HTML (messy, hours manual parsing). use_llm=true: auto-filters nav/ads/footers, extracts ONLY what you specify, handles complex structures, returns clean ready-to-use content, costs pennies (~$0.01/10 pages) vs hours work. 32K tokens (3=10K each, 5=6K, 10=3K, 50=640). Formula: "Extract [t1] | [t2] | [t3] | [t4] | [t5] with focus on [a1], [a2], [a3]". Min 3 targets with | separator, be specific (pricing tiers not pricing), aim 5-10 targets. Templates: Product (pricing|features|reviews|specs|integrations|support), Tech Docs (endpoints|auth|limits|errors|examples|schemas), Competitive (features|pricing|customers|USPs|stack|testimonials).
+
+    schemaDescriptions:
+      urls: "1-50 URLs (3-5 recommended). More URLs = broader coverage, fewer tokens/URL."
+      timeout: "Timeout per URL (5-120s, default 30)"
+      use_llm: "ALWAYS SET TRUE (default false but override it). AI extraction is tool's superpower - auto-filters nav/ads/footers, extracts ONLY your specified targets, returns clean structured content ready to use. Raw HTML (use_llm=false) is messy noise requiring hours parsing. Cost: ~$0.001/page (pennies). Needs OPENROUTER_API_KEY."
+      what_to_extract: "REQUIRED when use_llm=true. Formula: 'Extract [target1] | [target2] | [target3] | [target4] | [target5] with focus on [aspect1], [aspect2], [aspect3]'. Min 50 chars, min 3 targets with | separator. Be super specific (pricing tiers not pricing, API rate limits not API info). Aim 5-10 targets. Act like detailed LLM instruction. More specific targets = higher extraction quality. Include 'with focus on' to prioritize aspects."
+
+
+  - name: web_search
+    category: search
+    capability: search
+    useZodSchema: true
+    zodSchemaRef: "webSearchParamsSchema"
+    limits: {min_keywords: 3, max_keywords: 100, recommended: 7}
+
+    description: |
+      MIN 3, REC 5-7 keywords parallel Google search. 10 results/keyword (3=30 results, 7=70, 100=1000). Each keyword = separate search - MUST be diverse angles! 7 perspectives: 1) broad [topic] 2) specific/technical [topic]+[term] 3) problems [topic] issues/debugging 4) best practices [topic] 2024/2025 5) comparison [A] vs [B] OR 6) tutorial/guide 7) advanced patterns/architecture. Operators: site:domain.com (target GitHub/StackOverflow/docs), "exact phrase", -exclude, filetype:pdf, OR. Examples: "PostgreSQL" site:github.com stars:>1000, "Docker OOM" site:stackoverflow.com. CRITICAL: Search only gives URLs - MUST follow with scrape_links to get actual content! Workflow: search → think → scrape_links (MANDATORY) → think → iterate → synthesize. Using 1-2 keywords wastes parallel power.
+
+    schemaDescriptions:
+      keywords: "3-100 diverse keywords (5-7 rec). Each separate Google search parallel. 7 angles: broad | technical | problems | best practices+year | vs/OR | tutorial | patterns. Operators: site:, \"exact\", -exclude, filetype:, OR."

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Research Powerpack MCP Server
+ * Implements robust error handling - server NEVER crashes on tool failures
+ */
+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":";AAEA;;;GAGG"}