mcp-researchpowerpack 3.6.9

package/dist/clients/reddit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reddit.d.ts","sourceRoot":"","sources":["../../src/clients/reddit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,UAAU,IAAI;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC,CAAC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AAED,UAAU,iBAAiB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAK/E;AAcD,qBAAa,YAAY;IAKX,OAAO,CAAC,QAAQ;IAAU,OAAO,CAAC,YAAY;IAF1D,OAAO,CAAC,SAAS,CAA6D;gBAE1D,QAAQ,EAAE,MAAM,EAAU,YAAY,EAAE,MAAM;IAElE;;;;;OAKG;YACW,IAAI;IAqBlB;;OAEG;YACW,WAAW;IAuEzB,OAAO,CAAC,QAAQ;IAKhB;;;OAGG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,SAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA2GlE,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,eAAe;IA4BjB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,SAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC,CAAC;IAarF,aAAa,CACjB,IAAI,EAAE,MAAM,EAAE,EACd,mBAAmB,CAAC,EAAE,MAAM,EAC5B,aAAa,UAAO,EACpB,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,GACpF,OAAO,CAAC,eAAe,CAAC;CAqD5B"}

package/dist/clients/reddit.js

@@ -0,0 +1,305 @@
+/**
+ * Reddit OAuth API Client
+ * Fetches posts and comments sorted by score (most upvoted first)
+ * Implements robust error handling that NEVER crashes
+ */
+import { REDDIT } from '../config/index.js';
+import { USER_AGENT_VERSION } from '../version.js';
+import { classifyError, fetchWithTimeout, sleep, ErrorCode, } from '../utils/errors.js';
+import { pMap, pMapSettled } from '../utils/concurrency.js';
+import { mcpLog } from '../utils/logger.js';
+export function calculateCommentAllocation(postCount) {
+    const totalBudget = REDDIT.MAX_COMMENT_BUDGET;
+    const perPostBase = Math.floor(totalBudget / postCount);
+    const perPostCapped = Math.min(perPostBase, REDDIT.MAX_COMMENTS_PER_POST);
+    return { totalBudget, perPostBase, perPostCapped, redistributed: false };
+}
+// ============================================================================
+// Module-Level Token Cache (shared across all RedditClient instances)
+// ============================================================================
+let cachedToken = null;
+let cachedTokenExpiry = 0;
+// Token cache logging only when DEBUG env is set
+const DEBUG_TOKEN_CACHE = process.env.DEBUG_REDDIT === 'true';
+// Pending auth promise for deduplicating concurrent auth calls
+let pendingAuthPromise = null;
+export class RedditClient {
+    clientId;
+    clientSecret;
+    // Instance-level references (now point to module cache)
+    // User agent uses centralized version from package.json - auto-synced!
+    userAgent = `script:${USER_AGENT_VERSION} (by /u/research-powerpack)`;
+    constructor(clientId, clientSecret) {
+        this.clientId = clientId;
+        this.clientSecret = clientSecret;
+    }
+    /**
+     * Authenticate with Reddit API with retry logic
+     * Uses module-level token cache and promise deduplication to prevent
+     * concurrent auth calls from firing multiple token requests
+     * Returns null on failure instead of throwing
+     */
+    async auth() {
+        // Return module-cached token if still valid (with 60s buffer)
+        if (cachedToken && Date.now() < cachedTokenExpiry - 60000) {
+            if (DEBUG_TOKEN_CACHE)
+                console.error('[RedditClient] Token cache HIT');
+            return cachedToken;
+        }
+        // Deduplicate concurrent auth calls - if one is already in flight, await it
+        if (pendingAuthPromise) {
+            if (DEBUG_TOKEN_CACHE)
+                console.error('[RedditClient] Auth already in flight, awaiting...');
+            return pendingAuthPromise;
+        }
+        pendingAuthPromise = this.performAuth();
+        try {
+            return await pendingAuthPromise;
+        }
+        finally {
+            pendingAuthPromise = null;
+        }
+    }
+    /**
+     * Internal auth implementation - called only once per cache miss
+     */
+    async performAuth() {
+        if (DEBUG_TOKEN_CACHE)
+            console.error('[RedditClient] Token cache MISS - authenticating');
+        const credentials = Buffer.from(`${this.clientId}:${this.clientSecret}`).toString('base64');
+        for (let attempt = 0; attempt < 3; attempt++) {
+            try {
+                const res = await fetchWithTimeout('https://www.reddit.com/api/v1/access_token', {
+                    method: 'POST',
+                    headers: {
+                        'Authorization': `Basic ${credentials}`,
+                        'Content-Type': 'application/x-www-form-urlencoded',
+                        'User-Agent': this.userAgent,
+                    },
+                    body: 'grant_type=client_credentials',
+                    timeoutMs: 15000,
+                });
+                if (!res.ok) {
+                    const text = await res.text().catch(() => '');
+                    mcpLog('error', `Auth failed (${res.status}): ${text}`, 'reddit');
+                    // 401/403 are not retryable - invalidate cache
+                    if (res.status === 401 || res.status === 403) {
+                        cachedToken = null;
+                        cachedTokenExpiry = 0;
+                        return null;
+                    }
+                    // Retry on server errors
+                    if (res.status >= 500 && attempt < 2) {
+                        await sleep(REDDIT.RETRY_DELAYS[attempt] || 2000);
+                        continue;
+                    }
+                    return null;
+                }
+                const data = await res.json();
+                if (!data.access_token) {
+                    mcpLog('error', 'Auth response missing access_token', 'reddit');
+                    return null;
+                }
+                // Update module-level cache (shared across all instances)
+                cachedToken = data.access_token;
+                cachedTokenExpiry = Date.now() + (data.expires_in || 3600) * 1000;
+                return cachedToken;
+            }
+            catch (error) {
+                const err = classifyError(error);
+                mcpLog('error', `Auth error (attempt ${attempt + 1}): ${err.message}`, 'reddit');
+                // Invalidate cache on auth errors
+                if (err.code === ErrorCode.AUTH_ERROR) {
+                    cachedToken = null;
+                    cachedTokenExpiry = 0;
+                }
+                if (attempt < 2 && err.retryable) {
+                    await sleep(REDDIT.RETRY_DELAYS[attempt] || 2000);
+                    continue;
+                }
+                return null;
+            }
+        }
+        return null;
+    }
+    parseUrl(url) {
+        const m = url.match(/reddit\.com\/r\/([^\/]+)\/comments\/([a-z0-9]+)/i);
+        return m ? { sub: m[1], id: m[2] } : null;
+    }
+    /**
+     * Get a single Reddit post with comments
+     * Returns PostResult or throws Error (for use with Promise.allSettled)
+     */
+    async getPost(url, maxComments = 100) {
+        const parsed = this.parseUrl(url);
+        if (!parsed) {
+            throw new Error(`Invalid Reddit URL format: ${url}`);
+        }
+        // Auth - returns null on failure
+        const token = await this.auth();
+        if (!token) {
+            throw new Error('Reddit authentication failed - check credentials');
+        }
+        const limit = Math.min(maxComments, 500);
+        let lastError = null;
+        for (let attempt = 0; attempt < REDDIT.RETRY_COUNT; attempt++) {
+            try {
+                const apiUrl = `https://oauth.reddit.com/r/${parsed.sub}/comments/${parsed.id}?sort=top&limit=${limit}&depth=10&raw_json=1`;
+                const res = await fetchWithTimeout(apiUrl, {
+                    headers: {
+                        'Authorization': `Bearer ${token}`,
+                        'User-Agent': this.userAgent,
+                    },
+                    timeoutMs: 30000,
+                });
+                // Rate limited - always retry with backoff
+                if (res.status === 429) {
+                    const delay = REDDIT.RETRY_DELAYS[attempt] || 32000;
+                    mcpLog('warning', `Rate limited. Retry ${attempt + 1}/${REDDIT.RETRY_COUNT} after ${delay}ms`, 'reddit');
+                    await sleep(delay);
+                    continue;
+                }
+                // 404 - Post doesn't exist
+                if (res.status === 404) {
+                    throw new Error(`Post not found: ${url}`);
+                }
+                // Other errors
+                if (!res.ok) {
+                    lastError = classifyError({ status: res.status });
+                    if (lastError.retryable && attempt < REDDIT.RETRY_COUNT - 1) {
+                        const delay = REDDIT.RETRY_DELAYS[attempt] || 2000;
+                        mcpLog('warning', `API error ${res.status}. Retry ${attempt + 1}/${REDDIT.RETRY_COUNT}`, 'reddit');
+                        await sleep(delay);
+                        continue;
+                    }
+                    throw new Error(`Reddit API error: ${res.status}`);
+                }
+                // Parse response safely
+                let data;
+                try {
+                    data = await res.json();
+                }
+                catch (parseError) {
+                    throw new Error('Failed to parse Reddit API response');
+                }
+                const [postListing, commentListing] = data;
+                const p = postListing?.data?.children?.[0]?.data;
+                if (!p) {
+                    throw new Error(`Post data not found in response: ${url}`);
+                }
+                const post = {
+                    title: p.title || 'Untitled',
+                    author: p.author || '[deleted]',
+                    subreddit: p.subreddit || parsed.sub,
+                    body: this.formatBody(p),
+                    score: p.score || 0,
+                    commentCount: p.num_comments || 0,
+                    url: `https://reddit.com${p.permalink || ''}`,
+                    created: new Date((p.created_utc || 0) * 1000),
+                    flair: p.link_flair_text || undefined,
+                    isNsfw: p.over_18 || false,
+                    isPinned: p.stickied || false,
+                };
+                const comments = this.extractComments(commentListing?.data?.children || [], maxComments, post.author);
+                return { post, comments, allocatedComments: maxComments, actualComments: post.commentCount };
+            }
+            catch (error) {
+                lastError = classifyError(error);
+                // Don't retry non-retryable errors
+                if (!lastError.retryable) {
+                    throw error instanceof Error ? error : new Error(lastError.message);
+                }
+                if (attempt < REDDIT.RETRY_COUNT - 1) {
+                    const delay = REDDIT.RETRY_DELAYS[attempt] || 2000;
+                    mcpLog('warning', `${lastError.code}: ${lastError.message}. Retry ${attempt + 1}/${REDDIT.RETRY_COUNT}`, 'reddit');
+                    await sleep(delay);
+                }
+            }
+        }
+        // All retries exhausted
+        throw new Error(lastError?.message || 'Failed to fetch Reddit post after retries');
+    }
+    formatBody(p) {
+        if (p.selftext?.trim())
+            return p.selftext;
+        if (p.is_self)
+            return '';
+        if (p.url)
+            return `**Link:** ${p.url}`;
+        return '';
+    }
+    extractComments(children, maxComments, opAuthor) {
+        const result = [];
+        const extract = (items, depth = 0) => {
+            const sorted = [...items].sort((a, b) => (b.data?.score || 0) - (a.data?.score || 0));
+            for (const c of sorted) {
+                if (result.length >= maxComments)
+                    return;
+                if (c.kind !== 't1' || !c.data?.author || c.data.author === '[deleted]')
+                    continue;
+                result.push({
+                    author: c.data.author,
+                    body: c.data.body || '',
+                    score: c.data.score || 0,
+                    depth,
+                    isOP: c.data.author === opAuthor,
+                });
+                if (c.data.replies?.data?.children && result.length < maxComments) {
+                    extract(c.data.replies.data.children, depth + 1);
+                }
+            }
+        };
+        extract(children);
+        return result;
+    }
+    async getPosts(urls, maxComments = 100) {
+        if (urls.length <= REDDIT.BATCH_SIZE) {
+            // Limit to 5 concurrent Reddit API calls
+            const results = await pMap(urls, u => this.getPost(u, maxComments).catch(e => e), 5);
+            return new Map(urls.map((u, i) => [u, results[i]]));
+        }
+        return (await this.batchGetPosts(urls, maxComments)).results;
+    }
+    async batchGetPosts(urls, maxCommentsOverride, fetchComments = true, onBatchComplete) {
+        const totalBatches = Math.ceil(urls.length / REDDIT.BATCH_SIZE);
+        const allResults = new Map();
+        let rateLimitHits = 0;
+        const allocation = calculateCommentAllocation(urls.length);
+        const commentsPerPost = fetchComments ? (maxCommentsOverride || allocation.perPostCapped) : 0;
+        mcpLog('info', `Fetching ${urls.length} posts in ${totalBatches} batch(es), ${commentsPerPost} comments/post`, 'reddit');
+        for (let batchNum = 0; batchNum < totalBatches; batchNum++) {
+            const startIdx = batchNum * REDDIT.BATCH_SIZE;
+            const batchUrls = urls.slice(startIdx, startIdx + REDDIT.BATCH_SIZE);
+            mcpLog('info', `Batch ${batchNum + 1}/${totalBatches} (${batchUrls.length} posts)`, 'reddit');
+            // Limit to 5 concurrent Reddit API calls within each batch
+            const batchResults = await pMapSettled(batchUrls, url => this.getPost(url, commentsPerPost), 5);
+            for (let i = 0; i < batchResults.length; i++) {
+                const result = batchResults[i];
+                const url = batchUrls[i] || '';
+                if (result.status === 'fulfilled') {
+                    allResults.set(url, result.value);
+                }
+                else {
+                    const errorMsg = result.reason?.message || String(result.reason);
+                    if (errorMsg.includes('429') || errorMsg.includes('rate'))
+                        rateLimitHits++;
+                    allResults.set(url, new Error(errorMsg));
+                }
+            }
+            // Safe callback invocation
+            try {
+                onBatchComplete?.(batchNum + 1, totalBatches, allResults.size);
+            }
+            catch (callbackError) {
+                mcpLog('error', `onBatchComplete callback error: ${callbackError}`, 'reddit');
+            }
+            mcpLog('info', `Batch ${batchNum + 1} complete (${allResults.size}/${urls.length})`, 'reddit');
+            // Small delay between batches
+            if (batchNum < totalBatches - 1) {
+                await sleep(500);
+            }
+        }
+        return { results: allResults, batchesProcessed: totalBatches, totalPosts: urls.length, rateLimitHits, commentAllocation: allocation };
+    }
+}
+//# sourceMappingURL=reddit.js.map

