luca 3.0.0 → 3.1.0

package/src/commands/chat.ts

@@ -161,6 +161,7 @@ export default async function chat(options: z.infer<typeof argsSchema>, context:
 
 	assistant.on('toolCall', (toolName: string, args: any) => {
 		if (inkInstance) { inkInstance.unmount(); inkInstance = null }
+		responseBuffer = ''
 		const argsStr = JSON.stringify(args).slice(0, 120)
 		process.stdout.write(ui.colors.dim(`\n  ⟳ ${toolName}`) + ui.colors.dim(`(${argsStr})\n`))
 	})

package/src/commands/eval.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod'
-import { inspect } from 'util'
 import { commands } from '../command.js'
+import { displayResult } from '../node/features/display-result.js'
 import { CommandOptionsSchema } from '../schemas/base.js'
 import type { ContainerContext } from '../container.js'
 
@@ -58,61 +58,7 @@ export default async function evalCommand(options: z.infer<typeof argsSchema>, c
 	}
 }
 
-const BUILTIN_TYPES = new Set(['Object', 'Array', 'Map', 'Set', 'Date', 'RegExp', 'Promise', 'Error', 'Number', 'String', 'Boolean'])
-
-export function displayResult(value: any) {
-	if (typeof value !== 'object' || value === null) {
-		console.log(value)
-		return
-	}
-
-	const hasCustomInspect = typeof value[Symbol.for('nodejs.util.inspect.custom')] === 'function'
-	const ctorName = value.constructor?.name
-	const isClassInstance = ctorName && !BUILTIN_TYPES.has(ctorName)
-
-	// Objects with custom inspect or builtins: use standard inspect
-	if (hasCustomInspect || !isClassInstance) {
-		console.log(inspect(value, { colors: true, depth: 4 }))
-		return
-	}
-
-	// Class instances: show clean data (no _ props, no functions)
-	const data: Record<string, any> = {}
-	for (const [k, v] of Object.entries(value)) {
-		if (k.startsWith('_') || typeof v === 'function') continue
-		data[k] = v
-	}
-	const body = inspect(data, { colors: true, depth: 3 })
-	console.log(`${ctorName} ${body}`)
-
-	// Collect methods and getters from own + prototype chain
-	const methods: string[] = []
-	const getters: string[] = []
-
-	for (const [k, v] of Object.entries(value)) {
-		if (k.startsWith('_')) continue
-		if (typeof v === 'function') methods.push(k)
-	}
-
-	let proto = Object.getPrototypeOf(value)
-	while (proto && proto !== Object.prototype) {
-		for (const k of Object.getOwnPropertyNames(proto)) {
-			if (k === 'constructor' || k.startsWith('_')) continue
-			const desc = Object.getOwnPropertyDescriptor(proto, k)
-			if (!desc) continue
-			if (desc.get && !getters.includes(k)) getters.push(k)
-			else if (typeof desc.value === 'function' && !methods.includes(k)) methods.push(k)
-		}
-		proto = Object.getPrototypeOf(proto)
-	}
-
-	if (getters.length || methods.length) {
-		const parts: string[] = []
-		if (getters.length) parts.push(`  \x1b[36mgetters:\x1b[0m ${getters.sort().join(', ')}`)
-		if (methods.length) parts.push(`  \x1b[36mmethods:\x1b[0m ${methods.sort().map(m => m + '()').join(', ')}`)
-		console.log(parts.join('\n'))
-	}
-}
+export { displayResult } from '../node/features/display-result.js'
 
 commands.registerHandler('eval', {
 	description: 'Evaluate a JavaScript/TypeScript expression with the container in scope',

package/src/commands/introspect.ts

@@ -178,7 +178,7 @@ async function introspect(options: z.infer<typeof argsSchema>, context: Containe
 	}
 
 	const outputPath = options.output || 'features/introspection.generated.ts'
-	const importSource = '@soederpop/luca/introspection'
+	const importSource = 'luca/introspection'
 
 	console.log(`Scanning: ${src.join(', ')}`)
 	console.log(`Output: ${outputPath}`)

package/src/commands/prompt.ts

@@ -23,7 +23,7 @@ export const argsSchema = CommandOptionsSchema.extend({
 	'exclude-sections': z.string().optional().describe('Comma-separated list of section headings to exclude from the prompt'),
 	'chrome': z.boolean().default(false).describe('Launch Claude Code with a Chrome browser tool'),
 	'dry-run': z.boolean().default(false).describe('Display the resolved prompt and options without running the assistant'),
-	'local': z.boolean().default(false).describe('Use local models for assistant mode'),
+	'local': z.boolean().default(false).describe('Use local models (sets ANTHROPIC_BASE_URL and model for claudeCode, or local flag for assistants)'),
 })
 
 function normalizeTarget(raw: string): string {
@@ -97,7 +97,12 @@ async function runClaudeOrCodex(target: 'claude' | 'codex', promptContent: strin
 
 	let outputTokens = 0
 
-	// Render complete messages — text gets markdown formatting, tool_use gets a summary line
+	// Stream text via deltas for real-time output
+	feature.on('session:delta', ({ text }: { text: string }) => {
+		process.stdout.write(text)
+	})
+
+	// Render complete messages — only tool_use blocks and final text (markdown formatted)
 	feature.on('session:message', ({ message }: { message: any }) => {
 		const role = message?.message?.role ?? message?.role
 		if (role && role !== 'assistant') return
@@ -108,10 +113,12 @@ async function runClaudeOrCodex(target: 'claude' | 'codex', promptContent: strin
 		const usage = message?.message?.usage ?? message?.usage
 		if (usage?.output_tokens) outputTokens += usage.output_tokens
 
+		// Skip partial messages — text is already rendered via session:delta
+		const stopReason = message?.message?.stop_reason ?? message?.stop_reason
+		if (!stopReason) return
+
 		for (const block of content) {
-			if (block.type === 'text' && block.text) {
-				process.stdout.write(ui.markdown(block.text))
-			} else if (block.type === 'tool_use') {
+			if (block.type === 'tool_use') {
 				const argsStr = JSON.stringify(block.input).slice(0, 120)
 				process.stdout.write(ui.colors.dim(`\n  ⟳ ${block.name}`) + ui.colors.dim(`(${argsStr})\n`))
 			}
@@ -122,7 +129,12 @@ async function runClaudeOrCodex(target: 'claude' | 'codex', promptContent: strin
 	const collectedEvents: any[] = []
 	if (options['out-file']) {
 		feature.on('session:event', ({ event }: { event: any }) => {
-			if (event.type === 'assistant' || event.type === 'tool_result' || event.type === 'message' || event.type === 'function_call_output' || event.type === 'item.completed' || event.type === 'turn.completed') {
+			// Skip partial assistant messages (streaming tokens) — only collect complete messages with stop_reason
+			if (event.type === 'assistant') {
+				if (event.message?.stop_reason) collectedEvents.push(event)
+				return
+			}
+			if (event.type === 'tool_result' || event.type === 'message' || event.type === 'function_call_output' || event.type === 'item.completed' || event.type === 'turn.completed') {
 				collectedEvents.push(event)
 			}
 		})
@@ -137,6 +149,7 @@ async function runClaudeOrCodex(target: 'claude' | 'codex', promptContent: strin
 	if (target === 'claude') {
 		runOptions.permissionMode = options['permission-mode']
 		if (options.chrome) runOptions.chrome = true
+		if (options.local) runOptions.local = true
 	}
 
 	// CLI flags override agentOptions from frontmatter
@@ -179,6 +192,7 @@ async function runAssistant(name: string, promptContent: string, options: z.infe
 
 	// Collect structured events for --out-file
 	const collectedEvents: any[] = []
+	let textBuffer = ''
 
 	assistant.on('chunk', (text: string) => {
 		if (isFirstChunk) {
@@ -187,7 +201,7 @@ async function runAssistant(name: string, promptContent: string, options: z.infe
 		}
 		process.stdout.write(text)
 		if (options['out-file']) {
-			collectedEvents.push({ type: 'assistant', message: { content: [{ type: 'text', text }] } })
+			textBuffer += text
 		}
 	})
 
@@ -216,6 +230,12 @@ async function runAssistant(name: string, promptContent: string, options: z.infe
 	await assistant.ask(promptContent)
 	process.stdout.write('\n')
 
+	// Flush accumulated text buffer as a single event
+	if (textBuffer) {
+		collectedEvents.push({ type: 'assistant', message: { content: [{ type: 'text', text: textBuffer }] } })
+		textBuffer = ''
+	}
+
 	return { collectedEvents, durationMs: Date.now() - startTime, outputTokens: 0 }
 }
 
@@ -291,6 +311,7 @@ async function runParallel(
 		if (target === 'claude') {
 			runOptions.permissionMode = options['permission-mode']
 			if (options.chrome) runOptions.chrome = true
+			if (options.local) runOptions.local = true
 		}
 
 		feature.on('session:message', ({ sessionId, message }: { sessionId: string; message: any }) => {
@@ -320,7 +341,12 @@ async function runParallel(
 			feature.on('session:event', ({ sessionId, event }: { sessionId: string; event: any }) => {
 				const idx = sessionMap.get(sessionId)
 				if (idx === undefined) return
-				if (event.type === 'assistant' || event.type === 'tool_result' || event.type === 'message' || event.type === 'function_call_output') {
+				// Skip partial assistant messages (streaming tokens) — only collect complete messages
+				if (event.type === 'assistant') {
+					if (event.message?.stop_reason) promptStates[idx]!.collectedEvents.push(event)
+					return
+				}
+				if (event.type === 'tool_result' || event.type === 'message' || event.type === 'function_call_output') {
 					promptStates[idx]!.collectedEvents.push(event)
 				}
 			})
@@ -366,6 +392,7 @@ async function runParallel(
 		}
 
 		const lineBuffers: string[] = prepared.map(() => '')
+		const textBuffers: string[] = prepared.map(() => '')
 
 		const assistants = prepared.map((p, i) => {
 			const createOptions: Record<string, any> = { ...p.agentOptions }
@@ -384,7 +411,7 @@ async function runParallel(
 					}
 				}
 				if (options['out-file']) {
-					promptStates[i]!.collectedEvents.push({ type: 'assistant', message: { content: [{ type: 'text', text }] } })
+					textBuffers[i] += text
 				}
 			})
 
@@ -427,6 +454,11 @@ async function runParallel(
 						promptStates[i]!.lines.push(lineBuffers[i]!)
 						lineBuffers[i] = ''
 					}
+					// Flush accumulated text as a single event for out-file
+					if (textBuffers[i]) {
+						promptStates[i]!.collectedEvents.push({ type: 'assistant', message: { content: [{ type: 'text', text: textBuffers[i] }] } })
+						textBuffers[i] = ''
+					}
 					if (r.status === 'rejected') {
 						promptStates[i]!.status = 'error'
 						promptStates[i]!.error = String(r.reason)

package/src/container-describer.ts

@@ -274,7 +274,14 @@ Use these tools whenever you are unsure what helpers are available, what a helpe
 		const includeNode = this.shouldIncludeNode(platform)
 		const includeBrowser = this.shouldIncludeBrowser(platform)
 
-		if (lower === 'container' || lower === 'self') {
+		if (
+			lower === 'container' ||
+			lower === 'self' ||
+			lower === 'luca' ||
+			lower === 'lucaframework' ||
+			lower === 'luca-framework' ||
+			lower === 'framework'
+		) {
 			return [{ kind: 'container' }]
 		}
 

package/src/container.ts

@@ -915,6 +915,19 @@ const uuidCache = new Map<string, Helper>()
 const featureIdToHelperCacheKeyMap= new Map()
 const contextMap = new WeakMap()
 
+/**
+ * Returns all helper instances that have been created by any container in this process.
+ * Optionally filtered by class.
+ *
+ * @param FilterClass - When provided, only instances of this class are returned.
+ */
+export function allHelperInstances(): Helper[]
+export function allHelperInstances<T extends Helper>(FilterClass: new (...args: any[]) => T): T[]
+export function allHelperInstances<T extends Helper>(FilterClass?: new (...args: any[]) => T): Helper[] | T[] {
+  const all = [...uuidCache.values()]
+  return FilterClass ? all.filter((h): h is T => h instanceof FilterClass) : all
+}
+
 function presentContainerIntrospectionAsMarkdown(data: ContainerIntrospection, startHeadingDepth: number = 1, section?: IntrospectionSection): string {
   const sections: string[] = []
   const heading = (level: number) => '#'.repeat(Math.max(1, startHeadingDepth + level - 1))

package/src/entity.ts

@@ -71,7 +71,7 @@ export type Entity<
    * assistant.addTools(agent)
    * ```
    */
-  expose(functionName: string, schema: z.ZodType): this
+  expose(this: Entity<TState, TOptions, TEvents>, functionName: string, schema: z.ZodType): Entity<TState, TOptions, TEvents>
 
   /**
    * Returns `{ schemas, handlers }` for all tools registered via `.expose()`.
@@ -104,7 +104,7 @@ export function createEntityObject<
     on(event: any, listener: any) { _events.on(event, listener) },
     off(event: any, listener?: any) { _events.off(event, listener) },
     once(event: any, listener: any) { _events.once(event, listener) },
-    emit(event: any, ...args: any[]) { _events.emit(event, ...args) },
+    emit(event: any, ...args: any[]) { _events.emit(event, ...args as any) },
     waitFor(event: any) { return _events.waitFor(event) },
     setState(value: any) { _state.setState(value) },
     extend(extensions: any) { return applyExtensions(this as any, extensions) },

package/src/helper.ts

@@ -842,7 +842,7 @@ function normalizeTypeString(type: string): string {
     (_match, _kind, name) => {
       // Convert shortcut name to PascalCase class name
       const className = name.replace(/(^|[-_])(\w)/g, (_: string, _sep: string, ch: string) => ch.toUpperCase())
-      return `import('@soederpop/luca').${className}`
+      return `import('luca').${className}`
     }
   )
   return type