mcp-researchpowerpack 3.9.4 → 4.3.0

package/dist/utils/errors.js

@@ -1,390 +0,0 @@
-/**
- * Robust error handling utilities for MCP server
- * Ensures the server NEVER crashes and always returns structured responses
- */
-import { mcpLog } from './logger.js';
-// ============================================================================
-// Error Codes (MCP-compliant)
-// ============================================================================
-export const ErrorCode = {
-    // Retryable errors
-    RATE_LIMITED: 'RATE_LIMITED',
-    TIMEOUT: 'TIMEOUT',
-    NETWORK_ERROR: 'NETWORK_ERROR',
-    SERVICE_UNAVAILABLE: 'SERVICE_UNAVAILABLE',
-    // Non-retryable errors
-    AUTH_ERROR: 'AUTH_ERROR',
-    INVALID_INPUT: 'INVALID_INPUT',
-    NOT_FOUND: 'NOT_FOUND',
-    QUOTA_EXCEEDED: 'QUOTA_EXCEEDED',
-    // Internal errors
-    INTERNAL_ERROR: 'INTERNAL_ERROR',
-    PARSE_ERROR: 'PARSE_ERROR',
-    UNKNOWN_ERROR: 'UNKNOWN_ERROR',
-};
-// ============================================================================
-// Constants
-// ============================================================================
-const MAX_ERROR_MSG_LENGTH = 500;
-const DEFAULT_RETRY_OPTIONS = {
-    maxRetries: 3,
-    baseDelayMs: 1000,
-    maxDelayMs: 30000,
-    retryableStatuses: [408, 429, 500, 502, 503, 504, 510],
-};
-// ============================================================================
-// Error Classification — Atomic Classifiers
-// ============================================================================
-/**
- * Classify DOMException (AbortError from AbortController timeouts)
- */
-function classifyDomException(error) {
-    if (error.name === 'AbortError') {
-        return { code: ErrorCode.TIMEOUT, message: 'Request timed out', retryable: true };
-    }
-    return { code: ErrorCode.UNKNOWN_ERROR, message: error.message.substring(0, MAX_ERROR_MSG_LENGTH), retryable: false };
-}
-/**
- * Classify by Node.js error codes (ECONNREFUSED, ENOTFOUND, etc.)
- * Returns null if no matching code is found.
- */
-function classifyByErrorCode(error) {
-    const errCode = error.code;
-    if (!errCode)
-        return null;
-    const networkErrorMessages = {
-        ECONNREFUSED: 'Connection refused — service may be down',
-        ECONNRESET: 'Connection was reset — please retry',
-        ECONNABORTED: 'Connection aborted — please retry',
-        ENOTFOUND: 'Service not reachable — check your network',
-        EPIPE: 'Connection lost — please retry',
-        EAI_AGAIN: 'DNS lookup failed — check your network',
-    };
-    if (errCode === 'ECONNREFUSED' || errCode === 'ENOTFOUND' || errCode === 'ECONNRESET') {
-        return { code: ErrorCode.NETWORK_ERROR, message: networkErrorMessages[errCode] || 'Network connection failed', retryable: true, cause: error.message };
-    }
-    if (errCode === 'ECONNABORTED' || errCode === 'ETIMEDOUT') {
-        return { code: ErrorCode.TIMEOUT, message: networkErrorMessages[errCode] || 'Request timed out', retryable: true, cause: error.message };
-    }
-    return null;
-}
-/**
- * Classify by HTTP status code extracted from error objects (axios-style, fetch-style, etc.)
- * Returns null if no status code is found.
- */
-function classifyByStatusCode(error) {
-    const status = error.response?.status || error.status || error.statusCode;
-    if (!status)
-        return null;
-    return classifyHttpError(status, error.message || String(error));
-}
-/**
- * Classify by error message patterns (timeout, rate-limit, auth, parse errors)
- * Returns null if no pattern matches.
- */
-function classifyByMessage(message) {
-    const lower = message.toLowerCase();
-    // Timeout patterns
-    if (lower.includes('timeout') || lower.includes('timed out') || lower.includes('aborterror')) {
-        return { code: ErrorCode.TIMEOUT, message: 'Request timed out', retryable: true, cause: message };
-    }
-    // Rate-limit patterns
-    if (lower.includes('rate limit') || lower.includes('too many requests')) {
-        return { code: ErrorCode.RATE_LIMITED, message: 'Rate limit exceeded', retryable: true, cause: message };
-    }
-    // API key errors
-    if (message.includes('API_KEY') || message.includes('api_key') || message.includes('Invalid API')) {
-        return { code: ErrorCode.AUTH_ERROR, message: 'API key missing or invalid', retryable: false, cause: message };
-    }
-    // Parse errors
-    if (message.includes('JSON') || message.includes('parse') || message.includes('Unexpected token')) {
-        return { code: ErrorCode.PARSE_ERROR, message: 'Failed to parse response', retryable: false, cause: message };
-    }
-    return null;
-}
-/**
- * Catch-all fallback classification when no other classifier matches.
- */
-function classifyFallback(message, cause) {
-    return {
-        code: ErrorCode.UNKNOWN_ERROR,
-        message: message.substring(0, MAX_ERROR_MSG_LENGTH),
-        retryable: false,
-        cause: cause ? String(cause) : undefined,
-    };
-}
-// ============================================================================
-// Main Error Classification Pipeline
-// ============================================================================
-/**
- * Classify any error into a structured format.
- * NEVER throws — always returns a valid StructuredError.
- */
-export function classifyError(error) {
-    if (error == null) {
-        return { code: ErrorCode.UNKNOWN_ERROR, message: 'An unknown error occurred', retryable: false };
-    }
-    if (error instanceof DOMException)
-        return classifyDomException(error);
-    if (!isErrorLike(error)) {
-        return { code: ErrorCode.UNKNOWN_ERROR, message: String(error).substring(0, MAX_ERROR_MSG_LENGTH), retryable: false };
-    }
-    return classifyByErrorCode(error)
-        ?? classifyByStatusCode(error)
-        ?? classifyByMessage(error.message ?? String(error))
-        ?? classifyFallback(error.message ?? String(error), error.cause);
-}
-/**
- * Type guard for error-like objects with common error properties
- */
-function isErrorLike(value) {
-    return typeof value === 'object' && value !== null;
-}
-/**
- * Classify HTTP status codes into structured errors.
- * Exhaustive switch with grouped default handling for unknown ranges.
- */
-function classifyHttpError(status, message) {
-    switch (status) {
-        case 400:
-            return { code: ErrorCode.INVALID_INPUT, message: 'Bad request', retryable: false, statusCode: status };
-        case 401:
-            return { code: ErrorCode.AUTH_ERROR, message: 'Invalid API key', retryable: false, statusCode: status };
-        case 403:
-            return { code: ErrorCode.QUOTA_EXCEEDED, message: 'Access forbidden or quota exceeded', retryable: false, statusCode: status };
-        case 404:
-            return { code: ErrorCode.NOT_FOUND, message: 'Resource not found', retryable: false, statusCode: status };
-        case 408:
-            return { code: ErrorCode.TIMEOUT, message: 'Request timeout', retryable: true, statusCode: status };
-        case 429:
-            return { code: ErrorCode.RATE_LIMITED, message: 'Rate limit exceeded', retryable: true, statusCode: status };
-        case 500:
-            return { code: ErrorCode.INTERNAL_ERROR, message: 'Server error', retryable: true, statusCode: status };
-        case 502:
-            return { code: ErrorCode.SERVICE_UNAVAILABLE, message: 'Bad gateway', retryable: true, statusCode: status };
-        case 503:
-            return { code: ErrorCode.SERVICE_UNAVAILABLE, message: 'Service unavailable', retryable: true, statusCode: status };
-        case 504:
-            return { code: ErrorCode.TIMEOUT, message: 'Gateway timeout', retryable: true, statusCode: status };
-        case 510:
-            return { code: ErrorCode.SERVICE_UNAVAILABLE, message: 'Request canceled', retryable: true, statusCode: status };
-        default:
-            if (status >= 500) {
-                return { code: ErrorCode.SERVICE_UNAVAILABLE, message: `Server error: ${status}`, retryable: true, statusCode: status };
-            }
-            if (status >= 400) {
-                return { code: ErrorCode.INVALID_INPUT, message: `Client error: ${status}`, retryable: false, statusCode: status };
-            }
-            return { code: ErrorCode.UNKNOWN_ERROR, message: `HTTP ${status}: ${message.substring(0, MAX_ERROR_MSG_LENGTH)}`, retryable: false, statusCode: status };
-    }
-}
-// ============================================================================
-// Retry Logic with Exponential Backoff
-// ============================================================================
-/**
- * Calculate delay with exponential backoff and jitter
- */
-function calculateBackoff(attempt, options) {
-    const exponentialDelay = options.baseDelayMs * Math.pow(2, attempt);
-    const jitter = Math.random() * 0.3 * exponentialDelay; // 0-30% jitter
-    return Math.min(exponentialDelay + jitter, options.maxDelayMs);
-}
-/**
- * Sleep utility that respects abort signals
- */
-export function sleep(ms, signal) {
-    return new Promise((resolve, reject) => {
-        if (signal?.aborted) {
-            reject(new DOMException('Aborted', 'AbortError'));
-            return;
-        }
-        function onAbort() {
-            clearTimeout(timeout);
-            reject(new DOMException('Aborted', 'AbortError'));
-        }
-        const timeout = setTimeout(() => {
-            if (signal)
-                signal.removeEventListener('abort', onAbort);
-            resolve();
-        }, ms);
-        signal?.addEventListener('abort', onAbort, { once: true });
-        // Re-check: signal may have aborted between initial check and listener registration
-        if (signal?.aborted) {
-            onAbort();
-        }
-    });
-}
-/**
- * Wrap a fetch call with timeout via AbortController
- */
-export function fetchWithTimeout(url, options = {}) {
-    const { timeoutMs = 30000, signal: externalSignal, ...fetchOptions } = options;
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
-    let onExternalAbort;
-    if (externalSignal) {
-        onExternalAbort = () => controller.abort();
-        externalSignal.addEventListener('abort', onExternalAbort, { once: true });
-        if (externalSignal.aborted) {
-            controller.abort();
-        }
-    }
-    return fetch(url, { ...fetchOptions, signal: controller.signal }).finally(() => {
-        clearTimeout(timeoutId);
-        if (externalSignal && onExternalAbort) {
-            externalSignal.removeEventListener('abort', onExternalAbort);
-        }
-    });
-}
-// ============================================================================
-// MCP Tool Error Response Types (for client-facing error responses)
-// ============================================================================
-/**
- * MCP-compliant error codes for tool responses
- * These codes are exposed to clients for programmatic error handling
- */
-export const MCP_ERROR_CODES = {
-    RATE_LIMITED: 'RATE_LIMITED',
-    NETWORK_ERROR: 'NETWORK_ERROR',
-    TIMEOUT: 'TIMEOUT',
-    VALIDATION_ERROR: 'VALIDATION_ERROR',
-    AUTH_ERROR: 'AUTH_ERROR',
-    NOT_FOUND: 'NOT_FOUND',
-    INTERNAL_ERROR: 'INTERNAL_ERROR',
-    SERVICE_UNAVAILABLE: 'SERVICE_UNAVAILABLE',
-};
-/**
- * Map internal ErrorCode to client-facing MCP_ERROR_CODES
- */
-function mapErrorCodeToMCP(code) {
-    switch (code) {
-        case ErrorCode.RATE_LIMITED:
-        case ErrorCode.QUOTA_EXCEEDED:
-            return MCP_ERROR_CODES.RATE_LIMITED;
-        case ErrorCode.TIMEOUT:
-            return MCP_ERROR_CODES.TIMEOUT;
-        case ErrorCode.NETWORK_ERROR:
-            return MCP_ERROR_CODES.NETWORK_ERROR;
-        case ErrorCode.SERVICE_UNAVAILABLE:
-            return MCP_ERROR_CODES.SERVICE_UNAVAILABLE;
-        case ErrorCode.AUTH_ERROR:
-            return MCP_ERROR_CODES.AUTH_ERROR;
-        case ErrorCode.NOT_FOUND:
-            return MCP_ERROR_CODES.NOT_FOUND;
-        case ErrorCode.INVALID_INPUT:
-        case ErrorCode.PARSE_ERROR:
-            return MCP_ERROR_CODES.VALIDATION_ERROR;
-        case ErrorCode.INTERNAL_ERROR:
-        case ErrorCode.UNKNOWN_ERROR:
-        default:
-            return MCP_ERROR_CODES.INTERNAL_ERROR;
-    }
-}
-/**
- * Create a standardized MCP tool error response
- * @param message - Human-readable error message
- * @param errorCode - Optional MCP error code for programmatic handling
- * @param retryAfter - Optional seconds to wait before retry (for rate limits)
- */
-function createToolError(message, errorCode, retryAfter) {
-    const response = {
-        content: [{ type: 'text', text: message }],
-        isError: true,
-    };
-    if (errorCode) {
-        response.errorCode = errorCode;
-    }
-    if (retryAfter !== undefined && retryAfter > 0) {
-        response.retryAfter = retryAfter;
-    }
-    return response;
-}
-/**
- * Create a tool error response from a StructuredError
- * Automatically maps error codes and calculates retryAfter for rate limits
- */
-export function createToolErrorFromStructured(structuredError, attempt = 0) {
-    const errorCode = mapErrorCodeToMCP(structuredError.code);
-    // Calculate retryAfter for rate-limited errors
-    let retryAfter;
-    if (structuredError.retryable && errorCode === MCP_ERROR_CODES.RATE_LIMITED) {
-        retryAfter = Math.ceil(calculateBackoff(attempt, DEFAULT_RETRY_OPTIONS) / 1000);
-    }
-    // Format user-friendly error message
-    const retryHint = structuredError.retryable
-        ? '\n\n💡 This error may be temporary. Try again in a moment.'
-        : '';
-    const errorText = `## ❌ Error\n\n**${structuredError.code}:** ${structuredError.message}${retryHint}\n\nPlease check your input parameters and try again.`;
-    return createToolError(errorText, errorCode, retryAfter);
-}
-// ============================================================================
-// Stability Wrappers — Network resilience for LLM API calls
-// ============================================================================
-/**
- * Wrap a promise with a hard deadline timeout.
- * If the promise doesn't resolve/reject within `timeoutMs`, it rejects with a timeout error.
- * Uses AbortController to signal cancellation to the underlying request.
- */
-export function withRequestTimeout(fn, timeoutMs, label = 'request') {
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
-    return fn(controller.signal).finally(() => clearTimeout(timeoutId)).catch((err) => {
-        if (controller.signal.aborted && err instanceof DOMException && err.name === 'AbortError') {
-            throw Object.assign(new Error('Request timed out — please try again'), {
-                code: 'ETIMEDOUT',
-                retryable: true,
-            });
-        }
-        throw err;
-    });
-}
-/**
- * Wrap a non-streaming API call with activity-based timeout detection.
- * If the call hasn't completed within `stallMs`, abort and retry.
- * This catches "stuck" connections where TCP stays open but no data flows.
- *
- * @param fn - Async function that accepts an AbortSignal
- * @param stallMs - Max milliseconds to wait for the call to complete before considering it stuck
- * @param maxAttempts - Max retry attempts for stalled requests
- * @param label - Label for log messages
- * @returns The result of the function
- */
-export async function withStallProtection(fn, stallMs, maxAttempts = 2, label = 'request') {
-    for (let attempt = 0; attempt < maxAttempts; attempt++) {
-        const controller = new AbortController();
-        let stallTimer;
-        const stallPromise = new Promise((_, reject) => {
-            stallTimer = setTimeout(() => {
-                controller.abort();
-                reject(Object.assign(new Error(`Service temporarily unavailable — no response received (attempt ${attempt + 1}/${maxAttempts})`), {
-                    code: 'ESTALLED',
-                    retryable: attempt < maxAttempts - 1,
-                }));
-            }, stallMs);
-        });
-        let fnPromise;
-        try {
-            fnPromise = fn(controller.signal);
-            const result = await Promise.race([fnPromise, stallPromise]);
-            clearTimeout(stallTimer);
-            return result;
-        }
-        catch (err) {
-            // Suppress unhandled rejection from the losing promise
-            // (e.g. fnPromise rejects after stallPromise wins the race)
-            fnPromise?.catch(() => { });
-            clearTimeout(stallTimer);
-            const isStall = err instanceof Error && err.code === 'ESTALLED';
-            if (isStall && attempt < maxAttempts - 1) {
-                const backoff = calculateBackoff(attempt, DEFAULT_RETRY_OPTIONS);
-                mcpLog('warning', `${label} stalled, retrying in ${backoff}ms (attempt ${attempt + 1})`, 'stability');
-                await sleep(backoff);
-                continue;
-            }
-            throw err;
-        }
-    }
-    // Should never reach here, but TypeScript needs it
-    throw new Error(`${label} failed after ${maxAttempts} stall-protection attempts`);
-}
-//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/logger.d.ts

