@soederpop/luca 0.2.1 → 0.2.3

package/src/introspection/generated.agi.ts

@@ -1,7 +1,7 @@
 import { setBuildTimeData, setContainerBuildTimeData } from './index.js';
 
 // Auto-generated introspection registry data
-// Generated at: 2026-04-05T06:58:06.272Z
+// Generated at: 2026-04-09T05:21:42.461Z
 
 setBuildTimeData('features.googleDocs', {
   "id": "features.googleDocs",
@@ -11864,198 +11864,270 @@ setBuildTimeData('clients.websocket', {
   "envVars": []
 });
 
-setBuildTimeData('clients.supabase', {
-  "id": "clients.supabase",
-  "description": "Supabase client for the Luca container system. Wraps the official `@supabase/supabase-js` SDK and exposes it through Luca's typed state, events, and introspection system. The SDK is isomorphic so this single implementation works in both Node and browser containers. Use `client.sdk` for full SDK access, or use the convenience wrappers for common operations (auth, database queries, storage, edge functions, realtime).",
-  "shortcut": "clients.supabase",
-  "className": "SupabaseClient",
+setBuildTimeData('clients.openai', {
+  "id": "clients.openai",
+  "description": "OpenAI client — wraps the OpenAI SDK for chat completions, responses API, embeddings, and image generation. Provides convenience methods for common operations while tracking token usage and request counts. Supports both the Chat Completions API and the newer Responses API.",
+  "shortcut": "clients.openai",
+  "className": "OpenAIClient",
   "methods": {
-    "from": {
-      "description": "Start a query on a Postgres table or view.",
+    "connect": {
+      "description": "Test the API connection by listing models.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<this>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "await openai.connect()"
+        }
+      ]
+    },
+    "createChatCompletion": {
+      "description": "Create a chat completion using the Chat Completions API.",
       "parameters": {
-        "table": {
-          "type": "string",
-          "description": "The table or view name to query"
+        "messages": {
+          "type": "OpenAI.Chat.Completions.ChatCompletionMessageParam[]",
+          "description": "Array of chat messages"
+        },
+        "options": {
+          "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
+          "description": "Additional parameters for the completion"
         }
       },
       "required": [
-        "table"
+        "messages"
       ],
-      "returns": "void"
+      "returns": "Promise<OpenAI.Chat.Completions.ChatCompletion>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const response = await openai.createChatCompletion([\n { role: 'system', content: 'You are a helpful assistant.' },\n { role: 'user', content: 'Hello!' }\n])\nconsole.log(response.choices[0]?.message?.content)"
+        }
+      ]
     },
-    "rpc": {
-      "description": "Call a Postgres function (RPC).",
+    "createResponse": {
+      "description": "Create a response using the Responses API.",
       "parameters": {
-        "fn": {
-          "type": "string",
-          "description": "The function name"
-        },
-        "params": {
-          "type": "Record<string, unknown>",
-          "description": "Arguments to pass to the function"
+        "input": {
+          "type": "OpenAI.Responses.ResponseInput | string",
+          "description": "The input prompt or message array"
         },
         "options": {
-          "type": "{ head?: boolean; get?: boolean; count?: \"exact\" | \"planned\" | \"estimated\" }",
-          "description": "Optional settings (head, get, count)"
+          "type": "Partial<OpenAI.Responses.ResponseCreateParamsNonStreaming>",
+          "description": "Additional parameters for the response"
         }
       },
       "required": [
-        "fn"
+        "input"
       ],
-      "returns": "void"
+      "returns": "Promise<OpenAI.Responses.Response>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const response = await openai.createResponse('Explain quantum computing')"
+        }
+      ]
     },
-    "signInWithPassword": {
-      "description": "Sign in with email and password.",
+    "streamResponse": {
+      "description": "Stream a response using the Responses API.",
       "parameters": {
-        "email": {
-          "type": "string",
-          "description": "Parameter email"
+        "input": {
+          "type": "OpenAI.Responses.ResponseInput | string",
+          "description": "The input prompt or message array"
         },
-        "password": {
-          "type": "string",
-          "description": "Parameter password"
+        "options": {
+          "type": "Partial<OpenAI.Responses.ResponseCreateParamsStreaming>",
+          "description": "Additional parameters for the streaming response"
         }
       },
       "required": [
-        "email",
-        "password"
+        "input"
       ],
-      "returns": "void"
+      "returns": "Promise<AsyncIterable<OpenAI.Responses.ResponseStreamEvent>>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const stream = await openai.streamResponse('Write a poem')\nfor await (const event of stream) {\n if (event.type === 'response.output_text.delta') {\n   process.stdout.write(event.delta)\n }\n}"
+        }
+      ]
     },
-    "signUp": {
-      "description": "Create a new user account with email and password.",
+    "createCompletion": {
+      "description": "Create a legacy text completion.",
       "parameters": {
-        "email": {
+        "prompt": {
           "type": "string",
-          "description": "Parameter email"
+          "description": "The text prompt to complete"
         },
-        "password": {
-          "type": "string",
-          "description": "Parameter password"
+        "options": {
+          "type": "Partial<OpenAI.Completions.CompletionCreateParams>",
+          "description": "Additional parameters for the completion"
         }
       },
       "required": [
-        "email",
-        "password"
+        "prompt"
       ],
-      "returns": "void"
-    },
-    "signOut": {
-      "description": "Sign the current user out.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "getSession": {
-      "description": "Get the current session, if any.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "getUser": {
-      "description": "Get the current user, if any.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
+      "returns": "Promise<OpenAI.Completions.Completion>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const response = await openai.createCompletion('Once upon a time')"
+        }
+      ]
     },
-    "invoke": {
-      "description": "Invoke a Supabase Edge Function by name.",
+    "createEmbedding": {
+      "description": "Create text embeddings for semantic search or similarity comparisons.",
       "parameters": {
-        "name": {
-          "type": "string",
-          "description": "Parameter name"
+        "input": {
+          "type": "string | string[]",
+          "description": "A string or array of strings to embed"
         },
-        "body": {
-          "type": "any",
-          "description": "Parameter body"
+        "options": {
+          "type": "Partial<OpenAI.Embeddings.EmbeddingCreateParams>",
+          "description": "Additional parameters (model, etc.)"
         }
       },
       "required": [
-        "name"
+        "input"
       ],
-      "returns": "void"
+      "returns": "Promise<OpenAI.Embeddings.CreateEmbeddingResponse>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const response = await openai.createEmbedding('Hello world')\nconsole.log(response.data[0].embedding.length)"
+        }
+      ]
     },
-    "subscribe": {
-      "description": "Subscribe to realtime changes on a Postgres table.",
+    "createImage": {
+      "description": "Generate an image from a text prompt using DALL-E.",
       "parameters": {
-        "channelName": {
-          "type": "string",
-          "description": "A name for this subscription channel"
-        },
-        "table": {
+        "prompt": {
           "type": "string",
-          "description": "The table to listen to"
-        },
-        "callback": {
-          "type": "(payload: any) => void",
-          "description": "Called with the payload on each change"
+          "description": "Description of the image to generate"
         },
-        "event": {
-          "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
-          "description": "The event type to listen for (default: all changes)"
+        "options": {
+          "type": "Partial<OpenAI.Images.ImageGenerateParams>",
+          "description": "Additional parameters (size, n, etc.)"
         }
       },
       "required": [
-        "channelName",
-        "table",
-        "callback"
+        "prompt"
       ],
-      "returns": "RealtimeChannel"
+      "returns": "Promise<OpenAI.Images.ImagesResponse>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const response = await openai.createImage('A sunset over mountains')\nconsole.log(response.data[0].url)"
+        }
+      ]
     },
-    "unsubscribe": {
-      "description": "Unsubscribe and remove a realtime channel by name.",
+    "listModels": {
+      "description": "List all available models.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<OpenAI.Models.ModelsPage>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const models = await openai.listModels()"
+        }
+      ]
+    },
+    "ask": {
+      "description": "Ask a single question and get a text response. Convenience wrapper around `createChatCompletion` for simple Q&A.",
       "parameters": {
-        "channelName": {
+        "question": {
           "type": "string",
-          "description": "The channel name to remove"
+          "description": "The question to ask"
+        },
+        "options": {
+          "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
+          "description": "Additional completion parameters"
         }
       },
       "required": [
-        "channelName"
+        "question"
       ],
-      "returns": "void"
-    },
-    "unsubscribeAll": {
-      "description": "Unsubscribe and remove all realtime channels.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "connect": {
-      "description": "Connect is a no-op since the Supabase SDK initializes on construction. The client is ready to use immediately after creation.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
+      "returns": "Promise<string>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const answer = await openai.ask('What is 2 + 2?')\nconsole.log(answer) // '4'"
+        }
+      ]
     },
-    "disconnect": {
-      "description": "Disconnect by signing out and removing all realtime channels.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
+    "chat": {
+      "description": "Send a multi-turn conversation and get a text response. Convenience wrapper around `createChatCompletion` that returns just the text.",
+      "parameters": {
+        "messages": {
+          "type": "OpenAI.Chat.Completions.ChatCompletionMessageParam[]",
+          "description": "Array of chat messages"
+        },
+        "options": {
+          "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
+          "description": "Additional completion parameters"
+        }
+      },
+      "required": [
+        "messages"
+      ],
+      "returns": "Promise<string>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const reply = await openai.chat([\n { role: 'system', content: 'You are a pirate.' },\n { role: 'user', content: 'Hello!' }\n])"
+        }
+      ]
     }
   },
   "getters": {
-    "sdk": {
-      "description": "Returns the raw Supabase SDK client for full access to all SDK methods.",
-      "returns": "SupabaseSDKClient<any, any>"
+    "defaultModel": {
+      "description": "The default model used for completions, from options or 'gpt-4o'.",
+      "returns": "string"
     },
-    "storage": {
-      "description": "Returns the Supabase Storage client for managing buckets and files.",
-      "returns": "any"
+    "raw": {
+      "description": "The underlying OpenAI SDK instance for advanced use cases.",
+      "returns": "OpenAI"
+    }
+  },
+  "events": {
+    "connected": {
+      "name": "connected",
+      "description": "Event emitted by OpenAIClient",
+      "arguments": {}
     },
-    "functions": {
-      "description": "Returns the Supabase Functions client.",
-      "returns": "any"
+    "failure": {
+      "name": "failure",
+      "description": "Event emitted by OpenAIClient",
+      "arguments": {}
+    },
+    "completion": {
+      "name": "completion",
+      "description": "Event emitted by OpenAIClient",
+      "arguments": {}
+    },
+    "embedding": {
+      "name": "embedding",
+      "description": "Event emitted by OpenAIClient",
+      "arguments": {}
+    },
+    "image": {
+      "name": "image",
+      "description": "Event emitted by OpenAIClient",
+      "arguments": {}
+    },
+    "models": {
+      "name": "models",
+      "description": "Event emitted by OpenAIClient",
+      "arguments": {}
     }
   },
-  "events": {},
   "state": {},
   "options": {},
   "envVars": [],
   "examples": [
     {
       "language": "ts",
-      "code": "const supabase = container.client('supabase', {\n supabaseUrl: 'https://xyz.supabase.co',\n supabaseKey: 'your-anon-key',\n})\n\n// Query data\nconst { data } = await supabase.from('users').select('*')\n\n// Auth\nawait supabase.signInWithPassword('user@example.com', 'password')\n\n// Realtime\nsupabase.subscribe('changes', 'users', (payload) => {\n console.log('Change:', payload)\n})"
+      "code": "const openai = container.client('openai', { defaultModel: 'gpt-4o' })\nconst answer = await openai.ask('What is the meaning of life?')\nconsole.log(answer)"
     }
   ]
 });
@@ -12357,260 +12429,295 @@ setBuildTimeData('clients.comfyui', {
   }
 });
 
-setBuildTimeData('clients.openai', {
-  "id": "clients.openai",
-  "description": "OpenAI client — wraps the OpenAI SDK for chat completions, responses API, embeddings, and image generation. Provides convenience methods for common operations while tracking token usage and request counts. Supports both the Chat Completions API and the newer Responses API.",
-  "shortcut": "clients.openai",
-  "className": "OpenAIClient",
+setBuildTimeData('clients.voicebox', {
+  "id": "clients.voicebox",
+  "description": "VoiceBox client — local TTS synthesis via VoiceBox.sh REST API (Qwen3-TTS). Provides methods for managing voice profiles and generating speech audio locally. Uses the streaming endpoint for synchronous synthesis (returns WAV buffer).",
+  "shortcut": "clients.voicebox",
+  "className": "VoiceBoxClient",
   "methods": {
     "connect": {
-      "description": "Test the API connection by listing models.",
+      "description": "Validate the VoiceBox server is reachable by hitting the health endpoint.",
       "parameters": {},
       "required": [],
-      "returns": "Promise<this>",
+      "returns": "Promise<this>"
+    },
+    "listProfiles": {
+      "description": "List all voice profiles.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<any[]>",
       "examples": [
         {
           "language": "ts",
-          "code": "await openai.connect()"
+          "code": "const profiles = await vb.listProfiles()\nconsole.log(profiles.map(p => `${p.name} (${p.sample_count} samples)`))"
         }
       ]
     },
-    "createChatCompletion": {
-      "description": "Create a chat completion using the Chat Completions API.",
+    "getProfile": {
+      "description": "Get a single voice profile by ID.",
       "parameters": {
-        "messages": {
-          "type": "OpenAI.Chat.Completions.ChatCompletionMessageParam[]",
-          "description": "Array of chat messages"
-        },
-        "options": {
-          "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
-          "description": "Additional parameters for the completion"
+        "profileId": {
+          "type": "string",
+          "description": "Parameter profileId"
         }
       },
       "required": [
-        "messages"
+        "profileId"
       ],
-      "returns": "Promise<OpenAI.Chat.Completions.ChatCompletion>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const response = await openai.createChatCompletion([\n { role: 'system', content: 'You are a helpful assistant.' },\n { role: 'user', content: 'Hello!' }\n])\nconsole.log(response.choices[0]?.message?.content)"
-        }
-      ]
+      "returns": "Promise<any>"
     },
-    "createResponse": {
-      "description": "Create a response using the Responses API.",
+    "createProfile": {
+      "description": "Create a new voice profile.",
       "parameters": {
-        "input": {
-          "type": "OpenAI.Responses.ResponseInput | string",
-          "description": "The input prompt or message array"
+        "name": {
+          "type": "string",
+          "description": "Parameter name"
         },
         "options": {
-          "type": "Partial<OpenAI.Responses.ResponseCreateParamsNonStreaming>",
-          "description": "Additional parameters for the response"
+          "type": "{ description?: string; language?: string }",
+          "description": "Parameter options"
         }
       },
       "required": [
-        "input"
+        "name"
       ],
-      "returns": "Promise<OpenAI.Responses.Response>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const response = await openai.createResponse('Explain quantum computing')"
-        }
-      ]
+      "returns": "Promise<any>"
     },
-    "streamResponse": {
-      "description": "Stream a response using the Responses API.",
+    "listEffects": {
+      "description": "List available audio effects and their parameter definitions.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<any>"
+    },
+    "synthesize": {
+      "description": "Synthesize speech from text using the streaming endpoint. Returns audio as a WAV Buffer (synchronous — blocks until audio is ready).",
       "parameters": {
-        "input": {
-          "type": "OpenAI.Responses.ResponseInput | string",
-          "description": "The input prompt or message array"
+        "text": {
+          "type": "string",
+          "description": "The text to convert to speech"
         },
         "options": {
-          "type": "Partial<OpenAI.Responses.ResponseCreateParamsStreaming>",
-          "description": "Additional parameters for the streaming response"
+          "type": "SynthesizeOptions",
+          "description": "Profile, engine, model, and other synthesis options",
+          "properties": {
+            "profileId": {
+              "type": "string",
+              "description": ""
+            },
+            "engine": {
+              "type": "string",
+              "description": ""
+            },
+            "modelSize": {
+              "type": "string",
+              "description": ""
+            },
+            "language": {
+              "type": "string",
+              "description": ""
+            },
+            "instruct": {
+              "type": "string",
+              "description": ""
+            },
+            "seed": {
+              "type": "number",
+              "description": ""
+            },
+            "maxChunkChars": {
+              "type": "number",
+              "description": ""
+            },
+            "crossfadeMs": {
+              "type": "number",
+              "description": ""
+            },
+            "normalize": {
+              "type": "boolean",
+              "description": ""
+            },
+            "effectsChain": {
+              "type": "EffectConfig[]",
+              "description": ""
+            },
+            "disableCache": {
+              "type": "boolean",
+              "description": ""
+            }
+          }
         }
       },
       "required": [
-        "input"
+        "text"
       ],
-      "returns": "Promise<AsyncIterable<OpenAI.Responses.ResponseStreamEvent>>",
+      "returns": "Promise<Buffer>",
       "examples": [
         {
           "language": "ts",
-          "code": "const stream = await openai.streamResponse('Write a poem')\nfor await (const event of stream) {\n if (event.type === 'response.output_text.delta') {\n   process.stdout.write(event.delta)\n }\n}"
+          "code": "const audio = await vb.synthesize('Hello world', { profileId: 'abc-123' })\n// audio is a Buffer of WAV data"
         }
       ]
     },
-    "createCompletion": {
-      "description": "Create a legacy text completion.",
+    "generate": {
+      "description": "Generate speech asynchronously (returns metadata, not audio). Use getAudio() to fetch the audio after generation completes.",
       "parameters": {
-        "prompt": {
+        "text": {
           "type": "string",
-          "description": "The text prompt to complete"
+          "description": "Parameter text"
         },
         "options": {
-          "type": "Partial<OpenAI.Completions.CompletionCreateParams>",
-          "description": "Additional parameters for the completion"
+          "type": "SynthesizeOptions",
+          "description": "Parameter options",
+          "properties": {
+            "profileId": {
+              "type": "string",
+              "description": ""
+            },
+            "engine": {
+              "type": "string",
+              "description": ""
+            },
+            "modelSize": {
+              "type": "string",
+              "description": ""
+            },
+            "language": {
+              "type": "string",
+              "description": ""
+            },
+            "instruct": {
+              "type": "string",
+              "description": ""
+            },
+            "seed": {
+              "type": "number",
+              "description": ""
+            },
+            "maxChunkChars": {
+              "type": "number",
+              "description": ""
+            },
+            "crossfadeMs": {
+              "type": "number",
+              "description": ""
+            },
+            "normalize": {
+              "type": "boolean",
+              "description": ""
+            },
+            "effectsChain": {
+              "type": "EffectConfig[]",
+              "description": ""
+            },
+            "disableCache": {
+              "type": "boolean",
+              "description": ""
+            }
+          }
         }
       },
       "required": [
-        "prompt"
+        "text"
       ],
-      "returns": "Promise<OpenAI.Completions.Completion>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const response = await openai.createCompletion('Once upon a time')"
-        }
-      ]
+      "returns": "Promise<any>"
     },
-    "createEmbedding": {
-      "description": "Create text embeddings for semantic search or similarity comparisons.",
+    "getAudio": {
+      "description": "Fetch generated audio by generation ID. Returns WAV Buffer.",
       "parameters": {
-        "input": {
-          "type": "string | string[]",
-          "description": "A string or array of strings to embed"
-        },
-        "options": {
-          "type": "Partial<OpenAI.Embeddings.EmbeddingCreateParams>",
-          "description": "Additional parameters (model, etc.)"
+        "generationId": {
+          "type": "string",
+          "description": "Parameter generationId"
         }
       },
       "required": [
-        "input"
+        "generationId"
       ],
-      "returns": "Promise<OpenAI.Embeddings.CreateEmbeddingResponse>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const response = await openai.createEmbedding('Hello world')\nconsole.log(response.data[0].embedding.length)"
-        }
-      ]
+      "returns": "Promise<Buffer>"
     },
-    "createImage": {
-      "description": "Generate an image from a text prompt using DALL-E.",
+    "say": {
+      "description": "Synthesize and write audio to a file.",
       "parameters": {
-        "prompt": {
+        "text": {
           "type": "string",
-          "description": "Description of the image to generate"
+          "description": "Parameter text"
         },
-        "options": {
-          "type": "Partial<OpenAI.Images.ImageGenerateParams>",
-          "description": "Additional parameters (size, n, etc.)"
-        }
-      },
-      "required": [
-        "prompt"
-      ],
-      "returns": "Promise<OpenAI.Images.ImagesResponse>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const response = await openai.createImage('A sunset over mountains')\nconsole.log(response.data[0].url)"
-        }
-      ]
-    },
-    "listModels": {
-      "description": "List all available models.",
-      "parameters": {},
-      "required": [],
-      "returns": "Promise<OpenAI.Models.ModelsPage>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const models = await openai.listModels()"
-        }
-      ]
-    },
-    "ask": {
-      "description": "Ask a single question and get a text response. Convenience wrapper around `createChatCompletion` for simple Q&A.",
-      "parameters": {
-        "question": {
+        "outputPath": {
           "type": "string",
-          "description": "The question to ask"
+          "description": "Parameter outputPath"
         },
         "options": {
-          "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
-          "description": "Additional completion parameters"
-        }
-      },
-      "required": [
-        "question"
-      ],
-      "returns": "Promise<string>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const answer = await openai.ask('What is 2 + 2?')\nconsole.log(answer) // '4'"
-        }
-      ]
-    },
-    "chat": {
-      "description": "Send a multi-turn conversation and get a text response. Convenience wrapper around `createChatCompletion` that returns just the text.",
-      "parameters": {
-        "messages": {
-          "type": "OpenAI.Chat.Completions.ChatCompletionMessageParam[]",
-          "description": "Array of chat messages"
-        },
-        "options": {
-          "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
-          "description": "Additional completion parameters"
+          "type": "SynthesizeOptions",
+          "description": "Parameter options",
+          "properties": {
+            "profileId": {
+              "type": "string",
+              "description": ""
+            },
+            "engine": {
+              "type": "string",
+              "description": ""
+            },
+            "modelSize": {
+              "type": "string",
+              "description": ""
+            },
+            "language": {
+              "type": "string",
+              "description": ""
+            },
+            "instruct": {
+              "type": "string",
+              "description": ""
+            },
+            "seed": {
+              "type": "number",
+              "description": ""
+            },
+            "maxChunkChars": {
+              "type": "number",
+              "description": ""
+            },
+            "crossfadeMs": {
+              "type": "number",
+              "description": ""
+            },
+            "normalize": {
+              "type": "boolean",
+              "description": ""
+            },
+            "effectsChain": {
+              "type": "EffectConfig[]",
+              "description": ""
+            },
+            "disableCache": {
+              "type": "boolean",
+              "description": ""
+            }
+          }
         }
       },
       "required": [
-        "messages"
+        "text",
+        "outputPath"
       ],
-      "returns": "Promise<string>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const reply = await openai.chat([\n { role: 'system', content: 'You are a pirate.' },\n { role: 'user', content: 'Hello!' }\n])"
-        }
-      ]
-    }
-  },
-  "getters": {
-    "defaultModel": {
-      "description": "The default model used for completions, from options or 'gpt-4o'.",
-      "returns": "string"
-    },
-    "raw": {
-      "description": "The underlying OpenAI SDK instance for advanced use cases.",
-      "returns": "OpenAI"
+      "returns": "Promise<string>"
     }
   },
+  "getters": {},
   "events": {
-    "connected": {
-      "name": "connected",
-      "description": "Event emitted by OpenAIClient",
-      "arguments": {}
-    },
     "failure": {
       "name": "failure",
-      "description": "Event emitted by OpenAIClient",
-      "arguments": {}
-    },
-    "completion": {
-      "name": "completion",
-      "description": "Event emitted by OpenAIClient",
+      "description": "Event emitted by VoiceBoxClient",
       "arguments": {}
     },
-    "embedding": {
-      "name": "embedding",
-      "description": "Event emitted by OpenAIClient",
+    "profiles": {
+      "name": "profiles",
+      "description": "Event emitted by VoiceBoxClient",
       "arguments": {}
     },
-    "image": {
-      "name": "image",
-      "description": "Event emitted by OpenAIClient",
-      "arguments": {}
-    },
-    "models": {
-      "name": "models",
-      "description": "Event emitted by OpenAIClient",
+    "speech": {
+      "name": "speech",
+      "description": "Event emitted by VoiceBoxClient",
       "arguments": {}
     }
   },
@@ -12620,9 +12727,90 @@ setBuildTimeData('clients.openai', {
   "examples": [
     {
       "language": "ts",
-      "code": "const openai = container.client('openai', { defaultModel: 'gpt-4o' })\nconst answer = await openai.ask('What is the meaning of life?')\nconsole.log(answer)"
+      "code": "const vb = container.client('voicebox')\nawait vb.connect()\nconst profiles = await vb.listProfiles()\nconst audio = await vb.synthesize('Hello world', { profileId: profiles[0].id })\n// audio is a Buffer of WAV data"
     }
-  ]
+  ],
+  "types": {
+    "SynthesizeOptions": {
+      "description": "",
+      "properties": {
+        "profileId": {
+          "type": "string",
+          "description": "",
+          "optional": true
+        },
+        "engine": {
+          "type": "string",
+          "description": "",
+          "optional": true
+        },
+        "modelSize": {
+          "type": "string",
+          "description": "",
+          "optional": true
+        },
+        "language": {
+          "type": "string",
+          "description": "",
+          "optional": true
+        },
+        "instruct": {
+          "type": "string",
+          "description": "",
+          "optional": true
+        },
+        "seed": {
+          "type": "number",
+          "description": "",
+          "optional": true
+        },
+        "maxChunkChars": {
+          "type": "number",
+          "description": "",
+          "optional": true
+        },
+        "crossfadeMs": {
+          "type": "number",
+          "description": "",
+          "optional": true
+        },
+        "normalize": {
+          "type": "boolean",
+          "description": "",
+          "optional": true
+        },
+        "effectsChain": {
+          "type": "EffectConfig[]",
+          "description": "",
+          "optional": true
+        },
+        "disableCache": {
+          "type": "boolean",
+          "description": "",
+          "optional": true
+        }
+      }
+    },
+    "EffectConfig": {
+      "description": "",
+      "properties": {
+        "type": {
+          "type": "string",
+          "description": ""
+        },
+        "enabled": {
+          "type": "boolean",
+          "description": "",
+          "optional": true
+        },
+        "params": {
+          "type": "Record<string, any>",
+          "description": "",
+          "optional": true
+        }
+      }
+    }
+  }
 });
 
 setBuildTimeData('clients.elevenlabs', {
@@ -12889,6 +13077,202 @@ setBuildTimeData('clients.elevenlabs', {
   }
 });
 
+setBuildTimeData('clients.supabase', {
+  "id": "clients.supabase",
+  "description": "Supabase client for the Luca container system. Wraps the official `@supabase/supabase-js` SDK and exposes it through Luca's typed state, events, and introspection system. The SDK is isomorphic so this single implementation works in both Node and browser containers. Use `client.sdk` for full SDK access, or use the convenience wrappers for common operations (auth, database queries, storage, edge functions, realtime).",
+  "shortcut": "clients.supabase",
+  "className": "SupabaseClient",
+  "methods": {
+    "from": {
+      "description": "Start a query on a Postgres table or view.",
+      "parameters": {
+        "table": {
+          "type": "string",
+          "description": "The table or view name to query"
+        }
+      },
+      "required": [
+        "table"
+      ],
+      "returns": "void"
+    },
+    "rpc": {
+      "description": "Call a Postgres function (RPC).",
+      "parameters": {
+        "fn": {
+          "type": "string",
+          "description": "The function name"
+        },
+        "params": {
+          "type": "Record<string, unknown>",
+          "description": "Arguments to pass to the function"
+        },
+        "options": {
+          "type": "{ head?: boolean; get?: boolean; count?: \"exact\" | \"planned\" | \"estimated\" }",
+          "description": "Optional settings (head, get, count)"
+        }
+      },
+      "required": [
+        "fn"
+      ],
+      "returns": "void"
+    },
+    "signInWithPassword": {
+      "description": "Sign in with email and password.",
+      "parameters": {
+        "email": {
+          "type": "string",
+          "description": "Parameter email"
+        },
+        "password": {
+          "type": "string",
+          "description": "Parameter password"
+        }
+      },
+      "required": [
+        "email",
+        "password"
+      ],
+      "returns": "void"
+    },
+    "signUp": {
+      "description": "Create a new user account with email and password.",
+      "parameters": {
+        "email": {
+          "type": "string",
+          "description": "Parameter email"
+        },
+        "password": {
+          "type": "string",
+          "description": "Parameter password"
+        }
+      },
+      "required": [
+        "email",
+        "password"
+      ],
+      "returns": "void"
+    },
+    "signOut": {
+      "description": "Sign the current user out.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "getSession": {
+      "description": "Get the current session, if any.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "getUser": {
+      "description": "Get the current user, if any.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "invoke": {
+      "description": "Invoke a Supabase Edge Function by name.",
+      "parameters": {
+        "name": {
+          "type": "string",
+          "description": "Parameter name"
+        },
+        "body": {
+          "type": "any",
+          "description": "Parameter body"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "returns": "void"
+    },
+    "subscribe": {
+      "description": "Subscribe to realtime changes on a Postgres table.",
+      "parameters": {
+        "channelName": {
+          "type": "string",
+          "description": "A name for this subscription channel"
+        },
+        "table": {
+          "type": "string",
+          "description": "The table to listen to"
+        },
+        "callback": {
+          "type": "(payload: any) => void",
+          "description": "Called with the payload on each change"
+        },
+        "event": {
+          "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
+          "description": "The event type to listen for (default: all changes)"
+        }
+      },
+      "required": [
+        "channelName",
+        "table",
+        "callback"
+      ],
+      "returns": "RealtimeChannel"
+    },
+    "unsubscribe": {
+      "description": "Unsubscribe and remove a realtime channel by name.",
+      "parameters": {
+        "channelName": {
+          "type": "string",
+          "description": "The channel name to remove"
+        }
+      },
+      "required": [
+        "channelName"
+      ],
+      "returns": "void"
+    },
+    "unsubscribeAll": {
+      "description": "Unsubscribe and remove all realtime channels.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "connect": {
+      "description": "Connect is a no-op since the Supabase SDK initializes on construction. The client is ready to use immediately after creation.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "disconnect": {
+      "description": "Disconnect by signing out and removing all realtime channels.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    }
+  },
+  "getters": {
+    "sdk": {
+      "description": "Returns the raw Supabase SDK client for full access to all SDK methods.",
+      "returns": "SupabaseSDKClient<any, any>"
+    },
+    "storage": {
+      "description": "Returns the Supabase Storage client for managing buckets and files.",
+      "returns": "any"
+    },
+    "functions": {
+      "description": "Returns the Supabase Functions client.",
+      "returns": "any"
+    }
+  },
+  "events": {},
+  "state": {},
+  "options": {},
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const supabase = container.client('supabase', {\n supabaseUrl: 'https://xyz.supabase.co',\n supabaseKey: 'your-anon-key',\n})\n\n// Query data\nconst { data } = await supabase.from('users').select('*')\n\n// Auth\nawait supabase.signInWithPassword('user@example.com', 'password')\n\n// Realtime\nsupabase.subscribe('changes', 'users', (payload) => {\n console.log('Change:', payload)\n})"
+    }
+  ]
+});
+
 setBuildTimeData('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).",
@@ -13615,6 +13999,16 @@ setBuildTimeData('features.assistantsManager', {
         "hasVoice": {
           "type": "boolean",
           "description": "Whether a voice.yaml configuration file exists."
+        },
+        "about": {
+          "type": "string",
+          "description": "Contents of ABOUT.md if present, undefined otherwise.",
+          "optional": true
+        },
+        "meta": {
+          "type": "Record<string, any>",
+          "description": "Frontmatter metadata parsed from CORE.md.",
+          "optional": true
         }
       }
     }
@@ -13710,22 +14104,45 @@ setBuildTimeData('features.conversation', {
       ]
     },
     "fork": {
-      "description": "Fork the conversation into a new independent instance. The fork inherits the same system prompt, tools, and full message history, but has its own identity and state — changes in either direction do not affect the other.",
+      "description": "",
       "parameters": {
         "overrides": {
-          "type": "Partial<ConversationOptions>",
-          "description": "Optional option overrides for the forked conversation (e.g. different model or title)"
+          "type": "ForkOptions | ForkOptions[]",
+          "description": "Parameter overrides"
         }
       },
       "required": [],
-      "returns": "Conversation",
+      "returns": "Conversation | Conversation[]"
+    },
+    "research": {
+      "description": "Fan out N questions in parallel using forked conversations, return the results. Each fork is independent and ephemeral — no history is saved.",
+      "parameters": {
+        "questions": {
+          "type": "(string | { question: string; forkOptions?: ForkOptions })[]",
+          "description": "Array of questions (strings) or objects with question + per-fork overrides"
+        },
+        "defaults": {
+          "type": "ForkOptions",
+          "description": "Default fork options applied to all forks (individual overrides take precedence)"
+        }
+      },
+      "required": [
+        "questions"
+      ],
+      "returns": "Promise<string[]>",
       "examples": [
         {
           "language": "ts",
-          "code": "const fork = conversation.fork()\nawait fork.ask('What if we took a different approach?')\n// original conversation is unchanged"
+          "code": "const results = await conversation.research([\n \"What are the pros of approach A?\",\n \"What are the pros of approach B?\",\n], { history: 'none', model: 'gpt-4o-mini' })\n\n// Per-fork overrides\nconst results = await conversation.research([\n \"Quick factual question\",\n { question: \"Needs recent context\", forkOptions: { history: 5 } },\n], { history: 'none' })"
         }
       ]
     },
+    "abort": {
+      "description": "Abort the current ask() call. Cancels the in-flight network request and any pending tool executions. The ask() promise will reject with a ConversationAbortError whose `partial` property contains any text accumulated before the abort.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
     "estimateTokens": {
       "description": "Estimate the input token count for the current messages array using the js-tiktoken tokenizer. Updates state.",
       "parameters": {},
@@ -13884,6 +14301,11 @@ setBuildTimeData('features.conversation', {
       "description": "Event emitted by Conversation",
       "arguments": {}
     },
+    "aborted": {
+      "name": "aborted",
+      "description": "Event emitted by Conversation",
+      "arguments": {}
+    },
     "toolError": {
       "name": "toolError",
       "description": "Event emitted by Conversation",
@@ -15348,8 +15770,26 @@ setBuildTimeData('features.assistant', {
       ],
       "returns": "this"
     },
+    "triggerHook": {
+      "description": "Trigger a named hook and await its completion. The hook function receives `(assistant, ...args)` and its return value is passed back to the caller. This ensures hooks run to completion BEFORE any subsequent logic executes, unlike the old bus-based approach where async hooks were fire-and-forget. Hooks that don't exist are silently skipped (returns undefined).",
+      "parameters": {
+        "hookName": {
+          "type": "string",
+          "description": "The hook to trigger (matches an export name from hooks.ts)"
+        },
+        "args": {
+          "type": "any[]",
+          "description": "Arguments passed to the hook after the assistant instance"
+        }
+      },
+      "required": [
+        "hookName",
+        "args"
+      ],
+      "returns": "Promise<any>"
+    },
     "afterInitialize": {
-      "description": "Called immediately after the assistant is constructed. Synchronously loads the system prompt, tools, and hooks, then binds hooks as event listeners so every emitted event automatically invokes its corresponding hook.",
+      "description": "Called immediately after the assistant is constructed. Synchronously loads the system prompt, tools, and hooks. Hooks are invoked via triggerHook() at each emit site, ensuring async hooks are properly awaited.",
       "parameters": {},
       "required": [],
       "returns": "void"
@@ -15580,6 +16020,68 @@ setBuildTimeData('features.assistant', {
       "required": [],
       "returns": "void"
     },
+    "fork": {
+      "description": "",
+      "parameters": {
+        "options": {
+          "type": "AssistantForkOptions | AssistantForkOptions[]",
+          "description": "Parameter options"
+        }
+      },
+      "required": [],
+      "returns": "Promise<Assistant | Assistant[]>"
+    },
+    "createResearchJob": {
+      "description": "Create a non-blocking research job that fans out questions across forked assistants. The forks fire immediately and the returned entity tracks progress via observable state and events. Each fork preserves the full assistant identity (interceptors, tools, hooks).",
+      "parameters": {
+        "prompt": {
+          "type": "string",
+          "description": "Shared context/framing prompt prepended to each fork's system prompt"
+        },
+        "questions": {
+          "type": "(string | { question: string; forkOptions?: AssistantForkOptions })[]",
+          "description": "Array of questions (strings) or objects with question + per-fork overrides"
+        },
+        "defaults": {
+          "type": "AssistantForkOptions",
+          "description": "Default fork options applied to all forks"
+        }
+      },
+      "required": [
+        "prompt",
+        "questions"
+      ],
+      "returns": "Promise<ResearchJob>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "// Fire and forget — check later\nconst job = await assistant.createResearchJob(\n \"Analyze this codebase for security issues\",\n [\"Look for SQL injection\", \"Look for XSS\", \"Look for auth bypass\"],\n { history: 'none', model: 'gpt-4o-mini' }\n)\n\n// Check progress\njob.state.get('completed') // 2 of 3\njob.state.get('results')   // [answer1, answer2, null]\n\n// React to events\njob.on('forkCompleted', (index, result) => console.log(`Fork ${index} done`))\n\n// Or just wait\nawait job.waitFor('completed')"
+        }
+      ]
+    },
+    "research": {
+      "description": "Fan out N questions in parallel using forked assistants, return the results. Sugar over createResearchJob — blocks until all forks complete.",
+      "parameters": {
+        "questions": {
+          "type": "(string | { question: string; forkOptions?: AssistantForkOptions })[]",
+          "description": "Array of questions (strings) or objects with question + per-fork overrides"
+        },
+        "defaults": {
+          "type": "AssistantForkOptions & { prompt?: string }",
+          "description": "Default fork options applied to all forks"
+        }
+      },
+      "required": [
+        "questions"
+      ],
+      "returns": "Promise<(string | null)[]>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const results = await assistant.research([\n \"What are best practices for X?\",\n \"What are common pitfalls of X?\",\n], { history: 'none', model: 'gpt-4o-mini' })"
+        }
+      ]
+    },
     "subagent": {
       "description": "Get or create a subagent assistant. Uses the assistantsManager to discover and create the assistant, then caches the instance for reuse across tool calls.",
       "parameters": {
@@ -15657,6 +16159,14 @@ setBuildTimeData('features.assistant', {
       "description": "Whether the assistant has been started and is ready to receive questions.",
       "returns": "boolean"
     },
+    "isFork": {
+      "description": "Whether this assistant was created via fork().",
+      "returns": "boolean"
+    },
+    "forkDepth": {
+      "description": "How many levels deep this fork is. 0 = original, 1 = direct fork, 2 = fork of a fork, etc.",
+      "returns": "number"
+    },
     "systemPrompt": {
       "description": "The current system prompt text.",
       "returns": "string"
@@ -15711,6 +16221,11 @@ setBuildTimeData('features.assistant', {
     }
   },
   "events": {
+    "hookFired": {
+      "name": "hookFired",
+      "description": "Event emitted by Assistant",
+      "arguments": {}
+    },
     "created": {
       "name": "created",
       "description": "Event emitted by Assistant",
@@ -15726,11 +16241,6 @@ setBuildTimeData('features.assistant', {
       "description": "Event emitted by Assistant",
       "arguments": {}
     },
-    "hookFired": {
-      "name": "hookFired",
-      "description": "Event emitted by Assistant",
-      "arguments": {}
-    },
     "reloaded": {
       "name": "reloaded",
       "description": "Event emitted by Assistant",
@@ -31329,197 +31839,269 @@ export const introspectionData = [
     "envVars": []
   },
   {
-    "id": "clients.supabase",
-    "description": "Supabase client for the Luca container system. Wraps the official `@supabase/supabase-js` SDK and exposes it through Luca's typed state, events, and introspection system. The SDK is isomorphic so this single implementation works in both Node and browser containers. Use `client.sdk` for full SDK access, or use the convenience wrappers for common operations (auth, database queries, storage, edge functions, realtime).",
-    "shortcut": "clients.supabase",
-    "className": "SupabaseClient",
+    "id": "clients.openai",
+    "description": "OpenAI client — wraps the OpenAI SDK for chat completions, responses API, embeddings, and image generation. Provides convenience methods for common operations while tracking token usage and request counts. Supports both the Chat Completions API and the newer Responses API.",
+    "shortcut": "clients.openai",
+    "className": "OpenAIClient",
     "methods": {
-      "from": {
-        "description": "Start a query on a Postgres table or view.",
+      "connect": {
+        "description": "Test the API connection by listing models.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<this>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "await openai.connect()"
+          }
+        ]
+      },
+      "createChatCompletion": {
+        "description": "Create a chat completion using the Chat Completions API.",
         "parameters": {
-          "table": {
-            "type": "string",
-            "description": "The table or view name to query"
+          "messages": {
+            "type": "OpenAI.Chat.Completions.ChatCompletionMessageParam[]",
+            "description": "Array of chat messages"
+          },
+          "options": {
+            "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
+            "description": "Additional parameters for the completion"
           }
         },
         "required": [
-          "table"
+          "messages"
         ],
-        "returns": "void"
+        "returns": "Promise<OpenAI.Chat.Completions.ChatCompletion>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const response = await openai.createChatCompletion([\n { role: 'system', content: 'You are a helpful assistant.' },\n { role: 'user', content: 'Hello!' }\n])\nconsole.log(response.choices[0]?.message?.content)"
+          }
+        ]
       },
-      "rpc": {
-        "description": "Call a Postgres function (RPC).",
+      "createResponse": {
+        "description": "Create a response using the Responses API.",
         "parameters": {
-          "fn": {
-            "type": "string",
-            "description": "The function name"
-          },
-          "params": {
-            "type": "Record<string, unknown>",
-            "description": "Arguments to pass to the function"
+          "input": {
+            "type": "OpenAI.Responses.ResponseInput | string",
+            "description": "The input prompt or message array"
           },
           "options": {
-            "type": "{ head?: boolean; get?: boolean; count?: \"exact\" | \"planned\" | \"estimated\" }",
-            "description": "Optional settings (head, get, count)"
+            "type": "Partial<OpenAI.Responses.ResponseCreateParamsNonStreaming>",
+            "description": "Additional parameters for the response"
           }
         },
         "required": [
-          "fn"
+          "input"
         ],
-        "returns": "void"
+        "returns": "Promise<OpenAI.Responses.Response>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const response = await openai.createResponse('Explain quantum computing')"
+          }
+        ]
       },
-      "signInWithPassword": {
-        "description": "Sign in with email and password.",
+      "streamResponse": {
+        "description": "Stream a response using the Responses API.",
         "parameters": {
-          "email": {
-            "type": "string",
-            "description": "Parameter email"
+          "input": {
+            "type": "OpenAI.Responses.ResponseInput | string",
+            "description": "The input prompt or message array"
           },
-          "password": {
-            "type": "string",
-            "description": "Parameter password"
+          "options": {
+            "type": "Partial<OpenAI.Responses.ResponseCreateParamsStreaming>",
+            "description": "Additional parameters for the streaming response"
           }
         },
         "required": [
-          "email",
-          "password"
+          "input"
         ],
-        "returns": "void"
+        "returns": "Promise<AsyncIterable<OpenAI.Responses.ResponseStreamEvent>>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const stream = await openai.streamResponse('Write a poem')\nfor await (const event of stream) {\n if (event.type === 'response.output_text.delta') {\n   process.stdout.write(event.delta)\n }\n}"
+          }
+        ]
       },
-      "signUp": {
-        "description": "Create a new user account with email and password.",
+      "createCompletion": {
+        "description": "Create a legacy text completion.",
         "parameters": {
-          "email": {
+          "prompt": {
             "type": "string",
-            "description": "Parameter email"
+            "description": "The text prompt to complete"
           },
-          "password": {
-            "type": "string",
-            "description": "Parameter password"
+          "options": {
+            "type": "Partial<OpenAI.Completions.CompletionCreateParams>",
+            "description": "Additional parameters for the completion"
           }
         },
         "required": [
-          "email",
-          "password"
+          "prompt"
         ],
-        "returns": "void"
-      },
-      "signOut": {
-        "description": "Sign the current user out.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "getSession": {
-        "description": "Get the current session, if any.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "getUser": {
-        "description": "Get the current user, if any.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
+        "returns": "Promise<OpenAI.Completions.Completion>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const response = await openai.createCompletion('Once upon a time')"
+          }
+        ]
       },
-      "invoke": {
-        "description": "Invoke a Supabase Edge Function by name.",
+      "createEmbedding": {
+        "description": "Create text embeddings for semantic search or similarity comparisons.",
         "parameters": {
-          "name": {
-            "type": "string",
-            "description": "Parameter name"
+          "input": {
+            "type": "string | string[]",
+            "description": "A string or array of strings to embed"
           },
-          "body": {
-            "type": "any",
-            "description": "Parameter body"
+          "options": {
+            "type": "Partial<OpenAI.Embeddings.EmbeddingCreateParams>",
+            "description": "Additional parameters (model, etc.)"
           }
         },
         "required": [
-          "name"
+          "input"
         ],
-        "returns": "void"
+        "returns": "Promise<OpenAI.Embeddings.CreateEmbeddingResponse>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const response = await openai.createEmbedding('Hello world')\nconsole.log(response.data[0].embedding.length)"
+          }
+        ]
       },
-      "subscribe": {
-        "description": "Subscribe to realtime changes on a Postgres table.",
+      "createImage": {
+        "description": "Generate an image from a text prompt using DALL-E.",
         "parameters": {
-          "channelName": {
-            "type": "string",
-            "description": "A name for this subscription channel"
-          },
-          "table": {
+          "prompt": {
             "type": "string",
-            "description": "The table to listen to"
-          },
-          "callback": {
-            "type": "(payload: any) => void",
-            "description": "Called with the payload on each change"
+            "description": "Description of the image to generate"
           },
-          "event": {
-            "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
-            "description": "The event type to listen for (default: all changes)"
+          "options": {
+            "type": "Partial<OpenAI.Images.ImageGenerateParams>",
+            "description": "Additional parameters (size, n, etc.)"
           }
         },
         "required": [
-          "channelName",
-          "table",
-          "callback"
+          "prompt"
         ],
-        "returns": "RealtimeChannel"
+        "returns": "Promise<OpenAI.Images.ImagesResponse>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const response = await openai.createImage('A sunset over mountains')\nconsole.log(response.data[0].url)"
+          }
+        ]
       },
-      "unsubscribe": {
-        "description": "Unsubscribe and remove a realtime channel by name.",
+      "listModels": {
+        "description": "List all available models.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<OpenAI.Models.ModelsPage>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const models = await openai.listModels()"
+          }
+        ]
+      },
+      "ask": {
+        "description": "Ask a single question and get a text response. Convenience wrapper around `createChatCompletion` for simple Q&A.",
         "parameters": {
-          "channelName": {
+          "question": {
             "type": "string",
-            "description": "The channel name to remove"
+            "description": "The question to ask"
+          },
+          "options": {
+            "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
+            "description": "Additional completion parameters"
           }
         },
         "required": [
-          "channelName"
+          "question"
         ],
-        "returns": "void"
-      },
-      "unsubscribeAll": {
-        "description": "Unsubscribe and remove all realtime channels.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "connect": {
-        "description": "Connect is a no-op since the Supabase SDK initializes on construction. The client is ready to use immediately after creation.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
+        "returns": "Promise<string>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const answer = await openai.ask('What is 2 + 2?')\nconsole.log(answer) // '4'"
+          }
+        ]
       },
-      "disconnect": {
-        "description": "Disconnect by signing out and removing all realtime channels.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
+      "chat": {
+        "description": "Send a multi-turn conversation and get a text response. Convenience wrapper around `createChatCompletion` that returns just the text.",
+        "parameters": {
+          "messages": {
+            "type": "OpenAI.Chat.Completions.ChatCompletionMessageParam[]",
+            "description": "Array of chat messages"
+          },
+          "options": {
+            "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
+            "description": "Additional completion parameters"
+          }
+        },
+        "required": [
+          "messages"
+        ],
+        "returns": "Promise<string>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const reply = await openai.chat([\n { role: 'system', content: 'You are a pirate.' },\n { role: 'user', content: 'Hello!' }\n])"
+          }
+        ]
       }
     },
     "getters": {
-      "sdk": {
-        "description": "Returns the raw Supabase SDK client for full access to all SDK methods.",
-        "returns": "SupabaseSDKClient<any, any>"
+      "defaultModel": {
+        "description": "The default model used for completions, from options or 'gpt-4o'.",
+        "returns": "string"
       },
-      "storage": {
-        "description": "Returns the Supabase Storage client for managing buckets and files.",
-        "returns": "any"
+      "raw": {
+        "description": "The underlying OpenAI SDK instance for advanced use cases.",
+        "returns": "OpenAI"
+      }
+    },
+    "events": {
+      "connected": {
+        "name": "connected",
+        "description": "Event emitted by OpenAIClient",
+        "arguments": {}
       },
-      "functions": {
-        "description": "Returns the Supabase Functions client.",
-        "returns": "any"
+      "failure": {
+        "name": "failure",
+        "description": "Event emitted by OpenAIClient",
+        "arguments": {}
+      },
+      "completion": {
+        "name": "completion",
+        "description": "Event emitted by OpenAIClient",
+        "arguments": {}
+      },
+      "embedding": {
+        "name": "embedding",
+        "description": "Event emitted by OpenAIClient",
+        "arguments": {}
+      },
+      "image": {
+        "name": "image",
+        "description": "Event emitted by OpenAIClient",
+        "arguments": {}
+      },
+      "models": {
+        "name": "models",
+        "description": "Event emitted by OpenAIClient",
+        "arguments": {}
       }
     },
-    "events": {},
     "state": {},
     "options": {},
     "envVars": [],
     "examples": [
       {
         "language": "ts",
-        "code": "const supabase = container.client('supabase', {\n supabaseUrl: 'https://xyz.supabase.co',\n supabaseKey: 'your-anon-key',\n})\n\n// Query data\nconst { data } = await supabase.from('users').select('*')\n\n// Auth\nawait supabase.signInWithPassword('user@example.com', 'password')\n\n// Realtime\nsupabase.subscribe('changes', 'users', (payload) => {\n console.log('Change:', payload)\n})"
+        "code": "const openai = container.client('openai', { defaultModel: 'gpt-4o' })\nconst answer = await openai.ask('What is the meaning of life?')\nconsole.log(answer)"
       }
     ]
   },
@@ -31820,259 +32402,294 @@ export const introspectionData = [
     }
   },
   {
-    "id": "clients.openai",
-    "description": "OpenAI client — wraps the OpenAI SDK for chat completions, responses API, embeddings, and image generation. Provides convenience methods for common operations while tracking token usage and request counts. Supports both the Chat Completions API and the newer Responses API.",
-    "shortcut": "clients.openai",
-    "className": "OpenAIClient",
+    "id": "clients.voicebox",
+    "description": "VoiceBox client — local TTS synthesis via VoiceBox.sh REST API (Qwen3-TTS). Provides methods for managing voice profiles and generating speech audio locally. Uses the streaming endpoint for synchronous synthesis (returns WAV buffer).",
+    "shortcut": "clients.voicebox",
+    "className": "VoiceBoxClient",
     "methods": {
       "connect": {
-        "description": "Test the API connection by listing models.",
+        "description": "Validate the VoiceBox server is reachable by hitting the health endpoint.",
         "parameters": {},
         "required": [],
-        "returns": "Promise<this>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "await openai.connect()"
-          }
-        ]
+        "returns": "Promise<this>"
       },
-      "createChatCompletion": {
-        "description": "Create a chat completion using the Chat Completions API.",
-        "parameters": {
-          "messages": {
-            "type": "OpenAI.Chat.Completions.ChatCompletionMessageParam[]",
-            "description": "Array of chat messages"
-          },
-          "options": {
-            "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
-            "description": "Additional parameters for the completion"
-          }
-        },
-        "required": [
-          "messages"
-        ],
-        "returns": "Promise<OpenAI.Chat.Completions.ChatCompletion>",
+      "listProfiles": {
+        "description": "List all voice profiles.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<any[]>",
         "examples": [
           {
             "language": "ts",
-            "code": "const response = await openai.createChatCompletion([\n { role: 'system', content: 'You are a helpful assistant.' },\n { role: 'user', content: 'Hello!' }\n])\nconsole.log(response.choices[0]?.message?.content)"
+            "code": "const profiles = await vb.listProfiles()\nconsole.log(profiles.map(p => `${p.name} (${p.sample_count} samples)`))"
           }
         ]
       },
-      "createResponse": {
-        "description": "Create a response using the Responses API.",
+      "getProfile": {
+        "description": "Get a single voice profile by ID.",
         "parameters": {
-          "input": {
-            "type": "OpenAI.Responses.ResponseInput | string",
-            "description": "The input prompt or message array"
-          },
-          "options": {
-            "type": "Partial<OpenAI.Responses.ResponseCreateParamsNonStreaming>",
-            "description": "Additional parameters for the response"
+          "profileId": {
+            "type": "string",
+            "description": "Parameter profileId"
           }
         },
         "required": [
-          "input"
+          "profileId"
         ],
-        "returns": "Promise<OpenAI.Responses.Response>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const response = await openai.createResponse('Explain quantum computing')"
-          }
-        ]
+        "returns": "Promise<any>"
       },
-      "streamResponse": {
-        "description": "Stream a response using the Responses API.",
+      "createProfile": {
+        "description": "Create a new voice profile.",
         "parameters": {
-          "input": {
-            "type": "OpenAI.Responses.ResponseInput | string",
-            "description": "The input prompt or message array"
+          "name": {
+            "type": "string",
+            "description": "Parameter name"
           },
           "options": {
-            "type": "Partial<OpenAI.Responses.ResponseCreateParamsStreaming>",
-            "description": "Additional parameters for the streaming response"
+            "type": "{ description?: string; language?: string }",
+            "description": "Parameter options"
           }
         },
         "required": [
-          "input"
+          "name"
         ],
-        "returns": "Promise<AsyncIterable<OpenAI.Responses.ResponseStreamEvent>>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const stream = await openai.streamResponse('Write a poem')\nfor await (const event of stream) {\n if (event.type === 'response.output_text.delta') {\n   process.stdout.write(event.delta)\n }\n}"
-          }
-        ]
+        "returns": "Promise<any>"
       },
-      "createCompletion": {
-        "description": "Create a legacy text completion.",
+      "listEffects": {
+        "description": "List available audio effects and their parameter definitions.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<any>"
+      },
+      "synthesize": {
+        "description": "Synthesize speech from text using the streaming endpoint. Returns audio as a WAV Buffer (synchronous — blocks until audio is ready).",
         "parameters": {
-          "prompt": {
+          "text": {
             "type": "string",
-            "description": "The text prompt to complete"
+            "description": "The text to convert to speech"
           },
           "options": {
-            "type": "Partial<OpenAI.Completions.CompletionCreateParams>",
-            "description": "Additional parameters for the completion"
+            "type": "SynthesizeOptions",
+            "description": "Profile, engine, model, and other synthesis options",
+            "properties": {
+              "profileId": {
+                "type": "string",
+                "description": ""
+              },
+              "engine": {
+                "type": "string",
+                "description": ""
+              },
+              "modelSize": {
+                "type": "string",
+                "description": ""
+              },
+              "language": {
+                "type": "string",
+                "description": ""
+              },
+              "instruct": {
+                "type": "string",
+                "description": ""
+              },
+              "seed": {
+                "type": "number",
+                "description": ""
+              },
+              "maxChunkChars": {
+                "type": "number",
+                "description": ""
+              },
+              "crossfadeMs": {
+                "type": "number",
+                "description": ""
+              },
+              "normalize": {
+                "type": "boolean",
+                "description": ""
+              },
+              "effectsChain": {
+                "type": "EffectConfig[]",
+                "description": ""
+              },
+              "disableCache": {
+                "type": "boolean",
+                "description": ""
+              }
+            }
           }
         },
         "required": [
-          "prompt"
+          "text"
         ],
-        "returns": "Promise<OpenAI.Completions.Completion>",
+        "returns": "Promise<Buffer>",
         "examples": [
           {
             "language": "ts",
-            "code": "const response = await openai.createCompletion('Once upon a time')"
+            "code": "const audio = await vb.synthesize('Hello world', { profileId: 'abc-123' })\n// audio is a Buffer of WAV data"
           }
         ]
       },
-      "createEmbedding": {
-        "description": "Create text embeddings for semantic search or similarity comparisons.",
+      "generate": {
+        "description": "Generate speech asynchronously (returns metadata, not audio). Use getAudio() to fetch the audio after generation completes.",
         "parameters": {
-          "input": {
-            "type": "string | string[]",
-            "description": "A string or array of strings to embed"
+          "text": {
+            "type": "string",
+            "description": "Parameter text"
           },
           "options": {
-            "type": "Partial<OpenAI.Embeddings.EmbeddingCreateParams>",
-            "description": "Additional parameters (model, etc.)"
+            "type": "SynthesizeOptions",
+            "description": "Parameter options",
+            "properties": {
+              "profileId": {
+                "type": "string",
+                "description": ""
+              },
+              "engine": {
+                "type": "string",
+                "description": ""
+              },
+              "modelSize": {
+                "type": "string",
+                "description": ""
+              },
+              "language": {
+                "type": "string",
+                "description": ""
+              },
+              "instruct": {
+                "type": "string",
+                "description": ""
+              },
+              "seed": {
+                "type": "number",
+                "description": ""
+              },
+              "maxChunkChars": {
+                "type": "number",
+                "description": ""
+              },
+              "crossfadeMs": {
+                "type": "number",
+                "description": ""
+              },
+              "normalize": {
+                "type": "boolean",
+                "description": ""
+              },
+              "effectsChain": {
+                "type": "EffectConfig[]",
+                "description": ""
+              },
+              "disableCache": {
+                "type": "boolean",
+                "description": ""
+              }
+            }
           }
         },
         "required": [
-          "input"
+          "text"
         ],
-        "returns": "Promise<OpenAI.Embeddings.CreateEmbeddingResponse>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const response = await openai.createEmbedding('Hello world')\nconsole.log(response.data[0].embedding.length)"
-          }
-        ]
+        "returns": "Promise<any>"
       },
-      "createImage": {
-        "description": "Generate an image from a text prompt using DALL-E.",
+      "getAudio": {
+        "description": "Fetch generated audio by generation ID. Returns WAV Buffer.",
         "parameters": {
-          "prompt": {
+          "generationId": {
             "type": "string",
-            "description": "Description of the image to generate"
-          },
-          "options": {
-            "type": "Partial<OpenAI.Images.ImageGenerateParams>",
-            "description": "Additional parameters (size, n, etc.)"
+            "description": "Parameter generationId"
           }
         },
         "required": [
-          "prompt"
+          "generationId"
         ],
-        "returns": "Promise<OpenAI.Images.ImagesResponse>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const response = await openai.createImage('A sunset over mountains')\nconsole.log(response.data[0].url)"
-          }
-        ]
-      },
-      "listModels": {
-        "description": "List all available models.",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<OpenAI.Models.ModelsPage>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const models = await openai.listModels()"
-          }
-        ]
+        "returns": "Promise<Buffer>"
       },
-      "ask": {
-        "description": "Ask a single question and get a text response. Convenience wrapper around `createChatCompletion` for simple Q&A.",
+      "say": {
+        "description": "Synthesize and write audio to a file.",
         "parameters": {
-          "question": {
+          "text": {
             "type": "string",
-            "description": "The question to ask"
+            "description": "Parameter text"
           },
-          "options": {
-            "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
-            "description": "Additional completion parameters"
-          }
-        },
-        "required": [
-          "question"
-        ],
-        "returns": "Promise<string>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const answer = await openai.ask('What is 2 + 2?')\nconsole.log(answer) // '4'"
-          }
-        ]
-      },
-      "chat": {
-        "description": "Send a multi-turn conversation and get a text response. Convenience wrapper around `createChatCompletion` that returns just the text.",
-        "parameters": {
-          "messages": {
-            "type": "OpenAI.Chat.Completions.ChatCompletionMessageParam[]",
-            "description": "Array of chat messages"
+          "outputPath": {
+            "type": "string",
+            "description": "Parameter outputPath"
           },
           "options": {
-            "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
-            "description": "Additional completion parameters"
+            "type": "SynthesizeOptions",
+            "description": "Parameter options",
+            "properties": {
+              "profileId": {
+                "type": "string",
+                "description": ""
+              },
+              "engine": {
+                "type": "string",
+                "description": ""
+              },
+              "modelSize": {
+                "type": "string",
+                "description": ""
+              },
+              "language": {
+                "type": "string",
+                "description": ""
+              },
+              "instruct": {
+                "type": "string",
+                "description": ""
+              },
+              "seed": {
+                "type": "number",
+                "description": ""
+              },
+              "maxChunkChars": {
+                "type": "number",
+                "description": ""
+              },
+              "crossfadeMs": {
+                "type": "number",
+                "description": ""
+              },
+              "normalize": {
+                "type": "boolean",
+                "description": ""
+              },
+              "effectsChain": {
+                "type": "EffectConfig[]",
+                "description": ""
+              },
+              "disableCache": {
+                "type": "boolean",
+                "description": ""
+              }
+            }
           }
         },
         "required": [
-          "messages"
+          "text",
+          "outputPath"
         ],
-        "returns": "Promise<string>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const reply = await openai.chat([\n { role: 'system', content: 'You are a pirate.' },\n { role: 'user', content: 'Hello!' }\n])"
-          }
-        ]
-      }
-    },
-    "getters": {
-      "defaultModel": {
-        "description": "The default model used for completions, from options or 'gpt-4o'.",
-        "returns": "string"
-      },
-      "raw": {
-        "description": "The underlying OpenAI SDK instance for advanced use cases.",
-        "returns": "OpenAI"
+        "returns": "Promise<string>"
       }
     },
+    "getters": {},
     "events": {
-      "connected": {
-        "name": "connected",
-        "description": "Event emitted by OpenAIClient",
-        "arguments": {}
-      },
       "failure": {
         "name": "failure",
-        "description": "Event emitted by OpenAIClient",
-        "arguments": {}
-      },
-      "completion": {
-        "name": "completion",
-        "description": "Event emitted by OpenAIClient",
+        "description": "Event emitted by VoiceBoxClient",
         "arguments": {}
       },
-      "embedding": {
-        "name": "embedding",
-        "description": "Event emitted by OpenAIClient",
+      "profiles": {
+        "name": "profiles",
+        "description": "Event emitted by VoiceBoxClient",
         "arguments": {}
       },
-      "image": {
-        "name": "image",
-        "description": "Event emitted by OpenAIClient",
-        "arguments": {}
-      },
-      "models": {
-        "name": "models",
-        "description": "Event emitted by OpenAIClient",
+      "speech": {
+        "name": "speech",
+        "description": "Event emitted by VoiceBoxClient",
         "arguments": {}
       }
     },
@@ -32082,9 +32699,90 @@ export const introspectionData = [
     "examples": [
       {
         "language": "ts",
-        "code": "const openai = container.client('openai', { defaultModel: 'gpt-4o' })\nconst answer = await openai.ask('What is the meaning of life?')\nconsole.log(answer)"
+        "code": "const vb = container.client('voicebox')\nawait vb.connect()\nconst profiles = await vb.listProfiles()\nconst audio = await vb.synthesize('Hello world', { profileId: profiles[0].id })\n// audio is a Buffer of WAV data"
       }
-    ]
+    ],
+    "types": {
+      "SynthesizeOptions": {
+        "description": "",
+        "properties": {
+          "profileId": {
+            "type": "string",
+            "description": "",
+            "optional": true
+          },
+          "engine": {
+            "type": "string",
+            "description": "",
+            "optional": true
+          },
+          "modelSize": {
+            "type": "string",
+            "description": "",
+            "optional": true
+          },
+          "language": {
+            "type": "string",
+            "description": "",
+            "optional": true
+          },
+          "instruct": {
+            "type": "string",
+            "description": "",
+            "optional": true
+          },
+          "seed": {
+            "type": "number",
+            "description": "",
+            "optional": true
+          },
+          "maxChunkChars": {
+            "type": "number",
+            "description": "",
+            "optional": true
+          },
+          "crossfadeMs": {
+            "type": "number",
+            "description": "",
+            "optional": true
+          },
+          "normalize": {
+            "type": "boolean",
+            "description": "",
+            "optional": true
+          },
+          "effectsChain": {
+            "type": "EffectConfig[]",
+            "description": "",
+            "optional": true
+          },
+          "disableCache": {
+            "type": "boolean",
+            "description": "",
+            "optional": true
+          }
+        }
+      },
+      "EffectConfig": {
+        "description": "",
+        "properties": {
+          "type": {
+            "type": "string",
+            "description": ""
+          },
+          "enabled": {
+            "type": "boolean",
+            "description": "",
+            "optional": true
+          },
+          "params": {
+            "type": "Record<string, any>",
+            "description": "",
+            "optional": true
+          }
+        }
+      }
+    }
   },
   {
     "id": "clients.elevenlabs",
@@ -32349,6 +33047,201 @@ export const introspectionData = [
       }
     }
   },
+  {
+    "id": "clients.supabase",
+    "description": "Supabase client for the Luca container system. Wraps the official `@supabase/supabase-js` SDK and exposes it through Luca's typed state, events, and introspection system. The SDK is isomorphic so this single implementation works in both Node and browser containers. Use `client.sdk` for full SDK access, or use the convenience wrappers for common operations (auth, database queries, storage, edge functions, realtime).",
+    "shortcut": "clients.supabase",
+    "className": "SupabaseClient",
+    "methods": {
+      "from": {
+        "description": "Start a query on a Postgres table or view.",
+        "parameters": {
+          "table": {
+            "type": "string",
+            "description": "The table or view name to query"
+          }
+        },
+        "required": [
+          "table"
+        ],
+        "returns": "void"
+      },
+      "rpc": {
+        "description": "Call a Postgres function (RPC).",
+        "parameters": {
+          "fn": {
+            "type": "string",
+            "description": "The function name"
+          },
+          "params": {
+            "type": "Record<string, unknown>",
+            "description": "Arguments to pass to the function"
+          },
+          "options": {
+            "type": "{ head?: boolean; get?: boolean; count?: \"exact\" | \"planned\" | \"estimated\" }",
+            "description": "Optional settings (head, get, count)"
+          }
+        },
+        "required": [
+          "fn"
+        ],
+        "returns": "void"
+      },
+      "signInWithPassword": {
+        "description": "Sign in with email and password.",
+        "parameters": {
+          "email": {
+            "type": "string",
+            "description": "Parameter email"
+          },
+          "password": {
+            "type": "string",
+            "description": "Parameter password"
+          }
+        },
+        "required": [
+          "email",
+          "password"
+        ],
+        "returns": "void"
+      },
+      "signUp": {
+        "description": "Create a new user account with email and password.",
+        "parameters": {
+          "email": {
+            "type": "string",
+            "description": "Parameter email"
+          },
+          "password": {
+            "type": "string",
+            "description": "Parameter password"
+          }
+        },
+        "required": [
+          "email",
+          "password"
+        ],
+        "returns": "void"
+      },
+      "signOut": {
+        "description": "Sign the current user out.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "getSession": {
+        "description": "Get the current session, if any.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "getUser": {
+        "description": "Get the current user, if any.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "invoke": {
+        "description": "Invoke a Supabase Edge Function by name.",
+        "parameters": {
+          "name": {
+            "type": "string",
+            "description": "Parameter name"
+          },
+          "body": {
+            "type": "any",
+            "description": "Parameter body"
+          }
+        },
+        "required": [
+          "name"
+        ],
+        "returns": "void"
+      },
+      "subscribe": {
+        "description": "Subscribe to realtime changes on a Postgres table.",
+        "parameters": {
+          "channelName": {
+            "type": "string",
+            "description": "A name for this subscription channel"
+          },
+          "table": {
+            "type": "string",
+            "description": "The table to listen to"
+          },
+          "callback": {
+            "type": "(payload: any) => void",
+            "description": "Called with the payload on each change"
+          },
+          "event": {
+            "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
+            "description": "The event type to listen for (default: all changes)"
+          }
+        },
+        "required": [
+          "channelName",
+          "table",
+          "callback"
+        ],
+        "returns": "RealtimeChannel"
+      },
+      "unsubscribe": {
+        "description": "Unsubscribe and remove a realtime channel by name.",
+        "parameters": {
+          "channelName": {
+            "type": "string",
+            "description": "The channel name to remove"
+          }
+        },
+        "required": [
+          "channelName"
+        ],
+        "returns": "void"
+      },
+      "unsubscribeAll": {
+        "description": "Unsubscribe and remove all realtime channels.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "connect": {
+        "description": "Connect is a no-op since the Supabase SDK initializes on construction. The client is ready to use immediately after creation.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "disconnect": {
+        "description": "Disconnect by signing out and removing all realtime channels.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      }
+    },
+    "getters": {
+      "sdk": {
+        "description": "Returns the raw Supabase SDK client for full access to all SDK methods.",
+        "returns": "SupabaseSDKClient<any, any>"
+      },
+      "storage": {
+        "description": "Returns the Supabase Storage client for managing buckets and files.",
+        "returns": "any"
+      },
+      "functions": {
+        "description": "Returns the Supabase Functions client.",
+        "returns": "any"
+      }
+    },
+    "events": {},
+    "state": {},
+    "options": {},
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const supabase = container.client('supabase', {\n supabaseUrl: 'https://xyz.supabase.co',\n supabaseKey: 'your-anon-key',\n})\n\n// Query data\nconst { data } = await supabase.from('users').select('*')\n\n// Auth\nawait supabase.signInWithPassword('user@example.com', 'password')\n\n// Realtime\nsupabase.subscribe('changes', 'users', (payload) => {\n console.log('Change:', payload)\n})"
+      }
+    ]
+  },
   {
     "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).",
@@ -33072,6 +33965,16 @@ export const introspectionData = [
           "hasVoice": {
             "type": "boolean",
             "description": "Whether a voice.yaml configuration file exists."
+          },
+          "about": {
+            "type": "string",
+            "description": "Contents of ABOUT.md if present, undefined otherwise.",
+            "optional": true
+          },
+          "meta": {
+            "type": "Record<string, any>",
+            "description": "Frontmatter metadata parsed from CORE.md.",
+            "optional": true
           }
         }
       }
@@ -33166,22 +34069,45 @@ export const introspectionData = [
         ]
       },
       "fork": {
-        "description": "Fork the conversation into a new independent instance. The fork inherits the same system prompt, tools, and full message history, but has its own identity and state — changes in either direction do not affect the other.",
+        "description": "",
         "parameters": {
           "overrides": {
-            "type": "Partial<ConversationOptions>",
-            "description": "Optional option overrides for the forked conversation (e.g. different model or title)"
+            "type": "ForkOptions | ForkOptions[]",
+            "description": "Parameter overrides"
           }
         },
         "required": [],
-        "returns": "Conversation",
+        "returns": "Conversation | Conversation[]"
+      },
+      "research": {
+        "description": "Fan out N questions in parallel using forked conversations, return the results. Each fork is independent and ephemeral — no history is saved.",
+        "parameters": {
+          "questions": {
+            "type": "(string | { question: string; forkOptions?: ForkOptions })[]",
+            "description": "Array of questions (strings) or objects with question + per-fork overrides"
+          },
+          "defaults": {
+            "type": "ForkOptions",
+            "description": "Default fork options applied to all forks (individual overrides take precedence)"
+          }
+        },
+        "required": [
+          "questions"
+        ],
+        "returns": "Promise<string[]>",
         "examples": [
           {
             "language": "ts",
-            "code": "const fork = conversation.fork()\nawait fork.ask('What if we took a different approach?')\n// original conversation is unchanged"
+            "code": "const results = await conversation.research([\n \"What are the pros of approach A?\",\n \"What are the pros of approach B?\",\n], { history: 'none', model: 'gpt-4o-mini' })\n\n// Per-fork overrides\nconst results = await conversation.research([\n \"Quick factual question\",\n { question: \"Needs recent context\", forkOptions: { history: 5 } },\n], { history: 'none' })"
           }
         ]
       },
+      "abort": {
+        "description": "Abort the current ask() call. Cancels the in-flight network request and any pending tool executions. The ask() promise will reject with a ConversationAbortError whose `partial` property contains any text accumulated before the abort.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
       "estimateTokens": {
         "description": "Estimate the input token count for the current messages array using the js-tiktoken tokenizer. Updates state.",
         "parameters": {},
@@ -33340,6 +34266,11 @@ export const introspectionData = [
         "description": "Event emitted by Conversation",
         "arguments": {}
       },
+      "aborted": {
+        "name": "aborted",
+        "description": "Event emitted by Conversation",
+        "arguments": {}
+      },
       "toolError": {
         "name": "toolError",
         "description": "Event emitted by Conversation",
@@ -34799,8 +35730,26 @@ export const introspectionData = [
         ],
         "returns": "this"
       },
+      "triggerHook": {
+        "description": "Trigger a named hook and await its completion. The hook function receives `(assistant, ...args)` and its return value is passed back to the caller. This ensures hooks run to completion BEFORE any subsequent logic executes, unlike the old bus-based approach where async hooks were fire-and-forget. Hooks that don't exist are silently skipped (returns undefined).",
+        "parameters": {
+          "hookName": {
+            "type": "string",
+            "description": "The hook to trigger (matches an export name from hooks.ts)"
+          },
+          "args": {
+            "type": "any[]",
+            "description": "Arguments passed to the hook after the assistant instance"
+          }
+        },
+        "required": [
+          "hookName",
+          "args"
+        ],
+        "returns": "Promise<any>"
+      },
       "afterInitialize": {
-        "description": "Called immediately after the assistant is constructed. Synchronously loads the system prompt, tools, and hooks, then binds hooks as event listeners so every emitted event automatically invokes its corresponding hook.",
+        "description": "Called immediately after the assistant is constructed. Synchronously loads the system prompt, tools, and hooks. Hooks are invoked via triggerHook() at each emit site, ensuring async hooks are properly awaited.",
         "parameters": {},
         "required": [],
         "returns": "void"
@@ -35031,6 +35980,68 @@ export const introspectionData = [
         "required": [],
         "returns": "void"
       },
+      "fork": {
+        "description": "",
+        "parameters": {
+          "options": {
+            "type": "AssistantForkOptions | AssistantForkOptions[]",
+            "description": "Parameter options"
+          }
+        },
+        "required": [],
+        "returns": "Promise<Assistant | Assistant[]>"
+      },
+      "createResearchJob": {
+        "description": "Create a non-blocking research job that fans out questions across forked assistants. The forks fire immediately and the returned entity tracks progress via observable state and events. Each fork preserves the full assistant identity (interceptors, tools, hooks).",
+        "parameters": {
+          "prompt": {
+            "type": "string",
+            "description": "Shared context/framing prompt prepended to each fork's system prompt"
+          },
+          "questions": {
+            "type": "(string | { question: string; forkOptions?: AssistantForkOptions })[]",
+            "description": "Array of questions (strings) or objects with question + per-fork overrides"
+          },
+          "defaults": {
+            "type": "AssistantForkOptions",
+            "description": "Default fork options applied to all forks"
+          }
+        },
+        "required": [
+          "prompt",
+          "questions"
+        ],
+        "returns": "Promise<ResearchJob>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "// Fire and forget — check later\nconst job = await assistant.createResearchJob(\n \"Analyze this codebase for security issues\",\n [\"Look for SQL injection\", \"Look for XSS\", \"Look for auth bypass\"],\n { history: 'none', model: 'gpt-4o-mini' }\n)\n\n// Check progress\njob.state.get('completed') // 2 of 3\njob.state.get('results')   // [answer1, answer2, null]\n\n// React to events\njob.on('forkCompleted', (index, result) => console.log(`Fork ${index} done`))\n\n// Or just wait\nawait job.waitFor('completed')"
+          }
+        ]
+      },
+      "research": {
+        "description": "Fan out N questions in parallel using forked assistants, return the results. Sugar over createResearchJob — blocks until all forks complete.",
+        "parameters": {
+          "questions": {
+            "type": "(string | { question: string; forkOptions?: AssistantForkOptions })[]",
+            "description": "Array of questions (strings) or objects with question + per-fork overrides"
+          },
+          "defaults": {
+            "type": "AssistantForkOptions & { prompt?: string }",
+            "description": "Default fork options applied to all forks"
+          }
+        },
+        "required": [
+          "questions"
+        ],
+        "returns": "Promise<(string | null)[]>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const results = await assistant.research([\n \"What are best practices for X?\",\n \"What are common pitfalls of X?\",\n], { history: 'none', model: 'gpt-4o-mini' })"
+          }
+        ]
+      },
       "subagent": {
         "description": "Get or create a subagent assistant. Uses the assistantsManager to discover and create the assistant, then caches the instance for reuse across tool calls.",
         "parameters": {
@@ -35108,6 +36119,14 @@ export const introspectionData = [
         "description": "Whether the assistant has been started and is ready to receive questions.",
         "returns": "boolean"
       },
+      "isFork": {
+        "description": "Whether this assistant was created via fork().",
+        "returns": "boolean"
+      },
+      "forkDepth": {
+        "description": "How many levels deep this fork is. 0 = original, 1 = direct fork, 2 = fork of a fork, etc.",
+        "returns": "number"
+      },
       "systemPrompt": {
         "description": "The current system prompt text.",
         "returns": "string"
@@ -35162,6 +36181,11 @@ export const introspectionData = [
       }
     },
     "events": {
+      "hookFired": {
+        "name": "hookFired",
+        "description": "Event emitted by Assistant",
+        "arguments": {}
+      },
       "created": {
         "name": "created",
         "description": "Event emitted by Assistant",
@@ -35177,11 +36201,6 @@ export const introspectionData = [
         "description": "Event emitted by Assistant",
         "arguments": {}
       },
-      "hookFired": {
-        "name": "hookFired",
-        "description": "Event emitted by Assistant",
-        "arguments": {}
-      },
       "reloaded": {
         "name": "reloaded",
         "description": "Event emitted by Assistant",