mcp-researchpowerpack 3.9.4 → 4.3.0

package/dist/config/types.d.ts

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

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

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

package/dist/config/types.js

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

package/dist/config/types.js.map

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

package/dist/config/yaml/tools.yaml

@@ -1,146 +0,0 @@
-# Research Powerpack MCP - Tool Configuration
-# Optimized for LLM consumption - <1K tokens total
-version: "1.0"
-
-metadata:
-  name: "mcp-research-powerpack"
-  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 → EXECUTE (max diversity) → THINK (evaluate: gaps? claims to verify? links to follow?) → CROSS-REFERENCE (Reddit claims → web search, web results → scrape) → ITERATE → SYNTHESIZE.
-    NEVER stop after one tool call. Every search result has URLs to scrape. Every Reddit discussion has claims to verify. Every scraped page has links to follow.
-
-  iteration_triggers: "Iterate when: Reddit comments mention specific tools/links (scrape them) | Research cites sources (verify them) | Community claims contradict each other (web search for truth) | Results mention concepts you didn't research | First pass is ALWAYS incomplete"
-
-tools:
-  - name: search_reddit
-    category: reddit
-    capability: search
-    limits: {min_queries: 3, max_queries: 50, recommended: 20}
-
-    description: |
-      MIN 3 queries, REC 20+ (3q=30 results, 20q=200 results). Each query MUST target DIFFERENT angle - NO overlap! 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. Operators: intitle:, "exact", OR, -exclude. Auto adds site:reddit.com.
-
-    parameters:
-      queries:
-        type: array
-        required: true
-        items: {type: string}
-        validation: {minItems: 3, maxItems: 50}
-        description: "3-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. DO NOT use use_llm — default is false. Users need raw exact comments to read verbatim (quotes, code snippets, specific recommendations). LLM summarization loses critical detail and nuance from discussions. Only set use_llm=true if explicitly asked to synthesize across 20+ posts. Mix subreddits for diverse perspectives. Using 2-5 posts = narrow. 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: "Default false — DO NOT enable unless user explicitly requests synthesis. Raw comments preserve exact quotes, code snippets, nuanced opinions, and specific recommendations that LLM summarization loses. Only consider use_llm=true when processing 20+ posts and user explicitly wants a synthesized overview rather than reading individual comments."
-      what_to_extract:
-        type: string
-        required: false
-        description: "Only used when use_llm=true. Extraction instructions for AI synthesis. Be specific: 'Extract recommendations for X with pros/cons'."
-
-
-  - 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
-      research_suffix: "CONSTRAINTS: No restating the question. No hedging preambles. Cite sources inline [source]. NEVER hallucinate — only report what sources confirm."
-
-    description: |
-      MIN 2, REC 5-10 questions parallel. 32K tokens distributed (2q=16K/each deep, 5q=6.4K balanced, 10q=3.2K comprehensive). A compression suffix auto-appended to each question (anti-hallucination, cite-inline, no filler). Output uses tables for comparisons/structured data, tight bullets for explanations. 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_prefix: "Extract ONLY from document — never hallucinate. For structured data (pricing, specs, features) → markdown table. Otherwise → tight bullet points. No intro, no confirmation message, no meta-commentary."
-      extraction_suffix: "Output grounded info only. First line = content, not preamble."
-
-    description: |
-      REC 3-5 URLs. use_llm=true BY DEFAULT — AI extraction auto-filters nav/ads/footers, returns clean structured content. A compression prefix+suffix wraps your prompt automatically for max info density. 32K tokens (3=10K each, 5=6K, 10=3K, 50=640). PROMPT FORMULA — keep it tight, no verbosity: "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. BAD: "Please extract all information about pricing and features from this page" → GOOD: "pricing tiers|limits|features|integrations|API auth|rate limits with focus on free tier, enterprise pricing". Templates: Product (pricing|features|reviews|specs|integrations|support), Tech Docs (endpoints|auth|limits|errors|examples|schemas), Competitive (features|pricing|customers|USPs|stack|testimonials). Set use_llm=false ONLY for raw HTML debugging.
-
-    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: "Defaults to true. AI extraction auto-filters noise, extracts only specified targets, returns clean structured content. Compression prefix+suffix auto-applied to maximize info density. Cost: ~$0.001/page. Set false ONLY for raw HTML debugging. Needs OPENROUTER_API_KEY."
-      what_to_extract: "Your extraction targets — auto-wrapped with compression prefix+suffix. Formula: 'pricing tiers|limits|features|integrations|API auth with focus on free tier, enterprise'. Min 3 targets with | separator. Be terse and specific (pricing tiers not pricing, API rate limits not API info). No verbose sentences — just targets+focus. The system adds compression instructions automatically."
-
-
-  - 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

