@soederpop/luca 0.0.31 → 0.0.32

package/src/introspection/generated.agi.ts

@@ -1,7 +1,7 @@
 import { setBuildTimeData, setContainerBuildTimeData } from './index.js';
 
 // Auto-generated introspection registry data
-// Generated at: 2026-03-24T09:08:05.995Z
+// Generated at: 2026-03-24T09:09:09.989Z
 
 setBuildTimeData('features.googleDocs', {
   "id": "features.googleDocs",
@@ -11892,270 +11892,6 @@ setBuildTimeData('clients.supabase', {
   ]
 });
 
-setBuildTimeData('clients.elevenlabs', {
-  "id": "clients.elevenlabs",
-  "description": "ElevenLabs client — text-to-speech synthesis via the ElevenLabs REST API. Provides methods for listing voices, listing models, and generating speech audio. Audio is returned as a Buffer; use `say()` for a convenience method that writes to disk.",
-  "shortcut": "clients.elevenlabs",
-  "className": "ElevenLabsClient",
-  "methods": {
-    "beforeRequest": {
-      "description": "Inject the xi-api-key header before each request.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "connect": {
-      "description": "Validate the API key by listing available models.",
-      "parameters": {},
-      "required": [],
-      "returns": "Promise<this>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "await el.connect()"
-        }
-      ]
-    },
-    "listVoices": {
-      "description": "List available voices with optional search and filtering.",
-      "parameters": {
-        "options": {
-          "type": "{\n    search?: string\n    category?: string\n    voice_type?: string\n    page_size?: number\n    next_page_token?: string\n  }",
-          "description": "Query parameters for filtering voices"
-        }
-      },
-      "required": [],
-      "returns": "Promise<any>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const voices = await el.listVoices()\nconst premade = await el.listVoices({ category: 'premade' })"
-        }
-      ]
-    },
-    "getVoice": {
-      "description": "Get details for a single voice.",
-      "parameters": {
-        "voiceId": {
-          "type": "string",
-          "description": "The voice ID to look up"
-        }
-      },
-      "required": [
-        "voiceId"
-      ],
-      "returns": "Promise<any>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const voice = await el.getVoice('21m00Tcm4TlvDq8ikWAM')\nconsole.log(voice.name, voice.settings)"
-        }
-      ]
-    },
-    "listModels": {
-      "description": "List available TTS models.",
-      "parameters": {},
-      "required": [],
-      "returns": "Promise<any[]>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const models = await el.listModels()\nconsole.log(models.map(m => m.model_id))"
-        }
-      ]
-    },
-    "synthesize": {
-      "description": "Synthesize speech from text, returning audio as a Buffer.",
-      "parameters": {
-        "text": {
-          "type": "string",
-          "description": "The text to convert to speech"
-        },
-        "options": {
-          "type": "SynthesizeOptions",
-          "description": "Voice, model, format, and voice settings overrides",
-          "properties": {
-            "voiceId": {
-              "type": "string",
-              "description": ""
-            },
-            "modelId": {
-              "type": "string",
-              "description": ""
-            },
-            "outputFormat": {
-              "type": "string",
-              "description": ""
-            },
-            "voiceSettings": {
-              "type": "ElevenLabsVoiceSettings",
-              "description": ""
-            },
-            "disableCache": {
-              "type": "boolean",
-              "description": ""
-            }
-          }
-        }
-      },
-      "required": [
-        "text"
-      ],
-      "returns": "Promise<Buffer>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data\n\nconst custom = await el.synthesize('Hello', {\n voiceId: '21m00Tcm4TlvDq8ikWAM',\n voiceSettings: { stability: 0.5, similarityBoost: 0.8 }\n})"
-        }
-      ]
-    },
-    "say": {
-      "description": "Synthesize speech and write the audio to a file.",
-      "parameters": {
-        "text": {
-          "type": "string",
-          "description": "The text to convert to speech"
-        },
-        "outputPath": {
-          "type": "string",
-          "description": "File path to write the audio to"
-        },
-        "options": {
-          "type": "SynthesizeOptions",
-          "description": "Voice, model, format, and voice settings overrides",
-          "properties": {
-            "voiceId": {
-              "type": "string",
-              "description": ""
-            },
-            "modelId": {
-              "type": "string",
-              "description": ""
-            },
-            "outputFormat": {
-              "type": "string",
-              "description": ""
-            },
-            "voiceSettings": {
-              "type": "ElevenLabsVoiceSettings",
-              "description": ""
-            },
-            "disableCache": {
-              "type": "boolean",
-              "description": ""
-            }
-          }
-        }
-      },
-      "required": [
-        "text",
-        "outputPath"
-      ],
-      "returns": "Promise<string>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const path = await el.say('Hello world', './hello.mp3')\nconsole.log(`Audio saved to ${path}`)"
-        }
-      ]
-    }
-  },
-  "getters": {
-    "apiKey": {
-      "description": "The resolved API key from options or environment.",
-      "returns": "string"
-    }
-  },
-  "events": {
-    "failure": {
-      "name": "failure",
-      "description": "Event emitted by ElevenLabsClient",
-      "arguments": {}
-    },
-    "voices": {
-      "name": "voices",
-      "description": "Event emitted by ElevenLabsClient",
-      "arguments": {}
-    },
-    "speech": {
-      "name": "speech",
-      "description": "Event emitted by ElevenLabsClient",
-      "arguments": {}
-    }
-  },
-  "state": {},
-  "options": {},
-  "envVars": [],
-  "examples": [
-    {
-      "language": "ts",
-      "code": "const el = container.client('elevenlabs')\nawait el.connect()\nconst voices = await el.listVoices()\nconst audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data"
-    }
-  ],
-  "types": {
-    "SynthesizeOptions": {
-      "description": "",
-      "properties": {
-        "voiceId": {
-          "type": "string",
-          "description": "",
-          "optional": true
-        },
-        "modelId": {
-          "type": "string",
-          "description": "",
-          "optional": true
-        },
-        "outputFormat": {
-          "type": "string",
-          "description": "",
-          "optional": true
-        },
-        "voiceSettings": {
-          "type": "ElevenLabsVoiceSettings",
-          "description": "",
-          "optional": true
-        },
-        "disableCache": {
-          "type": "boolean",
-          "description": "",
-          "optional": true
-        }
-      }
-    },
-    "ElevenLabsVoiceSettings": {
-      "description": "",
-      "properties": {
-        "stability": {
-          "type": "number",
-          "description": "",
-          "optional": true
-        },
-        "similarityBoost": {
-          "type": "number",
-          "description": "",
-          "optional": true
-        },
-        "style": {
-          "type": "number",
-          "description": "",
-          "optional": true
-        },
-        "speed": {
-          "type": "number",
-          "description": "",
-          "optional": true
-        },
-        "useSpeakerBoost": {
-          "type": "boolean",
-          "description": "",
-          "optional": true
-        }
-      }
-    }
-  }
-});
-
 setBuildTimeData('clients.comfyui', {
   "id": "clients.comfyui",
   "description": "ComfyUI client — execute Stable Diffusion workflows via the ComfyUI API. Connects to a ComfyUI instance to queue prompts, track execution via WebSocket or polling, and download generated images. Supports both UI-format and API-format workflows with automatic conversion.",
@@ -12264,136 +12000,383 @@ setBuildTimeData('clients.comfyui', {
       ],
       "returns": "Promise<any>"
     },
-    "viewImage": {
-      "description": "Download a generated image from ComfyUI as a Buffer.",
+    "viewImage": {
+      "description": "Download a generated image from ComfyUI as a Buffer.",
+      "parameters": {
+        "filename": {
+          "type": "string",
+          "description": "The image filename"
+        },
+        "subfolder": {
+          "type": "any",
+          "description": "Subfolder within the output directory"
+        },
+        "type": {
+          "type": "any",
+          "description": "Image type ('output', 'input', 'temp')"
+        }
+      },
+      "required": [
+        "filename"
+      ],
+      "returns": "Promise<Buffer>"
+    },
+    "connectWs": {
+      "description": "Open a WebSocket connection to ComfyUI for real-time execution tracking. Events emitted: `execution_start`, `executing`, `progress`, `executed`, `execution_cached`, `execution_error`, `execution_complete`.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<void>"
+    },
+    "disconnectWs": {
+      "description": "Close the WebSocket connection.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "toApiFormat": {
+      "description": "Convert a UI-format workflow to the API format that /prompt expects. Requires a running ComfyUI instance to fetch `object_info` so we can map positional `widgets_values` to their named input fields. If the workflow is already in API format, it's returned as-is.",
+      "parameters": {
+        "workflow": {
+          "type": "Record<string, any>",
+          "description": "Parameter workflow"
+        }
+      },
+      "required": [
+        "workflow"
+      ],
+      "returns": "Promise<Record<string, any>>"
+    },
+    "runWorkflow": {
+      "description": "Run a ComfyUI workflow with optional runtime input overrides. Inputs can be provided in two forms: **Direct node mapping** (when no `inputMap` in options): ``` { '3': { seed: 42 }, '6': { text: 'a cat' } } ``` **Named inputs** (when `inputMap` is provided in options): ``` inputs: { positive_prompt: 'a cat', seed: 42 } options.inputMap: { positive_prompt: { nodeId: '6', field: 'text' }, seed: { nodeId: '3', field: 'seed' } } ```",
+      "parameters": {
+        "workflow": {
+          "type": "Record<string, any>",
+          "description": "Parameter workflow"
+        },
+        "inputs": {
+          "type": "Record<string, any>",
+          "description": "Parameter inputs"
+        },
+        "options": {
+          "type": "WorkflowRunOptions",
+          "description": "Parameter options",
+          "properties": {
+            "poll": {
+              "type": "boolean",
+              "description": "Use polling instead of WebSocket for tracking execution"
+            },
+            "pollInterval": {
+              "type": "number",
+              "description": "Polling interval in ms (default 1000)"
+            },
+            "inputMap": {
+              "type": "InputMapping",
+              "description": "Named input mapping: semantic name -> { nodeId, field }"
+            },
+            "outputDir": {
+              "type": "string",
+              "description": "If provided, output images are downloaded to this directory"
+            }
+          }
+        }
+      },
+      "required": [
+        "workflow"
+      ],
+      "returns": "Promise<WorkflowResult>"
+    }
+  },
+  "getters": {
+    "clientId": {
+      "description": "The unique client ID used for WebSocket session tracking.",
+      "returns": "string"
+    },
+    "wsURL": {
+      "description": "The WebSocket URL derived from baseURL or overridden via options.",
+      "returns": "string"
+    }
+  },
+  "events": {
+    "execution_start": {
+      "name": "execution_start",
+      "description": "Event emitted by ComfyUIClient",
+      "arguments": {}
+    },
+    "execution_complete": {
+      "name": "execution_complete",
+      "description": "Event emitted by ComfyUIClient",
+      "arguments": {}
+    },
+    "executing": {
+      "name": "executing",
+      "description": "Event emitted by ComfyUIClient",
+      "arguments": {}
+    },
+    "progress": {
+      "name": "progress",
+      "description": "Event emitted by ComfyUIClient",
+      "arguments": {}
+    },
+    "executed": {
+      "name": "executed",
+      "description": "Event emitted by ComfyUIClient",
+      "arguments": {}
+    },
+    "execution_cached": {
+      "name": "execution_cached",
+      "description": "Event emitted by ComfyUIClient",
+      "arguments": {}
+    },
+    "execution_error": {
+      "name": "execution_error",
+      "description": "Event emitted by ComfyUIClient",
+      "arguments": {}
+    }
+  },
+  "state": {},
+  "options": {},
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const comfy = container.client('comfyui', { baseURL: 'http://localhost:8188' })\nconst result = await comfy.runWorkflow(workflow, {\n '6': { text: 'a beautiful sunset' }\n})\nconsole.log(result.images)"
+    }
+  ],
+  "types": {
+    "WorkflowRunOptions": {
+      "description": "",
+      "properties": {
+        "poll": {
+          "type": "boolean",
+          "description": "Use polling instead of WebSocket for tracking execution",
+          "optional": true
+        },
+        "pollInterval": {
+          "type": "number",
+          "description": "Polling interval in ms (default 1000)",
+          "optional": true
+        },
+        "inputMap": {
+          "type": "InputMapping",
+          "description": "Named input mapping: semantic name -> { nodeId, field }",
+          "optional": true
+        },
+        "outputDir": {
+          "type": "string",
+          "description": "If provided, output images are downloaded to this directory",
+          "optional": true
+        }
+      }
+    },
+    "WorkflowResult": {
+      "description": "",
+      "properties": {
+        "promptId": {
+          "type": "string",
+          "description": ""
+        },
+        "outputs": {
+          "type": "Record<string, any>",
+          "description": ""
+        },
+        "images": {
+          "type": "Array<{ filename: string; subfolder: string; type: string; localPath?: string }>",
+          "description": "",
+          "optional": true
+        }
+      }
+    }
+  }
+});
+
+setBuildTimeData('clients.elevenlabs', {
+  "id": "clients.elevenlabs",
+  "description": "ElevenLabs client — text-to-speech synthesis via the ElevenLabs REST API. Provides methods for listing voices, listing models, and generating speech audio. Audio is returned as a Buffer; use `say()` for a convenience method that writes to disk.",
+  "shortcut": "clients.elevenlabs",
+  "className": "ElevenLabsClient",
+  "methods": {
+    "beforeRequest": {
+      "description": "Inject the xi-api-key header before each request.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "connect": {
+      "description": "Validate the API key by listing available models.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<this>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "await el.connect()"
+        }
+      ]
+    },
+    "listVoices": {
+      "description": "List available voices with optional search and filtering.",
+      "parameters": {
+        "options": {
+          "type": "{\n    search?: string\n    category?: string\n    voice_type?: string\n    page_size?: number\n    next_page_token?: string\n  }",
+          "description": "Query parameters for filtering voices"
+        }
+      },
+      "required": [],
+      "returns": "Promise<any>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const voices = await el.listVoices()\nconst premade = await el.listVoices({ category: 'premade' })"
+        }
+      ]
+    },
+    "getVoice": {
+      "description": "Get details for a single voice.",
       "parameters": {
-        "filename": {
+        "voiceId": {
           "type": "string",
-          "description": "The image filename"
-        },
-        "subfolder": {
-          "type": "any",
-          "description": "Subfolder within the output directory"
-        },
-        "type": {
-          "type": "any",
-          "description": "Image type ('output', 'input', 'temp')"
+          "description": "The voice ID to look up"
         }
       },
       "required": [
-        "filename"
+        "voiceId"
       ],
-      "returns": "Promise<Buffer>"
-    },
-    "connectWs": {
-      "description": "Open a WebSocket connection to ComfyUI for real-time execution tracking. Events emitted: `execution_start`, `executing`, `progress`, `executed`, `execution_cached`, `execution_error`, `execution_complete`.",
-      "parameters": {},
-      "required": [],
-      "returns": "Promise<void>"
+      "returns": "Promise<any>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const voice = await el.getVoice('21m00Tcm4TlvDq8ikWAM')\nconsole.log(voice.name, voice.settings)"
+        }
+      ]
     },
