@soederpop/luca 0.0.19 → 0.0.20

package/src/introspection/generated.node.ts

@@ -1,7 +1,7 @@
 import { setBuildTimeData, setContainerBuildTimeData } from './index.js';
 
 // Auto-generated introspection registry data
-// Generated at: 2026-03-20T21:12:58.846Z
+// Generated at: 2026-03-21T01:13:42.175Z
 
 setBuildTimeData('features.googleDocs', {
   "id": "features.googleDocs",
@@ -9519,202 +9519,6 @@ setBuildTimeData('clients.websocket', {
   ]
 });
 
-setBuildTimeData('clients.supabase', {
-  "id": "clients.supabase",
-  "description": "Supabase client for the Luca container system. Wraps the official `@supabase/supabase-js` SDK and exposes it through Luca's typed state, events, and introspection system. The SDK is isomorphic so this single implementation works in both Node and browser containers. Use `client.sdk` for full SDK access, or use the convenience wrappers for common operations (auth, database queries, storage, edge functions, realtime).",
-  "shortcut": "clients.supabase",
-  "className": "SupabaseClient",
-  "methods": {
-    "from": {
-      "description": "Start a query on a Postgres table or view.",
-      "parameters": {
-        "table": {
-          "type": "string",
-          "description": "The table or view name to query"
-        }
-      },
-      "required": [
-        "table"
-      ],
-      "returns": "void"
-    },
-    "rpc": {
-      "description": "Call a Postgres function (RPC).",
-      "parameters": {
-        "fn": {
-          "type": "string",
-          "description": "The function name"
-        },
-        "params": {
-          "type": "Record<string, unknown>",
-          "description": "Arguments to pass to the function"
-        },
-        "options": {
-          "type": "{ head?: boolean; get?: boolean; count?: \"exact\" | \"planned\" | \"estimated\" }",
-          "description": "Optional settings (head, get, count)"
-        }
-      },
-      "required": [
-        "fn"
-      ],
-      "returns": "void"
-    },
-    "signInWithPassword": {
-      "description": "Sign in with email and password.",
-      "parameters": {
-        "email": {
-          "type": "string",
-          "description": "Parameter email"
-        },
-        "password": {
-          "type": "string",
-          "description": "Parameter password"
-        }
-      },
-      "required": [
-        "email",
-        "password"
-      ],
-      "returns": "void"
-    },
-    "signUp": {
-      "description": "Create a new user account with email and password.",
-      "parameters": {
-        "email": {
-          "type": "string",
-          "description": "Parameter email"
-        },
-        "password": {
-          "type": "string",
-          "description": "Parameter password"
-        }
-      },
-      "required": [
-        "email",
-        "password"
-      ],
-      "returns": "void"
-    },
-    "signOut": {
-      "description": "Sign the current user out.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "getSession": {
-      "description": "Get the current session, if any.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "getUser": {
-      "description": "Get the current user, if any.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "invoke": {
-      "description": "Invoke a Supabase Edge Function by name.",
-      "parameters": {
-        "name": {
-          "type": "string",
-          "description": "Parameter name"
-        },
-        "body": {
-          "type": "any",
-          "description": "Parameter body"
-        }
-      },
-      "required": [
-        "name"
-      ],
-      "returns": "void"
-    },
-    "subscribe": {
-      "description": "Subscribe to realtime changes on a Postgres table.",
-      "parameters": {
-        "channelName": {
-          "type": "string",
-          "description": "A name for this subscription channel"
-        },
-        "table": {
-          "type": "string",
-          "description": "The table to listen to"
-        },
-        "callback": {
-          "type": "(payload: any) => void",
-          "description": "Called with the payload on each change"
-        },
-        "event": {
-          "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
-          "description": "The event type to listen for (default: all changes)"
-        }
-      },
-      "required": [
-        "channelName",
-        "table",
-        "callback"
-      ],
-      "returns": "RealtimeChannel"
-    },
-    "unsubscribe": {
-      "description": "Unsubscribe and remove a realtime channel by name.",
-      "parameters": {
-        "channelName": {
-          "type": "string",
-          "description": "The channel name to remove"
-        }
-      },
-      "required": [
-        "channelName"
-      ],
-      "returns": "void"
-    },
-    "unsubscribeAll": {
-      "description": "Unsubscribe and remove all realtime channels.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "connect": {
-      "description": "Connect is a no-op since the Supabase SDK initializes on construction. The client is ready to use immediately after creation.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "disconnect": {
-      "description": "Disconnect by signing out and removing all realtime channels.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    }
-  },
-  "getters": {
-    "sdk": {
-      "description": "Returns the raw Supabase SDK client for full access to all SDK methods.",
-      "returns": "SupabaseSDKClient<any, any>"
-    },
-    "storage": {
-      "description": "Returns the Supabase Storage client for managing buckets and files.",
-      "returns": "any"
-    },
-    "functions": {
-      "description": "Returns the Supabase Functions client.",
-      "returns": "any"
-    }
-  },
-  "events": {},
-  "state": {},
-  "options": {},
-  "envVars": [],
-  "examples": [
-    {
-      "language": "ts",
-      "code": "const supabase = container.client('supabase', {\n supabaseUrl: 'https://xyz.supabase.co',\n supabaseKey: 'your-anon-key',\n})\n\n// Query data\nconst { data } = await supabase.from('users').select('*')\n\n// Auth\nawait supabase.signInWithPassword('user@example.com', 'password')\n\n// Realtime\nsupabase.subscribe('changes', 'users', (payload) => {\n console.log('Change:', payload)\n})"
-    }
-  ]
-});
-
 setBuildTimeData('clients.openai', {
   "id": "clients.openai",
   "description": "OpenAI client — wraps the OpenAI SDK for chat completions, responses API, embeddings, and image generation. Provides convenience methods for common operations while tracking token usage and request counts. Supports both the Chat Completions API and the newer Responses API.",
@@ -9983,245 +9787,43 @@ setBuildTimeData('clients.openai', {
   ]
 });
 
-setBuildTimeData('clients.elevenlabs', {
-  "id": "clients.elevenlabs",
-  "description": "ElevenLabs client — text-to-speech synthesis via the ElevenLabs REST API. Provides methods for listing voices, listing models, and generating speech audio. Audio is returned as a Buffer; use `say()` for a convenience method that writes to disk.",
-  "shortcut": "clients.elevenlabs",
-  "className": "ElevenLabsClient",
+setBuildTimeData('clients.comfyui', {
+  "id": "clients.comfyui",
+  "description": "ComfyUI client — execute Stable Diffusion workflows via the ComfyUI API. Connects to a ComfyUI instance to queue prompts, track execution via WebSocket or polling, and download generated images. Supports both UI-format and API-format workflows with automatic conversion.",
+  "shortcut": "clients.comfyui",
+  "className": "ComfyUIClient",
   "methods": {
-    "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.",
+    "queuePrompt": {
+      "description": "Queue a prompt (API-format workflow) for execution.",
       "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"
+        "prompt": {
+          "type": "Record<string, any>",
+          "description": "The API-format workflow object"
+        },
+        "clientId": {
+          "type": "string",
+          "description": "Override the client ID for this request"
         }
       },
-      "required": [],
-      "returns": "Promise<any>",
+      "required": [
+        "prompt"
+      ],
+      "returns": "Promise<{ prompt_id: string; number: number }>",
       "examples": [
         {
           "language": "ts",
-          "code": "const voices = await el.listVoices()\nconst premade = await el.listVoices({ category: 'premade' })"
+          "code": "const { prompt_id } = await comfy.queuePrompt(apiWorkflow)"
         }
       ]
     },
-    "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"
-    }
-  ]
-});
-
-setBuildTimeData('clients.comfyui', {
-  "id": "clients.comfyui",
-  "description": "ComfyUI client — execute Stable Diffusion workflows via the ComfyUI API. Connects to a ComfyUI instance to queue prompts, track execution via WebSocket or polling, and download generated images. Supports both UI-format and API-format workflows with automatic conversion.",
-  "shortcut": "clients.comfyui",
-  "className": "ComfyUIClient",
-  "methods": {
-    "queuePrompt": {
-      "description": "Queue a prompt (API-format workflow) for execution.",
-      "parameters": {
-        "prompt": {
-          "type": "Record<string, any>",
-          "description": "The API-format workflow object"
-        },
-        "clientId": {
-          "type": "string",
-          "description": "Override the client ID for this request"
-        }
-      },
-      "required": [
-        "prompt"
-      ],
-      "returns": "Promise<{ prompt_id: string; number: number }>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const { prompt_id } = await comfy.queuePrompt(apiWorkflow)"
-        }
-      ]
-    },
-    "getQueue": {
-      "description": "Get the current prompt queue status.",
-      "parameters": {},
-      "required": [],
-      "returns": "Promise<{ queue_running: any[]; queue_pending: any[] }>"
-    },
-    "getHistory": {
-      "description": "Get execution history, optionally for a specific prompt.",
+    "getQueue": {
+      "description": "Get the current prompt queue status.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<{ queue_running: any[]; queue_pending: any[] }>"
+    },
+    "getHistory": {
+      "description": "Get execution history, optionally for a specific prompt.",
       "parameters": {
         "promptId": {
           "type": "string",
@@ -10437,157 +10039,194 @@ setBuildTimeData('clients.comfyui', {
   ]
 });
 
-setBuildTimeData('servers.mcp', {
-  "id": "servers.mcp",
-  "description": "MCP (Model Context Protocol) server for exposing tools, resources, and prompts to AI clients like Claude Code. Uses the low-level MCP SDK Server class directly with Zod 4 native JSON Schema conversion. Register tools, resources, and prompts programmatically, then start the server over stdio (for CLI integration) or HTTP (for remote access).",
-  "shortcut": "servers.mcp",
-  "className": "MCPServer",
+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": {
-    "tool": {
-      "description": "Register an MCP tool. The tool's Zod schema is converted to JSON Schema for the protocol listing, and used for runtime argument validation. Tool handlers can return a string (auto-wrapped as text content) or a full CallToolResult object for advanced responses (images, errors, etc).",
+    "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": {
-        "name": {
-          "type": "string",
-          "description": "Unique tool name"
-        },
         "options": {
-          "type": "ToolRegistrationOptions",
-          "description": "Tool schema, description, and handler",
-          "properties": {
-            "schema": {
-              "type": "z.ZodObject<any>",
-              "description": ""
-            },
-            "description": {
-              "type": "string",
-              "description": ""
-            },
-            "handler": {
-              "type": "(args: any, ctx: MCPContext) => any",
-              "description": ""
-            }
-          }
+          "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": [
-        "name",
-        "options"
-      ],
-      "returns": "this"
-    },
-    "resource": {
-      "description": "Register an MCP resource. Resources expose data (files, configs, etc) that AI clients can read by URI. Accepts either a handler function directly or an options object with additional metadata (name, description, mimeType).",
+      "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": {
-        "uri": {
+        "voiceId": {
           "type": "string",
-          "description": "Unique resource URI (e.g. \"project://readme\")"
-        },
-        "handlerOrOptions": {
-          "type": "ResourceRegistrationOptions['handler'] | ResourceRegistrationOptions",
-          "description": "Handler function or options object with handler"
+          "description": "The voice ID to look up"
         }
       },
       "required": [
-        "uri",
-        "handlerOrOptions"
+        "voiceId"
       ],
-      "returns": "this"
+      "returns": "Promise<any>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const voice = await el.getVoice('21m00Tcm4TlvDq8ikWAM')\nconsole.log(voice.name, voice.settings)"
+        }
+      ]
     },
-    "prompt": {
-      "description": "Register an MCP prompt. Prompts are reusable message templates that AI clients can invoke with optional string arguments.",
+    "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": {
-        "name": {
+        "text": {
           "type": "string",
-          "description": "Unique prompt name"
+          "description": "The text to convert to speech"
         },
         "options": {
-          "type": "PromptRegistrationOptions",
-          "description": "Prompt handler, optional args schema, and description",
+          "type": "SynthesizeOptions",
+          "description": "Voice, model, format, and voice settings overrides",
           "properties": {
-            "description": {
+            "voiceId": {
               "type": "string",
               "description": ""
             },
-            "args": {
-              "type": "Record<string, z.ZodType>",
+            "modelId": {
+              "type": "string",
               "description": ""
             },
-            "handler": {
-              "type": "(args: Record<string, string | undefined>, ctx: MCPContext) => Promise<PromptMessage[]> | PromptMessage[]",
+            "outputFormat": {
+              "type": "string",
+              "description": ""
+            },
+            "voiceSettings": {
+              "type": "ElevenLabsVoiceSettings",
+              "description": ""
+            },
+            "disableCache": {
+              "type": "boolean",
               "description": ""
             }
           }
         }
       },
       "required": [
-        "name",
-        "options"
+        "text"
       ],
-      "returns": "this"
-    },
-    "configure": {
-      "description": "Configure the MCP protocol server and register all protocol handlers. Called automatically before start() if not already configured.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
+      "returns": "Promise<Buffer>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const audio = await el.synthesize('Hello world')\n// audio is a Buffer of mp3 data\n\nconst custom = await el.synthesize('Hello', {\n voiceId: '21m00Tcm4TlvDq8ikWAM',\n voiceSettings: { stability: 0.5, similarityBoost: 0.8 }\n})"
+        }
+      ]
     },
-    "start": {
-      "description": "Start the MCP server with the specified transport.",
+    "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": "{\n    transport?: 'stdio' | 'http'\n    port?: number\n    host?: string\n    mcpCompat?: MCPCompatMode\n    stdioCompat?: StdioCompatMode\n  }",
-          "description": "Transport configuration. Defaults to stdio.",
+          "type": "SynthesizeOptions",
+          "description": "Voice, model, format, and voice settings overrides",
           "properties": {
-            "transport": {
-              "type": "any",
-              "description": "'stdio' for CLI integration, 'http' for remote access"
+            "voiceId": {
+              "type": "string",
+              "description": ""
             },
-            "port": {
-              "type": "any",
-              "description": "Port for HTTP transport (default 3001)"
+            "modelId": {
+              "type": "string",
+              "description": ""
+            },
+            "outputFormat": {
+              "type": "string",
+              "description": ""
+            },
+            "voiceSettings": {
+              "type": "ElevenLabsVoiceSettings",
+              "description": ""
+            },
+            "disableCache": {
+              "type": "boolean",
+              "description": ""
             }
           }
         }
       },
-      "required": [],
-      "returns": "void"
-    },
-    "stop": {
-      "description": "Stop the MCP server and close all connections.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
+      "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": {
-    "mcpServer": {
-      "description": "The underlying MCP protocol server instance. Created during configure().",
-      "returns": "MCPProtocolServer"
-    },
-    "handlerContext": {
-      "description": "The handler context passed to all tool, resource, and prompt handlers.",
-      "returns": "MCPContext"
+    "apiKey": {
+      "description": "The resolved API key from options or environment.",
+      "returns": "string"
     }
   },
   "events": {
-    "toolRegistered": {
-      "name": "toolRegistered",
-      "description": "Event emitted by MCPServer",
-      "arguments": {}
-    },
-    "resourceRegistered": {
-      "name": "resourceRegistered",
-      "description": "Event emitted by MCPServer",
+    "failure": {
+      "name": "failure",
+      "description": "Event emitted by ElevenLabsClient",
       "arguments": {}
     },
-    "promptRegistered": {
-      "name": "promptRegistered",
-      "description": "Event emitted by MCPServer",
+    "voices": {
+      "name": "voices",
+      "description": "Event emitted by ElevenLabsClient",
       "arguments": {}
     },
-    "toolCalled": {
-      "name": "toolCalled",
-      "description": "Event emitted by MCPServer",
+    "speech": {
+      "name": "speech",
+      "description": "Event emitted by ElevenLabsClient",
       "arguments": {}
     }
   },
@@ -10597,265 +10236,626 @@ setBuildTimeData('servers.mcp', {
   "examples": [
     {
       "language": "ts",
-      "code": "const mcp = container.server('mcp', { serverName: 'my-server', serverVersion: '1.0.0' })\n\nmcp.tool('search_files', {\n schema: z.object({ pattern: z.string() }),\n description: 'Search for files',\n handler: async (args, ctx) => {\n   return ctx.container.feature('fs').walk('.', { include: [args.pattern] }).files.join('\\n')\n }\n})\n\nawait mcp.start()"
+      "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"
     }
   ]
 });
 
-setBuildTimeData('servers.express', {
-  "id": "servers.express",
-  "description": "Express.js HTTP server with automatic endpoint mounting, CORS, and SPA history fallback. Wraps an Express application with convention-based endpoint discovery. Endpoints defined as modules are automatically mounted as routes. Supports static file serving, CORS configuration, and single-page app history fallback out of the box.",
-  "shortcut": "servers.express",
-  "className": "ExpressServer",
+setBuildTimeData('clients.supabase', {
+  "id": "clients.supabase",
+  "description": "Supabase client for the Luca container system. Wraps the official `@supabase/supabase-js` SDK and exposes it through Luca's typed state, events, and introspection system. The SDK is isomorphic so this single implementation works in both Node and browser containers. Use `client.sdk` for full SDK access, or use the convenience wrappers for common operations (auth, database queries, storage, edge functions, realtime).",
+  "shortcut": "clients.supabase",
+  "className": "SupabaseClient",
   "methods": {
-    "start": {
-      "description": "Start the Express HTTP server. A runtime `port` overrides the constructor option and is written to state so `server.port` always reflects reality.",
+    "from": {
+      "description": "Start a query on a Postgres table or view.",
       "parameters": {
-        "options": {
-          "type": "StartOptions",
-          "description": "Optional runtime overrides for port and host"
+        "table": {
+          "type": "string",
+          "description": "The table or view name to query"
         }
       },
-      "required": [],
-      "returns": "void"
-    },
-    "stop": {
-      "description": "",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "configure": {
-      "description": "",
-      "parameters": {},
-      "required": [],
+      "required": [
+        "table"
+      ],
       "returns": "void"
     },
-    "useEndpoint": {
-      "description": "",
+    "rpc": {
+      "description": "Call a Postgres function (RPC).",
       "parameters": {
-        "endpoint": {
-          "type": "Endpoint",
-          "description": "Parameter endpoint"
+        "fn": {
+          "type": "string",
+          "description": "The function name"
+        },
+        "params": {
+          "type": "Record<string, unknown>",
+          "description": "Arguments to pass to the function"
+        },
+        "options": {
+          "type": "{ head?: boolean; get?: boolean; count?: \"exact\" | \"planned\" | \"estimated\" }",
+          "description": "Optional settings (head, get, count)"
         }
       },
       "required": [
-        "endpoint"
+        "fn"
       ],
-      "returns": "this"
+      "returns": "void"
     },
-    "useEndpoints": {
-      "description": "",
+    "signInWithPassword": {
+      "description": "Sign in with email and password.",
       "parameters": {
-        "dir": {
+        "email": {
           "type": "string",
-          "description": "Parameter dir"
+          "description": "Parameter email"
+        },
+        "password": {
+          "type": "string",
+          "description": "Parameter password"
         }
       },
       "required": [
-        "dir"
+        "email",
+        "password"
       ],
-      "returns": "Promise<this>"
+      "returns": "void"
     },
-    "useEndpointModules": {
-      "description": "",
+    "signUp": {
+      "description": "Create a new user account with email and password.",
       "parameters": {
-        "modules": {
-          "type": "EndpointModule[]",
-          "description": "Parameter modules"
+        "email": {
+          "type": "string",
+          "description": "Parameter email"
+        },
+        "password": {
+          "type": "string",
+          "description": "Parameter password"
         }
       },
       "required": [
-        "modules"
+        "email",
+        "password"
       ],
-      "returns": "Promise<this>"
+      "returns": "void"
     },
-    "serveOpenAPISpec": {
-      "description": "",
-      "parameters": {
-        "options": {
-          "type": "{ title?: string; version?: string; description?: string }",
-          "description": "Parameter options"
-        }
-      },
+    "signOut": {
+      "description": "Sign the current user out.",
+      "parameters": {},
       "required": [],
-      "returns": "this"
+      "returns": "void"
     },
-    "generateOpenAPISpec": {
-      "description": "",
-      "parameters": {
-        "options": {
-          "type": "{ title?: string; version?: string; description?: string }",
-          "description": "Parameter options"
-        }
-      },
+    "getSession": {
+      "description": "Get the current session, if any.",
+      "parameters": {},
       "required": [],
-      "returns": "Record<string, any>"
-    }
-  },
-  "getters": {
-    "express": {
-      "description": "",
-      "returns": "any"
+      "returns": "void"
     },
-    "hooks": {
-      "description": "",
-      "returns": "any"
+    "getUser": {
+      "description": "Get the current user, if any.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
     },
-    "app": {
-      "description": "",
-      "returns": "any"
-    }
-  },
-  "events": {},
-  "state": {},
-  "options": {},
-  "envVars": [],
-  "examples": [
-    {
-      "language": "ts",
-      "code": "const server = container.server('express', { cors: true, static: './public' })\nawait server.start({ port: 3000 })\n\n// Mount endpoints programmatically\nserver.mount(myEndpoint)\n\n// Access the underlying Express app\nserver.app.get('/health', (req, res) => res.json({ ok: true }))"
-    }
-  ]
-});
-
-setBuildTimeData('servers.websocket', {
-  "id": "servers.websocket",
-  "description": "WebSocket server built on the `ws` library with optional JSON message framing. Manages WebSocket connections, tracks connected clients, and bridges messages to Luca's event bus. When `json` mode is enabled, incoming messages are automatically JSON-parsed (with `.toString()` for Buffer data) and outgoing messages via `send()` / `broadcast()` are JSON-stringified. When `json` mode is disabled, raw message data is emitted as-is and `send()` / `broadcast()` still JSON-stringify for safety.",
-  "shortcut": "servers.websocket",
-  "className": "WebsocketServer",
-  "methods": {
-    "broadcast": {
-      "description": "",
+    "invoke": {
+      "description": "Invoke a Supabase Edge Function by name.",
       "parameters": {
-        "message": {
+        "name": {
+          "type": "string",
+          "description": "Parameter name"
+        },
+        "body": {
           "type": "any",
-          "description": "Parameter message"
+          "description": "Parameter body"
         }
       },
       "required": [
-        "message"
+        "name"
       ],
       "returns": "void"
     },
-    "send": {
-      "description": "",
+    "subscribe": {
+      "description": "Subscribe to realtime changes on a Postgres table.",
       "parameters": {
-        "ws": {
-          "type": "any",
-          "description": "Parameter ws"
+        "channelName": {
+          "type": "string",
+          "description": "A name for this subscription channel"
         },
-        "message": {
-          "type": "any",
-          "description": "Parameter message"
+        "table": {
+          "type": "string",
+          "description": "The table to listen to"
+        },
+        "callback": {
+          "type": "(payload: any) => void",
+          "description": "Called with the payload on each change"
+        },
+        "event": {
+          "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
+          "description": "The event type to listen for (default: all changes)"
         }
       },
       "required": [
-        "ws",
-        "message"
+        "channelName",
+        "table",
+        "callback"
       ],
-      "returns": "void"
+      "returns": "RealtimeChannel"
     },
-    "start": {
-      "description": "Start the WebSocket server. A runtime `port` overrides the constructor option and is written to state before the underlying `ws.Server` is created, so the server binds to the correct port.",
+    "unsubscribe": {
+      "description": "Unsubscribe and remove a realtime channel by name.",
       "parameters": {
-        "options": {
-          "type": "StartOptions",
-          "description": "Optional runtime overrides for port and host"
+        "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"
     },
-    "stop": {
-      "description": "",
+    "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": {
-    "wss": {
-      "description": "",
-      "returns": "any"
+    "sdk": {
+      "description": "Returns the raw Supabase SDK client for full access to all SDK methods.",
+      "returns": "SupabaseSDKClient<any, any>"
     },
-    "port": {
-      "description": "The port this server will bind to. Defaults to 8081 if not set via constructor options or start().",
+    "storage": {
+      "description": "Returns the Supabase Storage client for managing buckets and files.",
       "returns": "any"
-    }
-  },
-  "events": {
-    "connection": {
-      "name": "connection",
-      "description": "Event emitted by WebsocketServer",
-      "arguments": {}
     },
-    "message": {
-      "name": "message",
-      "description": "Event emitted by WebsocketServer",
-      "arguments": {}
+    "functions": {
+      "description": "Returns the Supabase Functions client.",
+      "returns": "any"
     }
   },
+  "events": {},
   "state": {},
   "options": {},
   "envVars": [],
   "examples": [
     {
       "language": "ts",
-      "code": "const ws = container.server('websocket', { json: true })\nawait ws.start({ port: 8080 })\n\nws.on('message', (data, client) => {\n console.log('Received:', data)\n ws.broadcast({ echo: data })\n})"
+      "code": "const 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})"
     }
   ]
 });
 
-// Container introspection data
-setContainerBuildTimeData('Container', {
-  "className": "Container",
-  "description": "Containers are single objects that contain state, an event bus, and registries of helpers such as: - features - clients - servers A Helper represents a category of components in your program which have a common interface, e.g. all servers can be started / stopped, all features can be enabled, if supported, all clients can connect to something. A Helper can be introspected at runtime to learn about the interface of the helper. A helper has state, and emits events. You can design your own containers and load them up with the helpers you want for that environment.",
+setBuildTimeData('servers.mcp', {
+  "id": "servers.mcp",
+  "description": "MCP (Model Context Protocol) server for exposing tools, resources, and prompts to AI clients like Claude Code. Uses the low-level MCP SDK Server class directly with Zod 4 native JSON Schema conversion. Register tools, resources, and prompts programmatically, then start the server over stdio (for CLI integration) or HTTP (for remote access).",
+  "shortcut": "servers.mcp",
+  "className": "MCPServer",
   "methods": {
-    "subcontainer": {
-      "description": "Creates a new subcontainer instance of the same concrete Container subclass. The new instance is constructed with the same options as this container, shallow-merged with any overrides you provide. This preserves the runtime container type (e.g. NodeContainer, BrowserContainer, etc.).",
+    "tool": {
+      "description": "Register an MCP tool. The tool's Zod schema is converted to JSON Schema for the protocol listing, and used for runtime argument validation. Tool handlers can return a string (auto-wrapped as text content) or a full CallToolResult object for advanced responses (images, errors, etc).",
       "parameters": {
-        "this": {
-          "type": "This",
-          "description": "Parameter this"
+        "name": {
+          "type": "string",
+          "description": "Unique tool name"
         },
         "options": {
-          "type": "ConstructorParameters<This['constructor']>[0]",
-          "description": "Options to override for the new container instance."
+          "type": "ToolRegistrationOptions",
+          "description": "Tool schema, description, and handler",
+          "properties": {
+            "schema": {
+              "type": "z.ZodObject<any>",
+              "description": ""
+            },
+            "description": {
+              "type": "string",
+              "description": ""
+            },
+            "handler": {
+              "type": "(args: any, ctx: MCPContext) => any",
+              "description": ""
+            }
+          }
         }
       },
       "required": [
-        "this",
+        "name",
         "options"
       ],
-      "returns": "This"
+      "returns": "this"
     },
-    "addContext": {
-      "description": "",
+    "resource": {
+      "description": "Register an MCP resource. Resources expose data (files, configs, etc) that AI clients can read by URI. Accepts either a handler function directly or an options object with additional metadata (name, description, mimeType).",
       "parameters": {
-        "keyOrContext": {
-          "type": "keyof ContainerContext | Partial<ContainerContext>",
-          "description": "Parameter keyOrContext"
+        "uri": {
+          "type": "string",
+          "description": "Unique resource URI (e.g. \"project://readme\")"
         },
-        "value": {
-          "type": "ContainerContext[keyof ContainerContext]",
-          "description": "Parameter value"
+        "handlerOrOptions": {
+          "type": "ResourceRegistrationOptions['handler'] | ResourceRegistrationOptions",
+          "description": "Handler function or options object with handler"
         }
       },
       "required": [
-        "keyOrContext"
+        "uri",
+        "handlerOrOptions"
       ],
       "returns": "this"
     },
-    "setState": {
-      "description": "Sets the state of the container.",
+    "prompt": {
+      "description": "Register an MCP prompt. Prompts are reusable message templates that AI clients can invoke with optional string arguments.",
       "parameters": {
-        "newState": {
-          "type": "SetStateValue<ContainerState>",
-          "description": "The new state of the container."
-        }
-      },
-      "required": [
+        "name": {
+          "type": "string",
+          "description": "Unique prompt name"
+        },
+        "options": {
+          "type": "PromptRegistrationOptions",
+          "description": "Prompt handler, optional args schema, and description",
+          "properties": {
+            "description": {
+              "type": "string",
+              "description": ""
+            },
+            "args": {
+              "type": "Record<string, z.ZodType>",
+              "description": ""
+            },
+            "handler": {
+              "type": "(args: Record<string, string | undefined>, ctx: MCPContext) => Promise<PromptMessage[]> | PromptMessage[]",
+              "description": ""
+            }
+          }
+        }
+      },
+      "required": [
+        "name",
+        "options"
+      ],
+      "returns": "this"
+    },
+    "configure": {
+      "description": "Configure the MCP protocol server and register all protocol handlers. Called automatically before start() if not already configured.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "start": {
+      "description": "Start the MCP server with the specified transport.",
+      "parameters": {
+        "options": {
+          "type": "{\n    transport?: 'stdio' | 'http'\n    port?: number\n    host?: string\n    mcpCompat?: MCPCompatMode\n    stdioCompat?: StdioCompatMode\n  }",
+          "description": "Transport configuration. Defaults to stdio.",
+          "properties": {
+            "transport": {
+              "type": "any",
+              "description": "'stdio' for CLI integration, 'http' for remote access"
+            },
+            "port": {
+              "type": "any",
+              "description": "Port for HTTP transport (default 3001)"
+            }
+          }
+        }
+      },
+      "required": [],
+      "returns": "void"
+    },
+    "stop": {
+      "description": "Stop the MCP server and close all connections.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    }
+  },
+  "getters": {
+    "mcpServer": {
+      "description": "The underlying MCP protocol server instance. Created during configure().",
+      "returns": "MCPProtocolServer"
+    },
+    "handlerContext": {
+      "description": "The handler context passed to all tool, resource, and prompt handlers.",
+      "returns": "MCPContext"
+    }
+  },
+  "events": {
+    "toolRegistered": {
+      "name": "toolRegistered",
+      "description": "Event emitted by MCPServer",
+      "arguments": {}
+    },
+    "resourceRegistered": {
+      "name": "resourceRegistered",
+      "description": "Event emitted by MCPServer",
+      "arguments": {}
+    },
+    "promptRegistered": {
+      "name": "promptRegistered",
+      "description": "Event emitted by MCPServer",
+      "arguments": {}
+    },
+    "toolCalled": {
+      "name": "toolCalled",
+      "description": "Event emitted by MCPServer",
+      "arguments": {}
+    }
+  },
+  "state": {},
+  "options": {},
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const mcp = container.server('mcp', { serverName: 'my-server', serverVersion: '1.0.0' })\n\nmcp.tool('search_files', {\n schema: z.object({ pattern: z.string() }),\n description: 'Search for files',\n handler: async (args, ctx) => {\n   return ctx.container.feature('fs').walk('.', { include: [args.pattern] }).files.join('\\n')\n }\n})\n\nawait mcp.start()"
+    }
+  ]
+});
+
+setBuildTimeData('servers.express', {
+  "id": "servers.express",
+  "description": "Express.js HTTP server with automatic endpoint mounting, CORS, and SPA history fallback. Wraps an Express application with convention-based endpoint discovery. Endpoints defined as modules are automatically mounted as routes. Supports static file serving, CORS configuration, and single-page app history fallback out of the box.",
+  "shortcut": "servers.express",
+  "className": "ExpressServer",
+  "methods": {
+    "start": {
+      "description": "Start the Express HTTP server. A runtime `port` overrides the constructor option and is written to state so `server.port` always reflects reality.",
+      "parameters": {
+        "options": {
+          "type": "StartOptions",
+          "description": "Optional runtime overrides for port and host"
+        }
+      },
+      "required": [],
+      "returns": "void"
+    },
+    "stop": {
+      "description": "",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "configure": {
+      "description": "",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "useEndpoint": {
+      "description": "",
+      "parameters": {
+        "endpoint": {
+          "type": "Endpoint",
+          "description": "Parameter endpoint"
+        }
+      },
+      "required": [
+        "endpoint"
+      ],
+      "returns": "this"
+    },
+    "useEndpoints": {
+      "description": "",
+      "parameters": {
+        "dir": {
+          "type": "string",
+          "description": "Parameter dir"
+        }
+      },
+      "required": [
+        "dir"
+      ],
+      "returns": "Promise<this>"
+    },
+    "useEndpointModules": {
+      "description": "",
+      "parameters": {
+        "modules": {
+          "type": "EndpointModule[]",
+          "description": "Parameter modules"
+        }
+      },
+      "required": [
+        "modules"
+      ],
+      "returns": "Promise<this>"
+    },
+    "serveOpenAPISpec": {
+      "description": "",
+      "parameters": {
+        "options": {
+          "type": "{ title?: string; version?: string; description?: string }",
+          "description": "Parameter options"
+        }
+      },
+      "required": [],
+      "returns": "this"
+    },
+    "generateOpenAPISpec": {
+      "description": "",
+      "parameters": {
+        "options": {
+          "type": "{ title?: string; version?: string; description?: string }",
+          "description": "Parameter options"
+        }
+      },
+      "required": [],
+      "returns": "Record<string, any>"
+    }
+  },
+  "getters": {
+    "express": {
+      "description": "",
+      "returns": "any"
+    },
+    "hooks": {
+      "description": "",
+      "returns": "any"
+    },
+    "app": {
+      "description": "",
+      "returns": "any"
+    }
+  },
+  "events": {},
+  "state": {},
+  "options": {},
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const server = container.server('express', { cors: true, static: './public' })\nawait server.start({ port: 3000 })\n\n// Mount endpoints programmatically\nserver.mount(myEndpoint)\n\n// Access the underlying Express app\nserver.app.get('/health', (req, res) => res.json({ ok: true }))"
+    }
+  ]
+});
+
+setBuildTimeData('servers.websocket', {
+  "id": "servers.websocket",
+  "description": "WebSocket server built on the `ws` library with optional JSON message framing. Manages WebSocket connections, tracks connected clients, and bridges messages to Luca's event bus. When `json` mode is enabled, incoming messages are automatically JSON-parsed (with `.toString()` for Buffer data) and outgoing messages via `send()` / `broadcast()` are JSON-stringified. When `json` mode is disabled, raw message data is emitted as-is and `send()` / `broadcast()` still JSON-stringify for safety.",
+  "shortcut": "servers.websocket",
+  "className": "WebsocketServer",
+  "methods": {
+    "broadcast": {
+      "description": "",
+      "parameters": {
+        "message": {
+          "type": "any",
+          "description": "Parameter message"
+        }
+      },
+      "required": [
+        "message"
+      ],
+      "returns": "void"
+    },
+    "send": {
+      "description": "",
+      "parameters": {
+        "ws": {
+          "type": "any",
+          "description": "Parameter ws"
+        },
+        "message": {
+          "type": "any",
+          "description": "Parameter message"
+        }
+      },
+      "required": [
+        "ws",
+        "message"
+      ],
+      "returns": "void"
+    },
+    "start": {
+      "description": "Start the WebSocket server. A runtime `port` overrides the constructor option and is written to state before the underlying `ws.Server` is created, so the server binds to the correct port.",
+      "parameters": {
+        "options": {
+          "type": "StartOptions",
+          "description": "Optional runtime overrides for port and host"
+        }
+      },
+      "required": [],
+      "returns": "void"
+    },
+    "stop": {
+      "description": "",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    }
+  },
+  "getters": {
+    "wss": {
+      "description": "",
+      "returns": "any"
+    },
+    "port": {
+      "description": "The port this server will bind to. Defaults to 8081 if not set via constructor options or start().",
+      "returns": "any"
+    }
+  },
+  "events": {
+    "connection": {
+      "name": "connection",
+      "description": "Event emitted by WebsocketServer",
+      "arguments": {}
+    },
+    "message": {
+      "name": "message",
+      "description": "Event emitted by WebsocketServer",
+      "arguments": {}
+    }
+  },
+  "state": {},
+  "options": {},
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const ws = container.server('websocket', { json: true })\nawait ws.start({ port: 8080 })\n\nws.on('message', (data, client) => {\n console.log('Received:', data)\n ws.broadcast({ echo: data })\n})"
+    }
+  ]
+});
+
+// Container introspection data
+setContainerBuildTimeData('Container', {
+  "className": "Container",
+  "description": "Containers are single objects that contain state, an event bus, and registries of helpers such as: - features - clients - servers A Helper represents a category of components in your program which have a common interface, e.g. all servers can be started / stopped, all features can be enabled, if supported, all clients can connect to something. A Helper can be introspected at runtime to learn about the interface of the helper. A helper has state, and emits events. You can design your own containers and load them up with the helpers you want for that environment.",
+  "methods": {
+    "subcontainer": {
+      "description": "Creates a new subcontainer instance of the same concrete Container subclass. The new instance is constructed with the same options as this container, shallow-merged with any overrides you provide. This preserves the runtime container type (e.g. NodeContainer, BrowserContainer, etc.).",
+      "parameters": {
+        "this": {
+          "type": "This",
+          "description": "Parameter this"
+        },
+        "options": {
+          "type": "ConstructorParameters<This['constructor']>[0]",
+          "description": "Options to override for the new container instance."
+        }
+      },
+      "required": [
+        "this",
+        "options"
+      ],
+      "returns": "This"
+    },
+    "addContext": {
+      "description": "",
+      "parameters": {
+        "keyOrContext": {
+          "type": "keyof ContainerContext | Partial<ContainerContext>",
+          "description": "Parameter keyOrContext"
+        },
+        "value": {
+          "type": "ContainerContext[keyof ContainerContext]",
+          "description": "Parameter value"
+        }
+      },
+      "required": [
+        "keyOrContext"
+      ],
+      "returns": "this"
+    },
+    "setState": {
+      "description": "Sets the state of the container.",
+      "parameters": {
+        "newState": {
+          "type": "SetStateValue<ContainerState>",
+          "description": "The new state of the container."
+        }
+      },
+      "required": [
         "newState"
       ],
       "returns": "void"
@@ -20690,218 +20690,23 @@ export const introspectionData = [
         "arguments": {}
       },
       "close": {
-        "name": "close",
-        "description": "Event emitted by WebSocketClient",
-        "arguments": {}
-      },
-      "reconnecting": {
-        "name": "reconnecting",
-        "description": "Event emitted by WebSocketClient",
-        "arguments": {}
-      }
-    },
-    "state": {},
-    "options": {},
-    "envVars": [],
-    "examples": [
-      {
-        "language": "ts",
-        "code": "const ws = container.client('websocket', {\n baseURL: 'ws://localhost:8080',\n reconnect: true,\n maxReconnectAttempts: 5\n})\nws.on('message', (data) => console.log('Received:', data))\nawait ws.connect()\nawait ws.send({ type: 'hello' })"
-      }
-    ]
-  },
-  {
-    "id": "clients.supabase",
-    "description": "Supabase client for the Luca container system. Wraps the official `@supabase/supabase-js` SDK and exposes it through Luca's typed state, events, and introspection system. The SDK is isomorphic so this single implementation works in both Node and browser containers. Use `client.sdk` for full SDK access, or use the convenience wrappers for common operations (auth, database queries, storage, edge functions, realtime).",
-    "shortcut": "clients.supabase",
-    "className": "SupabaseClient",
-    "methods": {
-      "from": {
-        "description": "Start a query on a Postgres table or view.",
-        "parameters": {
-          "table": {
-            "type": "string",
-            "description": "The table or view name to query"
-          }
-        },
-        "required": [
-          "table"
-        ],
-        "returns": "void"
-      },
-      "rpc": {
-        "description": "Call a Postgres function (RPC).",
-        "parameters": {
-          "fn": {
-            "type": "string",
-            "description": "The function name"
-          },
-          "params": {
-            "type": "Record<string, unknown>",
-            "description": "Arguments to pass to the function"
-          },
-          "options": {
-            "type": "{ head?: boolean; get?: boolean; count?: \"exact\" | \"planned\" | \"estimated\" }",
-            "description": "Optional settings (head, get, count)"
-          }
-        },
-        "required": [
-          "fn"
-        ],
-        "returns": "void"
-      },
-      "signInWithPassword": {
-        "description": "Sign in with email and password.",
-        "parameters": {
-          "email": {
-            "type": "string",
-            "description": "Parameter email"
-          },
-          "password": {
-            "type": "string",
-            "description": "Parameter password"
-          }
-        },
-        "required": [
-          "email",
-          "password"
-        ],
-        "returns": "void"
-      },
-      "signUp": {
-        "description": "Create a new user account with email and password.",
-        "parameters": {
-          "email": {
-            "type": "string",
-            "description": "Parameter email"
-          },
-          "password": {
-            "type": "string",
-            "description": "Parameter password"
-          }
-        },
-        "required": [
-          "email",
-          "password"
-        ],
-        "returns": "void"
-      },
-      "signOut": {
-        "description": "Sign the current user out.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "getSession": {
-        "description": "Get the current session, if any.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "getUser": {
-        "description": "Get the current user, if any.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "invoke": {
-        "description": "Invoke a Supabase Edge Function by name.",
-        "parameters": {
-          "name": {
-            "type": "string",
-            "description": "Parameter name"
-          },
-          "body": {
-            "type": "any",
-            "description": "Parameter body"
-          }
-        },
-        "required": [
-          "name"
-        ],
-        "returns": "void"
-      },
-      "subscribe": {
-        "description": "Subscribe to realtime changes on a Postgres table.",
-        "parameters": {
-          "channelName": {
-            "type": "string",
-            "description": "A name for this subscription channel"
-          },
-          "table": {
-            "type": "string",
-            "description": "The table to listen to"
-          },
-          "callback": {
-            "type": "(payload: any) => void",
-            "description": "Called with the payload on each change"
-          },
-          "event": {
-            "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
-            "description": "The event type to listen for (default: all changes)"
-          }
-        },
-        "required": [
-          "channelName",
-          "table",
-          "callback"
-        ],
-        "returns": "RealtimeChannel"
-      },
-      "unsubscribe": {
-        "description": "Unsubscribe and remove a realtime channel by name.",
-        "parameters": {
-          "channelName": {
-            "type": "string",
-            "description": "The channel name to remove"
-          }
-        },
-        "required": [
-          "channelName"
-        ],
-        "returns": "void"
-      },
-      "unsubscribeAll": {
-        "description": "Unsubscribe and remove all realtime channels.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "connect": {
-        "description": "Connect is a no-op since the Supabase SDK initializes on construction. The client is ready to use immediately after creation.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "disconnect": {
-        "description": "Disconnect by signing out and removing all realtime channels.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      }
-    },
-    "getters": {
-      "sdk": {
-        "description": "Returns the raw Supabase SDK client for full access to all SDK methods.",
-        "returns": "SupabaseSDKClient<any, any>"
-      },
-      "storage": {
-        "description": "Returns the Supabase Storage client for managing buckets and files.",
-        "returns": "any"
+        "name": "close",
+        "description": "Event emitted by WebSocketClient",
+        "arguments": {}
       },
-      "functions": {
-        "description": "Returns the Supabase Functions client.",
-        "returns": "any"
+      "reconnecting": {
+        "name": "reconnecting",
+        "description": "Event emitted by WebSocketClient",
+        "arguments": {}
       }
     },
-    "events": {},
     "state": {},
     "options": {},
     "envVars": [],
     "examples": [
       {
         "language": "ts",
-        "code": "const supabase = container.client('supabase', {\n supabaseUrl: 'https://xyz.supabase.co',\n supabaseKey: 'your-anon-key',\n})\n\n// Query data\nconst { data } = await supabase.from('users').select('*')\n\n// Auth\nawait supabase.signInWithPassword('user@example.com', 'password')\n\n// Realtime\nsupabase.subscribe('changes', 'users', (payload) => {\n console.log('Change:', payload)\n})"
+        "code": "const ws = container.client('websocket', {\n baseURL: 'ws://localhost:8080',\n reconnect: true,\n maxReconnectAttempts: 5\n})\nws.on('message', (data) => console.log('Received:', data))\nawait ws.connect()\nawait ws.send({ type: 'hello' })"
       }
     ]
   },
@@ -21018,147 +20823,398 @@ export const introspectionData = [
       "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"
+          "input": {
+            "type": "string | string[]",
+            "description": "A string or array of strings to embed"
+          },
+          "options": {
+            "type": "Partial<OpenAI.Embeddings.EmbeddingCreateParams>",
+            "description": "Additional parameters (model, etc.)"
+          }
+        },
+        "required": [
+          "input"
+        ],
+        "returns": "Promise<OpenAI.Embeddings.CreateEmbeddingResponse>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const response = await openai.createEmbedding('Hello world')\nconsole.log(response.data[0].embedding.length)"
+          }
+        ]
+      },
+      "createImage": {
+        "description": "Generate an image from a text prompt using DALL-E.",
+        "parameters": {
+          "prompt": {
+            "type": "string",
+            "description": "Description of the image to generate"
+          },
+          "options": {
+            "type": "Partial<OpenAI.Images.ImageGenerateParams>",
+            "description": "Additional parameters (size, n, etc.)"
+          }
+        },
+        "required": [
+          "prompt"
+        ],
+        "returns": "Promise<OpenAI.Images.ImagesResponse>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const response = await openai.createImage('A sunset over mountains')\nconsole.log(response.data[0].url)"
+          }
+        ]
+      },
+      "listModels": {
+        "description": "List all available models.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<OpenAI.Models.ModelsPage>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const models = await openai.listModels()"
+          }
+        ]
+      },
+      "ask": {
+        "description": "Ask a single question and get a text response. Convenience wrapper around `createChatCompletion` for simple Q&A.",
+        "parameters": {
+          "question": {
+            "type": "string",
+            "description": "The question to ask"
+          },
+          "options": {
+            "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
+            "description": "Additional completion parameters"
+          }
+        },
+        "required": [
+          "question"
+        ],
+        "returns": "Promise<string>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const answer = await openai.ask('What is 2 + 2?')\nconsole.log(answer) // '4'"
+          }
+        ]
+      },
+      "chat": {
+        "description": "Send a multi-turn conversation and get a text response. Convenience wrapper around `createChatCompletion` that returns just the text.",
+        "parameters": {
+          "messages": {
+            "type": "OpenAI.Chat.Completions.ChatCompletionMessageParam[]",
+            "description": "Array of chat messages"
+          },
+          "options": {
+            "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
+            "description": "Additional completion parameters"
+          }
+        },
+        "required": [
+          "messages"
+        ],
+        "returns": "Promise<string>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const reply = await openai.chat([\n { role: 'system', content: 'You are a pirate.' },\n { role: 'user', content: 'Hello!' }\n])"
+          }
+        ]
+      }
+    },
+    "getters": {
+      "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 OpenAIClient",
+        "arguments": {}
+      },
+      "completion": {
+        "name": "completion",
+        "description": "Event emitted by OpenAIClient",
+        "arguments": {}
+      },
+      "embedding": {
+        "name": "embedding",
+        "description": "Event emitted by OpenAIClient",
+        "arguments": {}
+      },
+      "image": {
+        "name": "image",
+        "description": "Event emitted by OpenAIClient",
+        "arguments": {}
+      },
+      "models": {
+        "name": "models",
+        "description": "Event emitted by OpenAIClient",
+        "arguments": {}
+      }
+    },
+    "state": {},
+    "options": {},
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const openai = container.client('openai', { defaultModel: 'gpt-4o' })\nconst answer = await openai.ask('What is the meaning of life?')\nconsole.log(answer)"
+      }
+    ]
+  },
+  {
+    "id": "clients.comfyui",
+    "description": "ComfyUI client — execute Stable Diffusion workflows via the ComfyUI API. Connects to a ComfyUI instance to queue prompts, track execution via WebSocket or polling, and download generated images. Supports both UI-format and API-format workflows with automatic conversion.",
+    "shortcut": "clients.comfyui",
+    "className": "ComfyUIClient",
+    "methods": {
+      "queuePrompt": {
+        "description": "Queue a prompt (API-format workflow) for execution.",
+        "parameters": {
+          "prompt": {
+            "type": "Record<string, any>",
+            "description": "The API-format workflow object"
+          },
+          "clientId": {
+            "type": "string",
+            "description": "Override the client ID for this request"
+          }
+        },
+        "required": [
+          "prompt"
+        ],
+        "returns": "Promise<{ prompt_id: string; number: number }>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const { prompt_id } = await comfy.queuePrompt(apiWorkflow)"
+          }
+        ]
+      },
+      "getQueue": {
+        "description": "Get the current prompt queue status.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<{ queue_running: any[]; queue_pending: any[] }>"
+      },
+      "getHistory": {
+        "description": "Get execution history, optionally for a specific prompt.",
+        "parameters": {
+          "promptId": {
+            "type": "string",
+            "description": "If provided, returns history for this prompt only"
+          }
+        },
+        "required": [],
+        "returns": "Promise<Record<string, any>>"
+      },
+      "getSystemStats": {
+        "description": "Get system stats including GPU memory and queue info.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<any>"
+      },
+      "getObjectInfo": {
+        "description": "Get node type info with input/output schemas.",
+        "parameters": {
+          "nodeClass": {
+            "type": "string",
+            "description": "If provided, returns info for this node type only"
+          }
+        },
+        "required": [],
+        "returns": "Promise<any>"
+      },
+      "interrupt": {
+        "description": "Interrupt the currently executing prompt.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<void>"
+      },
+      "getModels": {
+        "description": "List available models, optionally filtered by type.",
+        "parameters": {
+          "type": {
+            "type": "string",
+            "description": "Model type filter (e.g., 'checkpoints', 'loras')"
+          }
+        },
+        "required": [],
+        "returns": "Promise<string[]>"
+      },
+      "getEmbeddings": {
+        "description": "List available embedding models.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<string[]>"
+      },
+      "uploadImage": {
+        "description": "Upload an image to ComfyUI's input directory.",
+        "parameters": {
+          "file": {
+            "type": "Buffer | Blob",
+            "description": "The image data as Buffer or Blob"
           },
-          "options": {
-            "type": "Partial<OpenAI.Embeddings.EmbeddingCreateParams>",
-            "description": "Additional parameters (model, etc.)"
+          "filename": {
+            "type": "string",
+            "description": "File name for the upload"
+          },
+          "opts": {
+            "type": "{ subfolder?: string; type?: string; overwrite?: boolean }",
+            "description": "Upload options (subfolder, type, overwrite)"
           }
         },
         "required": [
-          "input"
+          "file",
+          "filename"
         ],
-        "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.",
+      "viewImage": {
+        "description": "Download a generated image from ComfyUI as a Buffer.",
         "parameters": {
-          "prompt": {
+          "filename": {
             "type": "string",
-            "description": "Description of the image to generate"
+            "description": "The image filename"
           },
-          "options": {
-            "type": "Partial<OpenAI.Images.ImageGenerateParams>",
-            "description": "Additional parameters (size, n, etc.)"
+          "subfolder": {
+            "type": "any",
+            "description": "Subfolder within the output directory"
+          },
+          "type": {
+            "type": "any",
+            "description": "Image type ('output', 'input', 'temp')"
           }
         },
         "required": [
-          "prompt"
+          "filename"
         ],
-        "returns": "Promise<OpenAI.Images.ImagesResponse>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const response = await openai.createImage('A sunset over mountains')\nconsole.log(response.data[0].url)"
-          }
-        ]
+        "returns": "Promise<Buffer>"
       },
-      "listModels": {
-        "description": "List all available models.",
+      "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<OpenAI.Models.ModelsPage>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const models = await openai.listModels()"
-          }
-        ]
+        "returns": "Promise<void>"
       },
-      "ask": {
-        "description": "Ask a single question and get a text response. Convenience wrapper around `createChatCompletion` for simple Q&A.",
+      "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": {
-          "question": {
-            "type": "string",
-            "description": "The question to ask"
-          },
-          "options": {
-            "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
-            "description": "Additional completion parameters"
+          "workflow": {
+            "type": "Record<string, any>",
+            "description": "Parameter workflow"
           }
         },
         "required": [
-          "question"
+          "workflow"
         ],
-        "returns": "Promise<string>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const answer = await openai.ask('What is 2 + 2?')\nconsole.log(answer) // '4'"
-          }
-        ]
+        "returns": "Promise<Record<string, any>>"
       },
-      "chat": {
-        "description": "Send a multi-turn conversation and get a text response. Convenience wrapper around `createChatCompletion` that returns just the text.",
+      "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": {
-          "messages": {
-            "type": "OpenAI.Chat.Completions.ChatCompletionMessageParam[]",
-            "description": "Array of chat messages"
+          "workflow": {
+            "type": "Record<string, any>",
+            "description": "Parameter workflow"
+          },
+          "inputs": {
+            "type": "Record<string, any>",
+            "description": "Parameter inputs"
           },
           "options": {
-            "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
-            "description": "Additional completion parameters"
+            "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": [
-          "messages"
+          "workflow"
         ],
-        "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<WorkflowResult>"
       }
     },
     "getters": {
-      "defaultModel": {
-        "description": "The default model used for completions, from options or 'gpt-4o'.",
+      "clientId": {
+        "description": "The unique client ID used for WebSocket session tracking.",
         "returns": "string"
       },
-      "raw": {
-        "description": "The underlying OpenAI SDK instance for advanced use cases.",
-        "returns": "OpenAI"
+      "wsURL": {
+        "description": "The WebSocket URL derived from baseURL or overridden via options.",
+        "returns": "string"
       }
     },
     "events": {
-      "connected": {
-        "name": "connected",
-        "description": "Event emitted by OpenAIClient",
+      "execution_start": {
+        "name": "execution_start",
+        "description": "Event emitted by ComfyUIClient",
         "arguments": {}
       },
-      "failure": {
-        "name": "failure",
-        "description": "Event emitted by OpenAIClient",
+      "execution_complete": {
+        "name": "execution_complete",
+        "description": "Event emitted by ComfyUIClient",
         "arguments": {}
       },
-      "completion": {
-        "name": "completion",
-        "description": "Event emitted by OpenAIClient",
+      "executing": {
+        "name": "executing",
+        "description": "Event emitted by ComfyUIClient",
         "arguments": {}
       },
-      "embedding": {
-        "name": "embedding",
-        "description": "Event emitted by OpenAIClient",
+      "progress": {
+        "name": "progress",
+        "description": "Event emitted by ComfyUIClient",
         "arguments": {}
       },
-      "image": {
-        "name": "image",
-        "description": "Event emitted by OpenAIClient",
+      "executed": {
+        "name": "executed",
+        "description": "Event emitted by ComfyUIClient",
         "arguments": {}
       },
-      "models": {
-        "name": "models",
-        "description": "Event emitted by OpenAIClient",
+      "execution_cached": {
+        "name": "execution_cached",
+        "description": "Event emitted by ComfyUIClient",
+        "arguments": {}
+      },
+      "execution_error": {
+        "name": "execution_error",
+        "description": "Event emitted by ComfyUIClient",
         "arguments": {}
       }
     },
@@ -21168,7 +21224,7 @@ 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 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)"
       }
     ]
   },
@@ -21374,253 +21430,197 @@ export const introspectionData = [
     ]
   },
   {
-    "id": "clients.comfyui",
-    "description": "ComfyUI client — execute Stable Diffusion workflows via the ComfyUI API. Connects to a ComfyUI instance to queue prompts, track execution via WebSocket or polling, and download generated images. Supports both UI-format and API-format workflows with automatic conversion.",
-    "shortcut": "clients.comfyui",
-    "className": "ComfyUIClient",
+    "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": {
-      "queuePrompt": {
-        "description": "Queue a prompt (API-format workflow) for execution.",
-        "parameters": {
-          "prompt": {
-            "type": "Record<string, any>",
-            "description": "The API-format workflow object"
-          },
-          "clientId": {
-            "type": "string",
-            "description": "Override the client ID for this request"
-          }
-        },
-        "required": [
-          "prompt"
-        ],
-        "returns": "Promise<{ prompt_id: string; number: number }>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const { prompt_id } = await comfy.queuePrompt(apiWorkflow)"
-          }
-        ]
-      },
-      "getQueue": {
-        "description": "Get the current prompt queue status.",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<{ queue_running: any[]; queue_pending: any[] }>"
-      },
-      "getHistory": {
-        "description": "Get execution history, optionally for a specific prompt.",
-        "parameters": {
-          "promptId": {
-            "type": "string",
-            "description": "If provided, returns history for this prompt only"
-          }
-        },
-        "required": [],
-        "returns": "Promise<Record<string, any>>"
-      },
-      "getSystemStats": {
-        "description": "Get system stats including GPU memory and queue info.",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<any>"
-      },
-      "getObjectInfo": {
-        "description": "Get node type info with input/output schemas.",
+      "from": {
+        "description": "Start a query on a Postgres table or view.",
         "parameters": {
-          "nodeClass": {
+          "table": {
             "type": "string",
-            "description": "If provided, returns info for this node type only"
+            "description": "The table or view name to query"
           }
         },
-        "required": [],
-        "returns": "Promise<any>"
-      },
-      "interrupt": {
-        "description": "Interrupt the currently executing prompt.",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<void>"
+        "required": [
+          "table"
+        ],
+        "returns": "void"
       },
-      "getModels": {
-        "description": "List available models, optionally filtered by type.",
+      "rpc": {
+        "description": "Call a Postgres function (RPC).",
         "parameters": {
-          "type": {
+          "fn": {
             "type": "string",
-            "description": "Model type filter (e.g., 'checkpoints', 'loras')"
+            "description": "The function name"
+          },
+          "params": {
+            "type": "Record<string, unknown>",
+            "description": "Arguments to pass to the function"
+          },
+          "options": {
+            "type": "{ head?: boolean; get?: boolean; count?: \"exact\" | \"planned\" | \"estimated\" }",
+            "description": "Optional settings (head, get, count)"
           }
         },
-        "required": [],
-        "returns": "Promise<string[]>"
-      },
-      "getEmbeddings": {
-        "description": "List available embedding models.",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<string[]>"
+        "required": [
+          "fn"
+        ],
+        "returns": "void"
       },
-      "uploadImage": {
-        "description": "Upload an image to ComfyUI's input directory.",
+      "signInWithPassword": {
+        "description": "Sign in with email and password.",
         "parameters": {
-          "file": {
-            "type": "Buffer | Blob",
-            "description": "The image data as Buffer or Blob"
-          },
-          "filename": {
+          "email": {
             "type": "string",
-            "description": "File name for the upload"
+            "description": "Parameter email"
           },
-          "opts": {
-            "type": "{ subfolder?: string; type?: string; overwrite?: boolean }",
-            "description": "Upload options (subfolder, type, overwrite)"
+          "password": {
+            "type": "string",
+            "description": "Parameter password"
           }
         },
         "required": [
-          "file",
-          "filename"
+          "email",
+          "password"
         ],
-        "returns": "Promise<any>"
+        "returns": "void"
       },
-      "viewImage": {
-        "description": "Download a generated image from ComfyUI as a Buffer.",
+      "signUp": {
+        "description": "Create a new user account with email and password.",
         "parameters": {
-          "filename": {
+          "email": {
             "type": "string",
-            "description": "The image filename"
-          },
-          "subfolder": {
-            "type": "any",
-            "description": "Subfolder within the output directory"
+            "description": "Parameter email"
           },
-          "type": {
-            "type": "any",
-            "description": "Image type ('output', 'input', 'temp')"
+          "password": {
+            "type": "string",
+            "description": "Parameter password"
           }
         },
         "required": [
-          "filename"
+          "email",
+          "password"
         ],
-        "returns": "Promise<Buffer>"
+        "returns": "void"
       },
-      "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`.",
+      "signOut": {
+        "description": "Sign the current user out.",
         "parameters": {},
         "required": [],
-        "returns": "Promise<void>"
+        "returns": "void"
       },
-      "disconnectWs": {
-        "description": "Close the WebSocket connection.",
+      "getSession": {
+        "description": "Get the current session, if any.",
         "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.",
+      "getUser": {
+        "description": "Get the current user, if any.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "invoke": {
+        "description": "Invoke a Supabase Edge Function by name.",
         "parameters": {
-          "workflow": {
-            "type": "Record<string, any>",
-            "description": "Parameter workflow"
+          "name": {
+            "type": "string",
+            "description": "Parameter name"
+          },
+          "body": {
+            "type": "any",
+            "description": "Parameter body"
           }
         },
         "required": [
-          "workflow"
+          "name"
         ],
-        "returns": "Promise<Record<string, any>>"
+        "returns": "void"
       },
-      "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' } } ```",
+      "subscribe": {
+        "description": "Subscribe to realtime changes on a Postgres table.",
         "parameters": {
-          "workflow": {
-            "type": "Record<string, any>",
-            "description": "Parameter workflow"
+          "channelName": {
+            "type": "string",
+            "description": "A name for this subscription channel"
           },
-          "inputs": {
-            "type": "Record<string, any>",
-            "description": "Parameter inputs"
+          "table": {
+            "type": "string",
+            "description": "The table to listen to"
           },
-          "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"
-              }
-            }
+          "callback": {
+            "type": "(payload: any) => void",
+            "description": "Called with the payload on each change"
+          },
+          "event": {
+            "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
+            "description": "The event type to listen for (default: all changes)"
           }
         },
         "required": [
-          "workflow"
+          "channelName",
+          "table",
+          "callback"
         ],
-        "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": {}
+        "returns": "RealtimeChannel"
       },
-      "execution_complete": {
-        "name": "execution_complete",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
+      "unsubscribe": {
+        "description": "Unsubscribe and remove a realtime channel by name.",
+        "parameters": {
+          "channelName": {
+            "type": "string",
+            "description": "The channel name to remove"
+          }
+        },
+        "required": [
+          "channelName"
+        ],
+        "returns": "void"
       },
-      "executing": {
-        "name": "executing",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
+      "unsubscribeAll": {
+        "description": "Unsubscribe and remove all realtime channels.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
       },
-      "progress": {
-        "name": "progress",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
+      "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"
       },
-      "executed": {
-        "name": "executed",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
+      "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>"
       },
-      "execution_cached": {
-        "name": "execution_cached",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
+      "storage": {
+        "description": "Returns the Supabase Storage client for managing buckets and files.",
+        "returns": "any"
       },
-      "execution_error": {
-        "name": "execution_error",
-        "description": "Event emitted by ComfyUIClient",
-        "arguments": {}
+      "functions": {
+        "description": "Returns the Supabase Functions client.",
+        "returns": "any"
       }
     },
+    "events": {},
     "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)"
+        "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})"
       }
     ]
   },