@soederpop/luca 0.0.32 → 0.0.35

package/src/introspection/generated.agi.ts

@@ -1,7 +1,7 @@
 import { setBuildTimeData, setContainerBuildTimeData } from './index.js';
 
 // Auto-generated introspection registry data
-// Generated at: 2026-03-24T09:09:09.989Z
+// Generated at: 2026-03-27T03:29:26.633Z
 
 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,6 +7972,146 @@ setBuildTimeData('features.python', {
       "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": {
@@ -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,6 +12056,270 @@ 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).",
@@ -12189,270 +12813,6 @@ setBuildTimeData('clients.comfyui', {
   }
 });
 
-setBuildTimeData('clients.elevenlabs', {
-  "id": "clients.elevenlabs",
-  "description": "ElevenLabs client — text-to-speech synthesis via the ElevenLabs REST API. Provides methods for listing voices, listing models, and generating speech audio. Audio is returned as a Buffer; use `say()` for a convenience method that writes to disk.",
-  "shortcut": "clients.elevenlabs",
-  "className": "ElevenLabsClient",
-  "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('servers.mcp', {
   "id": "servers.mcp",
   "description": "MCP (Model Context Protocol) server for exposing tools, resources, and prompts to AI clients like Claude Code. Uses the low-level MCP SDK Server class directly with Zod 4 native JSON Schema conversion. Register tools, resources, and prompts programmatically, then start the server over stdio (for CLI integration) or HTTP (for remote access).",
@@ -16543,6 +16903,303 @@ setBuildTimeData('features.openaiCodex', {
   }
 });
 
+setBuildTimeData('features.lucaCoder', {
+  "id": "features.lucaCoder",
+  "description": "A coding assistant that owns a lower-level Assistant instance and gates all tool calls through a permission system. Comes with built-in Bash tool (via proc.execAndCapture) and auto-loads the luca-framework skill when found in .claude/skills paths. Tools are stacked from feature bundles (fileTools, etc.) and each tool can be set to 'allow' (runs immediately), 'ask' (blocks until user approves/denies), or 'deny' (always rejected).",
+  "shortcut": "features.lucaCoder",
+  "className": "LucaCoder",
+  "methods": {
+    "getPermission": {
+      "description": "Get the effective permission level for a tool.",
+      "parameters": {
+        "toolName": {
+          "type": "string",
+          "description": "Parameter toolName"
+        }
+      },
+      "required": [
+        "toolName"
+      ],
+      "returns": "PermissionLevel"
+    },
+    "setPermission": {
+      "description": "Set permission level for one or more tools.",
+      "parameters": {
+        "toolName": {
+          "type": "string | string[]",
+          "description": "Parameter toolName"
+        },
+        "level": {
+          "type": "PermissionLevel",
+          "description": "Parameter level"
+        }
+      },
+      "required": [
+        "toolName",
+        "level"
+      ],
+      "returns": "this"
+    },
+    "setDefaultPermission": {
+      "description": "Set the default permission level for unconfigured tools.",
+      "parameters": {
+        "level": {
+          "type": "PermissionLevel",
+          "description": "Parameter level"
+        }
+      },
+      "required": [
+        "level"
+      ],
+      "returns": "this"
+    },
+    "permitTool": {
+      "description": "Allow a tool (or tools) to run without approval.",
+      "parameters": {
+        "toolNames": {
+          "type": "string[]",
+          "description": "Parameter toolNames"
+        }
+      },
+      "required": [
+        "toolNames"
+      ],
+      "returns": "this"
+    },
+    "gateTool": {
+      "description": "Require approval before a tool (or tools) can run.",
+      "parameters": {
+        "toolNames": {
+          "type": "string[]",
+          "description": "Parameter toolNames"
+        }
+      },
+      "required": [
+        "toolNames"
+      ],
+      "returns": "this"
+    },
+    "blockTool": {
+      "description": "Block a tool (or tools) from ever running.",
+      "parameters": {
+        "toolNames": {
+          "type": "string[]",
+          "description": "Parameter toolNames"
+        }
+      },
+      "required": [
+        "toolNames"
+      ],
+      "returns": "this"
+    },
+    "approve": {
+      "description": "Approve a pending tool call by ID. The tool will execute.",
+      "parameters": {
+        "id": {
+          "type": "string",
+          "description": "Parameter id"
+        }
+      },
+      "required": [
+        "id"
+      ],
+      "returns": "this"
+    },
+    "deny": {
+      "description": "Deny a pending tool call by ID. The tool call will be skipped.",
+      "parameters": {
+        "id": {
+          "type": "string",
+          "description": "Parameter id"
+        }
+      },
+      "required": [
+        "id"
+      ],
+      "returns": "this"
+    },
+    "approveAll": {
+      "description": "Approve all pending tool calls.",
+      "parameters": {},
+      "required": [],
+      "returns": "this"
+    },
+    "denyAll": {
+      "description": "Deny all pending tool calls.",
+      "parameters": {},
+      "required": [],
+      "returns": "this"
+    },
+    "bash": {
+      "description": "Execute a shell command string and return its output. Uses proc.execAndCapture under the hood — runs `sh -c <command>`.",
+      "parameters": {
+        "{ command, cwd, timeout }": {
+          "type": "{ command: string; cwd?: string; timeout?: number }",
+          "description": "Parameter { command, cwd, timeout }"
+        }
+      },
+      "required": [
+        "{ command, cwd, timeout }"
+      ],
+      "returns": "Promise<{\n\t\texitCode: number\n\t\tstdout: string\n\t\tstderr: string\n\t\tsuccess: boolean\n\t}>"
+    },
+    "start": {
+      "description": "Initialize the inner assistant, register the bash tool, stack tool bundles, auto-load skills, and wire up the permission interceptor.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<this>"
+    },
+    "ask": {
+      "description": "Ask the coder a question. Auto-starts if needed. Tool calls will be gated by the permission system.",
+      "parameters": {
+        "question": {
+          "type": "string",
+          "description": "Parameter question"
+        },
+        "options": {
+          "type": "Record<string, any>",
+          "description": "Parameter options"
+        }
+      },
+      "required": [
+        "question"
+      ],
+      "returns": "Promise<string>"
+    },
+    "use": {
+      "description": "Add a tool bundle after initialization. Useful for dynamically extending the assistant's capabilities.",
+      "parameters": {
+        "spec": {
+          "type": "ToolBundleSpec",
+          "description": "Parameter spec"
+        }
+      },
+      "required": [
+        "spec"
+      ],
+      "returns": "this"
+    }
+  },
+  "getters": {
+    "assistant": {
+      "description": "The inner assistant. Throws if not started.",
+      "returns": "Assistant"
+    },
+    "permissions": {
+      "description": "Current permission map from state.",
+      "returns": "Record<string, PermissionLevel>"
+    },
+    "pendingApprovals": {
+      "description": "Current pending approvals.",
+      "returns": "PendingApproval[]"
+    },
+    "isStarted": {
+      "description": "Whether the assistant is started and ready.",
+      "returns": "boolean"
+    },
+    "tools": {
+      "description": "The tools registered on the inner assistant.",
+      "returns": "Record<string, any>"
+    },
+    "conversation": {
+      "description": "The conversation on the inner assistant (if started).",
+      "returns": "any"
+    },
+    "messages": {
+      "description": "Messages from the inner assistant's conversation.",
+      "returns": "any"
+    }
+  },
+  "events": {
+    "permissionGranted": {
+      "name": "permissionGranted",
+      "description": "Event emitted by LucaCoder",
+      "arguments": {}
+    },
+    "permissionDenied": {
+      "name": "permissionDenied",
+      "description": "Event emitted by LucaCoder",
+      "arguments": {}
+    },
+    "toolBlocked": {
+      "name": "toolBlocked",
+      "description": "Event emitted by LucaCoder",
+      "arguments": {}
+    },
+    "chunk": {
+      "name": "chunk",
+      "description": "Event emitted by LucaCoder",
+      "arguments": {}
+    },
+    "response": {
+      "name": "response",
+      "description": "Event emitted by LucaCoder",
+      "arguments": {}
+    },
+    "toolCall": {
+      "name": "toolCall",
+      "description": "Event emitted by LucaCoder",
+      "arguments": {}
+    },
+    "toolResult": {
+      "name": "toolResult",
+      "description": "Event emitted by LucaCoder",
+      "arguments": {}
+    },
+    "toolError": {
+      "name": "toolError",
+      "description": "Event emitted by LucaCoder",
+      "arguments": {}
+    },
+    "started": {
+      "name": "started",
+      "description": "Event emitted by LucaCoder",
+      "arguments": {}
+    },
+    "permissionRequest": {
+      "name": "permissionRequest",
+      "description": "Event emitted by LucaCoder",
+      "arguments": {}
+    }
+  },
+  "state": {},
+  "options": {},
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const coder = container.feature('lucaCoder', {\n tools: ['fileTools'],\n permissions: {\n   readFile: 'allow',\n   searchFiles: 'allow',\n   writeFile: 'ask',\n   bash: 'ask',\n },\n defaultPermission: 'ask',\n systemPrompt: 'You are a coding assistant.',\n})\n\ncoder.on('permissionRequest', ({ id, toolName, args }) => {\n console.log(`Tool \"${toolName}\" wants to run with`, args)\n coder.approve(id)  // or coder.deny(id)\n})\n\nawait coder.ask('Refactor the auth module to use async/await')"
+    }
+  ],
+  "types": {
+    "PendingApproval": {
+      "description": "A pending approval awaiting user decision.",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": ""
+        },
+        "toolName": {
+          "type": "string",
+          "description": ""
+        },
+        "args": {
+          "type": "Record<string, any>",
+          "description": ""
+        },
+        "timestamp": {
+          "type": "number",
+          "description": ""
+        },
+        "resolve": {
+          "type": "(decision: 'approve' | 'deny') => void",
+          "description": ""
+        }
+      }
+    }
+  }
+});
+
 setBuildTimeData('features.conversationHistory', {
   "id": "features.conversationHistory",
   "description": "Persists conversations to disk using the diskCache feature (cacache). Each conversation is stored as a JSON blob keyed by ID, with metadata stored alongside for efficient listing and search without loading full message arrays.",
@@ -17023,6 +17680,460 @@ setBuildTimeData('features.conversationHistory', {
   }
 });
 
+setBuildTimeData('features.autoAssistant', {
+  "id": "features.autoAssistant",
+  "description": "An autonomous assistant that owns a lower-level Assistant instance and gates all tool calls through a permission system. Tools are stacked from feature bundles (fileTools, processManager, etc.) and each tool can be set to 'allow' (runs immediately), 'ask' (blocks until user approves/denies), or 'deny' (always rejected).",
+  "shortcut": "features.autoAssistant",
+  "className": "AutonomousAssistant",
+  "methods": {
+    "getPermission": {
+      "description": "Get the effective permission level for a tool.",
+      "parameters": {
+        "toolName": {
+          "type": "string",
+          "description": "Parameter toolName"
+        }
+      },
+      "required": [
+        "toolName"
+      ],
+      "returns": "PermissionLevel"
+    },
+    "setPermission": {
+      "description": "Set permission level for one or more tools.",
+      "parameters": {
+        "toolName": {
+          "type": "string | string[]",
+          "description": "Parameter toolName"
+        },
+        "level": {
+          "type": "PermissionLevel",
+          "description": "Parameter level"
+        }
+      },
+      "required": [
+        "toolName",
+        "level"
+      ],
+      "returns": "this"
+    },
+    "setDefaultPermission": {
+      "description": "Set the default permission level for unconfigured tools.",
+      "parameters": {
+        "level": {
+          "type": "PermissionLevel",
+          "description": "Parameter level"
+        }
+      },
+      "required": [
+        "level"
+      ],
+      "returns": "this"
+    },
+    "permitTool": {
+      "description": "Allow a tool (or tools) to run without approval.",
+      "parameters": {
+        "toolNames": {
+          "type": "string[]",
+          "description": "Parameter toolNames"
+        }
+      },
+      "required": [
+        "toolNames"
+      ],
+      "returns": "this"
+    },
+    "gateTool": {
+      "description": "Require approval before a tool (or tools) can run.",
+      "parameters": {
+        "toolNames": {
+          "type": "string[]",
+          "description": "Parameter toolNames"
+        }
+      },
+      "required": [
+        "toolNames"
+      ],
+      "returns": "this"
+    },
+    "blockTool": {
+      "description": "Block a tool (or tools) from ever running.",
+      "parameters": {
+        "toolNames": {
+          "type": "string[]",
+          "description": "Parameter toolNames"
+        }
+      },
+      "required": [
+        "toolNames"
+      ],
+      "returns": "this"
+    },
+    "approve": {
+      "description": "Approve a pending tool call by ID. The tool will execute.",
+      "parameters": {
+        "id": {
+          "type": "string",
+          "description": "Parameter id"
+        }
+      },
+      "required": [
+        "id"
+      ],
+      "returns": "this"
+    },
+    "deny": {
+      "description": "Deny a pending tool call by ID. The tool call will be skipped.",
+      "parameters": {
+        "id": {
+          "type": "string",
+          "description": "Parameter id"
+        }
+      },
+      "required": [
+        "id"
+      ],
+      "returns": "this"
+    },
+    "approveAll": {
+      "description": "Approve all pending tool calls.",
+      "parameters": {},
+      "required": [],
+      "returns": "this"
+    },
+    "denyAll": {
+      "description": "Deny all pending tool calls.",
+      "parameters": {},
+      "required": [],
+      "returns": "this"
+    },
+    "start": {
+      "description": "Initialize the inner assistant, stack tool bundles, and wire up the permission interceptor.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<this>"
+    },
+    "ask": {
+      "description": "Ask the autonomous assistant a question. Auto-starts if needed. Tool calls will be gated by the permission system.",
+      "parameters": {
+        "question": {
+          "type": "string",
+          "description": "Parameter question"
+        },
+        "options": {
+          "type": "Record<string, any>",
+          "description": "Parameter options"
+        }
+      },
+      "required": [
+        "question"
+      ],
+      "returns": "Promise<string>"
+    },
+    "use": {
+      "description": "Add a tool bundle after initialization. Useful for dynamically extending the assistant's capabilities.",
+      "parameters": {
+        "spec": {
+          "type": "ToolBundleSpec",
+          "description": "Parameter spec"
+        }
+      },
+      "required": [
+        "spec"
+      ],
+      "returns": "this"
+    }
+  },
+  "getters": {
+    "assistant": {
+      "description": "The inner assistant. Throws if not started.",
+      "returns": "Assistant"
+    },
+    "permissions": {
+      "description": "Current permission map from state.",
+      "returns": "Record<string, PermissionLevel>"
+    },
+    "pendingApprovals": {
+      "description": "Current pending approvals.",
+      "returns": "PendingApproval[]"
+    },
+    "isStarted": {
+      "description": "Whether the assistant is started and ready.",
+      "returns": "boolean"
+    },
+    "tools": {
+      "description": "The tools registered on the inner assistant.",
+      "returns": "Record<string, any>"
+    },
+    "conversation": {
+      "description": "The conversation on the inner assistant (if started).",
+      "returns": "any"
+    },
+    "messages": {
+      "description": "Messages from the inner assistant's conversation.",
+      "returns": "any"
+    }
+  },
+  "events": {
+    "permissionGranted": {
+      "name": "permissionGranted",
+      "description": "Event emitted by AutonomousAssistant",
+      "arguments": {}
+    },
+    "permissionDenied": {
+      "name": "permissionDenied",
+      "description": "Event emitted by AutonomousAssistant",
+      "arguments": {}
+    },
+    "toolBlocked": {
+      "name": "toolBlocked",
+      "description": "Event emitted by AutonomousAssistant",
+      "arguments": {}
+    },
+    "chunk": {
+      "name": "chunk",
+      "description": "Event emitted by AutonomousAssistant",
+      "arguments": {}
+    },
+    "response": {
+      "name": "response",
+      "description": "Event emitted by AutonomousAssistant",
+      "arguments": {}
+    },
+    "toolCall": {
+      "name": "toolCall",
+      "description": "Event emitted by AutonomousAssistant",
+      "arguments": {}
+    },
+    "toolResult": {
+      "name": "toolResult",
+      "description": "Event emitted by AutonomousAssistant",
+      "arguments": {}
+    },
+    "toolError": {
+      "name": "toolError",
+      "description": "Event emitted by AutonomousAssistant",
+      "arguments": {}
+    },
+    "started": {
+      "name": "started",
+      "description": "Event emitted by AutonomousAssistant",
+      "arguments": {}
+    },
+    "permissionRequest": {
+      "name": "permissionRequest",
+      "description": "Event emitted by AutonomousAssistant",
+      "arguments": {}
+    }
+  },
+  "state": {},
+  "options": {},
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const auto = container.feature('autoAssistant', {\n tools: ['fileTools', { feature: 'processManager', except: ['killAllProcesses'] }],\n permissions: {\n   readFile: 'allow',\n   searchFiles: 'allow',\n   writeFile: 'ask',\n   editFile: 'ask',\n   deleteFile: 'deny',\n },\n defaultPermission: 'ask',\n systemPrompt: 'You are a coding assistant.',\n})\n\nauto.on('permissionRequest', ({ id, toolName, args }) => {\n console.log(`Tool \"${toolName}\" wants to run with`, args)\n // Show UI, then:\n auto.approve(id)  // or auto.deny(id)\n})\n\nawait auto.ask('Refactor the auth module to use async/await')"
+    }
+  ],
+  "types": {
+    "PendingApproval": {
+      "description": "A pending approval awaiting user decision.",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": ""
+        },
+        "toolName": {
+          "type": "string",
+          "description": ""
+        },
+        "args": {
+          "type": "Record<string, any>",
+          "description": ""
+        },
+        "timestamp": {
+          "type": "number",
+          "description": ""
+        },
+        "resolve": {
+          "type": "(decision: 'approve' | 'deny') => void",
+          "description": ""
+        }
+      }
+    }
+  }
+});
+
+setBuildTimeData('features.fileTools', {
+  "id": "features.fileTools",
+  "description": "Curated file-system and code-search tools for AI assistants. Wraps the container's `fs` and `grep` features into a focused tool surface modeled on the tools that coding assistants (Claude Code, Cursor, etc.) rely on: read, write, edit, list, search, find, stat, mkdir, move, copy, delete. Usage: ```typescript const fileTools = container.feature('fileTools') assistant.use(fileTools) // or selectively: assistant.use(fileTools.toTools({ only: ['readFile', 'searchFiles', 'listDirectory'] })) ```",
+  "shortcut": "features.fileTools",
+  "className": "FileTools",
+  "methods": {
+    "readFile": {
+      "description": "",
+      "parameters": {
+        "args": {
+          "type": "{ path: string; offset?: number; limit?: number }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "Promise<string>"
+    },
+    "writeFile": {
+      "description": "",
+      "parameters": {
+        "args": {
+          "type": "{ path: string; content: string }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "Promise<string>"
+    },
+    "editFile": {
+      "description": "",
+      "parameters": {
+        "args": {
+          "type": "{ path: string; oldString: string; newString: string; replaceAll?: boolean }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "Promise<string>"
+    },
+    "listDirectory": {
+      "description": "",
+      "parameters": {
+        "args": {
+          "type": "{ path?: string; recursive?: boolean; include?: string; exclude?: string }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "Promise<string>"
+    },
+    "searchFiles": {
+      "description": "",
+      "parameters": {
+        "args": {
+          "type": "{ pattern: string; path?: string; include?: string; exclude?: string; ignoreCase?: boolean; maxResults?: number }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "Promise<string>"
+    },
+    "findFiles": {
+      "description": "",
+      "parameters": {
+        "args": {
+          "type": "{ pattern: string; path?: string; exclude?: string }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "Promise<string>"
+    },
+    "fileInfo": {
+      "description": "",
+      "parameters": {
+        "args": {
+          "type": "{ path: string }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "Promise<string>"
+    },
+    "createDirectory": {
+      "description": "",
+      "parameters": {
+        "args": {
+          "type": "{ path: string }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "Promise<string>"
+    },
+    "moveFile": {
+      "description": "",
+      "parameters": {
+        "args": {
+          "type": "{ source: string; destination: string }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "Promise<string>"
+    },
+    "copyFile": {
+      "description": "",
+      "parameters": {
+        "args": {
+          "type": "{ source: string; destination: string }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "Promise<string>"
+    },
+    "deleteFile": {
+      "description": "",
+      "parameters": {
+        "args": {
+          "type": "{ path: string }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "Promise<string>"
+    },
+    "setupToolsConsumer": {
+      "description": "When an assistant uses fileTools, inject system prompt guidance about how to use the tools effectively.",
+      "parameters": {
+        "consumer": {
+          "type": "Helper",
+          "description": "Parameter consumer"
+        }
+      },
+      "required": [
+        "consumer"
+      ],
+      "returns": "void"
+    }
+  },
+  "getters": {},
+  "events": {},
+  "state": {},
+  "options": {},
+  "envVars": []
+});
+
 // Container introspection data
 setContainerBuildTimeData('Container', {
   "className": "Container",
@@ -17254,7 +18365,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": [],
@@ -17262,11 +18373,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": {
@@ -17283,32 +18394,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": [],
@@ -17316,16 +18412,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": {
@@ -23428,6 +24518,311 @@ 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",
     "description": "The FS feature provides methods for interacting with the file system, relative to the container's cwd.",
@@ -25063,7 +26458,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": {
@@ -25163,6 +26558,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": {
@@ -25219,6 +26754,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": {},
@@ -25227,9 +26777,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",
@@ -25864,135 +27443,6 @@ export const introspectionData = [
       }
     }
   },
-  {
-    "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})"
-      }
-    ]
-  },
   {
     "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.",
@@ -29177,6 +30627,269 @@ export const introspectionData = [
       }
     ]
   },
+  {
+    "id": "clients.elevenlabs",
+    "description": "ElevenLabs client — text-to-speech synthesis via the ElevenLabs REST API. Provides methods for listing voices, listing models, and generating speech audio. Audio is returned as a Buffer; use `say()` for a convenience method that writes to disk.",
+    "shortcut": "clients.elevenlabs",
+    "className": "ElevenLabsClient",
+    "methods": {
+      "beforeRequest": {
+        "description": "Inject the xi-api-key header before each request.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "connect": {
+        "description": "Validate the API key by listing available models.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<this>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "await el.connect()"
+          }
+        ]
+      },
+      "listVoices": {
+        "description": "List available voices with optional search and filtering.",
+        "parameters": {
+          "options": {
+            "type": "{\n    search?: string\n    category?: string\n    voice_type?: string\n    page_size?: number\n    next_page_token?: string\n  }",
+            "description": "Query parameters for filtering voices"
+          }
+        },
+        "required": [],
+        "returns": "Promise<any>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const voices = await el.listVoices()\nconst premade = await el.listVoices({ category: 'premade' })"
+          }
+        ]
+      },
+      "getVoice": {
+        "description": "Get details for a single voice.",
+        "parameters": {
+          "voiceId": {
+            "type": "string",
+            "description": "The voice ID to look up"
+          }
+        },
+        "required": [
+          "voiceId"
+        ],
+        "returns": "Promise<any>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const voice = await el.getVoice('21m00Tcm4TlvDq8ikWAM')\nconsole.log(voice.name, voice.settings)"
+          }
+        ]
+      },
+      "listModels": {
+        "description": "List available TTS models.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<any[]>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const models = await el.listModels()\nconsole.log(models.map(m => m.model_id))"
+          }
+        ]
+      },
+      "synthesize": {
+        "description": "Synthesize speech from text, returning audio as a Buffer.",
+        "parameters": {
+          "text": {
+            "type": "string",
+            "description": "The text to convert to speech"
+          },
+          "options": {
+            "type": "SynthesizeOptions",
+            "description": "Voice, model, format, and voice settings overrides",
+            "properties": {
+              "voiceId": {
+                "type": "string",
+                "description": ""
+              },
+              "modelId": {
+                "type": "string",
+                "description": ""
+              },
+              "outputFormat": {
+                "type": "string",
+                "description": ""
+              },
+              "voiceSettings": {
+                "type": "ElevenLabsVoiceSettings",
+                "description": ""
+              },
+              "disableCache": {
+                "type": "boolean",
+                "description": ""
+              }
+            }
+          }
+        },
+        "required": [
+          "text"
+        ],
+        "returns": "Promise<Buffer>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data\n\nconst custom = await el.synthesize('Hello', {\n voiceId: '21m00Tcm4TlvDq8ikWAM',\n voiceSettings: { stability: 0.5, similarityBoost: 0.8 }\n})"
+          }
+        ]
+      },
+      "say": {
+        "description": "Synthesize speech and write the audio to a file.",
+        "parameters": {
+          "text": {
+            "type": "string",
+            "description": "The text to convert to speech"
+          },
+          "outputPath": {
+            "type": "string",
+            "description": "File path to write the audio to"
+          },
+          "options": {
+            "type": "SynthesizeOptions",
+            "description": "Voice, model, format, and voice settings overrides",
+            "properties": {
+              "voiceId": {
+                "type": "string",
+                "description": ""
+              },
+              "modelId": {
+                "type": "string",
+                "description": ""
+              },
+              "outputFormat": {
+                "type": "string",
+                "description": ""
+              },
+              "voiceSettings": {
+                "type": "ElevenLabsVoiceSettings",
+                "description": ""
+              },
+              "disableCache": {
+                "type": "boolean",
+                "description": ""
+              }
+            }
+          }
+        },
+        "required": [
+          "text",
+          "outputPath"
+        ],
+        "returns": "Promise<string>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const path = await el.say('Hello world', './hello.mp3')\nconsole.log(`Audio saved to ${path}`)"
+          }
+        ]
+      }
+    },
+    "getters": {
+      "apiKey": {
+        "description": "The resolved API key from options or environment.",
+        "returns": "string"
+      }
+    },
+    "events": {
+      "failure": {
+        "name": "failure",
+        "description": "Event emitted by ElevenLabsClient",
+        "arguments": {}
+      },
+      "voices": {
+        "name": "voices",
+        "description": "Event emitted by ElevenLabsClient",
+        "arguments": {}
+      },
+      "speech": {
+        "name": "speech",
+        "description": "Event emitted by ElevenLabsClient",
+        "arguments": {}
+      }
+    },
+    "state": {},
+    "options": {},
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const el = container.client('elevenlabs')\nawait el.connect()\nconst voices = await el.listVoices()\nconst audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data"
+      }
+    ],
+    "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
+          }
+        }
+      }
+    }
+  },
   {
     "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).",
@@ -29668,269 +31381,6 @@ export const introspectionData = [
       }
     }
   },
