@soederpop/luca 0.0.32 → 0.0.35

package/src/introspection/generated.node.ts

@@ -1,7 +1,7 @@
 import { setBuildTimeData, setContainerBuildTimeData } from './index.js';
 
 // Auto-generated introspection registry data
-// Generated at: 2026-03-24T09:09:09.885Z
+// Generated at: 2026-03-27T03:29:26.519Z
 
 setBuildTimeData('features.googleDocs', {
   "id": "features.googleDocs",
@@ -5927,6 +5927,312 @@ setBuildTimeData('features.googleCalendar', {
   }
 });
 
+setBuildTimeData('features.redis', {
+  "id": "features.redis",
+  "description": "Redis feature for shared state and pub/sub communication between container instances. Wraps ioredis with a focused API for the primitives that matter most: key/value state, pub/sub messaging, and cross-instance coordination. Uses a dedicated subscriber connection for pub/sub (ioredis requirement), created lazily on first subscribe call.",
+  "shortcut": "features.redis",
+  "className": "RedisFeature",
+  "methods": {
+    "set": {
+      "description": "Set a key to a string value with optional TTL.",
+      "parameters": {
+        "key": {
+          "type": "string",
+          "description": "The key name"
+        },
+        "value": {
+          "type": "string",
+          "description": "The string value to store"
+        },
+        "ttl": {
+          "type": "number",
+          "description": "Optional time-to-live in seconds"
+        }
+      },
+      "required": [
+        "key",
+        "value"
+      ],
+      "returns": "Promise<void>"
+    },
+    "get": {
+      "description": "Get a key's value. Returns null if the key doesn't exist.",
+      "parameters": {
+        "key": {
+          "type": "string",
+          "description": "The key name"
+        }
+      },
+      "required": [
+        "key"
+      ],
+      "returns": "Promise<string | null>"
+    },
+    "del": {
+      "description": "Delete one or more keys.",
+      "parameters": {
+        "keys": {
+          "type": "string[]",
+          "description": "One or more key names to delete"
+        }
+      },
+      "required": [
+        "keys"
+      ],
+      "returns": "Promise<number>"
+    },
+    "exists": {
+      "description": "Check if a key exists.",
+      "parameters": {
+        "key": {
+          "type": "string",
+          "description": "The key name"
+        }
+      },
+      "required": [
+        "key"
+      ],
+      "returns": "Promise<boolean>"
+    },
+    "expire": {
+      "description": "Set a key's TTL in seconds.",
+      "parameters": {
+        "key": {
+          "type": "string",
+          "description": "The key name"
+        },
+        "seconds": {
+          "type": "number",
+          "description": "TTL in seconds"
+        }
+      },
+      "required": [
+        "key",
+        "seconds"
+      ],
+      "returns": "Promise<boolean>"
+    },
+    "keys": {
+      "description": "Find keys matching a glob pattern (respects prefix).",
+      "parameters": {
+        "pattern": {
+          "type": "string",
+          "description": "Glob pattern, e.g. \"worker:*\""
+        }
+      },
+      "required": [],
+      "returns": "Promise<string[]>"
+    },
+    "setJSON": {
+      "description": "Store a value as JSON.",
+      "parameters": {
+        "key": {
+          "type": "string",
+          "description": "The key name"
+        },
+        "value": {
+          "type": "unknown",
+          "description": "Any JSON-serializable value"
+        },
+        "ttl": {
+          "type": "number",
+          "description": "Optional TTL in seconds"
+        }
+      },
+      "required": [
+        "key",
+        "value"
+      ],
+      "returns": "Promise<void>"
+    },
+    "getJSON": {
+      "description": "Retrieve and parse a JSON value.",
+      "parameters": {
+        "key": {
+          "type": "string",
+          "description": "The key name"
+        }
+      },
+      "required": [
+        "key"
+      ],
+      "returns": "Promise<T | null>"
+    },
+    "hset": {
+      "description": "Set fields on a hash.",
+      "parameters": {
+        "key": {
+          "type": "string",
+          "description": "The hash key"
+        },
+        "fields": {
+          "type": "Record<string, string>",
+          "description": "Object of field/value pairs"
+        }
+      },
+      "required": [
+        "key",
+        "fields"
+      ],
+      "returns": "Promise<void>"
+    },
+    "hgetall": {
+      "description": "Get all fields from a hash.",
+      "parameters": {
+        "key": {
+          "type": "string",
+          "description": "The hash key"
+        }
+      },
+      "required": [
+        "key"
+      ],
+      "returns": "Promise<Record<string, string>>"
+    },
+    "hget": {
+      "description": "Get a single field from a hash.",
+      "parameters": {
+        "key": {
+          "type": "string",
+          "description": "The hash key"
+        },
+        "field": {
+          "type": "string",
+          "description": "The field name"
+        }
+      },
+      "required": [
+        "key",
+        "field"
+      ],
+      "returns": "Promise<string | null>"
+    },
+    "subscribe": {
+      "description": "Subscribe to one or more channels. Optionally pass a handler that fires only for these channels. The feature also emits a `message` event for all messages.",
+      "parameters": {
+        "channels": {
+          "type": "string | string[]",
+          "description": "Channel name(s) to subscribe to"
+        },
+        "handler": {
+          "type": "MessageHandler",
+          "description": "Optional per-channel message handler"
+        }
+      },
+      "required": [
+        "channels"
+      ],
+      "returns": "Promise<void>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "await redis.subscribe('tasks', (channel, msg) => {\n console.log(`Got ${msg} on ${channel}`)\n})"
+        }
+      ]
+    },
+    "unsubscribe": {
+      "description": "Unsubscribe from one or more channels.",
+      "parameters": {
+        "channels": {
+          "type": "string[]",
+          "description": "Channel name(s) to unsubscribe from"
+        }
+      },
+      "required": [
+        "channels"
+      ],
+      "returns": "Promise<void>"
+    },
+    "publish": {
+      "description": "Publish a message to a channel.",
+      "parameters": {
+        "channel": {
+          "type": "string",
+          "description": "The channel to publish to"
+        },
+        "message": {
+          "type": "string",
+          "description": "The message string (use JSON.stringify for objects)"
+        }
+      },
+      "required": [
+        "channel",
+        "message"
+      ],
+      "returns": "Promise<number>"
+    },
+    "ensureLocalDocker": {
+      "description": "Spin up a local Redis instance via Docker. Checks if a container with the given name already exists and starts it if stopped, or creates a new one from redis:alpine. Requires the docker feature to be available on the container.",
+      "parameters": {
+        "options": {
+          "type": "{ name?: string; port?: number; image?: string }",
+          "description": "Container name and host port"
+        }
+      },
+      "required": [],
+      "returns": "Promise<string>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const redis = container.feature('redis', { url: 'redis://localhost:6379', lazyConnect: true })\nawait redis.ensureLocalDocker()"
+        }
+      ]
+    },
+    "close": {
+      "description": "Close all redis connections (main client + subscriber).",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<this>"
+    }
+  },
+  "getters": {
+    "client": {
+      "description": "The underlying ioredis client for advanced operations.",
+      "returns": "Redis"
+    },
+    "subscriber": {
+      "description": "The dedicated subscriber connection, if pub/sub is active.",
+      "returns": "Redis | null"
+    }
+  },
+  "events": {
+    "message": {
+      "name": "message",
+      "description": "Event emitted by RedisFeature",
+      "arguments": {}
+    },
+    "error": {
+      "name": "error",
+      "description": "Event emitted by RedisFeature",
+      "arguments": {}
+    },
+    "subscribed": {
+      "name": "subscribed",
+      "description": "Event emitted by RedisFeature",
+      "arguments": {}
+    },
+    "unsubscribed": {
+      "name": "unsubscribed",
+      "description": "Event emitted by RedisFeature",
+      "arguments": {}
+    },
+    "closed": {
+      "name": "closed",
+      "description": "Event emitted by RedisFeature",
+      "arguments": {}
+    }
+  },
+  "state": {},
+  "options": {},
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const redis = container.feature('redis', { url: 'redis://localhost:6379' })\n\n// Shared state\nawait redis.set('worker:status', 'active')\nconst status = await redis.get('worker:status')\n\n// Pub/sub between instances\nredis.on('message', (channel, msg) => console.log(`${channel}: ${msg}`))\nawait redis.subscribe('tasks')\nawait redis.publish('tasks', JSON.stringify({ type: 'ping' }))\n\n// JSON helpers\nawait redis.setJSON('config', { workers: 4, debug: true })\nconst config = await redis.getJSON<{ workers: number }>('config')"
+    }
+  ]
+});
+
 setBuildTimeData('features.fs', {
   "id": "features.fs",
   "description": "The FS feature provides methods for interacting with the file system, relative to the container's cwd.",
@@ -7566,7 +7872,7 @@ setBuildTimeData('features.postgres', {
 
 setBuildTimeData('features.python', {
   "id": "features.python",
-  "description": "The Python VM feature provides Python virtual machine capabilities for executing Python code. This feature automatically detects Python environments (uv, conda, venv, system) and provides methods to install dependencies and execute Python scripts. It can manage project-specific Python environments and maintain context between executions.",
+  "description": "The Python VM feature provides Python virtual machine capabilities for executing Python code. This feature automatically detects Python environments (uv, conda, venv, system) and provides methods to install dependencies and execute Python scripts. It can manage project-specific Python environments and maintain context between executions. Supports two modes: - **Stateless** (default): `execute()` and `executeFile()` spawn a fresh process per call - **Persistent session**: `startSession()` spawns a long-lived bridge process that maintains state across `run()` calls, enabling real codebase interaction with imports and session variables",
   "shortcut": "features.python",
   "className": "Python",
   "methods": {
@@ -7666,37 +7972,177 @@ setBuildTimeData('features.python', {
       "parameters": {},
       "required": [],
       "returns": "Promise<{ version: string; path: string; packages: string[] }>"
-    }
-  },
-  "getters": {
-    "projectDir": {
-      "description": "Returns the root directory of the Python project.",
-      "returns": "any"
-    },
-    "pythonPath": {
-      "description": "Returns the path to the Python executable for this environment.",
-      "returns": "any"
     },
-    "environmentType": {
-      "description": "Returns the detected environment type: 'uv', 'conda', 'venv', or 'system'.",
-      "returns": "any"
-    }
-  },
-  "events": {
-    "ready": {
-      "name": "ready",
-      "description": "Event emitted by Python",
-      "arguments": {}
+    "startSession": {
+      "description": "Starts a persistent Python session by spawning the bridge process. The bridge sets up sys.path for the project directory, then enters a JSON-line REPL loop. State (variables, imports) persists across run() calls until stopSession() or resetSession() is called.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<void>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const python = container.feature('python', { dir: '/path/to/project' })\nawait python.enable()\nawait python.startSession()\nawait python.run('x = 42')\nconst result = await python.run('print(x)')\nconsole.log(result.stdout) // '42\\n'\nawait python.stopSession()"
+        }
+      ]
     },
-    "environmentDetected": {
-      "name": "environmentDetected",
-      "description": "Event emitted by Python",
-      "arguments": {}
+    "stopSession": {
+      "description": "Stops the persistent Python session and cleans up the bridge process.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<void>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "await python.stopSession()"
+        }
+      ]
     },
-    "installingDependencies": {
-      "name": "installingDependencies",
-      "description": "Event emitted by Python",
-      "arguments": {}
+    "run": {
+      "description": "Executes Python code in the persistent session. Variables and imports survive across calls. This is the session equivalent of execute().",
+      "parameters": {
+        "code": {
+          "type": "string",
+          "description": "Python code to execute"
+        },
+        "variables": {
+          "type": "Record<string, any>",
+          "description": "Variables to inject into the namespace before execution"
+        }
+      },
+      "required": [
+        "code"
+      ],
+      "returns": "Promise<RunResult>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "await python.startSession()\n\n// State persists across calls\nawait python.run('x = 42')\nconst result = await python.run('print(x * 2)')\nconsole.log(result.stdout) // '84\\n'\n\n// Inject variables from JS\nconst result2 = await python.run('print(f\"Hello {name}!\")', { name: 'World' })\nconsole.log(result2.stdout) // 'Hello World!\\n'"
+        }
+      ]
+    },
+    "eval": {
+      "description": "Evaluates a Python expression in the persistent session and returns its value.",
+      "parameters": {
+        "expression": {
+          "type": "string",
+          "description": "Python expression to evaluate"
+        }
+      },
+      "required": [
+        "expression"
+      ],
+      "returns": "Promise<any>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "await python.run('x = 42')\nconst result = await python.eval('x * 2')\nconsole.log(result) // 84"
+        }
+      ]
+    },
+    "importModule": {
+      "description": "Imports a Python module into the persistent session namespace.",
+      "parameters": {
+        "moduleName": {
+          "type": "string",
+          "description": "Dotted module path (e.g. 'myapp.models')"
+        },
+        "alias": {
+          "type": "string",
+          "description": "Optional alias for the import (defaults to the last segment)"
+        }
+      },
+      "required": [
+        "moduleName"
+      ],
+      "returns": "Promise<void>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "await python.importModule('json')\nawait python.importModule('myapp.models', 'models')\nconst result = await python.eval('models.User')"
+        }
+      ]
+    },
+    "call": {
+      "description": "Calls a function by dotted path in the persistent session namespace.",
+      "parameters": {
+        "funcPath": {
+          "type": "string",
+          "description": "Dotted path to the function (e.g. 'json.dumps' or 'my_func')"
+        },
+        "args": {
+          "type": "any[]",
+          "description": "Positional arguments"
+        },
+        "kwargs": {
+          "type": "Record<string, any>",
+          "description": "Keyword arguments"
+        }
+      },
+      "required": [
+        "funcPath"
+      ],
+      "returns": "Promise<any>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "await python.importModule('json')\nconst result = await python.call('json.dumps', [{ a: 1 }], { indent: 2 })"
+        }
+      ]
+    },
+    "getLocals": {
+      "description": "Returns all non-dunder variables from the persistent session namespace.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<Record<string, any>>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "await python.run('x = 42\\ny = \"hello\"')\nconst locals = await python.getLocals()\nconsole.log(locals) // { x: 42, y: 'hello' }"
+        }
+      ]
+    },
+    "resetSession": {
+      "description": "Clears all variables and imports from the persistent session namespace. The session remains active — you can continue calling run() after reset.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<void>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "await python.run('x = 42')\nawait python.resetSession()\n// x is now undefined"
+        }
+      ]
+    }
+  },
+  "getters": {
+    "projectDir": {
+      "description": "Returns the root directory of the Python project.",
+      "returns": "any"
+    },
+    "pythonPath": {
+      "description": "Returns the path to the Python executable for this environment.",
+      "returns": "any"
+    },
+    "environmentType": {
+      "description": "Returns the detected environment type: 'uv', 'conda', 'venv', or 'system'.",
+      "returns": "any"
+    }
+  },
+  "events": {
+    "ready": {
+      "name": "ready",
+      "description": "Event emitted by Python",
+      "arguments": {}
+    },
+    "environmentDetected": {
+      "name": "environmentDetected",
+      "description": "Event emitted by Python",
+      "arguments": {}
+    },
+    "installingDependencies": {
+      "name": "installingDependencies",
+      "description": "Event emitted by Python",
+      "arguments": {}
     },
     "dependenciesInstalled": {
       "name": "dependenciesInstalled",
@@ -7722,6 +8168,21 @@ setBuildTimeData('features.python', {
       "name": "fileExecuted",
       "description": "Event emitted by Python",
       "arguments": {}
+    },
+    "sessionError": {
+      "name": "sessionError",
+      "description": "Event emitted by Python",
+      "arguments": {}
+    },
+    "sessionStarted": {
+      "name": "sessionStarted",
+      "description": "Event emitted by Python",
+      "arguments": {}
+    },
+    "sessionStopped": {
+      "name": "sessionStopped",
+      "description": "Event emitted by Python",
+      "arguments": {}
     }
   },
   "state": {},
@@ -7730,9 +8191,38 @@ setBuildTimeData('features.python', {
   "examples": [
     {
       "language": "ts",
-      "code": "const python = container.feature('python', { \n dir: \"/path/to/python/project\",\n contextScript: \"/path/to/setup-context.py\"\n})\n\n// Auto-install dependencies\nawait python.installDependencies()\n\n// Execute Python code\nconst result = await python.execute('print(\"Hello from Python!\")')\n\n// Execute with custom variables\nconst result2 = await python.execute('print(f\"Hello {name}!\")', { name: 'World' })"
+      "code": "const python = container.feature('python', {\n dir: \"/path/to/python/project\",\n})\n\n// Stateless execution\nconst result = await python.execute('print(\"Hello from Python!\")')\n\n// Persistent session\nawait python.startSession()\nawait python.run('import myapp.models')\nawait python.run('users = myapp.models.User.objects.all()')\nconst result = await python.run('print(len(users))')\nawait python.stopSession()"
     }
-  ]
+  ],
+  "types": {
+    "RunResult": {
+      "description": "Result from a persistent session run() call.",
+      "properties": {
+        "ok": {
+          "type": "boolean",
+          "description": ""
+        },
+        "result": {
+          "type": "any",
+          "description": ""
+        },
+        "stdout": {
+          "type": "string",
+          "description": ""
+        },
+        "error": {
+          "type": "string",
+          "description": "",
+          "optional": true
+        },
+        "traceback": {
+          "type": "string",
+          "description": "",
+          "optional": true
+        }
+      }
+    }
+  }
 });
 
 setBuildTimeData('features.jsonTree', {
@@ -8371,136 +8861,6 @@ setBuildTimeData('features.processManager', {
   }
 });
 
-setBuildTimeData('portExposer', {
-  "id": "portExposer",
-  "description": "Port Exposer Feature Exposes local HTTP services via ngrok with SSL-enabled public URLs. Perfect for development, testing, and sharing local services securely. Features: - SSL-enabled public URLs for local services - Custom subdomains and domains (with paid plans) - Authentication options (basic auth, OAuth) - Regional endpoint selection - Connection state management",
-  "shortcut": "portExposer",
-  "className": "PortExposer",
-  "methods": {
-    "expose": {
-      "description": "Expose the local port via ngrok. Creates an ngrok tunnel to the specified local port and returns the SSL-enabled public URL. Emits `exposed` on success or `error` on failure.",
-      "parameters": {
-        "port": {
-          "type": "number",
-          "description": "Optional port override; falls back to `options.port`"
-        }
-      },
-      "required": [],
-      "returns": "Promise<string>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const exposer = container.feature('portExposer', { port: 3000 })\nconst url = await exposer.expose()\nconsole.log(`Public URL: ${url}`)\n\n// Override port at call time\nconst url2 = await exposer.expose(8080)"
-        }
-      ]
-    },
-    "close": {
-      "description": "Stop exposing the port and close the ngrok tunnel. Tears down the ngrok listener, resets connection state, and emits `closed`. Safe to call when no tunnel is active (no-op).",
-      "parameters": {},
-      "required": [],
-      "returns": "Promise<void>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const exposer = container.feature('portExposer', { port: 3000 })\nawait exposer.expose()\n// ... later\nawait exposer.close()\nconsole.log(exposer.isConnected()) // false"
-        }
-      ]
-    },
-    "getPublicUrl": {
-      "description": "Get the current public URL if connected. Returns the live URL from the ngrok listener, or `undefined` if no tunnel is active.",
-      "parameters": {},
-      "required": [],
-      "returns": "string | undefined",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const exposer = container.feature('portExposer', { port: 3000 })\nawait exposer.expose()\nconsole.log(exposer.getPublicUrl()) // 'https://abc123.ngrok.io'"
-        }
-      ]
-    },
-    "isConnected": {
-      "description": "Check if the ngrok tunnel is currently connected.",
-      "parameters": {},
-      "required": [],
-      "returns": "boolean",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const exposer = container.feature('portExposer', { port: 3000 })\nconsole.log(exposer.isConnected()) // false\nawait exposer.expose()\nconsole.log(exposer.isConnected()) // true"
-        }
-      ]
-    },
-    "getConnectionInfo": {
-      "description": "Get a snapshot of the current connection information. Returns an object with the tunnel's connected status, public URL, local port, connection timestamp, and session metadata.",
-      "parameters": {},
-      "required": [],
-      "returns": "void",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const exposer = container.feature('portExposer', { port: 3000 })\nawait exposer.expose()\nconst info = exposer.getConnectionInfo()\nconsole.log(info.publicUrl, info.localPort, info.connectedAt)"
-        }
-      ]
-    },
-    "reconnect": {
-      "description": "Close the existing tunnel and re-expose with optionally updated options. Calls `close()` first, merges any new options, then calls `expose()`.",
-      "parameters": {
-        "newOptions": {
-          "type": "Partial<PortExposerOptions>",
-          "description": "Optional partial options to merge before reconnecting"
-        }
-      },
-      "required": [],
-      "returns": "Promise<string>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const exposer = container.feature('portExposer', { port: 3000 })\nawait exposer.expose()\n// Switch to a different port\nconst newUrl = await exposer.reconnect({ port: 8080 })"
-        }
-      ]
-    },
-    "disable": {
-      "description": "Disable the feature, ensuring the ngrok tunnel is closed first. Overrides the base `disable()` to guarantee that the tunnel is torn down before the feature is marked as disabled.",
-      "parameters": {},
-      "required": [],
-      "returns": "Promise<this>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const exposer = container.feature('portExposer', { port: 3000 })\nawait exposer.expose()\nawait exposer.disable()"
-        }
-      ]
-    }
-  },
-  "getters": {},
-  "events": {
-    "exposed": {
-      "name": "exposed",
-      "description": "Event emitted by PortExposer",
-      "arguments": {}
-    },
-    "error": {
-      "name": "error",
-      "description": "Event emitted by PortExposer",
-      "arguments": {}
-    },
-    "closed": {
-      "name": "closed",
-      "description": "Event emitted by PortExposer",
-      "arguments": {}
-    }
-  },
-  "state": {},
-  "options": {},
-  "envVars": [],
-  "examples": [
-    {
-      "language": "ts",
-      "code": "// Basic usage\nconst exposer = container.feature('portExposer', { port: 3000 })\nconst url = await exposer.expose()\nconsole.log(`Service available at: ${url}`)\n\n// With custom subdomain\nconst exposer = container.feature('portExposer', {\n port: 8080,\n subdomain: 'my-app',\n authToken: 'your-ngrok-token'\n})"
-    }
-  ]
-});
-
 setBuildTimeData('features.googleSheets', {
   "id": "features.googleSheets",
   "description": "Google Sheets feature for reading spreadsheet data as JSON, CSV, or raw arrays. Depends on the googleAuth feature for authentication. Creates a Sheets v4 API client lazily and provides convenient methods for reading tabular data.",
@@ -11696,275 +12056,11 @@ 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",
-  "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"
-    }
-  ],
-  "types": {
-    "SynthesizeOptions": {
-      "description": "",
-      "properties": {
-        "voiceId": {
-          "type": "string",
-          "description": "",
-          "optional": true
-        },
-        "modelId": {
-          "type": "string",
-          "description": "",
-          "optional": true
-        },
-        "outputFormat": {
-          "type": "string",
-          "description": "",
-          "optional": true
-        },
-        "voiceSettings": {
-          "type": "ElevenLabsVoiceSettings",
-          "description": "",
-          "optional": true
-        },
-        "disableCache": {
-          "type": "boolean",
-          "description": "",
-          "optional": true
-        }
-      }
-    },
-    "ElevenLabsVoiceSettings": {
-      "description": "",
-      "properties": {
-        "stability": {
-          "type": "number",
-          "description": "",
-          "optional": true
-        },
-        "similarityBoost": {
-          "type": "number",
-          "description": "",
-          "optional": true
-        },
-        "style": {
-          "type": "number",
-          "description": "",
-          "optional": true
-        },
-        "speed": {
-          "type": "number",
-          "description": "",
-          "optional": true
-        },
-        "useSpeakerBoost": {
-          "type": "boolean",
-          "description": "",
-          "optional": true
-        }
-      }
-    }
-  }
-});
-
-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.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": {
     "from": {
       "description": "Start a query on a Postgres table or view.",
@@ -12420,31 +12516,295 @@ setBuildTimeData('clients.comfyui', {
           "description": "Polling interval in ms (default 1000)",
           "optional": true
         },
-        "inputMap": {
-          "type": "InputMapping",
-          "description": "Named input mapping: semantic name -> { nodeId, field }",
+        "inputMap": {
+          "type": "InputMapping",
+          "description": "Named input mapping: semantic name -> { nodeId, field }",
+          "optional": true
+        },
+        "outputDir": {
+          "type": "string",
+          "description": "If provided, output images are downloaded to this directory",
+          "optional": true
+        }
+      }
+    },
+    "WorkflowResult": {
+      "description": "",
+      "properties": {
+        "promptId": {
+          "type": "string",
+          "description": ""
+        },
+        "outputs": {
+          "type": "Record<string, any>",
+          "description": ""
+        },
+        "images": {
+          "type": "Array<{ filename: string; subfolder: string; type: string; localPath?: string }>",
+          "description": "",
+          "optional": true
+        }
+      }
+    }
+  }
+});
+
+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()"
+        }
+      ]
+    },
+    "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"
+    }
+  ],
+  "types": {
+    "SynthesizeOptions": {
+      "description": "",
+      "properties": {
+        "voiceId": {
+          "type": "string",
+          "description": "",
+          "optional": true
+        },
+        "modelId": {
+          "type": "string",
+          "description": "",
+          "optional": true
+        },
+        "outputFormat": {
+          "type": "string",
+          "description": "",
+          "optional": true
+        },
+        "voiceSettings": {
+          "type": "ElevenLabsVoiceSettings",
+          "description": "",
           "optional": true
         },
-        "outputDir": {
-          "type": "string",
-          "description": "If provided, output images are downloaded to this directory",
+        "disableCache": {
+          "type": "boolean",
+          "description": "",
           "optional": true
         }
       }
     },
-    "WorkflowResult": {
+    "ElevenLabsVoiceSettings": {
       "description": "",
       "properties": {
-        "promptId": {
-          "type": "string",
-          "description": ""
+        "stability": {
+          "type": "number",
+          "description": "",
+          "optional": true
         },
-        "outputs": {
-          "type": "Record<string, any>",
-          "description": ""
+        "similarityBoost": {
+          "type": "number",
+          "description": "",
+          "optional": true
         },
-        "images": {
-          "type": "Array<{ filename: string; subfolder: string; type: string; localPath?: string }>",
+        "style": {
+          "type": "number",
+          "description": "",
+          "optional": true
+        },
+        "speed": {
+          "type": "number",
+          "description": "",
+          "optional": true
+        },
+        "useSpeakerBoost": {
+          "type": "boolean",
           "description": "",
           "optional": true
         }
@@ -13185,7 +13545,7 @@ setContainerBuildTimeData('Container', {
         }
       ]
     },
-    "inspect": {
+    "introspect": {
       "description": "Returns a full introspection object for this container, merging build-time AST data (JSDoc descriptions, methods, getters) with runtime data (registries, factories, state, environment).",
       "parameters": {},
       "required": [],
@@ -13193,11 +13553,11 @@ setContainerBuildTimeData('Container', {
       "examples": [
         {
           "language": "ts",
-          "code": "const info = container.inspect()\nconsole.log(info.methods)   // all public methods with descriptions\nconsole.log(info.getters)   // all getters with return types\nconsole.log(info.registries) // features, clients, servers, etc."
+          "code": "const info = container.introspect()\nconsole.log(info.methods)   // all public methods with descriptions\nconsole.log(info.getters)   // all getters with return types\nconsole.log(info.registries) // features, clients, servers, etc."
         }
       ]
     },
-    "inspectAsText": {
+    "introspectAsText": {
       "description": "Returns a human-readable markdown representation of this container's introspection data. Useful in REPLs, AI agent contexts, or documentation generation. Pass a section name to render only that section (e.g. 'methods', 'getters', 'events', 'state').",
       "parameters": {
         "sectionOrDepth": {
@@ -13214,32 +13574,17 @@ setContainerBuildTimeData('Container', {
       "examples": [
         {
           "language": "ts",
-          "code": "console.log(container.inspectAsText())           // full description\nconsole.log(container.inspectAsText('methods'))   // just methods"
+          "code": "console.log(container.introspectAsText())           // full description\nconsole.log(container.introspectAsText('methods'))   // just methods"
         }
       ]
     },
-    "introspectAsText": {
-      "description": "Alias for inspectAsText.",
-      "parameters": {
-        "sectionOrDepth": {
-          "type": "IntrospectionSection | number",
-          "description": "Parameter sectionOrDepth"
-        },
-        "startHeadingDepth": {
-          "type": "number",
-          "description": "Parameter startHeadingDepth"
-        }
-      },
-      "required": [],
-      "returns": "string"
-    },
     "introspectAsJSON": {
-      "description": "Alias for inspect, returns JSON introspection data.",
+      "description": "Returns JSON introspection data.",
       "parameters": {},
       "required": [],
       "returns": "ContainerIntrospection"
     },
-    "inspectAsType": {
+    "introspectAsType": {
       "description": "Returns the container's introspection data formatted as a TypeScript interface declaration. Includes the container's own methods, getters, factories, and registered helper types.",
       "parameters": {},
       "required": [],
@@ -13247,16 +13592,10 @@ setContainerBuildTimeData('Container', {
       "examples": [
         {
           "language": "ts",
-          "code": "console.log(container.inspectAsType())\n// interface NodeContainer {\n//   feature<T>(id: string, options?: object): T;\n//   readonly uuid: string;\n//   ...\n// }"
+          "code": "console.log(container.introspectAsType())\n// interface NodeContainer {\n//   feature<T>(id: string, options?: object): T;\n//   readonly uuid: string;\n//   ...\n// }"
         }
       ]
     },
-    "introspectAsType": {
-      "description": "",
-      "parameters": {},
-      "required": [],
-      "returns": "string"
-    },
     "sleep": {
       "description": "Sleep for the specified number of milliseconds. Useful for scripting and sequencing.",
       "parameters": {
@@ -19303,7 +19642,312 @@ export const introspectionData = [
           }
         }
       }
-    }
+    }
+  },
+  {
+    "id": "features.redis",
+    "description": "Redis feature for shared state and pub/sub communication between container instances. Wraps ioredis with a focused API for the primitives that matter most: key/value state, pub/sub messaging, and cross-instance coordination. Uses a dedicated subscriber connection for pub/sub (ioredis requirement), created lazily on first subscribe call.",
+    "shortcut": "features.redis",
+    "className": "RedisFeature",
+    "methods": {
+      "set": {
+        "description": "Set a key to a string value with optional TTL.",
+        "parameters": {
+          "key": {
+            "type": "string",
+            "description": "The key name"
+          },
+          "value": {
+            "type": "string",
+            "description": "The string value to store"
+          },
+          "ttl": {
+            "type": "number",
+            "description": "Optional time-to-live in seconds"
+          }
+        },
+        "required": [
+          "key",
+          "value"
+        ],
+        "returns": "Promise<void>"
+      },
+      "get": {
+        "description": "Get a key's value. Returns null if the key doesn't exist.",
+        "parameters": {
+          "key": {
+            "type": "string",
+            "description": "The key name"
+          }
+        },
+        "required": [
+          "key"
+        ],
+        "returns": "Promise<string | null>"
+      },
+      "del": {
+        "description": "Delete one or more keys.",
+        "parameters": {
+          "keys": {
+            "type": "string[]",
+            "description": "One or more key names to delete"
+          }
+        },
+        "required": [
+          "keys"
+        ],
+        "returns": "Promise<number>"
+      },
+      "exists": {
+        "description": "Check if a key exists.",
+        "parameters": {
+          "key": {
+            "type": "string",
+            "description": "The key name"
+          }
+        },
+        "required": [
+          "key"
+        ],
+        "returns": "Promise<boolean>"
+      },
+      "expire": {
+        "description": "Set a key's TTL in seconds.",
+        "parameters": {
+          "key": {
+            "type": "string",
+            "description": "The key name"
+          },
+          "seconds": {
+            "type": "number",
+            "description": "TTL in seconds"
+          }
+        },
+        "required": [
+          "key",
+          "seconds"
+        ],
+        "returns": "Promise<boolean>"
+      },
+      "keys": {
+        "description": "Find keys matching a glob pattern (respects prefix).",
+        "parameters": {
+          "pattern": {
+            "type": "string",
+            "description": "Glob pattern, e.g. \"worker:*\""
+          }
+        },
+        "required": [],
+        "returns": "Promise<string[]>"
+      },
+      "setJSON": {
+        "description": "Store a value as JSON.",
+        "parameters": {
+          "key": {
+            "type": "string",
+            "description": "The key name"
+          },
+          "value": {
+            "type": "unknown",
+            "description": "Any JSON-serializable value"
+          },
+          "ttl": {
+            "type": "number",
+            "description": "Optional TTL in seconds"
+          }
+        },
+        "required": [
+          "key",
+          "value"
+        ],
+        "returns": "Promise<void>"
+      },
+      "getJSON": {
+        "description": "Retrieve and parse a JSON value.",
+        "parameters": {
+          "key": {
+            "type": "string",
+            "description": "The key name"
+          }
+        },
+        "required": [
+          "key"
+        ],
+        "returns": "Promise<T | null>"
+      },
+      "hset": {
+        "description": "Set fields on a hash.",
+        "parameters": {
+          "key": {
+            "type": "string",
+            "description": "The hash key"
+          },
+          "fields": {
+            "type": "Record<string, string>",
+            "description": "Object of field/value pairs"
+          }
+        },
+        "required": [
+          "key",
+          "fields"
+        ],
+        "returns": "Promise<void>"
+      },
+      "hgetall": {
+        "description": "Get all fields from a hash.",
+        "parameters": {
+          "key": {
+            "type": "string",
+            "description": "The hash key"
+          }
+        },
+        "required": [
+          "key"
+        ],
+        "returns": "Promise<Record<string, string>>"
+      },
+      "hget": {
+        "description": "Get a single field from a hash.",
+        "parameters": {
+          "key": {
+            "type": "string",
+            "description": "The hash key"
+          },
+          "field": {
+            "type": "string",
+            "description": "The field name"
+          }
+        },
+        "required": [
+          "key",
+          "field"
+        ],
+        "returns": "Promise<string | null>"
+      },
+      "subscribe": {
+        "description": "Subscribe to one or more channels. Optionally pass a handler that fires only for these channels. The feature also emits a `message` event for all messages.",
+        "parameters": {
+          "channels": {
+            "type": "string | string[]",
+            "description": "Channel name(s) to subscribe to"
+          },
+          "handler": {
+            "type": "MessageHandler",
+            "description": "Optional per-channel message handler"
+          }
+        },
+        "required": [
+          "channels"
+        ],
+        "returns": "Promise<void>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "await redis.subscribe('tasks', (channel, msg) => {\n console.log(`Got ${msg} on ${channel}`)\n})"
+          }
+        ]
+      },
+      "unsubscribe": {
+        "description": "Unsubscribe from one or more channels.",
+        "parameters": {
+          "channels": {
+            "type": "string[]",
+            "description": "Channel name(s) to unsubscribe from"
+          }
+        },
+        "required": [
+          "channels"
+        ],
+        "returns": "Promise<void>"
+      },
+      "publish": {
+        "description": "Publish a message to a channel.",
+        "parameters": {
+          "channel": {
+            "type": "string",
+            "description": "The channel to publish to"
+          },
+          "message": {
+            "type": "string",
+            "description": "The message string (use JSON.stringify for objects)"
+          }
+        },
+        "required": [
+          "channel",
+          "message"
+        ],
+        "returns": "Promise<number>"
+      },
+      "ensureLocalDocker": {
+        "description": "Spin up a local Redis instance via Docker. Checks if a container with the given name already exists and starts it if stopped, or creates a new one from redis:alpine. Requires the docker feature to be available on the container.",
+        "parameters": {
+          "options": {
+            "type": "{ name?: string; port?: number; image?: string }",
+            "description": "Container name and host port"
+          }
+        },
+        "required": [],
+        "returns": "Promise<string>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const redis = container.feature('redis', { url: 'redis://localhost:6379', lazyConnect: true })\nawait redis.ensureLocalDocker()"
+          }
+        ]
+      },
+      "close": {
+        "description": "Close all redis connections (main client + subscriber).",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<this>"
+      }
+    },
+    "getters": {
+      "client": {
+        "description": "The underlying ioredis client for advanced operations.",
+        "returns": "Redis"
+      },
+      "subscriber": {
+        "description": "The dedicated subscriber connection, if pub/sub is active.",
+        "returns": "Redis | null"
+      }
+    },
+    "events": {
+      "message": {
+        "name": "message",
+        "description": "Event emitted by RedisFeature",
+        "arguments": {}
+      },
+      "error": {
+        "name": "error",
+        "description": "Event emitted by RedisFeature",
+        "arguments": {}
+      },
+      "subscribed": {
+        "name": "subscribed",
+        "description": "Event emitted by RedisFeature",
+        "arguments": {}
+      },
+      "unsubscribed": {
+        "name": "unsubscribed",
+        "description": "Event emitted by RedisFeature",
+        "arguments": {}
+      },
+      "closed": {
+        "name": "closed",
+        "description": "Event emitted by RedisFeature",
+        "arguments": {}
+      }
+    },
+    "state": {},
+    "options": {},
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const redis = container.feature('redis', { url: 'redis://localhost:6379' })\n\n// Shared state\nawait redis.set('worker:status', 'active')\nconst status = await redis.get('worker:status')\n\n// Pub/sub between instances\nredis.on('message', (channel, msg) => console.log(`${channel}: ${msg}`))\nawait redis.subscribe('tasks')\nawait redis.publish('tasks', JSON.stringify({ type: 'ping' }))\n\n// JSON helpers\nawait redis.setJSON('config', { workers: 4, debug: true })\nconst config = await redis.getJSON<{ workers: number }>('config')"
+      }
+    ]
   },
   {
     "id": "features.fs",
@@ -20940,7 +21584,7 @@ export const introspectionData = [
   },
   {
     "id": "features.python",
-    "description": "The Python VM feature provides Python virtual machine capabilities for executing Python code. This feature automatically detects Python environments (uv, conda, venv, system) and provides methods to install dependencies and execute Python scripts. It can manage project-specific Python environments and maintain context between executions.",
+    "description": "The Python VM feature provides Python virtual machine capabilities for executing Python code. This feature automatically detects Python environments (uv, conda, venv, system) and provides methods to install dependencies and execute Python scripts. It can manage project-specific Python environments and maintain context between executions. Supports two modes: - **Stateless** (default): `execute()` and `executeFile()` spawn a fresh process per call - **Persistent session**: `startSession()` spawns a long-lived bridge process that maintains state across `run()` calls, enabling real codebase interaction with imports and session variables",
     "shortcut": "features.python",
     "className": "Python",
     "methods": {
@@ -21040,6 +21684,146 @@ export const introspectionData = [
         "parameters": {},
         "required": [],
         "returns": "Promise<{ version: string; path: string; packages: string[] }>"
+      },
+      "startSession": {
+        "description": "Starts a persistent Python session by spawning the bridge process. The bridge sets up sys.path for the project directory, then enters a JSON-line REPL loop. State (variables, imports) persists across run() calls until stopSession() or resetSession() is called.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<void>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const python = container.feature('python', { dir: '/path/to/project' })\nawait python.enable()\nawait python.startSession()\nawait python.run('x = 42')\nconst result = await python.run('print(x)')\nconsole.log(result.stdout) // '42\\n'\nawait python.stopSession()"
+          }
+        ]
+      },
+      "stopSession": {
+        "description": "Stops the persistent Python session and cleans up the bridge process.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<void>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "await python.stopSession()"
+          }
+        ]
+      },
+      "run": {
+        "description": "Executes Python code in the persistent session. Variables and imports survive across calls. This is the session equivalent of execute().",
+        "parameters": {
+          "code": {
+            "type": "string",
+            "description": "Python code to execute"
+          },
+          "variables": {
+            "type": "Record<string, any>",
+            "description": "Variables to inject into the namespace before execution"
+          }
+        },
+        "required": [
+          "code"
+        ],
+        "returns": "Promise<RunResult>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "await python.startSession()\n\n// State persists across calls\nawait python.run('x = 42')\nconst result = await python.run('print(x * 2)')\nconsole.log(result.stdout) // '84\\n'\n\n// Inject variables from JS\nconst result2 = await python.run('print(f\"Hello {name}!\")', { name: 'World' })\nconsole.log(result2.stdout) // 'Hello World!\\n'"
+          }
+        ]
+      },
+      "eval": {
+        "description": "Evaluates a Python expression in the persistent session and returns its value.",
+        "parameters": {
+          "expression": {
+            "type": "string",
+            "description": "Python expression to evaluate"
+          }
+        },
+        "required": [
+          "expression"
+        ],
+        "returns": "Promise<any>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "await python.run('x = 42')\nconst result = await python.eval('x * 2')\nconsole.log(result) // 84"
+          }
+        ]
+      },
+      "importModule": {
+        "description": "Imports a Python module into the persistent session namespace.",
+        "parameters": {
+          "moduleName": {
+            "type": "string",
+            "description": "Dotted module path (e.g. 'myapp.models')"
+          },
+          "alias": {
+            "type": "string",
+            "description": "Optional alias for the import (defaults to the last segment)"
+          }
+        },
+        "required": [
+          "moduleName"
+        ],
+        "returns": "Promise<void>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "await python.importModule('json')\nawait python.importModule('myapp.models', 'models')\nconst result = await python.eval('models.User')"
+          }
+        ]
+      },
+      "call": {
+        "description": "Calls a function by dotted path in the persistent session namespace.",
+        "parameters": {
+          "funcPath": {
+            "type": "string",
+            "description": "Dotted path to the function (e.g. 'json.dumps' or 'my_func')"
+          },
+          "args": {
+            "type": "any[]",
+            "description": "Positional arguments"
+          },
+          "kwargs": {
+            "type": "Record<string, any>",
+            "description": "Keyword arguments"
+          }
+        },
+        "required": [
+          "funcPath"
+        ],
+        "returns": "Promise<any>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "await python.importModule('json')\nconst result = await python.call('json.dumps', [{ a: 1 }], { indent: 2 })"
+          }
+        ]
+      },
+      "getLocals": {
+        "description": "Returns all non-dunder variables from the persistent session namespace.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<Record<string, any>>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "await python.run('x = 42\\ny = \"hello\"')\nconst locals = await python.getLocals()\nconsole.log(locals) // { x: 42, y: 'hello' }"
+          }
+        ]
+      },
+      "resetSession": {
+        "description": "Clears all variables and imports from the persistent session namespace. The session remains active — you can continue calling run() after reset.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<void>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "await python.run('x = 42')\nawait python.resetSession()\n// x is now undefined"
+          }
+        ]
       }
     },
     "getters": {
@@ -21096,6 +21880,21 @@ export const introspectionData = [
         "name": "fileExecuted",
         "description": "Event emitted by Python",
         "arguments": {}
+      },
+      "sessionError": {
+        "name": "sessionError",
+        "description": "Event emitted by Python",
+        "arguments": {}
+      },
+      "sessionStarted": {
+        "name": "sessionStarted",
+        "description": "Event emitted by Python",
+        "arguments": {}
+      },
+      "sessionStopped": {
+        "name": "sessionStopped",
+        "description": "Event emitted by Python",
+        "arguments": {}
       }
     },
     "state": {},
