@agentuity/opencode 1.0.15 → 1.0.17

package/src/sqlite/reader.ts

@@ -5,10 +5,12 @@ import { join } from 'node:path';
 import { QUERIES } from './queries';
 import type {
 	DBMessage,
+	DBNonTextPart,
 	DBSession,
 	DBTextPart,
 	DBTodo,
 	DBToolCall,
+	DBToolCallSummary,
 	MessageTokens,
 	OpenCodeDBConfig,
 	SessionCostSummary,
@@ -226,6 +228,39 @@ function mapTextPart(row: PartRow): DBTextPart | null {
 	};
 }
 
+function mapNonTextPart(row: PartRow): DBNonTextPart | null {
+	const payload = safeParseJSON<PartData>(row.data);
+	if (!payload || !payload.type || payload.type === 'text') return null;
+
+	return {
+		id: row.id,
+		messageId: row.message_id,
+		type: payload.type,
+		toolName: payload.tool,
+		timestamp: new Date(row.time_created).toISOString(),
+	};
+}
+
+function mapToolCallSummary(row: PartRow): DBToolCallSummary | null {
+	const payload = safeParseJSON<PartData>(row.data);
+	if (!payload || (payload.type !== 'tool' && payload.type !== 'tool-invocation')) return null;
+
+	const state = payload.state ?? {};
+	const inputStr =
+		state.input !== undefined ? String(JSON.stringify(state.input)).slice(0, 200) : undefined;
+	const outputStr =
+		state.output !== undefined ? String(JSON.stringify(state.output)).slice(0, 200) : undefined;
+
+	return {
+		id: row.id,
+		messageId: row.message_id,
+		toolName: payload.tool ?? 'unknown',
+		input: inputStr,
+		output: outputStr,
+		timestamp: new Date(row.time_created).toISOString(),
+	};
+}
+
 function isNotNull<T>(value: T | null): value is T {
 	return value !== null;
 }
@@ -475,6 +510,40 @@ export class OpenCodeDBReader {
 		}
 	}
 
+	/**
+	 * Get non-text parts (images, files, tool calls) for a session.
+	 * Useful for describing attachments during compaction.
+	 */
+	getNonTextParts(sessionId: string): DBNonTextPart[] {
+		if (!this.ensureOpen()) return [];
+
+		try {
+			const statement = this.getStatement('GET_NON_TEXT_PARTS');
+			const rows = statement?.all(sessionId, DEFAULT_LIMIT) as PartRow[] | null;
+			return rows ? rows.map(mapNonTextPart).filter(isNotNull) : [];
+		} catch (error) {
+			console.warn('[OpenCodeDBReader] Failed to get non-text parts', error);
+			return [];
+		}
+	}
+
+	/**
+	 * Get recent tool calls for a session (newest first).
+	 * Returns concise summaries for compaction context.
+	 */
+	getRecentToolCalls(sessionId: string, limit: number = 5): DBToolCallSummary[] {
+		if (!this.ensureOpen()) return [];
+
+		try {
+			const statement = this.getStatement('GET_TOOL_HISTORY');
+			const rows = statement?.all(sessionId, limit) as PartRow[] | null;
+			return rows ? rows.map(mapToolCallSummary).filter(isNotNull) : [];
+		} catch (error) {
+			console.warn('[OpenCodeDBReader] Failed to get recent tool calls', error);
+			return [];
+		}
+	}
+
 	getTodos(sessionId: string): DBTodo[] {
 		if (!this.ensureOpen()) return [];
 

package/src/sqlite/types.ts

@@ -119,3 +119,43 @@ export interface OpenCodeDBConfig {
 	dbPath?: string;
 	enableSchemaValidation?: boolean;
 }
+
+/** Non-text message part (image, file attachment, etc.) */
+export interface DBNonTextPart {
+	id: string;
+	messageId: string;
+	type: string;
+	toolName?: string;
+	timestamp?: string;
+}
+
+/** Tool call summary for compaction context */
+export interface DBToolCallSummary {
+	id: string;
+	messageId: string;
+	toolName: string;
+	input?: string;
+	output?: string;
+	timestamp: string;
+}
+
+/** Stats about what compaction preserved */
+export interface CompactionStats {
+	planningPhasesCount: number;
+	backgroundTasksCount: number;
+	imageDescriptionsCount: number;
+	toolCallSummariesCount: number;
+	estimatedTokens: number;
+}
+
+/** Pre-compaction state snapshot stored to KV */
+export interface PreCompactionSnapshot {
+	timestamp: string;
+	sessionId: string;
+	planningState?: Record<string, unknown>;
+	backgroundTasks?: Array<{ id: string; description: string; status: string }>;
+	imageDescriptions?: string[];
+	toolCallSummaries?: string[];
+	cadenceState?: Record<string, unknown>;
+	branch?: string;
+}

package/src/tools/background.ts

@@ -105,6 +105,12 @@ export function createBackgroundTools(manager: BackgroundManager): {
 			status: string;
 			result?: string;
 			error?: string;
+			progress?: {
+				toolCalls: number;
+				lastTool?: string;
+				lastToolSec: number;
+				activeTools: number;
+			};
 		}> {
 			const task = manager.getTask(args.task_id);
 			if (!task) {
@@ -114,12 +120,34 @@ export function createBackgroundTools(manager: BackgroundManager): {
 					error: 'Task not found.',
 				};
 			}
+
+			// Include compact progress snapshot only for active tasks.
+			// Three numbers + optional tool name — minimal context cost.
+			// lastToolSec: seconds since the last tool call event was received.
+			//   0 = active right now; >300 with activeTools=0 = genuinely stuck.
+			let progress:
+				| { toolCalls: number; lastTool?: string; lastToolSec: number; activeTools: number }
+				| undefined;
+
+			if ((task.status === 'running' || task.status === 'pending') && task.progress) {
+				const lastToolSec = Math.floor(
+					(Date.now() - task.progress.lastUpdate.getTime()) / 1000
+				);
+				progress = {
+					toolCalls: task.progress.toolCalls,
+					lastTool: task.progress.lastTool,
+					lastToolSec,
+					activeTools: task.progress.activeToolCallsInFlight,
+				};
+			}
+
 			return {
 				taskId: task.id,
 				sessionId: task.sessionId,
 				status: task.status,
 				result: task.result,
 				error: task.error,
+				progress,
 			};
 		},
 	};