package/dist/clients/reddit.js.map

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

package/dist/clients/research.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Deep Research Client
+ * Handles research API requests with web search capabilities
+ * Implements robust retry logic and NEVER crashes the server
+ */
+import { type StructuredError } from '../utils/errors.js';
+interface ResearchParams {
+    question: string;
+    systemPrompt?: string;
+    reasoningEffort?: 'low' | 'medium' | 'high';
+    maxSearchResults?: number;
+    maxTokens?: number;
+    temperature?: number;
+    responseFormat?: {
+        type: 'json_object' | 'text';
+    };
+}
+export interface ResearchResponse {
+    id: string;
+    model: string;
+    created: number;
+    content: string;
+    finishReason?: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+        sourcesUsed?: number;
+    };
+    annotations?: Array<{
+        type: 'url_citation';
+        url: string;
+        title: string;
+        startIndex: number;
+        endIndex: number;
+    }>;
+    error?: StructuredError;
+}
+export declare class ResearchClient {
+    private client;
+    constructor();
+    /**
+     * Check if an error is retryable for research requests
+     */
+    private isRetryableError;
+    /**
+     * Calculate backoff for research retries
+     */
+    private calculateBackoff;
+    /**
+     * Build request payload based on model type
+     * Gemini models use tools with google_search, others use search_parameters
+     */
+    private buildRequestPayload;
+    /**
+     * Execute a single research request with a specific model
+     */
+    private executeResearch;
+    /**
+     * Perform research with retry logic and fallback to secondary model
+     * Returns a ResearchResponse - may contain error field on failure
+     * NEVER throws - always returns a valid response object
+     */
+    research(params: ResearchParams): Promise<ResearchResponse>;
+}
+export {};
+//# sourceMappingURL=research.d.ts.map

