@portel/photon 1.11.0 → 1.12.0

package/dist/photons/tunnel.photon.js

@@ -1,9 +1,9 @@
 /**
  * Tunnel - Expose local servers to the internet
  * @description Multi-provider tunneling for remote access to Beam and local services
- * @internal
+ * @icon 🌐
  */
-import { spawn, spawnSync, execSync } from 'child_process';
+import { spawn, spawnSync } from 'child_process';
 // Track active tunnels
 const activeTunnels = new Map();
 export default class Tunnel {
@@ -12,21 +12,23 @@ export default class Tunnel {
      * @icon 🔍
      */
     async status() {
+        // Check which tunnels are still alive
+        for (const [port, tunnel] of activeTunnels) {
+            if (tunnel.process.killed || tunnel.process.exitCode !== null) {
+                tunnel.info.active = false;
+                activeTunnels.delete(port);
+            }
+        }
         const providers = [
             {
-                name: 'localtunnel',
-                available: true, // Always available via npx
-                note: 'Ready (uses npx, no install needed)',
+                name: 'cloudflared',
+                available: this._checkCommand('cloudflared'),
+                install: 'brew install cloudflared',
             },
             {
                 name: 'ngrok',
                 available: this._checkCommand('ngrok'),
-                install: 'brew install ngrok  OR  https://ngrok.com/download',
-            },
-            {
-                name: 'cloudflared',
-                available: this._checkCommand('cloudflared'),
-                install: 'brew install cloudflared  OR  https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/installation',
+                install: 'brew install ngrok',
             },
         ];
         return {
@@ -37,67 +39,62 @@ export default class Tunnel {
     /**
      * Start a tunnel to expose Beam to the internet
      * @icon 🚀
+     * @format qr
      * @param provider Tunnel provider to use
      */
-    async *start({ provider = 'localtunnel', } = {}) {
+    async *start({ provider = 'cloudflared', } = {}) {
         // Auto-detect Beam port from environment
         const port = parseInt(process.env.BEAM_PORT || '3117', 10);
         // Check if tunnel already exists for this port
-        if (activeTunnels.has(port)) {
-            const existing = activeTunnels.get(port);
-            const publicIp = await this._getPublicIp();
-            return {
-                message: `Tunnel already active on port ${port}`,
-                url: existing.info.url,
-                link: existing.info.url,
-                password: existing.info.provider === 'localtunnel' ? publicIp : undefined,
-                provider: existing.info.provider,
-                port,
-            };
+        const existing = activeTunnels.get(port);
+        if (existing) {
+            // Verify the process is still alive
+            if (!existing.process.killed && existing.process.exitCode === null) {
+                return {
+                    message: `Tunnel already running via ${existing.info.provider}`,
+                    url: existing.info.url,
+                    link: existing.info.url,
+                };
+            }
+            // Process died — clean up and start fresh
+            activeTunnels.delete(port);
         }
         yield {
             emit: 'status',
             value: { step: 'starting' },
-            message: `Starting ${provider} tunnel for Beam (port ${port})...`,
+            message: `Starting ${provider} tunnel on port ${port}...`,
         };
         try {
             let url;
-            let process;
+            let tunnelProcess;
             switch (provider) {
                 case 'ngrok':
                     if (!this._checkCommand('ngrok')) {
                         throw new Error('ngrok not installed. Run: brew install ngrok');
                     }
-                    ({ url, process } = await this._startNgrok(port));
+                    ({ url, process: tunnelProcess } = await this._startNgrok(port));
                     break;
                 case 'cloudflared':
+                default:
                     if (!this._checkCommand('cloudflared')) {
                         throw new Error('cloudflared not installed. Run: brew install cloudflared');
                     }
-                    ({ url, process } = await this._startCloudflared(port));
-                    break;
-                case 'localtunnel':
-                default:
-                    ({ url, process } = await this._startLocaltunnel(port));
+                    ({ url, process: tunnelProcess } = await this._startCloudflared(port));
                     break;
             }
-            // Fetch public IP (needed for localtunnel password)
-            const publicIp = await this._getPublicIp();
             const info = {
                 provider,
                 port,
                 url,
-                pid: process.pid,
+                pid: tunnelProcess.pid,
                 startedAt: new Date(),
+                active: true,
             };
-            activeTunnels.set(port, { process, info });
+            activeTunnels.set(port, { process: tunnelProcess, info });
             return {
-                message: `Tunnel started successfully`,
+                message: `Tunnel started via ${provider}`,
                 url,
                 link: url,
-                password: provider === 'localtunnel' ? publicIp : undefined,
-                provider,
-                port,
             };
         }
         catch (error) {
@@ -153,63 +150,6 @@ export default class Tunnel {
         const result = spawnSync(which, [cmd], { stdio: 'ignore' });
         return result.status === 0;
     }
-    async _getPublicIp() {
-        // Try multiple services in order
-        const services = ['https://api.ipify.org', 'https://ifconfig.me/ip', 'https://icanhazip.com'];
-        for (const service of services) {
-            try {
-                const result = execSync(`curl -s --max-time 3 ${service}`, {
-                    encoding: 'utf-8',
-                    timeout: 5000,
-                });
-                const ip = result.trim();
-                if (ip && /^\d+\.\d+\.\d+\.\d+$/.test(ip)) {
-                    return ip;
-                }
-            }
-            catch {
-                continue;
-            }
-        }
-        return 'unknown';
-    }
-    async _startLocaltunnel(port) {
-        return new Promise((resolve, reject) => {
-            const proc = spawn('npx', ['localtunnel', '--port', String(port)], {
-                stdio: ['ignore', 'pipe', 'pipe'],
-            });
-            let output = '';
-            const timeout = setTimeout(() => {
-                reject(new Error('Timeout waiting for localtunnel URL'));
-            }, 30000);
-            proc.stdout?.on('data', (data) => {
-                output += data.toString();
-                // localtunnel outputs: "your url is: https://xxx.loca.lt"
-                const match = output.match(/your url is: (https?:\/\/[^\s]+)/i);
-                if (match) {
-                    clearTimeout(timeout);
-                    resolve({ url: match[1], process: proc });
-                }
-            });
-            proc.stderr?.on('data', (data) => {
-                const err = data.toString();
-                if (err.includes('error')) {
-                    clearTimeout(timeout);
-                    reject(new Error(err));
-                }
-            });
-            proc.on('error', (err) => {
-                clearTimeout(timeout);
-                reject(err);
-            });
-            proc.on('close', (code) => {
-                if (code !== 0 && !output.includes('your url is')) {
-                    clearTimeout(timeout);
-                    reject(new Error(`localtunnel exited with code ${code}`));
-                }
-            });
-        });
-    }
     async _startNgrok(port) {
         return new Promise((resolve, reject) => {
             const proc = spawn('ngrok', ['http', String(port), '--log', 'stdout'], {

package/dist/photons/tunnel.photon.js.map

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

package/dist/photons/tunnel.photon.ts

@@ -1,10 +1,10 @@
 /**
  * Tunnel - Expose local servers to the internet
  * @description Multi-provider tunneling for remote access to Beam and local services
- * @internal
+ * @icon 🌐
  */
 
-import { spawn, spawnSync, execSync, ChildProcess } from 'child_process';
+import { spawn, spawnSync, ChildProcess } from 'child_process';
 
 interface TunnelInfo {
   provider: string;
@@ -12,6 +12,7 @@ interface TunnelInfo {
   url: string;
   pid: number;
   startedAt: Date;
+  active: boolean;
 }
 
 // Track active tunnels
@@ -27,26 +28,27 @@ export default class Tunnel {
       name: string;
       available: boolean;
       install?: string;
-      note?: string;
     }>;
     activeTunnels: TunnelInfo[];
   }> {
+    // Check which tunnels are still alive
+    for (const [port, tunnel] of activeTunnels) {
+      if (tunnel.process.killed || tunnel.process.exitCode !== null) {
+        tunnel.info.active = false;
+        activeTunnels.delete(port);
+      }
+    }
+
     const providers = [
       {
-        name: 'localtunnel',
-        available: true, // Always available via npx
-        note: 'Ready (uses npx, no install needed)',
+        name: 'cloudflared',
+        available: this._checkCommand('cloudflared'),
+        install: 'brew install cloudflared',
       },
       {
         name: 'ngrok',
         available: this._checkCommand('ngrok'),
-        install: 'brew install ngrok  OR  https://ngrok.com/download',
-      },
-      {
-        name: 'cloudflared',
-        available: this._checkCommand('cloudflared'),
-        install:
-          'brew install cloudflared  OR  https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/installation',
+        install: 'brew install ngrok',
       },
     ];
 
@@ -59,92 +61,82 @@ export default class Tunnel {
   /**
    * Start a tunnel to expose Beam to the internet
    * @icon 🚀
+   * @format qr
    * @param provider Tunnel provider to use
    */
   async *start({
-    provider = 'localtunnel',
+    provider = 'cloudflared',
   }: {
-    /** Provider: localtunnel, ngrok, or cloudflared */
-    provider?: 'localtunnel' | 'ngrok' | 'cloudflared';
+    /** Provider: cloudflared or ngrok */
+    provider?: 'cloudflared' | 'ngrok';
   } = {}): AsyncGenerator<
     { emit: string; value?: any; message: string },
     {
       message: string;
       url: string;
       link: string;
-      provider: string;
-      port: number;
-      password?: string;
     }
   > {
     // Auto-detect Beam port from environment
     const port = parseInt(process.env.BEAM_PORT || '3117', 10);
 
     // Check if tunnel already exists for this port
-    if (activeTunnels.has(port)) {
-      const existing = activeTunnels.get(port)!;
-      const publicIp = await this._getPublicIp();
-      return {
-        message: `Tunnel already active on port ${port}`,
-        url: existing.info.url,
-        link: existing.info.url,
-        password: existing.info.provider === 'localtunnel' ? publicIp : undefined,
-        provider: existing.info.provider,
-        port,
-      };
+    const existing = activeTunnels.get(port);
+    if (existing) {
+      // Verify the process is still alive
+      if (!existing.process.killed && existing.process.exitCode === null) {
+        return {
+          message: `Tunnel already running via ${existing.info.provider}`,
+          url: existing.info.url,
+          link: existing.info.url,
+        };
+      }
+      // Process died — clean up and start fresh
+      activeTunnels.delete(port);
     }
 
     yield {
       emit: 'status',
       value: { step: 'starting' },
-      message: `Starting ${provider} tunnel for Beam (port ${port})...`,
+      message: `Starting ${provider} tunnel on port ${port}...`,
     };
 
     try {
       let url: string;
-      let process: ChildProcess;
+      let tunnelProcess: ChildProcess;
 
       switch (provider) {
         case 'ngrok':
           if (!this._checkCommand('ngrok')) {
             throw new Error('ngrok not installed. Run: brew install ngrok');
           }
-          ({ url, process } = await this._startNgrok(port));
+          ({ url, process: tunnelProcess } = await this._startNgrok(port));
           break;
 
         case 'cloudflared':
+        default:
           if (!this._checkCommand('cloudflared')) {
             throw new Error('cloudflared not installed. Run: brew install cloudflared');
           }
-          ({ url, process } = await this._startCloudflared(port));
-          break;
-
-        case 'localtunnel':
-        default:
-          ({ url, process } = await this._startLocaltunnel(port));
+          ({ url, process: tunnelProcess } = await this._startCloudflared(port));
           break;
       }
 
-      // Fetch public IP (needed for localtunnel password)
-      const publicIp = await this._getPublicIp();
-
       const info: TunnelInfo = {
         provider,
         port,
         url,
-        pid: process.pid!,
+        pid: tunnelProcess.pid!,
         startedAt: new Date(),
+        active: true,
       };
 
-      activeTunnels.set(port, { process, info });
+      activeTunnels.set(port, { process: tunnelProcess, info });
 
       return {
-        message: `Tunnel started successfully`,
+        message: `Tunnel started via ${provider}`,
         url,
         link: url,
-        password: provider === 'localtunnel' ? publicIp : undefined,
-        provider,
-        port,
       };
     } catch (error: any) {
       throw new Error(error.message);
@@ -215,70 +207,6 @@ export default class Tunnel {
     return result.status === 0;
   }
 
-  private async _getPublicIp(): Promise<string> {
-    // Try multiple services in order
-    const services = ['https://api.ipify.org', 'https://ifconfig.me/ip', 'https://icanhazip.com'];
-
-    for (const service of services) {
-      try {
-        const result = execSync(`curl -s --max-time 3 ${service}`, {
-          encoding: 'utf-8',
-          timeout: 5000,
-        });
-        const ip = result.trim();
-        if (ip && /^\d+\.\d+\.\d+\.\d+$/.test(ip)) {
-          return ip;
-        }
-      } catch {
-        continue;
-      }
-    }
-    return 'unknown';
-  }
-
-  private async _startLocaltunnel(port: number): Promise<{ url: string; process: ChildProcess }> {
-    return new Promise((resolve, reject) => {
-      const proc = spawn('npx', ['localtunnel', '--port', String(port)], {
-        stdio: ['ignore', 'pipe', 'pipe'],
-      });
-
-      let output = '';
-      const timeout = setTimeout(() => {
-        reject(new Error('Timeout waiting for localtunnel URL'));
-      }, 30000);
-
-      proc.stdout?.on('data', (data) => {
-        output += data.toString();
-        // localtunnel outputs: "your url is: https://xxx.loca.lt"
-        const match = output.match(/your url is: (https?:\/\/[^\s]+)/i);
-        if (match) {
-          clearTimeout(timeout);
-          resolve({ url: match[1], process: proc });
-        }
-      });
-
-      proc.stderr?.on('data', (data) => {
-        const err = data.toString();
-        if (err.includes('error')) {
-          clearTimeout(timeout);
-          reject(new Error(err));
-        }
-      });
-
-      proc.on('error', (err) => {
-        clearTimeout(timeout);
-        reject(err);
-      });
-
-      proc.on('close', (code) => {
-        if (code !== 0 && !output.includes('your url is')) {
-          clearTimeout(timeout);
-          reject(new Error(`localtunnel exited with code ${code}`));
-        }
-      });
-    });
-  }
-
   private async _startNgrok(port: number): Promise<{ url: string; process: ChildProcess }> {
     return new Promise((resolve, reject) => {
       const proc = spawn('ngrok', ['http', String(port), '--log', 'stdout'], {

package/dist/server.d.ts.map

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

package/dist/server.js

@@ -464,6 +464,16 @@ export class PhotonServer {
                 description: `List all available instances.`,
                 inputSchema: { type: 'object', properties: {} },
             });
+            tools.push({
+                name: '_undo',
+                description: `Undo the last state mutation. Reverts the most recent tool call's changes.`,
+                inputSchema: { type: 'object', properties: {} },
+            });
+            tools.push({
+                name: '_redo',
+                description: `Redo the last undone mutation. Re-applies a previously undone change.`,
+                inputSchema: { type: 'object', properties: {} },
+            });
         }
         return { tools };
     }
@@ -472,8 +482,12 @@ export class PhotonServer {
             throw new Error('MCP not loaded');
         }
         const { name: toolName, arguments: args } = request.params;
-        // Route _use and _instances through daemon for stateful photons
-        if (this.daemonName && (toolName === '_use' || toolName === '_instances')) {
+        // Route _use, _instances, _undo, _redo through daemon for stateful photons
+        if (this.daemonName &&
+            (toolName === '_use' ||
+                toolName === '_instances' ||
+                toolName === '_undo' ||
+                toolName === '_redo')) {
             const { sendCommand } = await import('./daemon/client.js');
             const sendOpts = {
                 photonPath: this.options.filePath,
@@ -1290,6 +1304,10 @@ export class PhotonServer {
         if (!message || typeof message !== 'object')
             return;
         const msg = message;
+        // Debug logging for cross-client event transmission
+        if (process.env.PHOTON_DEBUG_EVENTS === '1') {
+            console.error(`[PHOTON-SERVER] Received daemon message on ${String(msg.channel)}: event=${String(msg.event)}`);
+        }
         // Use STANDARD notification with embedded photon data
         // Claude Desktop will forward this (it's a standard notification)
         // Our bridge extracts _photon and routes to the appropriate event handler
@@ -1306,9 +1324,16 @@ export class PhotonServer {
             },
         };
         try {
+            if (process.env.PHOTON_DEBUG_EVENTS === '1') {
+                console.error(`[PHOTON-SERVER] Sending notification to MCP clients...`);
+            }
             await this.server.notification(payload);
+            if (process.env.PHOTON_DEBUG_EVENTS === '1') {
+                console.error(`[PHOTON-SERVER] Notification sent successfully`);
+            }
         }
         catch (e) {
+            console.error(`[PHOTON-SERVER-ERROR] Notification send failed: ${getErrorMessage(e)}`);
             this.log('debug', 'Notification send failed', { error: getErrorMessage(e) });
         }
         // Also send to SSE sessions — snapshot to avoid live-iterator + await issues