@portel/photon 1.8.4 → 1.10.0

package/dist/auto-ui/beam/external-mcp.js

@@ -0,0 +1,311 @@
+/**
+ * External MCP management — connect, load, reconnect external MCP servers.
+ *
+ * Extracted from beam.ts. All shared state is passed explicitly via
+ * ExternalMCPState rather than module-level globals.
+ */
+import { createHash } from 'crypto';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
+import { ElicitRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { SDKMCPClientFactory } from '@portel/photon-core';
+import { logger } from '../../shared/logger.js';
+import { requestExternalElicitation } from '../streamable-http-transport.js';
+import { prettifyToolName } from './class-metadata.js';
+import { withTimeout } from '../../async/index.js';
+/**
+ * Generate a unique ID for an external MCP based on its name.
+ */
+export function generateExternalMCPId(name) {
+    return createHash('sha256').update(`external:${name}`).digest('hex').slice(0, 12);
+}
+/**
+ * Create an HTTP transport for a URL-based MCP.
+ * Tries Streamable HTTP first; falls back to legacy SSE.
+ */
+async function connectHTTPClient(url, mcpName) {
+    const sdkClient = new Client({ name: 'beam-mcp-client', version: '1.0.0' }, {
+        capabilities: {
+            elicitation: {},
+            experimental: {
+                ui: {},
+            },
+        },
+    });
+    sdkClient.setRequestHandler(ElicitRequestSchema, async (request) => {
+        const params = request.params;
+        const result = await requestExternalElicitation(mcpName, {
+            mode: params.mode,
+            message: params.message,
+            requestedSchema: params.requestedSchema,
+            url: params.url,
+        });
+        return result;
+    });
+    try {
+        const transport = new StreamableHTTPClientTransport(new URL(url));
+        const connectPromise = sdkClient.connect(transport);
+        await withTimeout(connectPromise, 10000, 'Connection timeout (10s)');
+        logger.debug(`Connected to ${url} via Streamable HTTP`);
+        return sdkClient;
+    }
+    catch (streamableError) {
+        logger.debug(`Streamable HTTP failed for ${url}, trying legacy SSE: ${String(streamableError)}`);
+    }
+    // Fallback: legacy SSE transport
+    const sseClient = new Client({ name: 'beam-mcp-client', version: '1.0.0' }, {
+        capabilities: {
+            elicitation: {},
+            experimental: {
+                ui: {},
+            },
+        },
+    });
+    sseClient.setRequestHandler(ElicitRequestSchema, async (request) => {
+        const params = request.params;
+        const result = await requestExternalElicitation(mcpName, {
+            mode: params.mode,
+            message: params.message,
+            requestedSchema: params.requestedSchema,
+            url: params.url,
+        });
+        return result;
+    });
+    const sseTransport = new SSEClientTransport(new URL(url));
+    const connectPromise = sseClient.connect(sseTransport);
+    await withTimeout(connectPromise, 10000, 'Connection timeout (10s)');
+    logger.debug(`Connected to ${url} via legacy SSE`);
+    return sseClient;
+}
+/** Extract tools → MethodInfo[] from an SDK client */
+function toolsToMethods(tools) {
+    return tools.map((tool) => ({
+        name: tool.name,
+        description: tool.description || '',
+        params: tool.inputSchema || { type: 'object', properties: {} },
+        returns: { type: 'object' },
+        icon: tool['x-icon'],
+        linkedUi: tool._meta?.ui?.resourceUri,
+        visibility: tool._meta?.ui?.visibility,
+    }));
+}
+/** Detect MCP App resources from an SDK client */
+async function detectMCPApps(sdkClient, methods, mcpInfo, name) {
+    try {
+        const resourcesResult = await sdkClient.listResources();
+        const resources = resourcesResult.resources || [];
+        const allUiResources = resources.filter((r) => r.uri?.startsWith('ui://') || r.mimeType === 'application/vnd.mcp.ui+html');
+        mcpInfo.resourceCount = resources.length - allUiResources.length;
+        const toolLinkedUris = new Set(methods.map((m) => m.linkedUi).filter(Boolean));
+        const standaloneResources = allUiResources.filter((r) => !toolLinkedUris.has(r.uri));
+        if (standaloneResources.length > 0) {
+            mcpInfo.hasApp = true;
+            mcpInfo.appResourceUri = standaloneResources[0].uri;
+            mcpInfo.appResourceUris = standaloneResources.map((r) => r.uri);
+            const uriList = mcpInfo.appResourceUris.join(', ');
+            logger.info(`🎨 MCP App detected: ${name} (${uriList})`);
+        }
+    }
+    catch {
+        logger.debug(`Resources not supported by ${name}`);
+    }
+}
+/**
+ * Load external MCPs from config.json mcpServers section.
+ *
+ * Populates state.externalMCPClients and state.externalMCPSDKClients as
+ * side effects. Returns the ExternalMCPInfo[] array to be pushed into
+ * state.externalMCPs by the caller.
+ */
+export async function loadExternalMCPs(config, state) {
+    const mcpServers = config.mcpServers || {};
+    const results = [];
+    for (const [name, serverConfig] of Object.entries(mcpServers)) {
+        const mcpId = generateExternalMCPId(name);
+        const mcpInfo = {
+            type: 'external-mcp',
+            id: mcpId,
+            name,
+            connected: false,
+            methods: [],
+            label: prettifyToolName(name),
+            icon: '🔌',
+            config: serverConfig,
+        };
+        try {
+            let methods = [];
+            if (serverConfig.url) {
+                // HTTP transport — SDK client only
+                const sdkClient = await connectHTTPClient(serverConfig.url, name);
+                state.externalMCPSDKClients.set(name, sdkClient);
+                const toolsResult = await sdkClient.listTools();
+                methods = toolsToMethods(toolsResult.tools || []);
+                await detectMCPApps(sdkClient, methods, mcpInfo, name);
+                mcpInfo.connected = true;
+                mcpInfo.methods = methods;
+            }
+            else if (serverConfig.command) {
+                // Stdio transport
+                const mcpConfig = { mcpServers: { [name]: serverConfig } };
+                const factory = new SDKMCPClientFactory(mcpConfig, false);
+                const client = factory.create(name);
+                state.externalMCPClients.set(name, client);
+                try {
+                    const sdkTransport = new StdioClientTransport({
+                        command: serverConfig.command,
+                        args: serverConfig.args,
+                        cwd: serverConfig.cwd,
+                        env: serverConfig.env,
+                        stderr: 'ignore',
+                    });
+                    const sdkClient = new Client({ name: 'beam-mcp-client', version: '1.0.0' }, {
+                        capabilities: {
+                            elicitation: {},
+                            experimental: { ui: {} },
+                        },
+                    });
+                    sdkClient.setRequestHandler(ElicitRequestSchema, async (request) => {
+                        const params = request.params;
+                        const result = await requestExternalElicitation(name, {
+                            mode: params.mode,
+                            message: params.message,
+                            requestedSchema: params.requestedSchema,
+                            url: params.url,
+                        });
+                        return result;
+                    });
+                    const connectPromise = sdkClient.connect(sdkTransport);
+                    await withTimeout(connectPromise, 10000, 'Connection timeout (10s)');
+                    state.externalMCPSDKClients.set(name, sdkClient);
+                    const toolsResult = await sdkClient.listTools();
+                    methods = toolsToMethods(toolsResult.tools || []);
+                    await detectMCPApps(sdkClient, methods, mcpInfo, name);
+                    mcpInfo.connected = true;
+                    mcpInfo.methods = methods;
+                }
+                catch (sdkError) {
+                    throw sdkError;
+                }
+            }
+            else {
+                // No command or URL — wrapper client (legacy fallback)
+                const mcpConfig = { mcpServers: { [name]: serverConfig } };
+                const factory = new SDKMCPClientFactory(mcpConfig, false);
+                const client = factory.create(name);
+                state.externalMCPClients.set(name, client);
+                const tools = await client.list();
+                methods = (tools || []).map((tool) => ({
+                    name: tool.name,
+                    description: tool.description || '',
+                    params: tool.inputSchema || { type: 'object', properties: {} },
+                    returns: { type: 'object' },
+                    icon: tool['x-icon'],
+                }));
+                mcpInfo.connected = true;
+                mcpInfo.methods = methods;
+            }
+            logger.info(`🔌 Connected to external MCP: ${name} (${methods.length} tools)`);
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            mcpInfo.errorMessage = errorMsg.slice(0, 200);
+            const shortMsg = errorMsg.includes('Cannot find module')
+                ? `Module not found (run npm build in the MCP directory)`
+                : errorMsg.includes('ENOENT')
+                    ? `Command not found: ${serverConfig.command}`
+                    : errorMsg.includes('Connection timeout')
+                        ? `Connection timed out (server may not be running)`
+                        : errorMsg.includes('Connection closed')
+                            ? `Server exited immediately (check configuration)`
+                            : errorMsg.slice(0, 120);
+            logger.warn(`⚠️  External MCP "${name}" — ${shortMsg}`);
+        }
+        results.push(mcpInfo);
+    }
+    return results;
+}
+/**
+ * Reconnect a failed external MCP.
+ *
+ * Uses re-find-after-await pattern for safe access to state.externalMCPs.
+ */
+export async function reconnectExternalMCP(name, state) {
+    const mcpIndex = state.externalMCPs.findIndex((m) => m.name === name);
+    if (mcpIndex === -1) {
+        return { success: false, error: `External MCP not found: ${name}` };
+    }
+    const mcpConfig = state.externalMCPs[mcpIndex].config;
+    try {
+        let methods = [];
+        let resourceCount;
+        let hasApp;
+        let appResourceUri;
+        let appResourceUris;
+        if (mcpConfig.url) {
+            const sdkClient = await connectHTTPClient(mcpConfig.url, name);
+            state.externalMCPSDKClients.set(name, sdkClient);
+            const toolsResult = await sdkClient.listTools();
+            methods = toolsToMethods(toolsResult.tools || []);
+            try {
+                const resourcesResult = await sdkClient.listResources();
+                const resources = resourcesResult.resources || [];
+                const allUiResources = resources.filter((r) => r.uri?.startsWith('ui://') || r.mimeType === 'application/vnd.mcp.ui+html');
+                resourceCount = resources.length - allUiResources.length;
+                const toolLinkedUris = new Set(methods.map((m) => m.linkedUi).filter(Boolean));
+                const standaloneResources = allUiResources.filter((r) => !toolLinkedUris.has(r.uri));
+                if (standaloneResources.length > 0) {
+                    hasApp = true;
+                    appResourceUri = standaloneResources[0].uri;
+                    appResourceUris = standaloneResources.map((r) => r.uri);
+                }
+            }
+            catch {
+                // Resources not supported
+            }
+        }
+        else {
+            // Stdio / wrapper transport
+            const stdioConfig = { mcpServers: { [name]: mcpConfig } };
+            const factory = new SDKMCPClientFactory(stdioConfig, false);
+            const client = factory.create(name);
+            const tools = (await withTimeout(client.list(), 10000, 'Connection timeout (10s)'));
+            methods = (tools || []).map((tool) => ({
+                name: tool.name,
+                description: tool.description || '',
+                params: tool.inputSchema || { type: 'object', properties: {} },
+                returns: { type: 'object' },
+                icon: tool['x-icon'],
+            }));
+            state.externalMCPClients.set(name, client);
+        }
+        // Re-find after awaits — externalMCPs may have been modified during connection
+        const currentIndex = state.externalMCPs.findIndex((m) => m.name === name);
+        if (currentIndex === -1) {
+            return { success: false, error: `External MCP '${name}' was removed during reconnection` };
+        }
+        const mcp = state.externalMCPs[currentIndex];
+        mcp.connected = true;
+        mcp.methods = methods;
+        mcp.errorMessage = undefined;
+        if (resourceCount !== undefined)
+            mcp.resourceCount = resourceCount;
+        if (hasApp !== undefined) {
+            mcp.hasApp = hasApp;
+            mcp.appResourceUri = appResourceUri;
+            mcp.appResourceUris = appResourceUris;
+        }
+        logger.info(`🔌 Reconnected to external MCP: ${name} (${methods.length} tools)`);
+        return { success: true };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        const failedMcp = state.externalMCPs.find((m) => m.name === name);
+        if (failedMcp)
+            failedMcp.errorMessage = errorMsg.slice(0, 200);
+        logger.warn(`⚠️ Failed to reconnect to external MCP: ${name} - ${errorMsg}`);
+        return { success: false, error: errorMsg };
+    }
+}
+//# sourceMappingURL=external-mcp.js.map

package/dist/auto-ui/beam/external-mcp.js.map

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

package/dist/auto-ui/beam/photon-management.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Photon management operations — configure, reload, remove, update metadata, generate docs.
+ *
+ * Extracted from beam.ts. All functions take explicit parameters
+ * rather than relying on closure-captured state.
+ */
+import { SchemaExtractor } from '@portel/photon-core';
+import { PhotonLoader } from '../../loader.js';
+import type { AnyPhotonInfo, PhotonInfo, MethodInfo, ConfigParam } from '../types.js';
+import type { PhotonConfig } from './types.js';
+declare function generatePhotonId(photonPath: string): string;
+/** Build MethodInfo[] from extracted schemas + templates + source */
+declare function buildMethodList(schemas: any[], templates: any[], source: string, uiAssets: any[]): MethodInfo[];
+/** Extract constructor params as ConfigParam[] */
+declare function extractConfigParams(extractor: SchemaExtractor, source: string, photonName: string): ConfigParam[];
+/**
+ * Configure a photon via MCP — apply env vars, save config, reload.
+ */
+export declare function configurePhotonViaMCP(photonName: string, config: Record<string, any>, photons: AnyPhotonInfo[], photonMCPs: Map<string, any>, loader: PhotonLoader, savedConfig: PhotonConfig, workingDir: string, activeLoads?: Set<string>): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Reload a photon via MCP — re-read source, rebuild methods, update in-place.
+ */
+export declare function reloadPhotonViaMCP(photonName: string, photons: AnyPhotonInfo[], photonMCPs: Map<string, any>, loader: PhotonLoader, savedConfig: PhotonConfig, broadcastChange: () => void, activeLoads?: Set<string>): Promise<{
+    success: boolean;
+    photon?: PhotonInfo;
+    error?: string;
+}>;
+/**
+ * Remove a photon — delete from arrays/maps, clear saved config.
+ */
+export declare function removePhotonViaMCP(photonName: string, photons: AnyPhotonInfo[], photonMCPs: Map<string, any>, savedConfig: PhotonConfig, broadcastChange: () => void, workingDir: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Update photon or method metadata in-place.
+ */
+export declare function updateMetadataViaMCP(photonName: string, methodName: string | null, metadata: Record<string, any>, photons: AnyPhotonInfo[]): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Generate rich help markdown for a photon.
+ * Checks for an existing .md file first; generates and saves one if missing.
+ */
+export declare function generatePhotonHelpMarkdown(photonName: string, photons: AnyPhotonInfo[]): Promise<string>;
+export { buildMethodList, extractConfigParams, generatePhotonId };
+//# sourceMappingURL=photon-management.d.ts.map

package/dist/auto-ui/beam/photon-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photon-management.d.ts","sourceRoot":"","sources":["../../../src/auto-ui/beam/photon-management.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,eAAe,EAAyB,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAY/C,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,iBAAS,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,qEAAqE;AACrE,iBAAS,eAAe,CACtB,OAAO,EAAE,GAAG,EAAE,EACd,SAAS,EAAE,GAAG,EAAE,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,GAAG,EAAE,GACd,UAAU,EAAE,CAqCd;AAED,kDAAkD;AAClD,iBAAS,mBAAmB,CAC1B,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,WAAW,EAAE,CAgBf;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,OAAO,EAAE,aAAa,EAAE,EACxB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,YAAY,EACzB,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACxB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiF/C;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,EAAE,EACxB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,YAAY,EACzB,eAAe,EAAE,MAAM,IAAI,EAC3B,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACxB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA8EpE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,EAAE,EACxB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,WAAW,EAAE,YAAY,EACzB,eAAe,EAAE,MAAM,IAAI,EAC3B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkB/C;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,OAAO,EAAE,aAAa,EAAE,GACvB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgC/C;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,EAAE,GACvB,OAAO,CAAC,MAAM,CAAC,CAyCjB;AAGD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,CAAC"}