@soederpop/luca 0.0.26 → 0.0.29

package/src/introspection/generated.agi.ts

@@ -1,7 +1,7 @@
 import { setBuildTimeData, setContainerBuildTimeData } from './index.js';
 
 // Auto-generated introspection registry data
-// Generated at: 2026-03-22T20:57:23.197Z
+// Generated at: 2026-03-24T01:41:39.242Z
 
 setBuildTimeData('features.googleDocs', {
   "id": "features.googleDocs",
@@ -1525,7 +1525,7 @@ setBuildTimeData('features.downloader', {
 
 setBuildTimeData('features.windowManager', {
   "id": "features.windowManager",
-  "description": "WindowManager Feature — Native window control via LucaVoiceLauncher Acts as an IPC server that the native macOS launcher app connects to. Communicates over a Unix domain socket using NDJSON (newline-delimited JSON). **Protocol:** - Bun listens on a Unix domain socket; the native app connects as a client - Window dispatch commands are sent as NDJSON with a `window` field - The app executes window commands and sends back `windowAck` messages - Any non-windowAck message from the app is emitted as a `message` event - Other features can use `send()` to write arbitrary NDJSON to the app **Capabilities:** - Spawn native browser windows with configurable chrome - Navigate, focus, close, and eval JavaScript in windows - Automatic socket file cleanup and fallback paths",
+  "description": "WindowManager Feature — Native window control via LucaVoiceLauncher Uses a broker/producer architecture so multiple luca processes can trigger window operations without competing for the same Unix socket. **Architecture:** - The first process to call `listen()` becomes the **broker**. It owns the app-facing socket (`ipc-window.sock`) and a control socket (`ipc-window-control.sock`). - Subsequent processes detect the broker and become **producers**. They connect to the control socket and route commands through the broker. - The broker forwards producer commands to the native app and routes acks and lifecycle events back to the originating producer. **Protocol:** - Bun listens on a Unix domain socket; the native app connects as a client - Window dispatch commands are sent as NDJSON with a `window` field - The app executes window commands and sends back `windowAck` messages - Any non-windowAck message from the app is emitted as a `message` event - Other features can use `send()` to write arbitrary NDJSON to the app **Capabilities:** - Spawn native browser windows with configurable chrome - Navigate, focus, close, and eval JavaScript in windows - Multiple luca processes can trigger window operations simultaneously - Automatic broker detection and producer fallback Observable state includes `windows` (open window metadata), `pendingOperations` (in-flight command ids), and `producerCount` (broker). Sockets, promises, and `WindowHandle` instances stay internal. **Producer state:** The broker pushes `windowStateSync` on the control socket when a producer connects and whenever the window roster changes, so every process sees the same `windows` / `windowCount` / `clientConnected` as the broker (not only its own acks).",
   "shortcut": "features.windowManager",
   "className": "WindowManager",
   "methods": {
@@ -1541,7 +1541,18 @@ setBuildTimeData('features.windowManager', {
       "returns": "Promise<this>"
     },
     "listen": {
-      "description": "Start listening on the Unix domain socket for the native app to connect. Fire-and-forget — binds the socket and returns immediately. Sits quietly until the native app connects; does nothing visible if it never does.",
+      "description": "Start the window manager. Automatically detects whether a broker already exists and either becomes the broker or connects as a producer. - If no broker is running: becomes the broker, binds the app socket and a control socket for producers. - If a broker is already running: connects as a producer through the control socket.",
+      "parameters": {
+        "socketPath": {
+          "type": "string",
+          "description": "Override the configured app socket path"
+        }
+      },
+      "required": [],
+      "returns": "Promise<this>"
+    },
+    "cleanupSocket": {
+      "description": "Remove stale socket files without starting or stopping the server. Useful when a previous process crashed and left dead sockets behind. Will not remove sockets that have live listeners.",
       "parameters": {
         "socketPath": {
           "type": "string",
@@ -1549,10 +1560,10 @@ setBuildTimeData('features.windowManager', {
         }
       },
       "required": [],
-      "returns": "this"
+      "returns": "Promise<boolean>"
     },
     "stop": {
-      "description": "Stop the IPC server and clean up all connections. Rejects any pending window operation requests.",
+      "description": "Stop the window manager and clean up all connections. Rejects any pending window operation requests.",
       "parameters": {},
       "required": [],
       "returns": "Promise<this>"
@@ -1825,7 +1836,7 @@ setBuildTimeData('features.windowManager', {
       ]
     },
     "send": {
-      "description": "Write an NDJSON message to the connected app client. Public so other features can send arbitrary protocol messages over the same socket.",
+      "description": "Write an NDJSON message to the connected app client. In producer mode, routes through the broker. Public so other features can send arbitrary protocol messages over the same socket.",
       "parameters": {
         "msg": {
           "type": "Record<string, any>",
@@ -1839,12 +1850,20 @@ setBuildTimeData('features.windowManager', {
     }
   },
   "getters": {
+    "isBroker": {
+      "description": "Whether this instance is acting as the broker.",
+      "returns": "boolean"
+    },
+    "isProducer": {
+      "description": "Whether this instance is acting as a producer.",
+      "returns": "boolean"
+    },
     "isListening": {
-      "description": "Whether the IPC server is currently listening.",
+      "description": "Whether the IPC server is currently listening (broker) or connected to broker (producer).",
       "returns": "boolean"
     },
     "isClientConnected": {
-      "description": "Whether the native app client is currently connected.",
+      "description": "Whether the native app client is currently connected (only meaningful for broker).",
       "returns": "boolean"
     }
   },
@@ -1879,6 +1898,11 @@ setBuildTimeData('features.windowManager', {
       "description": "Event emitted by WindowManager",
       "arguments": {}
     },
+    "windowFocus": {
+      "name": "windowFocus",
+      "description": "Event emitted by WindowManager",
+      "arguments": {}
+    },
     "message": {
       "name": "message",
       "description": "Event emitted by WindowManager",
@@ -5749,6 +5773,32 @@ setBuildTimeData('features.fs', {
         }
       ]
     },
+    "isSymlink": {
+      "description": "Checks if a path is a symbolic link.",
+      "parameters": {
+        "path": {
+          "type": "string",
+          "description": "The path to check"
+        }
+      },
+      "required": [
+        "path"
+      ],
+      "returns": "boolean"
+    },
+    "realpath": {
+      "description": "Resolves a symlink to its real path. Returns the resolved path as-is if not a symlink.",
+      "parameters": {
+        "path": {
+          "type": "string",
+          "description": "The path to resolve"
+        }
+      },
+      "required": [
+        "path"
+      ],
+      "returns": "string"
+    },
     "stat": {
       "description": "Synchronously returns the stat object for a file or directory.",
       "parameters": {
@@ -6223,7 +6273,7 @@ setBuildTimeData('features.fs', {
 
 setBuildTimeData('features.ipcSocket', {
   "id": "features.ipcSocket",
-  "description": "IpcSocket Feature - Inter-Process Communication via Unix Domain Sockets This feature provides robust IPC (Inter-Process Communication) capabilities using Unix domain sockets. It supports both server and client modes, allowing processes to communicate efficiently through file system-based socket connections. **Key Features:** - Dual-mode operation: server and client functionality - JSON message serialization/deserialization - Multiple client connection support (server mode) - Event-driven message handling - Automatic socket cleanup and management - Broadcast messaging to all connected clients - Lock file management for socket paths **Communication Pattern:** - Messages are automatically JSON-encoded with unique IDs - Both server and client emit 'message' events for incoming data - Server can broadcast to all connected clients - Client maintains single connection to server **Socket Management:** - Automatic cleanup of stale socket files - Connection tracking and management - Graceful shutdown procedures - Lock file protection against conflicts **Usage Examples:** **Server Mode:** ```typescript const ipc = container.feature('ipcSocket'); await ipc.listen('/tmp/myapp.sock', true); // removeLock=true ipc.on('connection', (socket) => { console.log('Client connected'); }); ipc.on('message', (data) => { console.log('Received:', data); ipc.broadcast({ reply: 'ACK', original: data }); }); ``` **Client Mode:** ```typescript const ipc = container.feature('ipcSocket'); await ipc.connect('/tmp/myapp.sock'); ipc.on('message', (data) => { console.log('Server says:', data); }); await ipc.send({ type: 'request', payload: 'hello' }); ```",
+  "description": "IpcSocket Feature - Inter-Process Communication via Unix Domain Sockets This feature provides robust IPC (Inter-Process Communication) capabilities using Unix domain sockets. It supports both server and client modes, allowing processes to communicate efficiently through file system-based socket connections. **Key Features:** - Hub-and-spoke: one server, many named clients with identity tracking - Targeted messaging: sendTo(clientId), broadcast(msg, excludeId) - Request/reply: ask() + reply() with timeout-based correlation - Auto-reconnect: clients reconnect with exponential backoff - Stale socket detection: probeSocket() before listen() - Clean shutdown: stopServer() removes socket file **Server (Hub):** ```typescript const ipc = container.feature('ipcSocket'); await ipc.listen('/tmp/hub.sock', true); ipc.on('connection', (clientId, socket) => { console.log('Client joined:', clientId); }); ipc.on('message', (data, clientId) => { console.log(`From ${clientId}:`, data); // Reply to sender, or ask and wait ipc.sendTo(clientId, { ack: true }); }); ``` **Client (Spoke):** ```typescript const ipc = container.feature('ipcSocket'); await ipc.connect('/tmp/hub.sock', { reconnect: true, name: 'worker-1' }); // Fire and forget await ipc.send({ type: 'status', ready: true }); // Request/reply ipc.on('message', (data) => { if (data.requestId) ipc.reply(data.requestId, { result: 42 }); }); ```",
   "shortcut": "features.ipcSocket",
   "className": "IpcSocket",
   "methods": {
@@ -6263,61 +6313,127 @@ setBuildTimeData('features.ipcSocket', {
       ]
     },
     "broadcast": {
-      "description": "Broadcasts a message to all connected clients (server mode only). This method sends a JSON-encoded message with a unique ID to every client currently connected to the server. Each message is automatically wrapped with metadata including a UUID for tracking. **Message Format:** Messages are automatically wrapped in the format: ```json { \"data\": <your_message>, \"id\": \"<uuid>\" } ```",
+      "description": "Broadcasts a message to all connected clients (server mode only).",
       "parameters": {
         "message": {
           "type": "any",
-          "description": "The message object to broadcast to all clients"
+          "description": "The message object to broadcast"
+        },
+        "exclude": {
+          "type": "string",
+          "description": "Optional client ID to exclude from broadcast"
         }
       },
       "required": [
         "message"
       ],
-      "returns": "void",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "// Broadcast to all connected clients\nipc.broadcast({ \n type: 'notification',\n message: 'Server is shutting down in 30 seconds',\n timestamp: Date.now()\n});\n\n// Chain multiple operations\nipc.broadcast({ status: 'ready' })\n  .broadcast({ time: new Date().toISOString() });"
+      "returns": "void"
+    },
+    "sendTo": {
+      "description": "Sends a message to a specific client by ID (server mode only).",
+      "parameters": {
+        "clientId": {
+          "type": "string",
+          "description": "The target client ID"
+        },
+        "message": {
+          "type": "any",
+          "description": "The message to send"
         }
-      ]
+      },
+      "required": [
+        "clientId",
+        "message"
+      ],
+      "returns": "boolean"
     },
     "send": {
-      "description": "Sends a message to the server (client mode only). This method sends a JSON-encoded message with a unique ID to the connected server. The message is automatically wrapped with metadata for tracking purposes. **Message Format:** Messages are automatically wrapped in the format: ```json { \"data\": <your_message>, \"id\": \"<uuid>\" } ```",
+      "description": "Fire-and-forget: sends a message to the server (client mode only). For server→client, use sendTo() or broadcast().",
       "parameters": {
         "message": {
           "type": "any",
-          "description": "The message object to send to the server"
+          "description": "The message to send"
         }
       },
       "required": [
         "message"
       ],
-      "returns": "void",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "// Send a simple message\nawait ipc.send({ type: 'ping' });\n\n// Send complex data\nawait ipc.send({\n type: 'data_update',\n payload: { users: [...], timestamp: Date.now() }\n});"
+      "returns": "void"
+    },
+    "ask": {
+      "description": "Sends a message and waits for a correlated reply. Works in both client and server mode. The recipient should call `reply(requestId, response)` to respond.",
+      "parameters": {
+        "message": {
+          "type": "any",
+          "description": "The message to send"
+        },
+        "options": {
+          "type": "{ clientId?: string; timeoutMs?: number }",
+          "description": "Optional: clientId (server mode target), timeoutMs"
         }
-      ]
+      },
+      "required": [
+        "message"
+      ],
+      "returns": "Promise<any>"
+    },
+    "reply": {
+      "description": "Sends a reply to a previous ask() call, correlated by requestId.",
+      "parameters": {
+        "requestId": {
+          "type": "string",
+          "description": "The requestId from the incoming message"
+        },
+        "data": {
+          "type": "any",
+          "description": "The reply payload"
+        },
+        "clientId": {
+          "type": "string",
+          "description": "Target client (server mode; for client mode, omit)"
+        }
+      },
+      "required": [
+        "requestId",
+        "data"
+      ],
+      "returns": "void"
     },
     "connect": {
-      "description": "Connects to an IPC server at the specified socket path (client mode). This method establishes a client connection to an existing IPC server. Once connected, the client can send messages to the server and receive responses. The connection is maintained until explicitly closed or the server terminates. **Connection Behavior:** - Sets the socket mode to 'client' - Returns existing connection if already connected - Automatically handles connection events and cleanup - JSON-parses incoming messages and emits 'message' events - Cleans up connection reference when socket closes **Error Handling:** - Throws error if already in server mode - Rejects promise on connection failures - Automatically cleans up on connection close",
+      "description": "Connects to an IPC server at the specified socket path (client mode).",
       "parameters": {
         "socketPath": {
           "type": "string",
-          "description": "The file system path to the server's Unix domain socket"
+          "description": "Path to the server's Unix domain socket"
+        },
+        "options": {
+          "type": "{ reconnect?: boolean; name?: string }",
+          "description": "Optional: reconnect (enable auto-reconnect), name (identify this client)"
         }
       },
       "required": [
         "socketPath"
       ],
-      "returns": "Promise<Socket>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "// Connect to server\nconst socket = await ipc.connect('/tmp/myapp.sock');\nconsole.log('Connected to IPC server');\n\n// Handle incoming messages\nipc.on('message', (data) => {\n console.log('Server message:', data);\n});\n\n// Send messages\nawait ipc.send({ type: 'hello', client_id: 'client_001' });"
+      "returns": "Promise<Socket>"
+    },
+    "disconnect": {
+      "description": "Disconnects the client and stops any reconnection attempts.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "probeSocket": {
+      "description": "Probe an existing socket to see if a live listener is behind it. Attempts a quick connect — if it succeeds, someone is listening.",
+      "parameters": {
+        "socketPath": {
+          "type": "string",
+          "description": "Parameter socketPath"
         }
-      ]
+      },
+      "required": [
+        "socketPath"
+      ],
+      "returns": "Promise<boolean>"
     }
   },
   "getters": {
@@ -6329,12 +6445,25 @@ setBuildTimeData('features.ipcSocket', {
       "description": "Checks if the IPC socket is operating in server mode.",
       "returns": "any"
     },
+    "clientCount": {
+      "description": "Returns the number of currently connected clients (server mode).",
+      "returns": "any"
+    },
+    "connectedClients": {
+      "description": "Returns info about all connected clients (server mode).",
+      "returns": "Array<{ id: string; name?: string; connectedAt: number }>"
+    },
     "connection": {
       "description": "Gets the current client connection socket.",
       "returns": "any"
     }
   },
   "events": {
+    "disconnection": {
+      "name": "disconnection",
+      "description": "Event emitted by IpcSocket",
+      "arguments": {}
+    },
     "connection": {
       "name": "connection",
       "description": "Event emitted by IpcSocket",
@@ -7255,10 +7384,68 @@ setBuildTimeData('features.packageFinder', {
 
 setBuildTimeData('features.processManager', {
   "id": "features.processManager",
-  "description": "Manages long-running child processes with tracking, events, and automatic cleanup. Unlike the `proc` feature whose spawn methods block until the child exits, ProcessManager returns a SpawnHandler immediately — a handle object with its own state, events, and lifecycle methods. The feature tracks all spawned processes, maintains observable state, and can automatically kill them on parent exit.",
+  "description": "Manages long-running child processes with tracking, events, and automatic cleanup. Unlike the `proc` feature whose spawn methods block until the child exits, ProcessManager returns a SpawnHandler immediately — a handle object with its own state, events, and lifecycle methods. The feature tracks all spawned processes, maintains observable state, and can automatically kill them on parent exit. Each handler maintains a memory-efficient output buffer: the first 20 lines (head) and last 50 lines (tail) of stdout/stderr are kept, everything in between is discarded.",
   "shortcut": "features.processManager",
   "className": "ProcessManager",
   "methods": {
+    "spawnProcess": {
+      "description": "Tool handler: spawn a long-running background process.",
+      "parameters": {
+        "args": {
+          "type": "{ command: string; args?: string; tag?: string; cwd?: string }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "void"
+    },
+    "runCommand": {
+      "description": "Tool handler: run a command to completion and return its output.",
+      "parameters": {
+        "args": {
+          "type": "{ command: string; cwd?: string }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "void"
+    },
+    "listProcesses": {
+      "description": "Tool handler: list all tracked processes.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "getProcessOutput": {
+      "description": "Tool handler: peek at a process's buffered output.",
+      "parameters": {
+        "args": {
+          "type": "{ id?: string; tag?: string; stream?: string }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "void"
+    },
+    "killProcess": {
+      "description": "Tool handler: kill a process by ID or tag.",
+      "parameters": {
+        "args": {
+          "type": "{ id?: string; tag?: string; signal?: string }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "void"
+    },
     "spawn": {
       "description": "Spawn a long-running process and return a handle immediately. The returned SpawnHandler provides events for stdout/stderr streaming, exit/crash notifications, and methods to kill or await the process.",
       "parameters": {
@@ -7436,7 +7623,7 @@ setBuildTimeData('features.processManager', {
   "examples": [
     {
       "language": "ts",
-      "code": "const pm = container.feature('processManager', { enable: true })\n\nconst server = pm.spawn('node', ['server.js'], { tag: 'api', cwd: '/app' })\nserver.on('stdout', (data) => console.log('[api]', data))\nserver.on('crash', (code) => console.error('API crashed:', code))\n\n// Kill one\nserver.kill()\n\n// Kill all tracked processes\npm.killAll()\n\n// List and lookup\npm.list()              // SpawnHandler[]\npm.getByTag('api')     // SpawnHandler | undefined"
+      "code": "const pm = container.feature('processManager', { enable: true })\n\nconst server = pm.spawn('node', ['server.js'], { tag: 'api', cwd: '/app' })\nserver.on('stdout', (data) => console.log('[api]', data))\nserver.on('crash', (code) => console.error('API crashed:', code))\n\n// Peek at buffered output\nconst { head, tail } = server.peek()\n\n// Kill one\nserver.kill()\n\n// Kill all tracked processes\npm.killAll()\n\n// List and lookup\npm.list()              // SpawnHandler[]\npm.getByTag('api')     // SpawnHandler | undefined"
     }
   ]
 });
@@ -9805,7 +9992,7 @@ setBuildTimeData('clients.rest', {
 
 setBuildTimeData('clients.websocket', {
   "id": "clients.websocket",
-  "description": "WebSocket client that bridges raw WebSocket events to Luca's Helper event bus, providing a clean interface for sending/receiving messages, tracking connection state, and optional auto-reconnection with exponential backoff. Events emitted: - `open` — connection established - `message` — message received (JSON-parsed when possible) - `close` — connection closed (with code and reason) - `error` — connection error - `reconnecting` — attempting reconnection (with attempt number)",
+  "description": "WebSocketClient helper",
   "shortcut": "clients.websocket",
   "className": "WebSocketClient",
   "methods": {
@@ -9828,6 +10015,59 @@ setBuildTimeData('clients.websocket', {
       ],
       "returns": "Promise<void>"
     },
+    "ask": {
+      "description": "Send a request and wait for a correlated response. The message is sent with a unique `requestId`; the remote side is expected to reply with a message containing `replyTo` set to that same ID.",
+      "parameters": {
+        "type": {
+          "type": "string",
+          "description": "A string identifying the request type"
+        },
+        "data": {
+          "type": "any",
+          "description": "Optional payload to include with the request"
+        },
+        "timeout": {
+          "type": "any",
+          "description": "How long to wait for a response (default 10 000 ms)"
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "returns": "Promise<R>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const result = await ws.ask('getUser', { id: 42 })"
+        }
+      ]
+    },
+    "_handleReply": {
+      "description": "",
+      "parameters": {
+        "message": {
+          "type": "any",
+          "description": "Parameter message"
+        }
+      },
+      "required": [
+        "message"
+      ],
+      "returns": "boolean"
+    },
+    "_rejectAllPending": {
+      "description": "",
+      "parameters": {
+        "reason": {
+          "type": "string",
+          "description": "Parameter reason"
+        }
+      },
+      "required": [
+        "reason"
+      ],
+      "returns": "void"
+    },
     "disconnect": {
       "description": "Gracefully close the WebSocket connection. Suppresses auto-reconnect and updates connection state to disconnected.",
       "parameters": {},
@@ -9870,13 +10110,7 @@ setBuildTimeData('clients.websocket', {
   },
   "state": {},
   "options": {},
-  "envVars": [],
-  "examples": [
-    {
-      "language": "ts",
-      "code": "const ws = container.client('websocket', {\n baseURL: 'ws://localhost:8080',\n reconnect: true,\n maxReconnectAttempts: 5\n})\nws.on('message', (data) => console.log('Received:', data))\nawait ws.connect()\nawait ws.send({ type: 'hello' })"
-    }
-  ]
+  "envVars": []
 });
 
 setBuildTimeData('clients.openai', {
@@ -10343,38 +10577,240 @@ setBuildTimeData('clients.supabase', {
   ]
 });
 
-setBuildTimeData('clients.comfyui', {
-  "id": "clients.comfyui",
-  "description": "ComfyUI client — execute Stable Diffusion workflows via the ComfyUI API. Connects to a ComfyUI instance to queue prompts, track execution via WebSocket or polling, and download generated images. Supports both UI-format and API-format workflows with automatic conversion.",
-  "shortcut": "clients.comfyui",
-  "className": "ComfyUIClient",
+setBuildTimeData('clients.elevenlabs', {
+  "id": "clients.elevenlabs",
+  "description": "ElevenLabs client — text-to-speech synthesis via the ElevenLabs REST API. Provides methods for listing voices, listing models, and generating speech audio. Audio is returned as a Buffer; use `say()` for a convenience method that writes to disk.",
+  "shortcut": "clients.elevenlabs",
+  "className": "ElevenLabsClient",
   "methods": {
-    "queuePrompt": {
-      "description": "Queue a prompt (API-format workflow) for execution.",
-      "parameters": {
-        "prompt": {
-          "type": "Record<string, any>",
-          "description": "The API-format workflow object"
-        },
-        "clientId": {
-          "type": "string",
-          "description": "Override the client ID for this request"
-        }
-      },
-      "required": [
-        "prompt"
-      ],
-      "returns": "Promise<{ prompt_id: string; number: number }>",
+    "beforeRequest": {
+      "description": "Inject the xi-api-key header before each request.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "connect": {
+      "description": "Validate the API key by listing available models.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<this>",
       "examples": [
         {
           "language": "ts",
-          "code": "const { prompt_id } = await comfy.queuePrompt(apiWorkflow)"
+          "code": "await el.connect()"
         }
       ]
     },
-    "getQueue": {
-      "description": "Get the current prompt queue status.",
-      "parameters": {},
+    "listVoices": {
+      "description": "List available voices with optional search and filtering.",
+      "parameters": {
+        "options": {
+          "type": "{\n    search?: string\n    category?: string\n    voice_type?: string\n    page_size?: number\n    next_page_token?: string\n  }",
+          "description": "Query parameters for filtering voices"
+        }
+      },
+      "required": [],
+      "returns": "Promise<any>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const voices = await el.listVoices()\nconst premade = await el.listVoices({ category: 'premade' })"
+        }
+      ]
+    },
+    "getVoice": {
+      "description": "Get details for a single voice.",
+      "parameters": {
+        "voiceId": {
+          "type": "string",
+          "description": "The voice ID to look up"
+        }
+      },
+      "required": [
+        "voiceId"
+      ],
+      "returns": "Promise<any>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const voice = await el.getVoice('21m00Tcm4TlvDq8ikWAM')\nconsole.log(voice.name, voice.settings)"
+        }
+      ]
+    },
+    "listModels": {
+      "description": "List available TTS models.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<any[]>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const models = await el.listModels()\nconsole.log(models.map(m => m.model_id))"
+        }
+      ]
+    },
+    "synthesize": {
+      "description": "Synthesize speech from text, returning audio as a Buffer.",
+      "parameters": {
+        "text": {
+          "type": "string",
+          "description": "The text to convert to speech"
+        },
+        "options": {
+          "type": "SynthesizeOptions",
+          "description": "Voice, model, format, and voice settings overrides",
+          "properties": {
+            "voiceId": {
+              "type": "string",
+              "description": ""
+            },
+            "modelId": {
+              "type": "string",
+              "description": ""
+            },
+            "outputFormat": {
+              "type": "string",
+              "description": ""
+            },
+            "voiceSettings": {
+              "type": "ElevenLabsVoiceSettings",
+              "description": ""
+            },
+            "disableCache": {
+              "type": "boolean",
+              "description": ""
+            }
+          }
+        }
+      },
+      "required": [
+        "text"
+      ],
+      "returns": "Promise<Buffer>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data\n\nconst custom = await el.synthesize('Hello', {\n voiceId: '21m00Tcm4TlvDq8ikWAM',\n voiceSettings: { stability: 0.5, similarityBoost: 0.8 }\n})"
+        }
+      ]
+    },
+    "say": {
+      "description": "Synthesize speech and write the audio to a file.",
+      "parameters": {
+        "text": {
+          "type": "string",
+          "description": "The text to convert to speech"
+        },
+        "outputPath": {
+          "type": "string",
+          "description": "File path to write the audio to"
+        },
+        "options": {
+          "type": "SynthesizeOptions",
+          "description": "Voice, model, format, and voice settings overrides",
+          "properties": {
+            "voiceId": {
+              "type": "string",
+              "description": ""
+            },
+            "modelId": {
+              "type": "string",
+              "description": ""
+            },
+            "outputFormat": {
+              "type": "string",
+              "description": ""
+            },
+            "voiceSettings": {
+              "type": "ElevenLabsVoiceSettings",
+              "description": ""
+            },
+            "disableCache": {
+              "type": "boolean",
+              "description": ""
+            }
+          }
+        }
+      },
+      "required": [
+        "text",
+        "outputPath"
+      ],
+      "returns": "Promise<string>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const path = await el.say('Hello world', './hello.mp3')\nconsole.log(`Audio saved to ${path}`)"
+        }
+      ]
+    }
+  },
+  "getters": {
+    "apiKey": {
+      "description": "The resolved API key from options or environment.",
+      "returns": "string"
+    }
+  },
+  "events": {
+    "failure": {
+      "name": "failure",
+      "description": "Event emitted by ElevenLabsClient",
+      "arguments": {}
+    },
+    "voices": {
+      "name": "voices",
+      "description": "Event emitted by ElevenLabsClient",
+      "arguments": {}
+    },
+    "speech": {
+      "name": "speech",
+      "description": "Event emitted by ElevenLabsClient",
+      "arguments": {}
+    }
+  },
+  "state": {},
+  "options": {},
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const el = container.client('elevenlabs')\nawait el.connect()\nconst voices = await el.listVoices()\nconst audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data"
+    }
+  ]
+});
+
+setBuildTimeData('clients.comfyui', {
+  "id": "clients.comfyui",
+  "description": "ComfyUI client — execute Stable Diffusion workflows via the ComfyUI API. Connects to a ComfyUI instance to queue prompts, track execution via WebSocket or polling, and download generated images. Supports both UI-format and API-format workflows with automatic conversion.",
+  "shortcut": "clients.comfyui",
+  "className": "ComfyUIClient",
+  "methods": {
+    "queuePrompt": {
+      "description": "Queue a prompt (API-format workflow) for execution.",
+      "parameters": {
+        "prompt": {
+          "type": "Record<string, any>",
+          "description": "The API-format workflow object"
+        },
+        "clientId": {
+          "type": "string",
+          "description": "Override the client ID for this request"
+        }
+      },
+      "required": [
+        "prompt"
+      ],
+      "returns": "Promise<{ prompt_id: string; number: number }>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const { prompt_id } = await comfy.queuePrompt(apiWorkflow)"
+        }
+      ]
+    },
+    "getQueue": {
+      "description": "Get the current prompt queue status.",
+      "parameters": {},
       "required": [],
       "returns": "Promise<{ queue_running: any[]; queue_pending: any[] }>"
     },
@@ -10595,221 +11031,19 @@ setBuildTimeData('clients.comfyui', {
   ]
 });
 
-setBuildTimeData('clients.elevenlabs', {
-  "id": "clients.elevenlabs",
-  "description": "ElevenLabs client — text-to-speech synthesis via the ElevenLabs REST API. Provides methods for listing voices, listing models, and generating speech audio. Audio is returned as a Buffer; use `say()` for a convenience method that writes to disk.",
-  "shortcut": "clients.elevenlabs",
-  "className": "ElevenLabsClient",
+setBuildTimeData('servers.mcp', {
+  "id": "servers.mcp",
+  "description": "MCP (Model Context Protocol) server for exposing tools, resources, and prompts to AI clients like Claude Code. Uses the low-level MCP SDK Server class directly with Zod 4 native JSON Schema conversion. Register tools, resources, and prompts programmatically, then start the server over stdio (for CLI integration) or HTTP (for remote access).",
+  "shortcut": "servers.mcp",
+  "className": "MCPServer",
   "methods": {
-    "beforeRequest": {
-      "description": "Inject the xi-api-key header before each request.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "connect": {
-      "description": "Validate the API key by listing available models.",
-      "parameters": {},
-      "required": [],
-      "returns": "Promise<this>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "await el.connect()"
-        }
-      ]
-    },
-    "listVoices": {
-      "description": "List available voices with optional search and filtering.",
+    "tool": {
+      "description": "Register an MCP tool. The tool's Zod schema is converted to JSON Schema for the protocol listing, and used for runtime argument validation. Tool handlers can return a string (auto-wrapped as text content) or a full CallToolResult object for advanced responses (images, errors, etc).",
       "parameters": {
-        "options": {
-          "type": "{\n    search?: string\n    category?: string\n    voice_type?: string\n    page_size?: number\n    next_page_token?: string\n  }",
-          "description": "Query parameters for filtering voices"
-        }
-      },
-      "required": [],
-      "returns": "Promise<any>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const voices = await el.listVoices()\nconst premade = await el.listVoices({ category: 'premade' })"
-        }
-      ]
-    },
-    "getVoice": {
-      "description": "Get details for a single voice.",
-      "parameters": {
-        "voiceId": {
-          "type": "string",
-          "description": "The voice ID to look up"
-        }
-      },
-      "required": [
-        "voiceId"
-      ],
-      "returns": "Promise<any>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const voice = await el.getVoice('21m00Tcm4TlvDq8ikWAM')\nconsole.log(voice.name, voice.settings)"
-        }
-      ]
-    },
-    "listModels": {
-      "description": "List available TTS models.",
-      "parameters": {},
-      "required": [],
-      "returns": "Promise<any[]>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const models = await el.listModels()\nconsole.log(models.map(m => m.model_id))"
-        }
-      ]
-    },
-    "synthesize": {
-      "description": "Synthesize speech from text, returning audio as a Buffer.",
-      "parameters": {
-        "text": {
-          "type": "string",
-          "description": "The text to convert to speech"
-        },
-        "options": {
-          "type": "SynthesizeOptions",
-          "description": "Voice, model, format, and voice settings overrides",
-          "properties": {
-            "voiceId": {
-              "type": "string",
-              "description": ""
-            },
-            "modelId": {
-              "type": "string",
-              "description": ""
-            },
-            "outputFormat": {
-              "type": "string",
-              "description": ""
-            },
-            "voiceSettings": {
-              "type": "ElevenLabsVoiceSettings",
-              "description": ""
-            },
-            "disableCache": {
-              "type": "boolean",
-              "description": ""
-            }
-          }
-        }
-      },
-      "required": [
-        "text"
-      ],
-      "returns": "Promise<Buffer>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data\n\nconst custom = await el.synthesize('Hello', {\n voiceId: '21m00Tcm4TlvDq8ikWAM',\n voiceSettings: { stability: 0.5, similarityBoost: 0.8 }\n})"
-        }
-      ]
-    },
-    "say": {
-      "description": "Synthesize speech and write the audio to a file.",
-      "parameters": {
-        "text": {
-          "type": "string",
-          "description": "The text to convert to speech"
-        },
-        "outputPath": {
-          "type": "string",
-          "description": "File path to write the audio to"
-        },
-        "options": {
-          "type": "SynthesizeOptions",
-          "description": "Voice, model, format, and voice settings overrides",
-          "properties": {
-            "voiceId": {
-              "type": "string",
-              "description": ""
-            },
-            "modelId": {
-              "type": "string",
-              "description": ""
-            },
-            "outputFormat": {
-              "type": "string",
-              "description": ""
-            },
-            "voiceSettings": {
-              "type": "ElevenLabsVoiceSettings",
-              "description": ""
-            },
-            "disableCache": {
-              "type": "boolean",
-              "description": ""
-            }
-          }
-        }
-      },
-      "required": [
-        "text",
-        "outputPath"
-      ],
-      "returns": "Promise<string>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const path = await el.say('Hello world', './hello.mp3')\nconsole.log(`Audio saved to ${path}`)"
-        }
-      ]
-    }
-  },
-  "getters": {
-    "apiKey": {
-      "description": "The resolved API key from options or environment.",
-      "returns": "string"
-    }
-  },
-  "events": {
-    "failure": {
-      "name": "failure",
-      "description": "Event emitted by ElevenLabsClient",
-      "arguments": {}
-    },
-    "voices": {
-      "name": "voices",
-      "description": "Event emitted by ElevenLabsClient",
-      "arguments": {}
-    },
-    "speech": {
-      "name": "speech",
-      "description": "Event emitted by ElevenLabsClient",
-      "arguments": {}
-    }
-  },
-  "state": {},
-  "options": {},
-  "envVars": [],
-  "examples": [
-    {
-      "language": "ts",
-      "code": "const el = container.client('elevenlabs')\nawait el.connect()\nconst voices = await el.listVoices()\nconst audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data"
-    }
-  ]
-});
-
-setBuildTimeData('servers.mcp', {
-  "id": "servers.mcp",
-  "description": "MCP (Model Context Protocol) server for exposing tools, resources, and prompts to AI clients like Claude Code. Uses the low-level MCP SDK Server class directly with Zod 4 native JSON Schema conversion. Register tools, resources, and prompts programmatically, then start the server over stdio (for CLI integration) or HTTP (for remote access).",
-  "shortcut": "servers.mcp",
-  "className": "MCPServer",
-  "methods": {
-    "tool": {
-      "description": "Register an MCP tool. The tool's Zod schema is converted to JSON Schema for the protocol listing, and used for runtime argument validation. Tool handlers can return a string (auto-wrapped as text content) or a full CallToolResult object for advanced responses (images, errors, etc).",
-      "parameters": {
-        "name": {
-          "type": "string",
-          "description": "Unique tool name"
-        },
+        "name": {
+          "type": "string",
+          "description": "Unique tool name"
+        },
         "options": {
           "type": "ToolRegistrationOptions",
           "description": "Tool schema, description, and handler",
@@ -11081,7 +11315,7 @@ setBuildTimeData('servers.express', {
 
 setBuildTimeData('servers.websocket', {
   "id": "servers.websocket",
-  "description": "WebSocket server built on the `ws` library with optional JSON message framing. Manages WebSocket connections, tracks connected clients, and bridges messages to Luca's event bus. When `json` mode is enabled, incoming messages are automatically JSON-parsed (with `.toString()` for Buffer data) and outgoing messages via `send()` / `broadcast()` are JSON-stringified. When `json` mode is disabled, raw message data is emitted as-is and `send()` / `broadcast()` still JSON-stringify for safety.",
+  "description": "WebSocket server built on the `ws` library with optional JSON message framing. Manages WebSocket connections, tracks connected clients, and bridges messages to Luca's event bus. When `json` mode is enabled, incoming messages are automatically JSON-parsed (with `.toString()` for Buffer data) and outgoing messages via `send()` / `broadcast()` are JSON-stringified. When `json` mode is disabled, raw message data is emitted as-is and `send()` / `broadcast()` still JSON-stringify for safety. Supports ask/reply semantics when paired with the Luca WebSocket client. The server can `ask(ws, type, data)` a connected client and await a typed response, or handle incoming asks from clients by listening for messages with a `requestId` and replying via `send(ws, { replyTo, data })`. Requests time out if no reply arrives within the configurable window.",
   "shortcut": "servers.websocket",
   "className": "WebsocketServer",
   "methods": {
@@ -11116,6 +11350,64 @@ setBuildTimeData('servers.websocket', {
       ],
       "returns": "void"
     },
+    "ask": {
+      "description": "Send a request to a specific client and wait for a correlated response. The client is expected to reply with a message whose `replyTo` matches the `requestId` of this message.",
+      "parameters": {
+        "ws": {
+          "type": "any",
+          "description": "The WebSocket client to ask"
+        },
+        "type": {
+          "type": "string",
+          "description": "A string identifying the request type"
+        },
+        "data": {
+          "type": "any",
+          "description": "Optional payload"
+        },
+        "timeout": {
+          "type": "any",
+          "description": "How long to wait (default 10 000 ms)"
+        }
+      },
+      "required": [
+        "ws",
+        "type"
+      ],
+      "returns": "Promise<R>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "ws.on('connection', async (client) => {\n const info = await ws.ask(client, 'identify')\n console.log('Client says:', info)\n})"
+        }
+      ]
+    },
+    "_handleReply": {
+      "description": "",
+      "parameters": {
+        "message": {
+          "type": "any",
+          "description": "Parameter message"
+        }
+      },
+      "required": [
+        "message"
+      ],
+      "returns": "boolean"
+    },
+    "_rejectAllPending": {
+      "description": "",
+      "parameters": {
+        "reason": {
+          "type": "string",
+          "description": "Parameter reason"
+        }
+      },
+      "required": [
+        "reason"
+      ],
+      "returns": "void"
+    },
     "start": {
       "description": "Start the WebSocket server. A runtime `port` overrides the constructor option and is written to state before the underlying `ws.Server` is created, so the server binds to the correct port.",
       "parameters": {
@@ -11162,7 +11454,7 @@ setBuildTimeData('servers.websocket', {
   "examples": [
     {
       "language": "ts",
-      "code": "const ws = container.server('websocket', { json: true })\nawait ws.start({ port: 8080 })\n\nws.on('message', (data, client) => {\n console.log('Received:', data)\n ws.broadcast({ echo: data })\n})"
+      "code": "const ws = container.server('websocket', { json: true })\nawait ws.start({ port: 8080 })\n\nws.on('message', (data, client) => {\n console.log('Received:', data)\n ws.broadcast({ echo: data })\n})\n\n// ask/reply: request info from a connected client\nws.on('connection', async (client) => {\n const info = await ws.ask(client, 'identify')\n console.log('Client says:', info)\n})"
     }
   ]
 });
@@ -11424,6 +11716,10 @@ setBuildTimeData('features.conversation', {
             "maxTokens": {
               "type": "number",
               "description": ""
+            },
+            "schema": {
+              "type": "z.ZodType",
+              "description": "When provided, enables OpenAI Structured Outputs. The model is constrained to return JSON matching this Zod schema. The return value of ask() will be the parsed object instead of a raw string."
             }
           }
         }
@@ -11541,6 +11837,21 @@ setBuildTimeData('features.conversation', {
       "description": "Event emitted by Conversation",
       "arguments": {}
     },
+    "toolError": {
+      "name": "toolError",
+      "description": "Event emitted by Conversation",
+      "arguments": {}
+    },
+    "toolCall": {
+      "name": "toolCall",
+      "description": "Event emitted by Conversation",
+      "arguments": {}
+    },
+    "toolResult": {
+      "name": "toolResult",
+      "description": "Event emitted by Conversation",
+      "arguments": {}
+    },
     "turnStart": {
       "name": "turnStart",
       "description": "Event emitted by Conversation",
@@ -11576,33 +11887,18 @@ setBuildTimeData('features.conversation', {
       "description": "Event emitted by Conversation",
       "arguments": {}
     },
-    "toolError": {
-      "name": "toolError",
+    "toolCallsEnd": {
+      "name": "toolCallsEnd",
       "description": "Event emitted by Conversation",
       "arguments": {}
     },
-    "toolCall": {
-      "name": "toolCall",
+    "turnEnd": {
+      "name": "turnEnd",
       "description": "Event emitted by Conversation",
       "arguments": {}
     },
-    "toolResult": {
-      "name": "toolResult",
-      "description": "Event emitted by Conversation",
-      "arguments": {}
-    },
-    "toolCallsEnd": {
-      "name": "toolCallsEnd",
-      "description": "Event emitted by Conversation",
-      "arguments": {}
-    },
-    "turnEnd": {
-      "name": "turnEnd",
-      "description": "Event emitted by Conversation",
-      "arguments": {}
-    },
-    "response": {
-      "name": "response",
+    "response": {
+      "name": "response",
       "description": "Event emitted by Conversation",
       "arguments": {}
     }
@@ -12010,12 +12306,61 @@ setBuildTimeData('features.assistant', {
   "shortcut": "features.assistant",
   "className": "Assistant",
   "methods": {
+    "intercept": {
+      "description": "Register an interceptor at a given point in the pipeline.",
+      "parameters": {
+        "point": {
+          "type": "K",
+          "description": "The interception point"
+        },
+        "fn": {
+          "type": "InterceptorFn<InterceptorPoints[K]>",
+          "description": "Middleware function receiving (ctx, next)"
+        }
+      },
+      "required": [
+        "point",
+        "fn"
+      ],
+      "returns": "this"
+    },
     "afterInitialize": {
       "description": "Called immediately after the assistant is constructed. Synchronously loads the system prompt, tools, and hooks, then binds hooks as event listeners so every emitted event automatically invokes its corresponding hook.",
       "parameters": {},
       "required": [],
       "returns": "void"
     },
+    "addSystemPromptExtension": {
+      "description": "Add or update a named system prompt extension. The value is appended to the base system prompt when passed to the conversation.",
+      "parameters": {
+        "key": {
+          "type": "string",
+          "description": "A unique identifier for this extension"
+        },
+        "value": {
+          "type": "string",
+          "description": "The text to append"
+        }
+      },
+      "required": [
+        "key",
+        "value"
+      ],
+      "returns": "this"
+    },
+    "removeSystemPromptExtension": {
+      "description": "Remove a named system prompt extension.",
+      "parameters": {
+        "key": {
+          "type": "string",
+          "description": "The identifier of the extension to remove"
+        }
+      },
+      "required": [
+        "key"
+      ],
+      "returns": "this"
+    },
     "use": {
       "description": "Apply a setup function or a Helper instance to this assistant. When passed a function, it receives the assistant and can configure tools, hooks, event listeners, etc. When passed a Helper instance that exposes tools via toTools(), those tools are automatically added to this assistant.",
       "parameters": {
@@ -12286,6 +12631,14 @@ setBuildTimeData('features.assistant', {
       "description": "The current system prompt text.",
       "returns": "string"
     },
+    "systemPromptExtensions": {
+      "description": "The named extensions appended to the system prompt.",
+      "returns": "Record<string, string>"
+    },
+    "effectiveSystemPrompt": {
+      "description": "The system prompt with all extensions appended. This is the value passed to the conversation.",
+      "returns": "string"
+    },
     "tools": {
       "description": "The tools registered with this assistant.",
       "returns": "Record<string, ConversationTool>"
@@ -12329,6 +12682,11 @@ setBuildTimeData('features.assistant', {
       "description": "Event emitted by Assistant",
       "arguments": {}
     },
+    "systemPromptExtensionsChanged": {
+      "name": "systemPromptExtensionsChanged",
+      "description": "Event emitted by Assistant",
+      "arguments": {}
+    },
     "toolsChanged": {
       "name": "toolsChanged",
       "description": "Event emitted by Assistant",
@@ -15653,7 +16011,7 @@ export const introspectionData = [
   },
   {
     "id": "features.windowManager",
-    "description": "WindowManager Feature — Native window control via LucaVoiceLauncher Acts as an IPC server that the native macOS launcher app connects to. Communicates over a Unix domain socket using NDJSON (newline-delimited JSON). **Protocol:** - Bun listens on a Unix domain socket; the native app connects as a client - Window dispatch commands are sent as NDJSON with a `window` field - The app executes window commands and sends back `windowAck` messages - Any non-windowAck message from the app is emitted as a `message` event - Other features can use `send()` to write arbitrary NDJSON to the app **Capabilities:** - Spawn native browser windows with configurable chrome - Navigate, focus, close, and eval JavaScript in windows - Automatic socket file cleanup and fallback paths",
+    "description": "WindowManager Feature — Native window control via LucaVoiceLauncher Uses a broker/producer architecture so multiple luca processes can trigger window operations without competing for the same Unix socket. **Architecture:** - The first process to call `listen()` becomes the **broker**. It owns the app-facing socket (`ipc-window.sock`) and a control socket (`ipc-window-control.sock`). - Subsequent processes detect the broker and become **producers**. They connect to the control socket and route commands through the broker. - The broker forwards producer commands to the native app and routes acks and lifecycle events back to the originating producer. **Protocol:** - Bun listens on a Unix domain socket; the native app connects as a client - Window dispatch commands are sent as NDJSON with a `window` field - The app executes window commands and sends back `windowAck` messages - Any non-windowAck message from the app is emitted as a `message` event - Other features can use `send()` to write arbitrary NDJSON to the app **Capabilities:** - Spawn native browser windows with configurable chrome - Navigate, focus, close, and eval JavaScript in windows - Multiple luca processes can trigger window operations simultaneously - Automatic broker detection and producer fallback Observable state includes `windows` (open window metadata), `pendingOperations` (in-flight command ids), and `producerCount` (broker). Sockets, promises, and `WindowHandle` instances stay internal. **Producer state:** The broker pushes `windowStateSync` on the control socket when a producer connects and whenever the window roster changes, so every process sees the same `windows` / `windowCount` / `clientConnected` as the broker (not only its own acks).",
     "shortcut": "features.windowManager",
     "className": "WindowManager",
     "methods": {
@@ -15669,7 +16027,18 @@ export const introspectionData = [
         "returns": "Promise<this>"
       },
       "listen": {
-        "description": "Start listening on the Unix domain socket for the native app to connect. Fire-and-forget — binds the socket and returns immediately. Sits quietly until the native app connects; does nothing visible if it never does.",
+        "description": "Start the window manager. Automatically detects whether a broker already exists and either becomes the broker or connects as a producer. - If no broker is running: becomes the broker, binds the app socket and a control socket for producers. - If a broker is already running: connects as a producer through the control socket.",
+        "parameters": {
+          "socketPath": {
+            "type": "string",
+            "description": "Override the configured app socket path"
+          }
+        },
+        "required": [],
+        "returns": "Promise<this>"
+      },
+      "cleanupSocket": {
+        "description": "Remove stale socket files without starting or stopping the server. Useful when a previous process crashed and left dead sockets behind. Will not remove sockets that have live listeners.",
         "parameters": {
           "socketPath": {
             "type": "string",
@@ -15677,10 +16046,10 @@ export const introspectionData = [
           }
         },
         "required": [],
-        "returns": "this"
+        "returns": "Promise<boolean>"
       },
       "stop": {
-        "description": "Stop the IPC server and clean up all connections. Rejects any pending window operation requests.",
+        "description": "Stop the window manager and clean up all connections. Rejects any pending window operation requests.",
         "parameters": {},
         "required": [],
         "returns": "Promise<this>"
@@ -15953,7 +16322,7 @@ export const introspectionData = [
         ]
       },
       "send": {
-        "description": "Write an NDJSON message to the connected app client. Public so other features can send arbitrary protocol messages over the same socket.",
+        "description": "Write an NDJSON message to the connected app client. In producer mode, routes through the broker. Public so other features can send arbitrary protocol messages over the same socket.",
         "parameters": {
           "msg": {
             "type": "Record<string, any>",
@@ -15967,12 +16336,20 @@ export const introspectionData = [
       }
     },
     "getters": {
+      "isBroker": {
+        "description": "Whether this instance is acting as the broker.",
+        "returns": "boolean"
+      },
+      "isProducer": {
+        "description": "Whether this instance is acting as a producer.",
+        "returns": "boolean"
+      },
       "isListening": {
-        "description": "Whether the IPC server is currently listening.",
+        "description": "Whether the IPC server is currently listening (broker) or connected to broker (producer).",
         "returns": "boolean"
       },
       "isClientConnected": {
-        "description": "Whether the native app client is currently connected.",
+        "description": "Whether the native app client is currently connected (only meaningful for broker).",
         "returns": "boolean"
       }
     },
@@ -16007,6 +16384,11 @@ export const introspectionData = [
         "description": "Event emitted by WindowManager",
         "arguments": {}
       },
+      "windowFocus": {
+        "name": "windowFocus",
+        "description": "Event emitted by WindowManager",
+        "arguments": {}
+      },
       "message": {
         "name": "message",
         "description": "Event emitted by WindowManager",
@@ -19857,6 +20239,32 @@ export const introspectionData = [
           }
         ]
       },
+      "isSymlink": {
+        "description": "Checks if a path is a symbolic link.",
+        "parameters": {
+          "path": {
+            "type": "string",
+            "description": "The path to check"
+          }
+        },
+        "required": [
+          "path"
+        ],
+        "returns": "boolean"
+      },
+      "realpath": {
+        "description": "Resolves a symlink to its real path. Returns the resolved path as-is if not a symlink.",
+        "parameters": {
+          "path": {
+            "type": "string",
+            "description": "The path to resolve"
+          }
+        },
+        "required": [
+          "path"
+        ],
+        "returns": "string"
+      },
       "stat": {
         "description": "Synchronously returns the stat object for a file or directory.",
         "parameters": {
@@ -20330,7 +20738,7 @@ export const introspectionData = [
   },
   {
     "id": "features.ipcSocket",
-    "description": "IpcSocket Feature - Inter-Process Communication via Unix Domain Sockets This feature provides robust IPC (Inter-Process Communication) capabilities using Unix domain sockets. It supports both server and client modes, allowing processes to communicate efficiently through file system-based socket connections. **Key Features:** - Dual-mode operation: server and client functionality - JSON message serialization/deserialization - Multiple client connection support (server mode) - Event-driven message handling - Automatic socket cleanup and management - Broadcast messaging to all connected clients - Lock file management for socket paths **Communication Pattern:** - Messages are automatically JSON-encoded with unique IDs - Both server and client emit 'message' events for incoming data - Server can broadcast to all connected clients - Client maintains single connection to server **Socket Management:** - Automatic cleanup of stale socket files - Connection tracking and management - Graceful shutdown procedures - Lock file protection against conflicts **Usage Examples:** **Server Mode:** ```typescript const ipc = container.feature('ipcSocket'); await ipc.listen('/tmp/myapp.sock', true); // removeLock=true ipc.on('connection', (socket) => { console.log('Client connected'); }); ipc.on('message', (data) => { console.log('Received:', data); ipc.broadcast({ reply: 'ACK', original: data }); }); ``` **Client Mode:** ```typescript const ipc = container.feature('ipcSocket'); await ipc.connect('/tmp/myapp.sock'); ipc.on('message', (data) => { console.log('Server says:', data); }); await ipc.send({ type: 'request', payload: 'hello' }); ```",
+    "description": "IpcSocket Feature - Inter-Process Communication via Unix Domain Sockets This feature provides robust IPC (Inter-Process Communication) capabilities using Unix domain sockets. It supports both server and client modes, allowing processes to communicate efficiently through file system-based socket connections. **Key Features:** - Hub-and-spoke: one server, many named clients with identity tracking - Targeted messaging: sendTo(clientId), broadcast(msg, excludeId) - Request/reply: ask() + reply() with timeout-based correlation - Auto-reconnect: clients reconnect with exponential backoff - Stale socket detection: probeSocket() before listen() - Clean shutdown: stopServer() removes socket file **Server (Hub):** ```typescript const ipc = container.feature('ipcSocket'); await ipc.listen('/tmp/hub.sock', true); ipc.on('connection', (clientId, socket) => { console.log('Client joined:', clientId); }); ipc.on('message', (data, clientId) => { console.log(`From ${clientId}:`, data); // Reply to sender, or ask and wait ipc.sendTo(clientId, { ack: true }); }); ``` **Client (Spoke):** ```typescript const ipc = container.feature('ipcSocket'); await ipc.connect('/tmp/hub.sock', { reconnect: true, name: 'worker-1' }); // Fire and forget await ipc.send({ type: 'status', ready: true }); // Request/reply ipc.on('message', (data) => { if (data.requestId) ipc.reply(data.requestId, { result: 42 }); }); ```",
     "shortcut": "features.ipcSocket",
     "className": "IpcSocket",
     "methods": {
@@ -20370,61 +20778,127 @@ export const introspectionData = [
         ]
       },
       "broadcast": {
-        "description": "Broadcasts a message to all connected clients (server mode only). This method sends a JSON-encoded message with a unique ID to every client currently connected to the server. Each message is automatically wrapped with metadata including a UUID for tracking. **Message Format:** Messages are automatically wrapped in the format: ```json { \"data\": <your_message>, \"id\": \"<uuid>\" } ```",
+        "description": "Broadcasts a message to all connected clients (server mode only).",
         "parameters": {
           "message": {
             "type": "any",
-            "description": "The message object to broadcast to all clients"
+            "description": "The message object to broadcast"
+          },
+          "exclude": {
+            "type": "string",
+            "description": "Optional client ID to exclude from broadcast"
           }
         },
         "required": [
           "message"
         ],
-        "returns": "void",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "// Broadcast to all connected clients\nipc.broadcast({ \n type: 'notification',\n message: 'Server is shutting down in 30 seconds',\n timestamp: Date.now()\n});\n\n// Chain multiple operations\nipc.broadcast({ status: 'ready' })\n  .broadcast({ time: new Date().toISOString() });"
+        "returns": "void"
+      },
+      "sendTo": {
+        "description": "Sends a message to a specific client by ID (server mode only).",
+        "parameters": {
+          "clientId": {
+            "type": "string",
+            "description": "The target client ID"
+          },
+          "message": {
+            "type": "any",
+            "description": "The message to send"
           }
-        ]
+        },
+        "required": [
+          "clientId",
+          "message"
+        ],
+        "returns": "boolean"
       },
       "send": {
-        "description": "Sends a message to the server (client mode only). This method sends a JSON-encoded message with a unique ID to the connected server. The message is automatically wrapped with metadata for tracking purposes. **Message Format:** Messages are automatically wrapped in the format: ```json { \"data\": <your_message>, \"id\": \"<uuid>\" } ```",
+        "description": "Fire-and-forget: sends a message to the server (client mode only). For server→client, use sendTo() or broadcast().",
         "parameters": {
           "message": {
             "type": "any",
-            "description": "The message object to send to the server"
+            "description": "The message to send"
           }
         },
         "required": [
           "message"
         ],
-        "returns": "void",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "// Send a simple message\nawait ipc.send({ type: 'ping' });\n\n// Send complex data\nawait ipc.send({\n type: 'data_update',\n payload: { users: [...], timestamp: Date.now() }\n});"
+        "returns": "void"
+      },
+      "ask": {
+        "description": "Sends a message and waits for a correlated reply. Works in both client and server mode. The recipient should call `reply(requestId, response)` to respond.",
+        "parameters": {
+          "message": {
+            "type": "any",
+            "description": "The message to send"
+          },
+          "options": {
+            "type": "{ clientId?: string; timeoutMs?: number }",
+            "description": "Optional: clientId (server mode target), timeoutMs"
           }
-        ]
+        },
+        "required": [
+          "message"
+        ],
+        "returns": "Promise<any>"
+      },
+      "reply": {
+        "description": "Sends a reply to a previous ask() call, correlated by requestId.",
+        "parameters": {
+          "requestId": {
+            "type": "string",
+            "description": "The requestId from the incoming message"
+          },
+          "data": {
+            "type": "any",
+            "description": "The reply payload"
+          },
+          "clientId": {
+            "type": "string",
+            "description": "Target client (server mode; for client mode, omit)"
+          }
+        },
+        "required": [
+          "requestId",
+          "data"
+        ],
+        "returns": "void"
       },
       "connect": {
-        "description": "Connects to an IPC server at the specified socket path (client mode). This method establishes a client connection to an existing IPC server. Once connected, the client can send messages to the server and receive responses. The connection is maintained until explicitly closed or the server terminates. **Connection Behavior:** - Sets the socket mode to 'client' - Returns existing connection if already connected - Automatically handles connection events and cleanup - JSON-parses incoming messages and emits 'message' events - Cleans up connection reference when socket closes **Error Handling:** - Throws error if already in server mode - Rejects promise on connection failures - Automatically cleans up on connection close",
+        "description": "Connects to an IPC server at the specified socket path (client mode).",
         "parameters": {
           "socketPath": {
             "type": "string",
-            "description": "The file system path to the server's Unix domain socket"
+            "description": "Path to the server's Unix domain socket"
+          },
+          "options": {
+            "type": "{ reconnect?: boolean; name?: string }",
+            "description": "Optional: reconnect (enable auto-reconnect), name (identify this client)"
           }
         },
         "required": [
           "socketPath"
         ],
-        "returns": "Promise<Socket>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "// Connect to server\nconst socket = await ipc.connect('/tmp/myapp.sock');\nconsole.log('Connected to IPC server');\n\n// Handle incoming messages\nipc.on('message', (data) => {\n console.log('Server message:', data);\n});\n\n// Send messages\nawait ipc.send({ type: 'hello', client_id: 'client_001' });"
+        "returns": "Promise<Socket>"
+      },
+      "disconnect": {
+        "description": "Disconnects the client and stops any reconnection attempts.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "probeSocket": {
+        "description": "Probe an existing socket to see if a live listener is behind it. Attempts a quick connect — if it succeeds, someone is listening.",
+        "parameters": {
+          "socketPath": {
+            "type": "string",
+            "description": "Parameter socketPath"
           }
-        ]
+        },
+        "required": [
+          "socketPath"
+        ],
+        "returns": "Promise<boolean>"
       }
     },
     "getters": {
@@ -20436,12 +20910,25 @@ export const introspectionData = [
         "description": "Checks if the IPC socket is operating in server mode.",
         "returns": "any"
       },
+      "clientCount": {
+        "description": "Returns the number of currently connected clients (server mode).",
+        "returns": "any"
+      },
+      "connectedClients": {
+        "description": "Returns info about all connected clients (server mode).",
+        "returns": "Array<{ id: string; name?: string; connectedAt: number }>"
+      },
       "connection": {
         "description": "Gets the current client connection socket.",
         "returns": "any"
       }
     },
     "events": {
+      "disconnection": {
+        "name": "disconnection",
+        "description": "Event emitted by IpcSocket",
+        "arguments": {}
+      },
       "connection": {
         "name": "connection",
         "description": "Event emitted by IpcSocket",
@@ -21356,10 +21843,68 @@ export const introspectionData = [
   },
   {
     "id": "features.processManager",
-    "description": "Manages long-running child processes with tracking, events, and automatic cleanup. Unlike the `proc` feature whose spawn methods block until the child exits, ProcessManager returns a SpawnHandler immediately — a handle object with its own state, events, and lifecycle methods. The feature tracks all spawned processes, maintains observable state, and can automatically kill them on parent exit.",
+    "description": "Manages long-running child processes with tracking, events, and automatic cleanup. Unlike the `proc` feature whose spawn methods block until the child exits, ProcessManager returns a SpawnHandler immediately — a handle object with its own state, events, and lifecycle methods. The feature tracks all spawned processes, maintains observable state, and can automatically kill them on parent exit. Each handler maintains a memory-efficient output buffer: the first 20 lines (head) and last 50 lines (tail) of stdout/stderr are kept, everything in between is discarded.",
     "shortcut": "features.processManager",
     "className": "ProcessManager",
     "methods": {
+      "spawnProcess": {
+        "description": "Tool handler: spawn a long-running background process.",
+        "parameters": {
+          "args": {
+            "type": "{ command: string; args?: string; tag?: string; cwd?: string }",
+            "description": "Parameter args"
+          }
+        },
+        "required": [
+          "args"
+        ],
+        "returns": "void"
+      },
+      "runCommand": {
+        "description": "Tool handler: run a command to completion and return its output.",
+        "parameters": {
+          "args": {
+            "type": "{ command: string; cwd?: string }",
+            "description": "Parameter args"
+          }
+        },
+        "required": [
+          "args"
+        ],
+        "returns": "void"
+      },
+      "listProcesses": {
+        "description": "Tool handler: list all tracked processes.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "getProcessOutput": {
+        "description": "Tool handler: peek at a process's buffered output.",
+        "parameters": {
+          "args": {
+            "type": "{ id?: string; tag?: string; stream?: string }",
+            "description": "Parameter args"
+          }
+        },
+        "required": [
+          "args"
+        ],
+        "returns": "void"
+      },
+      "killProcess": {
+        "description": "Tool handler: kill a process by ID or tag.",
+        "parameters": {
+          "args": {
+            "type": "{ id?: string; tag?: string; signal?: string }",
+            "description": "Parameter args"
+          }
+        },
+        "required": [
+          "args"
+        ],
+        "returns": "void"
+      },
       "spawn": {
         "description": "Spawn a long-running process and return a handle immediately. The returned SpawnHandler provides events for stdout/stderr streaming, exit/crash notifications, and methods to kill or await the process.",
         "parameters": {
@@ -21537,7 +22082,7 @@ export const introspectionData = [
     "examples": [
       {
         "language": "ts",
-        "code": "const pm = container.feature('processManager', { enable: true })\n\nconst server = pm.spawn('node', ['server.js'], { tag: 'api', cwd: '/app' })\nserver.on('stdout', (data) => console.log('[api]', data))\nserver.on('crash', (code) => console.error('API crashed:', code))\n\n// Kill one\nserver.kill()\n\n// Kill all tracked processes\npm.killAll()\n\n// List and lookup\npm.list()              // SpawnHandler[]\npm.getByTag('api')     // SpawnHandler | undefined"
+        "code": "const pm = container.feature('processManager', { enable: true })\n\nconst server = pm.spawn('node', ['server.js'], { tag: 'api', cwd: '/app' })\nserver.on('stdout', (data) => console.log('[api]', data))\nserver.on('crash', (code) => console.error('API crashed:', code))\n\n// Peek at buffered output\nconst { head, tail } = server.peek()\n\n// Kill one\nserver.kill()\n\n// Kill all tracked processes\npm.killAll()\n\n// List and lookup\npm.list()              // SpawnHandler[]\npm.getByTag('api')     // SpawnHandler | undefined"
       }
     ]
   },
@@ -23895,7 +24440,7 @@ export const introspectionData = [
   },
   {
     "id": "clients.websocket",
-    "description": "WebSocket client that bridges raw WebSocket events to Luca's Helper event bus, providing a clean interface for sending/receiving messages, tracking connection state, and optional auto-reconnection with exponential backoff. Events emitted: - `open` — connection established - `message` — message received (JSON-parsed when possible) - `close` — connection closed (with code and reason) - `error` — connection error - `reconnecting` — attempting reconnection (with attempt number)",
+    "description": "WebSocketClient helper",
     "shortcut": "clients.websocket",
     "className": "WebSocketClient",
     "methods": {
@@ -23918,24 +24463,77 @@ export const introspectionData = [
         ],
         "returns": "Promise<void>"
       },
-      "disconnect": {
-        "description": "Gracefully close the WebSocket connection. Suppresses auto-reconnect and updates connection state to disconnected.",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<this>"
-      }
-    },
-    "getters": {
-      "hasError": {
-        "description": "Whether the client is in an error state.",
-        "returns": "any"
-      }
-    },
-    "events": {
-      "open": {
-        "name": "open",
-        "description": "Event emitted by WebSocketClient",
-        "arguments": {}
+      "ask": {
+        "description": "Send a request and wait for a correlated response. The message is sent with a unique `requestId`; the remote side is expected to reply with a message containing `replyTo` set to that same ID.",
+        "parameters": {
+          "type": {
+            "type": "string",
+            "description": "A string identifying the request type"
+          },
+          "data": {
+            "type": "any",
+            "description": "Optional payload to include with the request"
+          },
+          "timeout": {
+            "type": "any",
+            "description": "How long to wait for a response (default 10 000 ms)"
+          }
+        },
+        "required": [
+          "type"
+        ],
+        "returns": "Promise<R>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const result = await ws.ask('getUser', { id: 42 })"
+          }
+        ]
+      },
+      "_handleReply": {
+        "description": "",
+        "parameters": {
+          "message": {
+            "type": "any",
+            "description": "Parameter message"
+          }
+        },
+        "required": [
+          "message"
+        ],
+        "returns": "boolean"
+      },
+      "_rejectAllPending": {
+        "description": "",
+        "parameters": {
+          "reason": {
+            "type": "string",
+            "description": "Parameter reason"
+          }
+        },
+        "required": [
+          "reason"
+        ],
+        "returns": "void"
+      },
+      "disconnect": {
+        "description": "Gracefully close the WebSocket connection. Suppresses auto-reconnect and updates connection state to disconnected.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<this>"
+      }
+    },
+    "getters": {
+      "hasError": {
+        "description": "Whether the client is in an error state.",
+        "returns": "any"
+      }
+    },
+    "events": {
+      "open": {
+        "name": "open",
+        "description": "Event emitted by WebSocketClient",
+        "arguments": {}
       },
       "error": {
         "name": "error",
@@ -23960,13 +24558,7 @@ export const introspectionData = [
     },
     "state": {},
     "options": {},
-    "envVars": [],
-    "examples": [
-      {
-        "language": "ts",
-        "code": "const ws = container.client('websocket', {\n baseURL: 'ws://localhost:8080',\n reconnect: true,\n maxReconnectAttempts: 5\n})\nws.on('message', (data) => console.log('Received:', data))\nawait ws.connect()\nawait ws.send({ type: 'hello' })"
-      }
-    ]
+    "envVars": []
   },
   {
     "id": "clients.openai",
@@ -24430,6 +25022,207 @@ export const introspectionData = [
       }
     ]
   },
+  {
+    "id": "clients.elevenlabs",
+    "description": "ElevenLabs client — text-to-speech synthesis via the ElevenLabs REST API. Provides methods for listing voices, listing models, and generating speech audio. Audio is returned as a Buffer; use `say()` for a convenience method that writes to disk.",
+    "shortcut": "clients.elevenlabs",
+    "className": "ElevenLabsClient",
+    "methods": {
+      "beforeRequest": {
+        "description": "Inject the xi-api-key header before each request.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "connect": {
+        "description": "Validate the API key by listing available models.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<this>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "await el.connect()"
+          }
+        ]
+      },
+      "listVoices": {
+        "description": "List available voices with optional search and filtering.",
+        "parameters": {
+          "options": {
+            "type": "{\n    search?: string\n    category?: string\n    voice_type?: string\n    page_size?: number\n    next_page_token?: string\n  }",
+            "description": "Query parameters for filtering voices"
+          }
+        },
+        "required": [],
+        "returns": "Promise<any>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const voices = await el.listVoices()\nconst premade = await el.listVoices({ category: 'premade' })"
+          }
+        ]
+      },
+      "getVoice": {
+        "description": "Get details for a single voice.",
+        "parameters": {
+          "voiceId": {
+            "type": "string",
+            "description": "The voice ID to look up"
+          }
+        },
+        "required": [
+          "voiceId"
+        ],
+        "returns": "Promise<any>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const voice = await el.getVoice('21m00Tcm4TlvDq8ikWAM')\nconsole.log(voice.name, voice.settings)"
+          }
+        ]
+      },
+      "listModels": {
+        "description": "List available TTS models.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<any[]>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const models = await el.listModels()\nconsole.log(models.map(m => m.model_id))"
+          }
+        ]
+      },
+      "synthesize": {
+        "description": "Synthesize speech from text, returning audio as a Buffer.",
+        "parameters": {
+          "text": {
+            "type": "string",
+            "description": "The text to convert to speech"
+          },
+          "options": {
+            "type": "SynthesizeOptions",
+            "description": "Voice, model, format, and voice settings overrides",
+            "properties": {
+              "voiceId": {
+                "type": "string",
+                "description": ""
+              },
+              "modelId": {
+                "type": "string",
+                "description": ""
+              },
+              "outputFormat": {
+                "type": "string",
+                "description": ""
+              },
+              "voiceSettings": {
+                "type": "ElevenLabsVoiceSettings",
+                "description": ""
+              },
+              "disableCache": {
+                "type": "boolean",
+                "description": ""
+              }
+            }
+          }
+        },
+        "required": [
+          "text"
+        ],
+        "returns": "Promise<Buffer>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data\n\nconst custom = await el.synthesize('Hello', {\n voiceId: '21m00Tcm4TlvDq8ikWAM',\n voiceSettings: { stability: 0.5, similarityBoost: 0.8 }\n})"
+          }
+        ]
+      },
+      "say": {
+        "description": "Synthesize speech and write the audio to a file.",
+        "parameters": {
+          "text": {
+            "type": "string",
+            "description": "The text to convert to speech"
+          },
+          "outputPath": {
+            "type": "string",
+            "description": "File path to write the audio to"
+          },
+          "options": {
+            "type": "SynthesizeOptions",
+            "description": "Voice, model, format, and voice settings overrides",
+            "properties": {
+              "voiceId": {
+                "type": "string",
+                "description": ""
+              },
+              "modelId": {
+                "type": "string",
+                "description": ""
+              },
+              "outputFormat": {
+                "type": "string",
+                "description": ""
+              },
+              "voiceSettings": {
+                "type": "ElevenLabsVoiceSettings",
+                "description": ""
+              },
+              "disableCache": {
+                "type": "boolean",
+                "description": ""
+              }
+            }
+          }
+        },
+        "required": [
+          "text",
+          "outputPath"
+        ],
+        "returns": "Promise<string>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const path = await el.say('Hello world', './hello.mp3')\nconsole.log(`Audio saved to ${path}`)"
+          }
+        ]
+      }
+    },
+    "getters": {
+      "apiKey": {
+        "description": "The resolved API key from options or environment.",
+        "returns": "string"
+      }
+    },
+    "events": {
+      "failure": {
+        "name": "failure",
+        "description": "Event emitted by ElevenLabsClient",
+        "arguments": {}
+      },
+      "voices": {
+        "name": "voices",
+        "description": "Event emitted by ElevenLabsClient",
+        "arguments": {}
+      },
+      "speech": {
+        "name": "speech",
+        "description": "Event emitted by ElevenLabsClient",
+        "arguments": {}
+      }
+    },
+    "state": {},
+    "options": {},
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const el = container.client('elevenlabs')\nawait el.connect()\nconst voices = await el.listVoices()\nconst audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data"
+      }
+    ]
+  },
   {
     "id": "clients.comfyui",
     "description": "ComfyUI client — execute Stable Diffusion workflows via the ComfyUI API. Connects to a ComfyUI instance to queue prompts, track execution via WebSocket or polling, and download generated images. Supports both UI-format and API-format workflows with automatic conversion.",
@@ -24558,317 +25351,116 @@ export const introspectionData = [
           "filename"
         ],
         "returns": "Promise<Buffer>"
-      },
-      "connectWs": {
-        "description": "Open a WebSocket connection to ComfyUI for real-time execution tracking. Events emitted: `execution_start`, `executing`, `progress`, `executed`, `execution_cached`, `execution_error`, `execution_complete`.",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<void>"
-      },
-      "disconnectWs": {
-        "description": "Close the WebSocket connection.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "toApiFormat": {
-        "description": "Convert a UI-format workflow to the API format that /prompt expects. Requires a running ComfyUI instance to fetch `object_info` so we can map positional `widgets_values` to their named input fields. If the workflow is already in API format, it's returned as-is.",
-        "parameters": {
-          "workflow": {
-            "type": "Record<string, any>",
-            "description": "Parameter workflow"
-          }
-        },
-        "required": [
-          "workflow"
-        ],
-        "returns": "Promise<Record<string, any>>"
-      },
-      "runWorkflow": {
-        "description": "Run a ComfyUI workflow with optional runtime input overrides. Inputs can be provided in two forms: **Direct node mapping** (when no `inputMap` in options): ``` { '3': { seed: 42 }, '6': { text: 'a cat' } } ``` **Named inputs** (when `inputMap` is provided in options): ``` inputs: { positive_prompt: 'a cat', seed: 42 } options.inputMap: { positive_prompt: { nodeId: '6', field: 'text' }, seed: { nodeId: '3', field: 'seed' } } ```",
-        "parameters": {
-          "workflow": {
-            "type": "Record<string, any>",
-            "description": "Parameter workflow"
-          },
-          "inputs": {
-            "type": "Record<string, any>",
-            "description": "Parameter inputs"
-          },
-          "options": {
-            "type": "WorkflowRunOptions",
-            "description": "Parameter options",
-            "properties": {
-              "poll": {
-                "type": "boolean",
-                "description": "Use polling instead of WebSocket for tracking execution"
-              },
-              "pollInterval": {
-                "type": "number",
-                "description": "Polling interval in ms (default 1000)"
-              },
-              "inputMap": {
-                "type": "InputMapping",
-                "description": "Named input mapping: semantic name -> { nodeId, field }"
-              },
-              "outputDir": {
-                "type": "string",
-                "description": "If provided, output images are downloaded to this directory"
-              }
-            }
-          }
-        },
-        "required": [
-          "workflow"
-        ],
-        "returns": "Promise<WorkflowResult>"
-      }
-    },
-    "getters": {
-      "clientId": {
-        "description": "The unique client ID used for WebSocket session tracking.",
-        "returns": "string"
-      },
-      "wsURL": {
-        "description": "The WebSocket URL derived from baseURL or overridden via options.",
-        "returns": "string"
-      }
-    },
-    "events": {
-      "execution_start": {
-        "name": "execution_start",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
-      },
-      "execution_complete": {
-        "name": "execution_complete",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
-      },
-      "executing": {
-        "name": "executing",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
-      },
-      "progress": {
-        "name": "progress",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
-      },
-      "executed": {
-        "name": "executed",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
-      },
-      "execution_cached": {
-        "name": "execution_cached",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
-      },
-      "execution_error": {
-        "name": "execution_error",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
-      }
-    },
-    "state": {},
-    "options": {},
-    "envVars": [],
-    "examples": [
-      {
-        "language": "ts",
-        "code": "const comfy = container.client('comfyui', { baseURL: 'http://localhost:8188' })\nconst result = await comfy.runWorkflow(workflow, {\n '6': { text: 'a beautiful sunset' }\n})\nconsole.log(result.images)"
-      }
-    ]
-  },
-  {
-    "id": "clients.elevenlabs",
-    "description": "ElevenLabs client — text-to-speech synthesis via the ElevenLabs REST API. Provides methods for listing voices, listing models, and generating speech audio. Audio is returned as a Buffer; use `say()` for a convenience method that writes to disk.",
-    "shortcut": "clients.elevenlabs",
-    "className": "ElevenLabsClient",
-    "methods": {
-      "beforeRequest": {
-        "description": "Inject the xi-api-key header before each request.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "connect": {
-        "description": "Validate the API key by listing available models.",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<this>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "await el.connect()"
-          }
-        ]
-      },
-      "listVoices": {
-        "description": "List available voices with optional search and filtering.",
-        "parameters": {
-          "options": {
-            "type": "{\n    search?: string\n    category?: string\n    voice_type?: string\n    page_size?: number\n    next_page_token?: string\n  }",
-            "description": "Query parameters for filtering voices"
-          }
-        },
-        "required": [],
-        "returns": "Promise<any>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const voices = await el.listVoices()\nconst premade = await el.listVoices({ category: 'premade' })"
-          }
-        ]
-      },
-      "getVoice": {
-        "description": "Get details for a single voice.",
-        "parameters": {
-          "voiceId": {
-            "type": "string",
-            "description": "The voice ID to look up"
-          }
-        },
-        "required": [
-          "voiceId"
-        ],
-        "returns": "Promise<any>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const voice = await el.getVoice('21m00Tcm4TlvDq8ikWAM')\nconsole.log(voice.name, voice.settings)"
-          }
-        ]
-      },
-      "listModels": {
-        "description": "List available TTS models.",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<any[]>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const models = await el.listModels()\nconsole.log(models.map(m => m.model_id))"
-          }
-        ]
-      },
-      "synthesize": {
-        "description": "Synthesize speech from text, returning audio as a Buffer.",
-        "parameters": {
-          "text": {
-            "type": "string",
-            "description": "The text to convert to speech"
-          },
-          "options": {
-            "type": "SynthesizeOptions",
-            "description": "Voice, model, format, and voice settings overrides",
-            "properties": {
-              "voiceId": {
-                "type": "string",
-                "description": ""
-              },
-              "modelId": {
-                "type": "string",
-                "description": ""
-              },
-              "outputFormat": {
-                "type": "string",
-                "description": ""
-              },
-              "voiceSettings": {
-                "type": "ElevenLabsVoiceSettings",
-                "description": ""
-              },
-              "disableCache": {
-                "type": "boolean",
-                "description": ""
-              }
-            }
+      },
+      "connectWs": {
+        "description": "Open a WebSocket connection to ComfyUI for real-time execution tracking. Events emitted: `execution_start`, `executing`, `progress`, `executed`, `execution_cached`, `execution_error`, `execution_complete`.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<void>"
+      },
+      "disconnectWs": {
+        "description": "Close the WebSocket connection.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "toApiFormat": {
+        "description": "Convert a UI-format workflow to the API format that /prompt expects. Requires a running ComfyUI instance to fetch `object_info` so we can map positional `widgets_values` to their named input fields. If the workflow is already in API format, it's returned as-is.",
+        "parameters": {
+          "workflow": {
+            "type": "Record<string, any>",
+            "description": "Parameter workflow"
           }
         },
         "required": [
-          "text"
+          "workflow"
         ],
-        "returns": "Promise<Buffer>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data\n\nconst custom = await el.synthesize('Hello', {\n voiceId: '21m00Tcm4TlvDq8ikWAM',\n voiceSettings: { stability: 0.5, similarityBoost: 0.8 }\n})"
-          }
-        ]
+        "returns": "Promise<Record<string, any>>"
       },
-      "say": {
-        "description": "Synthesize speech and write the audio to a file.",
+      "runWorkflow": {
+        "description": "Run a ComfyUI workflow with optional runtime input overrides. Inputs can be provided in two forms: **Direct node mapping** (when no `inputMap` in options): ``` { '3': { seed: 42 }, '6': { text: 'a cat' } } ``` **Named inputs** (when `inputMap` is provided in options): ``` inputs: { positive_prompt: 'a cat', seed: 42 } options.inputMap: { positive_prompt: { nodeId: '6', field: 'text' }, seed: { nodeId: '3', field: 'seed' } } ```",
         "parameters": {
-          "text": {
-            "type": "string",
-            "description": "The text to convert to speech"
+          "workflow": {
+            "type": "Record<string, any>",
+            "description": "Parameter workflow"
           },
-          "outputPath": {
-            "type": "string",
-            "description": "File path to write the audio to"
+          "inputs": {
+            "type": "Record<string, any>",
+            "description": "Parameter inputs"
           },
           "options": {
-            "type": "SynthesizeOptions",
-            "description": "Voice, model, format, and voice settings overrides",
+            "type": "WorkflowRunOptions",
+            "description": "Parameter options",
             "properties": {
-              "voiceId": {
-                "type": "string",
-                "description": ""
-              },
-              "modelId": {
-                "type": "string",
-                "description": ""
+              "poll": {
+                "type": "boolean",
+                "description": "Use polling instead of WebSocket for tracking execution"
               },
-              "outputFormat": {
-                "type": "string",
-                "description": ""
+              "pollInterval": {
+                "type": "number",
+                "description": "Polling interval in ms (default 1000)"
               },
-              "voiceSettings": {
-                "type": "ElevenLabsVoiceSettings",
-                "description": ""
+              "inputMap": {
+                "type": "InputMapping",
+                "description": "Named input mapping: semantic name -> { nodeId, field }"
               },
-              "disableCache": {
-                "type": "boolean",
-                "description": ""
+              "outputDir": {
+                "type": "string",
+                "description": "If provided, output images are downloaded to this directory"
               }
             }
           }
         },
         "required": [
-          "text",
-          "outputPath"
+          "workflow"
         ],
-        "returns": "Promise<string>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const path = await el.say('Hello world', './hello.mp3')\nconsole.log(`Audio saved to ${path}`)"
-          }
-        ]
+        "returns": "Promise<WorkflowResult>"
       }
     },
     "getters": {
-      "apiKey": {
-        "description": "The resolved API key from options or environment.",
+      "clientId": {
+        "description": "The unique client ID used for WebSocket session tracking.",
+        "returns": "string"
+      },
+      "wsURL": {
+        "description": "The WebSocket URL derived from baseURL or overridden via options.",
         "returns": "string"
       }
     },
     "events": {
-      "failure": {
-        "name": "failure",
-        "description": "Event emitted by ElevenLabsClient",
+      "execution_start": {
+        "name": "execution_start",
+        "description": "Event emitted by ComfyUIClient",
         "arguments": {}
       },
-      "voices": {
-        "name": "voices",
-        "description": "Event emitted by ElevenLabsClient",
+      "execution_complete": {
+        "name": "execution_complete",
+        "description": "Event emitted by ComfyUIClient",
         "arguments": {}
       },
-      "speech": {
-        "name": "speech",
-        "description": "Event emitted by ElevenLabsClient",
+      "executing": {
+        "name": "executing",
+        "description": "Event emitted by ComfyUIClient",
+        "arguments": {}
+      },
+      "progress": {
+        "name": "progress",
+        "description": "Event emitted by ComfyUIClient",
+        "arguments": {}
+      },
+      "executed": {
+        "name": "executed",
+        "description": "Event emitted by ComfyUIClient",
+        "arguments": {}
+      },
+      "execution_cached": {
+        "name": "execution_cached",
+        "description": "Event emitted by ComfyUIClient",
+        "arguments": {}
+      },
+      "execution_error": {
+        "name": "execution_error",
+        "description": "Event emitted by ComfyUIClient",
         "arguments": {}
       }
     },
@@ -24878,7 +25470,7 @@ export const introspectionData = [
     "examples": [
       {
         "language": "ts",
-        "code": "const el = container.client('elevenlabs')\nawait el.connect()\nconst voices = await el.listVoices()\nconst audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data"
+        "code": "const comfy = container.client('comfyui', { baseURL: 'http://localhost:8188' })\nconst result = await comfy.runWorkflow(workflow, {\n '6': { text: 'a beautiful sunset' }\n})\nconsole.log(result.images)"
       }
     ]
   },
@@ -25164,7 +25756,7 @@ export const introspectionData = [
   },
   {
     "id": "servers.websocket",
-    "description": "WebSocket server built on the `ws` library with optional JSON message framing. Manages WebSocket connections, tracks connected clients, and bridges messages to Luca's event bus. When `json` mode is enabled, incoming messages are automatically JSON-parsed (with `.toString()` for Buffer data) and outgoing messages via `send()` / `broadcast()` are JSON-stringified. When `json` mode is disabled, raw message data is emitted as-is and `send()` / `broadcast()` still JSON-stringify for safety.",
+    "description": "WebSocket server built on the `ws` library with optional JSON message framing. Manages WebSocket connections, tracks connected clients, and bridges messages to Luca's event bus. When `json` mode is enabled, incoming messages are automatically JSON-parsed (with `.toString()` for Buffer data) and outgoing messages via `send()` / `broadcast()` are JSON-stringified. When `json` mode is disabled, raw message data is emitted as-is and `send()` / `broadcast()` still JSON-stringify for safety. Supports ask/reply semantics when paired with the Luca WebSocket client. The server can `ask(ws, type, data)` a connected client and await a typed response, or handle incoming asks from clients by listening for messages with a `requestId` and replying via `send(ws, { replyTo, data })`. Requests time out if no reply arrives within the configurable window.",
     "shortcut": "servers.websocket",
     "className": "WebsocketServer",
     "methods": {
@@ -25199,6 +25791,64 @@ export const introspectionData = [
         ],
         "returns": "void"
       },
+      "ask": {
+        "description": "Send a request to a specific client and wait for a correlated response. The client is expected to reply with a message whose `replyTo` matches the `requestId` of this message.",
+        "parameters": {
+          "ws": {
+            "type": "any",
+            "description": "The WebSocket client to ask"
+          },
+          "type": {
+            "type": "string",
+            "description": "A string identifying the request type"
+          },
+          "data": {
+            "type": "any",
+            "description": "Optional payload"
+          },
+          "timeout": {
+            "type": "any",
+            "description": "How long to wait (default 10 000 ms)"
+          }
+        },
+        "required": [
+          "ws",
+          "type"
+        ],
+        "returns": "Promise<R>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "ws.on('connection', async (client) => {\n const info = await ws.ask(client, 'identify')\n console.log('Client says:', info)\n})"
+          }
+        ]
+      },
+      "_handleReply": {
+        "description": "",
+        "parameters": {
+          "message": {
+            "type": "any",
+            "description": "Parameter message"
+          }
+        },
+        "required": [
+          "message"
+        ],
+        "returns": "boolean"
+      },
+      "_rejectAllPending": {
+        "description": "",
+        "parameters": {
+          "reason": {
+            "type": "string",
+            "description": "Parameter reason"
+          }
+        },
+        "required": [
+          "reason"
+        ],
+        "returns": "void"
+      },
       "start": {
         "description": "Start the WebSocket server. A runtime `port` overrides the constructor option and is written to state before the underlying `ws.Server` is created, so the server binds to the correct port.",
         "parameters": {
@@ -25245,7 +25895,7 @@ export const introspectionData = [
     "examples": [
       {
         "language": "ts",
-        "code": "const ws = container.server('websocket', { json: true })\nawait ws.start({ port: 8080 })\n\nws.on('message', (data, client) => {\n console.log('Received:', data)\n ws.broadcast({ echo: data })\n})"
+        "code": "const ws = container.server('websocket', { json: true })\nawait ws.start({ port: 8080 })\n\nws.on('message', (data, client) => {\n console.log('Received:', data)\n ws.broadcast({ echo: data })\n})\n\n// ask/reply: request info from a connected client\nws.on('connection', async (client) => {\n const info = await ws.ask(client, 'identify')\n console.log('Client says:', info)\n})"
       }
     ]
   },
@@ -25505,6 +26155,10 @@ export const introspectionData = [
               "maxTokens": {
                 "type": "number",
                 "description": ""
+              },
+              "schema": {
+                "type": "z.ZodType",
+                "description": "When provided, enables OpenAI Structured Outputs. The model is constrained to return JSON matching this Zod schema. The return value of ask() will be the parsed object instead of a raw string."
               }
             }
           }
@@ -25622,6 +26276,21 @@ export const introspectionData = [
         "description": "Event emitted by Conversation",
         "arguments": {}
       },
+      "toolError": {
+        "name": "toolError",
+        "description": "Event emitted by Conversation",
+        "arguments": {}
+      },
+      "toolCall": {
+        "name": "toolCall",
+        "description": "Event emitted by Conversation",
+        "arguments": {}
+      },
+      "toolResult": {
+        "name": "toolResult",
+        "description": "Event emitted by Conversation",
+        "arguments": {}
+      },
       "turnStart": {
         "name": "turnStart",
         "description": "Event emitted by Conversation",
@@ -25657,21 +26326,6 @@ export const introspectionData = [
         "description": "Event emitted by Conversation",
         "arguments": {}
       },
-      "toolError": {
-        "name": "toolError",
-        "description": "Event emitted by Conversation",
-        "arguments": {}
-      },
-      "toolCall": {
-        "name": "toolCall",
-        "description": "Event emitted by Conversation",
-        "arguments": {}
-      },
-      "toolResult": {
-        "name": "toolResult",
-        "description": "Event emitted by Conversation",
-        "arguments": {}
-      },
       "toolCallsEnd": {
         "name": "toolCallsEnd",
         "description": "Event emitted by Conversation",
@@ -26087,12 +26741,61 @@ export const introspectionData = [
     "shortcut": "features.assistant",
     "className": "Assistant",
     "methods": {
+      "intercept": {
+        "description": "Register an interceptor at a given point in the pipeline.",
+        "parameters": {
+          "point": {
+            "type": "K",
+            "description": "The interception point"
+          },
+          "fn": {
+            "type": "InterceptorFn<InterceptorPoints[K]>",
+            "description": "Middleware function receiving (ctx, next)"
+          }
+        },
+        "required": [
+          "point",
+          "fn"
+        ],
+        "returns": "this"
+      },
       "afterInitialize": {
         "description": "Called immediately after the assistant is constructed. Synchronously loads the system prompt, tools, and hooks, then binds hooks as event listeners so every emitted event automatically invokes its corresponding hook.",
         "parameters": {},
         "required": [],
         "returns": "void"
       },
+      "addSystemPromptExtension": {
+        "description": "Add or update a named system prompt extension. The value is appended to the base system prompt when passed to the conversation.",
+        "parameters": {
+          "key": {
+            "type": "string",
+            "description": "A unique identifier for this extension"
+          },
+          "value": {
+            "type": "string",
+            "description": "The text to append"
+          }
+        },
+        "required": [
+          "key",
+          "value"
+        ],
+        "returns": "this"
+      },
+      "removeSystemPromptExtension": {
+        "description": "Remove a named system prompt extension.",
+        "parameters": {
+          "key": {
+            "type": "string",
+            "description": "The identifier of the extension to remove"
+          }
+        },
+        "required": [
+          "key"
+        ],
+        "returns": "this"
+      },
       "use": {
         "description": "Apply a setup function or a Helper instance to this assistant. When passed a function, it receives the assistant and can configure tools, hooks, event listeners, etc. When passed a Helper instance that exposes tools via toTools(), those tools are automatically added to this assistant.",
         "parameters": {
@@ -26363,6 +27066,14 @@ export const introspectionData = [
         "description": "The current system prompt text.",
         "returns": "string"
       },
+      "systemPromptExtensions": {
+        "description": "The named extensions appended to the system prompt.",
+        "returns": "Record<string, string>"
+      },
+      "effectiveSystemPrompt": {
+        "description": "The system prompt with all extensions appended. This is the value passed to the conversation.",
+        "returns": "string"
+      },
       "tools": {
         "description": "The tools registered with this assistant.",
         "returns": "Record<string, ConversationTool>"
@@ -26406,6 +27117,11 @@ export const introspectionData = [
         "description": "Event emitted by Assistant",
         "arguments": {}
       },
+      "systemPromptExtensionsChanged": {
+        "name": "systemPromptExtensionsChanged",
+        "description": "Event emitted by Assistant",
+        "arguments": {}
+      },
       "toolsChanged": {
         "name": "toolsChanged",
         "description": "Event emitted by Assistant",