@@ -1,39 +0,0 @@
-/**
- * MCP SDK Structured Logging Utility
- *
- * Sends log messages to MCP clients via server.sendLoggingMessage().
- * Falls back to stderr before the server is initialized.
- */
-import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
-export type LogLevel = 'debug' | 'info' | 'warning' | 'error';
-/**
- * Initialize the logger with an MCP server reference.
- * Must be called after server creation and before any tool execution.
- */
-export declare function initLogger(server: Server): void;
-/**
- * Log message via MCP SDK structured logging.
- * Falls back to stderr if the server isn't initialized yet.
- * @param level - Log level
- * @param message - Message to log
- * @param tool - Tool/logger name for context
- */
-export declare function mcpLog(level: LogLevel, message: string, tool?: string): void;
-/**
- * Safe log that catches any errors (never crashes)
- * @param level - Log level
- * @param message - Message to log
- * @param tool - Tool name for context
- */
-export declare function safeLog(level: LogLevel, message: string, tool?: string): void;
-/**
- * Create a bound logger for a specific tool
- */
-export declare function createToolLogger(tool: string): {
-    debug: (msg: string) => void;
-    info: (msg: string) => void;
-    warning: (msg: string) => void;
-    error: (msg: string) => void;
-};
-export type ToolLogger = ReturnType<typeof createToolLogger>;
-//# sourceMappingURL=logger.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAExE,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAI9D;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAQ5E;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAM7E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM;iBAE5B,MAAM;gBACP,MAAM;mBACH,MAAM;iBACR,MAAM;EAEtB;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/utils/logger.js