-    "disconnectWs": {
-      "description": "Close the WebSocket connection.",
+    "listModels": {
+      "description": "List available TTS models.",
       "parameters": {},
       "required": [],
-      "returns": "void"
+      "returns": "Promise<any[]>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const models = await el.listModels()\nconsole.log(models.map(m => m.model_id))"
+        }
+      ]
     },
-    "toApiFormat": {
-      "description": "Convert a UI-format workflow to the API format that /prompt expects. Requires a running ComfyUI instance to fetch `object_info` so we can map positional `widgets_values` to their named input fields. If the workflow is already in API format, it's returned as-is.",
+    "synthesize": {
+      "description": "Synthesize speech from text, returning audio as a Buffer.",
       "parameters": {
-        "workflow": {
-          "type": "Record<string, any>",
-          "description": "Parameter workflow"
+        "text": {
+          "type": "string",
+          "description": "The text to convert to speech"
+        },
+        "options": {
+          "type": "SynthesizeOptions",
+          "description": "Voice, model, format, and voice settings overrides",
+          "properties": {
+            "voiceId": {
+              "type": "string",
+              "description": ""
+            },
+            "modelId": {
+              "type": "string",
+              "description": ""
+            },
+            "outputFormat": {
+              "type": "string",
+              "description": ""
+            },
+            "voiceSettings": {
+              "type": "ElevenLabsVoiceSettings",
+              "description": ""
+            },
+            "disableCache": {
+              "type": "boolean",
+              "description": ""
+            }
+          }
         }
       },
       "required": [
-        "workflow"
+        "text"
       ],
-      "returns": "Promise<Record<string, any>>"
+      "returns": "Promise<Buffer>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data\n\nconst custom = await el.synthesize('Hello', {\n voiceId: '21m00Tcm4TlvDq8ikWAM',\n voiceSettings: { stability: 0.5, similarityBoost: 0.8 }\n})"
+        }
+      ]
     },
