@portel/photon 1.8.4 → 1.10.0

package/dist/auto-ui/beam/startup.js.map

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

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

@@ -0,0 +1,35 @@
+/**
+ * Subscription Management — Ref-counted channel subscriptions + event buffer replay.
+ *
+ * Manages daemon pub/sub subscriptions with reference counting so channels
+ * are subscribed only when at least one client is viewing them.
+ * Buffers recent events for delta-sync on reconnect.
+ */
+import type { AnyPhotonInfo } from '../types.js';
+export interface SubscriptionManagerDeps {
+    photons: AnyPhotonInfo[];
+    workingDir: string;
+}
+export declare class SubscriptionManager {
+    private channelSubscriptions;
+    private channelEventBuffers;
+    private sessionViewState;
+    private deps;
+    constructor(deps: SubscriptionManagerDeps);
+    /** Store an event in the channel buffer */
+    bufferEvent(channel: string, method: string, params: Record<string, unknown>): number;
+    /** Replay missed events to a session, or signal full sync needed */
+    replayEventsToSession(sessionId: string, channel: string, lastTimestamp?: number): {
+        replayed: number;
+        refreshNeeded: boolean;
+    };
+    /** Subscribe to a channel (increment ref count, actually subscribe if first) */
+    subscribeToChannel(channel: string): Promise<void>;
+    /** Unsubscribe from a channel (decrement ref count, actually unsubscribe if last) */
+    unsubscribeFromChannel(channel: string): void;
+    /** Called when a client starts viewing a board */
+    onClientViewingBoard(sessionId: string, photonId: string, itemId: string, lastTimestamp?: number): void;
+    /** Called when a client disconnects */
+    onClientDisconnect(sessionId: string): void;
+}
+//# sourceMappingURL=subscription.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../../src/auto-ui/beam/subscription.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA6BjD,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,oBAAoB,CAA0C;IACtE,OAAO,CAAC,mBAAmB,CAAoC;IAC/D,OAAO,CAAC,gBAAgB,CAA6D;IACrF,OAAO,CAAC,IAAI,CAA0B;gBAE1B,IAAI,EAAE,uBAAuB;IAIzC,2CAA2C;IAC3C,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAoBrF,oEAAoE;IACpE,qBAAqB,CACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,GACrB;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE;IAqC/C,gFAAgF;IAC1E,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDxD,qFAAqF;IACrF,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAgB7C,kDAAkD;IAClD,oBAAoB,CAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI;IAoBP,uCAAuC;IACvC,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAQ5C"}

package/dist/auto-ui/beam/subscription.js

