@orchestrator-claude/mcp-server 3.3.2 → 3.3.3

package/dist/PerplexityMcpServer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * PerplexityMcpServer
+ *
+ * Standalone MCP server for Perplexity AI research tools.
+ * Calls the Perplexity API directly (not via Orchestrator REST API).
+ *
+ * Usage: npx @orchestrator-claude/mcp-server --server perplexity
+ * Requires: PERPLEXITY_API_KEY environment variable
+ */
+export declare class PerplexityMcpServer {
+    private server;
+    private client;
+    constructor();
+    private initializeClient;
+    private registerTools;
+    start(): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=PerplexityMcpServer.d.ts.map

package/dist/PerplexityMcpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerplexityMcpServer.d.ts","sourceRoot":"","sources":["../src/PerplexityMcpServer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAqBH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,MAAM,CAAiC;;IAmB/C,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,aAAa;IA6Kf,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAUtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/PerplexityMcpServer.js

@@ -0,0 +1,210 @@
+/**
+ * PerplexityMcpServer
+ *
+ * Standalone MCP server for Perplexity AI research tools.
+ * Calls the Perplexity API directly (not via Orchestrator REST API).
+ *
+ * Usage: npx @orchestrator-claude/mcp-server --server perplexity
+ * Requires: PERPLEXITY_API_KEY environment variable
+ */
+import { z } from 'zod';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { PerplexityClient } from './external/PerplexityClient.js';
+import { PerplexityConfig } from './external/PerplexityConfig.js';
+function formatError(error) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify({ error: true, ...error }, null, 2) }],
+        isError: true,
+    };
+}
+function formatResult(data) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+    };
+}
+export class PerplexityMcpServer {
+    server;
+    client = null;
+    constructor() {
+        this.server = new McpServer({
+            name: 'perplexity',
+            version: '1.0.0',
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        this.initializeClient();
+        this.registerTools();
+    }
+    initializeClient() {
+        const configResult = PerplexityConfig.fromEnv();
+        if (configResult.isOk()) {
+            this.client = PerplexityClient.create(configResult.unwrap());
+            console.error('[perplexity] Client initialized with API key.');
+        }
+        else {
+            console.error('[perplexity] Warning: PERPLEXITY_API_KEY not set. Server will use mock responses.');
+        }
+    }
+    registerTools() {
+        // search
+        this.server.registerTool('search', {
+            description: 'Search for information using Perplexity AI',
+            inputSchema: z.object({
+                query: z.string().describe('The search query'),
+                maxResults: z.number().optional().describe('Maximum number of results to return (default: 5)'),
+                recency: z
+                    .enum(['day', 'week', 'month', 'year'])
+                    .optional()
+                    .describe('Filter results by recency'),
+            }),
+        }, async (input) => {
+            if (this.client) {
+                const options = {};
+                if (input.maxResults !== undefined)
+                    options.maxResults = input.maxResults;
+                if (input.recency !== undefined)
+                    options.recency = input.recency;
+                const result = await this.client.search(input.query, options);
+                if (result.isOk()) {
+                    return formatResult(result.unwrap());
+                }
+                return formatError(result.unwrapErr());
+            }
+            return formatResult({
+                query: input.query,
+                results: [
+                    {
+                        title: `Result for: ${input.query}`,
+                        snippet: `This is a mock search result for "${input.query}"`,
+                        url: `https://example.com/search?q=${encodeURIComponent(input.query)}`,
+                        relevance: 0.95,
+                    },
+                ],
+                totalResults: 1,
+                searchTime: 0.5,
+            });
+        });
+        // getTopicContent
+        this.server.registerTool('getTopicContent', {
+            description: 'Get detailed content about a specific topic',
+            inputSchema: z.object({
+                topic: z.string().describe('The topic to get content about'),
+                depth: z
+                    .enum(['brief', 'detailed'])
+                    .optional()
+                    .describe('Level of detail (default: brief)'),
+            }),
+        }, async (input) => {
+            if (this.client) {
+                const result = await this.client.getTopicContent(input.topic);
+                if (result.isOk()) {
+                    return formatResult(result.unwrap());
+                }
+                return formatError(result.unwrapErr());
+            }
+            const isBrief = input.depth !== 'detailed';
+            return formatResult({
+                topic: input.topic,
+                content: isBrief
+                    ? `Brief overview of ${input.topic}`
+                    : `Detailed analysis of ${input.topic}. This includes comprehensive information about the subject matter, covering key aspects, history, and current developments.`,
+                sources: [
+                    {
+                        title: `${input.topic} - Wikipedia`,
+                        url: `https://en.wikipedia.org/wiki/${encodeURIComponent(input.topic)}`,
+                    },
+                ],
+                lastUpdated: new Date().toISOString(),
+            });
+        });
+        // isAvailable
+        this.server.registerTool('isAvailable', {
+            description: 'Check if the Perplexity API is available',
+            inputSchema: z.object({}),
+        }, async () => {
+            if (this.client) {
+                const available = await this.client.isAvailable();
+                return formatResult({
+                    available,
+                    timestamp: new Date().toISOString(),
+                });
+            }
+            return formatResult({
+                available: false,
+                reason: 'No Perplexity client configured',
+                timestamp: new Date().toISOString(),
+            });
+        });
+        // summarize
+        this.server.registerTool('summarize', {
+            description: 'Get a summarized overview of a topic with key facts',
+            inputSchema: z.object({
+                topic: z.string().describe('The topic to summarize'),
+                includeRecent: z
+                    .boolean()
+                    .optional()
+                    .describe('Include recent news and developments (default: false)'),
+            }),
+        }, async (input) => {
+            if (this.client) {
+                const contentResult = await this.client.getTopicContent(input.topic);
+                if (contentResult.isErr()) {
+                    return formatError(contentResult.unwrapErr());
+                }
+                const content = contentResult.unwrap();
+                let recentInfo = null;
+                if (input.includeRecent) {
+                    const searchResult = await this.client.search(`${input.topic} latest news`, {
+                        recency: 'week',
+                        maxResults: 3,
+                    });
+                    if (searchResult.isOk()) {
+                        recentInfo = searchResult.unwrap();
+                    }
+                }
+                return formatResult({
+                    topic: input.topic,
+                    summary: content.content,
+                    sources: content.sources,
+                    recentDevelopments: recentInfo?.results ?? [],
+                    generatedAt: new Date().toISOString(),
+                });
+            }
+            return formatResult({
+                topic: input.topic,
+                summary: `Summary of ${input.topic}: This is a comprehensive overview covering the main aspects and key points.`,
+                sources: [
+                    {
+                        title: `${input.topic} Overview`,
+                        url: `https://example.com/${encodeURIComponent(input.topic)}`,
+                    },
+                ],
+                recentDevelopments: input.includeRecent
+                    ? [
+                        {
+                            title: `Latest on ${input.topic}`,
+                            snippet: 'Recent developments in this area...',
+                            url: `https://news.example.com/${encodeURIComponent(input.topic)}`,
+                        },
+                    ]
+                    : [],
+                generatedAt: new Date().toISOString(),
+            });
+        });
+    }
+    async start() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        process.on('SIGINT', async () => {
+            await this.server.close();
+            process.exit(0);
+        });
+    }
+    async close() {
+        await this.server.close();
+    }
+}
+//# sourceMappingURL=PerplexityMcpServer.js.map

package/dist/PerplexityMcpServer.js.map

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

package/dist/external/PerplexityClient.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Perplexity API Client
+ *
+ * Self-contained client for the Perplexity AI API.
+ * Features: rate limiting, exponential backoff retry, request timeout.
+ */
+import { type Result } from './Result.js';
+import { PerplexityConfig } from './PerplexityConfig.js';
+export interface PerplexitySearchOptions {
+    readonly maxResults?: number;
+    readonly recency?: 'day' | 'week' | 'month' | 'year';
+    readonly domains?: readonly string[];
+    readonly model?: string;
+}
+export interface PerplexitySearchResultItem {
+    readonly title: string;
+    readonly url: string;
+    readonly snippet: string;
+    readonly relevance: number;
+}
+export interface PerplexitySearchResult {
+    readonly query: string;
+    readonly results: readonly PerplexitySearchResultItem[];
+    readonly summary: string;
+    readonly model: string;
+    readonly timestamp: string;
+}
+export interface PerplexityContent {
+    readonly topic: string;
+    readonly content: string;
+    readonly sources: readonly string[];
+    readonly patterns: readonly string[];
+    readonly recommendations: readonly string[];
+    readonly timestamp: string;
+}
+export interface PerplexityError {
+    readonly code: string;
+    readonly message: string;
+    readonly details?: Record<string, unknown>;
+    readonly retryAfter?: number;
+}
+export declare class PerplexityClient {
+    private readonly config;
+    private requestTimestamps;
+    constructor(config: PerplexityConfig);
+    static create(config: PerplexityConfig): PerplexityClient;
+    search(query: string, options?: PerplexitySearchOptions): Promise<Result<PerplexitySearchResult, PerplexityError>>;
+    getTopicContent(topic: string): Promise<Result<PerplexityContent, PerplexityError>>;
+    isAvailable(): Promise<boolean>;
+    private makeRequest;
+    private canMakeRequest;
+    private recordRequest;
+    private getRetryAfterSeconds;
+    private sleep;
+    private extractResults;
+    private extractPatterns;
+    private extractRecommendations;
+}
+//# sourceMappingURL=PerplexityClient.d.ts.map

package/dist/external/PerplexityClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerplexityClient.d.ts","sourceRoot":"","sources":["../../src/external/PerplexityClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAIzD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAmCD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,iBAAiB,CAAgB;gBAE7B,MAAM,EAAE,gBAAgB;IAIpC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB;IAInD,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,eAAe,CAAC,CAAC;IA4DrD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC;IAyDnF,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;YAsBvB,WAAW;IA4EzB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,sBAAsB;CAU/B"}

package/dist/external/PerplexityClient.js

@@ -0,0 +1,248 @@
+/**
+ * Perplexity API Client
+ *
+ * Self-contained client for the Perplexity AI API.
+ * Features: rate limiting, exponential backoff retry, request timeout.
+ */
+import { ok, err } from './Result.js';
+// --- Client ---
+export class PerplexityClient {
+    config;
+    requestTimestamps = [];
+    constructor(config) {
+        this.config = config;
+    }
+    static create(config) {
+        return new PerplexityClient(config);
+    }
+    async search(query, options) {
+        if (!query || query.trim() === '') {
+            return err({
+                code: 'INVALID_QUERY',
+                message: 'Search query cannot be empty',
+            });
+        }
+        if (!this.canMakeRequest()) {
+            const retryAfter = this.getRetryAfterSeconds();
+            return err({
+                code: 'RATE_LIMITED',
+                message: `Rate limit exceeded. Try again in ${retryAfter} seconds.`,
+                retryAfter,
+            });
+        }
+        const request = {
+            model: options?.model ?? this.config.model,
+            messages: [
+                {
+                    role: 'system',
+                    content: 'You are a research assistant. Provide factual, well-sourced information. Format your response with clear sections.',
+                },
+                {
+                    role: 'user',
+                    content: query,
+                },
+            ],
+            max_tokens: 1024,
+            temperature: 0.2,
+        };
+        if (options?.recency) {
+            request.search_recency_filter = options.recency;
+        }
+        if (options?.domains && options.domains.length > 0) {
+            request.search_domain_filter = [...options.domains];
+        }
+        const result = await this.makeRequest(request);
+        if (result.isErr()) {
+            return err(result.unwrapErr());
+        }
+        const response = result.unwrap();
+        const content = response.choices[0]?.message.content ?? '';
+        return ok({
+            query,
+            results: this.extractResults(content, response.citations ?? []),
+            summary: content,
+            model: response.model,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    async getTopicContent(topic) {
+        if (!topic || topic.trim() === '') {
+            return err({
+                code: 'INVALID_QUERY',
+                message: 'Topic cannot be empty',
+            });
+        }
+        if (!this.canMakeRequest()) {
+            const retryAfter = this.getRetryAfterSeconds();
+            return err({
+                code: 'RATE_LIMITED',
+                message: `Rate limit exceeded. Try again in ${retryAfter} seconds.`,
+                retryAfter,
+            });
+        }
+        const request = {
+            model: this.config.model,
+            messages: [
+                {
+                    role: 'system',
+                    content: `You are a software engineering expert. Provide detailed technical content about the requested topic.
+Structure your response with:
+1. Overview
+2. Key patterns and best practices
+3. Recommendations
+4. Code examples if applicable`,
+                },
+                {
+                    role: 'user',
+                    content: `Provide comprehensive information about: ${topic}`,
+                },
+            ],
+            max_tokens: 2048,
+            temperature: 0.3,
+        };
+        const result = await this.makeRequest(request);
+        if (result.isErr()) {
+            return err(result.unwrapErr());
+        }
+        const response = result.unwrap();
+        const content = response.choices[0]?.message.content ?? '';
+        return ok({
+            topic,
+            content,
+            sources: response.citations ?? [],
+            patterns: this.extractPatterns(content),
+            recommendations: this.extractRecommendations(content),
+            timestamp: new Date().toISOString(),
+        });
+    }
+    async isAvailable() {
+        try {
+            const response = await fetch(`${this.config.baseUrl}/chat/completions`, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${this.config.apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    model: this.config.model,
+                    messages: [{ role: 'user', content: 'test' }],
+                    max_tokens: 1,
+                }),
+                signal: AbortSignal.timeout(5000),
+            });
+            return response.status === 200 || response.status === 401;
+        }
+        catch {
+            return false;
+        }
+    }
+    async makeRequest(request) {
+        let lastError = null;
+        for (let attempt = 0; attempt < this.config.maxRetries; attempt++) {
+            if (attempt > 0) {
+                const delay = Math.pow(2, attempt) * 1000;
+                await this.sleep(delay);
+            }
+            try {
+                this.recordRequest();
+                const response = await fetch(`${this.config.baseUrl}/chat/completions`, {
+                    method: 'POST',
+                    headers: {
+                        Authorization: `Bearer ${this.config.apiKey}`,
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify(request),
+                    signal: AbortSignal.timeout(this.config.timeout),
+                });
+                if (response.ok) {
+                    const data = (await response.json());
+                    return ok(data);
+                }
+                if (response.status === 429) {
+                    lastError = {
+                        code: 'RATE_LIMITED',
+                        message: 'API rate limit exceeded',
+                        retryAfter: parseInt(response.headers.get('Retry-After') ?? '60', 10),
+                    };
+                    continue;
+                }
+                if (response.status >= 500) {
+                    lastError = {
+                        code: 'API_ERROR',
+                        message: `Server error: ${response.status}`,
+                        details: { status: response.status },
+                    };
+                    continue;
+                }
+                const errorBody = await response.text();
+                return err({
+                    code: 'API_ERROR',
+                    message: `API error: ${response.status}`,
+                    details: { status: response.status, body: errorBody },
+                });
+            }
+            catch (error) {
+                if (error instanceof Error && error.name === 'TimeoutError') {
+                    lastError = {
+                        code: 'TIMEOUT',
+                        message: `Request timed out after ${this.config.timeout}ms`,
+                    };
+                    continue;
+                }
+                lastError = {
+                    code: 'NETWORK_ERROR',
+                    message: error instanceof Error ? error.message : 'Network error',
+                };
+                continue;
+            }
+        }
+        return err(lastError ?? {
+            code: 'API_ERROR',
+            message: 'Request failed after max retries',
+        });
+    }
+    canMakeRequest() {
+        const now = Date.now();
+        const oneMinuteAgo = now - 60000;
+        this.requestTimestamps = this.requestTimestamps.filter((ts) => ts > oneMinuteAgo);
+        return this.requestTimestamps.length < this.config.rateLimitPerMinute;
+    }
+    recordRequest() {
+        this.requestTimestamps.push(Date.now());
+    }
+    getRetryAfterSeconds() {
+        if (this.requestTimestamps.length === 0)
+            return 0;
+        const oldestTimestamp = Math.min(...this.requestTimestamps);
+        const waitUntil = oldestTimestamp + 60000;
+        return Math.ceil((waitUntil - Date.now()) / 1000);
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    extractResults(content, citations) {
+        return citations.map((url, index) => ({
+            title: `Source ${index + 1}`,
+            url,
+            snippet: content.slice(0, 200),
+            relevance: 1 - index * 0.1,
+        }));
+    }
+    extractPatterns(content) {
+        const patterns = [];
+        const patternMatch = content.match(/pattern[s]?:?\s*([^\n]+)/gi);
+        if (patternMatch) {
+            patterns.push(...patternMatch.map((m) => m.replace(/pattern[s]?:?\s*/i, '').trim()));
+        }
+        return patterns;
+    }
+    extractRecommendations(content) {
+        const recommendations = [];
+        const recMatch = content.match(/recommend[ation]?[s]?:?\s*([^\n]+)/gi);
+        if (recMatch) {
+            recommendations.push(...recMatch.map((m) => m.replace(/recommend[ation]?[s]?:?\s*/i, '').trim()));
+        }
+        return recommendations;
+    }
+}
+//# sourceMappingURL=PerplexityClient.js.map

package/dist/external/PerplexityClient.js.map

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

package/dist/external/PerplexityConfig.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Perplexity API Configuration
+ *
+ * Self-contained configuration for the Perplexity AI client.
+ * Reads from environment variables with sensible defaults.
+ */
+import { type Result } from './Result.js';
+export interface PerplexityConfigOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    timeout?: number;
+    maxRetries?: number;
+    rateLimitPerMinute?: number;
+    model?: string;
+}
+export interface PerplexityConfigError {
+    code: 'MISSING_API_KEY' | 'INVALID_CONFIG';
+    message: string;
+}
+export interface ValidatedPerplexityConfig {
+    readonly apiKey: string;
+    readonly baseUrl: string;
+    readonly timeout: number;
+    readonly maxRetries: number;
+    readonly rateLimitPerMinute: number;
+    readonly model: string;
+}
+export declare class PerplexityConfig {
+    private readonly config;
+    private constructor();
+    static create(options?: PerplexityConfigOptions): Result<PerplexityConfig, PerplexityConfigError>;
+    static fromEnv(): Result<PerplexityConfig, PerplexityConfigError>;
+    get apiKey(): string;
+    get baseUrl(): string;
+    get timeout(): number;
+    get maxRetries(): number;
+    get rateLimitPerMinute(): number;
+    get model(): string;
+}
+//# sourceMappingURL=PerplexityConfig.d.ts.map

package/dist/external/PerplexityConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerplexityConfig.d.ts","sourceRoot":"","sources":["../../src/external/PerplexityConfig.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,aAAa,CAAC;AAEnD,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,iBAAiB,GAAG,gBAAgB,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAQD,qBAAa,gBAAgB;IACP,OAAO,CAAC,QAAQ,CAAC,MAAM;IAA3C,OAAO;IAEP,MAAM,CAAC,MAAM,CACX,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;IAuBlD,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;IAIjE,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;CACF"}

package/dist/external/PerplexityConfig.js

@@ -0,0 +1,58 @@
+/**
+ * Perplexity API Configuration
+ *
+ * Self-contained configuration for the Perplexity AI client.
+ * Reads from environment variables with sensible defaults.
+ */
+import { ok, err } from './Result.js';
+const DEFAULT_BASE_URL = 'https://api.perplexity.ai';
+const DEFAULT_TIMEOUT = 30000;
+const DEFAULT_MAX_RETRIES = 3;
+const DEFAULT_RATE_LIMIT = 10;
+const DEFAULT_MODEL = 'sonar';
+export class PerplexityConfig {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    static create(options = {}) {
+        const apiKey = options.apiKey ?? process.env.PERPLEXITY_API_KEY;
+        if (!apiKey || apiKey.trim() === '') {
+            return err({
+                code: 'MISSING_API_KEY',
+                message: 'Perplexity API key is required. Set PERPLEXITY_API_KEY env var or pass apiKey option.',
+            });
+        }
+        const config = {
+            apiKey: apiKey.trim(),
+            baseUrl: options.baseUrl ?? process.env.PERPLEXITY_BASE_URL ?? DEFAULT_BASE_URL,
+            timeout: options.timeout ?? DEFAULT_TIMEOUT,
+            maxRetries: options.maxRetries ?? DEFAULT_MAX_RETRIES,
+            rateLimitPerMinute: options.rateLimitPerMinute ?? DEFAULT_RATE_LIMIT,
+            model: options.model ?? process.env.PERPLEXITY_MODEL ?? DEFAULT_MODEL,
+        };
+        return ok(new PerplexityConfig(config));
+    }
+    static fromEnv() {
+        return PerplexityConfig.create({});
+    }
+    get apiKey() {
+        return this.config.apiKey;
+    }
+    get baseUrl() {
+        return this.config.baseUrl;
+    }
+    get timeout() {
+        return this.config.timeout;
+    }
+    get maxRetries() {
+        return this.config.maxRetries;
+    }
+    get rateLimitPerMinute() {
+        return this.config.rateLimitPerMinute;
+    }
+    get model() {
+        return this.config.model;
+    }
+}
+//# sourceMappingURL=PerplexityConfig.js.map

package/dist/external/PerplexityConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerplexityConfig.js","sourceRoot":"","sources":["../../src/external/PerplexityConfig.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAe,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAyBnD,MAAM,gBAAgB,GAAG,2BAA2B,CAAC;AACrD,MAAM,eAAe,GAAG,KAAK,CAAC;AAC9B,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAC9B,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAC9B,MAAM,aAAa,GAAG,OAAO,CAAC;AAE9B,MAAM,OAAO,gBAAgB;IACU;IAArC,YAAqC,MAAiC;QAAjC,WAAM,GAAN,MAAM,CAA2B;IAAG,CAAC;IAE1E,MAAM,CAAC,MAAM,CACX,UAAmC,EAAE;QAErC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAEhE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACpC,OAAO,GAAG,CAAC;gBACT,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EACL,uFAAuF;aAC1F,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAA8B;YACxC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;YACrB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,gBAAgB;YAC/E,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,eAAe;YAC3C,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,mBAAmB;YACrD,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,kBAAkB;YACpE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,aAAa;SACtE,CAAC;QAEF,OAAO,EAAE,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,CAAC,OAAO;QACZ,OAAO,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;IAChC,CAAC;IAED,IAAI,kBAAkB;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC;IACxC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC3B,CAAC;CACF"}

package/dist/external/Result.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Minimal Result Type for Perplexity Client
+ *
+ * Railway-oriented programming pattern for error handling.
+ * Subset of the main project's Result type, self-contained for the thin client package.
+ */
+export type Result<T, E> = Ok<T, E> | Err<T, E>;
+export declare class Ok<T, E> {
+    readonly value: T;
+    constructor(value: T);
+    isOk(): this is Ok<T, E>;
+    isErr(): this is Err<T, E>;
+    unwrap(): T;
+    unwrapErr(): E;
+}
+export declare class Err<T, E> {
+    readonly error: E;
+    constructor(error: E);
+    isOk(): this is Ok<T, E>;
+    isErr(): this is Err<T, E>;
+    unwrap(): T;
+    unwrapErr(): E;
+}
+export declare const ok: <T, E = never>(value: T) => Result<T, E>;
+export declare const err: <E, T = never>(error: E) => Result<T, E>;
+//# sourceMappingURL=Result.d.ts.map

package/dist/external/Result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Result.d.ts","sourceRoot":"","sources":["../../src/external/Result.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEhD,qBAAa,EAAE,CAAC,CAAC,EAAE,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;gBAEN,KAAK,EAAE,CAAC;IAIpB,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAIxB,KAAK,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAI1B,MAAM,IAAI,CAAC;IAIX,SAAS,IAAI,CAAC;CAGf;AAED,qBAAa,GAAG,CAAC,CAAC,EAAE,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;gBAEN,KAAK,EAAE,CAAC;IAIpB,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAIxB,KAAK,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAI1B,MAAM,IAAI,CAAC;IAIX,SAAS,IAAI,CAAC;CAGf;AAED,eAAO,MAAM,EAAE,GAAI,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,OAAO,CAAC,KAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAkB,CAAC;AAC1E,eAAO,MAAM,GAAG,GAAI,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,OAAO,CAAC,KAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAmB,CAAC"}

package/dist/external/Result.js

@@ -0,0 +1,45 @@
+/**
+ * Minimal Result Type for Perplexity Client
+ *
+ * Railway-oriented programming pattern for error handling.
+ * Subset of the main project's Result type, self-contained for the thin client package.
+ */
+export class Ok {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    isOk() {
+        return true;
+    }
+    isErr() {
+        return false;
+    }
+    unwrap() {
+        return this.value;
+    }
+    unwrapErr() {
+        throw new Error('Called unwrapErr on Ok value');
+    }
+}
+export class Err {
+    error;
+    constructor(error) {
+        this.error = error;
+    }
+    isOk() {
+        return false;
+    }
+    isErr() {
+        return true;
+    }
+    unwrap() {
+        throw new Error(`Called unwrap on Err value: ${String(this.error)}`);
+    }
+    unwrapErr() {
+        return this.error;
+    }
+}
+export const ok = (value) => new Ok(value);
+export const err = (error) => new Err(error);
+//# sourceMappingURL=Result.js.map

package/dist/external/Result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Result.js","sourceRoot":"","sources":["../../src/external/Result.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,OAAO,EAAE;IACJ,KAAK,CAAI;IAElB,YAAY,KAAQ;QAClB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,SAAS;QACP,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;CACF;AAED,MAAM,OAAO,GAAG;IACL,KAAK,CAAI;IAElB,YAAY,KAAQ;QAClB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM;QACJ,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,EAAE,GAAG,CAAe,KAAQ,EAAgB,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;AAC1E,MAAM,CAAC,MAAM,GAAG,GAAG,CAAe,KAAQ,EAAgB,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC"}

package/dist/index.d.ts

@@ -2,10 +2,14 @@
 /**
  * MCP Thin Client Entry Point
  *
- * This is a thin client that delegates all operations to the Orchestrator REST API.
- * It implements the Model Context Protocol (MCP) server interface.
+ * Supports multiple server modes via --server flag:
+ *   --server core       → orchestrator-tools (core ~59 tools)
+ *   --server extended   → orchestrator-extended (11 tools)
+ *   --server perplexity → perplexity (4 tools, calls Perplexity API directly)
+ *   (default)           → uses MCP_TOOL_SET env var, falls back to 'all'
  */
 export { OrchestratorMcpServer } from './server.js';
+export { PerplexityMcpServer } from './PerplexityMcpServer.js';
 export { OrchestratorApiClient } from './client/OrchestratorApiClient.js';
 export { loadConfig } from './config.js';
 export type { Config } from './config.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAuCH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAkEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -2,18 +2,44 @@
 /**
  * MCP Thin Client Entry Point
  *
- * This is a thin client that delegates all operations to the Orchestrator REST API.
- * It implements the Model Context Protocol (MCP) server interface.
+ * Supports multiple server modes via --server flag:
+ *   --server core       → orchestrator-tools (core ~59 tools)
+ *   --server extended   → orchestrator-extended (11 tools)
+ *   --server perplexity → perplexity (4 tools, calls Perplexity API directly)
+ *   (default)           → uses MCP_TOOL_SET env var, falls back to 'all'
  */
 import { realpathSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { OrchestratorMcpServer } from './server.js';
+import { PerplexityMcpServer } from './PerplexityMcpServer.js';
 import { loadConfig } from './config.js';
+/**
+ * Parse --server <type> from process.argv
+ */
+function parseServerArg() {
+    const idx = process.argv.indexOf('--server');
+    if (idx !== -1 && idx + 1 < process.argv.length) {
+        return process.argv[idx + 1];
+    }
+    return undefined;
+}
 /**
  * Main entry point for CLI execution
  */
 async function main() {
     try {
+        const serverArg = parseServerArg();
+        // Perplexity mode: standalone server that calls Perplexity API directly
+        if (serverArg === 'perplexity') {
+            console.error('Starting Perplexity MCP Server...');
+            const server = new PerplexityMcpServer();
+            await server.start();
+            return;
+        }
+        // Override MCP_TOOL_SET from --server arg if provided
+        if (serverArg) {
+            process.env.MCP_TOOL_SET = serverArg;
+        }
         const config = loadConfig();
         const server = new OrchestratorMcpServer(config);
         console.error('Starting Orchestrator MCP Server...');
@@ -37,6 +63,7 @@ if (isEntryPoint) {
 }
 // Re-export for library usage
 export { OrchestratorMcpServer } from './server.js';
+export { PerplexityMcpServer } from './PerplexityMcpServer.js';
 export { OrchestratorApiClient } from './client/OrchestratorApiClient.js';
 export { loadConfig } from './config.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAEjD,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACrD,OAAO,CAAC,KAAK,CAAC,YAAY,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,KAAK,CAAC,YAAY,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAE7E,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,+CAA+C;AAC/C,yDAAyD;AACzD,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,YAAY,GAChB,WAAW,KAAK,UAAU;IAC1B,YAAY,CAAC,WAAW,CAAC,KAAK,YAAY,CAAC,UAAU,CAAC,CAAC;AAEzD,IAAI,YAAY,EAAE,CAAC;IACjB,IAAI,EAAE,CAAC;AACT,CAAC;AAED,8BAA8B;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,SAAS,cAAc;IACrB,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAChD,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,cAAc,EAAE,CAAC;QAEnC,wEAAwE;QACxE,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;YAC/B,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;YACnD,MAAM,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;YACzC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,sDAAsD;QACtD,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,SAAS,CAAC;QACvC,CAAC;QAED,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAEjD,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACrD,OAAO,CAAC,KAAK,CAAC,YAAY,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,KAAK,CAAC,YAAY,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAE7E,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,+CAA+C;AAC/C,yDAAyD;AACzD,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,YAAY,GAChB,WAAW,KAAK,UAAU;IAC1B,YAAY,CAAC,WAAW,CAAC,KAAK,YAAY,CAAC,UAAU,CAAC,CAAC;AAEzD,IAAI,YAAY,EAAE,CAAC;IACjB,IAAI,EAAE,CAAC;AACT,CAAC;AAED,8BAA8B;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orchestrator-claude/mcp-server",
-  "version": "3.3.2",
+  "version": "3.3.3",
   "description": "MCP Thin Client for Orchestrator - delegates to REST API",
   "type": "module",
   "main": "dist/index.js",