@soederpop/luca 0.0.23 → 0.0.26

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-21T15:48:33.044Z
+// Generated at: 2026-03-22T20:57:23.101Z
 
 setBuildTimeData('features.googleDocs', {
   "id": "features.googleDocs",
@@ -729,6 +729,25 @@ setBuildTimeData('features.git', {
         }
       ]
     },
+    "extractFolder": {
+      "description": "Extracts a folder (or entire repo) from a remote GitHub repository without cloning. Downloads the repo as a tarball and extracts only the specified subfolder, similar to how degit works. No .git history is included — just the files. Supports shorthand (`user/repo/path`), branch refs (`user/repo/path#branch`), and full GitHub URLs (`https://github.com/user/repo/tree/branch/path`).",
+      "parameters": {
+        "{ source, destination, branch }": {
+          "type": "{ source: string, destination: string, branch?: string }",
+          "description": "Parameter { source, destination, branch }"
+        }
+      },
+      "required": [
+        "{ source, destination, branch }"
+      ],
+      "returns": "void",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "// Extract a subfolder\nawait git.extractFolder({ source: 'soederpop/luca/src/assistants', destination: './my-assistants' })\n\n// Specific branch\nawait git.extractFolder({ source: 'sveltejs/template', destination: './my-app', branch: 'main' })\n\n// Full GitHub URL\nawait git.extractFolder({ source: 'https://github.com/user/repo/tree/main/examples', destination: './examples' })"
+        }
+      ]
+    },
     "getChangeHistoryForFiles": {
       "description": "Gets the commit history for a set of files or glob patterns. Accepts absolute paths, relative paths (resolved from container.cwd), or glob patterns. Returns commits that touched any of the matched files, with each entry noting which of your queried files were in that commit.",
       "parameters": {
@@ -2299,6 +2318,29 @@ setBuildTimeData('features.vm', {
       ],
       "returns": "Promise<T>"
     },
+    "runCaptured": {
+      "description": "Execute code and capture all console output as structured JSON. Returns both the execution result and an array of every `console.*` call made during execution, each entry recording the method name and arguments.",
+      "parameters": {
+        "code": {
+          "type": "string",
+          "description": "The JavaScript code to execute"
+        },
+        "ctx": {
+          "type": "any",
+          "description": "Context variables to make available to the executing code"
+        }
+      },
+      "required": [
+        "code"
+      ],
+      "returns": "Promise<{\n    result: T\n    console: Array<{ method: string, args: any[] }>\n    context: vm.Context\n  }>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const { result, console: calls } = await vm.runCaptured('console.log(\"hi\"); console.warn(\"oh\"); 42')\n// result === 42\n// calls === [{ method: 'log', args: ['hi'] }, { method: 'warn', args: ['oh'] }]"
+        }
+      ]
+    },
     "runSync": {
       "description": "Execute JavaScript code synchronously in a controlled environment.",
       "parameters": {
@@ -5256,6 +5298,23 @@ setBuildTimeData('features.fs', {
         }
       ]
     },
+    "readFileSync": {
+      "description": "Synchronously reads a file and returns its contents as a string. added this method because AI Assistants are understandly confused by this deviation from 2000's era node style",
+      "parameters": {
+        "path": {
+          "type": "string",
+          "description": "Parameter path"
+        },
+        "encoding": {
+          "type": "BufferEncoding | null",
+          "description": "Parameter encoding"
+        }
+      },
+      "required": [
+        "path"
+      ],
+      "returns": "string | Buffer"
+    },
     "readFileAsync": {
       "description": "Asynchronously reads a file and returns its contents as a string.",
       "parameters": {
@@ -5298,6 +5357,19 @@ setBuildTimeData('features.fs', {
         }
       ]
     },
+    "readJsonSync": {
+      "description": "Read and parse a JSON file synchronously",
+      "parameters": {
+        "path": {
+          "type": "string",
+          "description": "Parameter path"
+        }
+      },
+      "required": [
+        "path"
+      ],
+      "returns": "void"
+    },
     "readJsonAsync": {
       "description": "Asynchronously reads and parses a JSON file.",
       "parameters": {
@@ -9101,6 +9173,30 @@ setBuildTimeData('features.contentDb', {
   "shortcut": "features.contentDb",
   "className": "ContentDb",
   "methods": {
+    "renderTree": {
+      "description": "Render a tree view of the collection directory structure. Built with container.fs so it works without the `tree` binary.",
+      "parameters": {
+        "options": {
+          "type": "{ depth?: number; dirsOnly?: boolean }",
+          "description": "Parameter options"
+        }
+      },
+      "required": [],
+      "returns": "string"
+    },
+    "grep": {
+      "description": "",
+      "parameters": {
+        "options": {
+          "type": "string | GrepOptions",
+          "description": "Parameter options"
+        }
+      },
+      "required": [
+        "options"
+      ],
+      "returns": "void"
+    },
     "query": {
       "description": "Query documents belonging to a specific model definition.",
       "parameters": {
@@ -9318,6 +9414,90 @@ setBuildTimeData('features.contentDb', {
       },
       "required": [],
       "returns": "void"
+    },
+    "getCollectionOverview": {
+      "description": "Returns a high-level overview of the collection.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "listDocuments": {
+      "description": "List document IDs, optionally filtered by model or glob.",
+      "parameters": {
+        "args": {
+          "type": "{ model?: string; glob?: string }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "void"
+    },
+    "readDocument": {
+      "description": "Read a single document with optional section filtering.",
+      "parameters": {
+        "args": {
+          "type": "{ id: string; include?: string[]; exclude?: string[]; meta?: boolean }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "void"
+    },
+    "readMultipleDocuments": {
+      "description": "Read multiple documents with optional section filtering.",
+      "parameters": {
+        "args": {
+          "type": "{ ids: string[]; include?: string[]; exclude?: string[]; meta?: boolean }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "void"
+    },
+    "queryDocuments": {
+      "description": "Query documents by model with filters, sort, limit.",
+      "parameters": {
+        "args": {
+          "type": "{ model: string; where?: string; sort?: string; limit?: number; offset?: number; select?: string[] }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "void"
+    },
+    "searchContent": {
+      "description": "Grep/text search across the collection.",
+      "parameters": {
+        "args": {
+          "type": "{ pattern: string; caseSensitive?: boolean }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "void"
+    },
+    "semanticSearch": {
+      "description": "Hybrid semantic search with graceful fallback to grep.",
+      "parameters": {
+        "args": {
+          "type": "{ query: string; limit?: number }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "void"
     }
   },
   "getters": {
@@ -9341,6 +9521,18 @@ setBuildTimeData('features.contentDb', {
       "description": "Returns an array of all registered model names from the collection.",
       "returns": "string[]"
     },
+    "available": {
+      "description": "Returns the available document ids in the collection",
+      "returns": "string[]"
+    },
+    "modelDefinitionTable": {
+      "description": "",
+      "returns": "any"
+    },
+    "fileTree": {
+      "description": "",
+      "returns": "any"
+    },
     "searchIndexStatus": {
       "description": "Get the current search index status.",
       "returns": "any"
@@ -10157,450 +10349,450 @@ setBuildTimeData('clients.elevenlabs', {
   ]
 });
 
-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",
+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": {
-    "queuePrompt": {
-      "description": "Queue a prompt (API-format workflow) for execution.",
+    "from": {
+      "description": "Start a query on a Postgres table or view.",
       "parameters": {
-        "prompt": {
-          "type": "Record<string, any>",
-          "description": "The API-format workflow object"
-        },
-        "clientId": {
+        "table": {
           "type": "string",
-          "description": "Override the client ID for this request"
+          "description": "The table or view name to query"
         }
       },
       "required": [
-        "prompt"
+        "table"
       ],
-      "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[] }>"
+      "returns": "void"
     },
-    "getHistory": {
-      "description": "Get execution history, optionally for a specific prompt.",
+    "rpc": {
+      "description": "Call a Postgres function (RPC).",
       "parameters": {
-        "promptId": {
+        "fn": {
           "type": "string",
-          "description": "If provided, returns history for this prompt only"
+          "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<Record<string, any>>"
-    },
-    "getSystemStats": {
-      "description": "Get system stats including GPU memory and queue info.",
-      "parameters": {},
-      "required": [],
-      "returns": "Promise<any>"
+      "required": [
+        "fn"
+      ],
+      "returns": "void"
     },
-    "getObjectInfo": {
-      "description": "Get node type info with input/output schemas.",
+    "signInWithPassword": {
+      "description": "Sign in with email and password.",
       "parameters": {
-        "nodeClass": {
+        "email": {
           "type": "string",
-          "description": "If provided, returns info for this node type only"
+          "description": "Parameter email"
+        },
+        "password": {
+          "type": "string",
+          "description": "Parameter password"
         }
       },
-      "required": [],
-      "returns": "Promise<any>"
-    },
-    "interrupt": {
-      "description": "Interrupt the currently executing prompt.",
-      "parameters": {},
-      "required": [],
-      "returns": "Promise<void>"
+      "required": [
+        "email",
+        "password"
+      ],
+      "returns": "void"
     },
-    "getModels": {
-      "description": "List available models, optionally filtered by type.",
+    "signUp": {
+      "description": "Create a new user account with email and password.",
       "parameters": {
-        "type": {
+        "email": {
           "type": "string",
-          "description": "Model type filter (e.g., 'checkpoints', 'loras')"
+          "description": "Parameter email"
+        },
+        "password": {
+          "type": "string",
+          "description": "Parameter password"
         }
       },
+      "required": [
+        "email",
+        "password"
+      ],
+      "returns": "void"
+    },
+    "signOut": {
+      "description": "Sign the current user out.",
+      "parameters": {},
       "required": [],
-      "returns": "Promise<string[]>"
-    },
-    "getEmbeddings": {
-      "description": "List available embedding models.",
-      "parameters": {},
-      "required": [],
-      "returns": "Promise<string[]>"
+      "returns": "void"
     },
-    "uploadImage": {
-      "description": "Upload an image to ComfyUI's input directory.",
+    "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": {
-        "file": {
-          "type": "Buffer | Blob",
-          "description": "The image data as Buffer or Blob"
-        },
-        "filename": {
+        "name": {
           "type": "string",
-          "description": "File name for the upload"
+          "description": "Parameter name"
         },
-        "opts": {
-          "type": "{ subfolder?: string; type?: string; overwrite?: boolean }",
-          "description": "Upload options (subfolder, type, overwrite)"
+        "body": {
+          "type": "any",
+          "description": "Parameter body"
         }
       },
       "required": [
-        "file",
-        "filename"
+        "name"
       ],
-      "returns": "Promise<any>"
+      "returns": "void"
     },
-    "viewImage": {
-      "description": "Download a generated image from ComfyUI as a Buffer.",
+    "subscribe": {
+      "description": "Subscribe to realtime changes on a Postgres table.",
       "parameters": {
-        "filename": {
+        "channelName": {
           "type": "string",
-          "description": "The image filename"
+          "description": "A name for this subscription channel"
         },
-        "subfolder": {
-          "type": "any",
-          "description": "Subfolder within the output directory"
+        "table": {
+          "type": "string",
+          "description": "The table to listen to"
         },
-        "type": {
-          "type": "any",
-          "description": "Image type ('output', 'input', 'temp')"
+        "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": [
-        "filename"
+        "channelName",
+        "table",
+        "callback"
       ],
-      "returns": "Promise<Buffer>"
+      "returns": "RealtimeChannel"
     },
-    "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`.",
+    "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": "Promise<void>"
+      "returns": "void"
     },
-    "disconnectWs": {
-      "description": "Close the WebSocket connection.",
+    "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"
     },
-    "toApiFormat": {
-      "description": "Convert a UI-format workflow to the API format that /prompt expects. Requires a running ComfyUI instance to fetch `object_info` so we can map positional `widgets_values` to their named input fields. If the workflow is already in API format, it's returned as-is.",
-      "parameters": {
-        "workflow": {
-          "type": "Record<string, any>",
-          "description": "Parameter workflow"
-        }
-      },
-      "required": [
-        "workflow"
-      ],
-      "returns": "Promise<Record<string, any>>"
-    },
-    "runWorkflow": {
-      "description": "Run a ComfyUI workflow with optional runtime input overrides. Inputs can be provided in two forms: **Direct node mapping** (when no `inputMap` in options): ``` { '3': { seed: 42 }, '6': { text: 'a cat' } } ``` **Named inputs** (when `inputMap` is provided in options): ``` inputs: { positive_prompt: 'a cat', seed: 42 } options.inputMap: { positive_prompt: { nodeId: '6', field: 'text' }, seed: { nodeId: '3', field: 'seed' } } ```",
-      "parameters": {
-        "workflow": {
-          "type": "Record<string, any>",
-          "description": "Parameter workflow"
-        },
-        "inputs": {
-          "type": "Record<string, any>",
-          "description": "Parameter inputs"
-        },
-        "options": {
-          "type": "WorkflowRunOptions",
-          "description": "Parameter options",
-          "properties": {
-            "poll": {
-              "type": "boolean",
-              "description": "Use polling instead of WebSocket for tracking execution"
-            },
-            "pollInterval": {
-              "type": "number",
-              "description": "Polling interval in ms (default 1000)"
-            },
-            "inputMap": {
-              "type": "InputMapping",
-              "description": "Named input mapping: semantic name -> { nodeId, field }"
-            },
-            "outputDir": {
-              "type": "string",
-              "description": "If provided, output images are downloaded to this directory"
-            }
-          }
-        }
-      },
-      "required": [
-        "workflow"
-      ],
-      "returns": "Promise<WorkflowResult>"
+    "disconnect": {
+      "description": "Disconnect by signing out and removing all realtime channels.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
     }
   },
   "getters": {
-    "clientId": {
-      "description": "The unique client ID used for WebSocket session tracking.",
-      "returns": "string"
-    },
-    "wsURL": {
-      "description": "The WebSocket URL derived from baseURL or overridden via options.",
-      "returns": "string"
-    }
-  },
-  "events": {
-    "execution_start": {
-      "name": "execution_start",
-      "description": "Event emitted by ComfyUIClient",
-      "arguments": {}
-    },
-    "execution_complete": {
-      "name": "execution_complete",
-      "description": "Event emitted by ComfyUIClient",
-      "arguments": {}
-    },
-    "executing": {
-      "name": "executing",
-      "description": "Event emitted by ComfyUIClient",
-      "arguments": {}
-    },
-    "progress": {
-      "name": "progress",
-      "description": "Event emitted by ComfyUIClient",
-      "arguments": {}
-    },
-    "executed": {
-      "name": "executed",
-      "description": "Event emitted by ComfyUIClient",
-      "arguments": {}
+    "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})"
     }
   ]
 });
 
-setBuildTimeData('clients.supabase', {
-  "id": "clients.supabase",
-  "description": "Supabase client for the Luca container system. Wraps the official `@supabase/supabase-js` SDK and exposes it through Luca's typed state, events, and introspection system. The SDK is isomorphic so this single implementation works in both Node and browser containers. Use `client.sdk` for full SDK access, or use the convenience wrappers for common operations (auth, database queries, storage, edge functions, realtime).",
-  "shortcut": "clients.supabase",
-  "className": "SupabaseClient",
+setBuildTimeData('clients.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": {
-    "from": {
-      "description": "Start a query on a Postgres table or view.",
+    "queuePrompt": {
+      "description": "Queue a prompt (API-format workflow) for execution.",
       "parameters": {
-        "table": {
+        "prompt": {
+          "type": "Record<string, any>",
+          "description": "The API-format workflow object"
+        },
+        "clientId": {
           "type": "string",
-          "description": "The table or view name to query"
+          "description": "Override the client ID for this request"
         }
       },
       "required": [
-        "table"
+        "prompt"
       ],
-      "returns": "void"
+      "returns": "Promise<{ prompt_id: string; number: number }>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const { prompt_id } = await comfy.queuePrompt(apiWorkflow)"
+        }
+      ]
     },
-    "rpc": {
-      "description": "Call a Postgres function (RPC).",
+    "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": {
-        "fn": {
+        "promptId": {
           "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)"
+          "description": "If provided, returns history for this prompt only"
         }
       },
-      "required": [
-        "fn"
-      ],
-      "returns": "void"
+      "required": [],
+      "returns": "Promise<Record<string, any>>"
     },
-    "signInWithPassword": {
-      "description": "Sign in with email and password.",
+    "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": {
-        "email": {
+        "nodeClass": {
           "type": "string",
-          "description": "Parameter email"
+          "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"
         },
-        "password": {
+        "filename": {
           "type": "string",
-          "description": "Parameter password"
+          "description": "File name for the upload"
+        },
+        "opts": {
+          "type": "{ subfolder?: string; type?: string; overwrite?: boolean }",
+          "description": "Upload options (subfolder, type, overwrite)"
         }
       },
       "required": [
-        "email",
-        "password"
+        "file",
+        "filename"
       ],
-      "returns": "void"
+      "returns": "Promise<any>"
     },
-    "signUp": {
-      "description": "Create a new user account with email and password.",
+    "viewImage": {
+      "description": "Download a generated image from ComfyUI as a Buffer.",
       "parameters": {
-        "email": {
+        "filename": {
           "type": "string",
-          "description": "Parameter email"
+          "description": "The image filename"
         },
-        "password": {
-          "type": "string",
-          "description": "Parameter password"
+        "subfolder": {
+          "type": "any",
+          "description": "Subfolder within the output directory"
+        },
+        "type": {
+          "type": "any",
+          "description": "Image type ('output', 'input', 'temp')"
         }
       },
       "required": [
-        "email",
-        "password"
+        "filename"
       ],
-      "returns": "void"
-    },
-    "signOut": {
-      "description": "Sign the current user out.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
+      "returns": "Promise<Buffer>"
     },
-    "getSession": {
-      "description": "Get the current session, if any.",
+    "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": "void"
+      "returns": "Promise<void>"
     },
-    "getUser": {
-      "description": "Get the current user, if any.",
+    "disconnectWs": {
+      "description": "Close the WebSocket connection.",
       "parameters": {},
       "required": [],
       "returns": "void"
     },
-    "invoke": {
-      "description": "Invoke a Supabase Edge Function by name.",
+    "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": {
-        "name": {
-          "type": "string",
-          "description": "Parameter name"
-        },
-        "body": {
-          "type": "any",
-          "description": "Parameter body"
+        "workflow": {
+          "type": "Record<string, any>",
+          "description": "Parameter workflow"
         }
       },
       "required": [
-        "name"
+        "workflow"
       ],
-      "returns": "void"
+      "returns": "Promise<Record<string, any>>"
     },
-    "subscribe": {
-      "description": "Subscribe to realtime changes on a Postgres table.",
+    "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": {
-        "channelName": {
-          "type": "string",
-          "description": "A name for this subscription channel"
-        },
-        "table": {
-          "type": "string",
-          "description": "The table to listen to"
+        "workflow": {
+          "type": "Record<string, any>",
+          "description": "Parameter workflow"
         },
-        "callback": {
-          "type": "(payload: any) => void",
-          "description": "Called with the payload on each change"
+        "inputs": {
+          "type": "Record<string, any>",
+          "description": "Parameter inputs"
         },
-        "event": {
-          "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
-          "description": "The event type to listen for (default: all changes)"
+        "options": {
+          "type": "WorkflowRunOptions",
+          "description": "Parameter options",
+          "properties": {
+            "poll": {
+              "type": "boolean",
+              "description": "Use polling instead of WebSocket for tracking execution"
+            },
+            "pollInterval": {
+              "type": "number",
+              "description": "Polling interval in ms (default 1000)"
+            },
+            "inputMap": {
+              "type": "InputMapping",
+              "description": "Named input mapping: semantic name -> { nodeId, field }"
+            },
+            "outputDir": {
+              "type": "string",
+              "description": "If provided, output images are downloaded to this directory"
+            }
+          }
         }
       },
       "required": [
-        "channelName",
-        "table",
-        "callback"
+        "workflow"
       ],
-      "returns": "RealtimeChannel"
+      "returns": "Promise<WorkflowResult>"
+    }
+  },
+  "getters": {
+    "clientId": {
+      "description": "The unique client ID used for WebSocket session tracking.",
+      "returns": "string"
     },
-    "unsubscribe": {
-      "description": "Unsubscribe and remove a realtime channel by name.",
-      "parameters": {
-        "channelName": {
-          "type": "string",
-          "description": "The channel name to remove"
-        }
-      },
-      "required": [
-        "channelName"
-      ],
-      "returns": "void"
+    "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": {}
     },
-    "unsubscribeAll": {
-      "description": "Unsubscribe and remove all realtime channels.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
+    "execution_complete": {
+      "name": "execution_complete",
+      "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"
+    "executing": {
+      "name": "executing",
+      "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>"
+    "progress": {
+      "name": "progress",
+      "description": "Event emitted by ComfyUIClient",
+      "arguments": {}
     },
-    "storage": {
-      "description": "Returns the Supabase Storage client for managing buckets and files.",
-      "returns": "any"
+    "executed": {
+      "name": "executed",
+      "description": "Event emitted by ComfyUIClient",
+      "arguments": {}
     },
-    "functions": {
-      "description": "Returns the Supabase Functions client.",
-      "returns": "any"
+    "execution_cached": {
+      "name": "execution_cached",
+      "description": "Event emitted by ComfyUIClient",
+      "arguments": {}
+    },
+    "execution_error": {
+      "name": "execution_error",
+      "description": "Event emitted by ComfyUIClient",
+      "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 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)"
     }
   ]
 });
@@ -11325,6 +11517,10 @@ setContainerBuildTimeData('Container', {
       "description": "Returns a map of enabled feature shortcut IDs to their instances.",
       "returns": "Partial<AvailableInstanceTypes<Features>>"
     },
+    "describer": {
+      "description": "Lazy-initialized ContainerDescriber for introspecting registries, helpers, and members.",
+      "returns": "ContainerDescriber"
+    },
     "context": {
       "description": "The Container's context is an object that contains the enabled features, the container itself, and any additional context that has been added to the container. All helper instances that are created by the container will have access to the shared context.",
       "returns": "ContainerContext<Features> & Partial<AvailableInstanceTypes<AvailableFeatures>>"
@@ -12130,6 +12326,25 @@ export const introspectionData = [
           }
         ]
       },
+      "extractFolder": {
+        "description": "Extracts a folder (or entire repo) from a remote GitHub repository without cloning. Downloads the repo as a tarball and extracts only the specified subfolder, similar to how degit works. No .git history is included — just the files. Supports shorthand (`user/repo/path`), branch refs (`user/repo/path#branch`), and full GitHub URLs (`https://github.com/user/repo/tree/branch/path`).",
+        "parameters": {
+          "{ source, destination, branch }": {
+            "type": "{ source: string, destination: string, branch?: string }",
+            "description": "Parameter { source, destination, branch }"
+          }
+        },
+        "required": [
+          "{ source, destination, branch }"
+        ],
+        "returns": "void",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "// Extract a subfolder\nawait git.extractFolder({ source: 'soederpop/luca/src/assistants', destination: './my-assistants' })\n\n// Specific branch\nawait git.extractFolder({ source: 'sveltejs/template', destination: './my-app', branch: 'main' })\n\n// Full GitHub URL\nawait git.extractFolder({ source: 'https://github.com/user/repo/tree/main/examples', destination: './examples' })"
+          }
+        ]
+      },
       "getChangeHistoryForFiles": {
         "description": "Gets the commit history for a set of files or glob patterns. Accepts absolute paths, relative paths (resolved from container.cwd), or glob patterns. Returns commits that touched any of the matched files, with each entry noting which of your queried files were in that commit.",
         "parameters": {
@@ -13694,6 +13909,29 @@ export const introspectionData = [
         ],
         "returns": "Promise<T>"
       },
+      "runCaptured": {
+        "description": "Execute code and capture all console output as structured JSON. Returns both the execution result and an array of every `console.*` call made during execution, each entry recording the method name and arguments.",
+        "parameters": {
+          "code": {
+            "type": "string",
+            "description": "The JavaScript code to execute"
+          },
+          "ctx": {
+            "type": "any",
+            "description": "Context variables to make available to the executing code"
+          }
+        },
+        "required": [
+          "code"
+        ],
+        "returns": "Promise<{\n    result: T\n    console: Array<{ method: string, args: any[] }>\n    context: vm.Context\n  }>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const { result, console: calls } = await vm.runCaptured('console.log(\"hi\"); console.warn(\"oh\"); 42')\n// result === 42\n// calls === [{ method: 'log', args: ['hi'] }, { method: 'warn', args: ['oh'] }]"
+          }
+        ]
+      },
       "runSync": {
         "description": "Execute JavaScript code synchronously in a controlled environment.",
         "parameters": {
@@ -16633,6 +16871,23 @@ export const introspectionData = [
           }
         ]
       },
+      "readFileSync": {
+        "description": "Synchronously reads a file and returns its contents as a string. added this method because AI Assistants are understandly confused by this deviation from 2000's era node style",
+        "parameters": {
+          "path": {
+            "type": "string",
+            "description": "Parameter path"
+          },
+          "encoding": {
+            "type": "BufferEncoding | null",
+            "description": "Parameter encoding"
+          }
+        },
+        "required": [
+          "path"
+        ],
+        "returns": "string | Buffer"
+      },
       "readFileAsync": {
         "description": "Asynchronously reads a file and returns its contents as a string.",
         "parameters": {
@@ -16675,6 +16930,19 @@ export const introspectionData = [
           }
         ]
       },
+      "readJsonSync": {
+        "description": "Read and parse a JSON file synchronously",
+        "parameters": {
+          "path": {
+            "type": "string",
+            "description": "Parameter path"
+          }
+        },
+        "required": [
+          "path"
+        ],
+        "returns": "void"
+      },
       "readJsonAsync": {
         "description": "Asynchronously reads and parses a JSON file.",
         "parameters": {
@@ -20463,6 +20731,30 @@ export const introspectionData = [
     "shortcut": "features.contentDb",
     "className": "ContentDb",
     "methods": {
+      "renderTree": {
+        "description": "Render a tree view of the collection directory structure. Built with container.fs so it works without the `tree` binary.",
+        "parameters": {
+          "options": {
+            "type": "{ depth?: number; dirsOnly?: boolean }",
+            "description": "Parameter options"
+          }
+        },
+        "required": [],
+        "returns": "string"
+      },
+      "grep": {
+        "description": "",
+        "parameters": {
+          "options": {
+            "type": "string | GrepOptions",
+            "description": "Parameter options"
+          }
+        },
+        "required": [
+          "options"
+        ],
+        "returns": "void"
+      },
       "query": {
         "description": "Query documents belonging to a specific model definition.",
         "parameters": {
@@ -20621,64 +20913,148 @@ export const introspectionData = [
           }
         },
         "required": [
-          "query"
+          "query"
+        ],
+        "returns": "void"
+      },
+      "vectorSearch": {
+        "description": "Vector similarity search using embeddings. Finds conceptually related documents even without keyword matches.",
+        "parameters": {
+          "query": {
+            "type": "string",
+            "description": "Parameter query"
+          },
+          "options": {
+            "type": "{ limit?: number; model?: string; where?: Record<string, any> }",
+            "description": "Parameter options"
+          }
+        },
+        "required": [
+          "query"
+        ],
+        "returns": "void"
+      },
+      "hybridSearch": {
+        "description": "Combined keyword + semantic search with Reciprocal Rank Fusion. Best for general questions about the collection.",
+        "parameters": {
+          "query": {
+            "type": "string",
+            "description": "Parameter query"
+          },
+          "options": {
+            "type": "{ limit?: number; model?: string; where?: Record<string, any>; ftsWeight?: number; vecWeight?: number }",
+            "description": "Parameter options"
+          }
+        },
+        "required": [
+          "query"
+        ],
+        "returns": "void"
+      },
+      "buildSearchIndex": {
+        "description": "Build the search index from all documents in the collection. Chunks documents and generates embeddings.",
+        "parameters": {
+          "options": {
+            "type": "{ force?: boolean; embeddingProvider?: string; embeddingModel?: string; onProgress?: (indexed: number, total: number) => void }",
+            "description": "Parameter options"
+          }
+        },
+        "required": [],
+        "returns": "void"
+      },
+      "rebuildSearchIndex": {
+        "description": "Rebuild the entire search index from scratch.",
+        "parameters": {
+          "options": {
+            "type": "{ embeddingProvider?: string; embeddingModel?: string; onProgress?: (indexed: number, total: number) => void }",
+            "description": "Parameter options"
+          }
+        },
+        "required": [],
+        "returns": "void"
+      },
+      "getCollectionOverview": {
+        "description": "Returns a high-level overview of the collection.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "listDocuments": {
+        "description": "List document IDs, optionally filtered by model or glob.",
+        "parameters": {
+          "args": {
+            "type": "{ model?: string; glob?: string }",
+            "description": "Parameter args"
+          }
+        },
+        "required": [
+          "args"
+        ],
+        "returns": "void"
+      },
+      "readDocument": {
+        "description": "Read a single document with optional section filtering.",
+        "parameters": {
+          "args": {
+            "type": "{ id: string; include?: string[]; exclude?: string[]; meta?: boolean }",
+            "description": "Parameter args"
+          }
+        },
+        "required": [
+          "args"
         ],
         "returns": "void"
       },
-      "vectorSearch": {
-        "description": "Vector similarity search using embeddings. Finds conceptually related documents even without keyword matches.",
+      "readMultipleDocuments": {
+        "description": "Read multiple documents with optional section filtering.",
         "parameters": {
-          "query": {
-            "type": "string",
-            "description": "Parameter query"
-          },
-          "options": {
-            "type": "{ limit?: number; model?: string; where?: Record<string, any> }",
-            "description": "Parameter options"
+          "args": {
+            "type": "{ ids: string[]; include?: string[]; exclude?: string[]; meta?: boolean }",
+            "description": "Parameter args"
           }
         },
         "required": [
-          "query"
+          "args"
         ],
         "returns": "void"
       },
-      "hybridSearch": {
-        "description": "Combined keyword + semantic search with Reciprocal Rank Fusion. Best for general questions about the collection.",
+      "queryDocuments": {
+        "description": "Query documents by model with filters, sort, limit.",
         "parameters": {
-          "query": {
-            "type": "string",
-            "description": "Parameter query"
-          },
-          "options": {
-            "type": "{ limit?: number; model?: string; where?: Record<string, any>; ftsWeight?: number; vecWeight?: number }",
-            "description": "Parameter options"
+          "args": {
+            "type": "{ model: string; where?: string; sort?: string; limit?: number; offset?: number; select?: string[] }",
+            "description": "Parameter args"
           }
         },
         "required": [
-          "query"
+          "args"
         ],
         "returns": "void"
       },
-      "buildSearchIndex": {
-        "description": "Build the search index from all documents in the collection. Chunks documents and generates embeddings.",
+      "searchContent": {
+        "description": "Grep/text search across the collection.",
         "parameters": {
-          "options": {
-            "type": "{ force?: boolean; embeddingProvider?: string; embeddingModel?: string; onProgress?: (indexed: number, total: number) => void }",
-            "description": "Parameter options"
+          "args": {
+            "type": "{ pattern: string; caseSensitive?: boolean }",
+            "description": "Parameter args"
           }
         },
-        "required": [],
+        "required": [
+          "args"
+        ],
         "returns": "void"
       },
-      "rebuildSearchIndex": {
-        "description": "Rebuild the entire search index from scratch.",
+      "semanticSearch": {
+        "description": "Hybrid semantic search with graceful fallback to grep.",
         "parameters": {
-          "options": {
-            "type": "{ embeddingProvider?: string; embeddingModel?: string; onProgress?: (indexed: number, total: number) => void }",
-            "description": "Parameter options"
+          "args": {
+            "type": "{ query: string; limit?: number }",
+            "description": "Parameter args"
           }
         },
-        "required": [],
+        "required": [
+          "args"
+        ],
         "returns": "void"
       }
     },
@@ -20703,6 +21079,18 @@ export const introspectionData = [
         "description": "Returns an array of all registered model names from the collection.",
         "returns": "string[]"
       },
+      "available": {
+        "description": "Returns the available document ids in the collection",
+        "returns": "string[]"
+      },
+      "modelDefinitionTable": {
+        "description": "",
+        "returns": "any"
+      },
+      "fileTree": {
+        "description": "",
+        "returns": "any"
+      },
       "searchIndexStatus": {
         "description": "Get the current search index status.",
         "returns": "any"
@@ -21468,48 +21856,243 @@ export const introspectionData = [
           }
         },
         "required": [
-          "text",
-          "outputPath"
+          "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"
+      }
+    ]
+  },
+  {
+    "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": "Promise<string>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const path = await el.say('Hello world', './hello.mp3')\nconsole.log(`Audio saved to ${path}`)"
-          }
-        ]
+        "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": {
-      "apiKey": {
-        "description": "The resolved API key from options or environment.",
-        "returns": "string"
-      }
-    },
-    "events": {
-      "failure": {
-        "name": "failure",
-        "description": "Event emitted by ElevenLabsClient",
-        "arguments": {}
+      "sdk": {
+        "description": "Returns the raw Supabase SDK client for full access to all SDK methods.",
+        "returns": "SupabaseSDKClient<any, any>"
       },
-      "voices": {
-        "name": "voices",
-        "description": "Event emitted by ElevenLabsClient",
-        "arguments": {}
+      "storage": {
+        "description": "Returns the Supabase Storage client for managing buckets and files.",
+        "returns": "any"
       },
-      "speech": {
-        "name": "speech",
-        "description": "Event emitted by ElevenLabsClient",
-        "arguments": {}
+      "functions": {
+        "description": "Returns the Supabase Functions client.",
+        "returns": "any"
       }
     },
+    "events": {},
     "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"
+        "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})"
       }
     ]
   },
@@ -21764,201 +22347,6 @@ export const introspectionData = [
       }
     ]
   },
-  {
-    "id": "clients.supabase",
-    "description": "Supabase client for the Luca container system. Wraps the official `@supabase/supabase-js` SDK and exposes it through Luca's typed state, events, and introspection system. The SDK is isomorphic so this single implementation works in both Node and browser containers. Use `client.sdk` for full SDK access, or use the convenience wrappers for common operations (auth, database queries, storage, edge functions, realtime).",
-    "shortcut": "clients.supabase",
-    "className": "SupabaseClient",
-    "methods": {
-      "from": {
-        "description": "Start a query on a Postgres table or view.",
-        "parameters": {
-          "table": {
-            "type": "string",
-            "description": "The table or view name to query"
-          }
-        },
-        "required": [
-          "table"
-        ],
-        "returns": "void"
-      },
-      "rpc": {
-        "description": "Call a Postgres function (RPC).",
-        "parameters": {
-          "fn": {
-            "type": "string",
-            "description": "The function name"
-          },
-          "params": {
-            "type": "Record<string, unknown>",
-            "description": "Arguments to pass to the function"
-          },
-          "options": {
-            "type": "{ head?: boolean; get?: boolean; count?: \"exact\" | \"planned\" | \"estimated\" }",
-            "description": "Optional settings (head, get, count)"
-          }
-        },
-        "required": [
-          "fn"
-        ],
-        "returns": "void"
-      },
-      "signInWithPassword": {
-        "description": "Sign in with email and password.",
-        "parameters": {
-          "email": {
-            "type": "string",
-            "description": "Parameter email"
-          },
-          "password": {
-            "type": "string",
-            "description": "Parameter password"
-          }
-        },
-        "required": [
-          "email",
-          "password"
-        ],
-        "returns": "void"
-      },
-      "signUp": {
-        "description": "Create a new user account with email and password.",
-        "parameters": {
-          "email": {
-            "type": "string",
-            "description": "Parameter email"
-          },
-          "password": {
-            "type": "string",
-            "description": "Parameter password"
-          }
-        },
-        "required": [
-          "email",
-          "password"
-        ],
-        "returns": "void"
-      },
-      "signOut": {
-        "description": "Sign the current user out.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "getSession": {
-        "description": "Get the current session, if any.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "getUser": {
-        "description": "Get the current user, if any.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "invoke": {
-        "description": "Invoke a Supabase Edge Function by name.",
-        "parameters": {
-          "name": {
-            "type": "string",
-            "description": "Parameter name"
-          },
-          "body": {
-            "type": "any",
-            "description": "Parameter body"
-          }
-        },
-        "required": [
-          "name"
-        ],
-        "returns": "void"
-      },
-      "subscribe": {
-        "description": "Subscribe to realtime changes on a Postgres table.",
-        "parameters": {
-          "channelName": {
-            "type": "string",
-            "description": "A name for this subscription channel"
-          },
-          "table": {
-            "type": "string",
-            "description": "The table to listen to"
-          },
-          "callback": {
-            "type": "(payload: any) => void",
-            "description": "Called with the payload on each change"
-          },
-          "event": {
-            "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
-            "description": "The event type to listen for (default: all changes)"
-          }
-        },
-        "required": [
-          "channelName",
-          "table",
-          "callback"
-        ],
-        "returns": "RealtimeChannel"
-      },
-      "unsubscribe": {
-        "description": "Unsubscribe and remove a realtime channel by name.",
-        "parameters": {
-          "channelName": {
-            "type": "string",
-            "description": "The channel name to remove"
-          }
-        },
-        "required": [
-          "channelName"
-        ],
-        "returns": "void"
-      },
-      "unsubscribeAll": {
-        "description": "Unsubscribe and remove all realtime channels.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "connect": {
-        "description": "Connect is a no-op since the Supabase SDK initializes on construction. The client is ready to use immediately after creation.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "disconnect": {
-        "description": "Disconnect by signing out and removing all realtime channels.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      }
-    },
-    "getters": {
-      "sdk": {
-        "description": "Returns the raw Supabase SDK client for full access to all SDK methods.",
-        "returns": "SupabaseSDKClient<any, any>"
-      },
-      "storage": {
-        "description": "Returns the Supabase Storage client for managing buckets and files.",
-        "returns": "any"
-      },
-      "functions": {
-        "description": "Returns the Supabase Functions client.",
-        "returns": "any"
-      }
-    },
-    "events": {},
-    "state": {},
-    "options": {},
-    "envVars": [],
-    "examples": [
-      {
-        "language": "ts",
-        "code": "const supabase = container.client('supabase', {\n supabaseUrl: 'https://xyz.supabase.co',\n supabaseKey: 'your-anon-key',\n})\n\n// Query data\nconst { data } = await supabase.from('users').select('*')\n\n// Auth\nawait supabase.signInWithPassword('user@example.com', 'password')\n\n// Realtime\nsupabase.subscribe('changes', 'users', (payload) => {\n console.log('Change:', payload)\n})"
-      }
-    ]
-  },
   {
     "id": "servers.mcp",
     "description": "MCP (Model Context Protocol) server for exposing tools, resources, and prompts to AI clients like Claude Code. Uses the low-level MCP SDK Server class directly with Zod 4 native JSON Schema conversion. Register tools, resources, and prompts programmatically, then start the server over stdio (for CLI integration) or HTTP (for remote access).",
@@ -22678,6 +23066,10 @@ export const containerIntrospectionData = [
         "description": "Returns a map of enabled feature shortcut IDs to their instances.",
         "returns": "Partial<AvailableInstanceTypes<Features>>"
       },
+      "describer": {
+        "description": "Lazy-initialized ContainerDescriber for introspecting registries, helpers, and members.",
+        "returns": "ContainerDescriber"
+      },
       "context": {
         "description": "The Container's context is an object that contains the enabled features, the container itself, and any additional context that has been added to the container. All helper instances that are created by the container will have access to the shared context.",
         "returns": "ContainerContext<Features> & Partial<AvailableInstanceTypes<AvailableFeatures>>"