@portel/photon 1.22.1 → 1.23.0

package/dist/ag-ui/adapter.js

@@ -15,6 +15,7 @@
 import { randomUUID } from 'crypto';
 import { AGUIEventType } from './types.js';
 import { getRequestContext } from '../telemetry/context.js';
+import { resultToA2UIMessages, looksLikeA2UIStream } from '../a2ui/mapper.js';
 /**
  * Wrap an AG-UI event as a JSON-RPC 2.0 notification.
  *
@@ -158,22 +159,7 @@ export async function proxyExternalAgent(agentUrl, input, broadcast) {
         }));
     }
 }
-// ════════════════════════════════════════════════════════════════════════════════
-// AG-UI OUTPUT HANDLER (wraps photon execution)
-// ════════════════════════════════════════════════════════════════════════════════
-/**
- * Create an output handler that translates Photon yield values to AG-UI events.
- *
- * Mapping:
- * - Stream chunks (strings)  → TEXT_MESSAGE_START/CONTENT/END
- * - Progress yields          → STEP_STARTED/STEP_FINISHED
- * - Emit yields (custom)     → CUSTOM event
- * - Channel events (patches) → STATE_DELTA
- *
- * Returns { outputHandler, finish, error } — call finish() after successful
- * execution or error() on failure to emit the terminal event.
- */
-export function createAGUIOutputHandler(photonName, toolName, runId, broadcast) {
+export function createAGUIOutputHandler(photonName, toolName, runId, broadcast, options = {}) {
     const threadId = `${photonName}/${toolName}`;
     const messageId = randomUUID();
     let textStreamStarted = false;
@@ -311,6 +297,37 @@ export function createAGUIOutputHandler(photonName, toolName, runId, broadcast)
                 timestamp: ts,
             }));
         }
