@soederpop/luca 0.0.25 → 0.0.28

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-22T06:53:17.303Z
+// Generated at: 2026-03-23T07:45:57.079Z
 
 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",
@@ -5298,6 +5322,23 @@ setBuildTimeData('features.fs', {
         }
       ]
     },
+    "readFileSync": {
+      "description": "Synchronously reads a file and returns its contents as a string. added this method because AI Assistants are understandly confused by this deviation from 2000's era node style",
+      "parameters": {
+        "path": {
+          "type": "string",
+          "description": "Parameter path"
+        },
+        "encoding": {
+          "type": "BufferEncoding | null",
+          "description": "Parameter encoding"
+        }
+      },
+      "required": [
+        "path"
+      ],
+      "returns": "string | Buffer"
+    },
     "readFileAsync": {
       "description": "Asynchronously reads a file and returns its contents as a string.",
       "parameters": {
@@ -5340,6 +5381,19 @@ setBuildTimeData('features.fs', {
         }
       ]
     },
+    "readJsonSync": {
+      "description": "Read and parse a JSON file synchronously",
+      "parameters": {
+        "path": {
+          "type": "string",
+          "description": "Parameter path"
+        }
+      },
+      "required": [
+        "path"
+      ],
+      "returns": "void"
+    },
     "readJsonAsync": {
       "description": "Asynchronously reads and parses a JSON file.",
       "parameters": {
@@ -6193,7 +6247,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": {
@@ -6233,61 +6287,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": {
@@ -6299,12 +6419,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",
@@ -7225,10 +7358,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": {
@@ -7406,7 +7597,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"
     }
   ]
 });
