mcp-researchpowerpack 3.9.4 → 4.3.0

package/dist/utils/response.js

@@ -1,170 +0,0 @@
-/**
- * MCP Response Formatters - 70/20/10 Pattern
- *
- * All tool responses should follow this structure:
- * - 70% Summary: Key insights, status, metrics
- * - 20% Data: Structured results (lists, tables)
- * - 10% Next Steps: Actionable follow-up commands
- */
-/** Default maximum items to display in list formatting */
-export const DEFAULT_MAX_ITEMS = 20;
-/** Maximum snippet length before truncation in URL aggregator output */
-export const MAX_SNIPPET_LENGTH = 200;
-/** Duration thresholds in milliseconds */
-const SECONDS_MS = 1_000;
-const MINUTES_MS = 60_000;
-/**
- * Format a successful response using 70/20/10 pattern
- */
-export function formatSuccess(opts) {
-    const parts = [];
-    // Title
-    parts.push(`✓ ${opts.title}`);
-    parts.push('');
-    // Summary (70%)
-    parts.push(opts.summary);
-    // Data section (20%)
-    if (opts.data) {
-        parts.push('');
-        parts.push('---');
-        parts.push(opts.data);
-    }
-    // Next steps (10%)
-    if (opts.nextSteps?.length) {
-        parts.push('');
-        parts.push('---');
-        parts.push('**Next Steps:**');
-        opts.nextSteps.forEach(step => parts.push(`→ ${step}`));
-    }
-    // Metadata footer
-    if (opts.metadata && Object.keys(opts.metadata).length > 0) {
-        parts.push('');
-        parts.push('---');
-        const metaStr = Object.entries(opts.metadata)
-            .map(([k, v]) => `${k}: ${v}`)
-            .join(' | ');
-        parts.push(`*${metaStr}*`);
-    }
-    return parts.join('\n');
-}
-/** Maximum length for error messages before truncation */
-const MAX_ERROR_MSG_LENGTH = 500;
-/**
- * Format an error response with recovery guidance
- * Designed to keep agents moving — every error includes actionable alternatives
- */
-export function formatError(opts) {
-    const parts = [];
-    // Truncate error message to prevent unbounded output
-    const message = opts.message.length > MAX_ERROR_MSG_LENGTH
-        ? opts.message.slice(0, MAX_ERROR_MSG_LENGTH - 3) + '...'
-        : opts.message;
-    // Error header
-    const prefix = opts.toolName ? `[${opts.toolName}] ` : '';
-    parts.push(`❌ ${prefix}${opts.code}: ${message}`);
-    // Retryable hint — be specific about what to do while waiting
-    if (opts.retryable) {
-        parts.push('');
-        parts.push('*This error is retryable. Wait a moment and try again — but use the alternatives below in the meantime so research continues.*');
-    }
-    // How to fix
-    if (opts.howToFix?.length) {
-        parts.push('');
-        parts.push('**How to Fix:**');
-        opts.howToFix.forEach((step, i) => parts.push(`${i + 1}. ${step}`));
-    }
-    // Alternatives — directive, not optional
-    if (opts.alternatives?.length) {
-        parts.push('');
-        parts.push('**DO THIS INSTEAD (don\'t stop researching):**');
-        opts.alternatives.forEach((alt, i) => parts.push(`${i + 1}. ${alt}`));
-    }
-    // Continuation footer — push agents to keep going
-    if (opts.alternatives?.length) {
-        parts.push('');
-        parts.push('> This tool failed but your research should NOT stop. Use the alternatives above to continue gathering information from other sources.');
-    }
-    return parts.join('\n');
-}
-/**
- * Format a batch operation header with stats
- */
-export function formatBatchHeader(opts) {
-    const parts = [];
-    // Title with emoji based on success rate
-    const successRate = opts.totalItems > 0 ? opts.successful / opts.totalItems : 0;
-    const emoji = successRate === 1 ? '✓' : successRate >= 0.5 ? '⚠️' : '❌';
-    parts.push(`${emoji} ${opts.title}`);
-    parts.push('');
-    // Stats
-    parts.push(`• Total: ${opts.totalItems}`);
-    parts.push(`• Successful: ${opts.successful}`);
-    if (opts.failed > 0) {
-        parts.push(`• Failed: ${opts.failed}`);
-    }
-    if (opts.tokensPerItem) {
-        parts.push(`• Tokens/item: ~${opts.tokensPerItem.toLocaleString()}`);
-    }
-    if (opts.batches) {
-        parts.push(`• Batches: ${opts.batches}`);
-    }
-    // Extra stats
-    if (opts.extras) {
-        Object.entries(opts.extras).forEach(([key, val]) => {
-            parts.push(`• ${key}: ${val}`);
-        });
-    }
-    return parts.join('\n');
-}
-/**
- * Format a numbered list with optional metadata
- */
-export function formatList(items, options) {
-    const max = options?.maxItems ?? DEFAULT_MAX_ITEMS;
-    const numbered = options?.numbered ?? true;
-    const toShow = items.slice(0, max);
-    const remaining = items.length - max;
-    const lines = toShow.map((item, i) => {
-        const prefix = numbered ? `${i + 1}. ` : '• ';
-        let line = `${prefix}**${item.title}**`;
-        if (item.meta) {
-            line += ` (${item.meta})`;
-        }
-        if (item.description) {
-            line += `\n   ${item.description}`;
-        }
-        if (item.url) {
-            line += `\n   ${item.url}`;
-        }
-        return line;
-    });
-    if (remaining > 0) {
-        lines.push(`\n*...and ${remaining} more*`);
-    }
-    return lines.join('\n');
-}
-// ============================================================================
-// Duration Formatter
-// ============================================================================
-/**
- * Format duration in human-readable form
- */
-export function formatDuration(ms) {
-    if (ms < SECONDS_MS)
-        return `${ms}ms`;
-    if (ms < MINUTES_MS)
-        return `${(ms / SECONDS_MS).toFixed(1)}s`;
-    return `${(ms / MINUTES_MS).toFixed(1)}m`;
-}
-// ============================================================================
-// Text Truncation
-// ============================================================================
-/**
- * Truncate text to max length with ellipsis
- */
-export function truncateText(text, maxLength) {
-    if (text.length <= maxLength)
-        return text;
-    return text.slice(0, maxLength - 3) + '...';
-}
-//# sourceMappingURL=response.js.map

