luca 3.0.0 → 3.1.0

package/src/bootstrap/generated.ts

@@ -1,5 +1,4 @@
 // Auto-generated bootstrap content
-// Generated at: 2026-04-10T05:00:54.788Z
 // Source: docs/bootstrap/*.md, docs/bootstrap/templates/*, docs/examples/*.md, docs/tutorials/*.md
 //
 // Do not edit manually. Run: luca build-bootstrap
@@ -7,11 +6,11 @@
 export const bootstrapFiles: Record<string, string> = {
   "SKILL": `---
 name: Using the luca framework
-description: The @soederpop/luca framework, when you see a project with docs/ commands/ features/ luca.cli.ts endpoints/ folders, or @soederpop/luca is in the package.json, or the user is asking you to develop a new Luca feature, use this skill to learn about the APIs and how to learn the framework at runtime.  The luca cli bundles all of the documentation in a searchable, progressively learnable interface designed for students and AI assistants alike
+description: The luca framework, when you see a project with docs/ commands/ features/ luca.cli.ts endpoints/ folders, or luca is in the package.json, or the user is asking you to develop a new Luca feature, use this skill to learn about the APIs and how to learn the framework at runtime.  The luca cli bundles all of the documentation in a searchable, progressively learnable interface designed for students and AI assistants alike
 ---
 # Luca: Learning the Container
 
-The Luca framework \`@soederpop/luca\` ships a \`luca\` binary — a bun-based CLI for a dependency injection container. This project is based on it if this skill is present. The container auto-discovers modules in \`commands/\`, \`clients/\`, \`servers/\`, \`features/\`, and \`endpoints/\` folders.
+The Luca framework \`luca\` ships a \`luca\` binary — a bun-based CLI for a dependency injection container. This project is based on it if this skill is present. The container auto-discovers modules in \`commands/\`, \`clients/\`, \`servers/\`, \`features/\`, and \`endpoints/\` folders.
 
 The \`luca\` cli loads typescript modules in through its VM which injects a \`container\` global that is a singleton object from which you can learn about, and access all different kinds of utils and Helpers (features, clients, servers, commands, and compositions thereof)
 
@@ -551,11 +550,11 @@ Content goes here.
 - \`luca describe contentDb\` — runtime docs for the contentDb feature
 `,
   "example-feature": `import { z } from 'zod'
-import { FeatureStateSchema, FeatureOptionsSchema } from '@soederpop/luca'
-import { Feature } from '@soederpop/luca'
-import type { ContainerContext } from '@soederpop/luca'
+import { FeatureStateSchema, FeatureOptionsSchema } from 'luca'
+import { Feature } from 'luca'
+import type { ContainerContext } from 'luca'
 
-declare module '@soederpop/luca' {
+declare module 'luca' {
   interface AvailableFeatures {
     example: typeof Example
   }
@@ -612,7 +611,7 @@ export default Example
  * For example: \`luca about commands\` → options._[1] === 'commands'
  */
 import { z } from 'zod'
-import type { ContainerContext } from '@soederpop/luca'
+import type { ContainerContext } from 'luca'
 
 export const description = 'Display project information and discovered helpers'
 
@@ -2286,7 +2285,7 @@ Here's the structure of the built-in \`fileTools\` feature (simplified for clari
 
 \`\`\`ts
 import { z } from 'zod'
-import { Feature } from '@soederpop/luca/feature'
+import { Feature } from 'luca/feature'
 
 export class FileTools extends Feature {
   static { Feature.register(this, 'fileTools') }
@@ -5314,7 +5313,7 @@ A feature has:
 
 \`\`\`typescript
 import { z } from 'zod'
-import { Feature, features, FeatureStateSchema, FeatureOptionsSchema } from '@soederpop/luca'
+import { Feature, features, FeatureStateSchema, FeatureOptionsSchema } from 'luca'
 
 // Define state schema by extending the base FeatureStateSchema
 export const CounterStateSchema = FeatureStateSchema.extend({
@@ -5379,7 +5378,7 @@ export class Counter extends Feature<CounterState, CounterOptions> {
 features.register('counter', Counter)
 
 // Module augmentation for type safety
-declare module '@soederpop/luca' {
+declare module 'luca' {
   interface AvailableFeatures {
     counter: typeof Counter
   }
@@ -5671,7 +5670,7 @@ tags: [setup, quickstart, project, init]
 \`\`\`bash
 mkdir my-app && cd my-app
 bun init -y
-bun add @soederpop/luca 
+bun add luca 
 \`\`\`
 
 ## Project Structure
@@ -5705,7 +5704,7 @@ Everything in Luca revolves around the **container**. It is a per-process single
 In scripts, you create one directly:
 
 \`\`\`typescript
-import container from '@soederpop/luca/node'
+import container from 'luca/node'
 
 // Now you have access to all features
 const fs = container.fs           // File system operations
@@ -5791,7 +5790,7 @@ Define schemas for your handlers. Parameters are validated automatically:
 \`\`\`typescript
 // endpoints/users.ts
 import { z } from 'zod'
-import type { EndpointContext } from '@soederpop/luca'
+import type { EndpointContext } from 'luca'
 
 export const path = '/api/users'
 export const description = 'User management'
@@ -5828,7 +5827,7 @@ Use \`:param\` in the path or bracket-based file naming:
 \`\`\`typescript
 // endpoints/users/[id].ts
 import { z } from 'zod'
-import type { EndpointContext } from '@soederpop/luca'
+import type { EndpointContext } from 'luca'
 
 export const path = '/api/users/:id'
 export const description = 'Get, update, or delete a specific user'
@@ -5923,7 +5922,7 @@ The server automatically:
 You can also set up the server in a script:
 
 \`\`\`typescript
-import container from '@soederpop/luca'
+import container from 'luca'
 
 const server = container.server('express', { port: 3000, cors: true })
 
@@ -6267,8 +6266,8 @@ await python.stopSession()
 \`\`\`ts skip
 // commands/analyze.ts
 import { z } from 'zod'
-import type { ContainerContext } from '@soederpop/luca'
-import { CommandOptionsSchema } from '@soederpop/luca/schemas'
+import type { ContainerContext } from 'luca'
+import { CommandOptionsSchema } from 'luca/schemas'
 
 export const positionals = ['target']
 export const argsSchema = CommandOptionsSchema.extend({
@@ -6376,7 +6375,7 @@ Luca's \`semanticSearch\` feature provides BM25 keyword search, vector similarit
 The fastest way to use semantic search is through the \`contentDb\` feature, which handles indexing and querying automatically:
 
 \`\`\`typescript
-import container from '@soederpop/luca'
+import container from 'luca'
 
 const db = container.feature('contentDb', { rootPath: './docs' })
 await db.load()
@@ -6412,8 +6411,8 @@ await db.hybridSearch('authentication flow', { limit: 5 })
 For more control, use the \`semanticSearch\` feature directly:
 
 \`\`\`typescript
-import container from '@soederpop/luca'
-import { SemanticSearch } from '@soederpop/luca/node/features/semantic-search'
+import container from 'luca'
+import { SemanticSearch } from 'luca/node/features/semantic-search'
 
 // Attach the feature to the container
 SemanticSearch.attach(container)
@@ -7233,7 +7232,7 @@ Commands are CLI actions that the \`luca\` command discovers and runs. They are
 \`\`\`typescript
 // commands/seed.ts
 import { z } from 'zod'
-import type { ContainerContext } from '@soederpop/luca'
+import type { ContainerContext } from 'luca'
 
 export const description = 'Seed the database with sample data'
 
@@ -7284,7 +7283,7 @@ The simplest pattern — export a default async function. The function becomes t
 \`\`\`typescript
 // commands/greet.ts
 import { z } from 'zod'
-import type { ContainerContext } from '@soederpop/luca'
+import type { ContainerContext } from 'luca'
 
 export const description = 'Greet someone'
 export const argsSchema = z.object({
@@ -7303,7 +7302,7 @@ Useful when you want to co-locate all exports in one object:
 \`\`\`typescript
 // commands/deploy.ts
 import { z } from 'zod'
-import type { ContainerContext } from '@soederpop/luca'
+import type { ContainerContext } from 'luca'
 
 export const argsSchema = z.object({
   env: z.enum(['staging', 'production']).describe('Target environment'),
@@ -7486,7 +7485,7 @@ Luca's type system ensures that as you add features, clients, servers, and comma
 When you register a new helper, you augment the corresponding interface so TypeScript knows about it:
 
 \`\`\`typescript
-import { Feature, features, FeatureStateSchema, FeatureOptionsSchema } from '@soederpop/luca'
+import { Feature, features, FeatureStateSchema, FeatureOptionsSchema } from 'luca'
 import { z } from 'zod'
 
 // 1. Define your feature
@@ -7498,7 +7497,7 @@ export class MyCache extends Feature<MyCacheState, MyCacheOptions> {
 features.register('myCache', MyCache)
 
 // 3. Augment the interface
-declare module '@soederpop/luca' {
+declare module 'luca' {
   interface AvailableFeatures {
     myCache: typeof MyCache
   }
@@ -7574,28 +7573,28 @@ The pattern is the same for features, clients, servers, and commands:
 
 \`\`\`typescript
 // Features
-declare module '@soederpop/luca' {
+declare module 'luca' {
   interface AvailableFeatures {
     myFeature: typeof MyFeature
   }
 }
 
 // Clients
-declare module '@soederpop/luca' {
+declare module 'luca' {
   interface AvailableClients {
     myClient: typeof MyClient
   }
 }
 
 // Servers
-declare module '@soederpop/luca' {
+declare module 'luca' {
   interface AvailableServers {
     myServer: typeof MyServer
   }
 }
 
 // Commands
-declare module '@soederpop/luca' {
+declare module 'luca' {
   interface AvailableCommands {
     myCommand: typeof MyCommand
   }
@@ -7631,7 +7630,7 @@ export class Analytics extends Feature<AnalyticsState, AnalyticsOptions> { ... }
 
 // 2. You register + augment
 features.register('analytics', Analytics)
-declare module '@soederpop/luca' {
+declare module 'luca' {
   interface AvailableFeatures { analytics: typeof Analytics }
 }
 
@@ -7664,14 +7663,14 @@ The container is the heart of every Luca application. It is a per-process single
 ## Getting the Container
 
 \`\`\`typescript
-import container from '@soederpop/luca'
+import container from 'luca'
 \`\`\`
 
-The import resolves automatically based on environment -- \`@soederpop/luca\` gives you a \`NodeContainer\` on the server and a \`WebContainer\` in browser builds. You can also be explicit:
+The import resolves automatically based on environment -- \`luca\` gives you a \`NodeContainer\` on the server and a \`WebContainer\` in browser builds. You can also be explicit:
 
 \`\`\`typescript
-import container from '@soederpop/luca/node'  // Always NodeContainer
-import container from '@soederpop/luca/web'   // Always WebContainer
+import container from 'luca/node'  // Always NodeContainer
+import container from 'luca/web'   // Always WebContainer
 \`\`\`
 
 The NodeContainer comes pre-loaded with registries for features, clients, servers, commands, and endpoints. Core features like \`fs\`, \`git\`, \`proc\`, \`os\`, \`networking\`, \`ui\`, and \`vm\` are auto-enabled.
@@ -7875,7 +7874,7 @@ You can use Luca in any browser environment — no bundler, no build step. Impor
 
 \`\`\`html
 <script type="module">
-  import "https://esm.sh/@soederpop/luca/web"
+  import "https://esm.sh/luca/web"
 
   const container = window.luca
   console.log(container.uuid) // unique container ID
@@ -7889,7 +7888,7 @@ If you prefer a named import:
 
 \`\`\`html
 <script type="module">
-  import container from "https://esm.sh/@soederpop/luca/web"
+  import container from "https://esm.sh/luca/web"
   // container === window.luca
 </script>
 \`\`\`
@@ -7900,7 +7899,7 @@ Once you have the container, features work exactly like they do on the server
 
 \`\`\`html
 <script type="module">
-  import "https://esm.sh/@soederpop/luca/web"
+  import "https://esm.sh/luca/web"
   const { luca: container } = window
 
   // Load a script from a CDN
@@ -7927,7 +7926,7 @@ The container is a state machine and event bus. This works identically to the se
 
 \`\`\`html
 <script type="module">
-  import container from "https://esm.sh/@soederpop/luca/web"
+  import container from "https://esm.sh/luca/web"
 
   // Listen for state changes
   container.on('stateChanged', ({ changes }) => {
@@ -7948,7 +7947,7 @@ Make HTTP requests with the built-in REST client. Methods return parsed JSON dir
 
 \`\`\`html
 <script type="module">
-  import container from "https://esm.sh/@soederpop/luca/web"
+  import container from "https://esm.sh/luca/web"
 
   const api = container.client('rest', { baseURL: 'https://jsonplaceholder.typicode.com' })
   const posts = await api.get('/posts')
@@ -7962,7 +7961,7 @@ Connect to a WebSocket server:
 
 \`\`\`html
 <script type="module">
-  import container from "https://esm.sh/@soederpop/luca/web"
+  import container from "https://esm.sh/luca/web"
 
   const socket = container.client('socket', { url: 'ws://localhost:3000' })
   socket.on('message', (data) => console.log('Received:', data))
@@ -7976,7 +7975,7 @@ The container exposes the \`Feature\` class directly, so you can create your own
 
 \`\`\`html
 <script type="module">
-  import container from "https://esm.sh/@soederpop/luca/web"
+  import container from "https://esm.sh/luca/web"
 
   const { Feature } = container
 
@@ -8008,7 +8007,7 @@ The container's built-in utilities are available in the browser too.
 
 \`\`\`html
 <script type="module">
-  import container from "https://esm.sh/@soederpop/luca/web"
+  import container from "https://esm.sh/luca/web"
 
   // UUID generation
   const id = container.utils.uuid()
@@ -8037,7 +8036,7 @@ The container's built-in utilities are available in the browser too.
   <pre id="output"></pre>
 
   <script type="module">
-    import container from "https://esm.sh/@soederpop/luca/web"
+    import container from "https://esm.sh/luca/web"
 
     const log = (msg) => {
       document.getElementById('output').textContent += msg + '\\n'
@@ -8082,7 +8081,7 @@ Save this as an HTML file, open it in a browser, and everything works — no npm
 
 ## Gotchas
 
-- **esm.sh caches aggressively.** Pin a version if you need stability: \`https://esm.sh/@soederpop/luca@0.0.29/web\`
+- **esm.sh caches aggressively.** Pin a version if you need stability: \`https://esm.sh/luca@0.0.29/web\`
 - **Browser features only.** The web container doesn't include node-specific features like \`fs\`, \`git\`, \`proc\`, or \`docker\`. If you need server features, run Luca on the server and connect via the REST or WebSocket clients.
 - **\`window.luca\` is the singleton.** Don't call \`createContainer()\` — it just warns and returns the same instance. If you need isolation, use \`container.subcontainer()\`.
 - **CORS applies.** REST client requests from the browser are subject to browser CORS rules. Your API must send the right headers.
@@ -8128,7 +8127,7 @@ my-api/
     "seed": "luca seed"
   },
   "dependencies": {
-    "@soederpop/luca": "latest",
+    "luca": "latest",
     "zod": "^3.24.0"
   }
 }
@@ -8188,7 +8187,7 @@ The endpoint creates the assistant and forwards questions:
 \`\`\`typescript
 // endpoints/ask.ts
 import { z } from 'zod'
-import type { EndpointContext } from '@soederpop/luca'
+import type { EndpointContext } from 'luca'
 
 export const path = '/api/ask'
 export const postSchema = z.object({
@@ -8232,7 +8231,7 @@ docs-site/
 \`\`\`typescript
 // endpoints/docs.ts
 import { z } from 'zod'
-import type { EndpointContext } from '@soederpop/luca'
+import type { EndpointContext } from 'luca'
 
 export const path = '/api/docs'
 export const getSchema = z.object({
@@ -8500,7 +8499,7 @@ Contentbase lets you treat folders of markdown files as queryable database colle
 ## Setup
 
 \`\`\`typescript
-import container from '@soederpop/luca'
+import container from 'luca'
 
 const db = container.feature('contentDb', { rootPath: './content' })
 const { defineModel, section, hasMany, belongsTo } = db.library
@@ -8644,7 +8643,7 @@ console.log('Hello!')
 ## Full Example: Blog Engine
 
 \`\`\`typescript
-import container from '@soederpop/luca'
+import container from 'luca'
 import { z } from 'zod'
 
 const db = container.feature('contentDb', { rootPath: './blog' })
@@ -8825,7 +8824,7 @@ researchInternalDocs tool first to find accurate information before answering.
 ### In a Script
 
 \`\`\`typescript
-import container from '@soederpop/luca'
+import container from 'luca'
 
 const assistant = container.feature('assistant', {
   folder: 'assistants/my-assistant',
@@ -8851,7 +8850,7 @@ Expose the assistant as an API:
 \`\`\`typescript
 // endpoints/ask.ts
 import { z } from 'zod'
-import type { EndpointContext } from '@soederpop/luca'
+import type { EndpointContext } from 'luca'
 
 export const path = '/api/ask'
 export const description = 'Ask the support assistant a question'
@@ -8913,7 +8912,7 @@ luca run scripts/hello.ts
 
 \`\`\`typescript
 // scripts/hello.ts
-import container from '@soederpop/luca'
+import container from 'luca'
 
 console.log('Available features:', container.features.available)
 console.log('Git branch:', container.git.branch)
@@ -9015,7 +9014,7 @@ console.log(\`Found \${files.length} files in src/\`)
 
 \`\`\`typescript
 // scripts/process-images.ts
-import container from '@soederpop/luca'
+import container from 'luca'
 
 const { fs, proc } = container
 
@@ -9034,7 +9033,7 @@ console.log('Done.')
 
 \`\`\`typescript
 // scripts/migrate-data.ts
-import container from '@soederpop/luca'
+import container from 'luca'
 
 const { fs } = container
 
@@ -9062,7 +9061,7 @@ console.log('Migration complete.')
 
 \`\`\`typescript
 // scripts/weekly-report.ts
-import container from '@soederpop/luca'
+import container from 'luca'
 
 const { git, fs } = container
 
@@ -9211,7 +9210,7 @@ container.clients.describe('rest')
 \`\`\`typescript
 // endpoints/proxy.ts
 import { z } from 'zod'
-import type { EndpointContext } from '@soederpop/luca'
+import type { EndpointContext } from 'luca'
 
 export const path = '/api/external-data'
 

package/src/browser.ts

@@ -18,7 +18,7 @@ export default container
 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

package/src/cli/build-info.ts

@@ -1,4 +1,4 @@
 // Generated at compile time — do not edit manually
-export const BUILD_SHA = '066d9cb'
+export const BUILD_SHA = 'b06dca0'
 export const BUILD_BRANCH = 'main'
-export const BUILD_DATE = '2026-04-10T05:00:55Z'
+export const BUILD_DATE = '2026-05-23T07:32:17Z'

package/src/cli/cli.ts

@@ -7,12 +7,12 @@ import { BUILD_SHA, BUILD_BRANCH, BUILD_DATE } from './build-info'
 const args = process.argv.slice(2)
 if (args.includes('--version') || args.includes('-v')) {
 	console.log(`luca v${pkg.version} (${BUILD_BRANCH}@${BUILD_SHA}) built ${BUILD_DATE}`)
-	console.log(`  npm: https://www.npmjs.com/package/@soederpop/luca`)
+	console.log(`  npm: https://www.npmjs.com/package/luca`)
 	console.log(`  git: https://github.com/soederpop/luca`)
 	process.exit(0)
 }
 
