@soederpop/luca 0.0.11 → 0.0.14

package/src/introspection/generated.agi.ts

@@ -1,7 +1,7 @@
 import { setBuildTimeData, setContainerBuildTimeData } from './index.js';
 
 // Auto-generated introspection registry data
-// Generated at: 2026-03-20T00:15:39.223Z
+// Generated at: 2026-03-20T03:57:55.838Z
 
 setBuildTimeData('features.googleDocs', {
   "id": "features.googleDocs",
@@ -9519,198 +9519,270 @@ 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",
+setBuildTimeData('clients.openai', {
+  "id": "clients.openai",
+  "description": "OpenAI client — wraps the OpenAI SDK for chat completions, responses API, embeddings, and image generation. Provides convenience methods for common operations while tracking token usage and request counts. Supports both the Chat Completions API and the newer Responses API.",
+  "shortcut": "clients.openai",
+  "className": "OpenAIClient",
   "methods": {
-    "from": {
-      "description": "Start a query on a Postgres table or view.",
+    "connect": {
+      "description": "Test the API connection by listing models.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<this>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "await openai.connect()"
+        }
+      ]
+    },
+    "createChatCompletion": {
+      "description": "Create a chat completion using the Chat Completions API.",
       "parameters": {
-        "table": {
-          "type": "string",
-          "description": "The table or view name to query"
+        "messages": {
+          "type": "OpenAI.Chat.Completions.ChatCompletionMessageParam[]",
+          "description": "Array of chat messages"
+        },
+        "options": {
+          "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
+          "description": "Additional parameters for the completion"
         }
       },
       "required": [
-        "table"
+        "messages"
       ],
-      "returns": "void"
+      "returns": "Promise<OpenAI.Chat.Completions.ChatCompletion>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const response = await openai.createChatCompletion([\n { role: 'system', content: 'You are a helpful assistant.' },\n { role: 'user', content: 'Hello!' }\n])\nconsole.log(response.choices[0]?.message?.content)"
+        }
+      ]
     },
-    "rpc": {
-      "description": "Call a Postgres function (RPC).",
+    "createResponse": {
+      "description": "Create a response using the Responses API.",
       "parameters": {
-        "fn": {
-          "type": "string",
-          "description": "The function name"
-        },
-        "params": {
-          "type": "Record<string, unknown>",
-          "description": "Arguments to pass to the function"
+        "input": {
+          "type": "OpenAI.Responses.ResponseInput | string",
+          "description": "The input prompt or message array"
         },
         "options": {
-          "type": "{ head?: boolean; get?: boolean; count?: \"exact\" | \"planned\" | \"estimated\" }",
-          "description": "Optional settings (head, get, count)"
+          "type": "Partial<OpenAI.Responses.ResponseCreateParamsNonStreaming>",
+          "description": "Additional parameters for the response"
         }
       },
       "required": [
-        "fn"
+        "input"
       ],
-      "returns": "void"
+      "returns": "Promise<OpenAI.Responses.Response>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const response = await openai.createResponse('Explain quantum computing')"
+        }
+      ]
     },
-    "signInWithPassword": {
-      "description": "Sign in with email and password.",
+    "streamResponse": {
+      "description": "Stream a response using the Responses API.",
       "parameters": {
-        "email": {
-          "type": "string",
-          "description": "Parameter email"
+        "input": {
+          "type": "OpenAI.Responses.ResponseInput | string",
+          "description": "The input prompt or message array"
         },
-        "password": {
-          "type": "string",
-          "description": "Parameter password"
+        "options": {
+          "type": "Partial<OpenAI.Responses.ResponseCreateParamsStreaming>",
+          "description": "Additional parameters for the streaming response"
         }
       },
       "required": [
-        "email",
-        "password"
+        "input"
       ],
-      "returns": "void"
+      "returns": "Promise<AsyncIterable<OpenAI.Responses.ResponseStreamEvent>>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const stream = await openai.streamResponse('Write a poem')\nfor await (const event of stream) {\n if (event.type === 'response.output_text.delta') {\n   process.stdout.write(event.delta)\n }\n}"
+        }
+      ]
     },
-    "signUp": {
-      "description": "Create a new user account with email and password.",
+    "createCompletion": {
+      "description": "Create a legacy text completion.",
       "parameters": {
-        "email": {
+        "prompt": {
           "type": "string",
-          "description": "Parameter email"
+          "description": "The text prompt to complete"
         },
-        "password": {
-          "type": "string",
-          "description": "Parameter password"
+        "options": {
+          "type": "Partial<OpenAI.Completions.CompletionCreateParams>",
+          "description": "Additional parameters for the completion"
         }
       },
       "required": [
-        "email",
-        "password"
+        "prompt"
       ],
-      "returns": "void"
-    },
-    "signOut": {
-      "description": "Sign the current user out.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "getSession": {
-      "description": "Get the current session, if any.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "getUser": {
-      "description": "Get the current user, if any.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
+      "returns": "Promise<OpenAI.Completions.Completion>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const response = await openai.createCompletion('Once upon a time')"
+        }
+      ]
     },
-    "invoke": {
-      "description": "Invoke a Supabase Edge Function by name.",
+    "createEmbedding": {
+      "description": "Create text embeddings for semantic search or similarity comparisons.",
       "parameters": {
-        "name": {
-          "type": "string",
-          "description": "Parameter name"
+        "input": {
+          "type": "string | string[]",
+          "description": "A string or array of strings to embed"
         },
-        "body": {
-          "type": "any",
-          "description": "Parameter body"
+        "options": {
+          "type": "Partial<OpenAI.Embeddings.EmbeddingCreateParams>",
+          "description": "Additional parameters (model, etc.)"
         }
       },
       "required": [
-        "name"
+        "input"
       ],
-      "returns": "void"
+      "returns": "Promise<OpenAI.Embeddings.CreateEmbeddingResponse>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const response = await openai.createEmbedding('Hello world')\nconsole.log(response.data[0].embedding.length)"
+        }
+      ]
     },
-    "subscribe": {
-      "description": "Subscribe to realtime changes on a Postgres table.",
+    "createImage": {
+      "description": "Generate an image from a text prompt using DALL-E.",
       "parameters": {
-        "channelName": {
-          "type": "string",
-          "description": "A name for this subscription channel"
-        },
-        "table": {
+        "prompt": {
           "type": "string",
-          "description": "The table to listen to"
-        },
-        "callback": {
-          "type": "(payload: any) => void",
-          "description": "Called with the payload on each change"
+          "description": "Description of the image to generate"
         },
-        "event": {
-          "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
-          "description": "The event type to listen for (default: all changes)"
+        "options": {
+          "type": "Partial<OpenAI.Images.ImageGenerateParams>",
+          "description": "Additional parameters (size, n, etc.)"
         }
       },
       "required": [
-        "channelName",
-        "table",
-        "callback"
+        "prompt"
       ],
-      "returns": "RealtimeChannel"
+      "returns": "Promise<OpenAI.Images.ImagesResponse>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const response = await openai.createImage('A sunset over mountains')\nconsole.log(response.data[0].url)"
+        }
+      ]
     },
-    "unsubscribe": {
-      "description": "Unsubscribe and remove a realtime channel by name.",
+    "listModels": {
+      "description": "List all available models.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<OpenAI.Models.ModelsPage>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const models = await openai.listModels()"
+        }
+      ]
+    },
+    "ask": {
+      "description": "Ask a single question and get a text response. Convenience wrapper around `createChatCompletion` for simple Q&A.",
       "parameters": {
-        "channelName": {
+        "question": {
           "type": "string",
-          "description": "The channel name to remove"
+          "description": "The question to ask"
+        },
+        "options": {
+          "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
+          "description": "Additional completion parameters"
         }
       },
       "required": [
-        "channelName"
+        "question"
       ],
-      "returns": "void"
-    },
-    "unsubscribeAll": {
-      "description": "Unsubscribe and remove all realtime channels.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "connect": {
-      "description": "Connect is a no-op since the Supabase SDK initializes on construction. The client is ready to use immediately after creation.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
+      "returns": "Promise<string>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const answer = await openai.ask('What is 2 + 2?')\nconsole.log(answer) // '4'"
+        }
+      ]
     },
-    "disconnect": {
-      "description": "Disconnect by signing out and removing all realtime channels.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
+    "chat": {
+      "description": "Send a multi-turn conversation and get a text response. Convenience wrapper around `createChatCompletion` that returns just the text.",
+      "parameters": {
+        "messages": {
+          "type": "OpenAI.Chat.Completions.ChatCompletionMessageParam[]",
+          "description": "Array of chat messages"
+        },
+        "options": {
+          "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
+          "description": "Additional completion parameters"
+        }
+      },
+      "required": [
+        "messages"
+      ],
+      "returns": "Promise<string>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const reply = await openai.chat([\n { role: 'system', content: 'You are a pirate.' },\n { role: 'user', content: 'Hello!' }\n])"
+        }
+      ]
     }
   },
   "getters": {
-    "sdk": {
-      "description": "Returns the raw Supabase SDK client for full access to all SDK methods.",
-      "returns": "SupabaseSDKClient<any, any>"
+    "defaultModel": {
+      "description": "The default model used for completions, from options or 'gpt-4o'.",
+      "returns": "string"
     },
-    "storage": {
-      "description": "Returns the Supabase Storage client for managing buckets and files.",
-      "returns": "any"
+    "raw": {
+      "description": "The underlying OpenAI SDK instance for advanced use cases.",
+      "returns": "OpenAI"
+    }
+  },
+  "events": {
+    "connected": {
+      "name": "connected",
+      "description": "Event emitted by OpenAIClient",
+      "arguments": {}
     },
-    "functions": {
-      "description": "Returns the Supabase Functions client.",
-      "returns": "any"
+    "failure": {
+      "name": "failure",
+      "description": "Event emitted by OpenAIClient",
+      "arguments": {}
+    },
+    "completion": {
+      "name": "completion",
+      "description": "Event emitted by OpenAIClient",
+      "arguments": {}
+    },
+    "embedding": {
+      "name": "embedding",
+      "description": "Event emitted by OpenAIClient",
+      "arguments": {}
+    },
+    "image": {
+      "name": "image",
+      "description": "Event emitted by OpenAIClient",
+      "arguments": {}
+    },
+    "models": {
+      "name": "models",
+      "description": "Event emitted by OpenAIClient",
+      "arguments": {}
     }
   },
-  "events": {},
   "state": {},
   "options": {},
   "envVars": [],
   "examples": [
     {
       "language": "ts",
-      "code": "const supabase = container.client('supabase', {\n supabaseUrl: 'https://xyz.supabase.co',\n supabaseKey: 'your-anon-key',\n})\n\n// Query data\nconst { data } = await supabase.from('users').select('*')\n\n// Auth\nawait supabase.signInWithPassword('user@example.com', 'password')\n\n// Realtime\nsupabase.subscribe('changes', 'users', (payload) => {\n console.log('Change:', payload)\n})"
+      "code": "const openai = container.client('openai', { defaultModel: 'gpt-4o' })\nconst answer = await openai.ask('What is the meaning of life?')\nconsole.log(answer)"
     }
   ]
 });
@@ -9917,512 +9989,440 @@ 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[] }>"
-    },
-    "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>"
+      "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})"
     }
   ]
 });
 