package/dist/utils/response.js.map

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

package/dist/utils/retry.d.ts

@@ -1,43 +0,0 @@
-/**
- * Shared retry and backoff utilities
- * Eliminates duplication across client modules
- */
-/** Base delay for exponential backoff (ms) */
-export declare const RETRY_BASE_DELAY_MS: 1000;
-/** Maximum backoff delay cap (ms) */
-export declare const RETRY_MAX_DELAY_MS: 30000;
-/** Jitter factor to prevent thundering herd */
-export declare const JITTER_FACTOR: 0.3;
-/** Exponential base for backoff calculation */
-export declare const EXPONENTIAL_BASE: 2;
-/** HTTP status codes that indicate a retryable server error */
-export declare const RETRYABLE_STATUS_CODES: readonly [429, 500, 502, 503, 504];
-export type RetryableStatusCode = typeof RETRYABLE_STATUS_CODES[number];
-/** Network-level error codes that are retryable */
-export declare const NETWORK_ERROR_CODES: readonly ["ECONNREFUSED", "ENOTFOUND", "ECONNRESET", "ECONNABORTED", "ETIMEDOUT", "EPIPE", "EAI_AGAIN"];
-export type NetworkErrorCode = typeof NETWORK_ERROR_CODES[number];
-/** Timeout-related error message substrings */
-export declare const TIMEOUT_ERROR_PATTERNS: readonly ["timeout", "timed out", "deadline exceeded"];
-/**
- * Calculate exponential backoff delay with jitter.
- * Formula: min(base * 2^attempt + random_jitter, maxDelay)
- *
- * @param attempt - Zero-based retry attempt number
- * @param baseDelayMs - Base delay in milliseconds (default: 1000)
- * @param maxDelayMs - Maximum delay cap in milliseconds (default: 30000)
- * @returns Delay in milliseconds with jitter applied
- */
-export declare function calculateBackoff(attempt: number, baseDelayMs?: number, maxDelayMs?: number): number;
-/**
- * Check if an HTTP status code is retryable
- */
-export declare function isRetryableStatus(status: number): boolean;
-/**
- * Check if an error code indicates a network-level failure
- */
-export declare function isNetworkError(code: string | undefined): boolean;
-/**
- * Check if an error message indicates a timeout
- */
-export declare function isTimeoutError(message: string): boolean;
-//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,EAAG,IAAc,CAAC;AAElD,qCAAqC;AACrC,eAAO,MAAM,kBAAkB,EAAG,KAAe,CAAC;AAElD,+CAA+C;AAC/C,eAAO,MAAM,aAAa,EAAG,GAAY,CAAC;AAE1C,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAI3C,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,oCAAqC,CAAC;AACzE,MAAM,MAAM,mBAAmB,GAAG,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAExE,mDAAmD;AACnD,eAAO,MAAM,mBAAmB,yGAA0G,CAAC;AAC3I,MAAM,MAAM,gBAAgB,GAAG,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAElE,+CAA+C;AAC/C,eAAO,MAAM,sBAAsB,wDAAyD,CAAC;AAI7F;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,MAA4B,EACzC,UAAU,GAAE,MAA2B,GACtC,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAGhE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGvD"}

