@soederpop/luca 0.0.14 → 0.0.16

package/assistants/architect/CORE.md

@@ -0,0 +1,3 @@
+# Luca Framework Assistant 
+
+Your job is to help people use the Luca framework

package/assistants/architect/hooks.ts

@@ -0,0 +1,3 @@
+export function started() {
+	console.log('Assistant started!')
+}

package/assistants/architect/tools.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod'
+
+export const schemas = {
+	README: z.object({}).describe('CALL THIS README FUNCTION AS EARLY AS POSSIBLE')
+}
+
+export function README(options: z.infer<typeof schemas.README>) {
+	return 'YO YO'
+}
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soederpop/luca",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "website": "https://luca.soederpop.com",
   "description": "lightweight universal conversational architecture AKA Le Ultimate Component Architecture AKA Last Universal Common Ancestor, part AI part Human",
   "author": "jon soeder aka the people's champ <jon@soederpop.com>",

package/src/agi/features/assistant.ts

@@ -646,6 +646,11 @@ export class Assistant extends Feature<AssistantState, AssistantOptions> {
 			this.conversation.state.set('thread', threadId)
 			this.conversation.state.set('messages', messages)
 			this.state.set('conversationId', existing.id)
+
+			// Restore lastResponseId so the Responses API can continue the chain
+			if (existing.metadata?.lastResponseId) {
+				this.conversation.state.set('lastResponseId', existing.metadata.lastResponseId)
+			}
 		} else {
 			// Fresh conversation — just set thread
 			this.conversation.state.set('thread', threadId)

package/src/agi/features/conversation.ts

@@ -407,11 +407,23 @@ export class Conversation extends Feature<ConversationState, ConversationOptions
 
 		try {
 			if (this.apiMode === 'responses') {
+				const previousResponseId = this.state.get('lastResponseId') || undefined
+				let input: OpenAI.Responses.ResponseInput
+
+				if (previousResponseId) {
+					// Can chain via previous_response_id — only send the new user message
+					input = [this.toResponsesUserMessage(content)]
+				} else {
+					// No previous response ID (first call or resumed from disk).
+					// Convert full message history to Responses API input so the model has context.
+					input = this.messagesToResponsesInput()
+				}
+
 				return await this.runResponsesLoop({
 					turn: 1,
 					accumulated: '',
-					input: [this.toResponsesUserMessage(content)],
-					previousResponseId: this.state.get('lastResponseId') || undefined,
+					input,
+					previousResponseId,
 				})
 			}
 
@@ -456,6 +468,53 @@ export class Conversation extends Feature<ConversationState, ConversationOptions
 		}
 	}
 
+	/**
+	 * Convert the full Chat Completions message history into Responses API input items.
+	 * Used when resuming a conversation without a previous_response_id.
+	 */
+	private messagesToResponsesInput(): OpenAI.Responses.ResponseInput {
+		const input: OpenAI.Responses.ResponseInput = []
+
+		for (const msg of this.messages) {
+			if (msg.role === 'system' || msg.role === 'developer') {
+				// System/developer messages are handled via the instructions parameter
+				continue
+			}
+
+			if (msg.role === 'user') {
+				if (typeof msg.content === 'string') {
+					input.push({
+						type: 'message',
+						role: 'user',
+						content: [{ type: 'input_text', text: msg.content }],
+					})
+				} else if (Array.isArray(msg.content)) {
+					input.push(this.toResponsesUserMessage(msg.content as ContentPart[]))
+				}
+				continue
+			}
+
+			if (msg.role === 'assistant') {
+				const content = typeof msg.content === 'string' ? msg.content : (msg.content || []).map((p: any) => p.text || '').join('')
+				if (content) {
+					input.push({
+						type: 'message',
+						role: 'assistant',
+						content: [{ type: 'output_text', text: content, annotations: [] }],
+						id: `msg_replay-${input.length}`,
+						status: 'completed',
+					} as any)
+				}
+				continue
+			}
+
+			// Tool results — skip in the replay since the assistant's tool_calls won't have matching IDs
+			// The model will still understand context from the assistant messages that followed
+		}
+
+		return input
+	}
+
 	/** Returns the OpenAI client instance from the container. */
 	get openai() {
 		let baseURL = this.options.clientOptions?.baseURL ? this.options.clientOptions.baseURL : undefined
@@ -488,13 +547,17 @@ export class Conversation extends Feature<ConversationState, ConversationOptions
 		const id = this.state.get('id')!
 		const existing = await this.history.load(id)
 
+		// Persist lastResponseId so the Responses API can continue the chain on resume
+		const lastResponseId = this.state.get('lastResponseId')
+		const responseMeta = lastResponseId ? { lastResponseId } : {}
+
 		if (existing) {
 			existing.messages = this.messages
 			existing.model = this.model
 			if (opts?.title) existing.title = opts.title
 			if (opts?.tags) existing.tags = opts.tags
 			if (opts?.thread) existing.thread = opts.thread
-			if (opts?.metadata) existing.metadata = { ...existing.metadata, ...opts.metadata }
+			existing.metadata = { ...existing.metadata, ...responseMeta, ...(opts?.metadata || {}) }
 			await this.history.save(existing)
 			return existing
 		}
@@ -506,7 +569,7 @@ export class Conversation extends Feature<ConversationState, ConversationOptions
 			messages: this.messages,
 			tags: opts?.tags || this.options.tags || [],
 			thread: opts?.thread || this.options.thread || this.state.get('thread'),
-			metadata: opts?.metadata || this.options.metadata || {},
+			metadata: { ...responseMeta, ...(opts?.metadata || this.options.metadata || {}) },
 		})
 	}
 

package/src/bootstrap/generated.ts

@@ -1,5 +1,5 @@
 // Auto-generated bootstrap content
-// Generated at: 2026-03-20T03:57:57.385Z
+// Generated at: 2026-03-20T16:22:30.732Z
 // Source: docs/bootstrap/*.md, docs/bootstrap/templates/*
 //
 // Do not edit manually. Run: luca build-bootstrap

package/src/commands/chat.ts

@@ -17,6 +17,7 @@ export const argsSchema = CommandOptionsSchema.extend({
 	list: z.boolean().optional().describe('List recent conversations and exit'),
 	historyMode: z.enum(['lifecycle', 'daily', 'persistent', 'session']).optional().describe('Override history persistence mode'),
 	offRecord: z.boolean().optional().describe('Alias for --history-mode lifecycle (ephemeral, no persistence)'),
+	clear: z.boolean().optional().describe('Clear the conversation history for the resolved history mode and exit'),
 })
 
 export default async function chat(options: z.infer<typeof argsSchema>, context: ContainerContext) {
@@ -72,6 +73,17 @@ export default async function chat(options: z.infer<typeof argsSchema>, context:
 
 	const assistant = manager.create(name, createOptions)
 
+	// --clear: wipe history for the current mode and exit
+	if (options.clear) {
+		const deleted = await assistant.clearHistory()
+		if (deleted > 0) {
+			console.log(ui.colors.green(`  Cleared ${deleted} conversation(s) for ${ui.colors.cyan(name)} (${historyMode} mode).`))
+		} else {
+			console.log(ui.colors.dim(`  No history to clear for ${ui.colors.cyan(name)} (${historyMode} mode).`))
+		}
+		return
+	}
+
 	// --list: show recent conversations and exit
 	if (options.list) {
 		const history = await assistant.listHistory({ limit: 20 })