package/src/types.ts

@@ -89,6 +89,16 @@ export interface AgentConfig {
 	reasoningEffort?: ReasoningEffort;
 	/** Extended thinking configuration for Anthropic models */
 	thinking?: ThinkingConfig;
+	/**
+	 * Ordered list of fallback model IDs to try when the primary model fails
+	 * with a retryable error (429 rate limit, 500/502/503 server error).
+	 * Models are tried in order until one succeeds.
+	 *
+	 * Example: ['anthropic/claude-sonnet-4-20250514', 'openai/gpt-4.1']
+	 */
+	fallbackModels?: string[];
+	/** Hidden from @ autocomplete */
+	hidden?: boolean;
 }
 
 export interface AgentContext {
@@ -151,6 +161,24 @@ export const AgentModelConfigSchema = z.object({
 	maxSteps: z.number().optional(),
 });
 
+/** Configuration for compaction behavior */
+export interface CompactionConfig {
+	/** Use custom compaction prompt tailored to our agent system (default: true) */
+	customPrompt?: boolean;
+	/** Inline planning state from KV into compaction context (default: true) */
+	inlinePlanning?: boolean;
+	/** Detect and describe images/attachments (default: true) */
+	imageAwareness?: boolean;
+	/** Number of recent tool calls to summarize (default: 5, 0 to disable) */
+	toolCallSummaryLimit?: number;
+	/** Store pre-compaction snapshot to KV for recovery (default: true) */
+	snapshotToKV?: boolean;
+	/** Max tokens budget for ALL injected compaction context combined (default: 4000) */
+	maxContextTokens?: number;
+	/** Reserved token buffer for compaction prompts (default: 40000). Must not exceed OpenCode's max context window. */
+	reserved?: number;
+}
+
 export interface CoderConfig {
 	org?: string;
 	disabledMcps?: string[];
@@ -159,6 +187,7 @@ export interface CoderConfig {
 	background?: BackgroundTaskConfig;
 	skills?: SkillsConfig;
 	tmux?: TmuxConfig;
+	compaction?: CompactionConfig;
 }
 
 export const BackgroundTaskConfigSchema = z.object({
@@ -182,6 +211,16 @@ export const TmuxConfigSchema = z.object({
 	agentPaneMinWidth: z.number(),
 });
 
+export const CompactionConfigSchema = z.object({
+	customPrompt: z.boolean().optional(),
+	inlinePlanning: z.boolean().optional(),
+	imageAwareness: z.boolean().optional(),
+	toolCallSummaryLimit: z.number().optional(),
+	snapshotToKV: z.boolean().optional(),
+	maxContextTokens: z.number().optional(),
+	reserved: z.number().optional(),
+});
+
 export const CoderConfigSchema = z.object({
 	org: z.string().optional(),
 	disabledMcps: z.array(z.string()).optional(),
@@ -189,6 +228,7 @@ export const CoderConfigSchema = z.object({
 	background: BackgroundTaskConfigSchema.optional(),
 	skills: SkillsConfigSchema.optional(),
 	tmux: TmuxConfigSchema.optional(),
+	compaction: CompactionConfigSchema.optional(),
 });
 
 export interface McpConfig {