research-powerpack-mcp 3.6.4 → 3.6.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "research-powerpack-mcp",
-  "version": "3.6.4",
+  "version": "3.6.5",
   "description": "The ultimate research MCP toolkit: Reddit mining, web search with CTR aggregation, AI-powered deep research, and intelligent web scraping - all in one modular package",
   "type": "module",
   "main": "dist/index.js",

package/dist/config/env.d.ts

@@ -1,75 +0,0 @@
-/**
- * Centralized Environment Variable Validation
- * Uses Zod for type-safe parsing with helpful error messages
- */
-import { z } from 'zod';
-declare const envSchema: z.ZodObject<{
-    SCRAPEDO_API_KEY: z.ZodOptional<z.ZodString>;
-    SERPER_API_KEY: z.ZodOptional<z.ZodString>;
-    REDDIT_CLIENT_ID: z.ZodOptional<z.ZodString>;
-    REDDIT_CLIENT_SECRET: z.ZodOptional<z.ZodString>;
-    OPENROUTER_API_KEY: z.ZodOptional<z.ZodString>;
-    OPENROUTER_BASE_URL: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    RESEARCH_MODEL: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    RESEARCH_FALLBACK_MODEL: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    DEFAULT_REASONING_EFFORT: z.ZodDefault<z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>>;
-    DEFAULT_MAX_URLS: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    API_TIMEOUT_MS: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    LLM_EXTRACTION_MODEL: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    LLM_ENABLE_REASONING: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, boolean, string>>>;
-}, "strip", z.ZodTypeAny, {
-    OPENROUTER_BASE_URL: string;
-    RESEARCH_MODEL: string;
-    RESEARCH_FALLBACK_MODEL: string;
-    API_TIMEOUT_MS: number;
-    DEFAULT_REASONING_EFFORT: "low" | "medium" | "high";
-    DEFAULT_MAX_URLS: number;
-    LLM_EXTRACTION_MODEL: string;
-    LLM_ENABLE_REASONING: boolean;
-    SCRAPEDO_API_KEY?: string | undefined;
-    SERPER_API_KEY?: string | undefined;
-    REDDIT_CLIENT_ID?: string | undefined;
-    REDDIT_CLIENT_SECRET?: string | undefined;
-    OPENROUTER_API_KEY?: string | undefined;
-}, {
-    SCRAPEDO_API_KEY?: string | undefined;
-    SERPER_API_KEY?: string | undefined;
-    REDDIT_CLIENT_ID?: string | undefined;
-    REDDIT_CLIENT_SECRET?: string | undefined;
-    OPENROUTER_BASE_URL?: string | undefined;
-    RESEARCH_MODEL?: string | undefined;
-    RESEARCH_FALLBACK_MODEL?: string | undefined;
-    OPENROUTER_API_KEY?: string | undefined;
-    API_TIMEOUT_MS?: number | undefined;
-    DEFAULT_REASONING_EFFORT?: "low" | "medium" | "high" | undefined;
-    DEFAULT_MAX_URLS?: number | undefined;
-    LLM_EXTRACTION_MODEL?: string | undefined;
-    LLM_ENABLE_REASONING?: string | undefined;
-}>;
-export type EnvConfig = z.infer<typeof envSchema>;
-/**
- * Parse and validate environment variables
- * Returns cached result on subsequent calls
- */
-export declare function getEnv(): EnvConfig;
-/**
- * Clear cached environment (useful for testing)
- */
-export declare function clearEnvCache(): void;
-export interface Capabilities {
-    reddit: boolean;
-    search: boolean;
-    scraping: boolean;
-    deepResearch: boolean;
-    llmExtraction: boolean;
-}
-/**
- * Get available capabilities based on configured API keys
- */
-export declare function getCapabilitiesFromEnv(): Capabilities;
-/**
- * Get user-friendly message for missing capability
- */
-export declare function getMissingCapabilityMessage(capability: keyof Capabilities): string;
-export {};
-//# sourceMappingURL=env.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyBb,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAQlD;;;GAGG;AACH,wBAAgB,MAAM,IAAI,SAAS,CAelC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAMD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,CASrD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,YAAY,GAAG,MAAM,CASlF"}

package/dist/config/env.js

