@portel/photon-core 2.1.2 → 2.3.0

package/README.md

@@ -449,6 +449,67 @@ const resumed = await maybeStatefulExecute(
 
 ---
 
+### Channel-Based Pub/Sub
+
+Photon Core provides a pluggable channel broker architecture for cross-process messaging. This enables real-time updates between MCP processes, Beam UI, and other services.
+
+```typescript
+import { PhotonMCP } from '@portel/photon-core';
+
+export default class KanbanBoard extends PhotonMCP {
+  async moveTask(params: { taskId: string; column: string }) {
+    const task = await this.updateTask(params);
+
+    // Emit to local output handler (current caller)
+    this.emit({ emit: 'board-update', board: 'default' });
+
+    // Also publish to channel for cross-process subscribers
+    this.emit({
+      channel: 'kanban:default',  // Format: photonName:subChannel
+      event: 'task-moved',
+      data: { task }
+    });
+
+    return task;
+  }
+}
+```
+
+**Broker Types:**
+
+| Broker | Use Case | Configuration |
+|--------|----------|---------------|
+| `daemon` | Local dev, single-server | Default (uses Unix sockets) |
+| `redis` | Multi-server, production | `PHOTON_REDIS_URL` |
+| `http` | Webhook integrations | `PHOTON_CHANNEL_HTTP_URL` |
+| `noop` | Testing, disabled | `PHOTON_CHANNEL_BROKER=noop` |
+
+**Subscribing to channels:**
+
+```typescript
+import { getBroker } from '@portel/photon-core';
+
+const broker = getBroker();
+
+// Subscribe
+const sub = await broker.subscribe('kanban:default', (message) => {
+  console.log('Received:', message.event, message.data);
+});
+
+// Later: unsubscribe
+sub.unsubscribe();
+```
+
+**Environment Variables:**
+- `PHOTON_CHANNEL_BROKER` - Explicit broker type (`daemon`, `redis`, `http`, `noop`)
+- `PHOTON_NAME` - Photon name for daemon socket path
+- `PHOTON_REDIS_URL` - Redis connection URL (auto-enables redis broker)
+- `PHOTON_CHANNEL_HTTP_URL` - HTTP webhook URL (auto-enables http broker)
+
+See [CHANNELS.md](./CHANNELS.md) for full architecture documentation.
+
+---
+
 ## 🏗️ Building Custom Runtimes
 
 Photon Core is designed to be the foundation for custom runtimes. Here are examples:

package/dist/base.d.ts

@@ -49,7 +49,24 @@ import { MCPClient, MCPClientFactory } from '@portel/mcp';
 export declare class PhotonMCP {
     /**
      * Emit an event/progress update
-     * @param data Data to emit
+     *
+     * If data includes a `channel` property, the message is also published
+     * to the channel broker for cross-process notification.
+     *
+     * @param data Data to emit (can include channel, event, data properties for pub/sub)
+     *
+     * @example
+     * ```typescript
+     * // Simple emit (local only)
+     * this.emit({ status: 'processing', progress: 50 });
+     *
+     * // Emit with channel (broadcasts to subscribers)
+     * this.emit({
+     *   channel: 'board:my-board',
+     *   event: 'task-moved',
+     *   data: { taskId: '123', newColumn: 'Done' }
+     * });
+     * ```
      */
     protected emit(data: any): void;
     /**
@@ -69,7 +86,7 @@ export declare class PhotonMCP {
     static getMCPName(): string;
     /**
      * Get all tool methods from this class
-     * Returns all public async methods except lifecycle hooks
+     * Returns all public async methods except lifecycle hooks and configuration methods
      */
     static getToolMethods(): string[];
     /**
@@ -128,5 +145,28 @@ export declare class PhotonMCP {
      * Requires MCP factory to be set
      */
     listMCPServers(): Promise<string[]>;
+    /**
+     * Execute a function with a distributed lock
+     *
+     * Acquires the lock before executing, releases after (even on error).
+     * If the lock cannot be acquired, throws an error.
+     *
+     * @param lockName Name of the lock to acquire
+     * @param fn Function to execute while holding the lock
+     * @param timeout Optional lock timeout in ms (default 30000)
+     *
+     * @example
+     * ```typescript
+     * async moveTask(params: { taskId: string; column: string }) {
+     *   return this.withLock('board:write', async () => {
+     *     const task = await this.loadTask(params.taskId);
+     *     task.column = params.column;
+     *     await this.saveTask(task);
+     *     return task;
+     *   });
+     * }
+     * ```
+     */
+    protected withLock<T>(lockName: string, fn: () => Promise<T>, timeout?: number): Promise<T>;
 }
 //# sourceMappingURL=base.d.ts.map

package/dist/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAkB,MAAM,aAAa,CAAC;AAG1E;;;;;;GAMG;AACH,qBAAa,SAAS;IACpB;;;OAGG;IACH,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAM/B;;;OAGG;IACH,SAAS,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAEzC;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAsF;IAEzG;;;OAGG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM;IAQ3B;;;OAGG;IACH,MAAM,CAAC,cAAc,IAAI,MAAM,EAAE;IA0BjC;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAkBrH;;OAEG;IACG,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAC9B,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAoBhF;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAM9C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAM1C"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAkB,MAAM,aAAa,CAAC;AAK1E;;;;;;GAMG;AACH,qBAAa,SAAS;IACpB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IA0B/B;;;OAGG;IACH,SAAS,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAEzC;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAsF;IAEzG;;;OAGG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM;IAQ3B;;;OAGG;IACH,MAAM,CAAC,cAAc,IAAI,MAAM,EAAE;IAiCjC;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAkBrH;;OAEG;IACG,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAC9B,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAoBhF;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAM9C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAOzC;;;;;;;;;;;;;;;;;;;;;OAqBG;cACa,QAAQ,CAAC,CAAC,EACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,CAAC,CAAC;CAGd"}