@@ -21104,9 +21903,38 @@ export const introspectionData = [
     "examples": [
       {
         "language": "ts",
-        "code": "const python = container.feature('python', { \n dir: \"/path/to/python/project\",\n contextScript: \"/path/to/setup-context.py\"\n})\n\n// Auto-install dependencies\nawait python.installDependencies()\n\n// Execute Python code\nconst result = await python.execute('print(\"Hello from Python!\")')\n\n// Execute with custom variables\nconst result2 = await python.execute('print(f\"Hello {name}!\")', { name: 'World' })"
+        "code": "const python = container.feature('python', {\n dir: \"/path/to/python/project\",\n})\n\n// Stateless execution\nconst result = await python.execute('print(\"Hello from Python!\")')\n\n// Persistent session\nawait python.startSession()\nawait python.run('import myapp.models')\nawait python.run('users = myapp.models.User.objects.all()')\nconst result = await python.run('print(len(users))')\nawait python.stopSession()"
       }
-    ]
+    ],
+    "types": {
+      "RunResult": {
+        "description": "Result from a persistent session run() call.",
+        "properties": {
+          "ok": {
+            "type": "boolean",
+            "description": ""
+          },
+          "result": {
+            "type": "any",
+            "description": ""
+          },
+          "stdout": {
+            "type": "string",
+            "description": ""
+          },
+          "error": {
+            "type": "string",
+            "description": "",
+            "optional": true
+          },
+          "traceback": {
+            "type": "string",
+            "description": "",
+            "optional": true
+          }
+        }
+      }
+    }
   },
   {
     "id": "features.jsonTree",
@@ -21732,143 +22560,14 @@ export const introspectionData = [
             "description": "stdout mode: 'pipe' to capture output, 'inherit', or 'ignore' (default: 'pipe')",
             "optional": true
           },
-          "stderr": {
-            "type": "'pipe' | 'inherit' | 'ignore' | null",
-            "description": "stderr mode: 'pipe' to capture errors, 'inherit', or 'ignore' (default: 'pipe')",
-            "optional": true
-          }
-        }
-      }
-    }
-  },
-  {
-    "id": "portExposer",
-    "description": "Port Exposer Feature Exposes local HTTP services via ngrok with SSL-enabled public URLs. Perfect for development, testing, and sharing local services securely. Features: - SSL-enabled public URLs for local services - Custom subdomains and domains (with paid plans) - Authentication options (basic auth, OAuth) - Regional endpoint selection - Connection state management",
-    "shortcut": "portExposer",
-    "className": "PortExposer",
-    "methods": {
-      "expose": {
-        "description": "Expose the local port via ngrok. Creates an ngrok tunnel to the specified local port and returns the SSL-enabled public URL. Emits `exposed` on success or `error` on failure.",
-        "parameters": {
-          "port": {
-            "type": "number",
-            "description": "Optional port override; falls back to `options.port`"
-          }
-        },
-        "required": [],
-        "returns": "Promise<string>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const exposer = container.feature('portExposer', { port: 3000 })\nconst url = await exposer.expose()\nconsole.log(`Public URL: ${url}`)\n\n// Override port at call time\nconst url2 = await exposer.expose(8080)"
-          }
-        ]
-      },
-      "close": {
-        "description": "Stop exposing the port and close the ngrok tunnel. Tears down the ngrok listener, resets connection state, and emits `closed`. Safe to call when no tunnel is active (no-op).",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<void>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const exposer = container.feature('portExposer', { port: 3000 })\nawait exposer.expose()\n// ... later\nawait exposer.close()\nconsole.log(exposer.isConnected()) // false"
-          }
-        ]
-      },
-      "getPublicUrl": {
-        "description": "Get the current public URL if connected. Returns the live URL from the ngrok listener, or `undefined` if no tunnel is active.",
-        "parameters": {},
-        "required": [],
-        "returns": "string | undefined",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const exposer = container.feature('portExposer', { port: 3000 })\nawait exposer.expose()\nconsole.log(exposer.getPublicUrl()) // 'https://abc123.ngrok.io'"
-          }
-        ]
-      },
-      "isConnected": {
-        "description": "Check if the ngrok tunnel is currently connected.",
-        "parameters": {},
-        "required": [],
-        "returns": "boolean",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const exposer = container.feature('portExposer', { port: 3000 })\nconsole.log(exposer.isConnected()) // false\nawait exposer.expose()\nconsole.log(exposer.isConnected()) // true"
-          }
-        ]
-      },
-      "getConnectionInfo": {
-        "description": "Get a snapshot of the current connection information. Returns an object with the tunnel's connected status, public URL, local port, connection timestamp, and session metadata.",
-        "parameters": {},
-        "required": [],
-        "returns": "void",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const exposer = container.feature('portExposer', { port: 3000 })\nawait exposer.expose()\nconst info = exposer.getConnectionInfo()\nconsole.log(info.publicUrl, info.localPort, info.connectedAt)"
-          }
-        ]
-      },
-      "reconnect": {
-        "description": "Close the existing tunnel and re-expose with optionally updated options. Calls `close()` first, merges any new options, then calls `expose()`.",
-        "parameters": {
-          "newOptions": {
-            "type": "Partial<PortExposerOptions>",
-            "description": "Optional partial options to merge before reconnecting"
-          }
-        },
-        "required": [],
-        "returns": "Promise<string>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const exposer = container.feature('portExposer', { port: 3000 })\nawait exposer.expose()\n// Switch to a different port\nconst newUrl = await exposer.reconnect({ port: 8080 })"
-          }
-        ]
-      },
-      "disable": {
-        "description": "Disable the feature, ensuring the ngrok tunnel is closed first. Overrides the base `disable()` to guarantee that the tunnel is torn down before the feature is marked as disabled.",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<this>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const exposer = container.feature('portExposer', { port: 3000 })\nawait exposer.expose()\nawait exposer.disable()"
-          }
-        ]
-      }
-    },
-    "getters": {},
-    "events": {
-      "exposed": {
-        "name": "exposed",
-        "description": "Event emitted by PortExposer",
-        "arguments": {}
-      },
-      "error": {
-        "name": "error",
-        "description": "Event emitted by PortExposer",
-        "arguments": {}
-      },
-      "closed": {
-        "name": "closed",
-        "description": "Event emitted by PortExposer",
-        "arguments": {}
-      }
-    },
-    "state": {},
-    "options": {},
-    "envVars": [],
-    "examples": [
-      {
-        "language": "ts",
-        "code": "// Basic usage\nconst exposer = container.feature('portExposer', { port: 3000 })\nconst url = await exposer.expose()\nconsole.log(`Service available at: ${url}`)\n\n// With custom subdomain\nconst exposer = container.feature('portExposer', {\n port: 8080,\n subdomain: 'my-app',\n authToken: 'your-ngrok-token'\n})"
+          "stderr": {
+            "type": "'pipe' | 'inherit' | 'ignore' | null",
+            "description": "stderr mode: 'pipe' to capture errors, 'inherit', or 'ignore' (default: 'pipe')",
+            "optional": true
+          }
+        }
       }
