@soederpop/luca 0.0.28 → 0.0.30

package/src/cli/build-info.ts

@@ -1,4 +1,4 @@
 // Generated at compile time — do not edit manually
-export const BUILD_SHA = 'c1e466d'
+export const BUILD_SHA = 'd0653ac'
 export const BUILD_BRANCH = 'main'
-export const BUILD_DATE = '2026-03-23T07:45:58Z'
+export const BUILD_DATE = '2026-03-24T06:38:37Z'

package/src/clients/rest.ts

@@ -50,7 +50,7 @@ export class RestClient<
     }
   }
 
-  async beforeRequest() {
+  async beforeRequest(): Promise<void> {
   }
 
   /** Whether JSON content-type headers should be set automatically. */
@@ -71,7 +71,7 @@ export class RestClient<
    * @param options - Additional axios request config
    * @returns Parsed response body
    */
-  async patch(url: string, data: any = {}, options: AxiosRequestConfig = {}) {
+  async patch(url: string, data: any = {}, options: AxiosRequestConfig = {}): Promise<any> {
     await this.beforeRequest();
     return this.axios({
       ...options,
@@ -98,7 +98,7 @@ export class RestClient<
    * @param options - Additional axios request config
    * @returns Parsed response body
    */
-  async put(url: string, data: any = {}, options: AxiosRequestConfig = {}) {
+  async put(url: string, data: any = {}, options: AxiosRequestConfig = {}): Promise<any> {
     await this.beforeRequest();
     return this.axios({
       ...options,
@@ -125,7 +125,7 @@ export class RestClient<
    * @param options - Additional axios request config
    * @returns Parsed response body
    */
-  async post(url: string, data: any = {}, options: AxiosRequestConfig = {}) {
+  async post(url: string, data: any = {}, options: AxiosRequestConfig = {}): Promise<any> {
     await this.beforeRequest();
     return this.axios({
       ...options,
@@ -152,7 +152,7 @@ export class RestClient<
    * @param options - Additional axios request config
    * @returns Parsed response body
    */
-  async delete(url: string, params: any = {}, options: AxiosRequestConfig = {}) {
+  async delete(url: string, params: any = {}, options: AxiosRequestConfig = {}): Promise<any> {
     await this.beforeRequest();
     return this.axios({
       ...options,
@@ -179,7 +179,7 @@ export class RestClient<
    * @param options - Additional axios request config
    * @returns Parsed response body
    */
-  async get(url: string, params: any = {}, options: AxiosRequestConfig = {}) {
+  async get(url: string, params: any = {}, options: AxiosRequestConfig = {}): Promise<any> {
     await this.beforeRequest()
     return this.axios({
       ...options,
@@ -198,7 +198,7 @@ export class RestClient<
   }
 
   /** Handle an axios error by emitting 'failure' and returning the error as JSON. */
-  async handleError(error: AxiosError) {
+  async handleError(error: AxiosError): Promise<object> {
     this.emit('failure', error)
     return error.toJSON();
   }

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)