@@ -9495,6 +9686,14 @@ setBuildTimeData('features.contentDb', {
       "description": "Returns the available document ids in the collection",
       "returns": "string[]"
     },
+    "modelDefinitionTable": {
+      "description": "",
+      "returns": "any"
+    },
+    "fileTree": {
+      "description": "",
+      "returns": "any"
+    },
     "searchIndexStatus": {
       "description": "Get the current search index status.",
       "returns": "any"
@@ -9767,7 +9966,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": {
@@ -9790,6 +9989,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": {},
@@ -9832,13 +10084,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', {
@@ -10109,26 +10355,222 @@ setBuildTimeData('clients.openai', {
   ]
 });
 
-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('clients.supabase', {
+  "id": "clients.supabase",
+  "description": "Supabase client for the Luca container system. Wraps the official `@supabase/supabase-js` SDK and exposes it through Luca's typed state, events, and introspection system. The SDK is isomorphic so this single implementation works in both Node and browser containers. Use `client.sdk` for full SDK access, or use the convenience wrappers for common operations (auth, database queries, storage, edge functions, realtime).",
+  "shortcut": "clients.supabase",
+  "className": "SupabaseClient",
   "methods": {
-    "beforeRequest": {
-      "description": "Inject the xi-api-key header before each request.",
-      "parameters": {},
-      "required": [],
+    "from": {
+      "description": "Start a query on a Postgres table or view.",
+      "parameters": {
+        "table": {
+          "type": "string",
+          "description": "The table or view name to query"
+        }
+      },
+      "required": [
+        "table"
+      ],
       "returns": "void"
     },
-    "connect": {
-      "description": "Validate the API key by listing available models.",
-      "parameters": {},
-      "required": [],
-      "returns": "Promise<this>",
-      "examples": [
-        {
-          "language": "ts",
+    "rpc": {
+      "description": "Call a Postgres function (RPC).",
+      "parameters": {
+        "fn": {
+          "type": "string",
+          "description": "The function name"
+        },
+        "params": {
+          "type": "Record<string, unknown>",
+          "description": "Arguments to pass to the function"
+        },
+        "options": {
+          "type": "{ head?: boolean; get?: boolean; count?: \"exact\" | \"planned\" | \"estimated\" }",
+          "description": "Optional settings (head, get, count)"
+        }
+      },
+      "required": [
+        "fn"
+      ],
+      "returns": "void"
+    },
+    "signInWithPassword": {
+      "description": "Sign in with email and password.",
+      "parameters": {
+        "email": {
+          "type": "string",
+          "description": "Parameter email"
+        },
+        "password": {
+          "type": "string",
+          "description": "Parameter password"
+        }
+      },
+      "required": [
+        "email",
+        "password"
+      ],
+      "returns": "void"
+    },
+    "signUp": {
+      "description": "Create a new user account with email and password.",
+      "parameters": {
+        "email": {
+          "type": "string",
+          "description": "Parameter email"
+        },
+        "password": {
+          "type": "string",
+          "description": "Parameter password"
+        }
+      },
+      "required": [
+        "email",
+        "password"
+      ],
+      "returns": "void"
+    },
+    "signOut": {
+      "description": "Sign the current user out.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "getSession": {
+      "description": "Get the current session, if any.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "getUser": {
+      "description": "Get the current user, if any.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "invoke": {
+      "description": "Invoke a Supabase Edge Function by name.",
+      "parameters": {
+        "name": {
+          "type": "string",
+          "description": "Parameter name"
+        },
+        "body": {
+          "type": "any",
+          "description": "Parameter body"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "returns": "void"
+    },
+    "subscribe": {
+      "description": "Subscribe to realtime changes on a Postgres table.",
+      "parameters": {
+        "channelName": {
+          "type": "string",
+          "description": "A name for this subscription channel"
+        },
+        "table": {
+          "type": "string",
+          "description": "The table to listen to"
+        },
+        "callback": {
+          "type": "(payload: any) => void",
+          "description": "Called with the payload on each change"
+        },
+        "event": {
+          "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
+          "description": "The event type to listen for (default: all changes)"
+        }
+      },
+      "required": [
+        "channelName",
+        "table",
+        "callback"
+      ],
+      "returns": "RealtimeChannel"
+    },
+    "unsubscribe": {
+      "description": "Unsubscribe and remove a realtime channel by name.",
+      "parameters": {
+        "channelName": {
+          "type": "string",
+          "description": "The channel name to remove"
+        }
+      },
+      "required": [
+        "channelName"
+      ],
+      "returns": "void"
+    },
+    "unsubscribeAll": {
+      "description": "Unsubscribe and remove all realtime channels.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "connect": {
+      "description": "Connect is a no-op since the Supabase SDK initializes on construction. The client is ready to use immediately after creation.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "disconnect": {
+      "description": "Disconnect by signing out and removing all realtime channels.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    }
+  },
+  "getters": {
+    "sdk": {
+      "description": "Returns the raw Supabase SDK client for full access to all SDK methods.",
+      "returns": "SupabaseSDKClient<any, any>"
+    },
+    "storage": {
+      "description": "Returns the Supabase Storage client for managing buckets and files.",
+      "returns": "any"
+    },
+    "functions": {
+      "description": "Returns the Supabase Functions client.",
+      "returns": "any"
+    }
+  },
+  "events": {},
+  "state": {},
+  "options": {},
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const supabase = container.client('supabase', {\n supabaseUrl: 'https://xyz.supabase.co',\n supabaseKey: 'your-anon-key',\n})\n\n// Query data\nconst { data } = await supabase.from('users').select('*')\n\n// Auth\nawait supabase.signInWithPassword('user@example.com', 'password')\n\n// Realtime\nsupabase.subscribe('changes', 'users', (payload) => {\n console.log('Change:', payload)\n})"
+    }
+  ]
+});
+
+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": {
+    "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()"
         }
       ]
@@ -10311,243 +10753,47 @@ setBuildTimeData('clients.elevenlabs', {
   ]
 });
 
-setBuildTimeData('clients.supabase', {
-  "id": "clients.supabase",
-  "description": "Supabase client for the Luca container system. Wraps the official `@supabase/supabase-js` SDK and exposes it through Luca's typed state, events, and introspection system. The SDK is isomorphic so this single implementation works in both Node and browser containers. Use `client.sdk` for full SDK access, or use the convenience wrappers for common operations (auth, database queries, storage, edge functions, realtime).",
-  "shortcut": "clients.supabase",
-  "className": "SupabaseClient",
+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": {
-    "from": {
-      "description": "Start a query on a Postgres table or view.",
+    "queuePrompt": {
+      "description": "Queue a prompt (API-format workflow) for execution.",
       "parameters": {
-        "table": {
+        "prompt": {
+          "type": "Record<string, any>",
+          "description": "The API-format workflow object"
+        },
+        "clientId": {
           "type": "string",
-          "description": "The table or view name to query"
+          "description": "Override the client ID for this request"
         }
       },
       "required": [
-        "table"
+        "prompt"
       ],
-      "returns": "void"
+      "returns": "Promise<{ prompt_id: string; number: number }>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const { prompt_id } = await comfy.queuePrompt(apiWorkflow)"
+        }
+      ]
     },
-    "rpc": {
-      "description": "Call a Postgres function (RPC).",
+    "getQueue": {
+      "description": "Get the current prompt queue status.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<{ queue_running: any[]; queue_pending: any[] }>"
+    },
+    "getHistory": {
+      "description": "Get execution history, optionally for a specific prompt.",
       "parameters": {
-        "fn": {
+        "promptId": {
           "type": "string",
-          "description": "The function name"
-        },
-        "params": {
-          "type": "Record<string, unknown>",
-          "description": "Arguments to pass to the function"
-        },
-        "options": {
-          "type": "{ head?: boolean; get?: boolean; count?: \"exact\" | \"planned\" | \"estimated\" }",
-          "description": "Optional settings (head, get, count)"
-        }
-      },
-      "required": [
-        "fn"
-      ],
-      "returns": "void"
-    },
-    "signInWithPassword": {
-      "description": "Sign in with email and password.",
-      "parameters": {
-        "email": {
-          "type": "string",
-          "description": "Parameter email"
-        },
-        "password": {
-          "type": "string",
-          "description": "Parameter password"
-        }
-      },
-      "required": [
-        "email",
-        "password"
-      ],
-      "returns": "void"
-    },
-    "signUp": {
-      "description": "Create a new user account with email and password.",
-      "parameters": {
-        "email": {
-          "type": "string",
-          "description": "Parameter email"
-        },
-        "password": {
-          "type": "string",
-          "description": "Parameter password"
-        }
-      },
-      "required": [
-        "email",
-        "password"
-      ],
-      "returns": "void"
-    },
-    "signOut": {
-      "description": "Sign the current user out.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "getSession": {
-      "description": "Get the current session, if any.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "getUser": {
-      "description": "Get the current user, if any.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "invoke": {
-      "description": "Invoke a Supabase Edge Function by name.",
-      "parameters": {
-        "name": {
-          "type": "string",
-          "description": "Parameter name"
-        },
-        "body": {
-          "type": "any",
-          "description": "Parameter body"
-        }
-      },
-      "required": [
-        "name"
-      ],
-      "returns": "void"
-    },
-    "subscribe": {
-      "description": "Subscribe to realtime changes on a Postgres table.",
-      "parameters": {
-        "channelName": {
-          "type": "string",
-          "description": "A name for this subscription channel"
-        },
-        "table": {
-          "type": "string",
-          "description": "The table to listen to"
-        },
-        "callback": {
-          "type": "(payload: any) => void",
-          "description": "Called with the payload on each change"
-        },
-        "event": {
-          "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
-          "description": "The event type to listen for (default: all changes)"
-        }
-      },
-      "required": [
-        "channelName",
-        "table",
-        "callback"
-      ],
-      "returns": "RealtimeChannel"
-    },
-    "unsubscribe": {
-      "description": "Unsubscribe and remove a realtime channel by name.",
-      "parameters": {
-        "channelName": {
-          "type": "string",
-          "description": "The channel name to remove"
-        }
-      },
-      "required": [
-        "channelName"
-      ],
-      "returns": "void"
-    },
-    "unsubscribeAll": {
-      "description": "Unsubscribe and remove all realtime channels.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "connect": {
-      "description": "Connect is a no-op since the Supabase SDK initializes on construction. The client is ready to use immediately after creation.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "disconnect": {
-      "description": "Disconnect by signing out and removing all realtime channels.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    }
-  },
-  "getters": {
-    "sdk": {
-      "description": "Returns the raw Supabase SDK client for full access to all SDK methods.",
-      "returns": "SupabaseSDKClient<any, any>"
-    },
-    "storage": {
-      "description": "Returns the Supabase Storage client for managing buckets and files.",
-      "returns": "any"
-    },
-    "functions": {
-      "description": "Returns the Supabase Functions client.",
-      "returns": "any"
-    }
-  },
-  "events": {},
-  "state": {},
-  "options": {},
-  "envVars": [],
-  "examples": [
-    {
-      "language": "ts",
-      "code": "const supabase = container.client('supabase', {\n supabaseUrl: 'https://xyz.supabase.co',\n supabaseKey: 'your-anon-key',\n})\n\n// Query data\nconst { data } = await supabase.from('users').select('*')\n\n// Auth\nawait supabase.signInWithPassword('user@example.com', 'password')\n\n// Realtime\nsupabase.subscribe('changes', 'users', (payload) => {\n console.log('Change:', payload)\n})"
-    }
-  ]
-});
-
-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[] }>"
-    },
-    "getHistory": {
-      "description": "Get execution history, optionally for a specific prompt.",
-      "parameters": {
-        "promptId": {
-          "type": "string",
-          "description": "If provided, returns history for this prompt only"
+          "description": "If provided, returns history for this prompt only"
         }
       },
       "required": [],
@@ -11043,7 +11289,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": {
@@ -11078,6 +11324,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": {
@@ -11124,7 +11428,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})"
     }
   ]
 });