package/dist/utils/retry.js

@@ -1,57 +0,0 @@
-/**
- * Shared retry and backoff utilities
- * Eliminates duplication across client modules
- */
-// ── Retry Constants ──
-/** Base delay for exponential backoff (ms) */
-export const RETRY_BASE_DELAY_MS = 1_000;
-/** Maximum backoff delay cap (ms) */
-export const RETRY_MAX_DELAY_MS = 30_000;
-/** Jitter factor to prevent thundering herd */
-export const JITTER_FACTOR = 0.3;
-/** Exponential base for backoff calculation */
-export const EXPONENTIAL_BASE = 2;
-// ── HTTP Status Constants ──
-/** HTTP status codes that indicate a retryable server error */
-export const RETRYABLE_STATUS_CODES = [429, 500, 502, 503, 504];
-/** Network-level error codes that are retryable */
-export const NETWORK_ERROR_CODES = ['ECONNREFUSED', 'ENOTFOUND', 'ECONNRESET', 'ECONNABORTED', 'ETIMEDOUT', 'EPIPE', 'EAI_AGAIN'];
-/** Timeout-related error message substrings */
-export const TIMEOUT_ERROR_PATTERNS = ['timeout', 'timed out', 'deadline exceeded'];
-// ── Backoff Calculation ──
-/**
- * Calculate exponential backoff delay with jitter.
- * Formula: min(base * 2^attempt + random_jitter, maxDelay)
- *
- * @param attempt - Zero-based retry attempt number
- * @param baseDelayMs - Base delay in milliseconds (default: 1000)
- * @param maxDelayMs - Maximum delay cap in milliseconds (default: 30000)
- * @returns Delay in milliseconds with jitter applied
- */
-export function calculateBackoff(attempt, baseDelayMs = RETRY_BASE_DELAY_MS, maxDelayMs = RETRY_MAX_DELAY_MS) {
-    const exponentialDelay = baseDelayMs * Math.pow(EXPONENTIAL_BASE, attempt);
-    const jitter = JITTER_FACTOR * exponentialDelay * Math.random();
-    return Math.min(exponentialDelay + jitter, maxDelayMs);
-}
-/**
- * Check if an HTTP status code is retryable
- */
-export function isRetryableStatus(status) {
-    return RETRYABLE_STATUS_CODES.includes(status);
-}
-/**
- * Check if an error code indicates a network-level failure
- */
-export function isNetworkError(code) {
-    if (!code)
-        return false;
-    return NETWORK_ERROR_CODES.includes(code);
-}
-/**
- * Check if an error message indicates a timeout
- */
-export function isTimeoutError(message) {
-    const lower = message.toLowerCase();
-    return TIMEOUT_ERROR_PATTERNS.some(pattern => lower.includes(pattern));
-}
-//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAwB;AAExB,8CAA8C;AAC9C,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAc,CAAC;AAElD,qCAAqC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAe,CAAC;AAElD,+CAA+C;AAC/C,MAAM,CAAC,MAAM,aAAa,GAAG,GAAY,CAAC;AAE1C,+CAA+C;AAC/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAU,CAAC;AAE3C,8BAA8B;AAE9B,+DAA+D;AAC/D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC;AAGzE,mDAAmD;AACnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,CAAU,CAAC;AAG3I,+CAA+C;AAC/C,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,mBAAmB,CAAU,CAAC;AAE7F,4BAA4B;AAE5B;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,cAAsB,mBAAmB,EACzC,aAAqB,kBAAkB;IAEvC,MAAM,gBAAgB,GAAG,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,aAAa,GAAG,gBAAgB,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAChE,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,GAAG,MAAM,EAAE,UAAU,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAQ,sBAA4C,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAwB;IACrD,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,OAAQ,mBAAyC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AACzE,CAAC"}

