mcp-perplexity-pro 1.1.0

package/dist/perplexity-api.js

@@ -0,0 +1,455 @@
+import fetch from 'node-fetch';
+import { suggestFallbackModel } from './models.js';
+// Perplexity API endpoints
+const PERPLEXITY_BASE_URL = 'https://api.perplexity.ai';
+const CHAT_COMPLETIONS_ENDPOINT = '/chat/completions';
+const ASYNC_CHAT_COMPLETIONS_ENDPOINT = '/async/chat/completions';
+export class PerplexityApiError extends Error {
+    status;
+    response;
+    constructor(message, status, response) {
+        super(message);
+        this.status = status;
+        this.response = response;
+        this.name = 'PerplexityApiError';
+    }
+}
+export class PerplexityApiClient {
+    apiKey;
+    baseUrl;
+    constructor(config) {
+        this.apiKey = config.api_key;
+        this.baseUrl = PERPLEXITY_BASE_URL;
+    }
+    /**
+     * Makes a request to the Perplexity API with proper error handling
+     */
+    async makeRequest(endpoint, body, method = 'POST') {
+        const url = `${this.baseUrl}${endpoint}`;
+        console.error(`Making request to: ${url}`);
+        console.error(`API key: ${this.apiKey ? this.apiKey.substring(0, 10) + '...' : 'MISSING'}`);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                body: method === 'POST' ? JSON.stringify(body) : null,
+            });
+            // Check if response is JSON before parsing
+            const contentType = response.headers.get('content-type');
+            let data;
+            if (contentType?.includes('application/json')) {
+                data = await response.json();
+            }
+            else {
+                // If not JSON, get the text for better error messages
+                const text = await response.text();
+                data = { error: { message: `Non-JSON response: ${text.substring(0, 200)}...` } };
+            }
+            if (!response.ok) {
+                throw new PerplexityApiError(data.error?.message || `HTTP ${response.status}: ${response.statusText}`, response.status, data);
+            }
+            return data;
+        }
+        catch (error) {
+            if (error instanceof PerplexityApiError) {
+                throw error;
+            }
+            if (error instanceof Error) {
+                throw new PerplexityApiError(`Network error: ${error.message}`);
+            }
+            throw new PerplexityApiError('Unknown error occurred');
+        }
+    }
+    /**
+     * Sends a chat completion request to Perplexity
+     */
+    async chatCompletion(request) {
+        // Prepare the request body according to Perplexity API format
+        const requestBody = {
+            model: request.model,
+            messages: request.messages,
+            ...(request.max_tokens && { max_tokens: request.max_tokens }),
+            ...(request.temperature !== undefined && { temperature: request.temperature }),
+            ...(request.top_p !== undefined && { top_p: request.top_p }),
+            ...(request.search_domain_filter && { search_domain_filter: request.search_domain_filter }),
+            ...(request.return_images !== undefined && { return_images: request.return_images }),
+            ...(request.return_related_questions !== undefined && {
+                return_related_questions: request.return_related_questions,
+            }),
+            ...(request.search_recency_filter && {
+                search_recency_filter: request.search_recency_filter,
+            }),
+            ...(request.search_after_date_filter && {
+                search_after_date_filter: request.search_after_date_filter,
+            }),
+            ...(request.search_before_date_filter && {
+                search_before_date_filter: request.search_before_date_filter,
+            }),
+            ...(request.last_updated_after_filter && {
+                last_updated_after_filter: request.last_updated_after_filter,
+            }),
+            ...(request.last_updated_before_filter && {
+                last_updated_before_filter: request.last_updated_before_filter,
+            }),
+            ...(request.top_k !== undefined && { top_k: request.top_k }),
+            ...(request.stream !== undefined && { stream: request.stream }),
+            ...(request.presence_penalty !== undefined && { presence_penalty: request.presence_penalty }),
+            ...(request.frequency_penalty !== undefined && {
+                frequency_penalty: request.frequency_penalty,
+            }),
+            ...(request.response_format && { response_format: request.response_format }),
+            ...(request.disable_search !== undefined && { disable_search: request.disable_search }),
+            ...(request.enable_search_classifier !== undefined && {
+                enable_search_classifier: request.enable_search_classifier,
+            }),
+            ...(request.web_search_options && { web_search_options: request.web_search_options }),
+        };
+        return this.makeRequest(CHAT_COMPLETIONS_ENDPOINT, requestBody);
+    }
+    /**
+     * Sends a streaming chat completion request to Perplexity
+     */
+    async chatCompletionStream(request, callbacks) {
+        const url = `${this.baseUrl}${CHAT_COMPLETIONS_ENDPOINT}`;
+        // Force streaming mode
+        const requestBody = {
+            model: request.model,
+            messages: request.messages,
+            stream: true, // Force streaming
+            ...(request.max_tokens && { max_tokens: request.max_tokens }),
+            ...(request.temperature !== undefined && { temperature: request.temperature }),
+            ...(request.top_p !== undefined && { top_p: request.top_p }),
+            ...(request.search_domain_filter && { search_domain_filter: request.search_domain_filter }),
+            ...(request.return_images !== undefined && { return_images: request.return_images }),
+            ...(request.return_related_questions !== undefined && {
+                return_related_questions: request.return_related_questions,
+            }),
+            ...(request.search_recency_filter && {
+                search_recency_filter: request.search_recency_filter,
+            }),
+            ...(request.search_after_date_filter && {
+                search_after_date_filter: request.search_after_date_filter,
+            }),
+            ...(request.search_before_date_filter && {
+                search_before_date_filter: request.search_before_date_filter,
+            }),
+            ...(request.last_updated_after_filter && {
+                last_updated_after_filter: request.last_updated_after_filter,
+            }),
+            ...(request.last_updated_before_filter && {
+                last_updated_before_filter: request.last_updated_before_filter,
+            }),
+            ...(request.top_k !== undefined && { top_k: request.top_k }),
+            ...(request.presence_penalty !== undefined && { presence_penalty: request.presence_penalty }),
+            ...(request.frequency_penalty !== undefined && {
+                frequency_penalty: request.frequency_penalty,
+            }),
+            ...(request.response_format && { response_format: request.response_format }),
+            ...(request.disable_search !== undefined && { disable_search: request.disable_search }),
+            ...(request.enable_search_classifier !== undefined && {
+                enable_search_classifier: request.enable_search_classifier,
+            }),
+            ...(request.web_search_options && { web_search_options: request.web_search_options }),
+        };
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                    'Content-Type': 'application/json',
+                    Accept: 'text/event-stream',
+                },
+                body: JSON.stringify(requestBody),
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new PerplexityApiError(`HTTP ${response.status}: ${response.statusText}`, response.status, { error: { message: errorText } });
+            }
+            if (!response.body) {
+                throw new PerplexityApiError('No response body received');
+            }
+            // In node-fetch v3, response.body is already a Node.js Readable stream
+            // Cast it to the correct type for TypeScript
+            const bodyStream = response.body;
+            return this.processStreamingResponse(bodyStream, callbacks);
+        }
+        catch (error) {
+            if (callbacks.onError) {
+                callbacks.onError(error instanceof Error ? error : new Error('Unknown streaming error'));
+            }
+            throw error;
+        }
+    }
+    /**
+     * Processes Server-Sent Events from Perplexity's streaming API
+     */
+    async processStreamingResponse(body, callbacks) {
+        return new Promise((resolve, reject) => {
+            let buffer = '';
+            let finalResponse = null;
+            let aggregatedContent = '';
+            let responseMetadata = {};
+            body.on('data', chunk => {
+                buffer += chunk.toString();
+                // Process complete lines
+                const lines = buffer.split('\n');
+                buffer = lines.pop() || ''; // Keep incomplete line in buffer
+                for (const line of lines) {
+                    this.processSSELine(line, {
+                        onChunk: chunk => {
+                            // Aggregate content for final response
+                            if (chunk.choices?.[0]?.delta?.content) {
+                                aggregatedContent += chunk.choices[0].delta.content;
+                            }
+                            // Store metadata from first chunk
+                            if (!responseMetadata.id) {
+                                responseMetadata = {
+                                    id: chunk.id,
+                                    model: chunk.model,
+                                    created: chunk.created,
+                                    object: 'chat.completion',
+                                };
+                            }
+                            // Forward chunk to callback
+                            if (callbacks.onChunk) {
+                                callbacks.onChunk(chunk);
+                            }
+                        },
+                        onComplete: response => {
+                            finalResponse = response;
+                        },
+                        onError: callbacks.onError || (() => { }),
+                    });
+                }
+            });
+            body.on('end', () => {
+                // If we have a final response from [DONE], use it
+                if (finalResponse) {
+                    if (callbacks.onComplete) {
+                        callbacks.onComplete(finalResponse);
+                    }
+                    resolve(finalResponse);
+                }
+                else {
+                    // Otherwise, construct final response from aggregated data
+                    const constructedResponse = {
+                        ...responseMetadata,
+                        choices: [
+                            {
+                                index: 0,
+                                finish_reason: 'stop',
+                                message: {
+                                    role: 'assistant',
+                                    content: aggregatedContent,
+                                },
+                            },
+                        ],
+                        usage: {
+                            prompt_tokens: 0,
+                            completion_tokens: 0,
+                            total_tokens: 0,
+                        },
+                    };
+                    if (callbacks.onComplete) {
+                        callbacks.onComplete(constructedResponse);
+                    }
+                    resolve(constructedResponse);
+                }
+            });
+            body.on('error', error => {
+                if (callbacks.onError) {
+                    callbacks.onError(error);
+                }
+                reject(error);
+            });
+        });
+    }
+    /**
+     * Processes a single Server-Sent Event line
+     */
+    processSSELine(line, callbacks) {
+        if (!line.trim())
+            return;
+        // Handle SSE format: "data: {json}"
+        if (line.startsWith('data: ')) {
+            const data = line.slice(6).trim();
+            // Check for completion signal
+            if (data === '[DONE]') {
+                return;
+            }
+            try {
+                const chunk = JSON.parse(data);
+                if (callbacks.onChunk) {
+                    callbacks.onChunk(chunk);
+                }
+            }
+            catch (error) {
+                console.warn('Failed to parse SSE chunk:', data, error);
+            }
+        }
+    }
+    /**
+     * Creates an async chat completion job
+     */
+    async createAsyncChatCompletion(request) {
+        const requestBody = {
+            request: {
+                model: request.model,
+                messages: request.messages,
+                ...(request.max_tokens && { max_tokens: request.max_tokens }),
+                ...(request.temperature !== undefined && { temperature: request.temperature }),
+                ...(request.top_p !== undefined && { top_p: request.top_p }),
+                ...(request.search_domain_filter && { search_domain_filter: request.search_domain_filter }),
+                ...(request.return_images !== undefined && { return_images: request.return_images }),
+                ...(request.return_related_questions !== undefined && {
+                    return_related_questions: request.return_related_questions,
+                }),
+                ...(request.search_recency_filter && {
+                    search_recency_filter: request.search_recency_filter,
+                }),
+                ...(request.search_after_date_filter && {
+                    search_after_date_filter: request.search_after_date_filter,
+                }),
+                ...(request.search_before_date_filter && {
+                    search_before_date_filter: request.search_before_date_filter,
+                }),
+                ...(request.last_updated_after_filter && {
+                    last_updated_after_filter: request.last_updated_after_filter,
+                }),
+                ...(request.last_updated_before_filter && {
+                    last_updated_before_filter: request.last_updated_before_filter,
+                }),
+                ...(request.top_k !== undefined && { top_k: request.top_k }),
+                ...(request.stream !== undefined && { stream: request.stream }),
+                ...(request.presence_penalty !== undefined && {
+                    presence_penalty: request.presence_penalty,
+                }),
+                ...(request.frequency_penalty !== undefined && {
+                    frequency_penalty: request.frequency_penalty,
+                }),
+                ...(request.response_format && { response_format: request.response_format }),
+                ...(request.disable_search !== undefined && { disable_search: request.disable_search }),
+                ...(request.enable_search_classifier !== undefined && {
+                    enable_search_classifier: request.enable_search_classifier,
+                }),
+                ...(request.web_search_options && { web_search_options: request.web_search_options }),
+            },
+        };
+        return this.makeRequest(ASYNC_CHAT_COMPLETIONS_ENDPOINT, requestBody);
+    }
+    /**
+     * Alias for backward compatibility
+     */
+    async createAsyncChat(request) {
+        return this.createAsyncChatCompletion(request);
+    }
+    /**
+     * Lists async chat completion jobs
+     */
+    async listAsyncJobs(limit = 20, nextToken) {
+        const params = new URLSearchParams();
+        params.append('limit', limit.toString());
+        if (nextToken) {
+            params.append('next_token', encodeURIComponent(nextToken));
+        }
+        const endpoint = `${ASYNC_CHAT_COMPLETIONS_ENDPOINT}?${params.toString()}`;
+        return this.makeRequest(endpoint, null, 'GET');
+    }
+    /**
+     * Gets the status and result of an async job
+     */
+    async getAsyncJob(jobId) {
+        const endpoint = `${ASYNC_CHAT_COMPLETIONS_ENDPOINT}/${jobId}`;
+        return this.makeRequest(endpoint, null, 'GET');
+    }
+    /**
+     * Handles API errors and creates structured error responses
+     */
+    static handleError(error, context) {
+        if (error instanceof PerplexityApiError) {
+            // Rate limiting
+            if (error.status === 429) {
+                return {
+                    error: {
+                        type: 'rate_limit',
+                        message: 'Rate limit exceeded',
+                        details: {
+                            suggestion: 'Wait before retrying or use async_perplexity for queuing',
+                            retry_after: error.response?.headers?.['retry-after'] || 60,
+                            ...(context?.model && {
+                                fallback_model: suggestFallbackModel(context.model, 'rate_limit'),
+                            }),
+                        },
+                    },
+                };
+            }
+            // Invalid model
+            if (error.status === 400 && error.message.toLowerCase().includes('model')) {
+                return {
+                    error: {
+                        type: 'invalid_model',
+                        message: `Invalid model: ${context?.model || 'unknown'}`,
+                        details: {
+                            suggestion: 'Use a supported model: sonar, sonar-pro, sonar-reasoning, sonar-reasoning-pro, sonar-deep-research',
+                            fallback_model: 'sonar-reasoning-pro',
+                        },
+                    },
+                };
+            }
+            // Authentication error
+            if (error.status === 401) {
+                return {
+                    error: {
+                        type: 'api_error',
+                        message: 'Authentication failed - check your API key',
+                        details: {
+                            suggestion: 'Verify your Perplexity API key is correct and has sufficient credits',
+                        },
+                    },
+                };
+            }
+            // Server error
+            if (error.status && error.status >= 500) {
+                return {
+                    error: {
+                        type: 'api_error',
+                        message: 'Perplexity API server error',
+                        details: {
+                            suggestion: 'Try again later or use a different model',
+                            fallback_model: context?.model ? suggestFallbackModel(context.model) : 'sonar',
+                        },
+                    },
+                };
+            }
+            // General API error
+            return {
+                error: {
+                    type: 'api_error',
+                    message: error.message || 'Unknown API error',
+                    details: {
+                        suggestion: 'Check your request parameters and try again',
+                        fallback_model: context?.model
+                            ? suggestFallbackModel(context.model)
+                            : 'sonar-reasoning-pro',
+                    },
+                },
+            };
+        }
+        // Network or unknown error
+        return {
+            error: {
+                type: 'api_error',
+                message: error instanceof Error ? error.message : 'Unknown error occurred',
+                details: {
+                    suggestion: 'Check your internet connection and try again',
+                },
+            },
+        };
+    }
+}
+// Export alias for backward compatibility
+export { PerplexityApiClient as PerplexityAPI };
+//# sourceMappingURL=perplexity-api.js.map