@@ -1,7 +0,0 @@
-#!/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

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

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

@@ -1,64 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,224 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,32 +0,0 @@
-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 {
-    readonly content: string;
-    readonly metadata: {
-        readonly total_urls: number;
-        readonly successful: number;
-        readonly failed: number;
-        readonly total_credits: number;
-        readonly execution_time_ms: number;
-        readonly tokens_per_url?: number;
-        readonly total_token_budget?: number;
-        readonly batches_processed?: number;
-    };
-}
-//# sourceMappingURL=scrape-links.d.ts.map

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

@@ -1 +0,0 @@
-{"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,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;QACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QACjC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;QACrC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;KACrC,CAAC;CACH"}

package/dist/schemas/scrape-links.js

@@ -1,34 +0,0 @@
-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(true)
-        .describe('AI extraction enabled by default (requires OPENROUTER_API_KEY). Auto-filters nav/ads/footers, extracts ONLY what you specify. Set false only for raw HTML debugging.'),
-    what_to_extract: z
-        .string()
-        .max(1000, { message: 'scrape_links: Extraction instructions too long (max 1000 characters)' })
-        .optional()
-        .describe('Extraction instructions for AI. Will be wrapped with compression prefix+suffix automatically. Formula: "Extract [target1] | [target2] | [target3] with focus on [aspect1], [aspect2]". Min 3 targets with | separator. Be specific (pricing tiers not pricing). Aim 5-10 targets.'),
-};
-export const scrapeLinksParamsSchema = z.object(scrapeLinksParamsShape);
-//# sourceMappingURL=scrape-links.js.map

package/dist/schemas/scrape-links.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"scrape-links.js","sourceRoot":"","sources":["../../src/schemas/scrape-links.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sCAAsC;AACtC,MAAM,SAAS,GAAG,CAAC;KAChB,MAAM,CAAC,EAAE,cAAc,EAAE,+BAA+B,EAAE,CAAC;KAC3D,GAAG,CAAC,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;KACpD,MAAM,CACL,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAC9D,EAAE,OAAO,EAAE,yDAAyD,EAAE,CACvE,CAAC;AAEJ,qCAAqC;AACrC,MAAM,sBAAsB,GAAG;IAC7B,IAAI,EAAE,CAAC;SACJ,KAAK,CAAC,SAAS,EAAE;QAChB,cAAc,EAAE,sCAAsC;QACtD,kBAAkB,EAAE,qCAAqC;KAC1D,CAAC;SACD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;SAC/D,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,mDAAmD,EAAE,CAAC;SACzE,QAAQ,CAAC,sOAAsO,CAAC;IACnP,OAAO,EAAE,CAAC;SACP,MAAM,CAAC,EAAE,kBAAkB,EAAE,wCAAwC,EAAE,CAAC;SACxE,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,kDAAkD,EAAE,CAAC;SACvE,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,iDAAiD,EAAE,CAAC;SACxE,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,iCAAiC,CAAC;IAC9C,OAAO,EAAE,CAAC;SACP,OAAO,CAAC,EAAE,kBAAkB,EAAE,yCAAyC,EAAE,CAAC;SAC1E,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,sKAAsK,CAAC;IACnL,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,sEAAsE,EAAE,CAAC;SAC9F,QAAQ,EAAE;SACV,QAAQ,CAAC,mRAAmR,CAAC;CACjS,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC"}