@portel/photon 1.9.0 → 1.10.0

package/dist/auto-ui/beam/photon-management.js

@@ -0,0 +1,310 @@
+/**
+ * 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 * as fs from 'fs/promises';
+import * as path from 'path';
+import { createHash } from 'crypto';
+import { SchemaExtractor } from '@portel/photon-core';
+import { PhotonDocExtractor } from '../../photon-doc-extractor.js';
+import { TemplateManager } from '../../template-manager.js';
+import { toEnvVarName } from '../../shared/config-docs.js';
+import { logger } from '../../shared/logger.js';
+import { broadcastNotification, broadcastToBeam } from '../streamable-http-transport.js';
+import { applyMethodVisibility, extractClassMetadataFromSource, backfillEnvDefaults, } from './class-metadata.js';
+import { saveConfig } from './config.js';
+function generatePhotonId(photonPath) {
+    return createHash('sha256').update(photonPath).digest('hex').slice(0, 12);
+}
+/** Build MethodInfo[] from extracted schemas + templates + source */
+function buildMethodList(schemas, templates, source, uiAssets) {
+    const lifecycleMethods = ['onInitialize', 'onShutdown', 'constructor'];
+    const methods = schemas
+        .filter((schema) => !lifecycleMethods.includes(schema.name))
+        .map((schema) => {
+        const linkedAsset = uiAssets.find((ui) => ui.linkedTool === schema.name);
+        return {
+            name: schema.name,
+            description: schema.description || '',
+            params: schema.inputSchema || { type: 'object', properties: {}, required: [] },
+            returns: { type: 'object' },
+            autorun: schema.autorun || false,
+            outputFormat: schema.outputFormat,
+            layoutHints: schema.layoutHints,
+            buttonLabel: schema.buttonLabel,
+            icon: schema.icon,
+            linkedUi: linkedAsset?.id,
+            scheduled: schema.scheduled,
+        };
+    });
+    templates.forEach((template) => {
+        if (!lifecycleMethods.includes(template.name)) {
+            methods.push({
+                name: template.name,
+                description: template.description || '',
+                params: template.inputSchema || { type: 'object', properties: {}, required: [] },
+                returns: { type: 'object' },
+                isTemplate: true,
+                outputFormat: 'markdown',
+            });
+        }
+    });
+    applyMethodVisibility(source, methods);
+    return methods;
+}
+/** Extract constructor params as ConfigParam[] */
+function extractConfigParams(extractor, source, photonName) {
+    try {
+        const params = extractor.extractConstructorParams(source);
+        return params
+            .filter((p) => p.isPrimitive)
+            .map((p) => ({
+            name: p.name,
+            envVar: toEnvVarName(photonName, p.name),
+            type: p.type,
+            isOptional: p.isOptional,
+            hasDefault: p.hasDefault,
+            defaultValue: p.defaultValue,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Configure a photon via MCP — apply env vars, save config, reload.
+ */
+export async function configurePhotonViaMCP(photonName, config, photons, photonMCPs, loader, savedConfig, workingDir, activeLoads) {
+    const photonIndex = photons.findIndex((p) => p.name === photonName);
+    if (photonIndex === -1) {
+        return { success: false, error: `Photon not found: ${photonName}` };
+    }
+    if (activeLoads?.has(photonName)) {
+        return {
+            success: false,
+            error: `${photonName} is currently being reloaded — try again shortly`,
+        };
+    }
+    activeLoads?.add(photonName);
+    for (const [key, value] of Object.entries(config)) {
+        process.env[key] = String(value);
+    }
+    savedConfig.photons[photonName] = { ...(savedConfig.photons[photonName] || {}), ...config };
+    await saveConfig(savedConfig, workingDir);
+    const targetPhoton = photons[photonIndex];
+    const isReconfigure = targetPhoton.configured === true;
+    try {
+        const mcp = isReconfigure
+            ? await loader.reloadFile(targetPhoton.path)
+            : await loader.loadFile(targetPhoton.path);
+        const instance = mcp.instance;
+        if (!instance) {
+            throw new Error('Failed to create instance');
+        }
+        photonMCPs.set(photonName, mcp);
+        backfillEnvDefaults(instance, targetPhoton.requiredParams || []);
+        const extractor = new SchemaExtractor();
+        const configSource = await fs.readFile(targetPhoton.path, 'utf-8');
+        const { tools: schemas, templates } = extractor.extractAllFromSource(configSource);
+        mcp.schemas = schemas;
+        const uiAssets = mcp.assets?.ui || [];
+        const methods = buildMethodList(schemas, templates, configSource, uiAssets);
+        const mainMethod = methods.find((m) => m.name === 'main' && m.linkedUi);
+        const configuredPhoton = {
+            id: generatePhotonId(targetPhoton.path),
+            name: photonName,
+            path: targetPhoton.path,
+            configured: true,
+            methods,
+            isApp: !!mainMethod,
+            appEntry: mainMethod,
+            assets: mcp.assets,
+            ...(mcp.injectedPhotons &&
+                mcp.injectedPhotons.length > 0 && { injectedPhotons: mcp.injectedPhotons }),
+        };
+        // Re-find index — array may have shifted during the async work above
+        const currentIndex = photons.findIndex((p) => p.name === photonName);
+        if (currentIndex === -1) {
+            activeLoads?.delete(photonName);
+            return { success: false, error: `${photonName} was removed during configuration` };
+        }
+        photons[currentIndex] = configuredPhoton;
+        activeLoads?.delete(photonName);
+        logger.info(`✅ ${photonName} configured via MCP`);
+        broadcastNotification('notifications/tools/list_changed', {});
+        broadcastToBeam('beam/configured', { photon: configuredPhoton });
+        return { success: true };
+    }
+    catch (error) {
+        activeLoads?.delete(photonName);
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        logger.error(`Failed to configure ${photonName} via MCP: ${errorMsg}`);
+        return { success: false, error: errorMsg };
+    }
+}
+/**
+ * Reload a photon via MCP — re-read source, rebuild methods, update in-place.
+ */
+export async function reloadPhotonViaMCP(photonName, photons, photonMCPs, loader, savedConfig, broadcastChange, activeLoads) {
+    const photonIndex = photons.findIndex((p) => p.name === photonName);
+    if (photonIndex === -1) {
+        return { success: false, error: `Photon not found: ${photonName}` };
+    }
+    if (activeLoads?.has(photonName)) {
+        return {
+            success: false,
+            error: `${photonName} is currently being reloaded — try again shortly`,
+        };
+    }
+    activeLoads?.add(photonName);
+    const photon = photons[photonIndex];
+    const photonPath = photon.path;
+    const config = savedConfig.photons[photonName] || {};
+    for (const [key, value] of Object.entries(config)) {
+        process.env[key] = value;
+    }
+    try {
+        const mcp = await loader.reloadFile(photonPath);
+        const instance = mcp.instance;
+        if (!instance) {
+            throw new Error('Failed to create instance');
+        }
+        photonMCPs.set(photonName, mcp);
+        backfillEnvDefaults(instance, photon.requiredParams || []);
+        const extractor = new SchemaExtractor();
+        const reloadSrc = await fs.readFile(photonPath, 'utf-8');
+        const { tools: schemas, templates } = extractor.extractAllFromSource(reloadSrc);
+        mcp.schemas = schemas;
+        const uiAssets = mcp.assets?.ui || [];
+        const methods = buildMethodList(schemas, templates, reloadSrc, uiAssets);
+        const mainMethod = methods.find((m) => m.name === 'main' && m.linkedUi);
+        const reloadClassMeta = extractClassMetadataFromSource(reloadSrc);
+        const reloadedPhoton = {
+            id: generatePhotonId(photonPath),
+            name: photonName,
+            path: photonPath,
+            configured: true,
+            methods,
+            isApp: !!mainMethod,
+            appEntry: mainMethod,
+            description: reloadClassMeta.description,
+            icon: reloadClassMeta.icon,
+            internal: reloadClassMeta.internal,
+            ...(mcp.injectedPhotons &&
+                mcp.injectedPhotons.length > 0 && { injectedPhotons: mcp.injectedPhotons }),
+        };
+        // Re-find index — array may have shifted during the async work above
+        const currentIndex = photons.findIndex((p) => p.name === photonName);
+        if (currentIndex === -1) {
+            activeLoads?.delete(photonName);
+            return { success: false, error: `${photonName} was removed during reload` };
+        }
+        photons[currentIndex] = reloadedPhoton;
+        activeLoads?.delete(photonName);
+        logger.info(`🔄 ${photonName} reloaded via MCP`);
+        broadcastChange();
+        return { success: true, photon: reloadedPhoton };
+    }
+    catch (error) {
+        activeLoads?.delete(photonName);
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        logger.error(`Failed to reload ${photonName} via MCP: ${errorMsg}`);
+        return { success: false, error: errorMsg };
+    }
+}
+/**
+ * Remove a photon — delete from arrays/maps, clear saved config.
+ */
+export async function removePhotonViaMCP(photonName, photons, photonMCPs, savedConfig, broadcastChange, workingDir) {
+    const photonIndex = photons.findIndex((p) => p.name === photonName);
+    if (photonIndex === -1) {
+        return { success: false, error: `Photon not found: ${photonName}` };
+    }
+    photons.splice(photonIndex, 1);
+    photonMCPs.delete(photonName);
+    if (savedConfig.photons[photonName]) {
+        delete savedConfig.photons[photonName];
+        await saveConfig(savedConfig, workingDir);
+    }
+    logger.info(`🗑️ ${photonName} removed via MCP`);
+    broadcastChange();
+    return { success: true };
+}
+/**
+ * Update photon or method metadata in-place.
+ */
+export async function updateMetadataViaMCP(photonName, methodName, metadata, photons) {
+    const photonIndex = photons.findIndex((p) => p.name === photonName);
+    if (photonIndex === -1) {
+        return { success: false, error: `Photon not found: ${photonName}` };
+    }
+    if (methodName) {
+        if (!photons[photonIndex].configured || !photons[photonIndex].methods) {
+            return { success: false, error: 'Photon is not configured or has no methods' };
+        }
+        const method = photons[photonIndex].methods.find((m) => m.name === methodName);
+        if (!method) {
+            return { success: false, error: `Method not found: ${methodName}` };
+        }
+        if (metadata.description !== undefined)
+            method.description = metadata.description;
+        if (metadata.icon !== undefined)
+            method.icon = metadata.icon;
+        logger.info(`📝 Updated metadata for ${photonName}/${methodName}`);
+    }
+    else {
+        if (metadata.description !== undefined) {
+            photons[photonIndex].description = metadata.description;
+        }
+        if (metadata.icon !== undefined) {
+            photons[photonIndex].icon = metadata.icon;
+        }
+        logger.info(`📝 Updated metadata for ${photonName}`);
+    }
+    return { success: true };
+}
+/**
+ * Generate rich help markdown for a photon.
+ * Checks for an existing .md file first; generates and saves one if missing.
+ */
+export async function generatePhotonHelpMarkdown(photonName, photons) {
+    const photon = photons.find((p) => p.name === photonName);
+    if (!photon) {
+        throw new Error(`Photon not found: ${photonName}`);
+    }
+    if (!photon.path) {
+        throw new Error(`Photon path not available: ${photonName}`);
+    }
+    const sourceDir = path.dirname(photon.path);
+    const mdPath = path.join(sourceDir, `${photonName}.md`);
+    try {
+        const [mdStat, srcStat] = await Promise.all([fs.stat(mdPath), fs.stat(photon.path)]);
+        if (mdStat.mtimeMs >= srcStat.mtimeMs) {
+            const existing = await fs.readFile(mdPath, 'utf-8');
+            if (existing.trim()) {
+                return existing;
+            }
+        }
+    }
+    catch {
+        // .md doesn't exist or stat failed - regenerate
+    }
+    const extractor = new PhotonDocExtractor(photon.path);
+    const metadata = await extractor.extractFullMetadata();
+    const templateMgr = new TemplateManager(sourceDir);
+    await templateMgr.ensureTemplates();
+    const markdown = await templateMgr.renderTemplate('photon.md', metadata);
+    try {
+        await fs.writeFile(mdPath, markdown, 'utf-8');
+        logger.info(`📄 Generated help doc: ${mdPath}`);
+    }
+    catch {
+        logger.debug(`Could not save help doc to ${mdPath} (read-only?)`);
+    }
+    return markdown;
+}
+// Re-export helper for use by handleFileChange (still in beam.ts)
+export { buildMethodList, extractConfigParams, generatePhotonId };
+//# sourceMappingURL=photon-management.js.map

package/dist/auto-ui/beam/photon-management.js.map

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

package/dist/auto-ui/beam/routes/api-browse.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Browse, UI, and PWA route handlers.
+ *
+ * Extracted from beam.ts — handles:
+ *   /api/browse          – File browser API
+ *   /api/local-file      – Serve local files (images in markdown, etc.)
+ *   /api/photon-workdir  – Resolve photon working directory
+ *   /api/ui              – Serve UI templates for custom UI rendering
+ *   /api/mcp-app         – Serve MCP App HTML from external MCPs
+ *   /api/template        – Serve @ui template files (class-level custom UI)
+ *   /api/pwa/manifest.json – Auto-generated PWA manifest
+ *   /api/pwa/icon.svg    – Auto-generated SVG icon from photon emoji
+ *   /api/pwa/app         – PWA app entry with bridge injection
+ */
+import type { RouteHandler } from '../types.js';
+export declare const handleBrowseRoutes: RouteHandler;
+//# sourceMappingURL=api-browse.d.ts.map

package/dist/auto-ui/beam/routes/api-browse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-browse.d.ts","sourceRoot":"","sources":["../../../../src/auto-ui/beam/routes/api-browse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3D,eAAO,MAAM,kBAAkB,EAAE,YAqjBhC,CAAC"}