@@ -11978,16 +12282,47 @@ setBuildTimeData('features.assistant', {
       "required": [],
       "returns": "void"
     },
-    "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.",
+    "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": {
-        "fnOrHelper": {
-          "type": "((assistant: this) => void | Promise<void>) | { toTools: () => { schemas: Record<string, z.ZodType>, handlers: Record<string, Function> } }",
-          "description": "Setup function or Helper instance"
+        "key": {
+          "type": "string",
+          "description": "A unique identifier for this extension"
+        },
+        "value": {
+          "type": "string",
+          "description": "The text to append"
         }
       },
       "required": [
-        "fnOrHelper"
+        "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": {
+        "fnOrHelper": {
+          "type": "((assistant: this) => void | Promise<void>) | { toTools: () => { schemas: Record<string, z.ZodType>, handlers: Record<string, Function> } } | { schemas: Record<string, z.ZodType>, handlers: Record<string, Function> }",
+          "description": "Setup function or Helper instance"
+        }
+      },
+      "required": [
+        "fnOrHelper"
       ],
       "returns": "this",
       "examples": [
@@ -12248,6 +12583,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>"
@@ -12291,6 +12634,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",
@@ -13960,6 +14308,10 @@ setContainerBuildTimeData('Container', {
       "description": "Returns a map of enabled feature shortcut IDs to their instances.",
       "returns": "Partial<AvailableInstanceTypes<Features>>"
     },
+    "describer": {
+      "description": "Lazy-initialized ContainerDescriber for introspecting registries, helpers, and members.",
+      "returns": "ContainerDescriber"
+    },
     "context": {
       "description": "The Container's context is an object that contains the enabled features, the container itself, and any additional context that has been added to the container. All helper instances that are created by the container will have access to the shared context.",
       "returns": "ContainerContext<Features> & Partial<AvailableInstanceTypes<AvailableFeatures>>"
@@ -15611,7 +15963,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": {
@@ -15627,7 +15979,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",
@@ -15635,10 +15998,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>"
@@ -15911,7 +16274,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>",
@@ -15925,12 +16288,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"
       }
     },
@@ -15965,6 +16336,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",
@@ -19364,6 +19740,23 @@ export const introspectionData = [
           }
         ]
       },
+      "readFileSync": {
+        "description": "Synchronously reads a file and returns its contents as a string. added this method because AI Assistants are understandly confused by this deviation from 2000's era node style",
+        "parameters": {
+          "path": {
+            "type": "string",
+            "description": "Parameter path"
+          },
+          "encoding": {
+            "type": "BufferEncoding | null",
+            "description": "Parameter encoding"
+          }
+        },
+        "required": [
+          "path"
+        ],
+        "returns": "string | Buffer"
+      },
       "readFileAsync": {
         "description": "Asynchronously reads a file and returns its contents as a string.",
         "parameters": {
@@ -19406,6 +19799,19 @@ export const introspectionData = [
           }
         ]
       },
+      "readJsonSync": {
+        "description": "Read and parse a JSON file synchronously",
+        "parameters": {
+          "path": {
+            "type": "string",
+            "description": "Parameter path"
+          }
+        },
+        "required": [
+          "path"
+        ],
+        "returns": "void"
+      },
       "readJsonAsync": {
         "description": "Asynchronously reads and parses a JSON file.",
         "parameters": {
@@ -20258,7 +20664,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": {
@@ -20298,61 +20704,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": {
@@ -20364,12 +20836,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",
@@ -21284,10 +21769,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": {
@@ -21465,7 +22008,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"
       }
     ]
   },
@@ -23546,6 +24089,14 @@ export const introspectionData = [
         "description": "Returns the available document ids in the collection",
         "returns": "string[]"
       },
+      "modelDefinitionTable": {
+        "description": "",
+        "returns": "any"
+      },
+      "fileTree": {
+        "description": "",
+        "returns": "any"
+      },
       "searchIndexStatus": {
         "description": "Get the current search index status.",
         "returns": "any"
@@ -23815,7 +24366,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": {
@@ -23838,6 +24389,59 @@ export const introspectionData = [
         ],
         "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": {},
@@ -23880,13 +24484,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",
@@ -24155,207 +24753,6 @@ 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.supabase",
     "description": "Supabase client for the Luca container system. Wraps the official `@supabase/supabase-js` SDK and exposes it through Luca's typed state, events, and introspection system. The SDK is isomorphic so this single implementation works in both Node and browser containers. Use `client.sdk` for full SDK access, or use the convenience wrappers for common operations (auth, database queries, storage, edge functions, realtime).",
@@ -24444,110 +24841,311 @@ export const introspectionData = [
         "required": [],
         "returns": "void"
       },
-      "getUser": {
-        "description": "Get the current user, if any.",
+      "getUser": {
+        "description": "Get the current user, if any.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "invoke": {
+        "description": "Invoke a Supabase Edge Function by name.",
+        "parameters": {
+          "name": {
+            "type": "string",
+            "description": "Parameter name"
+          },
+          "body": {
+            "type": "any",
+            "description": "Parameter body"
+          }
+        },
+        "required": [
+          "name"
+        ],
+        "returns": "void"
+      },
+      "subscribe": {
+        "description": "Subscribe to realtime changes on a Postgres table.",
+        "parameters": {
+          "channelName": {
+            "type": "string",
+            "description": "A name for this subscription channel"
+          },
+          "table": {
+            "type": "string",
+            "description": "The table to listen to"
+          },
+          "callback": {
+            "type": "(payload: any) => void",
+            "description": "Called with the payload on each change"
+          },
+          "event": {
+            "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
+            "description": "The event type to listen for (default: all changes)"
+          }
+        },
+        "required": [
+          "channelName",
+          "table",
+          "callback"
+        ],
+        "returns": "RealtimeChannel"
+      },
+      "unsubscribe": {
+        "description": "Unsubscribe and remove a realtime channel by name.",
+        "parameters": {
+          "channelName": {
+            "type": "string",
+            "description": "The channel name to remove"
+          }
+        },
+        "required": [
+          "channelName"
+        ],
+        "returns": "void"
+      },
+      "unsubscribeAll": {
+        "description": "Unsubscribe and remove all realtime channels.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "connect": {
+        "description": "Connect is a no-op since the Supabase SDK initializes on construction. The client is ready to use immediately after creation.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "disconnect": {
+        "description": "Disconnect by signing out and removing all realtime channels.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      }
+    },
+    "getters": {
+      "sdk": {
+        "description": "Returns the raw Supabase SDK client for full access to all SDK methods.",
+        "returns": "SupabaseSDKClient<any, any>"
+      },
+      "storage": {
+        "description": "Returns the Supabase Storage client for managing buckets and files.",
+        "returns": "any"
+      },
+      "functions": {
+        "description": "Returns the Supabase Functions client.",
+        "returns": "any"
+      }
+    },
+    "events": {},
+    "state": {},
+    "options": {},
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const supabase = container.client('supabase', {\n supabaseUrl: 'https://xyz.supabase.co',\n supabaseKey: 'your-anon-key',\n})\n\n// Query data\nconst { data } = await supabase.from('users').select('*')\n\n// Auth\nawait supabase.signInWithPassword('user@example.com', 'password')\n\n// Realtime\nsupabase.subscribe('changes', 'users', (payload) => {\n console.log('Change:', payload)\n})"
+      }
+    ]
+  },
+  {
+    "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": "void"
+        "returns": "Promise<any[]>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const models = await el.listModels()\nconsole.log(models.map(m => m.model_id))"
+          }
+        ]
       },