-    ]
+    }
   },
   {
     "id": "features.googleSheets",
@@ -25036,286 +25735,23 @@ export const introspectionData = [
       "image": {
         "name": "image",
         "description": "Event emitted by OpenAIClient",
-        "arguments": {}
-      },
-      "models": {
-        "name": "models",
-        "description": "Event emitted by OpenAIClient",
-        "arguments": {}
-      }
-    },
-    "state": {},
-    "options": {},
-    "envVars": [],
-    "examples": [
-      {
-        "language": "ts",
-        "code": "const openai = container.client('openai', { defaultModel: 'gpt-4o' })\nconst answer = await openai.ask('What is the meaning of life?')\nconsole.log(answer)"
-      }
-    ]
-  },
-  {
-    "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"
-      }
-    ],
-    "types": {
-      "SynthesizeOptions": {
-        "description": "",
-        "properties": {
-          "voiceId": {
-            "type": "string",
-            "description": "",
-            "optional": true
-          },
-          "modelId": {
-            "type": "string",
-            "description": "",
-            "optional": true
-          },
-          "outputFormat": {
-            "type": "string",
-            "description": "",
-            "optional": true
-          },
-          "voiceSettings": {
-            "type": "ElevenLabsVoiceSettings",
-            "description": "",
-            "optional": true
-          },
-          "disableCache": {
-            "type": "boolean",
-            "description": "",
-            "optional": true
-          }
-        }
+        "arguments": {}
       },
-      "ElevenLabsVoiceSettings": {
-        "description": "",
-        "properties": {
-          "stability": {
-            "type": "number",
-            "description": "",
-            "optional": true
-          },
-          "similarityBoost": {
-            "type": "number",
-            "description": "",
-            "optional": true
-          },
-          "style": {
-            "type": "number",
-            "description": "",
-            "optional": true
-          },
-          "speed": {
-            "type": "number",
-            "description": "",
-            "optional": true
-          },
-          "useSpeakerBoost": {
-            "type": "boolean",
-            "description": "",
-            "optional": true
-          }
-        }
+      "models": {
+        "name": "models",
+        "description": "Event emitted by OpenAIClient",
+        "arguments": {}
       }
-    }
+    },
+    "state": {},
+    "options": {},
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const openai = container.client('openai', { defaultModel: 'gpt-4o' })\nconst answer = await openai.ask('What is the meaning of life?')\nconsole.log(answer)"
+      }
+    ]
   },
   {
     "id": "clients.supabase",
@@ -25647,109 +26083,355 @@ export const introspectionData = [
         "required": [],
         "returns": "Promise<void>"
       },
-      "disconnectWs": {
-        "description": "Close the WebSocket connection.",
+      "disconnectWs": {
+        "description": "Close the WebSocket connection.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "toApiFormat": {
+        "description": "Convert a UI-format workflow to the API format that /prompt expects. Requires a running ComfyUI instance to fetch `object_info` so we can map positional `widgets_values` to their named input fields. If the workflow is already in API format, it's returned as-is.",
+        "parameters": {
+          "workflow": {
+            "type": "Record<string, any>",
+            "description": "Parameter workflow"
+          }
+        },
+        "required": [
+          "workflow"
+        ],
+        "returns": "Promise<Record<string, any>>"
+      },
+      "runWorkflow": {
+        "description": "Run a ComfyUI workflow with optional runtime input overrides. Inputs can be provided in two forms: **Direct node mapping** (when no `inputMap` in options): ``` { '3': { seed: 42 }, '6': { text: 'a cat' } } ``` **Named inputs** (when `inputMap` is provided in options): ``` inputs: { positive_prompt: 'a cat', seed: 42 } options.inputMap: { positive_prompt: { nodeId: '6', field: 'text' }, seed: { nodeId: '3', field: 'seed' } } ```",
+        "parameters": {
+          "workflow": {
+            "type": "Record<string, any>",
+            "description": "Parameter workflow"
+          },
+          "inputs": {
+            "type": "Record<string, any>",
+            "description": "Parameter inputs"
+          },
+          "options": {
+            "type": "WorkflowRunOptions",
+            "description": "Parameter options",
+            "properties": {
+              "poll": {
+                "type": "boolean",
+                "description": "Use polling instead of WebSocket for tracking execution"
+              },
+              "pollInterval": {
+                "type": "number",
+                "description": "Polling interval in ms (default 1000)"
+              },
+              "inputMap": {
+                "type": "InputMapping",
+                "description": "Named input mapping: semantic name -> { nodeId, field }"
+              },
+              "outputDir": {
+                "type": "string",
+                "description": "If provided, output images are downloaded to this directory"
+              }
+            }
+          }
+        },
+        "required": [
+          "workflow"
+        ],
+        "returns": "Promise<WorkflowResult>"
+      }
+    },
+    "getters": {
+      "clientId": {
+        "description": "The unique client ID used for WebSocket session tracking.",
+        "returns": "string"
+      },
+      "wsURL": {
+        "description": "The WebSocket URL derived from baseURL or overridden via options.",
+        "returns": "string"
+      }
+    },
+    "events": {
+      "execution_start": {
+        "name": "execution_start",
+        "description": "Event emitted by ComfyUIClient",
+        "arguments": {}
+      },
+      "execution_complete": {
+        "name": "execution_complete",
+        "description": "Event emitted by ComfyUIClient",
+        "arguments": {}
+      },
+      "executing": {
+        "name": "executing",
+        "description": "Event emitted by ComfyUIClient",
+        "arguments": {}
+      },
+      "progress": {
+        "name": "progress",
+        "description": "Event emitted by ComfyUIClient",
+        "arguments": {}
+      },
+      "executed": {
+        "name": "executed",
+        "description": "Event emitted by ComfyUIClient",
+        "arguments": {}
+      },
+      "execution_cached": {
+        "name": "execution_cached",
+        "description": "Event emitted by ComfyUIClient",
+        "arguments": {}
+      },
+      "execution_error": {
+        "name": "execution_error",
+        "description": "Event emitted by ComfyUIClient",
+        "arguments": {}
+      }
+    },
+    "state": {},
+    "options": {},
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const comfy = container.client('comfyui', { baseURL: 'http://localhost:8188' })\nconst result = await comfy.runWorkflow(workflow, {\n '6': { text: 'a beautiful sunset' }\n})\nconsole.log(result.images)"
+      }
+    ],
+    "types": {
+      "WorkflowRunOptions": {
+        "description": "",
+        "properties": {
+          "poll": {
+            "type": "boolean",
+            "description": "Use polling instead of WebSocket for tracking execution",
+            "optional": true
+          },
+          "pollInterval": {
+            "type": "number",
+            "description": "Polling interval in ms (default 1000)",
+            "optional": true
+          },
+          "inputMap": {
+            "type": "InputMapping",
+            "description": "Named input mapping: semantic name -> { nodeId, field }",
+            "optional": true
+          },
+          "outputDir": {
+            "type": "string",
+            "description": "If provided, output images are downloaded to this directory",
+            "optional": true
+          }
+        }
+      },
+      "WorkflowResult": {
+        "description": "",
+        "properties": {
+          "promptId": {
+            "type": "string",
+            "description": ""
+          },
+          "outputs": {
+            "type": "Record<string, any>",
+            "description": ""
+          },
+          "images": {
+            "type": "Array<{ filename: string; subfolder: string; type: string; localPath?: string }>",
+            "description": "",
+            "optional": true
+          }
+        }
+      }
+    }
+  },
+  {
+    "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))"
+          }
+        ]
       },