-  {
-    "id": "clients.elevenlabs",
-    "description": "ElevenLabs client — text-to-speech synthesis via the ElevenLabs REST API. Provides methods for listing voices, listing models, and generating speech audio. Audio is returned as a Buffer; use `say()` for a convenience method that writes to disk.",
-    "shortcut": "clients.elevenlabs",
-    "className": "ElevenLabsClient",
-    "methods": {
-      "beforeRequest": {
-        "description": "Inject the xi-api-key header before each request.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "connect": {
-        "description": "Validate the API key by listing available models.",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<this>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "await el.connect()"
-          }
-        ]
-      },
-      "listVoices": {
-        "description": "List available voices with optional search and filtering.",
-        "parameters": {
-          "options": {
-            "type": "{\n    search?: string\n    category?: string\n    voice_type?: string\n    page_size?: number\n    next_page_token?: string\n  }",
-            "description": "Query parameters for filtering voices"
-          }
-        },
-        "required": [],
-        "returns": "Promise<any>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const voices = await el.listVoices()\nconst premade = await el.listVoices({ category: 'premade' })"
-          }
-        ]
-      },
-      "getVoice": {
-        "description": "Get details for a single voice.",
-        "parameters": {
-          "voiceId": {
-            "type": "string",
-            "description": "The voice ID to look up"
-          }
-        },
-        "required": [
-          "voiceId"
-        ],
-        "returns": "Promise<any>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const voice = await el.getVoice('21m00Tcm4TlvDq8ikWAM')\nconsole.log(voice.name, voice.settings)"
-          }
-        ]
-      },
-      "listModels": {
-        "description": "List available TTS models.",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<any[]>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const models = await el.listModels()\nconsole.log(models.map(m => m.model_id))"
-          }
-        ]
-      },
-      "synthesize": {
-        "description": "Synthesize speech from text, returning audio as a Buffer.",
-        "parameters": {
-          "text": {
-            "type": "string",
-            "description": "The text to convert to speech"
-          },
-          "options": {
-            "type": "SynthesizeOptions",
-            "description": "Voice, model, format, and voice settings overrides",
-            "properties": {
-              "voiceId": {
-                "type": "string",
-                "description": ""
-              },
-              "modelId": {
-                "type": "string",
-                "description": ""
-              },
-              "outputFormat": {
-                "type": "string",
-                "description": ""
-              },
-              "voiceSettings": {
-                "type": "ElevenLabsVoiceSettings",
-                "description": ""
-              },
-              "disableCache": {
-                "type": "boolean",
-                "description": ""
-              }
-            }
-          }
-        },
-        "required": [
-          "text"
-        ],
-        "returns": "Promise<Buffer>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data\n\nconst custom = await el.synthesize('Hello', {\n voiceId: '21m00Tcm4TlvDq8ikWAM',\n voiceSettings: { stability: 0.5, similarityBoost: 0.8 }\n})"
-          }
-        ]
-      },
-      "say": {
-        "description": "Synthesize speech and write the audio to a file.",
-        "parameters": {
-          "text": {
-            "type": "string",
-            "description": "The text to convert to speech"
-          },
-          "outputPath": {
-            "type": "string",
-            "description": "File path to write the audio to"
-          },
-          "options": {
-            "type": "SynthesizeOptions",
-            "description": "Voice, model, format, and voice settings overrides",
-            "properties": {
-              "voiceId": {
-                "type": "string",
-                "description": ""
-              },
-              "modelId": {
-                "type": "string",
-                "description": ""
-              },
-              "outputFormat": {
-                "type": "string",
-                "description": ""
-              },
-              "voiceSettings": {
-                "type": "ElevenLabsVoiceSettings",
-                "description": ""
-              },
-              "disableCache": {
-                "type": "boolean",
-                "description": ""
-              }
-            }
-          }
-        },
-        "required": [
-          "text",
-          "outputPath"
-        ],
-        "returns": "Promise<string>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const path = await el.say('Hello world', './hello.mp3')\nconsole.log(`Audio saved to ${path}`)"
-          }
-        ]
-      }
-    },
-    "getters": {
-      "apiKey": {
-        "description": "The resolved API key from options or environment.",
-        "returns": "string"
-      }
-    },
-    "events": {
-      "failure": {
-        "name": "failure",
-        "description": "Event emitted by ElevenLabsClient",
-        "arguments": {}
-      },
-      "voices": {
-        "name": "voices",
-        "description": "Event emitted by ElevenLabsClient",
-        "arguments": {}
-      },
-      "speech": {
-        "name": "speech",
-        "description": "Event emitted by ElevenLabsClient",
-        "arguments": {}
-      }
-    },
-    "state": {},
-    "options": {},
-    "envVars": [],
-    "examples": [
-      {
-        "language": "ts",
-        "code": "const el = container.client('elevenlabs')\nawait el.connect()\nconst voices = await el.listVoices()\nconst audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data"
-      }
-    ],
-    "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
-          }
-        }
-      }
-    }
-  },
   {
     "id": "servers.mcp",
     "description": "MCP (Model Context Protocol) server for exposing tools, resources, and prompts to AI clients like Claude Code. Uses the low-level MCP SDK Server class directly with Zod 4 native JSON Schema conversion. Register tools, resources, and prompts programmatically, then start the server over stdio (for CLI integration) or HTTP (for remote access).",
@@ -34009,6 +35459,302 @@ export const introspectionData = [
       }
     }
   },
