luca 3.0.0 → 3.1.0

package/src/node/features/transpiler.ts

@@ -145,16 +145,15 @@ export class Transpiler extends Feature {
       entrypoints: [filePath],
       target: 'bun',
       format: 'cjs',
-      bundle: true,
       external,
-    })
+    } as any)
 
     if (!result.success) {
       const msgs = result.logs.map((l: any) => l.message || String(l)).join('\n')
       throw new Error(`Bundle failed for ${filePath}:\n${msgs}`)
     }
 
-    return await result.outputs[0].text()
+    return await result.outputs[0]!.text()
   }
 }
 

package/src/node/features/ui.ts

@@ -72,6 +72,11 @@ export class UI<T extends UIState = UIState> extends Feature<T> {
   print: ColoredPrintFunction = Object.assign((...args: any[]) => {
     return console.log(...args)
   }, {
+    error: (text: string) => console.log(colors.red(text)),
+    info: (text: string) => console.log(text),
+    success: (text: string) => console.log(colors.green(text)),
+    warn: (text: string) => console.log(colors.yellow(text)),
+    warning: (text: string) => console.log(colors.yellow(text)),
     red: (text: string) => console.log(colors.red(text)),
     green: (text: string) => console.log(colors.green(text)),
     blue: (text: string) => console.log(colors.blue(text)),

package/src/node/features/vm.ts

@@ -55,17 +55,17 @@ export class VM<
    * Register a virtual module that will be available to `require()` inside VM-executed code.
    * Modules registered here take precedence over Node's native resolution.
    *
-   * @param id - The module specifier (e.g. `'@soederpop/luca'`, `'zod'`)
+   * @param id - The module specifier (e.g. `'luca'`, `'zod'`)
    * @param exports - The module's exports object
    *
    * @example
    * ```typescript
    * const vm = container.feature('vm')
-   * vm.defineModule('@soederpop/luca', { Container, Feature, fs, proc })
+   * vm.defineModule('luca', { Container, Feature, fs, proc })
    * vm.defineModule('zod', { z })
    *
    * // Now loadModule can resolve these in user code:
-   * // import { Container } from '@soederpop/luca'  → works
+   * // import { Container } from 'luca'  → works
    * ```
    */
   defineModule(id: string, exports: any): void {
@@ -165,6 +165,15 @@ export class VM<
       Buffer,
       URL,
       URLSearchParams,
+      AbortController,
+      AbortSignal,
+      FormData,
+      Blob,
+      File,
+      Headers,
+      Request,
+      Response,
+      fetch,
       ...this.container.context,
       ...ctx
     })
@@ -451,6 +460,14 @@ export class VM<
       Buffer,
       URL,
       URLSearchParams,
+      AbortController,
+      AbortSignal,
+      FormData,
+      Blob,
+      File,
+      Headers,
+      Request,
+      Response,
       fetch,
       ...ctx,
     })

package/src/node.ts