-      "toApiFormat": {
-        "description": "Convert a UI-format workflow to the API format that /prompt expects. Requires a running ComfyUI instance to fetch `object_info` so we can map positional `widgets_values` to their named input fields. If the workflow is already in API format, it's returned as-is.",
+      "synthesize": {
+        "description": "Synthesize speech from text, returning audio as a Buffer.",
         "parameters": {
-          "workflow": {
-            "type": "Record<string, any>",
-            "description": "Parameter workflow"
+          "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": [
-          "workflow"
+          "text"
         ],
-        "returns": "Promise<Record<string, any>>"
+        "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})"
+          }
+        ]
       },
-      "runWorkflow": {
-        "description": "Run a ComfyUI workflow with optional runtime input overrides. Inputs can be provided in two forms: **Direct node mapping** (when no `inputMap` in options): ``` { '3': { seed: 42 }, '6': { text: 'a cat' } } ``` **Named inputs** (when `inputMap` is provided in options): ``` inputs: { positive_prompt: 'a cat', seed: 42 } options.inputMap: { positive_prompt: { nodeId: '6', field: 'text' }, seed: { nodeId: '3', field: 'seed' } } ```",
+      "say": {
+        "description": "Synthesize speech and write the audio to a file.",
         "parameters": {
-          "workflow": {
-            "type": "Record<string, any>",
-            "description": "Parameter workflow"
+          "text": {
+            "type": "string",
+            "description": "The text to convert to speech"
           },
-          "inputs": {
-            "type": "Record<string, any>",
-            "description": "Parameter inputs"
+          "outputPath": {
+            "type": "string",
+            "description": "File path to write the audio to"
           },
           "options": {
-            "type": "WorkflowRunOptions",
-            "description": "Parameter options",
+            "type": "SynthesizeOptions",
+            "description": "Voice, model, format, and voice settings overrides",
             "properties": {
-              "poll": {
-                "type": "boolean",
-                "description": "Use polling instead of WebSocket for tracking execution"
-              },
-              "pollInterval": {
-                "type": "number",
-                "description": "Polling interval in ms (default 1000)"
+              "voiceId": {
+                "type": "string",
+                "description": ""
               },
-              "inputMap": {
-                "type": "InputMapping",
-                "description": "Named input mapping: semantic name -> { nodeId, field }"
+              "modelId": {
+                "type": "string",
+                "description": ""
               },
-              "outputDir": {
+              "outputFormat": {
                 "type": "string",
-                "description": "If provided, output images are downloaded to this directory"
+                "description": ""
+              },
+              "voiceSettings": {
+                "type": "ElevenLabsVoiceSettings",
+                "description": ""
+              },
+              "disableCache": {
+                "type": "boolean",
+                "description": ""
               }
             }
           }
         },
         "required": [
-          "workflow"
+          "text",
+          "outputPath"
         ],
-        "returns": "Promise<WorkflowResult>"
+        "returns": "Promise<string>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const path = await el.say('Hello world', './hello.mp3')\nconsole.log(`Audio saved to ${path}`)"
+          }
+        ]
       }
     },
     "getters": {
-      "clientId": {
-        "description": "The unique client ID used for WebSocket session tracking.",
-        "returns": "string"
-      },
-      "wsURL": {
-        "description": "The WebSocket URL derived from baseURL or overridden via options.",
+      "apiKey": {
+        "description": "The resolved API key from options or environment.",
         "returns": "string"
       }
     },
     "events": {
-      "execution_start": {
-        "name": "execution_start",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
-      },
-      "execution_complete": {
-        "name": "execution_complete",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
-      },
-      "executing": {
-        "name": "executing",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
-      },
-      "progress": {
-        "name": "progress",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
-      },
-      "executed": {
-        "name": "executed",
-        "description": "Event emitted by ComfyUIClient",
+      "failure": {
+        "name": "failure",
+        "description": "Event emitted by ElevenLabsClient",
         "arguments": {}
       },
-      "execution_cached": {
-        "name": "execution_cached",
-        "description": "Event emitted by ComfyUIClient",
+      "voices": {
+        "name": "voices",
+        "description": "Event emitted by ElevenLabsClient",
         "arguments": {}
       },
-      "execution_error": {
-        "name": "execution_error",
-        "description": "Event emitted by ComfyUIClient",
+      "speech": {
+        "name": "speech",
+        "description": "Event emitted by ElevenLabsClient",
         "arguments": {}
       }
     },
@@ -25759,48 +26441,65 @@ export const introspectionData = [
     "examples": [
       {
         "language": "ts",
-        "code": "const comfy = container.client('comfyui', { baseURL: 'http://localhost:8188' })\nconst result = await comfy.runWorkflow(workflow, {\n '6': { text: 'a beautiful sunset' }\n})\nconsole.log(result.images)"
+        "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"
       }
     ],
     "types": {
-      "WorkflowRunOptions": {
+      "SynthesizeOptions": {
         "description": "",
         "properties": {
-          "poll": {
-            "type": "boolean",
-            "description": "Use polling instead of WebSocket for tracking execution",
+          "voiceId": {
+            "type": "string",
+            "description": "",
             "optional": true
           },
-          "pollInterval": {
-            "type": "number",
-            "description": "Polling interval in ms (default 1000)",
+          "modelId": {
+            "type": "string",
+            "description": "",
             "optional": true
           },
-          "inputMap": {
-            "type": "InputMapping",
-            "description": "Named input mapping: semantic name -> { nodeId, field }",
+          "outputFormat": {
+            "type": "string",
+            "description": "",
             "optional": true
           },
-          "outputDir": {
-            "type": "string",
-            "description": "If provided, output images are downloaded to this directory",
+          "voiceSettings": {
+            "type": "ElevenLabsVoiceSettings",
+            "description": "",
+            "optional": true
+          },
+          "disableCache": {
+            "type": "boolean",
+            "description": "",
             "optional": true
           }
         }
       },
-      "WorkflowResult": {
+      "ElevenLabsVoiceSettings": {
         "description": "",
         "properties": {
-          "promptId": {
-            "type": "string",
-            "description": ""
+          "stability": {
+            "type": "number",
+            "description": "",
+            "optional": true
           },
-          "outputs": {
-            "type": "Record<string, any>",
-            "description": ""
+          "similarityBoost": {
+            "type": "number",
+            "description": "",
+            "optional": true
           },
-          "images": {
-            "type": "Array<{ filename: string; subfolder: string; type: string; localPath?: string }>",
+          "style": {
+            "type": "number",
+            "description": "",
+            "optional": true
+          },
+          "speed": {
+            "type": "number",
+            "description": "",
+            "optional": true
+          },
+          "useSpeakerBoost": {
+            "type": "boolean",
             "description": "",
             "optional": true
           }
@@ -26539,7 +27238,7 @@ export const containerIntrospectionData = [
           }
         ]
       },
-      "inspect": {
+      "introspect": {
         "description": "Returns a full introspection object for this container, merging build-time AST data (JSDoc descriptions, methods, getters) with runtime data (registries, factories, state, environment).",
         "parameters": {},
         "required": [],
@@ -26547,11 +27246,11 @@ export const containerIntrospectionData = [
         "examples": [
           {
             "language": "ts",
-            "code": "const info = container.inspect()\nconsole.log(info.methods)   // all public methods with descriptions\nconsole.log(info.getters)   // all getters with return types\nconsole.log(info.registries) // features, clients, servers, etc."
+            "code": "const info = container.introspect()\nconsole.log(info.methods)   // all public methods with descriptions\nconsole.log(info.getters)   // all getters with return types\nconsole.log(info.registries) // features, clients, servers, etc."
           }
         ]
       },
-      "inspectAsText": {
+      "introspectAsText": {
         "description": "Returns a human-readable markdown representation of this container's introspection data. Useful in REPLs, AI agent contexts, or documentation generation. Pass a section name to render only that section (e.g. 'methods', 'getters', 'events', 'state').",
         "parameters": {
           "sectionOrDepth": {
@@ -26568,32 +27267,17 @@ export const containerIntrospectionData = [
         "examples": [
           {
             "language": "ts",
-            "code": "console.log(container.inspectAsText())           // full description\nconsole.log(container.inspectAsText('methods'))   // just methods"
+            "code": "console.log(container.introspectAsText())           // full description\nconsole.log(container.introspectAsText('methods'))   // just methods"
           }
         ]
       },
-      "introspectAsText": {
-        "description": "Alias for inspectAsText.",
-        "parameters": {
-          "sectionOrDepth": {
-            "type": "IntrospectionSection | number",
-            "description": "Parameter sectionOrDepth"
-          },
-          "startHeadingDepth": {
-            "type": "number",
-            "description": "Parameter startHeadingDepth"
-          }
-        },
-        "required": [],
-        "returns": "string"
-      },
       "introspectAsJSON": {
-        "description": "Alias for inspect, returns JSON introspection data.",
+        "description": "Returns JSON introspection data.",
         "parameters": {},
         "required": [],
         "returns": "ContainerIntrospection"
       },
-      "inspectAsType": {
+      "introspectAsType": {
         "description": "Returns the container's introspection data formatted as a TypeScript interface declaration. Includes the container's own methods, getters, factories, and registered helper types.",
         "parameters": {},
         "required": [],
@@ -26601,16 +27285,10 @@ export const containerIntrospectionData = [
         "examples": [
           {
             "language": "ts",
-            "code": "console.log(container.inspectAsType())\n// interface NodeContainer {\n//   feature<T>(id: string, options?: object): T;\n//   readonly uuid: string;\n//   ...\n// }"
+            "code": "console.log(container.introspectAsType())\n// interface NodeContainer {\n//   feature<T>(id: string, options?: object): T;\n//   readonly uuid: string;\n//   ...\n// }"
           }
         ]
       },
-      "introspectAsType": {
-        "description": "",
-        "parameters": {},
-        "required": [],
-        "returns": "string"
-      },
       "sleep": {
         "description": "Sleep for the specified number of milliseconds. Useful for scripting and sequencing.",
         "parameters": {