luca 3.0.0 → 3.0.2

package/public/slides-ai-native.html

@@ -816,7 +816,7 @@ server.<span class="method">state</span>.<span class="method">observe</span>((<s
     <div class="grid-bg"></div>
     <div class="slide-content">
         <h1 class="reveal">Your Codebase<br>Is the <span class="cyan">Prompt.</span></h1>
-        <div class="closing-install reveal reveal-delay-1">bun add @soederpop/luca</div>
+        <div class="closing-install reveal reveal-delay-1">bun add luca</div>
         <p class="closing-link reveal reveal-delay-2">github.com/soederpop/luca</p>
     </div>
 </section>

package/public/slides-intro.html

@@ -700,7 +700,7 @@
     <div class="slide-content">
         <h2 class="reveal">One Object. Everything You Need.</h2>
         <div class="code-block reveal-scale reveal-delay-1">
-            <pre><span class="keyword">import</span> <span class="property">container</span> <span class="keyword">from</span> <span class="string">'@soederpop/luca/node'</span>
+            <pre><span class="keyword">import</span> <span class="property">container</span> <span class="keyword">from</span> <span class="string">'luca/node'</span>
 
 <span class="property">container</span>.<span class="method">fs</span>          <span class="comment">// file system</span>
 <span class="property">container</span>.<span class="method">git</span>         <span class="comment">// git operations</span>
@@ -881,7 +881,7 @@ api === api2 <span class="comment">// true &mdash; identity guarantee</span></pr
     <div class="grid-bg"></div>
     <div class="slide-content">
         <h1 class="reveal">Stop Rebuilding.<br><span class="accent">Start Composing.</span></h1>
-        <div class="closing-install reveal reveal-delay-1">bun add @soederpop/luca</div>
+        <div class="closing-install reveal reveal-delay-1">bun add luca</div>
         <p class="closing-link reveal reveal-delay-2">github.com/soederpop/luca</p>
     </div>
 </section>

package/scripts/examples/ask-luca-expert.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/agi'
+import container from 'luca/agi'
 import * as readline from 'readline'
 
 const { ui } = container

package/scripts/examples/assistant-questions.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/agi'
+import container from 'luca/agi'
 
 const assistant = container.feature('assistant', {
   folder: 'assistants/example',

package/scripts/examples/excalidraw-expert.ts

@@ -12,7 +12,7 @@
  *   bun run scripts/examples/excalidraw-expert.ts "a microservices architecture with api gateway"
  *   bun run scripts/examples/excalidraw-expert.ts "user auth flow" --style blueprint
  */
-import container from '@soederpop/luca/agi/container.server'
+import container from 'luca/agi/container.server'
 
 const args = process.argv.slice(2)
 const styleFlag = args.indexOf('--style')

package/scripts/examples/file-manager.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/agi'
+import container from 'luca/agi'
 
 async function main() {
 const fileManager = await container.feature('fileManager').enable()

package/scripts/examples/ideas.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/agi'
+import container from 'luca/agi'
 // @ts-ignore - module not yet implemented
 import createCollection, { Idea } from '@/ideas'
 

package/scripts/examples/interactive-chat.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/agi'
+import container from 'luca/agi'
 
 const { ui } = container
 

package/scripts/examples/opening-a-web-browser.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/node'
+import container from 'luca/node'
 
 const opener = container.feature('opener')
 

package/scripts/examples/telegram-bot.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/node'
+import container from 'luca/node'
 
 const ui = container.feature('ui')
 const tg = container.feature('telegram', {

package/scripts/examples/using-assistant-with-mcp.ts

@@ -11,7 +11,7 @@
  * Usage:
  *   bun run scripts/examples/using-assistant-with-mcp.ts
  */
-import container from '@soederpop/luca/agi'
+import container from 'luca/agi'
 
 // ─── Types ───────────────────────────────────────────────────────────────────
 

package/scripts/examples/using-claude-code.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/agi'
+import container from 'luca/agi'
 
 const claude = container.feature('claudeCode')
 

package/scripts/examples/using-contentdb.ts

@@ -1,5 +1,5 @@
-import container from '@soederpop/luca/agi'
-import { ContentDb } from '@soederpop/luca/node/features/content-db'
+import container from 'luca/agi'
+import { ContentDb } from 'luca/node/features/content-db'
 import { defineModel, section } from 'contentbase'
 import { toString } from 'mdast-util-to-string'
 import { z } from 'zod'

package/scripts/examples/using-conversations.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/agi'
+import container from 'luca/agi'
 
 async function main() {
 	const chat = container.feature('conversation', {

package/scripts/examples/using-disk-cache.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/node'
+import container from 'luca/node'
 
 async function main() {
 	const cache = container.feature('diskCache')

package/scripts/examples/using-docker-shell.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/node'
+import container from 'luca/node'
 
 async function main() {
 	const docker = container.feature('docker', { enable: true, autoRefresh: true })

package/scripts/examples/using-elevenlabs.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/node'
+import container from 'luca/node'
 import '../../src/clients/elevenlabs'
 
 async function main() {

package/scripts/examples/using-google-calendar.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/node'
+import container from 'luca/node'
 
 async function main() {
 	// GoogleAuth reads GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET from env.

package/scripts/examples/using-google-docs.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/node'
+import container from 'luca/node'
 
 // Pass a document ID as the first argument, or omit to list available docs.
 // You can find the ID in a Google Docs URL:

package/scripts/examples/using-google-drive.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/node'
+import container from 'luca/node'
 
 async function main() {
 	// GoogleAuth reads GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET from env.

package/scripts/examples/using-google-sheets.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/node'
+import container from 'luca/node'
 
 // Pass a spreadsheet ID as the first argument, or set DEFAULT_SPREADSHEET_ID env var.
 // You can find the ID in a Google Sheets URL:

package/scripts/examples/using-nlp.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/node'
+import container from 'luca/node'
 
 const nlp = container.feature('nlp', { enable: true })
 

package/scripts/examples/using-ollama.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/agi'
+import container from 'luca/agi'
 
 const conversation = container.feature('conversation', {
 	local: true,

package/scripts/examples/using-postgres.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/node'
+import container from 'luca/node'
 
 const DEFAULT_DATABASE_URL = 'postgresql://postgres:postgres@127.0.0.1:54322/postgres'
 

package/scripts/examples/using-runpod.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/node'
+import container from 'luca/node'
 
 async function main() {
 	const runpod = container.feature('runpod')

package/scripts/examples/using-tts.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/node'
+import container from 'luca/node'
 
 async function main() {
 	const tts = container.feature('tts', { enable: true })

package/scripts/scaffold.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/node'
+import container from 'luca/node'
 import { join } from 'path'
 
 const { ui, fs, argv } = container
@@ -84,15 +84,15 @@ function generateClient(name: string, description: string): string {
 
   return ui.endent`
     import { z } from 'zod'
-    import { ClientStateSchema, ClientOptionsSchema } from '@soederpop/luca/schemas/base.js'
+    import { ClientStateSchema, ClientOptionsSchema } from 'luca/schemas/base.js'
     import {
       type ClientsInterface,
       clients,
       RestClient,
-    } from '@soederpop/luca/client'
-    import { type ContainerContext } from '@soederpop/luca/container'
+    } from 'luca/client'
+    import { type ContainerContext } from 'luca/container'
 
-    declare module '@soederpop/luca/client' {
+    declare module 'luca/client' {
       interface AvailableClients {
         ${registryKey}: typeof ${className}
       }

package/scripts/scratch.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/agi'
+import container from 'luca/agi'
 
 const fs = container.feature('fs')
 

package/scripts/test-assistant-hooks.ts

@@ -1,4 +1,4 @@
-import container from '@soederpop/luca/agi'
+import container from 'luca/agi'
 
 const coder = container.feature('assistant', { folder: 'assistants/codingAssistant' })
 

package/scripts/test-docs-reader.ts

@@ -1,4 +1,4 @@
-import container from  '@soederpop/luca/agi'
+import container from  'luca/agi'
 
 const reader = container.feature('docsReader', {
 	contentDb: (await container.docs.load())

package/src/agi/container.server.ts

@@ -13,12 +13,13 @@ import { AssistantsManager } from './features/assistants-manager'
 import { DocsReader } from './features/docs-reader'
 import { SkillsLibrary } from './features/skills-library'
 import { BrowserUse } from './features/browser-use'
-import { SemanticSearch } from '@soederpop/luca/node/features/semantic-search'
-import { ContentDb } from '@soederpop/luca/node/features/content-db'
+import { SemanticSearch } from 'luca/node/features/semantic-search'
+import { ContentDb } from 'luca/node/features/content-db'
 import { FileTools } from './features/file-tools'
 import { LucaCoder } from './features/luca-coder'
 import { Memory } from './features/agent-memory'
 import { CodingTools } from './features/coding-tools'
+import { McpBridge } from './features/mcp-bridge'
 
 import type { ConversationTool } from './features/conversation'
 import type { ZodType } from 'zod'
@@ -37,6 +38,7 @@ export {
 	LucaCoder,
 	Memory,
 	CodingTools,
+	McpBridge,
 	SemanticSearch,
 	ContentDb,
 	NodeContainer,
@@ -65,6 +67,7 @@ export interface AGIFeatures extends NodeFeatures {
 	lucaCoder: typeof LucaCoder
 	memory: typeof Memory
 	codingTools: typeof CodingTools
+	mcpBridge: typeof McpBridge
 }
 
 export interface ConversationFactoryOptions {
@@ -143,6 +146,7 @@ const container = new AGIContainer()
 	.use(LucaCoder)
 	.use(Memory)
 	.use(CodingTools)
+	.use(McpBridge)
 	.use(SemanticSearch)
 
 container.docs = container.feature('contentDb', {

package/src/agi/features/agent-memory.ts

@@ -3,7 +3,7 @@ import { FeatureStateSchema, FeatureOptionsSchema, FeatureEventsSchema } from '.
 import { Feature } from '../feature.js'
 import type { Helper } from '../../helper.js'
 
-declare module '@soederpop/luca/feature' {
+declare module 'luca/feature' {
   interface AvailableFeatures {
     memory: typeof Memory
   }
@@ -169,13 +169,13 @@ export class Memory extends Feature<MemoryState, MemoryOptions> {
       )
     `)
 
-    const rows = await this.db.query<{ value: number }>(
+    const rows = await this.db.query(
       'SELECT value FROM epochs WHERE namespace = ?',
       [this.options.namespace]
-    )
+    ) as { value: number }[]
 
     if (rows.length) {
-      this.state.set('epoch', rows[0].value)
+      this.state.set('epoch', rows[0]!.value)
     } else {
       await this.db.execute('INSERT INTO epochs (namespace, value) VALUES (?, 1)', [this.options.namespace])
     }
@@ -299,7 +299,7 @@ export class Memory extends Feature<MemoryState, MemoryOptions> {
     await this.ensureDb()
 
     const results = await this.search(category, text, 1)
-    if (results.length > 0 && (1 - results[0].distance) >= similarityThreshold) {
+    if (results.length > 0 && (1 - results[0]!.distance) >= similarityThreshold) {
       return null
     }
 
@@ -316,10 +316,10 @@ export class Memory extends Feature<MemoryState, MemoryOptions> {
   async get(category: string, id: number): Promise<MemoryRecord | null> {
     await this.ensureDb()
 
-    const rows = await this.db.query<any>(
+    const rows = await this.db.query(
       'SELECT id, category, document, metadata, created_at, updated_at FROM memories WHERE namespace = ? AND category = ? AND id = ?',
       [this.options.namespace, category, id]
-    )
+    ) as any[]
 
     if (!rows.length) return null
     return this.rowToMemory(rows[0])
@@ -340,10 +340,10 @@ export class Memory extends Feature<MemoryState, MemoryOptions> {
 
     const { limit = 20, sortOrder = 'desc', filterMetadata } = options
 
-    let rows = await this.db.query<any>(
+    let rows = await this.db.query(
       `SELECT id, category, document, metadata, created_at, updated_at FROM memories WHERE namespace = ? AND category = ? ORDER BY created_at ${sortOrder === 'asc' ? 'ASC' : 'DESC'} LIMIT ?`,
       [this.options.namespace, category, limit]
-    )
+    ) as any[]
 
     if (filterMetadata) {
       rows = rows.filter((row: any) => {
@@ -462,18 +462,18 @@ export class Memory extends Feature<MemoryState, MemoryOptions> {
     await this.ensureDb()
 
     if (category) {
-      const rows = await this.db.query<{ cnt: number }>(
+      const rows = await this.db.query(
         'SELECT COUNT(*) as cnt FROM memories WHERE namespace = ? AND category = ?',
         [this.options.namespace, category]
-      )
-      return rows[0].cnt
+      ) as { cnt: number }[]
+      return rows[0]!.cnt
     }
 
-    const rows = await this.db.query<{ cnt: number }>(
+    const rows = await this.db.query(
       'SELECT COUNT(*) as cnt FROM memories WHERE namespace = ?',
       [this.options.namespace]
-    )
-    return rows[0].cnt
+    ) as { cnt: number }[]
+    return rows[0]!.cnt
   }
 
   /**
@@ -484,10 +484,10 @@ export class Memory extends Feature<MemoryState, MemoryOptions> {
   async categories(): Promise<string[]> {
     await this.ensureDb()
 
-    const rows = await this.db.query<{ category: string }>(
+    const rows = await this.db.query(
       'SELECT DISTINCT category FROM memories WHERE namespace = ?',
       [this.options.namespace]
-    )
+    ) as { category: string }[]
 
     return rows.map((r: { category: string }) => r.category)
   }
@@ -510,10 +510,10 @@ export class Memory extends Feature<MemoryState, MemoryOptions> {
 
     const queryEmbedding = await this.embed(query)
 
-    const rows = await this.db.query<any>(
+    const rows = await this.db.query(
       'SELECT id, category, document, metadata, embedding, created_at, updated_at FROM memories WHERE namespace = ? AND category = ? AND embedding IS NOT NULL',
       [this.options.namespace, category]
-    )
+    ) as any[]
 
     let scored = rows.map((row: any) => {
       const stored = this.blobToFloat64(row.embedding)
@@ -600,10 +600,10 @@ export class Memory extends Feature<MemoryState, MemoryOptions> {
   async exportToJson(): Promise<{ namespace: string; epoch: number; memories: MemoryRecord[] }> {
     await this.ensureDb()
 
-    const rows = await this.db.query<any>(
+    const rows = await this.db.query(
       'SELECT id, category, document, metadata, created_at, updated_at FROM memories WHERE namespace = ? ORDER BY category, id',
       [this.options.namespace]
-    )
+    ) as any[]
 
     return {
       namespace: this.options.namespace,
@@ -651,7 +651,7 @@ export class Memory extends Feature<MemoryState, MemoryOptions> {
   private float64ToBlob(arr: number[]): Buffer {
     const buf = Buffer.alloc(arr.length * 8)
     for (let i = 0; i < arr.length; i++) {
-      buf.writeDoubleLE(arr[i], i * 8)
+      buf.writeDoubleLE(arr[i]!, i * 8)
     }
     return buf
   }
@@ -670,9 +670,9 @@ export class Memory extends Feature<MemoryState, MemoryOptions> {
   private cosineDistance(a: number[], b: number[]): number {
     let dot = 0, magA = 0, magB = 0
     for (let i = 0; i < a.length; i++) {
-      dot += a[i] * b[i]
-      magA += a[i] * a[i]
-      magB += b[i] * b[i]
+      dot += a[i]! * b[i]!
+      magA += a[i]! * a[i]!
+      magB += b[i]! * b[i]!
     }
     const similarity = dot / (Math.sqrt(magA) * Math.sqrt(magB))
     return 1 - similarity

package/src/agi/features/assistant.ts

@@ -1,16 +1,16 @@
 import { z } from 'zod'
 import { FeatureStateSchema, FeatureOptionsSchema, FeatureEventsSchema } from '../../schemas/base.js'
-import { type AvailableFeatures } from '@soederpop/luca/feature'
+import { type AvailableFeatures } from 'luca/feature'
 import { Feature } from '../feature.js'
 import type { Conversation, ConversationTool, ContentPart, AskOptions, ForkOptions, Message } from './conversation'
-import type { ContentDb } from '@soederpop/luca/node'
+import type { ContentDb } from 'luca/node'
 import type { ConversationHistory, ConversationMeta } from './conversation-history'
 import hashObject from '../../hash-object.js'
 import { InterceptorChain, type InterceptorFn, type InterceptorPoints, type InterceptorPoint } from '../lib/interceptor-chain.js'
 import type { Entity } from '../../entity.js'
 import { State } from '../../state.js'
 
-declare module '@soederpop/luca/feature' {
+declare module 'luca/feature' {
 	interface AvailableFeatures {
 		assistant: typeof Assistant
 	}
@@ -577,7 +577,25 @@ export class Assistant extends Feature<AssistantState, AssistantOptions> {
 	 * }, z.object({ city: z.string() }).describe('Get weather for a city'))
 	 * ```
 	 */
-	addTool(name: string, handler: (...args: any[]) => any, schema?: z.ZodType): this {
+	addTool(name: string, handler: (...args: any[]) => any, schema?: z.ZodType): this
+	addTool(handler: (...args: any[]) => any, schema?: z.ZodType): this
+	addTool(nameOrHandler: string | ((...args: any[]) => any), handlerOrSchema?: ((...args: any[]) => any) | z.ZodType, maybeSchema?: z.ZodType): this {
+		let name: string
+		let handler: (...args: any[]) => any
+		let schema: z.ZodType | undefined
+
+		if (typeof nameOrHandler === 'function') {
+			// addTool(handler, schema?) — extract name from function
+			handler = nameOrHandler
+			name = handler.name
+			schema = handlerOrSchema as z.ZodType | undefined
+		} else {
+			// addTool(name, handler, schema?)
+			name = nameOrHandler
+			handler = handlerOrSchema as (...args: any[]) => any
+			schema = maybeSchema
+		}
+
 		if (!name) throw new Error('addTool handler must be a named function')
 		if (!this._runtimeToolNames) this._runtimeToolNames = new Set()
 		this._runtimeToolNames.add(name)
@@ -777,7 +795,7 @@ export class Assistant extends Feature<AssistantState, AssistantOptions> {
 			return this.mergeOptionTools(tools)
 		}
 
-		// Ensure virtual modules (zod, @soederpop/luca, etc.) are seeded so tools
+		// Ensure virtual modules (zod, luca, etc.) are seeded so tools
 		// files outside the project tree can resolve them through the VM
 		if (this.container.features.has('helpers')) {
 			const helpers = this.container.feature('helpers') as any
@@ -1093,6 +1111,17 @@ export class Assistant extends Feature<AssistantState, AssistantOptions> {
 		// Reload tools from disk (merges with option tools), then restore runtime tools
 		const diskTools = this.loadTools()
 		this.state.set('tools', { ...diskTools, ...runtimeTools })
+
+		// Re-process deferred `use` entries (export const use = [...] in tools.ts).
+		// These replace tools from the same features, which is a no-op when unchanged.
+		const deferredUse = this.state.get('deferredUse') as any[] | undefined
+		if (deferredUse?.length) {
+			for (const entry of deferredUse) {
+				this.use(entry)
+			}
+			this.state.set('deferredUse', undefined)
+		}
+
 		this.emit('toolsChanged')
 
 		// Reload hooks from disk — triggerHook reads from state so new hooks are active immediately