@portel/photon-core 2.14.0 → 2.16.0

package/README.md

@@ -131,14 +131,14 @@ if (instance.onShutdown) {
 
 ## 📚 API Reference
 
-### `PhotonMCP`
+### `Photon` (alias: `PhotonMCP`)
 
 Base class for creating Photon classes (optional - you can use plain classes too).
 
 ```typescript
-import { PhotonMCP } from '@portel/photon-core';
+import { Photon } from '@portel/photon-core';
 
-export default class MyPhoton extends PhotonMCP {
+export default class MyPhoton extends Photon {
   async myMethod(params: { input: string }) {
     return `Hello ${params.input}`;
   }
@@ -159,6 +159,21 @@ export default class MyPhoton extends PhotonMCP {
 
 **Instance methods:**
 - `executeTool(name, params)` - Execute a method by name
+- `emit(data)` - Emit events to local handler or pub/sub channel
+- `render(format, value)` - Send formatted intermediate results to the client
+- `render()` - Clear the render zone
+- `storage(subpath)` - Get path to persistent data directory
+- `assets(subpath)` - Get path to bundled assets directory
+
+**Caller identity** (requires `@auth` tag):
+- `this.caller` - Authenticated caller info (`{ id, name, anonymous, scope, claims }`)
+
+**Identity-aware locks** (for multiplayer/turn-based):
+- `acquireLock(name, callerId, timeout?)` - Assign a lock to a specific caller
+- `transferLock(name, toCallerId, fromCallerId?)` - Move lock to another caller
+- `releaseLock(name, callerId?)` - Release a lock
+- `getLock(name)` - Query who holds a lock
+- `withLock(name, fn, timeout?)` - Execute function with a binary mutex lock
 
 **Lifecycle hooks:**
 - `onInitialize()` - Called when photon is initialized
@@ -321,6 +336,8 @@ interface ExtractedSchema {
  * @param email Email address {@format email}
  * @param username Username {@pattern ^[a-z0-9_]+$}
  * @param count Count {@default 10}
+ * @param env Target environment {@choice-from environments}
+ * @param service Service to deploy {@choice-from services.name}
  */
 ```
 
@@ -370,6 +387,62 @@ export default class DeployTool extends PhotonMCP {
 
 ---
 
+### MCP OAuth & Caller Identity
+
+Photons can require authenticated callers using the `@auth` class-level tag. When enabled, `this.caller` provides the authenticated identity in every method.
+
+```typescript
+/**
+ * Chess game with authenticated players
+ * @stateful
+ * @auth required
+ */
+export default class Chess extends Photon {
+  players: Record<string, string> = {};
+
+  async join() {
+    const slot = !this.players.white ? 'white' : 'black';
+    this.players[slot] = this.caller.id;
+
+    if (slot === 'black') {
+      // Both joined — white goes first
+      await this.acquireLock('turn', this.players.white);
+    }
+    return { color: slot, playerId: this.caller.id, name: this.caller.name };
+  }
+
+  /** @locked turn */
+  async move(params: { from: string; to: string }) {
+    // Only reaches here if this.caller.id holds the 'turn' lock
+    const next = this.turn === 'white' ? this.players.black : this.players.white;
+    await this.transferLock('turn', next);
+    return this.board;
+  }
+}
+```
+
+**`@auth` tag values:**
+
+| Value | Behavior |
+|-------|----------|
+| `@auth required` | All methods require a valid JWT. Anonymous callers get 401. |
+| `@auth optional` | Caller populated if token present, anonymous allowed. |
+| `@auth https://accounts.google.com` | Specifies the OIDC provider URL (implies required). |
+
+**`this.caller` properties:**
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `id` | `string` | Stable user ID (JWT `sub` claim) |
+| `name` | `string?` | Display name from OIDC profile |
+| `anonymous` | `boolean` | `true` if no valid JWT was provided |
+| `scope` | `string?` | OAuth scopes |
+| `claims` | `Record<string, unknown>?` | Raw JWT claims |
+
+The MCP transport handles the OAuth 2.1 flow per the [MCP authorization spec](https://modelcontextprotocol.io/specification/latest/basic/authorization). The photon author never deals with tokens or OAuth directly.
+
+---
+
 ### Stateful Workflows (Checkpoint Pattern)
 
 For long-running workflows that need to survive interruptions, use checkpoint yields:
@@ -508,6 +581,119 @@ sub.unsubscribe();
 
 See [CHANNELS.md](./CHANNELS.md) for full architecture documentation.
 
+**Channel auto-prefixing:** When emitting with a `channel` property, the channel name is automatically prefixed with the photon name unless it already contains a colon:
+
+```typescript
+// In a photon named "whatsapp":
+this.emit({ channel: 'messages', event: 'new', data: msg });
+// → publishes to 'whatsapp:messages'
+
+// Explicit namespace (colon present = no auto-prefix)
+this.emit({ channel: 'board:updates', event: 'moved', data });
+// → publishes to 'board:updates' as-is
+```
+
+---
+
+### Intermediate Rendering (`this.render()`)
+
+Send formatted intermediate results to the client during method execution. Each call replaces the previous render in the result panel. Uses the same rendering pipeline as `@format` return values.
+
+```typescript
+export default class Scanner extends Photon {
+  async scan(params: { target: string }) {
+    // Show a progress table mid-execution
+    this.render('table', [{ host: params.target, status: 'scanning...' }]);
+
+    const results = await this.runScan(params.target);
+
+    // Update with final results
+    this.render('table', results);
+
+    // Clear the render zone
+    this.render();
+
+    return results;
+  }
+}
+```
+
+**Signatures:**
+- `this.render(format: string, value: any)` — render a formatted value
+- `this.render()` — clear the render zone (emits `render:clear`)
+
+---
+
+### Dynamic Enums (`{@choice-from}`)
+
+Populate parameter enum values dynamically by calling another tool at schema resolution time:
+
+```typescript
+export default class Deploy extends Photon {
+  /** @readOnly */
+  async environments() {
+    return ['staging', 'production', 'dev'];
+  }
+
+  /**
+   * Deploy to an environment
+   * @param env Target environment {@choice-from environments}
+   * @param service Service name {@choice-from services.name}
+   */
+  async deploy(params: { env: string; service: string }) { ... }
+}
+```
+
+The `{@choice-from toolName}` tag calls the specified tool and uses the result array as enum values. Use `{@choice-from toolName.field}` to extract a specific field from each result object.
+
+---
+
+### Namespace System & Storage/Assets
+
+Every photon gets scoped filesystem APIs for persistent data and bundled assets:
+
+```typescript
+export default class WhatsApp extends Photon {
+  async onInitialize() {
+    // Persistent data directory (follows symlink path)
+    const authDir = this.storage('auth');
+    // → ~/.photon/portel-dev/whatsapp/auth/
+
+    // Bundled assets directory (follows realpath to source)
+    const templates = this.assets('templates');
+    // → /real/path/to/whatsapp/assets/templates/
+  }
+}
+```
+
+Cross-namespace photon resolution uses `namespace:name` syntax:
+```typescript
+const wa = await this.photon.use('portel-dev:whatsapp', 'work');
+```
+
+---
+
+### Shared UI Assets (`linkedTools`)
+
+Multiple methods can reference the same `@ui` template. The first method becomes the primary link (used for app detection via `main()`), while all methods are tracked in `linkedTools[]`:
+
+```typescript
+export default class Dashboard extends Photon {
+  /** @ui dashboard ./ui/dashboard.html */
+  async main() { return this.status(); }
+
+  /** @ui dashboard */
+  async status() { return { uptime: process.uptime() }; }
+
+  /** @ui dashboard */
+  async metrics() { return { requests: 1234 }; }
+}
+```
+
+The `UIAsset` type tracks both:
+- `linkedTool` — first method (used for app detection)
+- `linkedTools[]` — all methods sharing this template
+
 ---
 
 ### Managed Collections

package/dist/asset-discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asset-discovery.d.ts","sourceRoot":"","sources":["../src/asset-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAc/C;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CA8DnC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CAiEf"}
+{"version":3,"file":"asset-discovery.d.ts","sourceRoot":"","sources":["../src/asset-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAc/C;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CA8DnC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CAqFf"}

package/dist/asset-discovery.js

@@ -92,12 +92,33 @@ export async function discoverAssets(photonPath, source) {
  */
 export async function autoDiscoverAssets(assetFolder, assets) {
     // Auto-discover UI files
+    // .photon.html files (declarative mode) take priority over .html files with the same base name.
     const uiDir = path.join(assetFolder, 'ui');
     if (await fileExists(uiDir)) {
         try {
             const files = await fs.readdir(uiDir);
+            // Collect .photon.html files first so they take priority
+            const photonHtmlFiles = new Set();
             for (const file of files) {
-                const id = path.basename(file, path.extname(file));
+                if (file.endsWith('.photon.html')) {
+                    photonHtmlFiles.add(file.replace(/\.photon\.html$/, ''));
+                }
+            }
+            for (const file of files) {
+                // Determine the asset ID:
+                // - foo.photon.html → id "foo"
+                // - foo.html → id "foo" (but skipped if foo.photon.html exists)
+                let id;
+                if (file.endsWith('.photon.html')) {
+                    id = file.replace(/\.photon\.html$/, '');
+                }
+                else {
+                    id = path.basename(file, path.extname(file));
+                    // Skip .html files when a .photon.html with the same base name exists
+                    if (file.endsWith('.html') && photonHtmlFiles.has(id)) {
+                        continue;
+                    }
+                }
                 if (!assets.ui.find((u) => u.id === id)) {
                     assets.ui.push({
                         id,

package/dist/asset-discovery.js.map

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

package/dist/base.d.ts

@@ -39,6 +39,7 @@
  * ```
  */
 import { MCPClient, MCPClientFactory } from '@portel/mcp';
+import { type CallerInfo } from '@portel/cli';
 import { MemoryProvider } from './memory.js';
 import { ScheduleProvider } from './schedule.js';
 /**
@@ -55,6 +56,18 @@ export declare class Photon {
      * @internal
      */
     _photonName?: string;
+    /**
+     * Absolute path to the .photon.ts/.photon.js source file - set by runtime loader
+     * Used for storage() and assets() path resolution
+     * @internal
+     */
+    _photonFilePath?: string;
+    /**
+     * Dynamic photon resolver - injected by runtime loader
+     * Used by this.photon.use() for runtime photon access
+     * @internal
+     */
+    _photonResolver?: (name: string, instance?: string) => Promise<any>;
     /**
      * Scoped memory provider - lazy-initialized on first access
      * @internal
@@ -70,6 +83,24 @@ export declare class Photon {
      * @internal
      */
     _sessionId?: string;
+    /**
+     * Authenticated caller identity
+     *
+     * Populated from MCP OAuth when `@auth` is enabled on the photon.
+     * Returns the identity of whoever is calling the current method —
+     * human (via social login) or agent (via API key).
+     *
+     * Returns an anonymous caller if no auth token was provided.
+     *
+     * @example
+     * ```typescript
+     * // In a method:
+     * const userId = this.caller.id;     // stable user ID from JWT
+     * const name = this.caller.name;     // display name
+     * const isAnon = this.caller.anonymous; // true if no auth
+     * ```
+     */
+    get caller(): CallerInfo;
     /**
      * Scoped key-value storage for photon data
      *
@@ -125,6 +156,66 @@ export declare class Photon {
      * ```
      */
     get schedule(): ScheduleProvider;
+    /**
+     * Get an absolute path to a storage directory for this photon's data.
+     *
+     * Uses the symlink/installed path (not resolved) so data stays at the
+     * installed location. Directories are auto-created.
+     *
+     * @param subpath Sub-directory within the photon's data folder (e.g., 'auth', 'media')
+     * @returns Absolute path to the directory
+     *
+     * @example
+     * ```typescript
+     * const authDir = this.storage('auth');
+     * // ~/.photon/portel-dev/whatsapp/auth/
+     *
+     * const mediaDir = this.storage('media/images');
+     * // ~/.photon/portel-dev/whatsapp/media/images/
+     * ```
+     */
+    protected storage(subpath: string): string;
+    /**
+     * Get an absolute path to an assets directory for this photon.
+     *
+     * Uses realpathSync to follow symlinks — assets travel with source code,
+     * not the installed location. Useful for marketplace-distributed resources
+     * like HTML templates, images, etc.
+     *
+     * @param subpath Sub-path within the assets folder (e.g., 'templates', 'icons/logo.png')
+     * @returns Absolute path to the asset file or directory
+     *
+     * @example
+     * ```typescript
+     * const templateDir = this.assets('templates');
+     * // /real/path/to/portel-dev/whatsapp/assets/templates/
+     *
+     * const logo = this.assets('icons/logo.png');
+     * // /real/path/to/portel-dev/whatsapp/assets/icons/logo.png
+     * ```
+     */
+    protected assets(subpath: string): string;
+    /**
+     * Dynamic photon access
+     *
+     * Provides runtime access to other photons by name, with optional instance selection.
+     * Supports both short names and namespace-qualified names.
+     *
+     * @example
+     * ```typescript
+     * // Get default instance
+     * const wa = await this.photon.use('whatsapp');
+     *
+     * // Get named instance
+     * const personal = await this.photon.use('whatsapp', 'personal');
+     *
+     * // Cross-namespace access
+     * const wa2 = await this.photon.use('portel-dev:whatsapp', 'work');
+     * ```
+     */
+    get photon(): {
+        use: (name: string, instance?: string) => Promise<any>;
+    };
     /**
      * Emit an event/progress update
      *
@@ -147,6 +238,35 @@ export declare class Photon {
      * ```
      */
     protected emit(data: any): void;
+    /**
+     * Render a formatted value as an intermediate result
+     *
+     * Sends a value to the client (Beam, CLI, MCP) rendered with the specified
+     * format — the same formats available via `@format` docblock tags. Each call
+     * replaces the previous render in the result panel.
+     *
+     * For custom formats, place an HTML renderer at `assets/formats/<name>.html`.
+     *
+     * @param format The format type (table, qr, chart:bar, dashboard, or custom)
+     * @param value The data to render — same shape as a return value with that @format
+     *
+     * @example
+     * ```typescript
+     * // Show a QR code mid-execution
+     * this.render('qr', { value: 'https://wa.link/...' });
+     *
+     * // Show a status table
+     * this.render('table', [['Step', 'Status'], ['Auth', 'Done']]);
+     *
+     * // Composite dashboard
+     * this.render('dashboard', {
+     *   qr: { format: 'qr', data: 'https://wa.link/...' },
+     *   status: { format: 'text', data: 'Scan the QR code above' }
+     * });
+     * ```
+     */
+    protected render(format: string, value: any): void;
+    protected render(): void;
     /**
      * Cross-photon call handler - injected by runtime
      * @internal
@@ -288,5 +408,83 @@ export declare class Photon {
      * ```
      */
     protected withLock<T>(lockName: string, fn: () => Promise<T>, timeout?: number): Promise<T>;
+    /**
+     * Identity-aware lock handler - injected by runtime
+     * @internal
+     */
+    _lockHandler?: {
+        assign(lockName: string, holder: string, timeout?: number): Promise<boolean>;
+        transfer(lockName: string, fromHolder: string, toHolder: string, timeout?: number): Promise<boolean>;
+        release(lockName: string, holder: string): Promise<boolean>;
+        query(lockName: string): Promise<{
+            holder: string | null;
+            acquiredAt?: number;
+            expiresAt?: number;
+        }>;
+    };
+    /**
+     * Assign a lock to a specific caller (identity-aware)
+     *
+     * Unlike `withLock` which auto-acquires/releases around a function,
+     * this explicitly assigns a lock to a caller ID. The lock persists
+     * until transferred or released.
+     *
+     * @param lockName Name of the lock
+     * @param callerId Caller ID to assign the lock to
+     * @param timeout Lock timeout in ms (default 30000, auto-extended on transfer)
+     *
+     * @example
+     * ```typescript
+     * // Assign "turn" lock to first player
+     * await this.acquireLock('turn', this.caller.id);
+     * ```
+     */
+    protected acquireLock(lockName: string, callerId: string, timeout?: number): Promise<boolean>;
+    /**
+     * Transfer a lock from the current holder to another caller
+     *
+     * Only succeeds if `fromCallerId` is the current holder.
+     *
+     * @param lockName Name of the lock
+     * @param toCallerId Caller ID to transfer the lock to
+     * @param fromCallerId Current holder (defaults to this.caller.id)
+     *
+     * @example
+     * ```typescript
+     * // After a chess move, transfer turn to opponent
+     * await this.transferLock('turn', opponentId);
+     * ```
+     */
+    protected transferLock(lockName: string, toCallerId: string, fromCallerId?: string): Promise<boolean>;
+    /**
+     * Release a lock (make the method open to anyone)
+     *
+     * @param lockName Name of the lock
+     * @param callerId Holder to release from (defaults to this.caller.id)
+     *
+     * @example
+     * ```typescript
+     * // Presenter releases navigation control to audience
+     * await this.releaseLock('navigation');
+     * ```
+     */
+    protected releaseLock(lockName: string, callerId?: string): Promise<boolean>;
+    /**
+     * Query who holds a specific lock
+     *
+     * @param lockName Name of the lock
+     * @returns Lock holder info, or null holder if unlocked
+     *
+     * @example
+     * ```typescript
+     * const lock = await this.getLock('turn');
+     * if (lock.holder === this.caller.id) { ... }
+     * ```
+     */
+    protected getLock(lockName: string): Promise<{
+        holder: string | null;
+        acquiredAt?: number;
+        expiresAt?: number;
+    }>;
 }
 //# 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":"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"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"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"}