@@ -17,7 +17,7 @@ export default container as NodeContainer
 export function createContainer() {
   console.warn(
     '[luca] createContainer() is unnecessary — import the default export instead.\n' +
-    '       `import container from "@soederpop/luca"`\n' +
+    '       `import container from "luca"`\n' +
     '       For a separate instance, use container.subcontainer().'
   )
   return container
@@ -45,7 +45,7 @@ export { Client, ClientsRegistry } from './client'
 export { RestClient } from './clients/rest'
 export { GraphClient } from './clients/graph'
 export { WebSocketClient } from './clients/websocket'
-export { Command, CommandsRegistry, commands } from './command'
+export { Command, CommandsRegistry, commands, graftModule } from './command'
 export { Endpoint, EndpointsRegistry, endpoints } from './endpoint'
 export { Selector, SelectorsRegistry, selectors } from './selector'
 export { Server, ServersRegistry } from './server'
@@ -69,7 +69,7 @@ export type { Entity } from './entity'
 export type { EventMap } from './bus'
 export type { SetStateValue, StateChangeType } from './state'
 
-// Zod — so consumer code can `import { z } from '@soederpop/luca'`
+// Zod — so consumer code can `import { z } from 'luca'`
 export { z } from 'zod'
 
 // Schemas

package/src/python/generated.ts

@@ -1,5 +1,4 @@
 // Auto-generated Python bridge script
-// Generated at: 2026-04-10T05:00:55.842Z
 // Source: src/python/bridge.py
 //
 // Do not edit manually. Run: luca build-python-bridge

package/src/scaffolds/generated.ts

@@ -1,5 +1,4 @@
 // Auto-generated scaffold and MCP readme content
-// Generated at: 2026-04-10T05:00:53.697Z
 // Source: docs/scaffolds/*.md, docs/examples/assistant/, and docs/mcp/readme.md
 //
 // Do not edit manually. Run: luca build-scaffolds
@@ -19,8 +18,8 @@ export const scaffolds: Record<string, ScaffoldData> = {
   feature: {
     sections: [
       { heading: "Imports", code: `import { z } from 'zod'
-import { FeatureStateSchema, FeatureOptionsSchema, FeatureEventsSchema } from '@soederpop/luca'
-import { Feature } from '@soederpop/luca'` },
+import { FeatureStateSchema, FeatureOptionsSchema, FeatureEventsSchema } from 'luca'
+import { Feature } from 'luca'` },
       { heading: "Schemas", code: `export const {{PascalName}}StateSchema = FeatureStateSchema.extend({
   // Add your state fields here. These are observable — changes emit events.
   // Example: itemCount: z.number().default(0).describe('Number of items stored'),
@@ -61,7 +60,7 @@ export class {{PascalName}} extends Feature<{{PascalName}}State, {{PascalName}}O
     // Set up initial state, start background tasks, etc.
   }
 }` },
-      { heading: "Module Augmentation", code: `declare module '@soederpop/luca' {
+      { heading: "Module Augmentation", code: `declare module 'luca' {
   interface AvailableFeatures {
     {{camelName}}: typeof {{PascalName}}
   }
@@ -72,10 +71,10 @@ static { Feature.register(this, '{{camelName}}') }
 // At module level:
 export default {{PascalName}}` },
       { heading: "Complete Example", code: `import { z } from 'zod'
-import { FeatureStateSchema, FeatureOptionsSchema } from '@soederpop/luca'
-import { Feature } from '@soederpop/luca'
+import { FeatureStateSchema, FeatureOptionsSchema } from 'luca'
+import { Feature } from 'luca'
 
-declare module '@soederpop/luca' {
+declare module 'luca' {
   interface AvailableFeatures {
     {{camelName}}: typeof {{PascalName}}
   }
@@ -111,10 +110,10 @@ export class {{PascalName}} extends Feature<{{PascalName}}State, {{PascalName}}O
 export default {{PascalName}}` }
     ],
     full: `import { z } from 'zod'
-import { FeatureStateSchema, FeatureOptionsSchema } from '@soederpop/luca'
-import { Feature } from '@soederpop/luca'
+import { FeatureStateSchema, FeatureOptionsSchema } from 'luca'
+import { Feature } from 'luca'
 
-declare module '@soederpop/luca' {
+declare module 'luca' {
   interface AvailableFeatures {
     {{camelName}}: typeof {{PascalName}}
   }
@@ -161,8 +160,8 @@ When to build a feature:
 
 \`\`\`ts
 import { z } from 'zod'
-import { FeatureStateSchema, FeatureOptionsSchema, FeatureEventsSchema } from '@soederpop/luca'
-import { Feature } from '@soederpop/luca'
+import { FeatureStateSchema, FeatureOptionsSchema, FeatureEventsSchema } from 'luca'
+import { Feature } from 'luca'
 \`\`\`
 
 These are the only imports your feature file needs from luca. If your feature wraps a third-party library, import it here too — feature implementations are the ONE place where direct library imports are allowed.
@@ -234,7 +233,7 @@ export class {{PascalName}} extends Feature<{{PascalName}}State, {{PascalName}}O
 This is what gives \`container.feature('yourName')\` TypeScript autocomplete. Without it, the feature works but TypeScript won't know about it.
 
 \`\`\`ts
-declare module '@soederpop/luca' {
+declare module 'luca' {
   interface AvailableFeatures {
     {{camelName}}: typeof {{PascalName}}
   }
@@ -259,10 +258,10 @@ Here's a minimal but complete feature. This is what a real feature file looks li
 
 \`\`\`ts
 import { z } from 'zod'
-import { FeatureStateSchema, FeatureOptionsSchema } from '@soederpop/luca'
-import { Feature } from '@soederpop/luca'
+import { FeatureStateSchema, FeatureOptionsSchema } from 'luca'
+import { Feature } from 'luca'
 
-declare module '@soederpop/luca' {
+declare module 'luca' {
   interface AvailableFeatures {
     {{camelName}}: typeof {{PascalName}}
   }
@@ -311,8 +310,8 @@ export default {{PascalName}}
   client: {
     sections: [
       { heading: "Imports", code: `import { z } from 'zod'
-import { Client, RestClient } from '@soederpop/luca/client'
-import { ClientStateSchema, ClientOptionsSchema, ClientEventsSchema } from '@soederpop/luca'` },
+import { Client, RestClient } from 'luca/client'
+import { ClientStateSchema, ClientOptionsSchema, ClientEventsSchema } from 'luca'` },
       { heading: "Schemas", code: `export const {{PascalName}}StateSchema = ClientStateSchema.extend({
   // Add your state fields here.
   // Example: authenticated: z.boolean().default(false).describe('Whether API auth is configured'),
@@ -354,7 +353,7 @@ export class {{PascalName}} extends RestClient<{{PascalName}}State, {{PascalName
   //   return this.get('/items')
   // }
 }` },
-      { heading: "Module Augmentation", code: `declare module '@soederpop/luca/client' {
+      { heading: "Module Augmentation", code: `declare module 'luca/client' {
   interface AvailableClients {
     {{camelName}}: typeof {{PascalName}}
   }
@@ -365,10 +364,10 @@ static { Client.register(this, '{{camelName}}') }
 // At module level:
 export default {{PascalName}}` },
       { heading: "Complete Example", code: `import { z } from 'zod'
-import { Client, RestClient } from '@soederpop/luca/client'
-import { ClientStateSchema, ClientOptionsSchema } from '@soederpop/luca'
+import { Client, RestClient } from 'luca/client'
+import { ClientStateSchema, ClientOptionsSchema } from 'luca'
 
-declare module '@soederpop/luca/client' {
+declare module 'luca/client' {
   interface AvailableClients {
     {{camelName}}: typeof {{PascalName}}
   }
@@ -406,10 +405,10 @@ export class {{PascalName}} extends RestClient<{{PascalName}}State, {{PascalName
 export default {{PascalName}}` }
     ],
     full: `import { z } from 'zod'
-import { Client, RestClient } from '@soederpop/luca/client'
-import { ClientStateSchema, ClientOptionsSchema } from '@soederpop/luca'
+import { Client, RestClient } from 'luca/client'
+import { ClientStateSchema, ClientOptionsSchema } from 'luca'
 
-declare module '@soederpop/luca/client' {
+declare module 'luca/client' {
   interface AvailableClients {
     {{camelName}}: typeof {{PascalName}}
   }
@@ -458,8 +457,8 @@ When to build a client:
 
 \`\`\`ts
 import { z } from 'zod'
-import { Client, RestClient } from '@soederpop/luca/client'
-import { ClientStateSchema, ClientOptionsSchema, ClientEventsSchema } from '@soederpop/luca'
+import { Client, RestClient } from 'luca/client'
+import { ClientStateSchema, ClientOptionsSchema, ClientEventsSchema } from 'luca'
 \`\`\`
 
 Use \`RestClient\` for HTTP APIs (most common). It gives you \`get\`, \`post\`, \`put\`, \`patch\`, \`delete\` methods that handle JSON, headers, and error wrapping.
@@ -522,7 +521,7 @@ export class {{PascalName}} extends RestClient<{{PascalName}}State, {{PascalName
 ## Module Augmentation
 
 \`\`\`ts
-declare module '@soederpop/luca/client' {
+declare module 'luca/client' {
   interface AvailableClients {
     {{camelName}}: typeof {{PascalName}}
   }
@@ -545,10 +544,10 @@ export default {{PascalName}}
 
 \`\`\`ts
 import { z } from 'zod'
-import { Client, RestClient } from '@soederpop/luca/client'
-import { ClientStateSchema, ClientOptionsSchema } from '@soederpop/luca'
+import { Client, RestClient } from 'luca/client'
+import { ClientStateSchema, ClientOptionsSchema } from 'luca'
 
-declare module '@soederpop/luca/client' {
+declare module 'luca/client' {
   interface AvailableClients {
     {{camelName}}: typeof {{PascalName}}
   }
@@ -599,10 +598,10 @@ export default {{PascalName}}
   server: {
     sections: [
       { heading: "Imports", code: `import { z } from 'zod'
-import { Server } from '@soederpop/luca'
-import { ServerStateSchema, ServerOptionsSchema, ServerEventsSchema } from '@soederpop/luca'
-import type { NodeContainer } from '@soederpop/luca'
-import type { ServersInterface } from '@soederpop/luca'` },
+import { Server } from 'luca'
+import { ServerStateSchema, ServerOptionsSchema, ServerEventsSchema } from 'luca'
+import type { NodeContainer } from 'luca'
+import type { ServersInterface } from 'luca'` },
       { heading: "Schemas", code: `export const {{PascalName}}StateSchema = ServerStateSchema.extend({
   // Add your state fields here.
   // Example: connectionCount: z.number().default(0).describe('Active connections'),
@@ -667,7 +666,7 @@ export class {{PascalName}} extends Server<{{PascalName}}State, {{PascalName}}Op
     return this
   }
 }` },
-      { heading: "Module Augmentation", code: `declare module '@soederpop/luca' {
+      { heading: "Module Augmentation", code: `declare module 'luca' {
   interface AvailableServers {
     {{camelName}}: typeof {{PascalName}}
   }
@@ -678,12 +677,12 @@ static { Server.register(this, '{{camelName}}') }
 // At module level:
 export default {{PascalName}}` },
       { heading: "Complete Example", code: `import { z } from 'zod'
-import { Server } from '@soederpop/luca'
-import { ServerStateSchema, ServerOptionsSchema, ServerEventsSchema } from '@soederpop/luca'
-import type { NodeContainer } from '@soederpop/luca'
-import type { ServersInterface } from '@soederpop/luca'
+import { Server } from 'luca'
+import { ServerStateSchema, ServerOptionsSchema, ServerEventsSchema } from 'luca'
+import type { NodeContainer } from 'luca'
+import type { ServersInterface } from 'luca'
 
-declare module '@soederpop/luca' {
+declare module 'luca' {
   interface AvailableServers {
     {{camelName}}: typeof {{PascalName}}
   }
@@ -745,12 +744,12 @@ export class {{PascalName}} extends Server<{{PascalName}}State, {{PascalName}}Op
 export default {{PascalName}}` }
     ],
     full: `import { z } from 'zod'
-import { Server } from '@soederpop/luca'
-import { ServerStateSchema, ServerOptionsSchema, ServerEventsSchema } from '@soederpop/luca'
-import type { NodeContainer } from '@soederpop/luca'
-import type { ServersInterface } from '@soederpop/luca'
+import { Server } from 'luca'
+import { ServerStateSchema, ServerOptionsSchema, ServerEventsSchema } from 'luca'
+import type { NodeContainer } from 'luca'
+import type { ServersInterface } from 'luca'
 
-declare module '@soederpop/luca' {
+declare module 'luca' {
   interface AvailableServers {
     {{camelName}}: typeof {{PascalName}}
   }
@@ -823,10 +822,10 @@ When to build a server:
 
 \`\`\`ts
 import { z } from 'zod'
-import { Server } from '@soederpop/luca'
-import { ServerStateSchema, ServerOptionsSchema, ServerEventsSchema } from '@soederpop/luca'
-import type { NodeContainer } from '@soederpop/luca'
-import type { ServersInterface } from '@soederpop/luca'
+import { Server } from 'luca'
+import { ServerStateSchema, ServerOptionsSchema, ServerEventsSchema } from 'luca'
+import type { NodeContainer } from 'luca'
+import type { ServersInterface } from 'luca'
 \`\`\`
 
 ## Schemas
@@ -908,7 +907,7 @@ export class {{PascalName}} extends Server<{{PascalName}}State, {{PascalName}}Op
 ## Module Augmentation
 
 \`\`\`ts
-declare module '@soederpop/luca' {
+declare module 'luca' {
   interface AvailableServers {
     {{camelName}}: typeof {{PascalName}}
   }
@@ -931,12 +930,12 @@ export default {{PascalName}}
 
 \`\`\`ts
 import { z } from 'zod'
-import { Server } from '@soederpop/luca'
-import { ServerStateSchema, ServerOptionsSchema, ServerEventsSchema } from '@soederpop/luca'
-import type { NodeContainer } from '@soederpop/luca'
-import type { ServersInterface } from '@soederpop/luca'
+import { Server } from 'luca'
+import { ServerStateSchema, ServerOptionsSchema, ServerEventsSchema } from 'luca'
+import type { NodeContainer } from 'luca'
+import type { ServersInterface } from 'luca'
 
-declare module '@soederpop/luca' {
+declare module 'luca' {
   interface AvailableServers {
     {{camelName}}: typeof {{PascalName}}
   }
@@ -1011,7 +1010,7 @@ export default {{PascalName}}
   command: {
     sections: [
       { heading: "Imports", code: `import { z } from 'zod'
-import type { ContainerContext } from '@soederpop/luca'` },
+import type { ContainerContext } from 'luca'` },
       { heading: "Positional Arguments", code: `// luca {{kebabName}} ./src  =>  options.target === './src'
 export const positionals = ['target']` },
       { heading: "Args Schema", code: `export const argsSchema = z.object({
@@ -1033,7 +1032,7 @@ export const positionals = ['target']` },
   // Your implementation here
 }` },
       { heading: "Complete Example", code: `import { z } from 'zod'
-import type { ContainerContext } from '@soederpop/luca'
+import type { ContainerContext } from 'luca'
 
 export const description = '{{description}}'
 
@@ -1070,7 +1069,7 @@ export default async function {{camelName}}(options: z.infer<typeof argsSchema>,
 }` }
     ],
     full: `import { z } from 'zod'
-import type { ContainerContext } from '@soederpop/luca'
+import type { ContainerContext } from 'luca'
 
 export const description = '{{description}}'
 
@@ -1100,7 +1099,7 @@ When to build a command:
 
 \`\`\`ts
 import { z } from 'zod'
-import type { ContainerContext } from '@soederpop/luca'
+import type { ContainerContext } from 'luca'
 \`\`\`
 
 ## Positional Arguments
@@ -1155,7 +1154,7 @@ export default async function {{camelName}}(options: z.infer<typeof argsSchema>,
 
 \`\`\`ts
 import { z } from 'zod'
-import type { ContainerContext } from '@soederpop/luca'
+import type { ContainerContext } from 'luca'
 
 export const description = '{{description}}'
 
@@ -1322,7 +1321,7 @@ Run \`luca serve\` and they're automatically discovered and mounted.
 
 Endpoints are lightweight — just exports and handler functions. No imports are required.
 
-If your project has \`@soederpop/luca\` as an npm dependency, you can import \`z\` from \`zod\` and \`EndpointContext\` from \`@soederpop/luca\` for type safety. Otherwise, use \`any\` types — the framework handles validation and context injection for you.
+If your project has \`luca\` as an npm dependency, you can import \`z\` from \`zod\` and \`EndpointContext\` from \`luca\` for type safety. Otherwise, use \`any\` types — the framework handles validation and context injection for you.
 
 Access framework capabilities through the \`ctx\` parameter:
 - \`ctx.container.feature('fs')\` for file operations
@@ -1368,7 +1367,7 @@ Return any object — it's automatically JSON-serialized as the response.
 
 ## Validation Schemas
 
-If \`zod\` is available (via \`@soederpop/luca\` dependency or \`node_modules\`), export Zod schemas to validate parameters for each method. Name them \`{method}Schema\`:
+If \`zod\` is available (via \`luca\` dependency or \`node_modules\`), export Zod schemas to validate parameters for each method. Name them \`{method}Schema\`:
 
 \`\`\`ts
 import { z } from 'zod'
@@ -1476,7 +1475,7 @@ export { del as delete }
   selector: {
     sections: [
       { heading: "Imports", code: `import { z } from 'zod'
-import type { ContainerContext } from '@soederpop/luca'` },
+import type { ContainerContext } from 'luca'` },
       { heading: "Args Schema", code: `export const argsSchema = z.object({
   // Add your input arguments here.
   // Example: field: z.string().optional().describe('Specific field to return'),
@@ -1492,7 +1491,7 @@ import type { ContainerContext } from '@soederpop/luca'` },
   return { /* your data */ }
 }` },
       { heading: "Complete Example", code: `import { z } from 'zod'
-import type { ContainerContext } from '@soederpop/luca'
+import type { ContainerContext } from 'luca'
 
 export const description = '{{description}}'
 
@@ -1506,7 +1505,7 @@ export async function run(args: z.infer<typeof argsSchema>, context: ContainerCo
 }` }
     ],
     full: `import { z } from 'zod'
-import type { ContainerContext } from '@soederpop/luca'
+import type { ContainerContext } from 'luca'
 
 export const description = '{{description}}'
 
@@ -1531,7 +1530,7 @@ When to build a selector:
 
 \`\`\`ts
 import { z } from 'zod'
-import type { ContainerContext } from '@soederpop/luca'
+import type { ContainerContext } from 'luca'
 \`\`\`
 
 ## Args Schema
@@ -1587,7 +1586,7 @@ export async function run(args: z.infer<typeof argsSchema>, context: ContainerCo
 
 \`\`\`ts
 import { z } from 'zod'
-import type { ContainerContext } from '@soederpop/luca'
+import type { ContainerContext } from 'luca'
 
 export const description = '{{description}}'
 
@@ -1660,20 +1659,20 @@ Every capability goes through the container. If you need something that doesn't
 
 ## Import Rule
 
-All consumer code imports from \`@soederpop/luca\` only:
+All consumer code imports from \`luca\` only:
 
 \`\`\`ts
-import { Feature, features, z, FeatureStateSchema, FeatureOptionsSchema } from '@soederpop/luca'
-import { Client, clients, RestClient, ClientStateSchema } from '@soederpop/luca/client'
-import { Server, servers, ServerStateSchema } from '@soederpop/luca'
-import { commands, CommandOptionsSchema } from '@soederpop/luca'
+import { Feature, features, z, FeatureStateSchema, FeatureOptionsSchema } from 'luca'
+import { Client, clients, RestClient, ClientStateSchema } from 'luca/client'
+import { Server, servers, ServerStateSchema } from 'luca'
+import { commands, CommandOptionsSchema } from 'luca'
 \`\`\`
 
 Never import from \`fs\`, \`path\`, \`crypto\`, or other Node builtins. Never import third-party packages in consumer code. If a container feature wraps the functionality, use it.
 
 ## Zod v4
 
-This project uses **Zod v4** — import \`z\` from \`@soederpop/luca\`, never from \`'zod'\` directly. All option, state, and event schemas use Zod v4 syntax. Key patterns:
+This project uses **Zod v4** — import \`z\` from \`luca\`, never from \`'zod'\` directly. All option, state, and event schemas use Zod v4 syntax. Key patterns:
 
 \`\`\`ts
 // Extending base schemas (options, state, events)
@@ -1700,7 +1699,7 @@ Zod v4 differences from v3 that matter:
 
 ## Dependencies
 
-If the project has \`node_modules\` and a package manager, helper implementations can import third-party libraries internally. If not (e.g. running via the \`luca\` binary's VM), all code must import only from \`@soederpop/luca\`.
+If the project has \`node_modules\` and a package manager, helper implementations can import third-party libraries internally. If not (e.g. running via the \`luca\` binary's VM), all code must import only from \`luca\`.
 
 ## Discovering Capabilities
 
@@ -1719,9 +1718,9 @@ Features access other features via \`this.container.feature(...)\`:
 
 \`\`\`ts
 import { z } from 'zod'
-import { FeatureStateSchema, FeatureOptionsSchema, FeatureEventsSchema } from '@soederpop/luca'
-import { Feature, features } from '@soederpop/luca'
-import type { ContainerContext } from '@soederpop/luca'
+import { FeatureStateSchema, FeatureOptionsSchema, FeatureEventsSchema } from 'luca'
+import { Feature, features } from 'luca'
+import type { ContainerContext } from 'luca'
 
 export const ConfigStateSchema = FeatureStateSchema.extend({
   loaded: z.boolean().default(false).describe('Whether config has been loaded'),
@@ -1753,7 +1752,7 @@ export class Config extends Feature<z.infer<typeof ConfigStateSchema>, z.infer<t
   }
 }
 
-declare module '@soederpop/luca' {
+declare module 'luca' {
   interface AvailableFeatures { config: typeof Config }
 }
 export default features.register('config', Config)
@@ -1765,8 +1764,8 @@ Clients access features and other clients via \`this.container\`:
 
 \`\`\`ts
 import { z } from 'zod'
-import { Client, clients, ClientStateSchema, ClientOptionsSchema, ClientEventsSchema } from '@soederpop/luca'
-import type { ContainerContext } from '@soederpop/luca'
+import { Client, clients, ClientStateSchema, ClientOptionsSchema, ClientEventsSchema } from 'luca'
+import type { ContainerContext } from 'luca'
 
 export const GithubOptionsSchema = ClientOptionsSchema.extend({
   token: z.string().describe('GitHub personal access token'),
@@ -1795,7 +1794,7 @@ export class GithubClient extends Client<z.infer<typeof ClientStateSchema>, z.in
   }
 }
 
-declare module '@soederpop/luca' {
+declare module 'luca' {
   interface AvailableClients { github: typeof GithubClient }
 }
 export default clients.register('github', GithubClient)
@@ -1811,5 +1810,5 @@ export default clients.register('github', GithubClient)
 
 ## Portability
 
-Code that only imports from \`@soederpop/luca\` can be copied between any luca project. That's the goal. Features, clients, servers, and commands written this way are portable building blocks.
+Code that only imports from \`luca\` can be copied between any luca project. That's the goal. Features, clients, servers, and commands written this way are portable building blocks.
 `

package/src/selector.ts

@@ -29,7 +29,7 @@ export interface SelectorsInterface {
  *
  * @example
  * ```typescript
- * declare module '@soederpop/luca' {
+ * declare module 'luca' {
  *   interface AvailableSelectors {
  *     packageInfo: SimpleSelector<typeof argsSchema>
  *   }

package/src/servers/express.ts

@@ -183,7 +183,7 @@ export class ExpressServer<T extends ServerState = ServerState, K extends Expres
       const glob = new Glob('**/*.ts')
 
       // Use the helpers feature's VM-aware loader so endpoints can resolve
-      // packages like zod and @soederpop/luca even from the compiled binary
+      // packages like zod and luca even from the compiled binary
       const helpers = this.container.feature('helpers') as any
 
       for await (const file of glob.scan({ cwd: dir, absolute: true })) {

package/src/web/features/helpers.ts

@@ -2,6 +2,8 @@ import { z } from 'zod'
 import { FeatureStateSchema, FeatureOptionsSchema, FeatureEventsSchema } from '../../schemas/base.js'
 import { Feature } from '../feature.js'
 import { Client } from '../../client.js'
+import { allHelperInstances } from '../../container.js'
+import type { Helper } from '../../helper.js'
 import type { Registry } from '../../registry.js'
 import type { AssetLoader } from './asset-loader.js'
 
@@ -106,6 +108,26 @@ export class Helpers extends Feature<HelpersState, HelpersOptions> {
     this.state.set('manifestLoaded', false)
   }
 
+  /**
+   * Returns all instantiated helper instances across all types, optionally filtered by class.
+   *
+   * @param FilterClass - When provided, only instances of this class are returned.
+   *
+   * @example
+   * ```typescript
+   * // All instances of any type
+   * container.helpers.getInstances()
+   *
+   * // All Assistant instances
+   * const assistants = container.helpers.getInstances(Assistant)
+   * ```
+   */
+  getInstances(): Helper[]
+  getInstances<T extends Helper>(FilterClass: new (...args: any[]) => T): T[]
+  getInstances<T extends Helper>(FilterClass?: new (...args: any[]) => T): Helper[] | T[] {
+    return FilterClass ? allHelperInstances(FilterClass) : allHelperInstances()
+  }
+
   /**
    * Returns a unified view of all available helpers across all registries.
    * Each key is a registry type, each value is the list of helper names in that registry.

package/tsconfig.json

@@ -21,18 +21,18 @@
       "@/*": ["src/*"],
       "@/web/*": ["src/web/*"],
       "@/node/*": ["src/node/*"],
-      "@soederpop/luca": ["src/node.ts"],
-      "@soederpop/luca/node": ["src/node.ts"],
-      "@soederpop/luca/node/*": ["src/node/*"],
-      "@soederpop/luca/agi": ["src/agi/index.ts"],
-      "@soederpop/luca/agi/*": ["src/agi/*"],
-      "@soederpop/luca/web": ["src/browser.ts"],
-      "@soederpop/luca/web/*": ["src/web/*"],
-      "@soederpop/luca/schemas": ["src/schemas/base.ts"],
-      "@soederpop/luca/schemas/*": ["src/schemas/*"],
-      "@soederpop/luca/container": ["src/container.ts"],
-      "@soederpop/luca/client": ["src/client.ts"],
-      "@soederpop/luca/feature": ["src/feature.ts"]
+      "luca": ["src/node.ts"],
+      "luca/node": ["src/node.ts"],
+      "luca/node/*": ["src/node/*"],
+      "luca/agi": ["src/agi/index.ts"],
+      "luca/agi/*": ["src/agi/*"],
+      "luca/web": ["src/browser.ts"],
+      "luca/web/*": ["src/web/*"],
+      "luca/schemas": ["src/schemas/base.ts"],
+      "luca/schemas/*": ["src/schemas/*"],
+      "luca/container": ["src/container.ts"],
+      "luca/client": ["src/client.ts"],
+      "luca/feature": ["src/feature.ts"]
     },
 
     // Best practices