-    "runWorkflow": {
-      "description": "Run a ComfyUI workflow with optional runtime input overrides. Inputs can be provided in two forms: **Direct node mapping** (when no `inputMap` in options): ``` { '3': { seed: 42 }, '6': { text: 'a cat' } } ``` **Named inputs** (when `inputMap` is provided in options): ``` inputs: { positive_prompt: 'a cat', seed: 42 } options.inputMap: { positive_prompt: { nodeId: '6', field: 'text' }, seed: { nodeId: '3', field: 'seed' } } ```",
+    "say": {
+      "description": "Synthesize speech and write the audio to a file.",
       "parameters": {
-        "workflow": {
-          "type": "Record<string, any>",
-          "description": "Parameter workflow"
+        "text": {
+          "type": "string",
+          "description": "The text to convert to speech"
         },
-        "inputs": {
-          "type": "Record<string, any>",
-          "description": "Parameter inputs"
+        "outputPath": {
+          "type": "string",
+          "description": "File path to write the audio to"
         },
         "options": {
-          "type": "WorkflowRunOptions",
-          "description": "Parameter options",
+          "type": "SynthesizeOptions",
+          "description": "Voice, model, format, and voice settings overrides",
           "properties": {
-            "poll": {
-              "type": "boolean",
-              "description": "Use polling instead of WebSocket for tracking execution"
-            },
-            "pollInterval": {
-              "type": "number",
-              "description": "Polling interval in ms (default 1000)"
+            "voiceId": {
+              "type": "string",
+              "description": ""
             },
-            "inputMap": {
-              "type": "InputMapping",
-              "description": "Named input mapping: semantic name -> { nodeId, field }"
+            "modelId": {
+              "type": "string",
+              "description": ""
             },
-            "outputDir": {
+            "outputFormat": {
               "type": "string",
-              "description": "If provided, output images are downloaded to this directory"
+              "description": ""
+            },
+            "voiceSettings": {
+              "type": "ElevenLabsVoiceSettings",
+              "description": ""
+            },
+            "disableCache": {
+              "type": "boolean",
+              "description": ""
             }
           }
         }
       },
       "required": [
-        "workflow"
+        "text",
+        "outputPath"
       ],
-      "returns": "Promise<WorkflowResult>"
+      "returns": "Promise<string>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const path = await el.say('Hello world', './hello.mp3')\nconsole.log(`Audio saved to ${path}`)"
+        }
+      ]
     }
   },
   "getters": {
-    "clientId": {
-      "description": "The unique client ID used for WebSocket session tracking.",
-      "returns": "string"
-    },
-    "wsURL": {
-      "description": "The WebSocket URL derived from baseURL or overridden via options.",
+    "apiKey": {
+      "description": "The resolved API key from options or environment.",
       "returns": "string"
     }
   },
   "events": {
-    "execution_start": {
-      "name": "execution_start",
-      "description": "Event emitted by ComfyUIClient",
-      "arguments": {}
-    },
-    "execution_complete": {
-      "name": "execution_complete",
-      "description": "Event emitted by ComfyUIClient",
-      "arguments": {}
-    },
-    "executing": {
-      "name": "executing",
-      "description": "Event emitted by ComfyUIClient",
-      "arguments": {}
-    },
-    "progress": {
-      "name": "progress",
-      "description": "Event emitted by ComfyUIClient",
-      "arguments": {}
-    },
-    "executed": {
-      "name": "executed",
-      "description": "Event emitted by ComfyUIClient",
+    "failure": {
+      "name": "failure",
+      "description": "Event emitted by ElevenLabsClient",
       "arguments": {}
     },
-    "execution_cached": {
-      "name": "execution_cached",
-      "description": "Event emitted by ComfyUIClient",
+    "voices": {
+      "name": "voices",
+      "description": "Event emitted by ElevenLabsClient",
       "arguments": {}
     },
-    "execution_error": {
-      "name": "execution_error",
-      "description": "Event emitted by ComfyUIClient",
+    "speech": {
+      "name": "speech",
+      "description": "Event emitted by ElevenLabsClient",
       "arguments": {}
     }
   },
@@ -12403,48 +12386,65 @@ setBuildTimeData('clients.comfyui', {
   "examples": [
     {
       "language": "ts",
-      "code": "const comfy = container.client('comfyui', { baseURL: 'http://localhost:8188' })\nconst result = await comfy.runWorkflow(workflow, {\n '6': { text: 'a beautiful sunset' }\n})\nconsole.log(result.images)"
+      "code": "const el = container.client('elevenlabs')\nawait el.connect()\nconst voices = await el.listVoices()\nconst audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data"
     }
   ],
   "types": {
-    "WorkflowRunOptions": {
+    "SynthesizeOptions": {
       "description": "",
       "properties": {
-        "poll": {
-          "type": "boolean",
-          "description": "Use polling instead of WebSocket for tracking execution",
+        "voiceId": {
+          "type": "string",
+          "description": "",
           "optional": true
         },
-        "pollInterval": {
-          "type": "number",
-          "description": "Polling interval in ms (default 1000)",
+        "modelId": {
+          "type": "string",
+          "description": "",
           "optional": true
         },
-        "inputMap": {
-          "type": "InputMapping",
-          "description": "Named input mapping: semantic name -> { nodeId, field }",
+        "outputFormat": {
+          "type": "string",
+          "description": "",
           "optional": true
         },
-        "outputDir": {
-          "type": "string",
-          "description": "If provided, output images are downloaded to this directory",
+        "voiceSettings": {
+          "type": "ElevenLabsVoiceSettings",
+          "description": "",
+          "optional": true
+        },
+        "disableCache": {
+          "type": "boolean",
+          "description": "",
           "optional": true
         }
       }
     },
-    "WorkflowResult": {
+    "ElevenLabsVoiceSettings": {
       "description": "",
       "properties": {
-        "promptId": {
-          "type": "string",
-          "description": ""
+        "stability": {
+          "type": "number",
+          "description": "",
+          "optional": true
         },
-        "outputs": {
-          "type": "Record<string, any>",
-          "description": ""
+        "similarityBoost": {
+          "type": "number",
+          "description": "",
+          "optional": true
+        },
+        "style": {
+          "type": "number",
+          "description": "",
+          "optional": true
+        },
+        "speed": {
+          "type": "number",
+          "description": "",
+          "optional": true
         },
-        "images": {
-          "type": "Array<{ filename: string; subfolder: string; type: string; localPath?: string }>",
+        "useSpeakerBoost": {
+          "type": "boolean",
           "description": "",
           "optional": true
         }
@@ -28621,549 +28621,186 @@ export const introspectionData = [
             "type": "string",
             "description": "Optional operation name when the mutation contains multiple operations"
           }
-        },
-        "required": [
-          "mutation"
-        ],
-        "returns": "Promise<R>"
-      }
-    },
-    "getters": {
-      "endpoint": {
-        "description": "The GraphQL endpoint path. Defaults to '/graphql'.",
-        "returns": "any"
-      }
-    },
-    "events": {
-      "graphqlError": {
-        "name": "graphqlError",
-        "description": "Event emitted by GraphClient",
-        "arguments": {}
-      },
-      "failure": {
-        "name": "failure",
-        "description": "Event emitted by GraphClient",
-        "arguments": {}
-      }
-    },
-    "state": {},
-    "options": {},
-    "envVars": [],
-    "examples": [
-      {
-        "language": "ts",
-        "code": "const gql = container.client('graph', { baseURL: 'https://api.example.com' })\nconst data = await gql.query(`{ users { id name } }`)\nawait gql.mutate(`mutation($name: String!) { createUser(name: $name) { id } }`, { name: 'Alice' })"
-      }
-    ]
-  },
-  {
-    "id": "clients.rest",
-    "description": "HTTP REST client built on top of axios. Provides convenience methods for GET, POST, PUT, PATCH, and DELETE requests with automatic JSON handling, configurable base URL, and error event emission.",
-    "shortcut": "clients.rest",
-    "className": "RestClient",
-    "methods": {
-      "beforeRequest": {
-        "description": "",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<void>"
-      },
-      "patch": {
-        "description": "Send a PATCH request. Returns the parsed response body directly (not an axios Response wrapper). On HTTP errors, returns the error as JSON instead of throwing.",
-        "parameters": {
-          "url": {
-            "type": "string",
-            "description": "Request path relative to baseURL"
-          },
-          "data": {
-            "type": "any",
-            "description": "Request body"
-          },
-          "options": {
-            "type": "AxiosRequestConfig",
-            "description": "Additional axios request config"
-          }
-        },
-        "required": [
-          "url"
-        ],
-        "returns": "Promise<any>"
-      },
-      "put": {
-        "description": "Send a PUT request. Returns the parsed response body directly (not an axios Response wrapper). On HTTP errors, returns the error as JSON instead of throwing.",
-        "parameters": {
-          "url": {
-            "type": "string",
-            "description": "Request path relative to baseURL"
-          },
-          "data": {
-            "type": "any",
-            "description": "Request body"
-          },
-          "options": {
-            "type": "AxiosRequestConfig",
-            "description": "Additional axios request config"
-          }
-        },
-        "required": [
-          "url"
-        ],
-        "returns": "Promise<any>"
-      },
-      "post": {
-        "description": "Send a POST request. Returns the parsed response body directly (not an axios Response wrapper). On HTTP errors, returns the error as JSON instead of throwing.",
-        "parameters": {
-          "url": {
-            "type": "string",
-            "description": "Request path relative to baseURL"
-          },
-          "data": {
-            "type": "any",
-            "description": "Request body"
-          },
-          "options": {
-            "type": "AxiosRequestConfig",
-            "description": "Additional axios request config"
-          }
-        },
-        "required": [
-          "url"
-        ],
-        "returns": "Promise<any>"
-      },
-      "delete": {
-        "description": "Send a DELETE request. Returns the parsed response body directly (not an axios Response wrapper). On HTTP errors, returns the error as JSON instead of throwing.",
-        "parameters": {
-          "url": {
-            "type": "string",
-            "description": "Request path relative to baseURL"
-          },
-          "params": {
-            "type": "any",
-            "description": "Query parameters"
-          },
-          "options": {
-            "type": "AxiosRequestConfig",
-            "description": "Additional axios request config"
-          }
-        },
-        "required": [
-          "url"
-        ],
-        "returns": "Promise<any>"
-      },
-      "get": {
-        "description": "Send a GET request. Returns the parsed response body directly (not an axios Response wrapper). On HTTP errors, returns the error as JSON instead of throwing.",
-        "parameters": {
-          "url": {
-            "type": "string",
-            "description": "Request path relative to baseURL"
-          },
-          "params": {
-            "type": "any",
-            "description": "Query parameters"
-          },
-          "options": {
-            "type": "AxiosRequestConfig",
-            "description": "Additional axios request config"
-          }
-        },
-        "required": [
-          "url"
-        ],
-        "returns": "Promise<any>"
-      },
-      "handleError": {
-        "description": "Handle an axios error by emitting 'failure' and returning the error as JSON.",
-        "parameters": {
-          "error": {
-            "type": "AxiosError",
-            "description": "Parameter error"
-          }
-        },
-        "required": [
-          "error"
-        ],
-        "returns": "Promise<object>"
-      }
-    },
-    "getters": {
-      "useJSON": {
-        "description": "Whether JSON content-type headers should be set automatically.",
-        "returns": "any"
-      },
-      "baseURL": {
-        "description": "",
-        "returns": "any"
-      }
-    },
-    "events": {
-      "failure": {
-        "name": "failure",
-        "description": "Event emitted by RestClient",
-        "arguments": {}
-      }
-    },
-    "state": {},
-    "options": {},
-    "envVars": [],
-    "examples": [
-      {
-        "language": "ts",
-        "code": "const api = container.client('rest', { baseURL: 'https://api.example.com', json: true })\nconst users = await api.get('/users')\nawait api.post('/users', { name: 'Alice' })"
-      }
-    ]
-  },
-  {
-    "id": "clients.websocket",
-    "description": "WebSocketClient helper",
-    "shortcut": "clients.websocket",
-    "className": "WebSocketClient",
-    "methods": {
-      "connect": {
-        "description": "Establish a WebSocket connection to the configured baseURL. Wires all raw WebSocket events (open, message, close, error) to the Helper event bus and updates connection state accordingly. Resolves once the connection is open; rejects on error.",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<this>"
-      },
-      "send": {
-        "description": "Send data over the WebSocket connection. Automatically JSON-serializes the payload. If not currently connected, attempts to connect first.",
-        "parameters": {
-          "data": {
-            "type": "any",
-            "description": "The data to send (will be JSON.stringify'd)"
-          }
-        },
-        "required": [
-          "data"
-        ],
-        "returns": "Promise<void>"
-      },
-      "ask": {
-        "description": "Send a request and wait for a correlated response. The message is sent with a unique `requestId`; the remote side is expected to reply with a message containing `replyTo` set to that same ID.",
-        "parameters": {
-          "type": {
-            "type": "string",
-            "description": "A string identifying the request type"
-          },
-          "data": {
-            "type": "any",
-            "description": "Optional payload to include with the request"
-          },
-          "timeout": {
-            "type": "any",
-            "description": "How long to wait for a response (default 10 000 ms)"
-          }
-        },
-        "required": [
-          "type"
-        ],
-        "returns": "Promise<R>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const result = await ws.ask('getUser', { id: 42 })"
-          }
-        ]
-      },
-      "disconnect": {
-        "description": "Gracefully close the WebSocket connection. Suppresses auto-reconnect and updates connection state to disconnected.",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<this>"
+        },
+        "required": [
+          "mutation"
+        ],
+        "returns": "Promise<R>"
       }
     },
     "getters": {
-      "hasError": {
-        "description": "Whether the client is in an error state.",
+      "endpoint": {
+        "description": "The GraphQL endpoint path. Defaults to '/graphql'.",
         "returns": "any"
       }
     },
     "events": {
-      "open": {
-        "name": "open",
-        "description": "Event emitted by WebSocketClient",
-        "arguments": {}
-      },
-      "error": {
-        "name": "error",
-        "description": "Event emitted by WebSocketClient",
-        "arguments": {}
-      },
-      "message": {
-        "name": "message",
-        "description": "Event emitted by WebSocketClient",
-        "arguments": {}
-      },
-      "close": {
-        "name": "close",
-        "description": "Event emitted by WebSocketClient",
+      "graphqlError": {
+        "name": "graphqlError",
+        "description": "Event emitted by GraphClient",
         "arguments": {}
       },
-      "reconnecting": {
-        "name": "reconnecting",
-        "description": "Event emitted by WebSocketClient",
+      "failure": {
+        "name": "failure",
+        "description": "Event emitted by GraphClient",
         "arguments": {}
       }
     },
     "state": {},
     "options": {},
-    "envVars": []
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const gql = container.client('graph', { baseURL: 'https://api.example.com' })\nconst data = await gql.query(`{ users { id name } }`)\nawait gql.mutate(`mutation($name: String!) { createUser(name: $name) { id } }`, { name: 'Alice' })"
+      }
+    ]
   },
   {
-    "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.rest",
+    "description": "HTTP REST client built on top of axios. Provides convenience methods for GET, POST, PUT, PATCH, and DELETE requests with automatic JSON handling, configurable base URL, and error event emission.",
+    "shortcut": "clients.rest",
+    "className": "RestClient",
     "methods": {
-      "connect": {
-        "description": "Test the API connection by listing models.",
+      "beforeRequest": {
+        "description": "",
         "parameters": {},
         "required": [],
-        "returns": "Promise<this>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "await openai.connect()"
-          }
-        ]
+        "returns": "Promise<void>"
       },
-      "createChatCompletion": {
-        "description": "Create a chat completion using the Chat Completions API.",
+      "patch": {
+        "description": "Send a PATCH request. Returns the parsed response body directly (not an axios Response wrapper). On HTTP errors, returns the error as JSON instead of throwing.",
         "parameters": {
-          "messages": {
-            "type": "OpenAI.Chat.Completions.ChatCompletionMessageParam[]",
-            "description": "Array of chat messages"
+          "url": {
+            "type": "string",
+            "description": "Request path relative to baseURL"
           },
-          "options": {
-            "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
-            "description": "Additional parameters for the completion"
-          }
-        },
-        "required": [
-          "messages"
-        ],
-        "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)"
-          }
-        ]
-      },
-      "createResponse": {
-        "description": "Create a response using the Responses API.",
-        "parameters": {
-          "input": {
-            "type": "OpenAI.Responses.ResponseInput | string",
-            "description": "The input prompt or message array"
+          "data": {
+            "type": "any",
+            "description": "Request body"
           },
           "options": {
-            "type": "Partial<OpenAI.Responses.ResponseCreateParamsNonStreaming>",
-            "description": "Additional parameters for the response"
+            "type": "AxiosRequestConfig",
+            "description": "Additional axios request config"
           }
         },
         "required": [
-          "input"
+          "url"
         ],
-        "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.",
+      "put": {
+        "description": "Send a PUT request. Returns the parsed response body directly (not an axios Response wrapper). On HTTP errors, returns the error as JSON instead of throwing.",
         "parameters": {
-          "input": {
-            "type": "OpenAI.Responses.ResponseInput | string",
-            "description": "The input prompt or message array"
+          "url": {
+            "type": "string",
+            "description": "Request path relative to baseURL"
+          },
+          "data": {
+            "type": "any",
+            "description": "Request body"
           },
           "options": {
-            "type": "Partial<OpenAI.Responses.ResponseCreateParamsStreaming>",
-            "description": "Additional parameters for the streaming response"
+            "type": "AxiosRequestConfig",
+            "description": "Additional axios request config"
           }
         },
         "required": [
-          "input"
+          "url"
         ],
-        "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.",
+      "post": {
+        "description": "Send a POST request. Returns the parsed response body directly (not an axios Response wrapper). On HTTP errors, returns the error as JSON instead of throwing.",
         "parameters": {
-          "prompt": {
+          "url": {
             "type": "string",
-            "description": "The text prompt to complete"
+            "description": "Request path relative to baseURL"
           },
-          "options": {
-            "type": "Partial<OpenAI.Completions.CompletionCreateParams>",
-            "description": "Additional parameters for the completion"
-          }
-        },
-        "required": [
-          "prompt"
-        ],
-        "returns": "Promise<OpenAI.Completions.Completion>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const response = await openai.createCompletion('Once upon a time')"
-          }
-        ]
-      },
-      "createEmbedding": {
-        "description": "Create text embeddings for semantic search or similarity comparisons.",
-        "parameters": {
-          "input": {
-            "type": "string | string[]",
-            "description": "A string or array of strings to embed"
+          "data": {
+            "type": "any",
+            "description": "Request body"
           },
           "options": {
-            "type": "Partial<OpenAI.Embeddings.EmbeddingCreateParams>",
-            "description": "Additional parameters (model, etc.)"
+            "type": "AxiosRequestConfig",
+            "description": "Additional axios request config"
           }
         },
         "required": [
-          "input"
+          "url"
         ],
-        "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.",
+      "delete": {
+        "description": "Send a DELETE request. Returns the parsed response body directly (not an axios Response wrapper). On HTTP errors, returns the error as JSON instead of throwing.",
         "parameters": {
-          "prompt": {
+          "url": {
             "type": "string",
-            "description": "Description of the image to generate"
+            "description": "Request path relative to baseURL"
+          },
+          "params": {
+            "type": "any",
+            "description": "Query parameters"
           },
           "options": {
-            "type": "Partial<OpenAI.Images.ImageGenerateParams>",
-            "description": "Additional parameters (size, n, etc.)"
+            "type": "AxiosRequestConfig",
+            "description": "Additional axios request config"
           }
         },
         "required": [
-          "prompt"
+          "url"
         ],
-        "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<any>"
       },
-      "ask": {
-        "description": "Ask a single question and get a text response. Convenience wrapper around `createChatCompletion` for simple Q&A.",
+      "get": {
+        "description": "Send a GET request. Returns the parsed response body directly (not an axios Response wrapper). On HTTP errors, returns the error as JSON instead of throwing.",
         "parameters": {
-          "question": {
+          "url": {
             "type": "string",
-            "description": "The question to ask"
+            "description": "Request path relative to baseURL"
           },
-          "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"
+          "params": {
+            "type": "any",
+            "description": "Query parameters"
           },
           "options": {
-            "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
-            "description": "Additional completion parameters"
+            "type": "AxiosRequestConfig",
+            "description": "Additional axios request config"
           }
         },
         "required": [
-          "messages"
+          "url"
         ],
-        "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])"
+        "returns": "Promise<any>"
+      },
+      "handleError": {
+        "description": "Handle an axios error by emitting 'failure' and returning the error as JSON.",
+        "parameters": {
+          "error": {
+            "type": "AxiosError",
+            "description": "Parameter error"
           }
-        ]
+        },
+        "required": [
+          "error"
+        ],
+        "returns": "Promise<object>"
       }
     },
     "getters": {
-      "defaultModel": {
-        "description": "The default model used for completions, from options or 'gpt-4o'.",
-        "returns": "string"
+      "useJSON": {
+        "description": "Whether JSON content-type headers should be set automatically.",
+        "returns": "any"
       },
-      "raw": {
-        "description": "The underlying OpenAI SDK instance for advanced use cases.",
-        "returns": "OpenAI"
+      "baseURL": {
+        "description": "",
+        "returns": "any"
       }
     },
     "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",
-        "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",
+        "description": "Event emitted by RestClient",
         "arguments": {}
       }
     },
@@ -29173,393 +28810,360 @@ 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 api = container.client('rest', { baseURL: 'https://api.example.com', json: true })\nconst users = await api.get('/users')\nawait api.post('/users', { name: 'Alice' })"
       }
     ]
   },
   {
-    "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.websocket",
+    "description": "WebSocketClient helper",
+    "shortcut": "clients.websocket",
+    "className": "WebSocketClient",
     "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"
+      "connect": {
+        "description": "Establish a WebSocket connection to the configured baseURL. Wires all raw WebSocket events (open, message, close, error) to the Helper event bus and updates connection state accordingly. Resolves once the connection is open; rejects on error.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<this>"
       },
-      "rpc": {
-        "description": "Call a Postgres function (RPC).",
+      "send": {
+        "description": "Send data over the WebSocket connection. Automatically JSON-serializes the payload. If not currently connected, attempts to connect first.",
         "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)"
+          "data": {
+            "type": "any",
+            "description": "The data to send (will be JSON.stringify'd)"
           }
         },
         "required": [
-          "fn"
+          "data"
         ],
-        "returns": "void"
+        "returns": "Promise<void>"
       },
-      "signInWithPassword": {
-        "description": "Sign in with email and password.",
+      "ask": {
+        "description": "Send a request and wait for a correlated response. The message is sent with a unique `requestId`; the remote side is expected to reply with a message containing `replyTo` set to that same ID.",
         "parameters": {
-          "email": {
+          "type": {
             "type": "string",
-            "description": "Parameter email"
+            "description": "A string identifying the request type"
           },
-          "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"
+          "data": {
+            "type": "any",
+            "description": "Optional payload to include with the request"
           },
-          "password": {
-            "type": "string",
-            "description": "Parameter password"
+          "timeout": {
+            "type": "any",
+            "description": "How long to wait for a response (default 10 000 ms)"
           }
         },
         "required": [
-          "email",
-          "password"
+          "type"
         ],
-        "returns": "void"
+        "returns": "Promise<R>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const result = await ws.ask('getUser', { id: 42 })"
+          }
+        ]
       },
-      "signOut": {
-        "description": "Sign the current user out.",
+      "disconnect": {
+        "description": "Gracefully close the WebSocket connection. Suppresses auto-reconnect and updates connection state to disconnected.",
         "parameters": {},
         "required": [],
-        "returns": "void"
+        "returns": "Promise<this>"
+      }
+    },
+    "getters": {
+      "hasError": {
+        "description": "Whether the client is in an error state.",
+        "returns": "any"
+      }
+    },
+    "events": {
+      "open": {
+        "name": "open",
+        "description": "Event emitted by WebSocketClient",
+        "arguments": {}
       },
-      "getSession": {
-        "description": "Get the current session, if any.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
+      "error": {
+        "name": "error",
+        "description": "Event emitted by WebSocketClient",
+        "arguments": {}
       },
-      "getUser": {
-        "description": "Get the current user, if any.",
+      "message": {
+        "name": "message",
+        "description": "Event emitted by WebSocketClient",
+        "arguments": {}
+      },
+      "close": {
+        "name": "close",
+        "description": "Event emitted by WebSocketClient",
+        "arguments": {}
+      },
+      "reconnecting": {
+        "name": "reconnecting",
+        "description": "Event emitted by WebSocketClient",
+        "arguments": {}
+      }
+    },
+    "state": {},
+    "options": {},
+    "envVars": []
+  },
+  {
+    "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": {
+      "connect": {
+        "description": "Test the API connection by listing models.",
         "parameters": {},
         "required": [],
-        "returns": "void"
+        "returns": "Promise<this>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "await openai.connect()"
+          }
+        ]
       },
-      "invoke": {
-        "description": "Invoke a Supabase Edge Function by name.",
+      "createChatCompletion": {
+        "description": "Create a chat completion using the Chat Completions API.",
         "parameters": {
-          "name": {
-            "type": "string",
-            "description": "Parameter name"
+          "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>",
+        "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)"
+          }
+        ]
+      },
+      "createResponse": {
+        "description": "Create a response using the Responses API.",
+        "parameters": {
+          "input": {
+            "type": "OpenAI.Responses.ResponseInput | string",
+            "description": "The input prompt or message array"
           },
-          "body": {
-            "type": "any",
-            "description": "Parameter body"
+          "options": {
+            "type": "Partial<OpenAI.Responses.ResponseCreateParamsNonStreaming>",
+            "description": "Additional parameters for the response"
           }
         },
         "required": [
-          "name"
+          "input"
         ],
-        "returns": "void"
+        "returns": "Promise<OpenAI.Responses.Response>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const response = await openai.createResponse('Explain quantum computing')"
+          }
+        ]
       },
-      "subscribe": {
-        "description": "Subscribe to realtime changes on a Postgres table.",
+      "streamResponse": {
+        "description": "Stream a response using the Responses API.",
         "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"
+          "input": {
+            "type": "OpenAI.Responses.ResponseInput | string",
+            "description": "The input prompt or message array"
           },
-          "event": {
-            "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
-            "description": "The event type to listen for (default: all changes)"
+          "options": {
+            "type": "Partial<OpenAI.Responses.ResponseCreateParamsStreaming>",
+            "description": "Additional parameters for the streaming response"
           }
         },
         "required": [
-          "channelName",
-          "table",
-          "callback"
+          "input"
         ],
-        "returns": "RealtimeChannel"
+        "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}"
+          }
+        ]
       },
-      "unsubscribe": {
-        "description": "Unsubscribe and remove a realtime channel by name.",
+      "createCompletion": {
+        "description": "Create a legacy text completion.",
         "parameters": {
-          "channelName": {
+          "prompt": {
             "type": "string",
-            "description": "The channel name to remove"
+            "description": "The text prompt to complete"
+          },
+          "options": {
+            "type": "Partial<OpenAI.Completions.CompletionCreateParams>",
+            "description": "Additional parameters for the completion"
           }
         },
         "required": [
-          "channelName"
+          "prompt"
         ],
-        "returns": "void"
-      },
-      "unsubscribeAll": {
-        "description": "Unsubscribe and remove all realtime channels.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "connect": {
-        "description": "Connect is a no-op since the Supabase SDK initializes on construction. The client is ready to use immediately after creation.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "disconnect": {
-        "description": "Disconnect by signing out and removing all realtime channels.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      }
-    },
-    "getters": {
-      "sdk": {
-        "description": "Returns the raw Supabase SDK client for full access to all SDK methods.",
-        "returns": "SupabaseSDKClient<any, any>"
-      },
-      "storage": {
-        "description": "Returns the Supabase Storage client for managing buckets and files.",
-        "returns": "any"
-      },
-      "functions": {
-        "description": "Returns the Supabase Functions client.",
-        "returns": "any"
-      }
-    },
-    "events": {},
-    "state": {},
-    "options": {},
-    "envVars": [],
-    "examples": [
-      {
-        "language": "ts",
-        "code": "const supabase = container.client('supabase', {\n supabaseUrl: 'https://xyz.supabase.co',\n supabaseKey: 'your-anon-key',\n})\n\n// Query data\nconst { data } = await supabase.from('users').select('*')\n\n// Auth\nawait supabase.signInWithPassword('user@example.com', 'password')\n\n// Realtime\nsupabase.subscribe('changes', 'users', (payload) => {\n console.log('Change:', payload)\n})"
-      }
-    ]
-  },
-  {
-    "id": "clients.elevenlabs",
-    "description": "ElevenLabs client — text-to-speech synthesis via the ElevenLabs REST API. Provides methods for listing voices, listing models, and generating speech audio. Audio is returned as a Buffer; use `say()` for a convenience method that writes to disk.",
-    "shortcut": "clients.elevenlabs",
-    "className": "ElevenLabsClient",
-    "methods": {
-      "beforeRequest": {
-        "description": "Inject the xi-api-key header before each request.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "connect": {
-        "description": "Validate the API key by listing available models.",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<this>",
+        "returns": "Promise<OpenAI.Completions.Completion>",
         "examples": [
           {
             "language": "ts",
-            "code": "await el.connect()"
+            "code": "const response = await openai.createCompletion('Once upon a time')"
           }
         ]
       },
-      "listVoices": {
-        "description": "List available voices with optional search and filtering.",
+      "createEmbedding": {
+        "description": "Create text embeddings for semantic search or similarity comparisons.",
         "parameters": {
+          "input": {
+            "type": "string | string[]",
+            "description": "A string or array of strings to embed"
+          },
           "options": {
-            "type": "{\n    search?: string\n    category?: string\n    voice_type?: string\n    page_size?: number\n    next_page_token?: string\n  }",
-            "description": "Query parameters for filtering voices"
+            "type": "Partial<OpenAI.Embeddings.EmbeddingCreateParams>",
+            "description": "Additional parameters (model, etc.)"
           }
         },
-        "required": [],
-        "returns": "Promise<any>",
+        "required": [
+          "input"
+        ],
+        "returns": "Promise<OpenAI.Embeddings.CreateEmbeddingResponse>",
         "examples": [
           {
             "language": "ts",
-            "code": "const voices = await el.listVoices()\nconst premade = await el.listVoices({ category: 'premade' })"
+            "code": "const response = await openai.createEmbedding('Hello world')\nconsole.log(response.data[0].embedding.length)"
           }
         ]
       },
-      "getVoice": {
-        "description": "Get details for a single voice.",
+      "createImage": {
+        "description": "Generate an image from a text prompt using DALL-E.",
         "parameters": {
-          "voiceId": {
+          "prompt": {
             "type": "string",
-            "description": "The voice ID to look up"
+            "description": "Description of the image to generate"
+          },
+          "options": {
+            "type": "Partial<OpenAI.Images.ImageGenerateParams>",
+            "description": "Additional parameters (size, n, etc.)"
           }
         },
         "required": [
-          "voiceId"
+          "prompt"
         ],
-        "returns": "Promise<any>",
+        "returns": "Promise<OpenAI.Images.ImagesResponse>",
         "examples": [
           {
             "language": "ts",
-            "code": "const voice = await el.getVoice('21m00Tcm4TlvDq8ikWAM')\nconsole.log(voice.name, voice.settings)"
+            "code": "const response = await openai.createImage('A sunset over mountains')\nconsole.log(response.data[0].url)"
           }
         ]
       },
       "listModels": {
-        "description": "List available TTS models.",
+        "description": "List all available models.",
         "parameters": {},
         "required": [],
-        "returns": "Promise<any[]>",
+        "returns": "Promise<OpenAI.Models.ModelsPage>",
         "examples": [
           {
             "language": "ts",
-            "code": "const models = await el.listModels()\nconsole.log(models.map(m => m.model_id))"
+            "code": "const models = await openai.listModels()"
           }
         ]
       },
-      "synthesize": {
-        "description": "Synthesize speech from text, returning audio as a Buffer.",
+      "ask": {
+        "description": "Ask a single question and get a text response. Convenience wrapper around `createChatCompletion` for simple Q&A.",
         "parameters": {
-          "text": {
+          "question": {
             "type": "string",
-            "description": "The text to convert to speech"
+            "description": "The question to ask"
           },
           "options": {
-            "type": "SynthesizeOptions",
-            "description": "Voice, model, format, and voice settings overrides",
-            "properties": {
-              "voiceId": {
-                "type": "string",
-                "description": ""
-              },
-              "modelId": {
-                "type": "string",
-                "description": ""
-              },
-              "outputFormat": {
-                "type": "string",
-                "description": ""
-              },
-              "voiceSettings": {
-                "type": "ElevenLabsVoiceSettings",
-                "description": ""
-              },
-              "disableCache": {
-                "type": "boolean",
-                "description": ""
-              }
-            }
+            "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
+            "description": "Additional completion parameters"
           }
         },
         "required": [
-          "text"
+          "question"
         ],
-        "returns": "Promise<Buffer>",
+        "returns": "Promise<string>",
         "examples": [
           {
             "language": "ts",
-            "code": "const audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data\n\nconst custom = await el.synthesize('Hello', {\n voiceId: '21m00Tcm4TlvDq8ikWAM',\n voiceSettings: { stability: 0.5, similarityBoost: 0.8 }\n})"
+            "code": "const answer = await openai.ask('What is 2 + 2?')\nconsole.log(answer) // '4'"
           }
         ]
       },
-      "say": {
-        "description": "Synthesize speech and write the audio to a file.",
-        "parameters": {
-          "text": {
-            "type": "string",
-            "description": "The text to convert to speech"
-          },
-          "outputPath": {
-            "type": "string",
-            "description": "File path to write the audio to"
-          },
-          "options": {
-            "type": "SynthesizeOptions",
-            "description": "Voice, model, format, and voice settings overrides",
-            "properties": {
-              "voiceId": {
-                "type": "string",
-                "description": ""
-              },
-              "modelId": {
-                "type": "string",
-                "description": ""
-              },
-              "outputFormat": {
-                "type": "string",
-                "description": ""
-              },
-              "voiceSettings": {
-                "type": "ElevenLabsVoiceSettings",
-                "description": ""
-              },
-              "disableCache": {
-                "type": "boolean",
-                "description": ""
-              }
-            }
+      "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": [
-          "text",
-          "outputPath"
+          "messages"
         ],
         "returns": "Promise<string>",
         "examples": [
           {
             "language": "ts",
-            "code": "const path = await el.say('Hello world', './hello.mp3')\nconsole.log(`Audio saved to ${path}`)"
+            "code": "const reply = await openai.chat([\n { role: 'system', content: 'You are a pirate.' },\n { role: 'user', content: 'Hello!' }\n])"
           }
         ]
       }
     },
     "getters": {
-      "apiKey": {
-        "description": "The resolved API key from options or environment.",
+      "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"
       }
     },
     "events": {
+      "connected": {
+        "name": "connected",
+        "description": "Event emitted by OpenAIClient",
+        "arguments": {}
+      },
       "failure": {
         "name": "failure",
-        "description": "Event emitted by ElevenLabsClient",
+        "description": "Event emitted by OpenAIClient",
         "arguments": {}
       },
-      "voices": {
-        "name": "voices",
-        "description": "Event emitted by ElevenLabsClient",
+      "completion": {
+        "name": "completion",
+        "description": "Event emitted by OpenAIClient",
         "arguments": {}
       },
-      "speech": {
-        "name": "speech",
-        "description": "Event emitted by ElevenLabsClient",
+      "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": {}
       }
     },
@@ -29569,71 +29173,204 @@ export const introspectionData = [
     "examples": [
       {
         "language": "ts",
-        "code": "const el = container.client('elevenlabs')\nawait el.connect()\nconst voices = await el.listVoices()\nconst audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data"
+        "code": "const openai = container.client('openai', { defaultModel: 'gpt-4o' })\nconst answer = await openai.ask('What is the meaning of life?')\nconsole.log(answer)"
       }
-    ],
-    "types": {
-      "SynthesizeOptions": {
-        "description": "",
-        "properties": {
-          "voiceId": {
+    ]
+  },
+  {
+    "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": "",
-            "optional": true
-          },
-          "modelId": {
+            "description": "The table or view name to query"
+          }
+        },
+        "required": [
+          "table"
+        ],
+        "returns": "void"
+      },
+      "rpc": {
+        "description": "Call a Postgres function (RPC).",
+        "parameters": {
+          "fn": {
             "type": "string",
-            "description": "",
-            "optional": true
+            "description": "The function name"
           },
-          "outputFormat": {
+          "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": "",
-            "optional": true
+            "description": "Parameter email"
           },
-          "voiceSettings": {
-            "type": "ElevenLabsVoiceSettings",
-            "description": "",
-            "optional": true
+          "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"
           },
-          "disableCache": {
-            "type": "boolean",
-            "description": "",
-            "optional": true
+          "password": {
+            "type": "string",
+            "description": "Parameter password"
           }
-        }
+        },
+        "required": [
+          "email",
+          "password"
+        ],
+        "returns": "void"
       },
-      "ElevenLabsVoiceSettings": {
-        "description": "",
-        "properties": {
-          "stability": {
-            "type": "number",
-            "description": "",
-            "optional": true
+      "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"
           },
-          "similarityBoost": {
-            "type": "number",
-            "description": "",
-            "optional": true
+          "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"
           },
-          "style": {
-            "type": "number",
-            "description": "",
-            "optional": true
+          "table": {
+            "type": "string",
+            "description": "The table to listen to"
           },
-          "speed": {
-            "type": "number",
-            "description": "",
-            "optional": true
+          "callback": {
+            "type": "(payload: any) => void",
+            "description": "Called with the payload on each change"
           },
-          "useSpeakerBoost": {
-            "type": "boolean",
-            "description": "",
-            "optional": true
+          "event": {
+            "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
+            "description": "The event type to listen for (default: all changes)"
           }
-        }
+        },
+        "required": [
+          "channelName",
+          "table",
+          "callback"
+        ],
+        "returns": "RealtimeChannel"
+      },
+      "unsubscribe": {
+        "description": "Unsubscribe and remove a realtime channel by name.",
+        "parameters": {
+          "channelName": {
+            "type": "string",
+            "description": "The channel name to remove"
+          }
+        },
+        "required": [
+          "channelName"
+        ],
+        "returns": "void"
+      },
+      "unsubscribeAll": {
+        "description": "Unsubscribe and remove all realtime channels.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "connect": {
+        "description": "Connect is a no-op since the Supabase SDK initializes on construction. The client is ready to use immediately after creation.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "disconnect": {
+        "description": "Disconnect by signing out and removing all realtime channels.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
       }
-    }
+    },
+    "getters": {
+      "sdk": {
+        "description": "Returns the raw Supabase SDK client for full access to all SDK methods.",
+        "returns": "SupabaseSDKClient<any, any>"
+      },
+      "storage": {
+        "description": "Returns the Supabase Storage client for managing buckets and files.",
+        "returns": "any"
+      },
+      "functions": {
+        "description": "Returns the Supabase Functions client.",
+        "returns": "any"
+      }
+    },
+    "events": {},
+    "state": {},
+    "options": {},
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const supabase = container.client('supabase', {\n supabaseUrl: 'https://xyz.supabase.co',\n supabaseKey: 'your-anon-key',\n})\n\n// Query data\nconst { data } = await supabase.from('users').select('*')\n\n// Auth\nawait supabase.signInWithPassword('user@example.com', 'password')\n\n// Realtime\nsupabase.subscribe('changes', 'users', (payload) => {\n console.log('Change:', payload)\n})"
+      }
+    ]
   },
   {
     "id": "clients.comfyui",
@@ -29746,133 +29483,379 @@ export const introspectionData = [
       "viewImage": {
         "description": "Download a generated image from ComfyUI as a Buffer.",
         "parameters": {
-          "filename": {
+          "filename": {
+            "type": "string",
+            "description": "The image filename"
+          },
+          "subfolder": {
+            "type": "any",
+            "description": "Subfolder within the output directory"
+          },
+          "type": {
+            "type": "any",
+            "description": "Image type ('output', 'input', 'temp')"
+          }
+        },
+        "required": [
+          "filename"
+        ],
+        "returns": "Promise<Buffer>"
+      },
+      "connectWs": {
+        "description": "Open a WebSocket connection to ComfyUI for real-time execution tracking. Events emitted: `execution_start`, `executing`, `progress`, `executed`, `execution_cached`, `execution_error`, `execution_complete`.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<void>"
+      },
+      "disconnectWs": {
+        "description": "Close the WebSocket connection.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "toApiFormat": {
+        "description": "Convert a UI-format workflow to the API format that /prompt expects. Requires a running ComfyUI instance to fetch `object_info` so we can map positional `widgets_values` to their named input fields. If the workflow is already in API format, it's returned as-is.",
+        "parameters": {
+          "workflow": {
+            "type": "Record<string, any>",
+            "description": "Parameter workflow"
+          }
+        },
+        "required": [
+          "workflow"
+        ],
+        "returns": "Promise<Record<string, any>>"
+      },
+      "runWorkflow": {
+        "description": "Run a ComfyUI workflow with optional runtime input overrides. Inputs can be provided in two forms: **Direct node mapping** (when no `inputMap` in options): ``` { '3': { seed: 42 }, '6': { text: 'a cat' } } ``` **Named inputs** (when `inputMap` is provided in options): ``` inputs: { positive_prompt: 'a cat', seed: 42 } options.inputMap: { positive_prompt: { nodeId: '6', field: 'text' }, seed: { nodeId: '3', field: 'seed' } } ```",
+        "parameters": {
+          "workflow": {
+            "type": "Record<string, any>",
+            "description": "Parameter workflow"
+          },
+          "inputs": {
+            "type": "Record<string, any>",
+            "description": "Parameter inputs"
+          },
+          "options": {
+            "type": "WorkflowRunOptions",
+            "description": "Parameter options",
+            "properties": {
+              "poll": {
+                "type": "boolean",
+                "description": "Use polling instead of WebSocket for tracking execution"
+              },
+              "pollInterval": {
+                "type": "number",
+                "description": "Polling interval in ms (default 1000)"
+              },
+              "inputMap": {
+                "type": "InputMapping",
+                "description": "Named input mapping: semantic name -> { nodeId, field }"
+              },
+              "outputDir": {
+                "type": "string",
+                "description": "If provided, output images are downloaded to this directory"
+              }
+            }
+          }
+        },
+        "required": [
+          "workflow"
+        ],
+        "returns": "Promise<WorkflowResult>"
+      }
+    },
+    "getters": {
+      "clientId": {
+        "description": "The unique client ID used for WebSocket session tracking.",
+        "returns": "string"
+      },
+      "wsURL": {
+        "description": "The WebSocket URL derived from baseURL or overridden via options.",
+        "returns": "string"
+      }
+    },
+    "events": {
+      "execution_start": {
+        "name": "execution_start",
+        "description": "Event emitted by ComfyUIClient",
+        "arguments": {}
+      },
+      "execution_complete": {
+        "name": "execution_complete",
+        "description": "Event emitted by ComfyUIClient",
+        "arguments": {}
+      },
+      "executing": {
+        "name": "executing",
+        "description": "Event emitted by ComfyUIClient",
+        "arguments": {}
+      },
+      "progress": {
+        "name": "progress",
+        "description": "Event emitted by ComfyUIClient",
+        "arguments": {}
+      },
+      "executed": {
+        "name": "executed",
+        "description": "Event emitted by ComfyUIClient",
+        "arguments": {}
+      },
+      "execution_cached": {
+        "name": "execution_cached",
+        "description": "Event emitted by ComfyUIClient",
+        "arguments": {}
+      },
+      "execution_error": {
+        "name": "execution_error",
+        "description": "Event emitted by ComfyUIClient",
+        "arguments": {}
+      }
+    },
+    "state": {},
+    "options": {},
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const comfy = container.client('comfyui', { baseURL: 'http://localhost:8188' })\nconst result = await comfy.runWorkflow(workflow, {\n '6': { text: 'a beautiful sunset' }\n})\nconsole.log(result.images)"
+      }
+    ],
+    "types": {
+      "WorkflowRunOptions": {
+        "description": "",
+        "properties": {
+          "poll": {
+            "type": "boolean",
+            "description": "Use polling instead of WebSocket for tracking execution",
+            "optional": true
+          },
+          "pollInterval": {
+            "type": "number",
+            "description": "Polling interval in ms (default 1000)",
+            "optional": true
+          },
+          "inputMap": {
+            "type": "InputMapping",
+            "description": "Named input mapping: semantic name -> { nodeId, field }",
+            "optional": true
+          },
+          "outputDir": {
+            "type": "string",
+            "description": "If provided, output images are downloaded to this directory",
+            "optional": true
+          }
+        }
+      },
+      "WorkflowResult": {
+        "description": "",
+        "properties": {
+          "promptId": {
+            "type": "string",
+            "description": ""
+          },
+          "outputs": {
+            "type": "Record<string, any>",
+            "description": ""
+          },
+          "images": {
+            "type": "Array<{ filename: string; subfolder: string; type: string; localPath?: string }>",
+            "description": "",
+            "optional": true
+          }
+        }
+      }
+    }
+  },
+  {
+    "id": "clients.elevenlabs",
+    "description": "ElevenLabs client — text-to-speech synthesis via the ElevenLabs REST API. Provides methods for listing voices, listing models, and generating speech audio. Audio is returned as a Buffer; use `say()` for a convenience method that writes to disk.",
+    "shortcut": "clients.elevenlabs",
+    "className": "ElevenLabsClient",
+    "methods": {
+      "beforeRequest": {
+        "description": "Inject the xi-api-key header before each request.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "connect": {
+        "description": "Validate the API key by listing available models.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<this>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "await el.connect()"
+          }
+        ]
+      },
+      "listVoices": {
+        "description": "List available voices with optional search and filtering.",
+        "parameters": {
+          "options": {
+            "type": "{\n    search?: string\n    category?: string\n    voice_type?: string\n    page_size?: number\n    next_page_token?: string\n  }",
+            "description": "Query parameters for filtering voices"
+          }
+        },
+        "required": [],
+        "returns": "Promise<any>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const voices = await el.listVoices()\nconst premade = await el.listVoices({ category: 'premade' })"
+          }
+        ]
+      },
+      "getVoice": {
+        "description": "Get details for a single voice.",
+        "parameters": {
+          "voiceId": {
             "type": "string",
-            "description": "The image filename"
-          },
-          "subfolder": {
-            "type": "any",
-            "description": "Subfolder within the output directory"
-          },
-          "type": {
-            "type": "any",
-            "description": "Image type ('output', 'input', 'temp')"
+            "description": "The voice ID to look up"
           }
         },
         "required": [
-          "filename"
+          "voiceId"
         ],
-        "returns": "Promise<Buffer>"
-      },
-      "connectWs": {
-        "description": "Open a WebSocket connection to ComfyUI for real-time execution tracking. Events emitted: `execution_start`, `executing`, `progress`, `executed`, `execution_cached`, `execution_error`, `execution_complete`.",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<void>"
+        "returns": "Promise<any>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const voice = await el.getVoice('21m00Tcm4TlvDq8ikWAM')\nconsole.log(voice.name, voice.settings)"
+          }
+        ]
       },
-      "disconnectWs": {
-        "description": "Close the WebSocket connection.",
+      "listModels": {
+        "description": "List available TTS models.",
         "parameters": {},
         "required": [],
-        "returns": "void"
+        "returns": "Promise<any[]>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const models = await el.listModels()\nconsole.log(models.map(m => m.model_id))"
+          }
+        ]
       },
-      "toApiFormat": {
-        "description": "Convert a UI-format workflow to the API format that /prompt expects. Requires a running ComfyUI instance to fetch `object_info` so we can map positional `widgets_values` to their named input fields. If the workflow is already in API format, it's returned as-is.",
+      "synthesize": {
+        "description": "Synthesize speech from text, returning audio as a Buffer.",
         "parameters": {
-          "workflow": {
-            "type": "Record<string, any>",
-            "description": "Parameter workflow"
+          "text": {
+            "type": "string",
+            "description": "The text to convert to speech"
+          },
+          "options": {
+            "type": "SynthesizeOptions",
+            "description": "Voice, model, format, and voice settings overrides",
+            "properties": {
+              "voiceId": {
+                "type": "string",
+                "description": ""
+              },
+              "modelId": {
+                "type": "string",
+                "description": ""
+              },
+              "outputFormat": {
+                "type": "string",
+                "description": ""
+              },
+              "voiceSettings": {
+                "type": "ElevenLabsVoiceSettings",
+                "description": ""
+              },
+              "disableCache": {
+                "type": "boolean",
+                "description": ""
+              }
+            }
           }
         },
         "required": [
-          "workflow"
+          "text"
         ],
-        "returns": "Promise<Record<string, any>>"
+        "returns": "Promise<Buffer>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data\n\nconst custom = await el.synthesize('Hello', {\n voiceId: '21m00Tcm4TlvDq8ikWAM',\n voiceSettings: { stability: 0.5, similarityBoost: 0.8 }\n})"
+          }
+        ]
       },
-      "runWorkflow": {
-        "description": "Run a ComfyUI workflow with optional runtime input overrides. Inputs can be provided in two forms: **Direct node mapping** (when no `inputMap` in options): ``` { '3': { seed: 42 }, '6': { text: 'a cat' } } ``` **Named inputs** (when `inputMap` is provided in options): ``` inputs: { positive_prompt: 'a cat', seed: 42 } options.inputMap: { positive_prompt: { nodeId: '6', field: 'text' }, seed: { nodeId: '3', field: 'seed' } } ```",
+      "say": {
+        "description": "Synthesize speech and write the audio to a file.",
         "parameters": {
-          "workflow": {
-            "type": "Record<string, any>",
-            "description": "Parameter workflow"
+          "text": {
+            "type": "string",
+            "description": "The text to convert to speech"
           },
-          "inputs": {
-            "type": "Record<string, any>",
-            "description": "Parameter inputs"
+          "outputPath": {
+            "type": "string",
+            "description": "File path to write the audio to"
           },
           "options": {
-            "type": "WorkflowRunOptions",
-            "description": "Parameter options",
+            "type": "SynthesizeOptions",
+            "description": "Voice, model, format, and voice settings overrides",
             "properties": {
-              "poll": {
-                "type": "boolean",
-                "description": "Use polling instead of WebSocket for tracking execution"
-              },
-              "pollInterval": {
-                "type": "number",
-                "description": "Polling interval in ms (default 1000)"
+              "voiceId": {
+                "type": "string",
+                "description": ""
               },
-              "inputMap": {
-                "type": "InputMapping",
-                "description": "Named input mapping: semantic name -> { nodeId, field }"
+              "modelId": {
+                "type": "string",
+                "description": ""
               },
-              "outputDir": {
+              "outputFormat": {
                 "type": "string",
-                "description": "If provided, output images are downloaded to this directory"
+                "description": ""
+              },
+              "voiceSettings": {
+                "type": "ElevenLabsVoiceSettings",
+                "description": ""
+              },
+              "disableCache": {
+                "type": "boolean",
+                "description": ""
               }
             }
           }
         },
         "required": [
-          "workflow"
+          "text",
+          "outputPath"
         ],
-        "returns": "Promise<WorkflowResult>"
+        "returns": "Promise<string>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const path = await el.say('Hello world', './hello.mp3')\nconsole.log(`Audio saved to ${path}`)"
+          }
+        ]
       }
     },
     "getters": {
-      "clientId": {
-        "description": "The unique client ID used for WebSocket session tracking.",
-        "returns": "string"
-      },
-      "wsURL": {
-        "description": "The WebSocket URL derived from baseURL or overridden via options.",
+      "apiKey": {
+        "description": "The resolved API key from options or environment.",
         "returns": "string"
       }
     },
     "events": {
-      "execution_start": {
-        "name": "execution_start",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
-      },
-      "execution_complete": {
-        "name": "execution_complete",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
-      },
-      "executing": {
-        "name": "executing",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
-      },
-      "progress": {
-        "name": "progress",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
-      },
-      "executed": {
-        "name": "executed",
-        "description": "Event emitted by ComfyUIClient",
+      "failure": {
+        "name": "failure",
+        "description": "Event emitted by ElevenLabsClient",
         "arguments": {}
       },
-      "execution_cached": {
-        "name": "execution_cached",
-        "description": "Event emitted by ComfyUIClient",
+      "voices": {
+        "name": "voices",
+        "description": "Event emitted by ElevenLabsClient",
         "arguments": {}
       },
-      "execution_error": {
-        "name": "execution_error",
-        "description": "Event emitted by ComfyUIClient",
+      "speech": {
+        "name": "speech",
+        "description": "Event emitted by ElevenLabsClient",
         "arguments": {}
       }
     },
@@ -29882,48 +29865,65 @@ export const introspectionData = [
     "examples": [
       {
         "language": "ts",
-        "code": "const comfy = container.client('comfyui', { baseURL: 'http://localhost:8188' })\nconst result = await comfy.runWorkflow(workflow, {\n '6': { text: 'a beautiful sunset' }\n})\nconsole.log(result.images)"
+        "code": "const el = container.client('elevenlabs')\nawait el.connect()\nconst voices = await el.listVoices()\nconst audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data"
       }
     ],
     "types": {
-      "WorkflowRunOptions": {
+      "SynthesizeOptions": {
         "description": "",
         "properties": {
-          "poll": {
-            "type": "boolean",
-            "description": "Use polling instead of WebSocket for tracking execution",
+          "voiceId": {
+            "type": "string",
+            "description": "",
             "optional": true
           },
-          "pollInterval": {
-            "type": "number",
-            "description": "Polling interval in ms (default 1000)",
+          "modelId": {
+            "type": "string",
+            "description": "",
             "optional": true
           },
-          "inputMap": {
-            "type": "InputMapping",
-            "description": "Named input mapping: semantic name -> { nodeId, field }",
+          "outputFormat": {
+            "type": "string",
+            "description": "",
             "optional": true
           },
-          "outputDir": {
-            "type": "string",
-            "description": "If provided, output images are downloaded to this directory",
+          "voiceSettings": {
+            "type": "ElevenLabsVoiceSettings",
+            "description": "",
+            "optional": true
+          },
+          "disableCache": {
+            "type": "boolean",
+            "description": "",
             "optional": true
           }
         }
       },
-      "WorkflowResult": {
+      "ElevenLabsVoiceSettings": {
         "description": "",
         "properties": {
-          "promptId": {
-            "type": "string",
-            "description": ""
+          "stability": {
+            "type": "number",
+            "description": "",
+            "optional": true
           },
-          "outputs": {
-            "type": "Record<string, any>",
-            "description": ""
+          "similarityBoost": {
+            "type": "number",
+            "description": "",
+            "optional": true
           },
-          "images": {
-            "type": "Array<{ filename: string; subfolder: string; type: string; localPath?: string }>",
+          "style": {
+            "type": "number",
+            "description": "",
+            "optional": true
+          },
+          "speed": {
+            "type": "number",
+            "description": "",
+            "optional": true
+          },
+          "useSpeakerBoost": {
+            "type": "boolean",
             "description": "",
             "optional": true
           }