+  {
+    "id": "features.lucaCoder",
+    "description": "A coding assistant that owns a lower-level Assistant instance and gates all tool calls through a permission system. Comes with built-in Bash tool (via proc.execAndCapture) and auto-loads the luca-framework skill when found in .claude/skills paths. Tools are stacked from feature bundles (fileTools, etc.) and each tool can be set to 'allow' (runs immediately), 'ask' (blocks until user approves/denies), or 'deny' (always rejected).",
+    "shortcut": "features.lucaCoder",
+    "className": "LucaCoder",
+    "methods": {
+      "getPermission": {
+        "description": "Get the effective permission level for a tool.",
+        "parameters": {
+          "toolName": {
+            "type": "string",
+            "description": "Parameter toolName"
+          }
+        },
+        "required": [
+          "toolName"
+        ],
+        "returns": "PermissionLevel"
+      },
+      "setPermission": {
+        "description": "Set permission level for one or more tools.",
+        "parameters": {
+          "toolName": {
+            "type": "string | string[]",
+            "description": "Parameter toolName"
+          },
+          "level": {
+            "type": "PermissionLevel",
+            "description": "Parameter level"
+          }
+        },
+        "required": [
+          "toolName",
+          "level"
+        ],
+        "returns": "this"
+      },
+      "setDefaultPermission": {
+        "description": "Set the default permission level for unconfigured tools.",
+        "parameters": {
+          "level": {
+            "type": "PermissionLevel",
+            "description": "Parameter level"
+          }
+        },
+        "required": [
+          "level"
+        ],
+        "returns": "this"
+      },
+      "permitTool": {
+        "description": "Allow a tool (or tools) to run without approval.",
+        "parameters": {
+          "toolNames": {
+            "type": "string[]",
+            "description": "Parameter toolNames"
+          }
+        },
+        "required": [
+          "toolNames"
+        ],
+        "returns": "this"
+      },
+      "gateTool": {
+        "description": "Require approval before a tool (or tools) can run.",
+        "parameters": {
+          "toolNames": {
+            "type": "string[]",
+            "description": "Parameter toolNames"
+          }
+        },
+        "required": [
+          "toolNames"
+        ],
+        "returns": "this"
+      },
+      "blockTool": {
+        "description": "Block a tool (or tools) from ever running.",
+        "parameters": {
+          "toolNames": {
+            "type": "string[]",
+            "description": "Parameter toolNames"
+          }
+        },
+        "required": [
+          "toolNames"
+        ],
+        "returns": "this"
+      },
+      "approve": {
+        "description": "Approve a pending tool call by ID. The tool will execute.",
+        "parameters": {
+          "id": {
+            "type": "string",
+            "description": "Parameter id"
+          }
+        },
+        "required": [
+          "id"
+        ],
+        "returns": "this"
+      },
+      "deny": {
+        "description": "Deny a pending tool call by ID. The tool call will be skipped.",
+        "parameters": {
+          "id": {
+            "type": "string",
+            "description": "Parameter id"
+          }
+        },
+        "required": [
+          "id"
+        ],
+        "returns": "this"
+      },
+      "approveAll": {
+        "description": "Approve all pending tool calls.",
+        "parameters": {},
+        "required": [],
+        "returns": "this"
+      },
+      "denyAll": {
+        "description": "Deny all pending tool calls.",
+        "parameters": {},
+        "required": [],
+        "returns": "this"
+      },
+      "bash": {
+        "description": "Execute a shell command string and return its output. Uses proc.execAndCapture under the hood — runs `sh -c <command>`.",
+        "parameters": {
+          "{ command, cwd, timeout }": {
+            "type": "{ command: string; cwd?: string; timeout?: number }",
+            "description": "Parameter { command, cwd, timeout }"
+          }
+        },
+        "required": [
+          "{ command, cwd, timeout }"
+        ],
+        "returns": "Promise<{\n\t\texitCode: number\n\t\tstdout: string\n\t\tstderr: string\n\t\tsuccess: boolean\n\t}>"
+      },
+      "start": {
+        "description": "Initialize the inner assistant, register the bash tool, stack tool bundles, auto-load skills, and wire up the permission interceptor.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<this>"
+      },
+      "ask": {
+        "description": "Ask the coder a question. Auto-starts if needed. Tool calls will be gated by the permission system.",
+        "parameters": {
+          "question": {
+            "type": "string",
+            "description": "Parameter question"
+          },
+          "options": {
+            "type": "Record<string, any>",
+            "description": "Parameter options"
+          }
+        },
+        "required": [
+          "question"
+        ],
+        "returns": "Promise<string>"
+      },
+      "use": {
+        "description": "Add a tool bundle after initialization. Useful for dynamically extending the assistant's capabilities.",
+        "parameters": {
+          "spec": {
+            "type": "ToolBundleSpec",
+            "description": "Parameter spec"
+          }
+        },
+        "required": [
+          "spec"
+        ],
+        "returns": "this"
+      }
+    },
+    "getters": {
+      "assistant": {
+        "description": "The inner assistant. Throws if not started.",
+        "returns": "Assistant"
+      },
+      "permissions": {
+        "description": "Current permission map from state.",
+        "returns": "Record<string, PermissionLevel>"
+      },
+      "pendingApprovals": {
+        "description": "Current pending approvals.",
+        "returns": "PendingApproval[]"
+      },
+      "isStarted": {
+        "description": "Whether the assistant is started and ready.",
+        "returns": "boolean"
+      },
+      "tools": {
+        "description": "The tools registered on the inner assistant.",
+        "returns": "Record<string, any>"
+      },
+      "conversation": {
+        "description": "The conversation on the inner assistant (if started).",
+        "returns": "any"
+      },
+      "messages": {
+        "description": "Messages from the inner assistant's conversation.",
+        "returns": "any"
+      }
+    },
+    "events": {
+      "permissionGranted": {
+        "name": "permissionGranted",
+        "description": "Event emitted by LucaCoder",
+        "arguments": {}
+      },
+      "permissionDenied": {
+        "name": "permissionDenied",
+        "description": "Event emitted by LucaCoder",
+        "arguments": {}
+      },
+      "toolBlocked": {
+        "name": "toolBlocked",
+        "description": "Event emitted by LucaCoder",
+        "arguments": {}
+      },
+      "chunk": {
+        "name": "chunk",
+        "description": "Event emitted by LucaCoder",
+        "arguments": {}
+      },
+      "response": {
+        "name": "response",
+        "description": "Event emitted by LucaCoder",
+        "arguments": {}
+      },
+      "toolCall": {
+        "name": "toolCall",
+        "description": "Event emitted by LucaCoder",
+        "arguments": {}
+      },
+      "toolResult": {
+        "name": "toolResult",
+        "description": "Event emitted by LucaCoder",
+        "arguments": {}
+      },
+      "toolError": {
+        "name": "toolError",
+        "description": "Event emitted by LucaCoder",
+        "arguments": {}
+      },
+      "started": {
+        "name": "started",
+        "description": "Event emitted by LucaCoder",
+        "arguments": {}
+      },
+      "permissionRequest": {
+        "name": "permissionRequest",
+        "description": "Event emitted by LucaCoder",
+        "arguments": {}
+      }
+    },
+    "state": {},
+    "options": {},
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const coder = container.feature('lucaCoder', {\n tools: ['fileTools'],\n permissions: {\n   readFile: 'allow',\n   searchFiles: 'allow',\n   writeFile: 'ask',\n   bash: 'ask',\n },\n defaultPermission: 'ask',\n systemPrompt: 'You are a coding assistant.',\n})\n\ncoder.on('permissionRequest', ({ id, toolName, args }) => {\n console.log(`Tool \"${toolName}\" wants to run with`, args)\n coder.approve(id)  // or coder.deny(id)\n})\n\nawait coder.ask('Refactor the auth module to use async/await')"
+      }
+    ],
+    "types": {
+      "PendingApproval": {
+        "description": "A pending approval awaiting user decision.",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": ""
+          },
+          "toolName": {
+            "type": "string",
+            "description": ""
+          },
+          "args": {
+            "type": "Record<string, any>",
+            "description": ""
+          },
+          "timestamp": {
+            "type": "number",
+            "description": ""
+          },
+          "resolve": {
+            "type": "(decision: 'approve' | 'deny') => void",
+            "description": ""
+          }
+        }
+      }
+    }
+  },
   {
     "id": "features.conversationHistory",
     "description": "Persists conversations to disk using the diskCache feature (cacache). Each conversation is stored as a JSON blob keyed by ID, with metadata stored alongside for efficient listing and search without loading full message arrays.",
@@ -34487,6 +36233,458 @@ export const introspectionData = [
         }
       }
     }
