@soederpop/luca 0.0.29 → 0.0.31

package/src/commands/chat.ts

@@ -20,6 +20,9 @@ export const argsSchema = CommandOptionsSchema.extend({
 	clear: z.boolean().optional().describe('Clear the conversation history for the resolved history mode and exit'),
 	prependPrompt: z.string().optional().describe('Text or path to a markdown file to prepend to the system prompt'),
 	appendPrompt: z.string().optional().describe('Text or path to a markdown file to append to the system prompt'),
+	use: z.union([z.string(), z.array(z.string())]).optional().describe('Feature(s) to inject into the assistant via .use(). Supports options: --use "contentDb:rootPath=/tmp;lazy=true"'),
+	forbidTool: z.union([z.string(), z.array(z.string())]).optional().describe('Tool name patterns to exclude (supports * glob). Can be specified multiple times.'),
+	allowTool: z.union([z.string(), z.array(z.string())]).optional().describe('Tool name patterns to allow (strict allowlist, supports * glob). Can be specified multiple times.'),
 })
 
 export default async function chat(options: z.infer<typeof argsSchema>, context: ContainerContext) {
@@ -72,6 +75,8 @@ export default async function chat(options: z.infer<typeof argsSchema>, context:
 	const createOptions: Record<string, any> = { historyMode, injectTimestamps: true }
 	if (options.model) createOptions.model = options.model
 	if (options.local) createOptions.local = options.local
+	if (options.forbidTool) createOptions.forbidTools = Array.isArray(options.forbidTool) ? options.forbidTool : [options.forbidTool]
+	if (options.allowTool) createOptions.allowTools = Array.isArray(options.allowTool) ? options.allowTool : [options.allowTool]
 
 	// Resolve --prepend-prompt / --append-prompt: if it's an existing file, read it; if it ends in .md but doesn't exist, error
 	const fs = container.feature('fs')
@@ -176,6 +181,23 @@ export default async function chat(options: z.infer<typeof argsSchema>, context:
 		process.stdout.write('\n')
 	})
 
+	// --use: inject features into the assistant
+	if (options.use) {
+		const items = Array.isArray(options.use) ? options.use : [options.use]
+		for (const item of items) {
+			const [namepart, optStr] = item.split(':')
+			const featureOpts: Record<string, any> = { enable: true }
+			if (optStr) {
+				for (const pair of optStr.split(';')) {
+					const [k, v] = pair.split('=')
+					if (k) featureOpts[k.trim()] = v?.trim() === 'true' ? true : v?.trim() === 'false' ? false : v?.trim()
+				}
+			}
+			const feature = container.feature(namepart.trim(), featureOpts)
+			assistant.use(feature)
+		}
+	}
+
 	// Start the assistant (loads history if applicable)
 	await assistant.start()
 

package/src/commands/describe.ts

@@ -2,11 +2,12 @@ import { z } from 'zod'
 import { commands } from '../command.js'
 import { CommandOptionsSchema } from '../schemas/base.js'
 import type { ContainerContext } from '../container.js'
-import type { HelperIntrospection } from '../introspection/index.js'
+import type { HelperIntrospection, IntrospectionSection } from '../introspection/index.js'
 import { __INTROSPECTION__, __BROWSER_INTROSPECTION__ } from '../introspection/index.js'
 import { features } from '../feature.js'
 import { ContainerDescriber } from '../container-describer.js'
 import type { BrowserFeatureData } from '../container-describer.js'
+import { presentIntrospectionAsTypeScript } from '../helper.js'
 
 declare module '../command.js' {
 	interface AvailableCommands {
@@ -16,6 +17,8 @@ declare module '../command.js' {
 
 export const argsSchema = CommandOptionsSchema.extend({
 	json: z.boolean().default(false).describe('Output introspection data as JSON instead of markdown'),
+	typescript: z.boolean().default(false).describe('Output introspection data as TypeScript interface declarations'),
+	ts: z.boolean().default(false).describe('Alias for --typescript'),
 	pretty: z.boolean().default(false).describe('Render markdown with terminal styling via ui.markdown'),
 	title: z.boolean().default(true).describe('Include the title header in the output (use --no-title to omit)'),
 	// Clean section flags (can be combined: --description --usage)
@@ -156,7 +159,12 @@ export default async function describe(options: z.infer<typeof argsSchema>, cont
 		platform: options.platform as any,
 	})
 
-	if (options.json) {
+	const wantsTypeScript = options.typescript || options.ts
+
+	if (wantsTypeScript) {
+		const output = renderResultAsTypeScript(result, targets, describer, sections)
+		console.log(output)
+	} else if (options.json) {
 		console.log(JSON.stringify(result.json, null, 2))
 	} else if (options.pretty) {
 		const ui = container.feature('ui')
@@ -166,6 +174,63 @@ export default async function describe(options: z.infer<typeof argsSchema>, cont
 	}
 }
 
+/**
+ * Renders the describe result as TypeScript interface declarations.
+ * Handles single helpers, arrays of helpers (registry describes), and the container.
+ */
+function renderResultAsTypeScript(result: { json: any; text: string }, targets: string[], describer: ContainerDescriber, sections: (IntrospectionSection | 'description')[]): string {
+	const json = result.json
+	const section = sections.length === 1 && sections[0] !== 'description' ? sections[0] as IntrospectionSection : undefined
+
+	// Single helper introspection object (has shortcut = full data, or id = filtered data)
+	if (json && (json.shortcut || json.id)) {
+		// If sections were applied, the JSON is partial — get full data and pass section to renderer
+		const fullData = json.shortcut ? json : __INTROSPECTION__.get(json.id) || json
+		return presentIntrospectionAsTypeScript(fullData, section)
+	}
+
+	// Container introspection (has className, registries, factories)
+	if (json && json.className && json.registries) {
+		const container = (describer as any).container
+		return container.inspectAsType()
+	}
+
+	// Array of results (e.g. from registry describe or multiple targets)
+	if (Array.isArray(json)) {
+		const interfaces = json
+			.filter((item: any) => item && (item.shortcut || item.id))
+			.map((item: any) => {
+				const fullData = item.shortcut ? item : __INTROSPECTION__.get(item.id) || item
+				return presentIntrospectionAsTypeScript(fullData, section)
+			})
+		return interfaces.join('\n\n')
+	}
+
+	// Object keyed by helper id (registry describe format — has _shared and per-helper summaries)
+	if (json && typeof json === 'object' && !json._helper && json._shared) {
+		const ids = Object.keys(json).filter(k => k !== '_shared')
+		const interfaces = ids
+			.map((id: string) => {
+				// Try qualified key first (e.g. "clients.rest"), then scan the introspection map
+				for (const prefix of ['features', 'clients', 'servers', 'commands', 'endpoints']) {
+					const data = __INTROSPECTION__.get(`${prefix}.${id}`)
+					if (data) return presentIntrospectionAsTypeScript(data, section)
+				}
+				return null
+			})
+			.filter(Boolean)
+		if (interfaces.length > 0) return interfaces.join('\n\n')
+	}
+
+	// Member-level result (has _helper and _type) — render the full helper interface
+	if (json && json._helper) {
+		const fullData = __INTROSPECTION__.get(json._helper) || __INTROSPECTION__.get(`features.${json._helper}`)
+		if (fullData) return presentIntrospectionAsTypeScript(fullData)
+	}
+
+	return result.text
+}
+
 commands.registerHandler('describe', {
 	description: 'Describe the container, registries, or individual helpers',
 	argsSchema,

package/src/commands/prompt.ts

@@ -12,7 +12,8 @@ declare module '../command.js' {
 
 export const argsSchema = CommandOptionsSchema.extend({
 	model: z.string().optional().describe('Override the LLM model (assistant mode only)'),
-	'preserve-frontmatter': z.boolean().default(false).describe('Keep YAML frontmatter in the prompt instead of stripping it before sending to the agent.'),
+	'include-frontmatter': z.boolean().default(false).describe('Keep YAML frontmatter in the prompt instead of stripping it before sending to the agent.'),
+	'skip-eval': z.boolean().default(false).describe('Skip execution of fenced code blocks in the prompt file'),
 	'permission-mode': z.enum(['default', 'acceptEdits', 'bypassPermissions', 'plan']).default('acceptEdits').describe('Permission mode for CLI agents (default: acceptEdits)'),
 	'in-folder': z.string().optional().describe('Run the CLI agent in this directory (resolved via container.paths)'),
 	'out-file': z.string().optional().describe('Save session output as a markdown file'),
@@ -790,12 +791,31 @@ async function preparePrompt(
 	}
 
 	let promptContent: string
-	if (options['preserve-frontmatter']) {
-		promptContent = content
+	if (options['skip-eval']) {
+		// Strip frontmatter but don't execute code blocks
+		if (content.startsWith('---')) {
+			const fmEnd = content.indexOf('\n---', 3)
+			if (fmEnd !== -1) {
+				promptContent = content.slice(fmEnd + 4).trimStart()
+			} else {
+				promptContent = content
+			}
+		} else {
+			promptContent = content
+		}
 	} else {
 		promptContent = await executePromptFile(resolvedPath, container, resolvedInputs)
 	}
 
+	// Re-attach frontmatter if requested
+	if (options['include-frontmatter'] && content.startsWith('---')) {
+		const fmEnd = content.indexOf('\n---', 3)
+		if (fmEnd !== -1) {
+			const frontmatter = content.slice(0, fmEnd + 4)
+			promptContent = frontmatter + '\n' + promptContent
+		}
+	}
+
 	// Substitute {{key}} placeholders with resolved input values
 	if (Object.keys(resolvedInputs).length) {
 		promptContent = substituteInputs(promptContent, resolvedInputs)

package/src/commands/serve.ts

@@ -19,6 +19,7 @@ export const argsSchema = CommandOptionsSchema.extend({
 	force: z.boolean().default(false).describe('Kill any process currently using the target port'),
 	anyPort: z.boolean().default(false).describe('Find an available port starting above 3000'),
 	open: z.boolean().default(true).describe('Open the server URL in Google Chrome'),
+	watch: z.boolean().default(false).describe('Watch endpoint files and hot-reload handlers on change'),
 })
 
 export default async function serve(options: z.infer<typeof argsSchema>, context: ContainerContext) {
@@ -157,6 +158,32 @@ export default async function serve(options: z.infer<typeof argsSchema>, context
 		}
 	}
 
+	if (options.watch && endpointsDir) {
+		const fm = container.feature('fileManager')
+		await fm.watch({ paths: [endpointsDir] })
+
+		fm.on('file:change', async ({ type, path: filePath }: { type: string; path: string }) => {
+			if (!filePath.endsWith('.ts')) return
+
+			if (type === 'change') {
+				try {
+					const ep = await expressServer.reloadEndpoint(filePath)
+					if (ep) {
+						console.log(`[watch] Reloaded ${ep.methods.map((m: string) => m.toUpperCase()).join(',')} ${ep.path}`)
+					}
+				} catch (err: any) {
+					console.error(`[watch] Failed to reload ${filePath}: ${err.message}`)
+				}
+			} else if (type === 'add') {
+				console.log(`[watch] New file detected: ${filePath} (restart to mount)`)
+			} else if (type === 'delete') {
+				console.log(`[watch] File deleted: ${filePath} (restart to unmount)`)
+			}
+		})
+
+		console.log(`\n[watch] Watching ${endpointsDir} for changes`)
+	}
+
 	console.log()
 }