+        // A2UI: map the result to v0.9 messages and emit each as a CUSTOM event.
+        // Consumers reassemble the JSONL stream. Emitted before STATE_SNAPSHOT so
+        // non-A2UI clients still see the raw data snapshot.
+        //
+        // Methods are allowed to return a pre-serialized A2UI stream (an array
+        // of message objects); forward it verbatim so AG-UI matches the CLI's
+        // behavior. Remapping pre-built streams would corrupt custom surfaces.
+        if (options.outputFormat === 'a2ui') {
+            try {
+                const messages = Array.isArray(result) && looksLikeA2UIStream(result)
+                    ? result
+                    : resultToA2UIMessages(result);
+                for (const message of messages) {
+                    broadcast(wrapNotification({
+                        type: AGUIEventType.CUSTOM,
+                        name: 'a2ui.message',
+                        value: message,
+                        timestamp: ts,
+                    }));
+                }
+            }
+            catch (err) {
+                // Don't kill the run on mapping failure — surface it and carry on.
+                broadcast(wrapNotification({
+                    type: AGUIEventType.CUSTOM,
+                    name: 'a2ui.error',
+                    value: { message: err instanceof Error ? err.message : String(err) },
+                    timestamp: ts,
+                }));
+            }
+        }
         // If result is an object, emit as state snapshot
         if (result && typeof result === 'object') {
             broadcast(wrapNotification({

package/dist/ag-ui/adapter.js.map

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

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

@@ -0,0 +1,18 @@
+/**
+ * Daemon API route handlers for Beam.
+ *
+ * Thin HTTP wrapper around the daemon client RPCs — gives the Beam UI a
+ * parallel surface to the `photon ps` CLI for observing and controlling
+ * scheduled work.
+ *
+ * Endpoints:
+ *   GET  /api/daemon/ps                     – full snapshot (active/declared/webhooks/sessions)
+ *   POST /api/daemon/schedules/enable       – body: { photon, method }
+ *   POST /api/daemon/schedules/disable      – body: { photon, method }
+ *   POST /api/daemon/schedules/pause        – body: { photon, method }
+ *   POST /api/daemon/schedules/resume       – body: { photon, method }
+ *   GET  /api/daemon/history?photon=&method=&limit=&sinceTs=
+ */
+import type { RouteHandler } from '../types.js';
+export declare const handleDaemonRoutes: RouteHandler;
+//# sourceMappingURL=api-daemon.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-daemon.d.ts","sourceRoot":"","sources":["../../../../src/auto-ui/beam/routes/api-daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA2BhD,eAAO,MAAM,kBAAkB,EAAE,YA2EhC,CAAC"}

package/dist/auto-ui/beam/routes/api-daemon.js

@@ -0,0 +1,118 @@
+/**
+ * Daemon API route handlers for Beam.
+ *
+ * Thin HTTP wrapper around the daemon client RPCs — gives the Beam UI a
+ * parallel surface to the `photon ps` CLI for observing and controlling
+ * scheduled work.
+ *
+ * Endpoints:
+ *   GET  /api/daemon/ps                     – full snapshot (active/declared/webhooks/sessions)
+ *   POST /api/daemon/schedules/enable       – body: { photon, method }
+ *   POST /api/daemon/schedules/disable      – body: { photon, method }
+ *   POST /api/daemon/schedules/pause        – body: { photon, method }
+ *   POST /api/daemon/schedules/resume       – body: { photon, method }
+ *   GET  /api/daemon/history?photon=&method=&limit=&sinceTs=
+ */
+import { readBody } from '../../../shared/security.js';
+import { getErrorMessage } from '../../../shared/error-handler.js';
+function writeJson(res, status, body) {
+    res.writeHead(status, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify(body));
+}
+async function readAction(req) {
+    const raw = await readBody(req);
+    let parsed;
+    try {
+        parsed = raw ? JSON.parse(raw) : {};
+    }
+    catch {
+        return { error: 'Invalid JSON body' };
+    }
+    const body = parsed;
+    if (typeof body.photon !== 'string' || !body.photon.trim()) {
+        return { error: 'Missing or invalid "photon"' };
+    }
+    if (typeof body.method !== 'string' || !body.method.trim()) {
+        return { error: 'Missing or invalid "method"' };
+    }
+    return { photon: body.photon, method: body.method };
+}
+export const handleDaemonRoutes = async (req, res, url) => {
+    if (!url.pathname.startsWith('/api/daemon'))
+        return false;
+    // Mutation endpoints require the CSRF-ish header used elsewhere in Beam.
+    if (req.method === 'POST' || req.method === 'PUT' || req.method === 'DELETE') {
+        const photonHeader = req.headers['x-photon-request'];
+        if (!photonHeader) {
+            writeJson(res, 403, { error: 'Missing X-Photon-Request header' });
+            return true;
+        }
+    }
+    if (url.pathname === '/api/daemon/ps' && (req.method === 'GET' || !req.method)) {
+        try {
+            const { fetchPsSnapshot } = await import('../../../daemon/client.js');
+            const snap = await fetchPsSnapshot();
+            writeJson(res, 200, snap);
+        }
+        catch (err) {
+            writeJson(res, 500, { error: getErrorMessage(err) });
+        }
+        return true;
+    }
+    if (url.pathname === '/api/daemon/history' && (req.method === 'GET' || !req.method)) {
+        const photon = url.searchParams.get('photon') ?? '';
+        const method = url.searchParams.get('method') ?? '';
+        if (!photon || !method) {
+            writeJson(res, 400, { error: 'Missing required query params "photon" and "method"' });
+            return true;
+        }
+        const limitRaw = url.searchParams.get('limit');
+        const sinceRaw = url.searchParams.get('sinceTs');
+        const limit = limitRaw ? Math.max(1, parseInt(limitRaw, 10) || 20) : undefined;
+        const sinceTs = sinceRaw ? parseInt(sinceRaw, 10) || undefined : undefined;
+        try {
+            const { fetchExecutionHistory } = await import('../../../daemon/client.js');
+            const resp = await fetchExecutionHistory(photon, method, { limit, sinceTs });
+            writeJson(res, 200, resp);
+        }
+        catch (err) {
+            writeJson(res, 500, { error: getErrorMessage(err) });
+        }
+        return true;
+    }
+    if (url.pathname.startsWith('/api/daemon/schedules/') && (req.method === 'POST' || !req.method)) {
+        const action = url.pathname.slice('/api/daemon/schedules/'.length);
+        if (!['enable', 'disable', 'pause', 'resume'].includes(action)) {
+            writeJson(res, 404, { error: `Unknown schedule action "${action}"` });
+            return true;
+        }
+        const parsed = await readAction(req);
+        if ('error' in parsed) {
+            writeJson(res, 400, { error: parsed.error });
+            return true;
+        }
+        try {
+            const client = await import('../../../daemon/client.js');
+            let result;
+            if (action === 'enable') {
+                result = await client.enableSchedule(parsed.photon, parsed.method);
+            }
+            else if (action === 'disable') {
+                result = await client.disableSchedule(parsed.photon, parsed.method);
+            }
+            else if (action === 'pause') {
+                result = await client.pauseSchedule(parsed.photon, parsed.method);
+            }
+            else {
+                result = await client.resumeSchedule(parsed.photon, parsed.method);
+            }
+            writeJson(res, 200, { ok: true, result });
+        }
+        catch (err) {
+            writeJson(res, 500, { error: getErrorMessage(err) });
+        }
+        return true;
+    }
+    return false;
+};
+//# sourceMappingURL=api-daemon.js.map

package/dist/auto-ui/beam/routes/api-daemon.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"beam.d.ts","sourceRoot":"","sources":["../../src/auto-ui/beam.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6KH,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AA4XjD,wBAAsB,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAikFlF;AAED;;;GAGG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAsB9C"}
+{"version":3,"file":"beam.d.ts","sourceRoot":"","sources":["../../src/auto-ui/beam.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8KH,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AA4XjD,wBAAsB,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4kFlF;AAED;;;GAGG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAsB9C"}

package/dist/auto-ui/beam.js

@@ -113,6 +113,7 @@ import { SubscriptionManager } from './beam/subscription.js';
 import { handleMarketplaceRoutes } from './beam/routes/api-marketplace.js';
 import { handleBrowseRoutes } from './beam/routes/api-browse.js';
 import { handleConfigRoutes } from './beam/routes/api-config.js';
+import { handleDaemonRoutes } from './beam/routes/api-daemon.js';
 import { loadExternalMCPs as loadExternalMCPsFromModule, reconnectExternalMCP as reconnectExternalMCPFromModule, } from './beam/external-mcp.js';
 import { configurePhotonViaMCP, reloadPhotonViaMCP, removePhotonViaMCP, updateMetadataViaMCP, generatePhotonHelpMarkdown, } from './beam/photon-management.js';
 import { generateAgentCard } from '../a2a/card-generator.js';
@@ -591,6 +592,33 @@ export async function startBeam(rawWorkingDir, port) {
             return true;
         return false;
     };
+    // Param names that almost always carry credentials. Same pattern the
+    // doctor lint uses; kept inline to avoid pulling a CLI helper into the
+    // Beam server bundle.
+    const SECRET_NAME_REGEX = /^(api[_-]?key|password|passwd|pwd|secret|token|access[_-]?token|bearer)$/i;
+    /**
+     * Convert raw extractor params into the Beam-shaped ConfigParam, with
+     * isSecret flagged by name and currentValue echoed from process.env.
+     * Secret-named env vars are masked to '***' (or null when absent) so
+     * Beam's network response never carries a credential in the clear.
+     */
+    const enrichParam = (p, photonName) => {
+        const envVar = toEnvVarName(photonName, p.name);
+        const isSecret = SECRET_NAME_REGEX.test(p.name);
+        const raw = process.env[envVar];
+        const currentValue = raw === undefined ? null : isSecret ? '***' : raw;
+        return {
+            name: p.name,
+            envVar,
+            type: p.type,
+            isOptional: p.isOptional,
+            hasDefault: p.hasDefault,
+            defaultValue: p.defaultValue,
+            isSecret,
+            currentValue,
+            ...(p.description ? { description: p.description } : {}),
+        };
+    };
     // Helper: load a single photon, returning the info to push into photons[]
     async function loadSinglePhoton(name) {
         const photonPath = bundledPhotonPaths.get(name) ||
@@ -631,16 +659,7 @@ export async function startBeam(rawWorkingDir, port) {
         try {
             if (source) {
                 const params = extractor.extractConstructorParams(source);
-                constructorParams = params
-                    .filter((p) => p.isPrimitive)
-                    .map((p) => ({
-                    name: p.name,
-                    envVar: toEnvVarName(name, p.name),
-                    type: p.type,
-                    isOptional: p.isOptional,
-                    hasDefault: p.hasDefault,
-                    defaultValue: p.defaultValue,
-                }));
+                constructorParams = params.filter((p) => p.isPrimitive).map((p) => enrichParam(p, name));
                 // Extract @ui template path from class-level JSDoc
                 const classJsdocMatch = source.match(/\/\*\*[\s\S]*?\*\/\s*(?=export\s+default\s+class)/) ||
                     source.match(/^\/\*\*([\s\S]*?)\*\//);
@@ -1221,6 +1240,8 @@ export async function startBeam(rawWorkingDir, port) {
                     return;
                 if (await handleConfigRoutes(req, res, url, beamState))
                     return;
+                if (await handleDaemonRoutes(req, res, url, beamState))
+                    return;
             }
             // Service worker for PWA support
             if (url.pathname === '/sw.js') {
@@ -2072,14 +2093,7 @@ export async function startBeam(rawWorkingDir, port) {
                             const params = extractor.extractConstructorParams(source);
                             constructorParams = 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,
-                            }));
+                                .map((p) => enrichParam(p, photonName));
                         }
                         catch {
                             // Can't extract params, try to load anyway
@@ -2212,14 +2226,7 @@ export async function startBeam(rawWorkingDir, port) {
                             const reloadParams = extractor.extractConstructorParams(reloadSource);
                             reloadConstructorParams = reloadParams
                                 .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,
-                            }));
+                                .map((p) => enrichParam(p, photonName));
                         }
                         catch {
                             // Can't extract params
@@ -2297,14 +2304,7 @@ export async function startBeam(rawWorkingDir, port) {
                                 const params = extractor.extractConstructorParams(source);
                                 constructorParams = 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,
-                                }));
+                                    .map((p) => enrichParam(p, photonName));
                             }
                             catch {
                                 // Ignore extraction errors