@@ -0,0 +1,151 @@
+/**
+ * Subscription Management — Ref-counted channel subscriptions + event buffer replay.
+ *
+ * Manages daemon pub/sub subscriptions with reference counting so channels
+ * are subscribed only when at least one client is viewing them.
+ * Buffers recent events for delta-sync on reconnect.
+ */
+import { subscribeChannel, pingDaemon } from '../../daemon/client.js';
+import { broadcastToBeam, sendToSession } from '../streamable-http-transport.js';
+import { logger } from '../../shared/logger.js';
+// ══════════════════════════════════════════════════════════════════════════════
+// SUBSCRIPTION MANAGER
+// ══════════════════════════════════════════════════════════════════════════════
+/** Buffer retention window — events older than this are purged */
+const EVENT_BUFFER_DURATION_MS = 5 * 60 * 1000; // 5 minutes
+export class SubscriptionManager {
+    channelSubscriptions = new Map();
+    channelEventBuffers = new Map();
+    sessionViewState = new Map();
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** Store an event in the channel buffer */
+    bufferEvent(channel, method, params) {
+        let buffer = this.channelEventBuffers.get(channel);
+        if (!buffer) {
+            buffer = { events: [] };
+            this.channelEventBuffers.set(channel, buffer);
+        }
+        const now = Date.now();
+        const event = { id: now, method, params, timestamp: now };
+        buffer.events.push(event);
+        // Purge events older than retention window
+        const cutoff = now - EVENT_BUFFER_DURATION_MS;
+        while (buffer.events.length > 0 && buffer.events[0].timestamp < cutoff) {
+            buffer.events.shift();
+        }
+        return now;
+    }
+    /** Replay missed events to a session, or signal full sync needed */
+    replayEventsToSession(sessionId, channel, lastTimestamp) {
+        const buffer = this.channelEventBuffers.get(channel);
+        if (!buffer || buffer.events.length === 0) {
+            return { replayed: 0, refreshNeeded: false };
+        }
+        if (lastTimestamp === undefined) {
+            return { replayed: 0, refreshNeeded: false };
+        }
+        const oldestEvent = buffer.events[0];
+        // Stale: client's timestamp is older than buffer window → full sync needed
+        if (lastTimestamp < oldestEvent.timestamp) {
+            sendToSession(sessionId, 'photon/refresh-needed', { channel });
+            logger.info(`📡 Stale client on ${channel} - last seen ${new Date(lastTimestamp).toISOString()}, oldest buffered ${new Date(oldestEvent.timestamp).toISOString()}, full sync needed`);
+            return { replayed: 0, refreshNeeded: true };
+        }
+        // Delta sync: replay events after client's last timestamp
+        const eventsToReplay = buffer.events.filter((e) => e.timestamp > lastTimestamp);
+        if (eventsToReplay.length === 0) {
+            return { replayed: 0, refreshNeeded: false };
+        }
+        for (const event of eventsToReplay) {
+            sendToSession(sessionId, event.method, { ...event.params, _eventId: event.timestamp });
+        }
+        logger.info(`📡 Delta sync: ${channel} - replayed ${eventsToReplay.length} events`);
+        return { replayed: eventsToReplay.length, refreshNeeded: false };
+    }
+    /** Subscribe to a channel (increment ref count, actually subscribe if first) */
+    async subscribeToChannel(channel) {
+        const existing = this.channelSubscriptions.get(channel);
+        if (existing) {
+            existing.refCount++;
+            logger.debug(`Channel ${channel} ref count: ${existing.refCount}`);
+            return;
+        }
+        // First subscriber — actually subscribe to daemon
+        const subscription = { refCount: 1, unsubscribe: null };
+        this.channelSubscriptions.set(channel, subscription);
+        try {
+            const [photonId, itemId] = channel.split(':');
+            const photon = this.deps.photons.find((p) => p.id === photonId);
+            if (!photon) {
+                logger.warn(`Cannot subscribe to ${channel}: unknown photon ID ${photonId}`);
+                return;
+            }
+            const photonName = photon.name;
+            const daemonChannel = `${photonName}:${itemId}`;
+            const isRunning = await pingDaemon(photonName);
+            if (isRunning) {
+                const unsubscribe = await subscribeChannel(photonName, daemonChannel, (message) => {
+                    const params = {
+                        photonId,
+                        photon: photonName,
+                        channel: daemonChannel,
+                        event: message?.event,
+                        data: message?.data || message,
+                    };
+                    const eventId = this.bufferEvent(channel, 'photon/channel-event', params);
+                    broadcastToBeam('photon/channel-event', { ...params, _eventId: eventId });
+                }, { workingDir: this.deps.workingDir });
+                subscription.unsubscribe = unsubscribe;
+                logger.info(`📡 Subscribed to ${daemonChannel} (id: ${photonId}, ref: 1)`);
+            }
+        }
+        catch {
+            // Daemon not running — in-process events still work
+        }
+    }
+    /** Unsubscribe from a channel (decrement ref count, actually unsubscribe if last) */
+    unsubscribeFromChannel(channel) {
+        const subscription = this.channelSubscriptions.get(channel);
+        if (!subscription)
+            return;
+        subscription.refCount--;
+        logger.debug(`Channel ${channel} ref count: ${subscription.refCount}`);
+        if (subscription.refCount <= 0) {
+            if (subscription.unsubscribe) {
+                subscription.unsubscribe();
+                logger.info(`📡 Unsubscribed from ${channel}`);
+            }
+            this.channelSubscriptions.delete(channel);
+        }
+    }
+    /** Called when a client starts viewing a board */
+    onClientViewingBoard(sessionId, photonId, itemId, lastTimestamp) {
+        const prevState = this.sessionViewState.get(sessionId);
+        // Unsubscribe from previous item if different
+        if (prevState?.itemId && (prevState.photonId !== photonId || prevState.itemId !== itemId)) {
+            const prevChannel = `${prevState.photonId}:${prevState.itemId}`;
+            this.unsubscribeFromChannel(prevChannel);
+        }
+        // Subscribe to new item
+        const channel = `${photonId}:${itemId}`;
+        this.sessionViewState.set(sessionId, { photonId, itemId });
+        void this.subscribeToChannel(channel);
+        // Delta sync missed events if lastTimestamp is provided
+        if (lastTimestamp !== undefined) {
+            void this.replayEventsToSession(sessionId, channel, lastTimestamp);
+        }
+    }
+    /** Called when a client disconnects */
+    onClientDisconnect(sessionId) {
+        const state = this.sessionViewState.get(sessionId);
+        if (state?.photonId && state?.itemId) {
+            const channel = `${state.photonId}:${state.itemId}`;
+            this.unsubscribeFromChannel(channel);
+        }
+        this.sessionViewState.delete(sessionId);
+    }
+}
+//# sourceMappingURL=subscription.js.map

package/dist/auto-ui/beam/subscription.js.map

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

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

