@portel/photon-core 1.5.0 → 2.1.0

package/dist/mcp-client.d.ts

@@ -1,218 +0,0 @@
-/**
- * MCP Protocol Client for Photons
- *
- * Enables Photons to call external MCPs via the MCP protocol.
- * This is runtime-agnostic - the actual transport is provided by the runtime (NCP, Lumina, etc.)
- *
- * Usage in Photon:
- * ```typescript
- * export default class MyPhoton extends PhotonMCP {
- *   async doSomething() {
- *     const github = this.mcp('github');
- *     const issues = await github.call('list_issues', { repo: 'foo/bar' });
- *   }
- * }
- * ```
- */
-/**
- * Tool information returned from MCP discovery
- */
-export interface MCPToolInfo {
-    name: string;
-    description?: string;
-    inputSchema?: {
-        type: 'object';
-        properties?: Record<string, any>;
-        required?: string[];
-    };
-}
-/**
- * Result from an MCP tool call
- */
-export interface MCPToolResult {
-    content: Array<{
-        type: 'text' | 'image' | 'resource';
-        text?: string;
-        data?: string;
-        mimeType?: string;
-    }>;
-    isError?: boolean;
-}
-/**
- * Interface that runtimes must implement to provide MCP connectivity
- * This keeps photon-core runtime-agnostic
- */
-export interface MCPTransport {
-    /**
-     * Call a tool on an MCP server
-     * @param mcpName The MCP server name
-     * @param toolName The tool to call
-     * @param parameters Tool parameters
-     */
-    callTool(mcpName: string, toolName: string, parameters: Record<string, any>): Promise<MCPToolResult>;
-    /**
-     * List available tools on an MCP server
-     * @param mcpName The MCP server name
-     */
-    listTools(mcpName: string): Promise<MCPToolInfo[]>;
-    /**
-     * Check if an MCP server is connected/available
-     * @param mcpName The MCP server name
-     */
-    isConnected(mcpName: string): Promise<boolean>;
-}
-/**
- * Factory interface for creating MCP clients
- * Runtimes implement this to provide MCP access to Photons
- */
-export interface MCPClientFactory {
-    /**
-     * Create an MCP client for a specific server
-     * @param mcpName The MCP server name
-     */
-    create(mcpName: string): MCPClient;
-    /**
-     * List all available MCP servers
-     */
-    listServers(): Promise<string[]>;
-}
-/**
- * MCP Client - Protocol wrapper for calling external MCPs
- *
- * Provides a clean async interface for Photons to call MCP tools.
- * The actual protocol communication is handled by the transport layer.
- */
-export declare class MCPClient {
-    private mcpName;
-    private transport;
-    private toolsCache;
-    constructor(mcpName: string, transport: MCPTransport);
-    /**
-     * Get the MCP server name
-     */
-    get name(): string;
-    /**
-     * Call a tool on this MCP server
-     *
-     * @param toolName The tool to call
-     * @param parameters Tool parameters
-     * @returns Tool result (parsed from MCP response)
-     *
-     * @example
-     * ```typescript
-     * const github = this.mcp('github');
-     * const issues = await github.call('list_issues', { repo: 'owner/repo', state: 'open' });
-     * ```
-     */
-    call(toolName: string, parameters?: Record<string, any>): Promise<any>;
-    /**
-     * List all available tools on this MCP server
-     *
-     * @returns Array of tool information
-     *
-     * @example
-     * ```typescript
-     * const github = this.mcp('github');
-     * const tools = await github.list();
-     * // [{ name: 'list_issues', description: '...' }, ...]
-     * ```
-     */
-    list(): Promise<MCPToolInfo[]>;
-    /**
-     * Find tools matching a query
-     *
-     * @param query Search query (matches name or description)
-     * @returns Matching tools
-     *
-     * @example
-     * ```typescript
-     * const github = this.mcp('github');
-     * const issueTools = await github.find('issue');
-     * ```
-     */
-    find(query: string): Promise<MCPToolInfo[]>;
-    /**
-     * Check if this MCP server is connected
-     */
-    isConnected(): Promise<boolean>;
-    /**
-     * Clear the tools cache (useful after reconnection)
-     */
-    clearCache(): void;
-    /**
-     * Parse MCP tool result into a usable value
-     */
-    private parseResult;
-}
-/**
- * Base class for MCP-related errors
- */
-export declare class MCPError extends Error {
-    readonly mcpName: string;
-    constructor(mcpName: string, message: string);
-}
-/**
- * Error thrown when MCP server is not connected
- */
-export declare class MCPNotConnectedError extends MCPError {
-    constructor(mcpName: string);
-}
-/**
- * Error thrown when MCP tool call fails
- */
-export declare class MCPToolError extends MCPError {
-    readonly toolName: string;
-    readonly details: string;
-    constructor(mcpName: string, toolName: string, details: string);
-}
-/**
- * MCP source type - how the MCP was declared
- */
-export type MCPSourceType = 'npm' | 'github' | 'local' | 'url' | 'unknown';
-/**
- * Information about a missing MCP dependency
- */
-export interface MissingMCPInfo {
-    name: string;
-    source: string;
-    sourceType: MCPSourceType;
-    declaredIn?: string;
-    originalError?: string;
-}
-/**
- * Error thrown when MCP is not configured correctly
- * Provides detailed, actionable guidance for users
- */
-export declare class MCPConfigurationError extends MCPError {
-    readonly configPath: string;
-    readonly missingMCPs: MissingMCPInfo[];
-    constructor(missingMCPs: MissingMCPInfo[]);
-    /**
-     * Format detailed error message with configuration instructions
-     */
-    private static formatMessage;
-    /**
-     * Generate example JSON config for missing MCPs
-     */
-    private static generateExampleConfig;
-    /**
-     * Get example server config based on source type
-     */
-    private static getExampleServerConfig;
-    /**
-     * Get source-type specific guidance
-     */
-    private static getSourceTypeGuide;
-}
-/**
- * Create a proxy-based MCP client that allows direct method calls
- *
- * This enables a more fluent API:
- * ```typescript
- * const github = this.mcp('github');
- * // Instead of: await github.call('list_issues', { repo: 'foo/bar' })
- * // You can do: await github.list_issues({ repo: 'foo/bar' })
- * ```
- */
-export declare function createMCPProxy(client: MCPClient): MCPClient & Record<string, (params?: any) => Promise<any>>;
-//# sourceMappingURL=mcp-client.d.ts.map