package/dist/perplexity-api.js.map

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

package/dist/port-utils.d.ts

@@ -0,0 +1,31 @@
+export interface PortDiscoveryResult {
+    port: number;
+    isExistingServer: boolean;
+    healthStatus?: 'healthy' | 'unhealthy';
+}
+/**
+ * Checks if a port is available for binding
+ */
+export declare function isPortAvailable(port: number): Promise<boolean>;
+/**
+ * Checks if an MCP server is running on the specified port
+ */
+export declare function checkMcpServerHealth(port: number): Promise<'healthy' | 'unhealthy' | 'not-running'>;
+/**
+ * Discovers the best port to use for the MCP server
+ * Strategy:
+ * 1. Check if there's already a healthy MCP server running in the port range
+ * 2. If yes, return that port (shared server model)
+ * 3. If no, find the first available port in the range
+ * 4. If none available in range, throw an error
+ */
+export declare function discoverMcpPort(preferredPort?: number): Promise<PortDiscoveryResult>;
+/**
+ * Lists all ports in the MCP range and their status
+ */
+export declare function scanMcpPortRange(): Promise<Array<{
+    port: number;
+    available: boolean;
+    mcpHealth: 'healthy' | 'unhealthy' | 'not-running';
+}>>;
+//# sourceMappingURL=port-utils.d.ts.map