@@ -1,87 +0,0 @@
-/**
- * Centralized Environment Variable Validation
- * Uses Zod for type-safe parsing with helpful error messages
- */
-import { z } from 'zod';
-// ============================================================================
-// Environment Schema
-// ============================================================================
-const envSchema = z.object({
-    // Scraper API (required for scrape_links)
-    SCRAPEDO_API_KEY: z.string().optional(),
-    // Search API (required for web_search and search_reddit)
-    SERPER_API_KEY: z.string().optional(),
-    // Reddit API (required for get_reddit_post)
-    REDDIT_CLIENT_ID: z.string().optional(),
-    REDDIT_CLIENT_SECRET: z.string().optional(),
-    // OpenRouter API (required for deep_research and LLM extraction)
-    OPENROUTER_API_KEY: z.string().optional(),
-    OPENROUTER_BASE_URL: z.string().url().optional().default('https://openrouter.ai/api/v1'),
-    // Research configuration
-    RESEARCH_MODEL: z.string().optional().default('x-ai/grok-4-fast'),
-    RESEARCH_FALLBACK_MODEL: z.string().optional().default('google/gemini-2.5-flash'),
-    DEFAULT_REASONING_EFFORT: z.enum(['low', 'medium', 'high']).optional().default('high'),
-    DEFAULT_MAX_URLS: z.coerce.number().min(10).max(200).optional().default(100),
-    API_TIMEOUT_MS: z.coerce.number().min(1000).max(3600000).optional().default(1800000),
-    // LLM extraction configuration
-    LLM_EXTRACTION_MODEL: z.string().optional().default('openai/gpt-oss-120b:nitro'),
-    LLM_ENABLE_REASONING: z.string().transform(v => v !== 'false').optional().default('true'),
-});
-// ============================================================================
-// Parse and Validate Environment
-// ============================================================================
-let cachedEnv = null;
-/**
- * Parse and validate environment variables
- * Returns cached result on subsequent calls
- */
-export function getEnv() {
-    if (cachedEnv)
-        return cachedEnv;
-    try {
-        cachedEnv = envSchema.parse(process.env);
-        return cachedEnv;
-    }
-    catch (error) {
-        if (error instanceof z.ZodError) {
-            const issues = error.issues.map(i => `  - ${i.path.join('.')}: ${i.message}`).join('\n');
-            console.error(`[Config] Environment validation failed:\n${issues}`);
-        }
-        // Return defaults on error to avoid crashing
-        cachedEnv = envSchema.parse({});
-        return cachedEnv;
-    }
-}
-/**
- * Clear cached environment (useful for testing)
- */
-export function clearEnvCache() {
-    cachedEnv = null;
-}
-/**
- * Get available capabilities based on configured API keys
- */
-export function getCapabilitiesFromEnv() {
-    const env = getEnv();
-    return {
-        reddit: !!(env.REDDIT_CLIENT_ID && env.REDDIT_CLIENT_SECRET),
-        search: !!env.SERPER_API_KEY,
-        scraping: !!env.SCRAPEDO_API_KEY,
-        deepResearch: !!env.OPENROUTER_API_KEY,
-        llmExtraction: !!env.OPENROUTER_API_KEY,
-    };
-}
-/**
- * Get user-friendly message for missing capability
- */
-export function getMissingCapabilityMessage(capability) {
-    const messages = {
-        reddit: '❌ **Reddit tools unavailable.** Set `REDDIT_CLIENT_ID` and `REDDIT_CLIENT_SECRET` to enable.\n\n👉 Create a Reddit app at: https://www.reddit.com/prefs/apps (select "script" type)',
-        search: '❌ **Search unavailable.** Set `SERPER_API_KEY` to enable web search and Reddit search.\n\n👉 Get your free API key at: https://serper.dev (2,500 free queries)',
-        scraping: '❌ **Web scraping unavailable.** Set `SCRAPEDO_API_KEY` to enable URL content extraction.\n\n👉 Sign up at: https://scrape.do (1,000 free credits)',
-        deepResearch: '❌ **Deep research unavailable.** Set `OPENROUTER_API_KEY` to enable AI-powered research.\n\n👉 Get your API key at: https://openrouter.ai/keys',
-        llmExtraction: '⚠️ **AI extraction disabled.** The `use_llm` and `what_to_extract` features require `OPENROUTER_API_KEY`.\n\nScraping will work but without intelligent content filtering.',
-    };
-    return messages[capability];
-}
-//# sourceMappingURL=env.js.map

package/dist/config/env.js.map

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

package/dist/utils/mcp-logger.d.ts

@@ -1,8 +0,0 @@
-/**
- * MCP SDK structured logging wrapper
- * Sends log messages to MCP clients via server.sendLoggingMessage()
- */
-import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
-export declare function initLogger(server: Server): void;
-export declare function mcpLog(level: 'debug' | 'info' | 'warning' | 'error', message: string, logger?: string): void;
-//# sourceMappingURL=mcp-logger.d.ts.map

package/dist/utils/mcp-logger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-logger.d.ts","sourceRoot":"","sources":["../../src/utils/mcp-logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAIxE,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAG5G"}

package/dist/utils/mcp-logger.js

@@ -1,14 +0,0 @@
-/**
- * MCP SDK structured logging wrapper
- * Sends log messages to MCP clients via server.sendLoggingMessage()
- */
-let serverRef = null;
-export function initLogger(server) {
-    serverRef = server;
-}
-export function mcpLog(level, message, logger) {
-    if (!serverRef)
-        return;
-    serverRef.sendLoggingMessage({ level, data: message, logger: logger ?? 'research-powerpack' }).catch(() => { });
-}
-//# sourceMappingURL=mcp-logger.js.map

package/dist/utils/mcp-logger.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-logger.js","sourceRoot":"","sources":["../../src/utils/mcp-logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,IAAI,SAAS,GAAkB,IAAI,CAAC;AAEpC,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,SAAS,GAAG,MAAM,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAA6C,EAAE,OAAe,EAAE,MAAe;IACpG,IAAI,CAAC,SAAS;QAAE,OAAO;IACvB,SAAS,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AACjH,CAAC"}