@@ -1,57 +0,0 @@
-/**
- * MCP SDK Structured Logging Utility
- *
- * Sends log messages to MCP clients via server.sendLoggingMessage().
- * Falls back to stderr before the server is initialized.
- */
-let serverRef = null;
-/**
- * Initialize the logger with an MCP server reference.
- * Must be called after server creation and before any tool execution.
- */
-export function initLogger(server) {
-    serverRef = server;
-}
-/**
- * Log message via MCP SDK structured logging.
- * Falls back to stderr if the server isn't initialized yet.
- * @param level - Log level
- * @param message - Message to log
- * @param tool - Tool/logger name for context
- */
-export function mcpLog(level, message, tool) {
-    const logger = tool ?? 'research-powerpack';
-    if (serverRef) {
-        serverRef.sendLoggingMessage({ level, data: message, logger }).catch(() => { });
-    }
-    else {
-        // Fallback to stderr before MCP transport is connected
-        console.error(`[${logger}] ${message}`);
-    }
-}
-/**
- * Safe log that catches any errors (never crashes)
- * @param level - Log level
- * @param message - Message to log
- * @param tool - Tool name for context
- */
-export function safeLog(level, message, tool) {
-    try {
-        mcpLog(level, message, tool);
-    }
-    catch {
-        // Swallow logging errors - never crash
-    }
-}
-/**
- * Create a bound logger for a specific tool
- */
-export function createToolLogger(tool) {
-    return {
-        debug: (msg) => safeLog('debug', msg, tool),
-        info: (msg) => safeLog('info', msg, tool),
-        warning: (msg) => safeLog('warning', msg, tool),
-        error: (msg) => safeLog('error', msg, tool),
-    };
-}
-//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,IAAI,SAAS,GAAkB,IAAI,CAAC;AAEpC;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,SAAS,GAAG,MAAM,CAAC;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,KAAe,EAAE,OAAe,EAAE,IAAa;IACpE,MAAM,MAAM,GAAG,IAAI,IAAI,oBAAoB,CAAC;IAC5C,IAAI,SAAS,EAAE,CAAC;QACd,SAAS,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACjF,CAAC;SAAM,CAAC;QACN,uDAAuD;QACvD,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,KAAe,EAAE,OAAe,EAAE,IAAa;IACrE,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,uCAAuC;IACzC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO;QACL,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;QACnD,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;QACjD,OAAO,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC;QACvD,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;KACpD,CAAC;AACJ,CAAC"}