-setBuildTimeData('clients.openai', {
-  "id": "clients.openai",
-  "description": "OpenAI client — wraps the OpenAI SDK for chat completions, responses API, embeddings, and image generation. Provides convenience methods for common operations while tracking token usage and request counts. Supports both the Chat Completions API and the newer Responses API.",
-  "shortcut": "clients.openai",
-  "className": "OpenAIClient",
+setBuildTimeData('clients.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": {
-    "connect": {
-      "description": "Test the API connection by listing models.",
-      "parameters": {},
-      "required": [],
-      "returns": "Promise<this>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "await openai.connect()"
-        }
-      ]
-    },
-    "createChatCompletion": {
-      "description": "Create a chat completion using the Chat Completions API.",
-      "parameters": {
-        "messages": {
-          "type": "OpenAI.Chat.Completions.ChatCompletionMessageParam[]",
-          "description": "Array of chat messages"
-        },
-        "options": {
-          "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
-          "description": "Additional parameters for the completion"
-        }
-      },
-      "required": [
-        "messages"
-      ],
-      "returns": "Promise<OpenAI.Chat.Completions.ChatCompletion>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const response = await openai.createChatCompletion([\n { role: 'system', content: 'You are a helpful assistant.' },\n { role: 'user', content: 'Hello!' }\n])\nconsole.log(response.choices[0]?.message?.content)"
-        }
-      ]
-    },
-    "createResponse": {
-      "description": "Create a response using the Responses API.",
+    "queuePrompt": {
+      "description": "Queue a prompt (API-format workflow) for execution.",
       "parameters": {
-        "input": {
-          "type": "OpenAI.Responses.ResponseInput | string",
-          "description": "The input prompt or message array"
-        },
-        "options": {
-          "type": "Partial<OpenAI.Responses.ResponseCreateParamsNonStreaming>",
-          "description": "Additional parameters for the response"
+        "prompt": {
+          "type": "Record<string, any>",
+          "description": "The API-format workflow object"
+        },
+        "clientId": {
+          "type": "string",
+          "description": "Override the client ID for this request"
         }
       },
       "required": [
-        "input"
+        "prompt"
       ],
-      "returns": "Promise<OpenAI.Responses.Response>",
+      "returns": "Promise<{ prompt_id: string; number: number }>",
       "examples": [
         {
           "language": "ts",
-          "code": "const response = await openai.createResponse('Explain quantum computing')"
+          "code": "const { prompt_id } = await comfy.queuePrompt(apiWorkflow)"
         }
       ]
     },
-    "streamResponse": {
-      "description": "Stream a response using the Responses API.",
+    "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": {
-        "input": {
-          "type": "OpenAI.Responses.ResponseInput | string",
-          "description": "The input prompt or message array"
-        },
-        "options": {
-          "type": "Partial<OpenAI.Responses.ResponseCreateParamsStreaming>",
-          "description": "Additional parameters for the streaming response"
+        "promptId": {
+          "type": "string",
+          "description": "If provided, returns history for this prompt only"
         }
       },
-      "required": [
-        "input"
-      ],
-      "returns": "Promise<AsyncIterable<OpenAI.Responses.ResponseStreamEvent>>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const stream = await openai.streamResponse('Write a poem')\nfor await (const event of stream) {\n if (event.type === 'response.output_text.delta') {\n   process.stdout.write(event.delta)\n }\n}"
-        }
-      ]
+      "required": [],
+      "returns": "Promise<Record<string, any>>"
     },
-    "createCompletion": {
-      "description": "Create a legacy text completion.",
+    "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": {
-        "prompt": {
+        "nodeClass": {
           "type": "string",
-          "description": "The text prompt to complete"
-        },
-        "options": {
-          "type": "Partial<OpenAI.Completions.CompletionCreateParams>",
-          "description": "Additional parameters for the completion"
+          "description": "If provided, returns info for this node type only"
         }
       },
-      "required": [
-        "prompt"
-      ],
-      "returns": "Promise<OpenAI.Completions.Completion>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const response = await openai.createCompletion('Once upon a time')"
+      "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[]>"
     },
-    "createEmbedding": {
-      "description": "Create text embeddings for semantic search or similarity comparisons.",
+    "getEmbeddings": {
+      "description": "List available embedding models.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<string[]>"
+    },
+    "uploadImage": {
+      "description": "Upload an image to ComfyUI's input directory.",
       "parameters": {
-        "input": {
-          "type": "string | string[]",
-          "description": "A string or array of strings to embed"
+        "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": {}
     }
   },
@@ -10432,7 +10432,7 @@ setBuildTimeData('clients.openai', {
   "examples": [
     {
       "language": "ts",
-      "code": "const openai = container.client('openai', { defaultModel: 'gpt-4o' })\nconst answer = await openai.ask('What is the meaning of life?')\nconsole.log(answer)"
+      "code": "const 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)"
     }
   ]
 });
@@ -11980,6 +11980,10 @@ setBuildTimeData('features.claudeCode', {
             "settingsFile": {
               "type": "string",
               "description": "Path to a custom settings file."
+            },
+            "chrome": {
+              "type": "boolean",
+              "description": "Launch Claude Code with a Chrome browser tool."
             }
           }
         }
@@ -12129,6 +12133,10 @@ setBuildTimeData('features.claudeCode', {
             "settingsFile": {
               "type": "string",
               "description": "Path to a custom settings file."
+            },
+            "chrome": {
+              "type": "boolean",
+              "description": "Launch Claude Code with a Chrome browser tool."
             }
           }
         }
@@ -22978,197 +22986,269 @@ 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",
+    "id": "clients.openai",
+    "description": "OpenAI client — wraps the OpenAI SDK for chat completions, responses API, embeddings, and image generation. Provides convenience methods for common operations while tracking token usage and request counts. Supports both the Chat Completions API and the newer Responses API.",
+    "shortcut": "clients.openai",
+    "className": "OpenAIClient",
     "methods": {
-      "from": {
-        "description": "Start a query on a Postgres table or view.",
+      "connect": {
+        "description": "Test the API connection by listing models.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<this>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "await openai.connect()"
+          }
+        ]
+      },
+      "createChatCompletion": {
+        "description": "Create a chat completion using the Chat Completions API.",
         "parameters": {
-          "table": {
-            "type": "string",
-            "description": "The table or view name to query"
+          "messages": {
+            "type": "OpenAI.Chat.Completions.ChatCompletionMessageParam[]",
+            "description": "Array of chat messages"
+          },
+          "options": {
+            "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
+            "description": "Additional parameters for the completion"
           }
         },
         "required": [
-          "table"
+          "messages"
         ],
-        "returns": "void"
+        "returns": "Promise<OpenAI.Chat.Completions.ChatCompletion>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const response = await openai.createChatCompletion([\n { role: 'system', content: 'You are a helpful assistant.' },\n { role: 'user', content: 'Hello!' }\n])\nconsole.log(response.choices[0]?.message?.content)"
+          }
+        ]
       },
-      "rpc": {
-        "description": "Call a Postgres function (RPC).",
+      "createResponse": {
+        "description": "Create a response using the Responses API.",
         "parameters": {
-          "fn": {
-            "type": "string",
-            "description": "The function name"
-          },
-          "params": {
-            "type": "Record<string, unknown>",
-            "description": "Arguments to pass to the function"
+          "input": {
+            "type": "OpenAI.Responses.ResponseInput | string",
+            "description": "The input prompt or message array"
           },
           "options": {
-            "type": "{ head?: boolean; get?: boolean; count?: \"exact\" | \"planned\" | \"estimated\" }",
-            "description": "Optional settings (head, get, count)"
+            "type": "Partial<OpenAI.Responses.ResponseCreateParamsNonStreaming>",
+            "description": "Additional parameters for the response"
           }
         },
         "required": [
-          "fn"
+          "input"
         ],
-        "returns": "void"
+        "returns": "Promise<OpenAI.Responses.Response>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const response = await openai.createResponse('Explain quantum computing')"
+          }
+        ]
       },
-      "signInWithPassword": {
-        "description": "Sign in with email and password.",
+      "streamResponse": {
+        "description": "Stream a response using the Responses API.",
         "parameters": {
-          "email": {
-            "type": "string",
-            "description": "Parameter email"
+          "input": {
+            "type": "OpenAI.Responses.ResponseInput | string",
+            "description": "The input prompt or message array"
           },
-          "password": {
-            "type": "string",
-            "description": "Parameter password"
+          "options": {
+            "type": "Partial<OpenAI.Responses.ResponseCreateParamsStreaming>",
+            "description": "Additional parameters for the streaming response"
           }
         },
         "required": [
-          "email",
-          "password"
+          "input"
         ],
-        "returns": "void"
+        "returns": "Promise<AsyncIterable<OpenAI.Responses.ResponseStreamEvent>>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const stream = await openai.streamResponse('Write a poem')\nfor await (const event of stream) {\n if (event.type === 'response.output_text.delta') {\n   process.stdout.write(event.delta)\n }\n}"
+          }
+        ]
       },
-      "signUp": {
-        "description": "Create a new user account with email and password.",
+      "createCompletion": {
+        "description": "Create a legacy text completion.",
         "parameters": {
-          "email": {
+          "prompt": {
             "type": "string",
-            "description": "Parameter email"
+            "description": "The text prompt to complete"
           },
-          "password": {
-            "type": "string",
-            "description": "Parameter password"
+          "options": {
+            "type": "Partial<OpenAI.Completions.CompletionCreateParams>",
+            "description": "Additional parameters for the completion"
           }
         },
         "required": [
-          "email",
-          "password"
+          "prompt"
         ],
-        "returns": "void"
-      },
-      "signOut": {
-        "description": "Sign the current user out.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "getSession": {
-        "description": "Get the current session, if any.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "getUser": {
-        "description": "Get the current user, if any.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
+        "returns": "Promise<OpenAI.Completions.Completion>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const response = await openai.createCompletion('Once upon a time')"
+          }
+        ]
       },
-      "invoke": {
-        "description": "Invoke a Supabase Edge Function by name.",
+      "createEmbedding": {
+        "description": "Create text embeddings for semantic search or similarity comparisons.",
         "parameters": {
-          "name": {
-            "type": "string",
-            "description": "Parameter name"
+          "input": {
+            "type": "string | string[]",
+            "description": "A string or array of strings to embed"
           },
-          "body": {
-            "type": "any",
-            "description": "Parameter body"
+          "options": {
+            "type": "Partial<OpenAI.Embeddings.EmbeddingCreateParams>",
+            "description": "Additional parameters (model, etc.)"
           }
         },
         "required": [
-          "name"
+          "input"
         ],
-        "returns": "void"
+        "returns": "Promise<OpenAI.Embeddings.CreateEmbeddingResponse>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const response = await openai.createEmbedding('Hello world')\nconsole.log(response.data[0].embedding.length)"
+          }
+        ]
       },
-      "subscribe": {
-        "description": "Subscribe to realtime changes on a Postgres table.",
+      "createImage": {
+        "description": "Generate an image from a text prompt using DALL-E.",
         "parameters": {
-          "channelName": {
+          "prompt": {
             "type": "string",
-            "description": "A name for this subscription channel"
+            "description": "Description of the image to generate"
           },
-          "table": {
+          "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 table to listen to"
-          },
-          "callback": {
-            "type": "(payload: any) => void",
-            "description": "Called with the payload on each change"
+            "description": "The question to ask"
           },
-          "event": {
-            "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
-            "description": "The event type to listen for (default: all changes)"
+          "options": {
+            "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
+            "description": "Additional completion parameters"
           }
         },
         "required": [
-          "channelName",
-          "table",
-          "callback"
+          "question"
         ],
-        "returns": "RealtimeChannel"
+        "returns": "Promise<string>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const answer = await openai.ask('What is 2 + 2?')\nconsole.log(answer) // '4'"
+          }
+        ]
       },
-      "unsubscribe": {
-        "description": "Unsubscribe and remove a realtime channel by name.",
+      "chat": {
+        "description": "Send a multi-turn conversation and get a text response. Convenience wrapper around `createChatCompletion` that returns just the text.",
         "parameters": {
-          "channelName": {
-            "type": "string",
-            "description": "The channel name to remove"
+          "messages": {
+            "type": "OpenAI.Chat.Completions.ChatCompletionMessageParam[]",
+            "description": "Array of chat messages"
+          },
+          "options": {
+            "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
+            "description": "Additional completion parameters"
           }
         },
         "required": [
-          "channelName"
+          "messages"
         ],
-        "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"
+        "returns": "Promise<string>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const reply = await openai.chat([\n { role: 'system', content: 'You are a pirate.' },\n { role: 'user', content: 'Hello!' }\n])"
+          }
+        ]
       }
     },
     "getters": {
-      "sdk": {
-        "description": "Returns the raw Supabase SDK client for full access to all SDK methods.",
-        "returns": "SupabaseSDKClient<any, any>"
+      "defaultModel": {
+        "description": "The default model used for completions, from options or 'gpt-4o'.",
+        "returns": "string"
       },
-      "storage": {
-        "description": "Returns the Supabase Storage client for managing buckets and files.",
-        "returns": "any"
+      "raw": {
+        "description": "The underlying OpenAI SDK instance for advanced use cases.",
+        "returns": "OpenAI"
+      }
+    },
+    "events": {
+      "connected": {
+        "name": "connected",
+        "description": "Event emitted by OpenAIClient",
+        "arguments": {}
       },
-      "functions": {
-        "description": "Returns the Supabase Functions client.",
-        "returns": "any"
+      "failure": {
+        "name": "failure",
+        "description": "Event emitted by OpenAIClient",
+        "arguments": {}
+      },
+      "completion": {
+        "name": "completion",
+        "description": "Event emitted by OpenAIClient",
+        "arguments": {}
+      },
+      "embedding": {
+        "name": "embedding",
+        "description": "Event emitted by OpenAIClient",
+        "arguments": {}
+      },
+      "image": {
+        "name": "image",
+        "description": "Event emitted by OpenAIClient",
+        "arguments": {}
+      },
+      "models": {
+        "name": "models",
+        "description": "Event emitted by OpenAIClient",
+        "arguments": {}
       }
     },
-    "events": {},
     "state": {},
     "options": {},
     "envVars": [],
     "examples": [
       {
         "language": "ts",
-        "code": "const supabase = container.client('supabase', {\n supabaseUrl: 'https://xyz.supabase.co',\n supabaseKey: 'your-anon-key',\n})\n\n// Query data\nconst { data } = await supabase.from('users').select('*')\n\n// Auth\nawait supabase.signInWithPassword('user@example.com', 'password')\n\n// Realtime\nsupabase.subscribe('changes', 'users', (payload) => {\n console.log('Change:', payload)\n})"
+        "code": "const openai = container.client('openai', { defaultModel: 'gpt-4o' })\nconst answer = await openai.ask('What is the meaning of life?')\nconsole.log(answer)"
       }
     ]
   },
@@ -23374,510 +23454,438 @@ 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.",
+      "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[] }>"
-      },
-      "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>"
+        "returns": "void"
       },
-      "getObjectInfo": {
-        "description": "Get node type info with input/output schemas.",
+      "rpc": {
+        "description": "Call a Postgres function (RPC).",
         "parameters": {
-          "nodeClass": {
+          "fn": {
             "type": "string",
-            "description": "If provided, returns info for this node type 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<any>"
-      },
-      "interrupt": {
-        "description": "Interrupt the currently executing prompt.",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<void>"
+        "required": [
+          "fn"
+        ],
+        "returns": "void"
       },
-      "getModels": {
-        "description": "List available models, optionally filtered by type.",
+      "signInWithPassword": {
+        "description": "Sign in with email and password.",
         "parameters": {
-          "type": {
+          "email": {
             "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"
+            "description": "Parameter email"
           },
-          "filename": {
+          "password": {
             "type": "string",
-            "description": "File name for the upload"
-          },
-          "opts": {
-            "type": "{ subfolder?: string; type?: string; overwrite?: boolean }",
-            "description": "Upload options (subfolder, type, overwrite)"
+            "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"
+      },
+      "signOut": {
+        "description": "Sign the current user out.",
+        "parameters": {},
+        "required": [],
+        "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`.",
+      "getSession": {
+        "description": "Get the current session, if any.",
         "parameters": {},
         "required": [],
-        "returns": "Promise<void>"
+        "returns": "void"
       },
-      "disconnectWs": {
-        "description": "Close the WebSocket connection.",
+      "getUser": {
+        "description": "Get the current user, 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.",
+      "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})"
       }
     ]
   },
   {
-    "id": "clients.openai",
-    "description": "OpenAI client — wraps the OpenAI SDK for chat completions, responses API, embeddings, and image generation. Provides convenience methods for common operations while tracking token usage and request counts. Supports both the Chat Completions API and the newer Responses API.",
-    "shortcut": "clients.openai",
-    "className": "OpenAIClient",
+    "id": "clients.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": {
-      "connect": {
-        "description": "Test the API connection by listing models.",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<this>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "await openai.connect()"
-          }
-        ]
-      },
-      "createChatCompletion": {
-        "description": "Create a chat completion using the Chat Completions API.",
+      "queuePrompt": {
+        "description": "Queue a prompt (API-format workflow) for execution.",
         "parameters": {
-          "messages": {
-            "type": "OpenAI.Chat.Completions.ChatCompletionMessageParam[]",
-            "description": "Array of chat messages"
+          "prompt": {
+            "type": "Record<string, any>",
+            "description": "The API-format workflow object"
           },
-          "options": {
-            "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
-            "description": "Additional parameters for the completion"
+          "clientId": {
+            "type": "string",
+            "description": "Override the client ID for this request"
           }
         },
         "required": [
-          "messages"
+          "prompt"
         ],
-        "returns": "Promise<OpenAI.Chat.Completions.ChatCompletion>",
+        "returns": "Promise<{ prompt_id: string; number: number }>",
         "examples": [
           {
             "language": "ts",
-            "code": "const response = await openai.createChatCompletion([\n { role: 'system', content: 'You are a helpful assistant.' },\n { role: 'user', content: 'Hello!' }\n])\nconsole.log(response.choices[0]?.message?.content)"
+            "code": "const { prompt_id } = await comfy.queuePrompt(apiWorkflow)"
           }
         ]
       },
-      "createResponse": {
-        "description": "Create a response using the Responses API.",
+      "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": {
-          "input": {
-            "type": "OpenAI.Responses.ResponseInput | string",
-            "description": "The input prompt or message array"
-          },
-          "options": {
-            "type": "Partial<OpenAI.Responses.ResponseCreateParamsNonStreaming>",
-            "description": "Additional parameters for the response"
+          "promptId": {
+            "type": "string",
+            "description": "If provided, returns history for this prompt only"
           }
         },
-        "required": [
-          "input"
-        ],
-        "returns": "Promise<OpenAI.Responses.Response>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const response = await openai.createResponse('Explain quantum computing')"
-          }
-        ]
+        "required": [],
+        "returns": "Promise<Record<string, any>>"
       },
-      "streamResponse": {
-        "description": "Stream a response using the Responses API.",
-        "parameters": {
-          "input": {
-            "type": "OpenAI.Responses.ResponseInput | string",
-            "description": "The input prompt or message array"
-          },
-          "options": {
-            "type": "Partial<OpenAI.Responses.ResponseCreateParamsStreaming>",
-            "description": "Additional parameters for the streaming response"
+      "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": [
-          "input"
-        ],
-        "returns": "Promise<AsyncIterable<OpenAI.Responses.ResponseStreamEvent>>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const stream = await openai.streamResponse('Write a poem')\nfor await (const event of stream) {\n if (event.type === 'response.output_text.delta') {\n   process.stdout.write(event.delta)\n }\n}"
-          }
-        ]
+        "required": [],
+        "returns": "Promise<any>"
       },
-      "createCompletion": {
-        "description": "Create a legacy text completion.",
+      "interrupt": {
+        "description": "Interrupt the currently executing prompt.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<void>"
+      },
+      "getModels": {
+        "description": "List available models, optionally filtered by type.",
         "parameters": {
-          "prompt": {
+          "type": {
             "type": "string",
-            "description": "The text prompt to complete"
-          },
-          "options": {
-            "type": "Partial<OpenAI.Completions.CompletionCreateParams>",
-            "description": "Additional parameters for the completion"
+            "description": "Model type filter (e.g., 'checkpoints', 'loras')"
           }
         },
-        "required": [
-          "prompt"
-        ],
-        "returns": "Promise<OpenAI.Completions.Completion>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const response = await openai.createCompletion('Once upon a time')"
-          }
-        ]
+        "required": [],
+        "returns": "Promise<string[]>"
       },
-      "createEmbedding": {
-        "description": "Create text embeddings for semantic search or similarity comparisons.",
+      "getEmbeddings": {
+        "description": "List available embedding models.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<string[]>"
+      },
+      "uploadImage": {
+        "description": "Upload an image to ComfyUI's input directory.",
         "parameters": {
-          "input": {
-            "type": "string | string[]",
-            "description": "A string or array of strings to embed"
+          "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": {}
       }
     },
@@ -23887,7 +23895,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)"
       }
     ]
   },
@@ -25426,6 +25434,10 @@ export const introspectionData = [
               "settingsFile": {
                 "type": "string",
                 "description": "Path to a custom settings file."
+              },
+              "chrome": {
+                "type": "boolean",
+                "description": "Launch Claude Code with a Chrome browser tool."
               }
             }
           }
@@ -25575,6 +25587,10 @@ export const introspectionData = [
               "settingsFile": {
                 "type": "string",
                 "description": "Path to a custom settings file."
+              },
+              "chrome": {
+                "type": "boolean",
+                "description": "Launch Claude Code with a Chrome browser tool."
               }
             }
           }