+  },
+  {
+    "id": "features.autoAssistant",
+    "description": "An autonomous assistant that owns a lower-level Assistant instance and gates all tool calls through a permission system. Tools are stacked from feature bundles (fileTools, processManager, etc.) and each tool can be set to 'allow' (runs immediately), 'ask' (blocks until user approves/denies), or 'deny' (always rejected).",
+    "shortcut": "features.autoAssistant",
+    "className": "AutonomousAssistant",
+    "methods": {
+      "getPermission": {
+        "description": "Get the effective permission level for a tool.",
+        "parameters": {
+          "toolName": {
+            "type": "string",
+            "description": "Parameter toolName"
+          }
+        },
+        "required": [
+          "toolName"
+        ],
+        "returns": "PermissionLevel"
+      },
+      "setPermission": {
+        "description": "Set permission level for one or more tools.",
+        "parameters": {
+          "toolName": {
+            "type": "string | string[]",
+            "description": "Parameter toolName"
+          },
+          "level": {
+            "type": "PermissionLevel",
+            "description": "Parameter level"
+          }
+        },
+        "required": [
+          "toolName",
+          "level"
+        ],
+        "returns": "this"
+      },
+      "setDefaultPermission": {
+        "description": "Set the default permission level for unconfigured tools.",
+        "parameters": {
+          "level": {
+            "type": "PermissionLevel",
+            "description": "Parameter level"
+          }
+        },
+        "required": [
+          "level"
+        ],
+        "returns": "this"
+      },
+      "permitTool": {
+        "description": "Allow a tool (or tools) to run without approval.",
+        "parameters": {
+          "toolNames": {
+            "type": "string[]",
+            "description": "Parameter toolNames"
+          }
+        },
+        "required": [
+          "toolNames"
+        ],
+        "returns": "this"
+      },
+      "gateTool": {
+        "description": "Require approval before a tool (or tools) can run.",
+        "parameters": {
+          "toolNames": {
+            "type": "string[]",
+            "description": "Parameter toolNames"
+          }
+        },
+        "required": [
+          "toolNames"
+        ],
+        "returns": "this"
+      },
+      "blockTool": {
+        "description": "Block a tool (or tools) from ever running.",
+        "parameters": {
+          "toolNames": {
+            "type": "string[]",
+            "description": "Parameter toolNames"
+          }
+        },
+        "required": [
+          "toolNames"
+        ],
+        "returns": "this"
+      },
+      "approve": {
+        "description": "Approve a pending tool call by ID. The tool will execute.",
+        "parameters": {
+          "id": {
+            "type": "string",
+            "description": "Parameter id"
+          }
+        },
+        "required": [
+          "id"
+        ],
+        "returns": "this"
+      },
+      "deny": {
+        "description": "Deny a pending tool call by ID. The tool call will be skipped.",
+        "parameters": {
+          "id": {
+            "type": "string",
+            "description": "Parameter id"
+          }
+        },
+        "required": [
+          "id"
+        ],
+        "returns": "this"
+      },
+      "approveAll": {
+        "description": "Approve all pending tool calls.",
+        "parameters": {},
+        "required": [],
+        "returns": "this"
+      },
+      "denyAll": {
+        "description": "Deny all pending tool calls.",
+        "parameters": {},
+        "required": [],
+        "returns": "this"
+      },
+      "start": {
+        "description": "Initialize the inner assistant, stack tool bundles, and wire up the permission interceptor.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<this>"
+      },
+      "ask": {
+        "description": "Ask the autonomous assistant a question. Auto-starts if needed. Tool calls will be gated by the permission system.",
+        "parameters": {
+          "question": {
+            "type": "string",
+            "description": "Parameter question"
+          },
+          "options": {
+            "type": "Record<string, any>",
+            "description": "Parameter options"
+          }
+        },
+        "required": [
+          "question"
+        ],
+        "returns": "Promise<string>"
+      },
+      "use": {
+        "description": "Add a tool bundle after initialization. Useful for dynamically extending the assistant's capabilities.",
+        "parameters": {
+          "spec": {
+            "type": "ToolBundleSpec",
+            "description": "Parameter spec"
+          }
+        },
+        "required": [
+          "spec"
+        ],
+        "returns": "this"
+      }
+    },
+    "getters": {
+      "assistant": {
+        "description": "The inner assistant. Throws if not started.",
+        "returns": "Assistant"
+      },
+      "permissions": {
+        "description": "Current permission map from state.",
+        "returns": "Record<string, PermissionLevel>"
+      },
+      "pendingApprovals": {
+        "description": "Current pending approvals.",
+        "returns": "PendingApproval[]"
+      },
+      "isStarted": {
+        "description": "Whether the assistant is started and ready.",
+        "returns": "boolean"
+      },
+      "tools": {
+        "description": "The tools registered on the inner assistant.",
+        "returns": "Record<string, any>"
+      },
+      "conversation": {
+        "description": "The conversation on the inner assistant (if started).",
+        "returns": "any"
+      },
+      "messages": {
+        "description": "Messages from the inner assistant's conversation.",
+        "returns": "any"
+      }
+    },
+    "events": {
+      "permissionGranted": {
+        "name": "permissionGranted",
+        "description": "Event emitted by AutonomousAssistant",
+        "arguments": {}
+      },
+      "permissionDenied": {
+        "name": "permissionDenied",
+        "description": "Event emitted by AutonomousAssistant",
+        "arguments": {}
+      },
+      "toolBlocked": {
+        "name": "toolBlocked",
+        "description": "Event emitted by AutonomousAssistant",
+        "arguments": {}
+      },
+      "chunk": {
+        "name": "chunk",
+        "description": "Event emitted by AutonomousAssistant",
+        "arguments": {}
+      },
+      "response": {
+        "name": "response",
+        "description": "Event emitted by AutonomousAssistant",
+        "arguments": {}
+      },
+      "toolCall": {
+        "name": "toolCall",
+        "description": "Event emitted by AutonomousAssistant",
+        "arguments": {}
+      },
+      "toolResult": {
+        "name": "toolResult",
+        "description": "Event emitted by AutonomousAssistant",
+        "arguments": {}
+      },
+      "toolError": {
+        "name": "toolError",
+        "description": "Event emitted by AutonomousAssistant",
+        "arguments": {}
+      },
+      "started": {
+        "name": "started",
+        "description": "Event emitted by AutonomousAssistant",
+        "arguments": {}
+      },
+      "permissionRequest": {
+        "name": "permissionRequest",
+        "description": "Event emitted by AutonomousAssistant",
+        "arguments": {}
+      }
+    },
+    "state": {},
+    "options": {},
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const auto = container.feature('autoAssistant', {\n tools: ['fileTools', { feature: 'processManager', except: ['killAllProcesses'] }],\n permissions: {\n   readFile: 'allow',\n   searchFiles: 'allow',\n   writeFile: 'ask',\n   editFile: 'ask',\n   deleteFile: 'deny',\n },\n defaultPermission: 'ask',\n systemPrompt: 'You are a coding assistant.',\n})\n\nauto.on('permissionRequest', ({ id, toolName, args }) => {\n console.log(`Tool \"${toolName}\" wants to run with`, args)\n // Show UI, then:\n auto.approve(id)  // or auto.deny(id)\n})\n\nawait auto.ask('Refactor the auth module to use async/await')"
+      }
+    ],
+    "types": {
+      "PendingApproval": {
+        "description": "A pending approval awaiting user decision.",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": ""
+          },
+          "toolName": {
+            "type": "string",
+            "description": ""
+          },
+          "args": {
+            "type": "Record<string, any>",
+            "description": ""
+          },
+          "timestamp": {
+            "type": "number",
+            "description": ""
+          },
+          "resolve": {
+            "type": "(decision: 'approve' | 'deny') => void",
+            "description": ""
+          }
+        }
+      }
+    }
+  },
+  {
+    "id": "features.fileTools",
+    "description": "Curated file-system and code-search tools for AI assistants. Wraps the container's `fs` and `grep` features into a focused tool surface modeled on the tools that coding assistants (Claude Code, Cursor, etc.) rely on: read, write, edit, list, search, find, stat, mkdir, move, copy, delete. Usage: ```typescript const fileTools = container.feature('fileTools') assistant.use(fileTools) // or selectively: assistant.use(fileTools.toTools({ only: ['readFile', 'searchFiles', 'listDirectory'] })) ```",
+    "shortcut": "features.fileTools",
+    "className": "FileTools",
+    "methods": {
+      "readFile": {
+        "description": "",
+        "parameters": {
+          "args": {
+            "type": "{ path: string; offset?: number; limit?: number }",
+            "description": "Parameter args"
+          }
+        },
+        "required": [
+          "args"
+        ],
+        "returns": "Promise<string>"
+      },
+      "writeFile": {
+        "description": "",
+        "parameters": {
+          "args": {
+            "type": "{ path: string; content: string }",
+            "description": "Parameter args"
+          }
+        },
+        "required": [
+          "args"
+        ],
+        "returns": "Promise<string>"
+      },
+      "editFile": {
+        "description": "",
+        "parameters": {
+          "args": {
+            "type": "{ path: string; oldString: string; newString: string; replaceAll?: boolean }",
+            "description": "Parameter args"
+          }
+        },
+        "required": [
+          "args"
+        ],
+        "returns": "Promise<string>"
+      },
+      "listDirectory": {
+        "description": "",
+        "parameters": {
+          "args": {
+            "type": "{ path?: string; recursive?: boolean; include?: string; exclude?: string }",
+            "description": "Parameter args"
+          }
+        },
+        "required": [
+          "args"
+        ],
+        "returns": "Promise<string>"
+      },
+      "searchFiles": {
+        "description": "",
+        "parameters": {
+          "args": {
+            "type": "{ pattern: string; path?: string; include?: string; exclude?: string; ignoreCase?: boolean; maxResults?: number }",
+            "description": "Parameter args"
+          }
+        },
+        "required": [
+          "args"
+        ],
+        "returns": "Promise<string>"
+      },
+      "findFiles": {
+        "description": "",
+        "parameters": {
+          "args": {
+            "type": "{ pattern: string; path?: string; exclude?: string }",
+            "description": "Parameter args"
+          }
+        },
+        "required": [
+          "args"
+        ],
+        "returns": "Promise<string>"
+      },
+      "fileInfo": {
+        "description": "",
+        "parameters": {
+          "args": {
+            "type": "{ path: string }",
+            "description": "Parameter args"
+          }
+        },
+        "required": [
+          "args"
+        ],
+        "returns": "Promise<string>"
+      },
+      "createDirectory": {
+        "description": "",
+        "parameters": {
+          "args": {
+            "type": "{ path: string }",
+            "description": "Parameter args"
+          }
+        },
+        "required": [
+          "args"
+        ],
+        "returns": "Promise<string>"
+      },
+      "moveFile": {
+        "description": "",
+        "parameters": {
+          "args": {
+            "type": "{ source: string; destination: string }",
+            "description": "Parameter args"
+          }
+        },
+        "required": [
+          "args"
+        ],
+        "returns": "Promise<string>"
+      },
+      "copyFile": {
+        "description": "",
+        "parameters": {
+          "args": {
+            "type": "{ source: string; destination: string }",
+            "description": "Parameter args"
+          }
+        },
+        "required": [
+          "args"
+        ],
+        "returns": "Promise<string>"
+      },
+      "deleteFile": {
+        "description": "",
+        "parameters": {
+          "args": {
+            "type": "{ path: string }",
+            "description": "Parameter args"
+          }
+        },
+        "required": [
+          "args"
+        ],
+        "returns": "Promise<string>"
+      },
+      "setupToolsConsumer": {
+        "description": "When an assistant uses fileTools, inject system prompt guidance about how to use the tools effectively.",
+        "parameters": {
+          "consumer": {
+            "type": "Helper",
+            "description": "Parameter consumer"
+          }
+        },
+        "required": [
+          "consumer"
+        ],
+        "returns": "void"
+      }
+    },
+    "getters": {},
+    "events": {},
+    "state": {},
+    "options": {},
+    "envVars": []
   }
 ];
 
@@ -34721,7 +36919,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": [],
@@ -34729,11 +36927,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": {
@@ -34750,32 +36948,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": [],
@@ -34783,16 +36966,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": {