-      "invoke": {
-        "description": "Invoke a Supabase Edge Function by name.",
+      "synthesize": {
+        "description": "Synthesize speech from text, returning audio as a Buffer.",
         "parameters": {
-          "name": {
+          "text": {
             "type": "string",
-            "description": "Parameter name"
+            "description": "The text to convert to speech"
           },
-          "body": {
-            "type": "any",
-            "description": "Parameter body"
+          "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": [
-          "name"
+          "text"
         ],
-        "returns": "void"
+        "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})"
+          }
+        ]
       },
-      "subscribe": {
-        "description": "Subscribe to realtime changes on a Postgres table.",
+      "say": {
+        "description": "Synthesize speech and write the audio to a file.",
         "parameters": {
-          "channelName": {
+          "text": {
             "type": "string",
-            "description": "A name for this subscription channel"
+            "description": "The text to convert to speech"
           },
-          "table": {
+          "outputPath": {
             "type": "string",
-            "description": "The table to listen to"
-          },
-          "callback": {
-            "type": "(payload: any) => void",
-            "description": "Called with the payload on each change"
+            "description": "File path to write the audio to"
           },
-          "event": {
-            "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
-            "description": "The event type to listen for (default: all changes)"
+          "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": [
-          "channelName",
-          "table",
-          "callback"
+          "text",
+          "outputPath"
         ],
-        "returns": "RealtimeChannel"
-      },
-      "unsubscribe": {
-        "description": "Unsubscribe and remove a realtime channel by name.",
-        "parameters": {
-          "channelName": {
-            "type": "string",
-            "description": "The channel name to remove"
+        "returns": "Promise<string>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const path = await el.say('Hello world', './hello.mp3')\nconsole.log(`Audio saved to ${path}`)"
           }
-        },
-        "required": [
-          "channelName"
-        ],
-        "returns": "void"
-      },
-      "unsubscribeAll": {
-        "description": "Unsubscribe and remove all realtime channels.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "connect": {
-        "description": "Connect is a no-op since the Supabase SDK initializes on construction. The client is ready to use immediately after creation.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "disconnect": {
-        "description": "Disconnect by signing out and removing all realtime channels.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
+        ]
       }
     },
     "getters": {
-      "sdk": {
-        "description": "Returns the raw Supabase SDK client for full access to all SDK methods.",
-        "returns": "SupabaseSDKClient<any, any>"
+      "apiKey": {
+        "description": "The resolved API key from options or environment.",
+        "returns": "string"
+      }
+    },
+    "events": {
+      "failure": {
+        "name": "failure",
+        "description": "Event emitted by ElevenLabsClient",
+        "arguments": {}
       },
-      "storage": {
-        "description": "Returns the Supabase Storage client for managing buckets and files.",
-        "returns": "any"
+      "voices": {
+        "name": "voices",
+        "description": "Event emitted by ElevenLabsClient",
+        "arguments": {}
       },
-      "functions": {
-        "description": "Returns the Supabase Functions client.",
-        "returns": "any"
+      "speech": {
+        "name": "speech",
+        "description": "Event emitted by ElevenLabsClient",
+        "arguments": {}
       }
     },
-    "events": {},
     "state": {},
     "options": {},
     "envVars": [],
     "examples": [
       {
         "language": "ts",
-        "code": "const supabase = container.client('supabase', {\n supabaseUrl: 'https://xyz.supabase.co',\n supabaseKey: 'your-anon-key',\n})\n\n// Query data\nconst { data } = await supabase.from('users').select('*')\n\n// Auth\nawait supabase.signInWithPassword('user@example.com', 'password')\n\n// Realtime\nsupabase.subscribe('changes', 'users', (payload) => {\n console.log('Change:', payload)\n})"
+        "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"
       }
     ]
   },
@@ -25084,7 +25682,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": {
@@ -25119,6 +25717,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": {
@@ -25165,7 +25821,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})"
       }
     ]
   },
@@ -26013,11 +26669,42 @@ export const introspectionData = [
         "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": {
           "fnOrHelper": {
-            "type": "((assistant: this) => void | Promise<void>) | { toTools: () => { schemas: Record<string, z.ZodType>, handlers: Record<string, Function> } }",
+            "type": "((assistant: this) => void | Promise<void>) | { toTools: () => { schemas: Record<string, z.ZodType>, handlers: Record<string, Function> } } | { schemas: Record<string, z.ZodType>, handlers: Record<string, Function> }",
             "description": "Setup function or Helper instance"
           }
         },
@@ -26283,6 +26970,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>"
@@ -26326,6 +27021,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",
@@ -27993,6 +28693,10 @@ export const containerIntrospectionData = [
         "description": "Returns a map of enabled feature shortcut IDs to their instances.",
         "returns": "Partial<AvailableInstanceTypes<Features>>"
       },
+      "describer": {
+        "description": "Lazy-initialized ContainerDescriber for introspecting registries, helpers, and members.",
+        "returns": "ContainerDescriber"
+      },
       "context": {
         "description": "The Container's context is an object that contains the enabled features, the container itself, and any additional context that has been added to the container. All helper instances that are created by the container will have access to the shared context.",
         "returns": "ContainerContext<Features> & Partial<AvailableInstanceTypes<AvailableFeatures>>"