@soederpop/luca 0.0.23 → 0.0.26

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-21T15:48:33.144Z
+// Generated at: 2026-03-22T20:57:23.197Z
 
 setBuildTimeData('features.googleDocs', {
   "id": "features.googleDocs",
@@ -729,6 +729,25 @@ setBuildTimeData('features.git', {
         }
       ]
     },
+    "extractFolder": {
+      "description": "Extracts a folder (or entire repo) from a remote GitHub repository without cloning. Downloads the repo as a tarball and extracts only the specified subfolder, similar to how degit works. No .git history is included — just the files. Supports shorthand (`user/repo/path`), branch refs (`user/repo/path#branch`), and full GitHub URLs (`https://github.com/user/repo/tree/branch/path`).",
+      "parameters": {
+        "{ source, destination, branch }": {
+          "type": "{ source: string, destination: string, branch?: string }",
+          "description": "Parameter { source, destination, branch }"
+        }
+      },
+      "required": [
+        "{ source, destination, branch }"
+      ],
+      "returns": "void",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "// Extract a subfolder\nawait git.extractFolder({ source: 'soederpop/luca/src/assistants', destination: './my-assistants' })\n\n// Specific branch\nawait git.extractFolder({ source: 'sveltejs/template', destination: './my-app', branch: 'main' })\n\n// Full GitHub URL\nawait git.extractFolder({ source: 'https://github.com/user/repo/tree/main/examples', destination: './examples' })"
+        }
+      ]
+    },
     "getChangeHistoryForFiles": {
       "description": "Gets the commit history for a set of files or glob patterns. Accepts absolute paths, relative paths (resolved from container.cwd), or glob patterns. Returns commits that touched any of the matched files, with each entry noting which of your queried files were in that commit.",
       "parameters": {
@@ -2299,6 +2318,29 @@ setBuildTimeData('features.vm', {
       ],
       "returns": "Promise<T>"
     },
+    "runCaptured": {
+      "description": "Execute code and capture all console output as structured JSON. Returns both the execution result and an array of every `console.*` call made during execution, each entry recording the method name and arguments.",
+      "parameters": {
+        "code": {
+          "type": "string",
+          "description": "The JavaScript code to execute"
+        },
+        "ctx": {
+          "type": "any",
+          "description": "Context variables to make available to the executing code"
+        }
+      },
+      "required": [
+        "code"
+      ],
+      "returns": "Promise<{\n    result: T\n    console: Array<{ method: string, args: any[] }>\n    context: vm.Context\n  }>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const { result, console: calls } = await vm.runCaptured('console.log(\"hi\"); console.warn(\"oh\"); 42')\n// result === 42\n// calls === [{ method: 'log', args: ['hi'] }, { method: 'warn', args: ['oh'] }]"
+        }
+      ]
+    },
     "runSync": {
       "description": "Execute JavaScript code synchronously in a controlled environment.",
       "parameters": {
@@ -5256,6 +5298,23 @@ setBuildTimeData('features.fs', {
         }
       ]
     },
+    "readFileSync": {
+      "description": "Synchronously reads a file and returns its contents as a string. added this method because AI Assistants are understandly confused by this deviation from 2000's era node style",
+      "parameters": {
+        "path": {
+          "type": "string",
+          "description": "Parameter path"
+        },
+        "encoding": {
+          "type": "BufferEncoding | null",
+          "description": "Parameter encoding"
+        }
+      },
+      "required": [
+        "path"
+      ],
+      "returns": "string | Buffer"
+    },
     "readFileAsync": {
       "description": "Asynchronously reads a file and returns its contents as a string.",
       "parameters": {
@@ -5298,6 +5357,19 @@ setBuildTimeData('features.fs', {
         }
       ]
     },
+    "readJsonSync": {
+      "description": "Read and parse a JSON file synchronously",
+      "parameters": {
+        "path": {
+          "type": "string",
+          "description": "Parameter path"
+        }
+      },
+      "required": [
+        "path"
+      ],
+      "returns": "void"
+    },
     "readJsonAsync": {
       "description": "Asynchronously reads and parses a JSON file.",
       "parameters": {
@@ -9101,6 +9173,30 @@ setBuildTimeData('features.contentDb', {
   "shortcut": "features.contentDb",
   "className": "ContentDb",
   "methods": {
+    "renderTree": {
+      "description": "Render a tree view of the collection directory structure. Built with container.fs so it works without the `tree` binary.",
+      "parameters": {
+        "options": {
+          "type": "{ depth?: number; dirsOnly?: boolean }",
+          "description": "Parameter options"
+        }
+      },
+      "required": [],
+      "returns": "string"
+    },
+    "grep": {
+      "description": "",
+      "parameters": {
+        "options": {
+          "type": "string | GrepOptions",
+          "description": "Parameter options"
+        }
+      },
+      "required": [
+        "options"
+      ],
+      "returns": "void"
+    },
     "query": {
       "description": "Query documents belonging to a specific model definition.",
       "parameters": {
@@ -9318,6 +9414,90 @@ setBuildTimeData('features.contentDb', {
       },
       "required": [],
       "returns": "void"
+    },
+    "getCollectionOverview": {
+      "description": "Returns a high-level overview of the collection.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "listDocuments": {
+      "description": "List document IDs, optionally filtered by model or glob.",
+      "parameters": {
+        "args": {
+          "type": "{ model?: string; glob?: string }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "void"
+    },
+    "readDocument": {
+      "description": "Read a single document with optional section filtering.",
+      "parameters": {
+        "args": {
+          "type": "{ id: string; include?: string[]; exclude?: string[]; meta?: boolean }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "void"
+    },
+    "readMultipleDocuments": {
+      "description": "Read multiple documents with optional section filtering.",
+      "parameters": {
+        "args": {
+          "type": "{ ids: string[]; include?: string[]; exclude?: string[]; meta?: boolean }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "void"
+    },
+    "queryDocuments": {
+      "description": "Query documents by model with filters, sort, limit.",
+      "parameters": {
+        "args": {
+          "type": "{ model: string; where?: string; sort?: string; limit?: number; offset?: number; select?: string[] }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "void"
+    },
+    "searchContent": {
+      "description": "Grep/text search across the collection.",
+      "parameters": {
+        "args": {
+          "type": "{ pattern: string; caseSensitive?: boolean }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "void"
+    },
+    "semanticSearch": {
+      "description": "Hybrid semantic search with graceful fallback to grep.",
+      "parameters": {
+        "args": {
+          "type": "{ query: string; limit?: number }",
+          "description": "Parameter args"
+        }
+      },
+      "required": [
+        "args"
+      ],
+      "returns": "void"
     }
   },
   "getters": {
@@ -9341,6 +9521,18 @@ setBuildTimeData('features.contentDb', {
       "description": "Returns an array of all registered model names from the collection.",
       "returns": "string[]"
     },
+    "available": {
+      "description": "Returns the available document ids in the collection",
+      "returns": "string[]"
+    },
+    "modelDefinitionTable": {
+      "description": "",
+      "returns": "any"
+    },
+    "fileTree": {
+      "description": "",
+      "returns": "any"
+    },
     "searchIndexStatus": {
       "description": "Get the current search index status.",
       "returns": "any"
@@ -9687,466 +9879,466 @@ 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"
-    },
-    "unsubscribe": {
-      "description": "Unsubscribe and remove a realtime channel by name.",
-      "parameters": {
-        "channelName": {
-          "type": "string",
-          "description": "The channel name to remove"
+      "returns": "Promise<OpenAI.Images.ImagesResponse>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const response = await openai.createImage('A sunset over mountains')\nconsole.log(response.data[0].url)"
         }
-      },
-      "required": [
-        "channelName"
-      ],
-      "returns": "void"
-    },
-    "unsubscribeAll": {
-      "description": "Unsubscribe and remove all realtime channels.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "connect": {
-      "description": "Connect is a no-op since the Supabase SDK initializes on construction. The client is ready to use immediately after creation.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    },
-    "disconnect": {
-      "description": "Disconnect by signing out and removing all realtime channels.",
-      "parameters": {},
-      "required": [],
-      "returns": "void"
-    }
-  },
-  "getters": {
-    "sdk": {
-      "description": "Returns the raw Supabase SDK client for full access to all SDK methods.",
-      "returns": "SupabaseSDKClient<any, any>"
-    },
-    "storage": {
-      "description": "Returns the Supabase Storage client for managing buckets and files.",
-      "returns": "any"
+      ]
     },
-    "functions": {
-      "description": "Returns the Supabase Functions client.",
-      "returns": "any"
-    }
-  },
-  "events": {},
-  "state": {},
-  "options": {},
-  "envVars": [],
-  "examples": [
-    {
-      "language": "ts",
-      "code": "const supabase = container.client('supabase', {\n supabaseUrl: 'https://xyz.supabase.co',\n supabaseKey: 'your-anon-key',\n})\n\n// Query data\nconst { data } = await supabase.from('users').select('*')\n\n// Auth\nawait supabase.signInWithPassword('user@example.com', 'password')\n\n// Realtime\nsupabase.subscribe('changes', 'users', (payload) => {\n console.log('Change:', payload)\n})"
-    }
-  ]
-});
-
-setBuildTimeData('clients.openai', {
-  "id": "clients.openai",
-  "description": "OpenAI client — wraps the OpenAI SDK for chat completions, responses API, embeddings, and image generation. Provides convenience methods for common operations while tracking token usage and request counts. Supports both the Chat Completions API and the newer Responses API.",
-  "shortcut": "clients.openai",
-  "className": "OpenAIClient",
-  "methods": {
-    "connect": {
-      "description": "Test the API connection by listing models.",
+    "listModels": {
+      "description": "List all available models.",
       "parameters": {},
       "required": [],
-      "returns": "Promise<this>",
+      "returns": "Promise<OpenAI.Models.ModelsPage>",
       "examples": [
         {
           "language": "ts",
-          "code": "await openai.connect()"
+          "code": "const models = await openai.listModels()"
         }
       ]
     },
-    "createChatCompletion": {
-      "description": "Create a chat completion using the Chat Completions API.",
+    "ask": {
+      "description": "Ask a single question and get a text response. Convenience wrapper around `createChatCompletion` for simple Q&A.",
       "parameters": {
-        "messages": {
-          "type": "OpenAI.Chat.Completions.ChatCompletionMessageParam[]",
-          "description": "Array of chat messages"
+        "question": {
+          "type": "string",
+          "description": "The question to ask"
         },
         "options": {
           "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
-          "description": "Additional parameters for the completion"
+          "description": "Additional completion parameters"
         }
       },
       "required": [
-        "messages"
+        "question"
       ],
-      "returns": "Promise<OpenAI.Chat.Completions.ChatCompletion>",
+      "returns": "Promise<string>",
       "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 answer = await openai.ask('What is 2 + 2?')\nconsole.log(answer) // '4'"
         }
       ]
     },
-    "createResponse": {
-      "description": "Create a response using the Responses API.",
+    "chat": {
+      "description": "Send a multi-turn conversation and get a text response. Convenience wrapper around `createChatCompletion` that returns just the text.",
       "parameters": {
-        "input": {
-          "type": "OpenAI.Responses.ResponseInput | string",
-          "description": "The input prompt or message array"
+        "messages": {
+          "type": "OpenAI.Chat.Completions.ChatCompletionMessageParam[]",
+          "description": "Array of chat messages"
         },
         "options": {
-          "type": "Partial<OpenAI.Responses.ResponseCreateParamsNonStreaming>",
-          "description": "Additional parameters for the response"
+          "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
+          "description": "Additional completion parameters"
         }
       },
       "required": [
-        "input"
+        "messages"
       ],
-      "returns": "Promise<OpenAI.Responses.Response>",
+      "returns": "Promise<string>",
       "examples": [
         {
           "language": "ts",
-          "code": "const response = await openai.createResponse('Explain quantum computing')"
+          "code": "const reply = await openai.chat([\n { role: 'system', content: 'You are a pirate.' },\n { role: 'user', content: 'Hello!' }\n])"
         }
       ]
+    }
+  },
+  "getters": {
+    "defaultModel": {
+      "description": "The default model used for completions, from options or 'gpt-4o'.",
+      "returns": "string"
     },
-    "streamResponse": {
-      "description": "Stream a response using the Responses API.",
+    "raw": {
+      "description": "The underlying OpenAI SDK instance for advanced use cases.",
+      "returns": "OpenAI"
+    }
+  },
+  "events": {
+    "connected": {
+      "name": "connected",
+      "description": "Event emitted by OpenAIClient",
+      "arguments": {}
+    },
+    "failure": {
+      "name": "failure",
+      "description": "Event emitted by OpenAIClient",
+      "arguments": {}
+    },
+    "completion": {
+      "name": "completion",
+      "description": "Event emitted by OpenAIClient",
+      "arguments": {}
+    },
+    "embedding": {
+      "name": "embedding",
+      "description": "Event emitted by OpenAIClient",
+      "arguments": {}
+    },
+    "image": {
+      "name": "image",
+      "description": "Event emitted by OpenAIClient",
+      "arguments": {}
+    },
+    "models": {
+      "name": "models",
+      "description": "Event emitted by OpenAIClient",
+      "arguments": {}
+    }
+  },
+  "state": {},
+  "options": {},
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const openai = container.client('openai', { defaultModel: 'gpt-4o' })\nconst answer = await openai.ask('What is the meaning of life?')\nconsole.log(answer)"
+    }
+  ]
+});
+
+setBuildTimeData('clients.supabase', {
+  "id": "clients.supabase",
+  "description": "Supabase client for the Luca container system. Wraps the official `@supabase/supabase-js` SDK and exposes it through Luca's typed state, events, and introspection system. The SDK is isomorphic so this single implementation works in both Node and browser containers. Use `client.sdk` for full SDK access, or use the convenience wrappers for common operations (auth, database queries, storage, edge functions, realtime).",
+  "shortcut": "clients.supabase",
+  "className": "SupabaseClient",
+  "methods": {
+    "from": {
+      "description": "Start a query on a Postgres table or view.",
       "parameters": {
-        "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"
+        "table": {
+          "type": "string",
+          "description": "The table or view name to query"
         }
       },
       "required": [
-        "input"
+        "table"
       ],
-      "returns": "Promise<AsyncIterable<OpenAI.Responses.ResponseStreamEvent>>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const stream = await openai.streamResponse('Write a poem')\nfor await (const event of stream) {\n if (event.type === 'response.output_text.delta') {\n   process.stdout.write(event.delta)\n }\n}"
-        }
-      ]
+      "returns": "void"
     },
-    "createCompletion": {
-      "description": "Create a legacy text completion.",
+    "rpc": {
+      "description": "Call a Postgres function (RPC).",
       "parameters": {
-        "prompt": {
+        "fn": {
           "type": "string",
-          "description": "The text prompt to complete"
+          "description": "The function name"
+        },
+        "params": {
+          "type": "Record<string, unknown>",
+          "description": "Arguments to pass to the function"
         },
         "options": {
-          "type": "Partial<OpenAI.Completions.CompletionCreateParams>",
-          "description": "Additional parameters for the completion"
+          "type": "{ head?: boolean; get?: boolean; count?: \"exact\" | \"planned\" | \"estimated\" }",
+          "description": "Optional settings (head, get, count)"
         }
       },
       "required": [
-        "prompt"
+        "fn"
       ],
-      "returns": "Promise<OpenAI.Completions.Completion>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const response = await openai.createCompletion('Once upon a time')"
-        }
-      ]
+      "returns": "void"
     },
-    "createEmbedding": {
-      "description": "Create text embeddings for semantic search or similarity comparisons.",
+    "signInWithPassword": {
+      "description": "Sign in with email and password.",
       "parameters": {
-        "input": {
-          "type": "string | string[]",
-          "description": "A string or array of strings to embed"
+        "email": {
+          "type": "string",
+          "description": "Parameter email"
         },
-        "options": {
-          "type": "Partial<OpenAI.Embeddings.EmbeddingCreateParams>",
-          "description": "Additional parameters (model, etc.)"
+        "password": {
+          "type": "string",
+          "description": "Parameter password"
         }
       },
       "required": [
-        "input"
+        "email",
+        "password"
       ],
-      "returns": "Promise<OpenAI.Embeddings.CreateEmbeddingResponse>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const response = await openai.createEmbedding('Hello world')\nconsole.log(response.data[0].embedding.length)"
-        }
-      ]
+      "returns": "void"
     },
-    "createImage": {
-      "description": "Generate an image from a text prompt using DALL-E.",
+    "signUp": {
+      "description": "Create a new user account with email and password.",
       "parameters": {
-        "prompt": {
+        "email": {
           "type": "string",
-          "description": "Description of the image to generate"
+          "description": "Parameter email"
         },
-        "options": {
-          "type": "Partial<OpenAI.Images.ImageGenerateParams>",
-          "description": "Additional parameters (size, n, etc.)"
+        "password": {
+          "type": "string",
+          "description": "Parameter password"
         }
       },
       "required": [
-        "prompt"
+        "email",
+        "password"
       ],
-      "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": "void"
     },
-    "listModels": {
-      "description": "List all available models.",
+    "signOut": {
+      "description": "Sign the current user out.",
       "parameters": {},
       "required": [],
-      "returns": "Promise<OpenAI.Models.ModelsPage>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const models = await openai.listModels()"
-        }
-      ]
+      "returns": "void"
     },
-    "ask": {
-      "description": "Ask a single question and get a text response. Convenience wrapper around `createChatCompletion` for simple Q&A.",
+    "getSession": {
+      "description": "Get the current session, if any.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "getUser": {
+      "description": "Get the current user, if any.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
+    },
+    "invoke": {
+      "description": "Invoke a Supabase Edge Function by name.",
       "parameters": {
-        "question": {
+        "name": {
           "type": "string",
-          "description": "The question to ask"
+          "description": "Parameter name"
         },
-        "options": {
-          "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
-          "description": "Additional completion parameters"
+        "body": {
+          "type": "any",
+          "description": "Parameter body"
         }
       },
       "required": [
-        "question"
+        "name"
       ],
-      "returns": "Promise<string>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const answer = await openai.ask('What is 2 + 2?')\nconsole.log(answer) // '4'"
+      "returns": "void"
+    },
+    "subscribe": {
+      "description": "Subscribe to realtime changes on a Postgres table.",
+      "parameters": {
+        "channelName": {
+          "type": "string",
+          "description": "A name for this subscription channel"
+        },
+        "table": {
+          "type": "string",
+          "description": "The table to listen to"
+        },
+        "callback": {
+          "type": "(payload: any) => void",
+          "description": "Called with the payload on each change"
+        },
+        "event": {
+          "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
+          "description": "The event type to listen for (default: all changes)"
         }
-      ]
+      },
+      "required": [
+        "channelName",
+        "table",
+        "callback"
+      ],
+      "returns": "RealtimeChannel"
     },
-    "chat": {
-      "description": "Send a multi-turn conversation and get a text response. Convenience wrapper around `createChatCompletion` that returns just the text.",
+    "unsubscribe": {
+      "description": "Unsubscribe and remove a realtime channel by name.",
       "parameters": {
-        "messages": {
-          "type": "OpenAI.Chat.Completions.ChatCompletionMessageParam[]",
-          "description": "Array of chat messages"
-        },
-        "options": {
-          "type": "Partial<OpenAI.Chat.Completions.ChatCompletionCreateParams>",
-          "description": "Additional completion parameters"
+        "channelName": {
+          "type": "string",
+          "description": "The channel name to remove"
         }
       },
       "required": [
-        "messages"
+        "channelName"
       ],
-      "returns": "Promise<string>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const reply = await openai.chat([\n { role: 'system', content: 'You are a pirate.' },\n { role: 'user', content: 'Hello!' }\n])"
-        }
-      ]
-    }
-  },
-  "getters": {
-    "defaultModel": {
-      "description": "The default model used for completions, from options or 'gpt-4o'.",
-      "returns": "string"
-    },
-    "raw": {
-      "description": "The underlying OpenAI SDK instance for advanced use cases.",
-      "returns": "OpenAI"
-    }
-  },
-  "events": {
-    "connected": {
-      "name": "connected",
-      "description": "Event emitted by OpenAIClient",
-      "arguments": {}
+      "returns": "void"
     },
-    "failure": {
-      "name": "failure",
-      "description": "Event emitted by OpenAIClient",
-      "arguments": {}
+    "unsubscribeAll": {
+      "description": "Unsubscribe and remove all realtime channels.",
+      "parameters": {},
+      "required": [],
+      "returns": "void"
     },
-    "completion": {
-      "name": "completion",
-      "description": "Event emitted by OpenAIClient",
-      "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"
     },
-    "embedding": {
-      "name": "embedding",
-      "description": "Event emitted by OpenAIClient",
-      "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>"
     },
-    "image": {
-      "name": "image",
-      "description": "Event emitted by OpenAIClient",
-      "arguments": {}
+    "storage": {
+      "description": "Returns the Supabase Storage client for managing buckets and files.",
+      "returns": "any"
     },
-    "models": {
-      "name": "models",
-      "description": "Event emitted by OpenAIClient",
-      "arguments": {}
+    "functions": {
+      "description": "Returns the Supabase Functions client.",
+      "returns": "any"
     }
   },
+  "events": {},
   "state": {},
   "options": {},
   "envVars": [],
   "examples": [
     {
       "language": "ts",
-      "code": "const openai = container.client('openai', { defaultModel: 'gpt-4o' })\nconst answer = await openai.ask('What is the meaning of life?')\nconsole.log(answer)"
+      "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})"
     }
   ]
 });
@@ -10977,21 +11169,27 @@ setBuildTimeData('servers.websocket', {
 
 setBuildTimeData('features.assistantsManager', {
   "id": "features.assistantsManager",
-  "description": "Discovers and manages assistant definitions by finding all CORE.md files in the project using the fileManager. Each directory containing a CORE.md is treated as an assistant definition that can also contain tools.ts, hooks.ts, voice.yaml, and a docs/ folder. Use `discover()` to scan for available assistants, `list()` to enumerate them, and `create(name)` to instantiate one as a running Assistant feature.",
+  "description": "Discovers and manages assistant definitions by looking for subdirectories in two locations: ~/.luca/assistants/ and cwd/assistants/. Each subdirectory containing a CORE.md is treated as an assistant definition. Use `discover()` to scan for available assistants, `list()` to enumerate them, and `create(name)` to instantiate one as a running Assistant feature.",
   "shortcut": "features.assistantsManager",
   "className": "AssistantsManager",
   "methods": {
-    "afterInitialize": {
-      "description": "",
+    "discover": {
+      "description": "Discovers assistants by listing subdirectories in ~/.luca/assistants/ and cwd/assistants/. Each subdirectory containing a CORE.md is an assistant.",
       "parameters": {},
       "required": [],
-      "returns": "void"
+      "returns": "Promise<this>"
     },
-    "discover": {
-      "description": "Discovers assistants by finding all CORE.md files in the project using the fileManager. Each directory containing a CORE.md is treated as an assistant definition.",
+    "downloadLucaCoreAssistants": {
+      "description": "Downloads the core assistants that ship with luca from GitHub into ~/.luca/assistants.",
       "parameters": {},
       "required": [],
-      "returns": "Promise<this>"
+      "returns": "void",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const manager = container.feature('assistantsManager')\nawait manager.downloadLucaCoreAssistants()\nawait manager.discover()\nconsole.log(manager.available)"
+        }
+      ]
     },
     "list": {
       "description": "Returns all discovered assistant entries as an array.",
@@ -11004,7 +11202,7 @@ setBuildTimeData('features.assistantsManager', {
       "parameters": {
         "name": {
           "type": "string",
-          "description": "The assistant name (e.g. 'assistants/chief-of-staff')"
+          "description": "The assistant name (e.g. 'chief-of-staff')"
         }
       },
       "required": [
@@ -11012,12 +11210,36 @@ setBuildTimeData('features.assistantsManager', {
       ],
       "returns": "AssistantEntry | undefined"
     },
+    "register": {
+      "description": "Registers a factory function that creates an assistant at runtime. Registered factories take precedence over discovered entries when calling `create()`.",
+      "parameters": {
+        "id": {
+          "type": "string",
+          "description": "The assistant identifier"
+        },
+        "factory": {
+          "type": "(options: Record<string, any>) => Assistant",
+          "description": "Factory function that receives create options and returns an Assistant"
+        }
+      },
+      "required": [
+        "id",
+        "factory"
+      ],
+      "returns": "this",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "manager.register('custom-bot', (options) => {\n return container.feature('assistant', {\n   systemPrompt: 'You are a custom bot.',\n   ...options,\n })\n})\nconst bot = manager.create('custom-bot')"
+        }
+      ]
+    },
     "create": {
-      "description": "Creates and returns a new Assistant feature instance for the given name. The assistant is configured with the discovered folder path. Any additional options are merged in.",
+      "description": "Creates and returns a new Assistant feature instance for the given name. Checks runtime-registered factories first, then falls back to discovered entries. The assistant is configured with the discovered folder path. Any additional options are merged in.",
       "parameters": {
         "name": {
           "type": "string",
-          "description": "The assistant name (must match a discovered entry)"
+          "description": "The assistant name (must match a registered factory or discovered entry)"
         },
         "options": {
           "type": "Record<string, any>",
@@ -11031,7 +11253,7 @@ setBuildTimeData('features.assistantsManager', {
       "examples": [
         {
           "language": "ts",
-          "code": "const assistant = manager.create('assistants/chief-of-staff', { model: 'gpt-4.1' })"
+          "code": "const assistant = manager.create('chief-of-staff', { model: 'gpt-4.1' })"
         }
       ]
     },
@@ -11056,6 +11278,18 @@ setBuildTimeData('features.assistantsManager', {
     }
   },
   "getters": {
+    "entries": {
+      "description": "Discovered assistant entries keyed by name.",
+      "returns": "Record<string, AssistantEntry>"
+    },
+    "instances": {
+      "description": "Active assistant instances keyed by name.",
+      "returns": "Record<string, Assistant>"
+    },
+    "factories": {
+      "description": "Registered factory functions keyed by name.",
+      "returns": "Record<string, (options: Record<string, any>) => Assistant>"
+    },
     "available": {
       "description": "",
       "returns": "any"
@@ -11067,6 +11301,11 @@ setBuildTimeData('features.assistantsManager', {
       "description": "Event emitted by AssistantsManager",
       "arguments": {}
     },
+    "assistantRegistered": {
+      "name": "assistantRegistered",
+      "description": "Event emitted by AssistantsManager",
+      "arguments": {}
+    },
     "assistantCreated": {
       "name": "assistantCreated",
       "description": "Event emitted by AssistantsManager",
@@ -11079,7 +11318,7 @@ setBuildTimeData('features.assistantsManager', {
   "examples": [
     {
       "language": "ts",
-      "code": "const manager = container.feature('assistantsManager')\nmanager.discover()\nconsole.log(manager.list()) // [{ name: 'assistants/chief-of-staff', folder: '...', ... }]\nconst assistant = manager.create('assistants/chief-of-staff')\nconst answer = await assistant.ask('Hello!')"
+      "code": "const manager = container.feature('assistantsManager')\nmanager.discover()\nconsole.log(manager.list()) // [{ name: 'chief-of-staff', folder: '...', ... }]\nconst assistant = manager.create('chief-of-staff')\nconst answer = await assistant.ask('Hello!')"
     }
   ]
 });
@@ -11090,6 +11329,64 @@ setBuildTimeData('features.conversation', {
   "shortcut": "features.conversation",
   "className": "Conversation",
   "methods": {
+    "addTool": {
+      "description": "Add or replace a single tool by name. Uses the same format as tools passed at construction time.",
+      "parameters": {
+        "name": {
+          "type": "string",
+          "description": "Parameter name"
+        },
+        "tool": {
+          "type": "ConversationTool",
+          "description": "Parameter tool",
+          "properties": {
+            "handler": {
+              "type": "(...args: any[]) => Promise<any>",
+              "description": ""
+            },
+            "description": {
+              "type": "string",
+              "description": ""
+            },
+            "parameters": {
+              "type": "Record<string, any>",
+              "description": ""
+            }
+          }
+        }
+      },
+      "required": [
+        "name",
+        "tool"
+      ],
+      "returns": "this"
+    },
+    "removeTool": {
+      "description": "Remove a tool by name.",
+      "parameters": {
+        "name": {
+          "type": "string",
+          "description": "Parameter name"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "returns": "this"
+    },
+    "updateTools": {
+      "description": "Merge new tools into the conversation, replacing any with the same name. Accepts the same Record<string, ConversationTool> format used at construction time.",
+      "parameters": {
+        "tools": {
+          "type": "Record<string, ConversationTool>",
+          "description": "Parameter tools"
+        }
+      },
+      "required": [
+        "tools"
+      ],
+      "returns": "this"
+    },
     "estimateTokens": {
       "description": "Estimate the input token count for the current messages array using the js-tiktoken tokenizer. Updates state.",
       "parameters": {},
@@ -11170,7 +11467,11 @@ setBuildTimeData('features.conversation', {
   "getters": {
     "tools": {
       "description": "Returns the registered tools available for the model to call.",
-      "returns": "Record<string, any>"
+      "returns": "Record<string, ConversationTool>"
+    },
+    "availableTools": {
+      "description": "",
+      "returns": "any"
     },
     "mcpServers": {
       "description": "Returns configured remote MCP servers keyed by server label.",
@@ -11424,8 +11725,8 @@ setBuildTimeData('features.openapi', {
     }
   },
   "events": {
-    "loaded": {
-      "name": "loaded",
+    "started": {
+      "name": "started",
       "description": "Event emitted by OpenAPI",
       "arguments": {}
     }
@@ -11441,160 +11742,253 @@ setBuildTimeData('features.openapi', {
   ]
 });
 
+setBuildTimeData('features.docsReader', {
+  "id": "features.docsReader",
+  "description": "The DocsReader feature is an AI Assisted wrapper around a ContentDB feature. You can ask it questions about the content, and it will use the ContentDB to find the answers from the documents.",
+  "shortcut": "features.docsReader",
+  "className": "DocsReader",
+  "methods": {
+    "calculateCacheKeyForQuestion": {
+      "description": "",
+      "parameters": {
+        "question": {
+          "type": "string",
+          "description": "Parameter question"
+        }
+      },
+      "required": [
+        "question"
+      ],
+      "returns": "void"
+    },
+    "ask": {
+      "description": "",
+      "parameters": {
+        "question": {
+          "type": "string",
+          "description": "Parameter question"
+        }
+      },
+      "required": [
+        "question"
+      ],
+      "returns": "void"
+    },
+    "askCached": {
+      "description": "",
+      "parameters": {
+        "question": {
+          "type": "string",
+          "description": "Parameter question"
+        }
+      },
+      "required": [
+        "question"
+      ],
+      "returns": "void"
+    },
+    "start": {
+      "description": "Start the docs reader by loading the contentDb and wiring its tools into an assistant.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<DocsReader>"
+    }
+  },
+  "getters": {
+    "isStarted": {
+      "description": "Whether the docs reader has been started.",
+      "returns": "boolean"
+    },
+    "answerCache": {
+      "description": "",
+      "returns": "any"
+    },
+    "contentDb": {
+      "description": "",
+      "returns": "ContentDb"
+    }
+  },
+  "events": {
+    "started": {
+      "name": "started",
+      "description": "Event emitted by DocsReader",
+      "arguments": {}
+    }
+  },
+  "state": {},
+  "options": {},
+  "envVars": []
+});
+
 setBuildTimeData('features.skillsLibrary', {
   "id": "features.skillsLibrary",
-  "description": "Manages two contentbase collections of skills following the Claude Code SKILL.md format. Project-level skills live in .claude/skills/ and user-level skills live in ~/.luca/skills/. Skills can be discovered, searched, created, updated, and removed at runtime.",
+  "description": "Manages a registry of skill locations — folders containing SKILL.md files. Persists known locations to ~/.luca/skills.json and scans them on start. Each skill folder can be opened as a DocsReader for AI-assisted Q&A. Exposes tools for assistant integration via assistant.use(skillsLibrary).",
   "shortcut": "features.skillsLibrary",
   "className": "SkillsLibrary",
   "methods": {
-    "load": {
-      "description": "Loads both project and user skill collections from disk. Gracefully handles missing directories.",
+    "start": {
+      "description": "Start the skills library: read config, scan all locations.",
       "parameters": {},
       "required": [],
       "returns": "Promise<SkillsLibrary>"
     },
-    "list": {
-      "description": "Lists all skills from both collections. Project skills come first.",
-      "parameters": {},
-      "required": [],
-      "returns": "SkillEntry[]"
-    },
-    "find": {
-      "description": "Finds a skill by name. Project skills take precedence over user skills.",
+    "addLocation": {
+      "description": "Add a new skill location folder and scan it for skills.",
       "parameters": {
-        "name": {
+        "locationPath": {
           "type": "string",
-          "description": "The skill name to find (case-insensitive)"
+          "description": "Path to a directory containing skill subfolders with SKILL.md"
         }
       },
       "required": [
-        "name"
+        "locationPath"
       ],
-      "returns": "SkillEntry | undefined"
+      "returns": "Promise<void>"
     },
-    "search": {
-      "description": "Searches skills by substring match against name and description.",
+    "removeLocation": {
+      "description": "Remove a skill location and its skills from the library.",
       "parameters": {
-        "query": {
+        "locationPath": {
           "type": "string",
-          "description": "The search query"
+          "description": "The location path to remove"
         }
       },
       "required": [
-        "query"
+        "locationPath"
       ],
-      "returns": "SkillEntry[]"
+      "returns": "Promise<void>"
     },
-    "getSkill": {
-      "description": "Gets a skill by name. Alias for find().",
+    "scanLocation": {
+      "description": "Scan a location folder for skill subfolders containing SKILL.md.",
       "parameters": {
-        "name": {
+        "locationPath": {
           "type": "string",
-          "description": "The skill name"
+          "description": "Absolute path to scan"
         }
       },
       "required": [
-        "name"
+        "locationPath"
       ],
-      "returns": "SkillEntry | undefined"
+      "returns": "Promise<void>"
     },
-    "create": {
-      "description": "Creates a new SKILL.md file in the specified collection. Maintains the directory-per-skill structure (skill-name/SKILL.md).",
+    "list": {
+      "description": "Return all discovered skills.",
+      "parameters": {},
+      "required": [],
+      "returns": "SkillInfo[]"
+    },
+    "find": {
+      "description": "Find a skill by name.",
       "parameters": {
-        "skill": {
-          "type": "{\n\t\t\tname: string\n\t\t\tdescription: string\n\t\t\tbody: string\n\t\t\tmeta?: Record<string, unknown>\n\t\t}",
-          "description": "The skill to create"
-        },
-        "target": {
-          "type": "'project' | 'user'",
-          "description": "Which collection to write to (default: 'project')"
+        "skillName": {
+          "type": "string",
+          "description": "Parameter skillName"
         }
       },
       "required": [
-        "skill"
+        "skillName"
       ],
-      "returns": "Promise<SkillEntry>"
+      "returns": "SkillInfo | undefined"
     },
-    "update": {
-      "description": "Updates an existing skill's content or metadata.",
+    "createSkillReader": {
+      "description": "Create a DocsReader for a skill's folder, enabling AI-assisted Q&A.",
       "parameters": {
-        "name": {
+        "skillName": {
           "type": "string",
-          "description": "The skill name to update"
-        },
-        "updates": {
-          "type": "{\n\t\t\tdescription?: string\n\t\t\tbody?: string\n\t\t\tmeta?: Record<string, unknown>\n\t\t}",
-          "description": "Fields to update"
+          "description": "Name of the skill to create a reader for"
         }
       },
       "required": [
-        "name",
-        "updates"
+        "skillName"
       ],
-      "returns": "Promise<SkillEntry>"
+      "returns": "DocsReader"
     },
-    "remove": {
-      "description": "Removes a skill by name, deleting its SKILL.md and cleaning up the directory.",
+    "ensureFolderCreatedWithSkillsByName": {
+      "description": "Create a tmp directory containing symlinked/copied skill folders by name, suitable for passing to claude --add-dir.",
       "parameters": {
-        "name": {
-          "type": "string",
-          "description": "The skill name to remove"
+        "skillNames": {
+          "type": "string[]",
+          "description": "Array of skill names to include"
         }
       },
       "required": [
-        "name"
+        "skillNames"
       ],
-      "returns": "Promise<boolean>"
+      "returns": "string"
     },
-    "toConversationTools": {
-      "description": "Converts all skills into ConversationTool format for use with Conversation. Each skill becomes a tool that returns its instruction body when invoked.",
-      "parameters": {},
+    "searchAvailableSkills": {
+      "description": "Search available skills, optionally filtered by a query string.",
+      "parameters": {
+        "{ query }": {
+          "type": "{ query?: string }",
+          "description": "Parameter { query }"
+        }
+      },
       "required": [],
-      "returns": "Record<string, ConversationTool>"
+      "returns": "Promise<string>"
     },
-    "toSystemPromptBlock": {
-      "description": "Generates a markdown block listing all available skills with names and descriptions. Suitable for injecting into a system prompt.",
-      "parameters": {},
-      "required": [],
-      "returns": "string"
+    "loadSkill": {
+      "description": "Load a skill's full SKILL.md content and metadata.",
+      "parameters": {
+        "{ skillName }": {
+          "type": "{ skillName: string }",
+          "description": "Parameter { skillName }"
+        }
+      },
+      "required": [
+        "{ skillName }"
+      ],
+      "returns": "Promise<string>"
+    },
+    "askSkillBasedQuestion": {
+      "description": "Ask a question about a specific skill using a DocsReader.",
+      "parameters": {
+        "{ skillName, question }": {
+          "type": "{ skillName: string; question: string }",
+          "description": "Parameter { skillName, question }"
+        }
+      },
+      "required": [
+        "{ skillName, question }"
+      ],
+      "returns": "Promise<string>"
     }
   },
   "getters": {
-    "projectCollection": {
-      "description": "Returns the project-level contentbase Collection, lazily initialized.",
-      "returns": "Collection"
+    "skills": {
+      "description": "Discovered skills keyed by name.",
+      "returns": "Record<string, SkillInfo>"
+    },
+    "availableSkills": {
+      "description": "",
+      "returns": "any"
     },
-    "userCollection": {
-      "description": "Returns the user-level contentbase Collection, lazily initialized.",
-      "returns": "Collection"
+    "skillsTable": {
+      "description": "",
+      "returns": "Record<string, string>"
     },
-    "isLoaded": {
-      "description": "Whether the skills library has been loaded.",
-      "returns": "boolean"
+    "configPath": {
+      "description": "Resolved path to the skills.json config file.",
+      "returns": "string"
     },
-    "skillNames": {
-      "description": "Array of all skill names across both collections.",
-      "returns": "string[]"
+    "isStarted": {
+      "description": "Whether the library has been loaded.",
+      "returns": "boolean"
     }
   },
   "events": {
-    "loaded": {
-      "name": "loaded",
-      "description": "Event emitted by SkillsLibrary",
-      "arguments": {}
-    },
-    "skillCreated": {
-      "name": "skillCreated",
+    "started": {
+      "name": "started",
       "description": "Event emitted by SkillsLibrary",
       "arguments": {}
     },
-    "skillUpdated": {
-      "name": "skillUpdated",
+    "locationAdded": {
+      "name": "locationAdded",
       "description": "Event emitted by SkillsLibrary",
       "arguments": {}
     },
-    "skillRemoved": {
-      "name": "skillRemoved",
+    "skillDiscovered": {
+      "name": "skillDiscovered",
       "description": "Event emitted by SkillsLibrary",
       "arguments": {}
     }
@@ -11605,7 +11999,7 @@ setBuildTimeData('features.skillsLibrary', {
   "examples": [
     {
       "language": "ts",
-      "code": "const skills = container.feature('skillsLibrary')\nawait skills.load()\n\n// List and search\nconst allSkills = skills.list()\nconst matches = skills.search('code review')\n\n// Create a new skill\nawait skills.create({\n name: 'summarize',\n description: 'Summarize a document',\n body: '## Instructions\\nRead the document and produce a concise summary.'\n})"
+      "code": "const lib = container.feature('skillsLibrary')\nawait lib.start()\nawait lib.addLocation('~/.claude/skills')\nlib.list() // => SkillInfo[]\nconst reader = lib.createSkillReader('my-skill')"
     }
   ]
 });
@@ -11623,27 +12017,31 @@ setBuildTimeData('features.assistant', {
       "returns": "void"
     },
     "use": {
-      "description": "Apply a setup function to this assistant. The function receives the assistant instance and can configure tools, hooks, event listeners, etc.",
+      "description": "Apply a setup function or a Helper instance to this assistant. When passed a function, it receives the assistant and can configure tools, hooks, event listeners, etc. When passed a Helper instance that exposes tools via toTools(), those tools are automatically added to this assistant.",
       "parameters": {
-        "fn": {
-          "type": "(assistant: this) => void | Promise<void>",
-          "description": "Setup function that receives this assistant"
+        "fnOrHelper": {
+          "type": "((assistant: this) => void | Promise<void>) | { toTools: () => { schemas: Record<string, z.ZodType>, handlers: Record<string, Function> } } | { schemas: Record<string, z.ZodType>, handlers: Record<string, Function> }",
+          "description": "Setup function or Helper instance"
         }
       },
       "required": [
-        "fn"
+        "fnOrHelper"
       ],
       "returns": "this",
       "examples": [
         {
           "language": "ts",
-          "code": "assistant\n .use(setupLogging)\n .use(addAnalyticsTools)"
+          "code": "assistant\n .use(setupLogging)\n .use(container.feature('git'))"
         }
       ]
     },
     "addTool": {
       "description": "Add a tool to this assistant. The tool name is derived from the handler's function name.",
       "parameters": {
+        "name": {
+          "type": "string",
+          "description": "Parameter name"
+        },
         "handler": {
           "type": "(...args: any[]) => any",
           "description": "A named function that implements the tool"
@@ -11654,6 +12052,7 @@ setBuildTimeData('features.assistant', {
         }
       },
       "required": [
+        "name",
         "handler"
       ],
       "returns": "this",
@@ -11719,7 +12118,7 @@ setBuildTimeData('features.assistant', {
       "returns": "this"
     },
     "loadSystemPrompt": {
-      "description": "Load the system prompt from CORE.md, applying any prepend/append options.",
+      "description": "Load the system prompt from CORE.md, applying any prepend/append options. YAML frontmatter (between --- fences) is stripped from the prompt and stored in `_meta`.",
       "parameters": {},
       "required": [],
       "returns": "string"
@@ -11805,6 +12204,29 @@ setBuildTimeData('features.assistant', {
       },
       "required": [],
       "returns": "void"
+    },
+    "subagent": {
+      "description": "Get or create a subagent assistant. Uses the assistantsManager to discover and create the assistant, then caches the instance for reuse across tool calls.",
+      "parameters": {
+        "id": {
+          "type": "string",
+          "description": "The assistant name (e.g. 'codingAssistant')"
+        },
+        "options": {
+          "type": "Record<string, any>",
+          "description": "Additional options to pass to the assistant constructor"
+        }
+      },
+      "required": [
+        "id"
+      ],
+      "returns": "Promise<Assistant>",
+      "examples": [
+        {
+          "language": "ts",
+          "code": "const researcher = await assistant.subagent('codingAssistant')\nconst answer = await researcher.ask('Find all usages of container.feature(\"fs\")')"
+        }
+      ]
     }
   },
   "getters": {
@@ -11848,6 +12270,10 @@ setBuildTimeData('features.assistant', {
       "description": "",
       "returns": "Conversation"
     },
+    "availableTools": {
+      "description": "",
+      "returns": "any"
+    },
     "messages": {
       "description": "",
       "returns": "any"
@@ -11864,6 +12290,10 @@ setBuildTimeData('features.assistant', {
       "description": "The tools registered with this assistant.",
       "returns": "Record<string, ConversationTool>"
     },
+    "meta": {
+      "description": "Parsed YAML frontmatter from CORE.md, or empty object if none.",
+      "returns": "Record<string, any>"
+    },
     "paths": {
       "description": "Provides a helper for creating paths off of the assistant's base folder",
       "returns": "any"
@@ -11887,6 +12317,10 @@ setBuildTimeData('features.assistant', {
     "currentThreadId": {
       "description": "The active thread ID (undefined in lifecycle mode).",
       "returns": "string | undefined"
+    },
+    "availableSubagents": {
+      "description": "Names of assistants available as subagents, discovered via the assistantsManager.",
+      "returns": "string[]"
     }
   },
   "events": {
@@ -11895,6 +12329,11 @@ setBuildTimeData('features.assistant', {
       "description": "Event emitted by Assistant",
       "arguments": {}
     },
+    "toolsChanged": {
+      "name": "toolsChanged",
+      "description": "Event emitted by Assistant",
+      "arguments": {}
+    },
     "hookFired": {
       "name": "hookFired",
       "description": "Event emitted by Assistant",
@@ -13559,6 +13998,10 @@ setContainerBuildTimeData('Container', {
       "description": "Returns a map of enabled feature shortcut IDs to their instances.",
       "returns": "Partial<AvailableInstanceTypes<Features>>"
     },
+    "describer": {
+      "description": "Lazy-initialized ContainerDescriber for introspecting registries, helpers, and members.",
+      "returns": "ContainerDescriber"
+    },
     "context": {
       "description": "The Container's context is an object that contains the enabled features, the container itself, and any additional context that has been added to the container. All helper instances that are created by the container will have access to the shared context.",
       "returns": "ContainerContext<Features> & Partial<AvailableInstanceTypes<AvailableFeatures>>"
@@ -14418,6 +14861,25 @@ export const introspectionData = [
           }
         ]
       },
+      "extractFolder": {
+        "description": "Extracts a folder (or entire repo) from a remote GitHub repository without cloning. Downloads the repo as a tarball and extracts only the specified subfolder, similar to how degit works. No .git history is included — just the files. Supports shorthand (`user/repo/path`), branch refs (`user/repo/path#branch`), and full GitHub URLs (`https://github.com/user/repo/tree/branch/path`).",
+        "parameters": {
+          "{ source, destination, branch }": {
+            "type": "{ source: string, destination: string, branch?: string }",
+            "description": "Parameter { source, destination, branch }"
+          }
+        },
+        "required": [
+          "{ source, destination, branch }"
+        ],
+        "returns": "void",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "// Extract a subfolder\nawait git.extractFolder({ source: 'soederpop/luca/src/assistants', destination: './my-assistants' })\n\n// Specific branch\nawait git.extractFolder({ source: 'sveltejs/template', destination: './my-app', branch: 'main' })\n\n// Full GitHub URL\nawait git.extractFolder({ source: 'https://github.com/user/repo/tree/main/examples', destination: './examples' })"
+          }
+        ]
+      },
       "getChangeHistoryForFiles": {
         "description": "Gets the commit history for a set of files or glob patterns. Accepts absolute paths, relative paths (resolved from container.cwd), or glob patterns. Returns commits that touched any of the matched files, with each entry noting which of your queried files were in that commit.",
         "parameters": {
@@ -15982,6 +16444,29 @@ export const introspectionData = [
         ],
         "returns": "Promise<T>"
       },
+      "runCaptured": {
+        "description": "Execute code and capture all console output as structured JSON. Returns both the execution result and an array of every `console.*` call made during execution, each entry recording the method name and arguments.",
+        "parameters": {
+          "code": {
+            "type": "string",
+            "description": "The JavaScript code to execute"
+          },
+          "ctx": {
+            "type": "any",
+            "description": "Context variables to make available to the executing code"
+          }
+        },
+        "required": [
+          "code"
+        ],
+        "returns": "Promise<{\n    result: T\n    console: Array<{ method: string, args: any[] }>\n    context: vm.Context\n  }>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const { result, console: calls } = await vm.runCaptured('console.log(\"hi\"); console.warn(\"oh\"); 42')\n// result === 42\n// calls === [{ method: 'log', args: ['hi'] }, { method: 'warn', args: ['oh'] }]"
+          }
+        ]
+      },
       "runSync": {
         "description": "Execute JavaScript code synchronously in a controlled environment.",
         "parameters": {
@@ -18921,6 +19406,23 @@ export const introspectionData = [
           }
         ]
       },
+      "readFileSync": {
+        "description": "Synchronously reads a file and returns its contents as a string. added this method because AI Assistants are understandly confused by this deviation from 2000's era node style",
+        "parameters": {
+          "path": {
+            "type": "string",
+            "description": "Parameter path"
+          },
+          "encoding": {
+            "type": "BufferEncoding | null",
+            "description": "Parameter encoding"
+          }
+        },
+        "required": [
+          "path"
+        ],
+        "returns": "string | Buffer"
+      },
       "readFileAsync": {
         "description": "Asynchronously reads a file and returns its contents as a string.",
         "parameters": {
@@ -18963,6 +19465,19 @@ export const introspectionData = [
           }
         ]
       },
+      "readJsonSync": {
+        "description": "Read and parse a JSON file synchronously",
+        "parameters": {
+          "path": {
+            "type": "string",
+            "description": "Parameter path"
+          }
+        },
+        "required": [
+          "path"
+        ],
+        "returns": "void"
+      },
       "readJsonAsync": {
         "description": "Asynchronously reads and parses a JSON file.",
         "parameters": {
@@ -22751,6 +23266,30 @@ export const introspectionData = [
     "shortcut": "features.contentDb",
     "className": "ContentDb",
     "methods": {
+      "renderTree": {
+        "description": "Render a tree view of the collection directory structure. Built with container.fs so it works without the `tree` binary.",
+        "parameters": {
+          "options": {
+            "type": "{ depth?: number; dirsOnly?: boolean }",
+            "description": "Parameter options"
+          }
+        },
+        "required": [],
+        "returns": "string"
+      },
+      "grep": {
+        "description": "",
+        "parameters": {
+          "options": {
+            "type": "string | GrepOptions",
+            "description": "Parameter options"
+          }
+        },
+        "required": [
+          "options"
+        ],
+        "returns": "void"
+      },
       "query": {
         "description": "Query documents belonging to a specific model definition.",
         "parameters": {
@@ -22916,57 +23455,141 @@ export const introspectionData = [
       "vectorSearch": {
         "description": "Vector similarity search using embeddings. Finds conceptually related documents even without keyword matches.",
         "parameters": {
-          "query": {
-            "type": "string",
-            "description": "Parameter query"
-          },
-          "options": {
-            "type": "{ limit?: number; model?: string; where?: Record<string, any> }",
-            "description": "Parameter options"
+          "query": {
+            "type": "string",
+            "description": "Parameter query"
+          },
+          "options": {
+            "type": "{ limit?: number; model?: string; where?: Record<string, any> }",
+            "description": "Parameter options"
+          }
+        },
+        "required": [
+          "query"
+        ],
+        "returns": "void"
+      },
+      "hybridSearch": {
+        "description": "Combined keyword + semantic search with Reciprocal Rank Fusion. Best for general questions about the collection.",
+        "parameters": {
+          "query": {
+            "type": "string",
+            "description": "Parameter query"
+          },
+          "options": {
+            "type": "{ limit?: number; model?: string; where?: Record<string, any>; ftsWeight?: number; vecWeight?: number }",
+            "description": "Parameter options"
+          }
+        },
+        "required": [
+          "query"
+        ],
+        "returns": "void"
+      },
+      "buildSearchIndex": {
+        "description": "Build the search index from all documents in the collection. Chunks documents and generates embeddings.",
+        "parameters": {
+          "options": {
+            "type": "{ force?: boolean; embeddingProvider?: string; embeddingModel?: string; onProgress?: (indexed: number, total: number) => void }",
+            "description": "Parameter options"
+          }
+        },
+        "required": [],
+        "returns": "void"
+      },
+      "rebuildSearchIndex": {
+        "description": "Rebuild the entire search index from scratch.",
+        "parameters": {
+          "options": {
+            "type": "{ embeddingProvider?: string; embeddingModel?: string; onProgress?: (indexed: number, total: number) => void }",
+            "description": "Parameter options"
+          }
+        },
+        "required": [],
+        "returns": "void"
+      },
+      "getCollectionOverview": {
+        "description": "Returns a high-level overview of the collection.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "listDocuments": {
+        "description": "List document IDs, optionally filtered by model or glob.",
+        "parameters": {
+          "args": {
+            "type": "{ model?: string; glob?: string }",
+            "description": "Parameter args"
+          }
+        },
+        "required": [
+          "args"
+        ],
+        "returns": "void"
+      },
+      "readDocument": {
+        "description": "Read a single document with optional section filtering.",
+        "parameters": {
+          "args": {
+            "type": "{ id: string; include?: string[]; exclude?: string[]; meta?: boolean }",
+            "description": "Parameter args"
+          }
+        },
+        "required": [
+          "args"
+        ],
+        "returns": "void"
+      },
+      "readMultipleDocuments": {
+        "description": "Read multiple documents with optional section filtering.",
+        "parameters": {
+          "args": {
+            "type": "{ ids: string[]; include?: string[]; exclude?: string[]; meta?: boolean }",
+            "description": "Parameter args"
           }
         },
         "required": [
-          "query"
+          "args"
         ],
         "returns": "void"
       },
-      "hybridSearch": {
-        "description": "Combined keyword + semantic search with Reciprocal Rank Fusion. Best for general questions about the collection.",
+      "queryDocuments": {
+        "description": "Query documents by model with filters, sort, limit.",
         "parameters": {
-          "query": {
-            "type": "string",
-            "description": "Parameter query"
-          },
-          "options": {
-            "type": "{ limit?: number; model?: string; where?: Record<string, any>; ftsWeight?: number; vecWeight?: number }",
-            "description": "Parameter options"
+          "args": {
+            "type": "{ model: string; where?: string; sort?: string; limit?: number; offset?: number; select?: string[] }",
+            "description": "Parameter args"
           }
         },
         "required": [
-          "query"
+          "args"
         ],
         "returns": "void"
       },
-      "buildSearchIndex": {
-        "description": "Build the search index from all documents in the collection. Chunks documents and generates embeddings.",
+      "searchContent": {
+        "description": "Grep/text search across the collection.",
         "parameters": {
-          "options": {
-            "type": "{ force?: boolean; embeddingProvider?: string; embeddingModel?: string; onProgress?: (indexed: number, total: number) => void }",
-            "description": "Parameter options"
+          "args": {
+            "type": "{ pattern: string; caseSensitive?: boolean }",
+            "description": "Parameter args"
           }
         },
-        "required": [],
+        "required": [
+          "args"
+        ],
         "returns": "void"
       },
-      "rebuildSearchIndex": {
-        "description": "Rebuild the entire search index from scratch.",
+      "semanticSearch": {
+        "description": "Hybrid semantic search with graceful fallback to grep.",
         "parameters": {
-          "options": {
-            "type": "{ embeddingProvider?: string; embeddingModel?: string; onProgress?: (indexed: number, total: number) => void }",
-            "description": "Parameter options"
+          "args": {
+            "type": "{ query: string; limit?: number }",
+            "description": "Parameter args"
           }
         },
-        "required": [],
+        "required": [
+          "args"
+        ],
         "returns": "void"
       }
     },
@@ -22991,6 +23614,18 @@ export const introspectionData = [
         "description": "Returns an array of all registered model names from the collection.",
         "returns": "string[]"
       },
+      "available": {
+        "description": "Returns the available document ids in the collection",
+        "returns": "string[]"
+      },
+      "modelDefinitionTable": {
+        "description": "",
+        "returns": "any"
+      },
+      "fileTree": {
+        "description": "",
+        "returns": "any"
+      },
       "searchIndexStatus": {
         "description": "Get the current search index status.",
         "returns": "any"
@@ -23281,250 +23916,55 @@ export const introspectionData = [
         "required": [
           "data"
         ],
-        "returns": "Promise<void>"
-      },
-      "disconnect": {
-        "description": "Gracefully close the WebSocket connection. Suppresses auto-reconnect and updates connection state to disconnected.",
-        "parameters": {},
-        "required": [],
-        "returns": "Promise<this>"
-      }
-    },
-    "getters": {
-      "hasError": {
-        "description": "Whether the client is in an error state.",
-        "returns": "any"
-      }
-    },
-    "events": {
-      "open": {
-        "name": "open",
-        "description": "Event emitted by WebSocketClient",
-        "arguments": {}
-      },
-      "error": {
-        "name": "error",
-        "description": "Event emitted by WebSocketClient",
-        "arguments": {}
-      },
-      "message": {
-        "name": "message",
-        "description": "Event emitted by WebSocketClient",
-        "arguments": {}
-      },
-      "close": {
-        "name": "close",
-        "description": "Event emitted by WebSocketClient",
-        "arguments": {}
-      },
-      "reconnecting": {
-        "name": "reconnecting",
-        "description": "Event emitted by WebSocketClient",
-        "arguments": {}
-      }
-    },
-    "state": {},
-    "options": {},
-    "envVars": [],
-    "examples": [
-      {
-        "language": "ts",
-        "code": "const ws = container.client('websocket', {\n baseURL: 'ws://localhost:8080',\n reconnect: true,\n maxReconnectAttempts: 5\n})\nws.on('message', (data) => console.log('Received:', data))\nawait ws.connect()\nawait ws.send({ type: 'hello' })"
-      }
-    ]
-  },
-  {
-    "id": "clients.supabase",
-    "description": "Supabase client for the Luca container system. Wraps the official `@supabase/supabase-js` SDK and exposes it through Luca's typed state, events, and introspection system. The SDK is isomorphic so this single implementation works in both Node and browser containers. Use `client.sdk` for full SDK access, or use the convenience wrappers for common operations (auth, database queries, storage, edge functions, realtime).",
-    "shortcut": "clients.supabase",
-    "className": "SupabaseClient",
-    "methods": {
-      "from": {
-        "description": "Start a query on a Postgres table or view.",
-        "parameters": {
-          "table": {
-            "type": "string",
-            "description": "The table or view name to query"
-          }
-        },
-        "required": [
-          "table"
-        ],
-        "returns": "void"
-      },
-      "rpc": {
-        "description": "Call a Postgres function (RPC).",
-        "parameters": {
-          "fn": {
-            "type": "string",
-            "description": "The function name"
-          },
-          "params": {
-            "type": "Record<string, unknown>",
-            "description": "Arguments to pass to the function"
-          },
-          "options": {
-            "type": "{ head?: boolean; get?: boolean; count?: \"exact\" | \"planned\" | \"estimated\" }",
-            "description": "Optional settings (head, get, count)"
-          }
-        },
-        "required": [
-          "fn"
-        ],
-        "returns": "void"
-      },
-      "signInWithPassword": {
-        "description": "Sign in with email and password.",
-        "parameters": {
-          "email": {
-            "type": "string",
-            "description": "Parameter email"
-          },
-          "password": {
-            "type": "string",
-            "description": "Parameter password"
-          }
-        },
-        "required": [
-          "email",
-          "password"
-        ],
-        "returns": "void"
-      },
-      "signUp": {
-        "description": "Create a new user account with email and password.",
-        "parameters": {
-          "email": {
-            "type": "string",
-            "description": "Parameter email"
-          },
-          "password": {
-            "type": "string",
-            "description": "Parameter password"
-          }
-        },
-        "required": [
-          "email",
-          "password"
-        ],
-        "returns": "void"
-      },
-      "signOut": {
-        "description": "Sign the current user out.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "getSession": {
-        "description": "Get the current session, if any.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "getUser": {
-        "description": "Get the current user, if any.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "invoke": {
-        "description": "Invoke a Supabase Edge Function by name.",
-        "parameters": {
-          "name": {
-            "type": "string",
-            "description": "Parameter name"
-          },
-          "body": {
-            "type": "any",
-            "description": "Parameter body"
-          }
-        },
-        "required": [
-          "name"
-        ],
-        "returns": "void"
-      },
-      "subscribe": {
-        "description": "Subscribe to realtime changes on a Postgres table.",
-        "parameters": {
-          "channelName": {
-            "type": "string",
-            "description": "A name for this subscription channel"
-          },
-          "table": {
-            "type": "string",
-            "description": "The table to listen to"
-          },
-          "callback": {
-            "type": "(payload: any) => void",
-            "description": "Called with the payload on each change"
-          },
-          "event": {
-            "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
-            "description": "The event type to listen for (default: all changes)"
-          }
-        },
-        "required": [
-          "channelName",
-          "table",
-          "callback"
-        ],
-        "returns": "RealtimeChannel"
-      },
-      "unsubscribe": {
-        "description": "Unsubscribe and remove a realtime channel by name.",
-        "parameters": {
-          "channelName": {
-            "type": "string",
-            "description": "The channel name to remove"
-          }
-        },
-        "required": [
-          "channelName"
-        ],
-        "returns": "void"
-      },
-      "unsubscribeAll": {
-        "description": "Unsubscribe and remove all realtime channels.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
-      },
-      "connect": {
-        "description": "Connect is a no-op since the Supabase SDK initializes on construction. The client is ready to use immediately after creation.",
-        "parameters": {},
-        "required": [],
-        "returns": "void"
+        "returns": "Promise<void>"
       },
       "disconnect": {
-        "description": "Disconnect by signing out and removing all realtime channels.",
+        "description": "Gracefully close the WebSocket connection. Suppresses auto-reconnect and updates connection state to disconnected.",
         "parameters": {},
         "required": [],
-        "returns": "void"
+        "returns": "Promise<this>"
       }
     },
     "getters": {
-      "sdk": {
-        "description": "Returns the raw Supabase SDK client for full access to all SDK methods.",
-        "returns": "SupabaseSDKClient<any, any>"
-      },
-      "storage": {
-        "description": "Returns the Supabase Storage client for managing buckets and files.",
+      "hasError": {
+        "description": "Whether the client is in an error state.",
         "returns": "any"
+      }
+    },
+    "events": {
+      "open": {
+        "name": "open",
+        "description": "Event emitted by WebSocketClient",
+        "arguments": {}
       },
-      "functions": {
-        "description": "Returns the Supabase Functions client.",
-        "returns": "any"
+      "error": {
+        "name": "error",
+        "description": "Event emitted by WebSocketClient",
+        "arguments": {}
+      },
+      "message": {
+        "name": "message",
+        "description": "Event emitted by WebSocketClient",
+        "arguments": {}
+      },
+      "close": {
+        "name": "close",
+        "description": "Event emitted by WebSocketClient",
+        "arguments": {}
+      },
+      "reconnecting": {
+        "name": "reconnecting",
+        "description": "Event emitted by WebSocketClient",
+        "arguments": {}
       }
     },
-    "events": {},
     "state": {},
     "options": {},
     "envVars": [],
     "examples": [
       {
         "language": "ts",
-        "code": "const supabase = container.client('supabase', {\n supabaseUrl: 'https://xyz.supabase.co',\n supabaseKey: 'your-anon-key',\n})\n\n// Query data\nconst { data } = await supabase.from('users').select('*')\n\n// Auth\nawait supabase.signInWithPassword('user@example.com', 'password')\n\n// Realtime\nsupabase.subscribe('changes', 'users', (payload) => {\n console.log('Change:', payload)\n})"
+        "code": "const ws = container.client('websocket', {\n baseURL: 'ws://localhost:8080',\n reconnect: true,\n maxReconnectAttempts: 5\n})\nws.on('message', (data) => console.log('Received:', data))\nawait ws.connect()\nawait ws.send({ type: 'hello' })"
       }
     ]
   },
@@ -23795,6 +24235,201 @@ export const introspectionData = [
       }
     ]
   },
+  {
+    "id": "clients.supabase",
+    "description": "Supabase client for the Luca container system. Wraps the official `@supabase/supabase-js` SDK and exposes it through Luca's typed state, events, and introspection system. The SDK is isomorphic so this single implementation works in both Node and browser containers. Use `client.sdk` for full SDK access, or use the convenience wrappers for common operations (auth, database queries, storage, edge functions, realtime).",
+    "shortcut": "clients.supabase",
+    "className": "SupabaseClient",
+    "methods": {
+      "from": {
+        "description": "Start a query on a Postgres table or view.",
+        "parameters": {
+          "table": {
+            "type": "string",
+            "description": "The table or view name to query"
+          }
+        },
+        "required": [
+          "table"
+        ],
+        "returns": "void"
+      },
+      "rpc": {
+        "description": "Call a Postgres function (RPC).",
+        "parameters": {
+          "fn": {
+            "type": "string",
+            "description": "The function name"
+          },
+          "params": {
+            "type": "Record<string, unknown>",
+            "description": "Arguments to pass to the function"
+          },
+          "options": {
+            "type": "{ head?: boolean; get?: boolean; count?: \"exact\" | \"planned\" | \"estimated\" }",
+            "description": "Optional settings (head, get, count)"
+          }
+        },
+        "required": [
+          "fn"
+        ],
+        "returns": "void"
+      },
+      "signInWithPassword": {
+        "description": "Sign in with email and password.",
+        "parameters": {
+          "email": {
+            "type": "string",
+            "description": "Parameter email"
+          },
+          "password": {
+            "type": "string",
+            "description": "Parameter password"
+          }
+        },
+        "required": [
+          "email",
+          "password"
+        ],
+        "returns": "void"
+      },
+      "signUp": {
+        "description": "Create a new user account with email and password.",
+        "parameters": {
+          "email": {
+            "type": "string",
+            "description": "Parameter email"
+          },
+          "password": {
+            "type": "string",
+            "description": "Parameter password"
+          }
+        },
+        "required": [
+          "email",
+          "password"
+        ],
+        "returns": "void"
+      },
+      "signOut": {
+        "description": "Sign the current user out.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "getSession": {
+        "description": "Get the current session, if any.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "getUser": {
+        "description": "Get the current user, if any.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "invoke": {
+        "description": "Invoke a Supabase Edge Function by name.",
+        "parameters": {
+          "name": {
+            "type": "string",
+            "description": "Parameter name"
+          },
+          "body": {
+            "type": "any",
+            "description": "Parameter body"
+          }
+        },
+        "required": [
+          "name"
+        ],
+        "returns": "void"
+      },
+      "subscribe": {
+        "description": "Subscribe to realtime changes on a Postgres table.",
+        "parameters": {
+          "channelName": {
+            "type": "string",
+            "description": "A name for this subscription channel"
+          },
+          "table": {
+            "type": "string",
+            "description": "The table to listen to"
+          },
+          "callback": {
+            "type": "(payload: any) => void",
+            "description": "Called with the payload on each change"
+          },
+          "event": {
+            "type": "\"INSERT\" | \"UPDATE\" | \"DELETE\" | \"*\"",
+            "description": "The event type to listen for (default: all changes)"
+          }
+        },
+        "required": [
+          "channelName",
+          "table",
+          "callback"
+        ],
+        "returns": "RealtimeChannel"
+      },
+      "unsubscribe": {
+        "description": "Unsubscribe and remove a realtime channel by name.",
+        "parameters": {
+          "channelName": {
+            "type": "string",
+            "description": "The channel name to remove"
+          }
+        },
+        "required": [
+          "channelName"
+        ],
+        "returns": "void"
+      },
+      "unsubscribeAll": {
+        "description": "Unsubscribe and remove all realtime channels.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "connect": {
+        "description": "Connect is a no-op since the Supabase SDK initializes on construction. The client is ready to use immediately after creation.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      },
+      "disconnect": {
+        "description": "Disconnect by signing out and removing all realtime channels.",
+        "parameters": {},
+        "required": [],
+        "returns": "void"
+      }
+    },
+    "getters": {
+      "sdk": {
+        "description": "Returns the raw Supabase SDK client for full access to all SDK methods.",
+        "returns": "SupabaseSDKClient<any, any>"
+      },
+      "storage": {
+        "description": "Returns the Supabase Storage client for managing buckets and files.",
+        "returns": "any"
+      },
+      "functions": {
+        "description": "Returns the Supabase Functions client.",
+        "returns": "any"
+      }
+    },
+    "events": {},
+    "state": {},
+    "options": {},
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const supabase = container.client('supabase', {\n supabaseUrl: 'https://xyz.supabase.co',\n supabaseKey: 'your-anon-key',\n})\n\n// Query data\nconst { data } = await supabase.from('users').select('*')\n\n// Auth\nawait supabase.signInWithPassword('user@example.com', 'password')\n\n// Realtime\nsupabase.subscribe('changes', 'users', (payload) => {\n console.log('Change:', payload)\n})"
+      }
+    ]
+  },
   {
     "id": "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.",
@@ -24616,21 +25251,27 @@ export const introspectionData = [
   },
   {
     "id": "features.assistantsManager",
-    "description": "Discovers and manages assistant definitions by finding all CORE.md files in the project using the fileManager. Each directory containing a CORE.md is treated as an assistant definition that can also contain tools.ts, hooks.ts, voice.yaml, and a docs/ folder. Use `discover()` to scan for available assistants, `list()` to enumerate them, and `create(name)` to instantiate one as a running Assistant feature.",
+    "description": "Discovers and manages assistant definitions by looking for subdirectories in two locations: ~/.luca/assistants/ and cwd/assistants/. Each subdirectory containing a CORE.md is treated as an assistant definition. Use `discover()` to scan for available assistants, `list()` to enumerate them, and `create(name)` to instantiate one as a running Assistant feature.",
     "shortcut": "features.assistantsManager",
     "className": "AssistantsManager",
     "methods": {
-      "afterInitialize": {
-        "description": "",
+      "discover": {
+        "description": "Discovers assistants by listing subdirectories in ~/.luca/assistants/ and cwd/assistants/. Each subdirectory containing a CORE.md is an assistant.",
         "parameters": {},
         "required": [],
-        "returns": "void"
+        "returns": "Promise<this>"
       },
-      "discover": {
-        "description": "Discovers assistants by finding all CORE.md files in the project using the fileManager. Each directory containing a CORE.md is treated as an assistant definition.",
+      "downloadLucaCoreAssistants": {
+        "description": "Downloads the core assistants that ship with luca from GitHub into ~/.luca/assistants.",
         "parameters": {},
         "required": [],
-        "returns": "Promise<this>"
+        "returns": "void",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const manager = container.feature('assistantsManager')\nawait manager.downloadLucaCoreAssistants()\nawait manager.discover()\nconsole.log(manager.available)"
+          }
+        ]
       },
       "list": {
         "description": "Returns all discovered assistant entries as an array.",
@@ -24643,7 +25284,7 @@ export const introspectionData = [
         "parameters": {
           "name": {
             "type": "string",
-            "description": "The assistant name (e.g. 'assistants/chief-of-staff')"
+            "description": "The assistant name (e.g. 'chief-of-staff')"
           }
         },
         "required": [
@@ -24651,12 +25292,36 @@ export const introspectionData = [
         ],
         "returns": "AssistantEntry | undefined"
       },
+      "register": {
+        "description": "Registers a factory function that creates an assistant at runtime. Registered factories take precedence over discovered entries when calling `create()`.",
+        "parameters": {
+          "id": {
+            "type": "string",
+            "description": "The assistant identifier"
+          },
+          "factory": {
+            "type": "(options: Record<string, any>) => Assistant",
+            "description": "Factory function that receives create options and returns an Assistant"
+          }
+        },
+        "required": [
+          "id",
+          "factory"
+        ],
+        "returns": "this",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "manager.register('custom-bot', (options) => {\n return container.feature('assistant', {\n   systemPrompt: 'You are a custom bot.',\n   ...options,\n })\n})\nconst bot = manager.create('custom-bot')"
+          }
+        ]
+      },
       "create": {
-        "description": "Creates and returns a new Assistant feature instance for the given name. The assistant is configured with the discovered folder path. Any additional options are merged in.",
+        "description": "Creates and returns a new Assistant feature instance for the given name. Checks runtime-registered factories first, then falls back to discovered entries. The assistant is configured with the discovered folder path. Any additional options are merged in.",
         "parameters": {
           "name": {
             "type": "string",
-            "description": "The assistant name (must match a discovered entry)"
+            "description": "The assistant name (must match a registered factory or discovered entry)"
           },
           "options": {
             "type": "Record<string, any>",
@@ -24670,7 +25335,7 @@ export const introspectionData = [
         "examples": [
           {
             "language": "ts",
-            "code": "const assistant = manager.create('assistants/chief-of-staff', { model: 'gpt-4.1' })"
+            "code": "const assistant = manager.create('chief-of-staff', { model: 'gpt-4.1' })"
           }
         ]
       },
@@ -24695,6 +25360,18 @@ export const introspectionData = [
       }
     },
     "getters": {
+      "entries": {
+        "description": "Discovered assistant entries keyed by name.",
+        "returns": "Record<string, AssistantEntry>"
+      },
+      "instances": {
+        "description": "Active assistant instances keyed by name.",
+        "returns": "Record<string, Assistant>"
+      },
+      "factories": {
+        "description": "Registered factory functions keyed by name.",
+        "returns": "Record<string, (options: Record<string, any>) => Assistant>"
+      },
       "available": {
         "description": "",
         "returns": "any"
@@ -24706,6 +25383,11 @@ export const introspectionData = [
         "description": "Event emitted by AssistantsManager",
         "arguments": {}
       },
+      "assistantRegistered": {
+        "name": "assistantRegistered",
+        "description": "Event emitted by AssistantsManager",
+        "arguments": {}
+      },
       "assistantCreated": {
         "name": "assistantCreated",
         "description": "Event emitted by AssistantsManager",
@@ -24718,7 +25400,7 @@ export const introspectionData = [
     "examples": [
       {
         "language": "ts",
-        "code": "const manager = container.feature('assistantsManager')\nmanager.discover()\nconsole.log(manager.list()) // [{ name: 'assistants/chief-of-staff', folder: '...', ... }]\nconst assistant = manager.create('assistants/chief-of-staff')\nconst answer = await assistant.ask('Hello!')"
+        "code": "const manager = container.feature('assistantsManager')\nmanager.discover()\nconsole.log(manager.list()) // [{ name: 'chief-of-staff', folder: '...', ... }]\nconst assistant = manager.create('chief-of-staff')\nconst answer = await assistant.ask('Hello!')"
       }
     ]
   },
@@ -24728,6 +25410,64 @@ export const introspectionData = [
     "shortcut": "features.conversation",
     "className": "Conversation",
     "methods": {
+      "addTool": {
+        "description": "Add or replace a single tool by name. Uses the same format as tools passed at construction time.",
+        "parameters": {
+          "name": {
+            "type": "string",
+            "description": "Parameter name"
+          },
+          "tool": {
+            "type": "ConversationTool",
+            "description": "Parameter tool",
+            "properties": {
+              "handler": {
+                "type": "(...args: any[]) => Promise<any>",
+                "description": ""
+              },
+              "description": {
+                "type": "string",
+                "description": ""
+              },
+              "parameters": {
+                "type": "Record<string, any>",
+                "description": ""
+              }
+            }
+          }
+        },
+        "required": [
+          "name",
+          "tool"
+        ],
+        "returns": "this"
+      },
+      "removeTool": {
+        "description": "Remove a tool by name.",
+        "parameters": {
+          "name": {
+            "type": "string",
+            "description": "Parameter name"
+          }
+        },
+        "required": [
+          "name"
+        ],
+        "returns": "this"
+      },
+      "updateTools": {
+        "description": "Merge new tools into the conversation, replacing any with the same name. Accepts the same Record<string, ConversationTool> format used at construction time.",
+        "parameters": {
+          "tools": {
+            "type": "Record<string, ConversationTool>",
+            "description": "Parameter tools"
+          }
+        },
+        "required": [
+          "tools"
+        ],
+        "returns": "this"
+      },
       "estimateTokens": {
         "description": "Estimate the input token count for the current messages array using the js-tiktoken tokenizer. Updates state.",
         "parameters": {},
@@ -24808,7 +25548,11 @@ export const introspectionData = [
     "getters": {
       "tools": {
         "description": "Returns the registered tools available for the model to call.",
-        "returns": "Record<string, any>"
+        "returns": "Record<string, ConversationTool>"
+      },
+      "availableTools": {
+        "description": "",
+        "returns": "any"
       },
       "mcpServers": {
         "description": "Returns configured remote MCP servers keyed by server label.",
@@ -25061,8 +25805,8 @@ export const introspectionData = [
       }
     },
     "events": {
-      "loaded": {
-        "name": "loaded",
+      "started": {
+        "name": "started",
         "description": "Event emitted by OpenAPI",
         "arguments": {}
       }
@@ -25077,160 +25821,252 @@ export const introspectionData = [
       }
     ]
   },
+  {
+    "id": "features.docsReader",
+    "description": "The DocsReader feature is an AI Assisted wrapper around a ContentDB feature. You can ask it questions about the content, and it will use the ContentDB to find the answers from the documents.",
+    "shortcut": "features.docsReader",
+    "className": "DocsReader",
+    "methods": {
+      "calculateCacheKeyForQuestion": {
+        "description": "",
+        "parameters": {
+          "question": {
+            "type": "string",
+            "description": "Parameter question"
+          }
+        },
+        "required": [
+          "question"
+        ],
+        "returns": "void"
+      },
+      "ask": {
+        "description": "",
+        "parameters": {
+          "question": {
+            "type": "string",
+            "description": "Parameter question"
+          }
+        },
+        "required": [
+          "question"
+        ],
+        "returns": "void"
+      },
+      "askCached": {
+        "description": "",
+        "parameters": {
+          "question": {
+            "type": "string",
+            "description": "Parameter question"
+          }
+        },
+        "required": [
+          "question"
+        ],
+        "returns": "void"
+      },
+      "start": {
+        "description": "Start the docs reader by loading the contentDb and wiring its tools into an assistant.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<DocsReader>"
+      }
+    },
+    "getters": {
+      "isStarted": {
+        "description": "Whether the docs reader has been started.",
+        "returns": "boolean"
+      },
+      "answerCache": {
+        "description": "",
+        "returns": "any"
+      },
+      "contentDb": {
+        "description": "",
+        "returns": "ContentDb"
+      }
+    },
+    "events": {
+      "started": {
+        "name": "started",
+        "description": "Event emitted by DocsReader",
+        "arguments": {}
+      }
+    },
+    "state": {},
+    "options": {},
+    "envVars": []
+  },
   {
     "id": "features.skillsLibrary",
-    "description": "Manages two contentbase collections of skills following the Claude Code SKILL.md format. Project-level skills live in .claude/skills/ and user-level skills live in ~/.luca/skills/. Skills can be discovered, searched, created, updated, and removed at runtime.",
+    "description": "Manages a registry of skill locations — folders containing SKILL.md files. Persists known locations to ~/.luca/skills.json and scans them on start. Each skill folder can be opened as a DocsReader for AI-assisted Q&A. Exposes tools for assistant integration via assistant.use(skillsLibrary).",
     "shortcut": "features.skillsLibrary",
     "className": "SkillsLibrary",
     "methods": {
-      "load": {
-        "description": "Loads both project and user skill collections from disk. Gracefully handles missing directories.",
+      "start": {
+        "description": "Start the skills library: read config, scan all locations.",
         "parameters": {},
         "required": [],
         "returns": "Promise<SkillsLibrary>"
       },
-      "list": {
-        "description": "Lists all skills from both collections. Project skills come first.",
-        "parameters": {},
-        "required": [],
-        "returns": "SkillEntry[]"
-      },
-      "find": {
-        "description": "Finds a skill by name. Project skills take precedence over user skills.",
+      "addLocation": {
+        "description": "Add a new skill location folder and scan it for skills.",
         "parameters": {
-          "name": {
+          "locationPath": {
             "type": "string",
-            "description": "The skill name to find (case-insensitive)"
+            "description": "Path to a directory containing skill subfolders with SKILL.md"
           }
         },
         "required": [
-          "name"
+          "locationPath"
         ],
-        "returns": "SkillEntry | undefined"
+        "returns": "Promise<void>"
       },
-      "search": {
-        "description": "Searches skills by substring match against name and description.",
+      "removeLocation": {
+        "description": "Remove a skill location and its skills from the library.",
         "parameters": {
-          "query": {
+          "locationPath": {
             "type": "string",
-            "description": "The search query"
+            "description": "The location path to remove"
           }
         },
         "required": [
-          "query"
+          "locationPath"
         ],
-        "returns": "SkillEntry[]"
+        "returns": "Promise<void>"
       },
-      "getSkill": {
-        "description": "Gets a skill by name. Alias for find().",
+      "scanLocation": {
+        "description": "Scan a location folder for skill subfolders containing SKILL.md.",
         "parameters": {
-          "name": {
+          "locationPath": {
             "type": "string",
-            "description": "The skill name"
+            "description": "Absolute path to scan"
           }
         },
         "required": [
-          "name"
+          "locationPath"
         ],
-        "returns": "SkillEntry | undefined"
+        "returns": "Promise<void>"
       },
-      "create": {
-        "description": "Creates a new SKILL.md file in the specified collection. Maintains the directory-per-skill structure (skill-name/SKILL.md).",
+      "list": {
+        "description": "Return all discovered skills.",
+        "parameters": {},
+        "required": [],
+        "returns": "SkillInfo[]"
+      },
+      "find": {
+        "description": "Find a skill by name.",
         "parameters": {
-          "skill": {
-            "type": "{\n\t\t\tname: string\n\t\t\tdescription: string\n\t\t\tbody: string\n\t\t\tmeta?: Record<string, unknown>\n\t\t}",
-            "description": "The skill to create"
-          },
-          "target": {
-            "type": "'project' | 'user'",
-            "description": "Which collection to write to (default: 'project')"
+          "skillName": {
+            "type": "string",
+            "description": "Parameter skillName"
           }
         },
         "required": [
-          "skill"
+          "skillName"
         ],
-        "returns": "Promise<SkillEntry>"
+        "returns": "SkillInfo | undefined"
       },
-      "update": {
-        "description": "Updates an existing skill's content or metadata.",
+      "createSkillReader": {
+        "description": "Create a DocsReader for a skill's folder, enabling AI-assisted Q&A.",
         "parameters": {
-          "name": {
+          "skillName": {
             "type": "string",
-            "description": "The skill name to update"
-          },
-          "updates": {
-            "type": "{\n\t\t\tdescription?: string\n\t\t\tbody?: string\n\t\t\tmeta?: Record<string, unknown>\n\t\t}",
-            "description": "Fields to update"
+            "description": "Name of the skill to create a reader for"
           }
         },
         "required": [
-          "name",
-          "updates"
+          "skillName"
         ],
-        "returns": "Promise<SkillEntry>"
+        "returns": "DocsReader"
       },
-      "remove": {
-        "description": "Removes a skill by name, deleting its SKILL.md and cleaning up the directory.",
+      "ensureFolderCreatedWithSkillsByName": {
+        "description": "Create a tmp directory containing symlinked/copied skill folders by name, suitable for passing to claude --add-dir.",
         "parameters": {
-          "name": {
-            "type": "string",
-            "description": "The skill name to remove"
+          "skillNames": {
+            "type": "string[]",
+            "description": "Array of skill names to include"
           }
         },
         "required": [
-          "name"
+          "skillNames"
         ],
-        "returns": "Promise<boolean>"
+        "returns": "string"
       },
-      "toConversationTools": {
-        "description": "Converts all skills into ConversationTool format for use with Conversation. Each skill becomes a tool that returns its instruction body when invoked.",
-        "parameters": {},
+      "searchAvailableSkills": {
+        "description": "Search available skills, optionally filtered by a query string.",
+        "parameters": {
+          "{ query }": {
+            "type": "{ query?: string }",
+            "description": "Parameter { query }"
+          }
+        },
         "required": [],
-        "returns": "Record<string, ConversationTool>"
+        "returns": "Promise<string>"
       },
-      "toSystemPromptBlock": {
-        "description": "Generates a markdown block listing all available skills with names and descriptions. Suitable for injecting into a system prompt.",
-        "parameters": {},
-        "required": [],
-        "returns": "string"
+      "loadSkill": {
+        "description": "Load a skill's full SKILL.md content and metadata.",
+        "parameters": {
+          "{ skillName }": {
+            "type": "{ skillName: string }",
+            "description": "Parameter { skillName }"
+          }
+        },
+        "required": [
+          "{ skillName }"
+        ],
+        "returns": "Promise<string>"
+      },
+      "askSkillBasedQuestion": {
+        "description": "Ask a question about a specific skill using a DocsReader.",
+        "parameters": {
+          "{ skillName, question }": {
+            "type": "{ skillName: string; question: string }",
+            "description": "Parameter { skillName, question }"
+          }
+        },
+        "required": [
+          "{ skillName, question }"
+        ],
+        "returns": "Promise<string>"
       }
     },
     "getters": {
-      "projectCollection": {
-        "description": "Returns the project-level contentbase Collection, lazily initialized.",
-        "returns": "Collection"
+      "skills": {
+        "description": "Discovered skills keyed by name.",
+        "returns": "Record<string, SkillInfo>"
+      },
+      "availableSkills": {
+        "description": "",
+        "returns": "any"
       },
-      "userCollection": {
-        "description": "Returns the user-level contentbase Collection, lazily initialized.",
-        "returns": "Collection"
+      "skillsTable": {
+        "description": "",
+        "returns": "Record<string, string>"
       },
-      "isLoaded": {
-        "description": "Whether the skills library has been loaded.",
-        "returns": "boolean"
+      "configPath": {
+        "description": "Resolved path to the skills.json config file.",
+        "returns": "string"
       },
-      "skillNames": {
-        "description": "Array of all skill names across both collections.",
-        "returns": "string[]"
+      "isStarted": {
+        "description": "Whether the library has been loaded.",
+        "returns": "boolean"
       }
     },
     "events": {
-      "loaded": {
-        "name": "loaded",
-        "description": "Event emitted by SkillsLibrary",
-        "arguments": {}
-      },
-      "skillCreated": {
-        "name": "skillCreated",
+      "started": {
+        "name": "started",
         "description": "Event emitted by SkillsLibrary",
         "arguments": {}
       },
-      "skillUpdated": {
-        "name": "skillUpdated",
+      "locationAdded": {
+        "name": "locationAdded",
         "description": "Event emitted by SkillsLibrary",
         "arguments": {}
       },
-      "skillRemoved": {
-        "name": "skillRemoved",
+      "skillDiscovered": {
+        "name": "skillDiscovered",
         "description": "Event emitted by SkillsLibrary",
         "arguments": {}
       }
@@ -25241,7 +26077,7 @@ export const introspectionData = [
     "examples": [
       {
         "language": "ts",
-        "code": "const skills = container.feature('skillsLibrary')\nawait skills.load()\n\n// List and search\nconst allSkills = skills.list()\nconst matches = skills.search('code review')\n\n// Create a new skill\nawait skills.create({\n name: 'summarize',\n description: 'Summarize a document',\n body: '## Instructions\\nRead the document and produce a concise summary.'\n})"
+        "code": "const lib = container.feature('skillsLibrary')\nawait lib.start()\nawait lib.addLocation('~/.claude/skills')\nlib.list() // => SkillInfo[]\nconst reader = lib.createSkillReader('my-skill')"
       }
     ]
   },
@@ -25258,27 +26094,31 @@ export const introspectionData = [
         "returns": "void"
       },
       "use": {
-        "description": "Apply a setup function to this assistant. The function receives the assistant instance and can configure tools, hooks, event listeners, etc.",
+        "description": "Apply a setup function or a Helper instance to this assistant. When passed a function, it receives the assistant and can configure tools, hooks, event listeners, etc. When passed a Helper instance that exposes tools via toTools(), those tools are automatically added to this assistant.",
         "parameters": {
-          "fn": {
-            "type": "(assistant: this) => void | Promise<void>",
-            "description": "Setup function that receives this assistant"
+          "fnOrHelper": {
+            "type": "((assistant: this) => void | Promise<void>) | { toTools: () => { schemas: Record<string, z.ZodType>, handlers: Record<string, Function> } } | { schemas: Record<string, z.ZodType>, handlers: Record<string, Function> }",
+            "description": "Setup function or Helper instance"
           }
         },
         "required": [
-          "fn"
+          "fnOrHelper"
         ],
         "returns": "this",
         "examples": [
           {
             "language": "ts",
-            "code": "assistant\n .use(setupLogging)\n .use(addAnalyticsTools)"
+            "code": "assistant\n .use(setupLogging)\n .use(container.feature('git'))"
           }
         ]
       },
       "addTool": {
         "description": "Add a tool to this assistant. The tool name is derived from the handler's function name.",
         "parameters": {
+          "name": {
+            "type": "string",
+            "description": "Parameter name"
+          },
           "handler": {
             "type": "(...args: any[]) => any",
             "description": "A named function that implements the tool"
@@ -25289,6 +26129,7 @@ export const introspectionData = [
           }
         },
         "required": [
+          "name",
           "handler"
         ],
         "returns": "this",
@@ -25354,7 +26195,7 @@ export const introspectionData = [
         "returns": "this"
       },
       "loadSystemPrompt": {
-        "description": "Load the system prompt from CORE.md, applying any prepend/append options.",
+        "description": "Load the system prompt from CORE.md, applying any prepend/append options. YAML frontmatter (between --- fences) is stripped from the prompt and stored in `_meta`.",
         "parameters": {},
         "required": [],
         "returns": "string"
@@ -25440,6 +26281,29 @@ export const introspectionData = [
         },
         "required": [],
         "returns": "void"
+      },
+      "subagent": {
+        "description": "Get or create a subagent assistant. Uses the assistantsManager to discover and create the assistant, then caches the instance for reuse across tool calls.",
+        "parameters": {
+          "id": {
+            "type": "string",
+            "description": "The assistant name (e.g. 'codingAssistant')"
+          },
+          "options": {
+            "type": "Record<string, any>",
+            "description": "Additional options to pass to the assistant constructor"
+          }
+        },
+        "required": [
+          "id"
+        ],
+        "returns": "Promise<Assistant>",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const researcher = await assistant.subagent('codingAssistant')\nconst answer = await researcher.ask('Find all usages of container.feature(\"fs\")')"
+          }
+        ]
       }
     },
     "getters": {
@@ -25483,6 +26347,10 @@ export const introspectionData = [
         "description": "",
         "returns": "Conversation"
       },
+      "availableTools": {
+        "description": "",
+        "returns": "any"
+      },
       "messages": {
         "description": "",
         "returns": "any"
@@ -25499,6 +26367,10 @@ export const introspectionData = [
         "description": "The tools registered with this assistant.",
         "returns": "Record<string, ConversationTool>"
       },
+      "meta": {
+        "description": "Parsed YAML frontmatter from CORE.md, or empty object if none.",
+        "returns": "Record<string, any>"
+      },
       "paths": {
         "description": "Provides a helper for creating paths off of the assistant's base folder",
         "returns": "any"
@@ -25522,6 +26394,10 @@ export const introspectionData = [
       "currentThreadId": {
         "description": "The active thread ID (undefined in lifecycle mode).",
         "returns": "string | undefined"
+      },
+      "availableSubagents": {
+        "description": "Names of assistants available as subagents, discovered via the assistantsManager.",
+        "returns": "string[]"
       }
     },
     "events": {
@@ -25530,6 +26406,11 @@ export const introspectionData = [
         "description": "Event emitted by Assistant",
         "arguments": {}
       },
+      "toolsChanged": {
+        "name": "toolsChanged",
+        "description": "Event emitted by Assistant",
+        "arguments": {}
+      },
       "hookFired": {
         "name": "hookFired",
         "description": "Event emitted by Assistant",
@@ -27192,6 +28073,10 @@ export const containerIntrospectionData = [
         "description": "Returns a map of enabled feature shortcut IDs to their instances.",
         "returns": "Partial<AvailableInstanceTypes<Features>>"
       },
+      "describer": {
+        "description": "Lazy-initialized ContainerDescriber for introspecting registries, helpers, and members.",
+        "returns": "ContainerDescriber"
+      },
       "context": {
         "description": "The Container's context is an object that contains the enabled features, the container itself, and any additional context that has been added to the container. All helper instances that are created by the container will have access to the shared context.",
         "returns": "ContainerContext<Features> & Partial<AvailableInstanceTypes<AvailableFeatures>>"