package/dist/base.js

@@ -40,6 +40,8 @@
  */
 import { createMCPProxy } from '@portel/mcp';
 import { executionContext } from '@portel/cli';
+import { getBroker } from './channels/index.js';
+import { withLock as withLockHelper } from './decorators.js';
 /**
  * Simple base class for creating Photon MCPs
  *
@@ -50,13 +52,48 @@ import { executionContext } from '@portel/cli';
 export class PhotonMCP {
     /**
      * Emit an event/progress update
-     * @param data Data to emit
+     *
+     * If data includes a `channel` property, the message is also published
+     * to the channel broker for cross-process notification.
+     *
+     * @param data Data to emit (can include channel, event, data properties for pub/sub)
+     *
+     * @example
+     * ```typescript
+     * // Simple emit (local only)
+     * this.emit({ status: 'processing', progress: 50 });
+     *
+     * // Emit with channel (broadcasts to subscribers)
+     * this.emit({
+     *   channel: 'board:my-board',
+     *   event: 'task-moved',
+     *   data: { taskId: '123', newColumn: 'Done' }
+     * });
+     * ```
      */
     emit(data) {
         const store = executionContext.getStore();
+        // Send to local output handler (current caller)
         if (store?.outputHandler) {
             store.outputHandler(data);
         }
+        // If channel is specified, also publish to broker for cross-process notification
+        if (data && typeof data.channel === 'string') {
+            const broker = getBroker();
+            broker.publish({
+                channel: data.channel,
+                event: data.event || 'message',
+                data: data.data !== undefined ? data.data : data,
+                timestamp: Date.now(),
+                source: this.constructor.name,
+            }).catch((err) => {
+                // Silent fail - channel pub is best-effort
+                // Log only in debug mode
+                if (process.env.PHOTON_DEBUG) {
+                    console.error('Channel publish error:', err);
+                }
+            });
+        }
     }
     /**
      * MCP client factory - injected by runtime
@@ -81,20 +118,26 @@ export class PhotonMCP {
     }
     /**
      * Get all tool methods from this class
-     * Returns all public async methods except lifecycle hooks
+     * Returns all public async methods except lifecycle hooks and configuration methods
      */
     static getToolMethods() {
         const prototype = this.prototype;
         const methods = [];
+        // Methods that are conventions, not tools
+        const conventionMethods = new Set([
+            'constructor',
+            'onInitialize', // Lifecycle hook
+            'onShutdown', // Lifecycle hook
+            'configure', // Configuration convention
+            'getConfig', // Configuration convention
+        ]);
         // Get all property names from prototype chain
         let current = prototype;
         while (current && current !== PhotonMCP.prototype) {
             Object.getOwnPropertyNames(current).forEach((name) => {
-                // Skip constructor, private methods (starting with _), and lifecycle hooks
-                if (name !== 'constructor' &&
-                    !name.startsWith('_') &&
-                    name !== 'onInitialize' &&
-                    name !== 'onShutdown' &&
+                // Skip private methods (starting with _) and convention methods
+                if (!name.startsWith('_') &&
+                    !conventionMethods.has(name) &&
                     typeof prototype[name] === 'function' &&
                     !methods.includes(name)) {
                     methods.push(name);
@@ -193,5 +236,30 @@ export class PhotonMCP {
         }
         return this._mcpFactory.listServers();
     }
+    /**
+     * Execute a function with a distributed lock
+     *
+     * Acquires the lock before executing, releases after (even on error).
+     * If the lock cannot be acquired, throws an error.
+     *
+     * @param lockName Name of the lock to acquire
+     * @param fn Function to execute while holding the lock
+     * @param timeout Optional lock timeout in ms (default 30000)
+     *
+     * @example
+     * ```typescript
+     * async moveTask(params: { taskId: string; column: string }) {
+     *   return this.withLock('board:write', async () => {
+     *     const task = await this.loadTask(params.taskId);
+     *     task.column = params.column;
+     *     await this.saveTask(task);
+     *     return task;
+     *   });
+     * }
+     * ```
+     */
+    async withLock(lockName, fn, timeout) {
+        return withLockHelper(lockName, fn, timeout);
+    }
 }
 //# sourceMappingURL=base.js.map

package/dist/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EAA+B,cAAc,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,OAAO,SAAS;IACpB;;;;;;;;;;;;;;;;;;;;OAoBG;IACO,IAAI,CAAC,IAAS;QACtB,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,EAAE,CAAC;QAE1C,gDAAgD;QAChD,IAAI,KAAK,EAAE,aAAa,EAAE,CAAC;YACzB,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAED,iFAAiF;QACjF,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC7C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,OAAO,CAAC;gBACb,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,SAAS;gBAC9B,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;gBAChD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;aAC9B,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACf,2CAA2C;gBAC3C,yBAAyB;gBACzB,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;oBAC7B,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC;gBAC/C,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD;;;OAGG;IACO,WAAW,CAAoB;IAEzC;;;OAGG;IACK,WAAW,GAA4E,IAAI,GAAG,EAAE,CAAC;IAEzG;;;OAGG;IACH,MAAM,CAAC,UAAU;QACf,OAAO,IAAI,CAAC,IAAI;aACb,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,iCAAiC;aACrD,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC;aAC1B,WAAW,EAAE;aACb,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,sBAAsB;IAC9C,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,cAAc;QACnB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QACjC,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,0CAA0C;QAC1C,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;YAChC,aAAa;YACb,cAAc,EAAG,iBAAiB;YAClC,YAAY,EAAK,iBAAiB;YAClC,WAAW,EAAM,2BAA2B;YAC5C,WAAW,EAAM,2BAA2B;SAC7C,CAAC,CAAC;QAEH,8CAA8C;QAC9C,IAAI,OAAO,GAAG,SAAS,CAAC;QACxB,OAAO,OAAO,IAAI,OAAO,KAAK,SAAS,CAAC,SAAS,EAAE,CAAC;YAClD,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;gBACnD,gEAAgE;gBAChE,IACE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;oBACrB,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC;oBAC5B,OAAQ,SAAiB,CAAC,IAAI,CAAC,KAAK,UAAU;oBAC9C,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EACvB,CAAC;oBACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC,CAAC,CAAC;YACH,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,UAAe,EAAE,OAAiD;QACpG,MAAM,MAAM,GAAI,IAAY,CAAC,QAAQ,CAAC,CAAC;QAEvC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,gBAAgB,CAAC,GAAG,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,KAAK,IAAI,EAAE;YAChF,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBACnD,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,OAAO,CAAC,KAAK,CAAC,0BAA0B,QAAQ,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBACvE,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAQD;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,GAAG,CAAC,OAAe;QACjB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,8CAA8C,OAAO,2GAA2G,CACjK,CAAC;QACJ,CAAC;QAED,oCAAoC;QACpC,IAAI,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,iCAAiC;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;QACnC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACtC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,OAAyB;QACrC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;QAC3B,4CAA4C;QAC5C,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc;QAClB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;IACxC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACO,KAAK,CAAC,QAAQ,CACtB,QAAgB,EAChB,EAAoB,EACpB,OAAgB;QAEhB,OAAO,cAAc,CAAC,QAAQ,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/channels/daemon-broker.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Daemon Channel Broker
+ *
+ * Uses Unix sockets (or named pipes on Windows) to communicate with
+ * the local photon daemon for pub/sub messaging.
+ *
+ * Best for:
+ * - Local development
+ * - Single-server deployments
+ * - Scenarios where BEAM and MCP share the same filesystem
+ */
+import type { ChannelBroker, ChannelMessage, ChannelHandler, Subscription } from './types.js';
+export interface DaemonBrokerOptions {
+    /** Photon name (for socket path) */
+    photonName?: string;
+    /** Custom socket directory */
+    socketDir?: string;
+    /** Connection timeout in ms */
+    timeout?: number;
+}
+export declare class DaemonBroker implements ChannelBroker {
+    readonly type = "daemon";
+    private photonName;
+    private socketDir?;
+    private timeout;
+    private subscriptions;
+    constructor(options?: DaemonBrokerOptions);
+    publish(message: ChannelMessage): Promise<void>;
+    subscribe(channel: string, handler: ChannelHandler): Promise<Subscription>;
+    isConnected(): boolean;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+}
+export default DaemonBroker;
+//# sourceMappingURL=daemon-broker.d.ts.map

package/dist/channels/daemon-broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-broker.d.ts","sourceRoot":"","sources":["../../src/channels/daemon-broker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG9F,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAaD,qBAAa,YAAa,YAAW,aAAa;IAChD,QAAQ,CAAC,IAAI,YAAY;IAEzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAA4E;gBAErF,OAAO,GAAE,mBAAwB;IAMvC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAmE/C,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IA+HhF,WAAW,IAAI,OAAO;IAKhB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CASlC;AAKD,eAAe,YAAY,CAAC"}

package/dist/channels/daemon-broker.js

@@ -0,0 +1,229 @@
+/**
+ * Daemon Channel Broker
+ *
+ * Uses Unix sockets (or named pipes on Windows) to communicate with
+ * the local photon daemon for pub/sub messaging.
+ *
+ * Best for:
+ * - Local development
+ * - Single-server deployments
+ * - Scenarios where BEAM and MCP share the same filesystem
+ */
+import * as net from 'net';
+import * as path from 'path';
+import * as os from 'os';
+import * as fs from 'fs';
+import { registerBroker } from './registry.js';
+/**
+ * Get the socket path for a photon daemon
+ */
+function getSocketPath(photonName, socketDir) {
+    const dir = socketDir || path.join(os.homedir(), '.photon', 'daemons');
+    if (process.platform === 'win32') {
+        return `\\\\.\\pipe\\photon-${photonName}`;
+    }
+    return path.join(dir, `${photonName}.sock`);
+}
+export class DaemonBroker {
+    type = 'daemon';
+    photonName;
+    socketDir;
+    timeout;
+    subscriptions = new Map();
+    constructor(options = {}) {
+        this.photonName = options.photonName || process.env.PHOTON_NAME || 'unknown';
+        this.socketDir = options.socketDir;
+        this.timeout = options.timeout || 5000;
+    }
+    async publish(message) {
+        // Determine photon name: use configured name, or extract from channel format "photonName:subChannel"
+        let targetPhoton = this.photonName;
+        if (targetPhoton === 'unknown' && message.channel?.includes(':')) {
+            // Extract photon name from channel (e.g., "kanban:default" -> "kanban")
+            const colonIndex = message.channel.indexOf(':');
+            targetPhoton = message.channel.slice(0, colonIndex);
+        }
+        const socketPath = getSocketPath(targetPhoton, this.socketDir);
+        // Check if socket exists
+        if (process.platform !== 'win32' && !fs.existsSync(socketPath)) {
+            // Daemon not running, silently ignore
+            return;
+        }
+        return new Promise((resolve, reject) => {
+            const client = net.createConnection(socketPath);
+            const requestId = `pub_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+            const timeout = setTimeout(() => {
+                client.destroy();
+                // Don't reject on timeout - publish is best-effort
+                resolve();
+            }, this.timeout);
+            client.on('connect', () => {
+                const request = {
+                    type: 'publish',
+                    id: requestId,
+                    channel: message.channel,
+                    message: {
+                        ...message,
+                        timestamp: message.timestamp || Date.now(),
+                        source: message.source || this.photonName,
+                    },
+                };
+                client.write(JSON.stringify(request) + '\n');
+            });
+            client.on('data', (chunk) => {
+                try {
+                    const response = JSON.parse(chunk.toString().trim());
+                    if (response.id === requestId) {
+                        clearTimeout(timeout);
+                        client.destroy();
+                        resolve();
+                    }
+                }
+                catch {
+                    // Ignore parse errors
+                }
+            });
+            client.on('error', () => {
+                clearTimeout(timeout);
+                client.destroy();
+                // Don't reject - publish is best-effort
+                resolve();
+            });
+            client.on('end', () => {
+                clearTimeout(timeout);
+            });
+        });
+    }
+    async subscribe(channel, handler) {
+        const socketPath = getSocketPath(this.photonName, this.socketDir);
+        const subscribeId = `sub_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+        return new Promise((resolve, reject) => {
+            const client = net.createConnection(socketPath);
+            let subscribed = false;
+            let buffer = '';
+            const timeout = setTimeout(() => {
+                if (!subscribed) {
+                    client.destroy();
+                    reject(new Error('Subscription timeout'));
+                }
+            }, this.timeout);
+            client.on('connect', () => {
+                const request = {
+                    type: 'subscribe',
+                    id: subscribeId,
+                    channel,
+                    clientType: 'photon',
+                };
+                client.write(JSON.stringify(request) + '\n');
+            });
+            client.on('data', (chunk) => {
+                buffer += chunk.toString();
+                // Process complete JSON messages (newline-delimited)
+                const lines = buffer.split('\n');
+                buffer = lines.pop() || '';
+                for (const line of lines) {
+                    if (!line.trim())
+                        continue;
+                    try {
+                        const response = JSON.parse(line);
+                        // Handle subscription confirmation
+                        if (response.id === subscribeId && response.type === 'result') {
+                            clearTimeout(timeout);
+                            subscribed = true;
+                            // Track subscription
+                            if (!this.subscriptions.has(channel)) {
+                                this.subscriptions.set(channel, { socket: client, handlers: new Set() });
+                            }
+                            this.subscriptions.get(channel).handlers.add(handler);
+                            // Return subscription handle
+                            const subscription = {
+                                channel,
+                                active: true,
+                                unsubscribe: () => {
+                                    subscription.active = false;
+                                    const sub = this.subscriptions.get(channel);
+                                    if (sub) {
+                                        sub.handlers.delete(handler);
+                                        if (sub.handlers.size === 0) {
+                                            // Send unsubscribe and close
+                                            const unsubRequest = {
+                                                type: 'unsubscribe',
+                                                id: `unsub_${Date.now()}`,
+                                                channel,
+                                            };
+                                            if (!client.destroyed) {
+                                                client.write(JSON.stringify(unsubRequest) + '\n');
+                                                client.end();
+                                            }
+                                            this.subscriptions.delete(channel);
+                                        }
+                                    }
+                                },
+                            };
+                            resolve(subscription);
+                        }
+                        // Handle channel messages
+                        if (response.type === 'channel_message' && response.channel === channel) {
+                            const msg = {
+                                channel: response.channel,
+                                event: response.message?.event || 'message',
+                                data: response.message?.data || response.message,
+                                timestamp: response.message?.timestamp || Date.now(),
+                                source: response.message?.source,
+                            };
+                            handler(msg);
+                        }
+                        // Handle errors
+                        if (response.type === 'error' && response.id === subscribeId) {
+                            clearTimeout(timeout);
+                            reject(new Error(response.error || 'Subscription failed'));
+                        }
+                    }
+                    catch {
+                        // Ignore parse errors for partial messages
+                    }
+                }
+            });
+            client.on('error', (error) => {
+                if (!subscribed) {
+                    clearTimeout(timeout);
+                    reject(new Error(`Connection error: ${error.message}`));
+                }
+            });
+            client.on('end', () => {
+                if (!subscribed) {
+                    clearTimeout(timeout);
+                    reject(new Error('Connection closed before subscription confirmed'));
+                }
+            });
+            client.on('close', () => {
+                // Mark all subscriptions on this socket as inactive
+                for (const [ch, sub] of this.subscriptions) {
+                    if (sub.socket === client) {
+                        this.subscriptions.delete(ch);
+                    }
+                }
+            });
+        });
+    }
+    isConnected() {
+        // Check if any subscriptions are active
+        return this.subscriptions.size > 0;
+    }
+    async connect() {
+        // Connection happens lazily on first publish/subscribe
+    }
+    async disconnect() {
+        // Close all subscription sockets
+        for (const [, sub] of this.subscriptions) {
+            if (!sub.socket.destroyed) {
+                sub.socket.end();
+            }
+        }
+        this.subscriptions.clear();
+    }
+}
+// Register the broker
+registerBroker('daemon', (options) => new DaemonBroker(options));
+export default DaemonBroker;
+//# sourceMappingURL=daemon-broker.js.map

package/dist/channels/daemon-broker.js.map

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

package/dist/channels/http-broker.d.ts

@@ -0,0 +1,45 @@
+/**
+ * HTTP Channel Broker
+ *
+ * Uses HTTP webhooks for publishing and Server-Sent Events (SSE) for subscribing.
+ * Works with any HTTP-based pub/sub system.
+ *
+ * Best for:
+ * - Serverless environments (AWS Lambda, Vercel, etc.)
+ * - Cloud functions that can't maintain long-lived connections
+ * - Integration with existing webhook infrastructure
+ *
+ * Publishing: POST to publishUrl with JSON body
+ * Subscribing: SSE connection to subscribeUrl
+ */
+import type { ChannelBroker, ChannelMessage, ChannelHandler, Subscription } from './types.js';
+export interface HttpBrokerOptions {
+    /** URL for publishing messages (POST requests) */
+    publishUrl?: string;
+    /** URL for SSE subscriptions */
+    subscribeUrl?: string;
+    /** Authentication token (sent as Bearer token) */
+    authToken?: string;
+    /** Custom headers for requests */
+    headers?: Record<string, string>;
+    /** Request timeout in ms */
+    timeout?: number;
+}
+export declare class HttpBroker implements ChannelBroker {
+    readonly type = "http";
+    private publishUrl?;
+    private subscribeUrl?;
+    private authToken?;
+    private headers;
+    private timeout;
+    private subscriptions;
+    constructor(options?: HttpBrokerOptions);
+    private getHeaders;
+    publish(message: ChannelMessage): Promise<void>;
+    subscribe(channel: string, handler: ChannelHandler): Promise<Subscription>;
+    isConnected(): boolean;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+}
+export default HttpBroker;
+//# sourceMappingURL=http-broker.d.ts.map

package/dist/channels/http-broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-broker.d.ts","sourceRoot":"","sources":["../../src/channels/http-broker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG9F,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,UAAW,YAAW,aAAa;IAC9C,QAAQ,CAAC,IAAI,UAAU;IAEvB,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAqF;gBAE9F,OAAO,GAAE,iBAAsB;IAQ3C,OAAO,CAAC,UAAU;IAaZ,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B/C,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IA4GhF,WAAW,IAAI,OAAO;IAIhB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAOlC;AAKD,eAAe,UAAU,CAAC"}