package/dist/mcp-client.d.ts.map

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

package/dist/mcp-client.js

@@ -1,424 +0,0 @@
-/**
- * MCP Protocol Client for Photons
- *
- * Enables Photons to call external MCPs via the MCP protocol.
- * This is runtime-agnostic - the actual transport is provided by the runtime (NCP, Lumina, etc.)
- *
- * Usage in Photon:
- * ```typescript
- * export default class MyPhoton extends PhotonMCP {
- *   async doSomething() {
- *     const github = this.mcp('github');
- *     const issues = await github.call('list_issues', { repo: 'foo/bar' });
- *   }
- * }
- * ```
- */
-/**
- * MCP Client - Protocol wrapper for calling external MCPs
- *
- * Provides a clean async interface for Photons to call MCP tools.
- * The actual protocol communication is handled by the transport layer.
- */
-export class MCPClient {
-    mcpName;
-    transport;
-    toolsCache = null;
-    constructor(mcpName, transport) {
-        this.mcpName = mcpName;
-        this.transport = transport;
-    }
-    /**
-     * Get the MCP server name
-     */
-    get name() {
-        return this.mcpName;
-    }
-    /**
-     * Call a tool on this MCP server
-     *
-     * @param toolName The tool to call
-     * @param parameters Tool parameters
-     * @returns Tool result (parsed from MCP response)
-     *
-     * @example
-     * ```typescript
-     * const github = this.mcp('github');
-     * const issues = await github.call('list_issues', { repo: 'owner/repo', state: 'open' });
-     * ```
-     */
-    async call(toolName, parameters = {}) {
-        // Check connection first
-        const connected = await this.transport.isConnected(this.mcpName);
-        if (!connected) {
-            throw new MCPNotConnectedError(this.mcpName);
-        }
-        try {
-            const result = await this.transport.callTool(this.mcpName, toolName, parameters);
-            if (result.isError) {
-                const errorText = result.content.find(c => c.type === 'text')?.text || 'Unknown error';
-                throw new MCPToolError(this.mcpName, toolName, errorText);
-            }
-            // Extract and parse the result
-            return this.parseResult(result);
-        }
-        catch (error) {
-            if (error instanceof MCPError) {
-                throw error;
-            }
-            throw new MCPToolError(this.mcpName, toolName, error instanceof Error ? error.message : String(error));
-        }
-    }
-    /**
-     * List all available tools on this MCP server
-     *
-     * @returns Array of tool information
-     *
-     * @example
-     * ```typescript
-     * const github = this.mcp('github');
-     * const tools = await github.list();
-     * // [{ name: 'list_issues', description: '...' }, ...]
-     * ```
-     */
-    async list() {
-        if (this.toolsCache) {
-            return this.toolsCache;
-        }
-        const connected = await this.transport.isConnected(this.mcpName);
-        if (!connected) {
-            throw new MCPNotConnectedError(this.mcpName);
-        }
-        this.toolsCache = await this.transport.listTools(this.mcpName);
-        return this.toolsCache;
-    }
-    /**
-     * Find tools matching a query
-     *
-     * @param query Search query (matches name or description)
-     * @returns Matching tools
-     *
-     * @example
-     * ```typescript
-     * const github = this.mcp('github');
-     * const issueTools = await github.find('issue');
-     * ```
-     */
-    async find(query) {
-        const tools = await this.list();
-        const lowerQuery = query.toLowerCase();
-        return tools.filter(t => t.name.toLowerCase().includes(lowerQuery) ||
-            t.description?.toLowerCase().includes(lowerQuery));
-    }
-    /**
-     * Check if this MCP server is connected
-     */
-    async isConnected() {
-        return this.transport.isConnected(this.mcpName);
-    }
-    /**
-     * Clear the tools cache (useful after reconnection)
-     */
-    clearCache() {
-        this.toolsCache = null;
-    }
-    /**
-     * Parse MCP tool result into a usable value
-     */
-    parseResult(result) {
-        if (!result.content || result.content.length === 0) {
-            return null;
-        }
-        // Single text result - try to parse as JSON
-        if (result.content.length === 1 && result.content[0].type === 'text') {
-            const text = result.content[0].text || '';
-            try {
-                return JSON.parse(text);
-            }
-            catch {
-                return text;
-            }
-        }
-        // Multiple results or non-text - return as-is
-        return result.content.map(c => {
-            if (c.type === 'text') {
-                try {
-                    return JSON.parse(c.text || '');
-                }
-                catch {
-                    return c.text;
-                }
-            }
-            return c;
-        });
-    }
-}
-/**
- * Base class for MCP-related errors
- */
-export class MCPError extends Error {
-    mcpName;
-    constructor(mcpName, message) {
-        super(message);
-        this.mcpName = mcpName;
-        this.name = 'MCPError';
-    }
-}
-/**
- * Error thrown when MCP server is not connected
- */
-export class MCPNotConnectedError extends MCPError {
-    constructor(mcpName) {
-        super(mcpName, `MCP server '${mcpName}' is not connected`);
-        this.name = 'MCPNotConnectedError';
-    }
-}
-/**
- * Error thrown when MCP tool call fails
- */
-export class MCPToolError extends MCPError {
-    toolName;
-    details;
-    constructor(mcpName, toolName, details) {
-        super(mcpName, `MCP tool '${mcpName}:${toolName}' failed: ${details}`);
-        this.toolName = toolName;
-        this.details = details;
-        this.name = 'MCPToolError';
-    }
-}
-/**
- * Error thrown when MCP is not configured correctly
- * Provides detailed, actionable guidance for users
- */
-export class MCPConfigurationError extends MCPError {
-    configPath;
-    missingMCPs;
-    constructor(missingMCPs) {
-        const configPath = `~/.photon/mcp-servers.json`;
-        const message = MCPConfigurationError.formatMessage(missingMCPs, configPath);
-        super(missingMCPs[0]?.name || 'unknown', message);
-        this.name = 'MCPConfigurationError';
-        this.configPath = configPath;
-        this.missingMCPs = missingMCPs;
-    }
-    /**
-     * Format detailed error message with configuration instructions
-     */
-    static formatMessage(missingMCPs, configPath) {
-        const lines = [
-            '',
-            '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
-            '❌ MCP Configuration Required',
-            '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
-            '',
-        ];
-        // List missing MCPs
-        lines.push(`The following MCP server${missingMCPs.length > 1 ? 's are' : ' is'} required but not configured:`);
-        lines.push('');
-        for (const mcp of missingMCPs) {
-            lines.push(`  • ${mcp.name}`);
-            if (mcp.source) {
-                lines.push(`    Source: ${mcp.source} (${mcp.sourceType})`);
-            }
-            if (mcp.declaredIn) {
-                lines.push(`    Declared in: ${mcp.declaredIn}`);
-            }
-            if (mcp.originalError) {
-                lines.push(`    Error: ${mcp.originalError}`);
-            }
-            lines.push('');
-        }
-        // Configuration instructions
-        lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-        lines.push('🔧 How to Fix');
-        lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-        lines.push('');
-        lines.push(`Add the following to ${configPath}:`);
-        lines.push('');
-        // Generate example config
-        const exampleConfig = MCPConfigurationError.generateExampleConfig(missingMCPs);
-        lines.push(exampleConfig);
-        lines.push('');
-        // Step-by-step instructions
-        lines.push('Steps:');
-        lines.push(`  1. Create or edit ${configPath}`);
-        lines.push('  2. Add the configuration above');
-        lines.push('  3. Replace placeholder values with your actual configuration');
-        lines.push('  4. Restart the Photon');
-        lines.push('');
-        // Per-source-type guidance
-        const uniqueTypes = new Set(missingMCPs.map(m => m.sourceType));
-        if (uniqueTypes.size > 0) {
-            lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-            lines.push('📖 Configuration Guide');
-            lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-            lines.push('');
-            for (const type of uniqueTypes) {
-                lines.push(...MCPConfigurationError.getSourceTypeGuide(type));
-                lines.push('');
-            }
-        }
-        lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-        return lines.join('\n');
-    }
-    /**
-     * Generate example JSON config for missing MCPs
-     */
-    static generateExampleConfig(missingMCPs) {
-        const servers = {};
-        for (const mcp of missingMCPs) {
-            servers[mcp.name] = MCPConfigurationError.getExampleServerConfig(mcp);
-        }
-        const config = { mcpServers: servers };
-        return JSON.stringify(config, null, 2)
-            .split('\n')
-            .map(line => '  ' + line)
-            .join('\n');
-    }
-    /**
-     * Get example server config based on source type
-     */
-    static getExampleServerConfig(mcp) {
-        switch (mcp.sourceType) {
-            case 'npm':
-                return {
-                    command: 'npx',
-                    args: ['-y', mcp.source],
-                    env: {
-                        '// Add required environment variables here': '',
-                    },
-                };
-            case 'github': {
-                // Parse github source: owner/repo or owner/repo#branch
-                const [repo, branch] = mcp.source.split('#');
-                const args = ['-y', `github:${repo}`];
-                if (branch) {
-                    args[1] = `github:${repo}#${branch}`;
-                }
-                return {
-                    command: 'npx',
-                    args,
-                    env: {
-                        '// Add required environment variables here': '',
-                    },
-                };
-            }
-            case 'url':
-                if (mcp.source.startsWith('ws://') || mcp.source.startsWith('wss://')) {
-                    return {
-                        url: mcp.source,
-                        transport: 'websocket',
-                    };
-                }
-                return {
-                    url: mcp.source,
-                    transport: 'sse',
-                };
-            case 'local':
-                return {
-                    command: mcp.source,
-                    args: [],
-                    cwd: '// Optional: working directory',
-                };
-            default:
-                return {
-                    '// Configure this MCP server': '',
-                    command: 'npx',
-                    args: ['-y', '<package-name>'],
-                };
-        }
-    }
-    /**
-     * Get source-type specific guidance
-     */
-    static getSourceTypeGuide(type) {
-        switch (type) {
-            case 'npm':
-                return [
-                    '📦 NPM Packages:',
-                    '   MCP servers from npm are run via npx.',
-                    '   Example: @modelcontextprotocol/server-github',
-                    '',
-                    '   {',
-                    '     "command": "npx",',
-                    '     "args": ["-y", "@modelcontextprotocol/server-github"],',
-                    '     "env": {',
-                    '       "GITHUB_TOKEN": "ghp_your_token_here"',
-                    '     }',
-                    '   }',
-                ];
-            case 'github':
-                return [
-                    '🐙 GitHub Repositories:',
-                    '   MCP servers from GitHub repos are cloned and run.',
-                    '   Format: owner/repo or owner/repo#branch',
-                    '',
-                    '   {',
-                    '     "command": "npx",',
-                    '     "args": ["-y", "github:anthropics/mcp-server-github"],',
-                    '     "env": {',
-                    '       "GITHUB_TOKEN": "ghp_your_token_here"',
-                    '     }',
-                    '   }',
-                ];
-            case 'url':
-                return [
-                    '🌐 Remote URLs:',
-                    '   MCP servers running on remote hosts.',
-                    '',
-                    '   HTTP/SSE:',
-                    '   {',
-                    '     "url": "https://mcp.example.com/api",',
-                    '     "transport": "sse",',
-                    '     "headers": { "Authorization": "Bearer token" }',
-                    '   }',
-                    '',
-                    '   WebSocket:',
-                    '   {',
-                    '     "url": "wss://mcp.example.com/ws",',
-                    '     "transport": "websocket"',
-                    '   }',
-                ];
-            case 'local':
-                return [
-                    '💻 Local Commands:',
-                    '   MCP servers running as local processes.',
-                    '',
-                    '   {',
-                    '     "command": "/path/to/mcp-server",',
-                    '     "args": ["--port", "3000"],',
-                    '     "cwd": "/working/directory",',
-                    '     "env": { "CONFIG": "value" }',
-                    '   }',
-                ];
-            default:
-                return [
-                    '⚙️ Custom Configuration:',
-                    '   Configure the MCP server based on its documentation.',
-                ];
-        }
-    }
-}
-/**
- * Create a proxy-based MCP client that allows direct method calls
- *
- * This enables a more fluent API:
- * ```typescript
- * const github = this.mcp('github');
- * // Instead of: await github.call('list_issues', { repo: 'foo/bar' })
- * // You can do: await github.list_issues({ repo: 'foo/bar' })
- * ```
- */
-export function createMCPProxy(client) {
-    return new Proxy(client, {
-        get(target, prop) {
-            // Return existing methods
-            if (prop in target) {
-                return target[prop];
-            }
-            // Return a function that calls the tool
-            return (params = {}) => target.call(prop, params);
-        },
-    });
-}
-//# sourceMappingURL=mcp-client.js.map

package/dist/mcp-client.js.map

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