-import container from '@soederpop/luca/agi'
+import container from 'luca/agi'
 import '@/commands/index.js'
 import { homedir } from 'os'
 import { join } from 'path'

package/src/clients/civitai/index.ts

@@ -1,15 +1,15 @@
 import {
   Client,
   type ClientOptions,
-} from "@soederpop/luca/client";
+} from "luca/client";
 import { RestClient } from "../rest";
-import { type ContainerContext } from "@soederpop/luca/container";
+import { type ContainerContext } from "luca/container";
 import { isEmpty, maxBy, omitBy } from "lodash-es";
-import { NodeContainer } from "@soederpop/luca/node/container";
+import { NodeContainer } from "luca/node/container";
 import { z } from 'zod'
-import { ClientStateSchema } from '@soederpop/luca/schemas/base.js'
+import { ClientStateSchema } from 'luca/schemas/base.js'
 
-declare module "@soederpop/luca/client" {
+declare module "luca/client" {
   interface AvailableClients {
     civitai: typeof CivitaiClient;
   }

package/src/clients/client-template.ts

@@ -2,13 +2,13 @@ import {
   type ClientOptions,
   type ClientsInterface,
   clients,
-} from "@soederpop/luca/client";
+} from "luca/client";
 import { RestClient } from "./rest";
-import { type ContainerContext } from "@soederpop/luca/container";
+import { type ContainerContext } from "luca/container";
 import { z } from 'zod'
-import { ClientStateSchema } from '@soederpop/luca/schemas/base.js'
+import { ClientStateSchema } from 'luca/schemas/base.js'
 
-declare module "@soederpop/luca/client" {
+declare module "luca/client" {
   interface AvailableClients {
     myClient: typeof MyClient;
   }

package/src/clients/comfyui/index.ts

@@ -1,12 +1,12 @@
 import {
   Client,
-} from "@soederpop/luca/client";
+} from "luca/client";
 import { RestClient } from "../rest";
-import type { ContainerContext } from "@soederpop/luca/container";
+import type { ContainerContext } from "luca/container";
 import { z } from 'zod'
-import { ClientStateSchema, ClientOptionsSchema, ClientEventsSchema } from '@soederpop/luca/schemas/base.js'
+import { ClientStateSchema, ClientOptionsSchema, ClientEventsSchema } from 'luca/schemas/base.js'
 
-declare module "@soederpop/luca/client" {
+declare module "luca/client" {
   interface AvailableClients {
     comfyui: typeof ComfyUIClient;
   }

package/src/clients/elevenlabs/index.ts

@@ -1,12 +1,12 @@
 import { z } from 'zod'
-import { ClientStateSchema, ClientOptionsSchema, ClientEventsSchema } from '@soederpop/luca/schemas/base.js'
-import { Client } from "@soederpop/luca/client";
+import { ClientStateSchema, ClientOptionsSchema, ClientEventsSchema } from 'luca/schemas/base.js'
+import { Client } from "luca/client";
 import { RestClient } from "../rest";
-import type { ContainerContext } from "@soederpop/luca/container";
+import type { ContainerContext } from "luca/container";
 import type { NodeContainer } from "../../node/container.js";
 import type { AxiosRequestConfig } from 'axios'
 
-declare module "@soederpop/luca/client" {
+declare module "luca/client" {
   interface AvailableClients {
     elevenlabs: typeof ElevenLabsClient;
   }

package/src/clients/openai/index.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod'
-import { ClientStateSchema, ClientOptionsSchema, ClientEventsSchema } from '@soederpop/luca/schemas/base.js'
-import { Client } from "@soederpop/luca/client";
-import type { Container, ContainerContext } from "@soederpop/luca/container";
+import { ClientStateSchema, ClientOptionsSchema, ClientEventsSchema } from 'luca/schemas/base.js'
+import { Client } from "luca/client";
+import type { Container, ContainerContext } from "luca/container";
 
 import OpenAI from "openai";
 
@@ -21,7 +21,7 @@ export const OpenAIClientOptionsSchema = ClientOptionsSchema.extend({
   organization: z.string().optional().describe('OpenAI organization ID'),
   project: z.string().optional().describe('OpenAI project ID'),
   dangerouslyAllowBrowser: z.boolean().optional().describe('Allow usage in browser environments'),
-  defaultModel: z.string().optional().describe('Default model for completions (default: gpt-4o)'),
+  defaultModel: z.string().optional().describe('Default model for completions (falls back to OPENAI_DEFAULT_MODEL env var, then gpt-5.4-mini)'),
   timeout: z.number().optional().describe('Request timeout in milliseconds'),
   maxRetries: z.number().optional().describe('Maximum number of retries on failure'),
 })
@@ -52,7 +52,7 @@ export class OpenAIClient extends Client<OpenAIClientState, OpenAIClientOptions>
   private openai!: OpenAI;
 
   static override shortcut = "clients.openai" as const
-  static override envVars = ['OPENAI_API_KEY']
+  static override envVars = ['OPENAI_API_KEY', 'OPENAI_DEFAULT_MODEL']
   static override stateSchema = OpenAIClientStateSchema
   static override optionsSchema = OpenAIClientOptionsSchema
   static override eventsSchema = OpenAIClientEventsSchema
@@ -116,7 +116,7 @@ export class OpenAIClient extends Client<OpenAIClientState, OpenAIClientOptions>
 
   /** The default model used for completions, from options or 'gpt-4o'. */
   get defaultModel(): string {
-    return this.options.defaultModel || 'gpt-4o';
+    return this.options.defaultModel || process.env.OPENAI_DEFAULT_MODEL || 'gpt-5.4-mini';
   }
 
   private updateTokenUsage(usage?: OpenAI.CompletionUsage | OpenAI.Embeddings.CreateEmbeddingResponse.Usage) {
@@ -287,7 +287,7 @@ export class OpenAIClient extends Client<OpenAIClientState, OpenAIClientOptions>
 
     try {
       const response = await this.openai.completions.create({
-        model: options.model || 'gpt-5',
+        model: options.model || this.defaultModel,
         prompt,
         stream: false, // Ensure non-streaming response
         ...options

package/src/clients/supabase/index.ts

@@ -1,13 +1,13 @@
 import {
   Client,
-} from "@soederpop/luca/client";
-import type { ContainerContext } from "@soederpop/luca/container";
+} from "luca/client";
+import type { ContainerContext } from "luca/container";
 import { z } from "zod";
 import {
   ClientStateSchema,
   ClientOptionsSchema,
   ClientEventsSchema,
-} from "@soederpop/luca/schemas/base.js";
+} from "luca/schemas/base.js";
 import {
   createClient,
   type SupabaseClient as SupabaseSDKClient,
@@ -15,7 +15,7 @@ import {
   type RealtimeChannel,
 } from "@supabase/supabase-js";
 
-declare module "@soederpop/luca/client" {
+declare module "luca/client" {
   interface AvailableClients {
     supabase: typeof SupabaseClient;
   }

package/src/clients/voicebox/index.ts

@@ -1,11 +1,11 @@
 import { z } from 'zod'
-import { ClientStateSchema, ClientOptionsSchema, ClientEventsSchema } from '@soederpop/luca/schemas/base.js'
-import { Client } from "@soederpop/luca/client";
+import { ClientStateSchema, ClientOptionsSchema, ClientEventsSchema } from 'luca/schemas/base.js'
+import { Client } from "luca/client";
 import { RestClient } from "../rest";
-import type { ContainerContext } from "@soederpop/luca/container";
+import type { ContainerContext } from "luca/container";
 import type { NodeContainer } from "../../node/container.js";
 
-declare module "@soederpop/luca/client" {
+declare module "luca/client" {
   interface AvailableClients {
     voicebox: typeof VoiceBoxClient;
   }

package/src/command.ts

@@ -31,7 +31,7 @@ export type CommandHandler<T = any> = (options: T, context: ContainerContext) =>
  *
  * @example
  * ```typescript
- * declare module '@soederpop/luca' {
+ * declare module 'luca' {
  *   interface AvailableCommands {
  *     serve: SimpleCommand<typeof argsSchema>
  *   }
@@ -432,6 +432,7 @@ export class CommandsRegistry extends Registry<Command<any>> {
 				const Grafted = graftModule(Command as any, {
 					description: commandModule.description,
 					argsSchema: commandModule.argsSchema,
+					positionals: commandModule.positionals ?? mod.positionals,
 					handler: commandModule.handler,
 				}, name, 'commands')
 				this.register(name, Grafted as any)