package/dist/clients/research.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../src/clients/research.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAG5B,UAAU,cAAc;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE;QAAE,IAAI,EAAE,aAAa,GAAG,MAAM,CAAA;KAAE,CAAC;CACnD;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,IAAI,EAAE,cAAc,CAAC;QACrB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AA4BD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;;IAevB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA6BxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAqD3B;;OAEG;YACW,eAAe;IA+F7B;;;;OAIG;IACG,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAkElE"}

package/dist/clients/research.js

@@ -0,0 +1,252 @@
+/**
+ * Deep Research Client
+ * Handles research API requests with web search capabilities
+ * Implements robust retry logic and NEVER crashes the server
+ */
+import OpenAI from 'openai';
+import { RESEARCH } from '../config/index.js';
+import { classifyError, sleep, ErrorCode, } from '../utils/errors.js';
+import { mcpLog } from '../utils/logger.js';
+// Research-specific retry configuration
+// Research requests can be long-running, so we use longer delays
+const RESEARCH_RETRY_CONFIG = {
+    maxRetries: 3, // 3 retries for robustness on transient failures
+    baseDelayMs: 5000, // Longer base delay
+    maxDelayMs: 60000,
+};
+// Retryable status codes for research API
+const RETRYABLE_RESEARCH_CODES = new Set([429, 500, 502, 503, 504]);
+// Models that use Gemini-style google_search tool instead of search_parameters
+const GEMINI_STYLE_MODELS = new Set([
+    'google/gemini-2.5-flash',
+    'google/gemini-2.5-pro',
+    'google/gemini-2.0-flash',
+    'google/gemini-pro',
+]);
+/**
+ * Check if a model uses Gemini-style google_search tool
+ */
+function isGeminiStyleModel(model) {
+    return GEMINI_STYLE_MODELS.has(model) || model.startsWith('google/gemini');
+}
+export class ResearchClient {
+    client;
+    constructor() {
+        if (!RESEARCH.API_KEY) {
+            throw new Error('OPENROUTER_API_KEY is required for research');
+        }
+        this.client = new OpenAI({
+            baseURL: RESEARCH.BASE_URL,
+            apiKey: RESEARCH.API_KEY,
+            timeout: RESEARCH.TIMEOUT_MS,
+            maxRetries: 0, // We handle retries ourselves
+        });
+    }
+    /**
+     * Check if an error is retryable for research requests
+     */
+    isRetryableError(error) {
+        if (!error)
+            return false;
+        const err = error;
+        // Check HTTP status codes
+        if (err.status && RETRYABLE_RESEARCH_CODES.has(err.status)) {
+            return true;
+        }
+        // Check message patterns
+        const message = (err.message || '').toLowerCase();
+        if (message.includes('rate limit') ||
+            message.includes('timeout') ||
+            message.includes('timed out') ||
+            message.includes('service unavailable') ||
+            message.includes('connection')) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Calculate backoff for research retries
+     */
+    calculateBackoff(attempt) {
+        const exponentialDelay = RESEARCH_RETRY_CONFIG.baseDelayMs * Math.pow(2, attempt);
+        const jitter = Math.random() * 0.3 * exponentialDelay;
+        return Math.min(exponentialDelay + jitter, RESEARCH_RETRY_CONFIG.maxDelayMs);
+    }
+    /**
+     * Build request payload based on model type
+     * Gemini models use tools with google_search, others use search_parameters
+     */
+    buildRequestPayload(model, messages, options) {
+        const { temperature, reasoningEffort, maxTokens, maxSearchResults, responseFormat } = options;
+        if (isGeminiStyleModel(model)) {
+            // Gemini uses tools with google_search
+            const payload = {
+                model,
+                messages,
+                temperature,
+                max_tokens: maxTokens,
+                tools: [
+                    {
+                        type: 'google_search',
+                        googleSearch: {},
+                    },
+                ],
+            };
+            if (responseFormat) {
+                payload.response_format = responseFormat;
+            }
+            return payload;
+        }
+        // Default: use search_parameters (for Grok, Perplexity, etc.)
+        const payload = {
+            model,
+            messages,
+            temperature,
+            reasoning_effort: reasoningEffort,
+            max_completion_tokens: maxTokens,
+            search_parameters: {
+                mode: 'on',
+                max_search_results: Math.min(maxSearchResults, 30),
+                return_citations: true,
+                sources: [{ type: 'web' }],
+            },
+        };
+        if (responseFormat) {
+            payload.response_format = responseFormat;
+        }
+        return payload;
+    }
+    /**
+     * Execute a single research request with a specific model
+     */
+    async executeResearch(model, messages, options) {
+        const requestPayload = this.buildRequestPayload(model, messages, options);
+        let lastError;
+        // Retry loop for this model
+        for (let attempt = 0; attempt <= RESEARCH_RETRY_CONFIG.maxRetries; attempt++) {
+            try {
+                if (attempt > 0) {
+                    mcpLog('warning', `Retry attempt ${attempt}/${RESEARCH_RETRY_CONFIG.maxRetries} for ${model}`, 'research');
+                }
+                const response = await this.client.chat.completions.create(requestPayload);
+                const choice = response.choices?.[0];
+                const message = choice?.message;
+                // Validate response
+                if (!message?.content && !choice) {
+                    lastError = {
+                        code: ErrorCode.INTERNAL_ERROR,
+                        message: 'Research API returned empty response',
+                        retryable: true,
+                    };
+                    if (attempt < RESEARCH_RETRY_CONFIG.maxRetries) {
+                        const delayMs = this.calculateBackoff(attempt);
+                        mcpLog('warning', `Empty response, retrying in ${delayMs}ms...`, 'research');
+                        await sleep(delayMs);
+                        continue;
+                    }
+                }
+                return {
+                    id: response.id || '',
+                    model: response.model || model,
+                    created: response.created || Date.now(),
+                    content: message?.content || '',
+                    finishReason: choice?.finish_reason,
+                    usage: response.usage ? {
+                        promptTokens: response.usage.prompt_tokens,
+                        completionTokens: response.usage.completion_tokens,
+                        totalTokens: response.usage.total_tokens,
+                        sourcesUsed: response.usage.num_sources_used,
+                    } : undefined,
+                    annotations: message?.annotations?.map((a) => ({
+                        type: 'url_citation',
+                        url: a.url_citation?.url || '',
+                        title: a.url_citation?.title || '',
+                        startIndex: a.url_citation?.start_index || 0,
+                        endIndex: a.url_citation?.end_index || 0,
+                    })),
+                };
+            }
+            catch (error) {
+                lastError = classifyError(error);
+                const err = error;
+                mcpLog('error', `Error with ${model} (attempt ${attempt + 1}): ${lastError.message} (status: ${err.status})`, 'research');
+                // Check if we should retry
+                if (this.isRetryableError(error) && attempt < RESEARCH_RETRY_CONFIG.maxRetries) {
+                    const delayMs = this.calculateBackoff(attempt);
+                    mcpLog('warning', `Retrying in ${delayMs}ms...`, 'research');
+                    await sleep(delayMs);
+                    continue;
+                }
+                // Non-retryable or max retries reached
+                break;
+            }
+        }
+        // Return error response
+        return {
+            id: '',
+            model,
+            created: Date.now(),
+            content: '',
+            error: lastError || {
+                code: ErrorCode.UNKNOWN_ERROR,
+                message: 'Unknown research error',
+                retryable: false,
+            },
+        };
+    }
+    /**
+     * Perform research with retry logic and fallback to secondary model
+     * Returns a ResearchResponse - may contain error field on failure
+     * NEVER throws - always returns a valid response object
+     */
+    async research(params) {
+        const { question, systemPrompt, reasoningEffort = RESEARCH.REASONING_EFFORT, maxSearchResults = RESEARCH.MAX_URLS, maxTokens = 32000, temperature = 0.3, responseFormat, } = params;
+        // Validate input
+        if (!question?.trim()) {
+            return {
+                id: '',
+                model: RESEARCH.MODEL,
+                created: Date.now(),
+                content: '',
+                error: {
+                    code: ErrorCode.INVALID_INPUT,
+                    message: 'Research question cannot be empty',
+                    retryable: false,
+                },
+            };
+        }
+        const messages = [];
+        if (systemPrompt) {
+            messages.push({ role: 'system', content: systemPrompt });
+        }
+        messages.push({ role: 'user', content: question });
+        const options = { temperature, reasoningEffort, maxTokens, maxSearchResults, responseFormat };
+        // Try primary model first
+        mcpLog('info', `Trying primary model: ${RESEARCH.MODEL}`, 'research');
+        const primaryResult = await this.executeResearch(RESEARCH.MODEL, messages, options);
+        if (!primaryResult.error) {
+            return primaryResult;
+        }
+        // Primary failed - try fallback model if different
+        if (RESEARCH.FALLBACK_MODEL && RESEARCH.FALLBACK_MODEL !== RESEARCH.MODEL) {
+            mcpLog('warning', `Primary model failed, trying fallback: ${RESEARCH.FALLBACK_MODEL}`, 'research');
+            const fallbackResult = await this.executeResearch(RESEARCH.FALLBACK_MODEL, messages, options);
+            if (!fallbackResult.error) {
+                return fallbackResult;
+            }
+            // Both failed - return the fallback error (more recent)
+            mcpLog('error', `Both models failed. Primary: ${primaryResult.error?.message}, Fallback: ${fallbackResult.error?.message}`, 'research');
+            return {
+                ...fallbackResult,
+                content: `Research failed with both models. Primary (${RESEARCH.MODEL}): ${primaryResult.error?.message}. Fallback (${RESEARCH.FALLBACK_MODEL}): ${fallbackResult.error?.message}`,
+            };
+        }
+        // No fallback or same model - return primary error
+        mcpLog('error', `All attempts failed: ${primaryResult.error?.message}`, 'research');
+        return {
+            ...primaryResult,
+            content: `Research failed: ${primaryResult.error?.message}`,
+        };
+    }
+}
+//# sourceMappingURL=research.js.map