@@ -0,0 +1,103 @@
+/**
+ * BeamState — Shared state for Beam modules.
+ *
+ * Replaces the ~30 closure variables in startBeam() with a single
+ * typed object that route handlers and utility modules can share.
+ */
+import type { PhotonLoader } from '../../loader.js';
+import type { MarketplaceManager } from '../../marketplace-manager.js';
+import type { PhotonContext } from '../../context.js';
+import type { SimpleRateLimiter } from '../../shared/security.js';
+import type { AnyPhotonInfo, ExternalMCPInfo, MCPServerConfig } from '../types.js';
+import type { Client } from '@modelcontextprotocol/sdk/client/index.js';
+/** Unified config structure for config.json */
+export interface PhotonConfig {
+    photons: Record<string, Record<string, string>>;
+    mcpServers: Record<string, MCPServerConfig>;
+}
+/** Channel subscription with reference counting */
+export interface ChannelSubscription {
+    photonName: string;
+    channelPattern: string;
+    refCount: number;
+    unsubscribe: () => void;
+}
+/** Buffered event for replay on new subscriptions */
+export interface BufferedEvent {
+    channel: string;
+    data: unknown;
+    timestamp: number;
+}
+/** Route handler signature: returns true if it handled the request */
+export type RouteHandler = (req: import('http').IncomingMessage, res: import('http').ServerResponse, url: URL, state: BeamState) => Promise<boolean>;
+/** Callbacks that route handlers can invoke to trigger side effects */
+export interface BeamActions {
+    broadcastPhotonChange: () => void;
+    handleFileChange: (photonName: string) => Promise<void>;
+    loadSinglePhoton: (name: string) => Promise<AnyPhotonInfo | null>;
+    reconnectExternalMCP: (name: string) => Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    loadUIAsset: (photonName: string, uiId: string) => Promise<string | null>;
+    subscribeToChannel: (channel: string) => Promise<void>;
+    unsubscribeFromChannel: (channel: string) => void;
+    configurePhotonViaMCP: (photonName: string, config: Record<string, any>) => Promise<any>;
+    reloadPhotonViaMCP: (photonName: string) => Promise<any>;
+    removePhotonViaMCP: (photonName: string) => Promise<any>;
+}
+/**
+ * BeamState — mutable shared state for the Beam server.
+ *
+ * Created once in startBeam() and passed to all route handlers and utilities.
+ * This replaces the closure-captured variables scattered throughout the 4300-line function.
+ */
+export interface BeamState {
+    /** Actions (callbacks) that route handlers can invoke */
+    actions: BeamActions;
+    /** Resolved working directory */
+    workingDir: string;
+    /** PhotonContext for path resolution */
+    ctx: PhotonContext;
+    /** Photon loader instance */
+    loader: PhotonLoader;
+    /** Marketplace manager */
+    marketplace: MarketplaceManager;
+    /** In-memory mirror of config.json */
+    savedConfig: PhotonConfig;
+    /** All loaded photons (configured + unconfigured) */
+    photons: AnyPhotonInfo[];
+    /** Map of photon name → loaded MCP instance */
+    photonMCPs: Map<string, any>;
+    /** External MCP server info */
+    externalMCPs: ExternalMCPInfo[];
+    /** Active MCP transport clients for external MCPs */
+    externalMCPClients: Map<string, any>;
+    /** Direct SDK clients for resource access */
+    externalMCPSDKClients: Map<string, Client>;
+    /** Channel subscriptions (ref-counted) */
+    channelSubscriptions: Map<string, ChannelSubscription>;
+    /** Event buffer for replay */
+    channelEventBuffers: Map<string, BufferedEvent[]>;
+    /** Per-session view state (which board each session is viewing) */
+    sessionViewState: Map<string, string>;
+    /** API rate limiter */
+    apiRateLimiter: SimpleRateLimiter;
+    /** HTTP server instance */
+    server: import('http').Server | null;
+    /** File watchers */
+    watchers: import('fs').FSWatcher[];
+    /** Pending reload debounce timers */
+    pendingReloads: Map<string, NodeJS.Timeout>;
+    /** Currently loading photon names (prevents duplicate loads) */
+    activeLoads: Set<string>;
+    /** Callbacks to run after a load completes */
+    pendingAfterLoad: Map<string, Array<() => void>>;
+    /** __dirname of the beam module (for resolving static assets) */
+    beamDir: string;
+    /** Count of configured photons */
+    configuredCount: number;
+    /** Count of unconfigured photons */
+    unconfiguredCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/auto-ui/beam/types.js

@@ -0,0 +1,8 @@
+/**
+ * BeamState — Shared state for Beam modules.
+ *
+ * Replaces the ~30 closure variables in startBeam() with a single
+ * typed object that route handlers and utility modules can share.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/auto-ui/beam/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/auto-ui/beam/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

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

@@ -5,6 +5,8 @@
  * Uses MCP Streamable HTTP (POST + SSE) for real-time communication.
  * Version: 2.0.0 (SSE Architecture)
  */
+export type { PhotonConfig } from './beam/types.js';
+export type { BeamState } from './beam/types.js';
 export declare function startBeam(rawWorkingDir: string, port: number): Promise<void>;
 /**
  * Gracefully stop Beam server and clean up resources.

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;AAiyBH,wBAAsB,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAinFlF;AAiYD;;;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;AA4GH,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAuFjD,wBAAsB,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAy+ClF;AAED;;;GAGG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAmB9C"}