package/dist/port-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-utils.d.ts","sourceRoot":"","sources":["../src/port-utils.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;CACxC;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUpE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,SAAS,GAAG,WAAW,GAAG,aAAa,CAAC,CAkBlD;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA0D1F;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAC/C,KAAK,CAAC;IACJ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,SAAS,GAAG,WAAW,GAAG,aAAa,CAAC;CACpD,CAAC,CACH,CAeA"}

package/dist/port-utils.js

@@ -0,0 +1,114 @@
+import { createServer } from 'http';
+// Port range for MCP server discovery (Claude Code uses 8124, Claude Desktop uses 8125)
+const MCP_PORT_RANGE = { start: 8124, end: 8133 };
+/**
+ * Checks if a port is available for binding
+ */
+export async function isPortAvailable(port) {
+    return new Promise(resolve => {
+        const server = createServer();
+        server.listen(port, () => {
+            server.close(() => resolve(true));
+        });
+        server.on('error', () => resolve(false));
+    });
+}
+/**
+ * Checks if an MCP server is running on the specified port
+ */
+export async function checkMcpServerHealth(port) {
+    try {
+        const response = await fetch(`http://localhost:${port}/health`, {
+            method: 'GET',
+            signal: AbortSignal.timeout(2000), // 2 second timeout
+        });
+        if (response.ok) {
+            const health = await response.json();
+            return health.status === 'healthy' ? 'healthy' : 'unhealthy';
+        }
+        else {
+            return 'unhealthy';
+        }
+    }
+    catch (error) {
+        // Port might be occupied by non-MCP service or not running
+        const available = await isPortAvailable(port);
+        return available ? 'not-running' : 'unhealthy';
+    }
+}
+/**
+ * Discovers the best port to use for the MCP server
+ * Strategy:
+ * 1. Check if there's already a healthy MCP server running in the port range
+ * 2. If yes, return that port (shared server model)
+ * 3. If no, find the first available port in the range
+ * 4. If none available in range, throw an error
+ */
+export async function discoverMcpPort(preferredPort) {
+    const debugMode = process.env.MCP_DEBUG_MODE === 'true';
+    const debugLog = debugMode ? console.log : console.error;
+    debugLog(`Discovering MCP server port (preferred: ${preferredPort || 'none'})`);
+    // First, check if preferred port has a healthy MCP server
+    if (preferredPort) {
+        const health = await checkMcpServerHealth(preferredPort);
+        if (health === 'healthy') {
+            debugLog(`Found healthy MCP server on preferred port ${preferredPort}`);
+            return {
+                port: preferredPort,
+                isExistingServer: true,
+                healthStatus: 'healthy',
+            };
+        }
+    }
+    // Scan the entire port range for existing healthy MCP servers
+    for (let port = MCP_PORT_RANGE.start; port <= MCP_PORT_RANGE.end; port++) {
+        const health = await checkMcpServerHealth(port);
+        if (health === 'healthy') {
+            debugLog(`Found healthy MCP server on port ${port}`);
+            return {
+                port,
+                isExistingServer: true,
+                healthStatus: 'healthy',
+            };
+        }
+    }
+    // No existing healthy server found, find an available port
+    // Start with preferred port if specified and available
+    if (preferredPort && (await isPortAvailable(preferredPort))) {
+        debugLog(`Using preferred port ${preferredPort} (no existing server found)`);
+        return {
+            port: preferredPort,
+            isExistingServer: false,
+        };
+    }
+    // Find first available port in range
+    for (let port = MCP_PORT_RANGE.start; port <= MCP_PORT_RANGE.end; port++) {
+        if (await isPortAvailable(port)) {
+            debugLog(`Using available port ${port}`);
+            return {
+                port,
+                isExistingServer: false,
+            };
+        }
+    }
+    // No ports available in the range
+    throw new Error(`No available ports in MCP range ${MCP_PORT_RANGE.start}-${MCP_PORT_RANGE.end}. ` +
+        'Please free up a port or use a different range.');
+}
+/**
+ * Lists all ports in the MCP range and their status
+ */
+export async function scanMcpPortRange() {
+    const results = [];
+    for (let port = MCP_PORT_RANGE.start; port <= MCP_PORT_RANGE.end; port++) {
+        const available = await isPortAvailable(port);
+        const mcpHealth = available ? 'not-running' : await checkMcpServerHealth(port);
+        results.push({
+            port,
+            available,
+            mcpHealth,
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=port-utils.js.map

package/dist/port-utils.js.map

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