package/dist/utils/url-aggregator.d.ts

@@ -1,90 +0,0 @@
-/**
- * URL Aggregator Utility
- * Aggregates search results across multiple queries, calculates CTR-weighted scores,
- * and generates consensus-based rankings.
- */
-import type { KeywordSearchResult, RedditSearchResult } from '../clients/search.js';
-/**
- * Ranked URL with normalized score
- */
-interface RankedUrl {
-    readonly url: string;
-    readonly title: string;
-    readonly snippet: string;
-    readonly rank: number;
-    readonly score: number;
-    readonly frequency: number;
-    readonly positions: number[];
-    readonly queries: string[];
-    readonly bestPosition: number;
-    readonly isConsensus: boolean;
-}
-/**
- * Aggregation result containing all processed data
- */
-interface AggregationResult {
-    readonly rankedUrls: RankedUrl[];
-    readonly totalUniqueUrls: number;
-    readonly totalQueries: number;
-    readonly frequencyThreshold: number;
-    readonly thresholdNote?: string;
-}
-/**
- * Mark consensus status for a URL
- * Returns "✓" if frequency >= threshold, else "✗"
- */
-export declare function markConsensus(frequency: number): string;
-/**
- * Generate enhanced narrative output for consensus URLs
- */
-export declare function generateEnhancedOutput(rankedUrls: RankedUrl[], allKeywords: string[], totalUniqueUrls: number, frequencyThreshold: number, thresholdNote?: string): string;
-/**
- * Full aggregation pipeline with fallback thresholds
- * Tries ≥3, falls back to ≥2, then ≥1 if needed
- */
-export declare function aggregateAndRank(searches: KeywordSearchResult[], minConsensusUrls?: number): AggregationResult;
-/**
- * Build URL lookup map for quick consensus checking during result formatting
- */
-export declare function buildUrlLookup(rankedUrls: RankedUrl[]): Map<string, RankedUrl>;
-/**
- * Look up a URL in the ranked results
- */
-export declare function lookupUrl(url: string, lookup: Map<string, RankedUrl>): RankedUrl | undefined;
-/**
- * Ranked Reddit URL with normalized score
- */
-interface RankedRedditUrl {
-    readonly url: string;
-    readonly title: string;
-    readonly snippet: string;
-    readonly date?: string;
-    readonly rank: number;
-    readonly score: number;
-    readonly frequency: number;
-    readonly positions: number[];
-    readonly queries: string[];
-    readonly bestPosition: number;
-    readonly isConsensus: boolean;
-}
-/**
- * Reddit aggregation result
- */
-interface RedditAggregationResult {
-    readonly rankedUrls: RankedRedditUrl[];
-    readonly totalUniqueUrls: number;
-    readonly totalQueries: number;
-    readonly frequencyThreshold: number;
-    readonly thresholdNote?: string;
-}
-/**
- * Full Reddit aggregation pipeline with fallback thresholds
- */
-export declare function aggregateAndRankReddit(searches: Map<string, RedditSearchResult[]>, minConsensusUrls?: number): RedditAggregationResult;
-/**
- * Generate enhanced output for Reddit aggregated results
- * Now includes both aggregated view AND per-query raw results
- */
-export declare function generateRedditEnhancedOutput(aggregation: RedditAggregationResult, allQueries: string[], rawResults?: Map<string, RedditSearchResult[]>): string;
-export {};
-//# sourceMappingURL=url-aggregator.d.ts.map

package/dist/utils/url-aggregator.d.ts.map

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