package/dist/utils/markdown-formatter.d.ts

@@ -1,5 +0,0 @@
-/**
- * Markdown formatting utilities
- */
-export declare function removeMetaTags(content: string): string;
-//# sourceMappingURL=markdown-formatter.d.ts.map

package/dist/utils/markdown-formatter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"markdown-formatter.d.ts","sourceRoot":"","sources":["../../src/utils/markdown-formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAYtD"}

package/dist/utils/markdown-formatter.js

@@ -1,15 +0,0 @@
-/**
- * Markdown formatting utilities
- */
-export function removeMetaTags(content) {
-    if (!content || typeof content !== 'string') {
-        return content;
-    }
-    const lines = content.split('\n');
-    const filteredLines = lines.filter(line => {
-        const trimmed = line.trim();
-        return !trimmed.startsWith('- Meta:') && !trimmed.startsWith('Meta:');
-    });
-    return filteredLines.join('\n');
-}
-//# sourceMappingURL=markdown-formatter.js.map

package/dist/utils/markdown-formatter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"markdown-formatter.js","sourceRoot":"","sources":["../../src/utils/markdown-formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC"}

package/dist/utils/response.d.ts

@@ -1,93 +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 declare const DEFAULT_MAX_ITEMS: 20;
-/** Maximum snippet length before truncation in URL aggregator output */
-export declare const MAX_SNIPPET_LENGTH: 200;
-export interface SuccessOptions {
-    /** Title/header for the response */
-    readonly title: string;
-    /** Summary section (70% of content) */
-    readonly summary: string;
-    /** Optional data section (20% of content) */
-    readonly data?: string;
-    /** Optional next steps (10% of content) */
-    readonly nextSteps?: string[];
-    /** Optional metadata footer */
-    readonly metadata?: Record<string, string | number>;
-}
-/**
- * Format a successful response using 70/20/10 pattern
- */
-export declare function formatSuccess(opts: SuccessOptions): string;
-export interface ErrorOptions {
-    /** Error code (e.g., RATE_LIMITED, TIMEOUT) */
-    readonly code: string;
-    /** Human-readable error message */
-    readonly message: string;
-    /** Is this error retryable? */
-    readonly retryable?: boolean;
-    /** How to fix the error */
-    readonly howToFix?: string[];
-    /** Alternative actions */
-    readonly alternatives?: string[];
-    /** Tool name for context */
-    readonly toolName?: string;
-}
-/**
- * Format an error response with recovery guidance
- * Designed to keep agents moving — every error includes actionable alternatives
- */
-export declare function formatError(opts: ErrorOptions): string;
-export interface BatchHeaderOptions {
-    /** Batch operation title */
-    readonly title: string;
-    /** Total items attempted */
-    readonly totalItems: number;
-    /** Successfully processed count */
-    readonly successful: number;
-    /** Failed count */
-    readonly failed: number;
-    /** Optional tokens per item */
-    readonly tokensPerItem?: number;
-    /** Optional batch count */
-    readonly batches?: number;
-    /** Extra stats to include */
-    readonly extras?: Record<string, string | number>;
-}
-/**
- * Format a batch operation header with stats
- */
-export declare function formatBatchHeader(opts: BatchHeaderOptions): string;
-export interface ListItem {
-    /** Item title/name */
-    readonly title: string;
-    /** Optional description */
-    readonly description?: string;
-    /** Optional metadata */
-    readonly meta?: string;
-    /** Optional URL */
-    readonly url?: string;
-}
-/**
- * Format a numbered list with optional metadata
- */
-export declare function formatList(items: ListItem[], options?: {
-    maxItems?: number;
-    numbered?: boolean;
-}): string;
-/**
- * Format duration in human-readable form
- */
-export declare function formatDuration(ms: number): string;
-/**
- * Truncate text to max length with ellipsis
- */
-export declare function truncateText(text: string, maxLength: number): string;
-//# sourceMappingURL=response.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/utils/response.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,EAAG,EAAW,CAAC;AAE7C,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,EAAG,GAAY,CAAC;AAU/C,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAoC1D;AAMD,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,0BAA0B;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAKD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAuCtD;AAMD,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mCAAmC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mBAAmB;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,2BAA2B;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CA8BlE;AAMD,MAAM,WAAW,QAAQ;IACvB,sBAAsB;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,wBAAwB;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB;IACnB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CA0BzG;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIjD;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGpE"}