@agentuity/opencode 1.0.14 → 1.0.16

package/dist/plugin/hooks/compaction-utils.js

@@ -0,0 +1,259 @@
+/**
+ * Get the current git branch name.
+ * Moved here from cadence.ts and session-memory.ts to deduplicate.
+ */
+export async function getCurrentBranch() {
+    try {
+        const proc = Bun.spawn(['git', 'branch', '--show-current'], {
+            stdout: 'pipe',
+            stderr: 'pipe',
+        });
+        const stdout = await new Response(proc.stdout).text();
+        await proc.exited;
+        return stdout.trim() || 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/**
+ * Access Agentuity KV storage via CLI.
+ * All calls are wrapped in try/catch — returns null on failure.
+ */
+async function kvGet(namespace, key) {
+    try {
+        const proc = Bun.spawn(['agentuity', 'cloud', 'kv', 'get', namespace, key, '--json'], {
+            stdout: 'pipe',
+            stderr: 'pipe',
+        });
+        const output = await new Response(proc.stdout).text();
+        const exitCode = await proc.exited;
+        if (exitCode !== 0)
+            return null;
+        return JSON.parse(output);
+    }
+    catch {
+        return null;
+    }
+}
+async function kvSet(namespace, key, value) {
+    try {
+        const proc = Bun.spawn(['agentuity', 'cloud', 'kv', 'set', namespace, key, JSON.stringify(value)], { stdout: 'pipe', stderr: 'pipe' });
+        const exitCode = await proc.exited;
+        return exitCode === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Build the custom compaction prompt for our agent system.
+ * This REPLACES the default OpenCode compaction prompt via output.prompt.
+ */
+export function buildCustomCompactionPrompt(mode) {
+    const cadenceSection = mode === 'cadence'
+        ? `
+
+## Cadence Loop State
+- Loop ID, iteration number, max iterations
+- Current phase and what's in progress
+- Whether this is a Lead-of-Leads session with child tasks`
+        : '';
+    return `You are generating a continuation context for a multi-agent coding system (Agentuity Coder). Your summary will be the ONLY context the orchestrating Lead agent has after this compaction. Preserve everything needed for seamless continuation.
+
+## CRITICAL — Preserve These Verbatim
+1. The current task/objective (quote the user's original request exactly)
+2. All background task IDs (bg_xxx) with status, purpose, and session IDs
+3. Active planning state: current phase, completed phases, next steps, blockers
+4. ALL file paths being actively worked on (with role: created/modified/read)
+5. Key decisions made and their rationale
+6. Any corrections or gotchas discovered during the session
+7. Todo list state (what's done, in progress, pending)
+8. Descriptions of any images or attachments that appeared in conversation${cadenceSection}
+
+## Structure Your Summary As:
+
+### Active Task
+[Verbatim objective + what the agent was doing when compaction fired]
+
+### Planning State
+[Phases with status. Include phase notes, not just titles.]
+
+### Background Tasks
+[bg_xxx: description → status (running/completed/errored). Include session IDs.]
+
+### Key Context
+[Decisions, constraints, user preferences, corrections discovered]
+
+### Active Files
+[filepath → role (creating/modifying/reading) + what's being done to it]
+
+### Images & Attachments
+[Describe any images/screenshots: what they showed, when they appeared, why they mattered]
+
+### Next Steps
+[What should happen immediately after compaction resumes]
+
+## Rules
+- Use specific file paths, task IDs, phase names — NOT vague references.
+- State what tools returned, not just that they were called.
+- NEVER drop background task references — the agent MUST know what's still running.
+- Prefer completeness over brevity — this is the agent's entire working memory.`;
+}
+/**
+ * Fetch planning state from KV and format as markdown.
+ * Returns null if KV is unavailable or no planning state exists.
+ */
+export async function fetchAndFormatPlanningState(sessionId) {
+    try {
+        const record = await kvGet('agentuity-opencode-memory', `session:${sessionId}`);
+        if (!record || typeof record !== 'object')
+            return null;
+        const data = record.data ?? record;
+        const planning = data.planning;
+        if (!planning)
+            return null;
+        const lines = ['## Planning State (from KV)'];
+        if (planning.objective)
+            lines.push(`**Objective:** ${planning.objective}`);
+        if (planning.current)
+            lines.push(`**Current:** ${planning.current}`);
+        if (planning.next)
+            lines.push(`**Next:** ${planning.next}`);
+        const phases = planning.phases;
+        if (phases?.length) {
+            lines.push('', '### Phases:');
+            for (const p of phases) {
+                const status = p.status ?? 'unknown';
+                const title = p.title ?? p.content ?? 'untitled';
+                const notes = p.notes ? ` — ${String(p.notes).slice(0, 100)}` : '';
+                lines.push(`- [${status}] ${title}${notes}`);
+            }
+        }
+        const findings = planning.findings;
+        if (findings?.length) {
+            lines.push('', '### Key Findings:');
+            for (const f of findings.slice(0, 5)) {
+                lines.push(`- ${String(f).slice(0, 150)}`);
+            }
+        }
+        const errors = planning.errors;
+        if (errors?.length) {
+            lines.push('', '### Errors to Avoid:');
+            for (const e of errors.slice(0, 3)) {
+                lines.push(`- ${String(e).slice(0, 150)}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get image/attachment descriptions from SQLite for compaction context.
+ * Returns brief metadata about non-text parts in the conversation.
+ */
+export function getImageDescriptions(dbReader, sessionId) {
+    if (!dbReader?.isAvailable())
+        return null;
+    try {
+        const parts = dbReader.getNonTextParts(sessionId);
+        if (!parts.length)
+            return null;
+        // Filter to image-like parts (not tool calls — those are separate)
+        const imageParts = parts.filter((p) => !['tool-invocation', 'tool-result', 'text'].includes(p.type));
+        if (!imageParts.length)
+            return null;
+        const lines = ['## Images & Attachments'];
+        for (const part of imageParts.slice(0, 10)) {
+            const when = part.timestamp ? ` at ${part.timestamp}` : '';
+            lines.push(`- [${part.type}]${when}: message ${part.messageId}`);
+        }
+        return lines.join('\n');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get recent tool call summaries for compaction context.
+ * CONCISE — capped at limit calls, brief descriptions only.
+ */
+export function getRecentToolCallSummaries(dbReader, sessionId, limit = 5) {
+    if (!dbReader?.isAvailable() || limit <= 0)
+        return null;
+    try {
+        const calls = dbReader.getRecentToolCalls(sessionId, limit);
+        if (!calls.length)
+            return null;
+        const lines = ['## Recent Tool Activity'];
+        for (const call of calls) {
+            const inputBrief = call.input ? ` — ${String(call.input).slice(0, 80)}` : '';
+            const outputBrief = call.output ? ` → ${String(call.output).slice(0, 80)}` : '';
+            lines.push(`- ${call.toolName}${inputBrief}${outputBrief}`);
+        }
+        return lines.join('\n');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Store a pre-compaction snapshot to KV as a recovery mechanism.
+ */
+export async function storePreCompactionSnapshot(sessionId, snapshot) {
+    try {
+        await kvSet('agentuity-opencode-memory', `compaction:snapshot:${sessionId}`, snapshot);
+    }
+    catch {
+        // Silently fail — this is a best-effort recovery mechanism
+    }
+}
+/**
+ * Persist Cadence session state to KV for recovery after plugin restart.
+ */
+export async function persistCadenceStateToKV(sessionId, state) {
+    try {
+        await kvSet('agentuity-opencode-memory', `cadence:active:${sessionId}`, state);
+    }
+    catch {
+        // Silently fail
+    }
+}
+/**
+ * Restore Cadence session state from KV.
+ */
+export async function restoreCadenceStateFromKV(sessionId) {
+    try {
+        const state = await kvGet('agentuity-opencode-memory', `cadence:active:${sessionId}`);
+        return state;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Format compaction diagnostics — brief summary of what was preserved.
+ */
+export function formatCompactionDiagnostics(stats) {
+    const parts = [];
+    if (stats.planningPhasesCount > 0)
+        parts.push(`${stats.planningPhasesCount} planning phases`);
+    if (stats.backgroundTasksCount > 0)
+        parts.push(`${stats.backgroundTasksCount} background tasks`);
+    if (stats.imageDescriptionsCount > 0)
+        parts.push(`${stats.imageDescriptionsCount} image refs`);
+    if (stats.toolCallSummariesCount > 0)
+        parts.push(`${stats.toolCallSummariesCount} tool calls`);
+    if (!parts.length)
+        return '';
+    return `> **Compaction preserved:** ${parts.join(', ')} (~${stats.estimatedTokens} tokens injected)`;
+}
+/** Count markdown list items in a string */
+export function countListItems(s) {
+    if (!s)
+        return 0;
+    return (s.match(/^- /gm) ?? []).length;
+}
+//# sourceMappingURL=compaction-utils.js.map

package/dist/plugin/hooks/compaction-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-utils.js","sourceRoot":"","sources":["../../../src/plugin/hooks/compaction-utils.ts"],"names":[],"mappings":"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"}

package/dist/plugin/hooks/params.d.ts

@@ -3,7 +3,7 @@ import type { CoderConfig } from '../../types';
 export interface ParamsHooks {
     onParams: (input: unknown, output: unknown) => Promise<void>;
 }
-export declare function createParamsHooks(ctx: PluginInput, _config: CoderConfig): ParamsHooks;
+export declare function createParamsHooks(ctx: PluginInput, _config: CoderConfig, lastUserMessages?: Map<string, string>): ParamsHooks;
 /**
  * Advertised magic words for users:
  *

package/dist/plugin/hooks/params.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../../src/plugin/hooks/params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AA4FD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,GAAG,WAAW,CA+ErF;AAED;;;;;;;;;;;;;GAaG"}
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../../src/plugin/hooks/params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AA4FD,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,WAAW,EACpB,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,WAAW,CAoFb;AAED;;;;;;;;;;;;;GAaG"}

package/dist/plugin/hooks/params.js

@@ -80,7 +80,7 @@ function detectMode(messageContent) {
     }
     return null;
 }
-export function createParamsHooks(ctx, _config) {
+export function createParamsHooks(ctx, _config, lastUserMessages) {
     return {
         async onParams(input, output) {
             // Input contains: sessionID, agent, model, provider, message
@@ -91,6 +91,10 @@ export function createParamsHooks(ctx, _config) {
             const messageContent = inputObj.message?.content || '';
             if (!messageContent)
                 return;
+            // Store user message text for downstream hooks (e.g. cadence trigger detection)
+            if (lastUserMessages && inputObj.sessionID) {
+                lastUserMessages.set(inputObj.sessionID, messageContent);
+            }
             // Check for dynamic mode triggers
             const detected = detectMode(messageContent);
             if (!detected)

package/dist/plugin/hooks/params.js.map

@@ -1 +1 @@
-{"version":3,"file":"params.js","sourceRoot":"","sources":["../../../src/plugin/hooks/params.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../../src/plugin/hooks/params.ts"],"names":[],"mappings":"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"}

package/dist/plugin/hooks/session-memory.d.ts

@@ -1,6 +1,7 @@
 import type { PluginInput } from '@opencode-ai/plugin';
 import type { CoderConfig } from '../../types';
 import type { BackgroundManager } from '../../background';
+import type { OpenCodeDBReader } from '../../sqlite';
 export interface SessionMemoryHooks {
     onEvent: (input: {
         event: {
@@ -22,5 +23,5 @@ export interface SessionMemoryHooks {
  * 1. On compacting: Inject Memory system info into compaction prompt
  * 2. On session.compacted: Tell Lead to have Memory save the summary (it's already in context!)
  */
-export declare function createSessionMemoryHooks(ctx: PluginInput, _config: CoderConfig, backgroundManager?: BackgroundManager): SessionMemoryHooks;
+export declare function createSessionMemoryHooks(ctx: PluginInput, config: CoderConfig, backgroundManager?: BackgroundManager, dbReader?: OpenCodeDBReader): SessionMemoryHooks;
 //# sourceMappingURL=session-memory.d.ts.map

package/dist/plugin/hooks/session-memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-memory.d.ts","sourceRoot":"","sources":["../../../src/plugin/hooks/session-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAmB1D,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,CAAC,KAAK,EAAE;QAChB,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,CAAC;KAC9D,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,YAAY,EAAE,CACb,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EAC5B,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAC1C,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACvC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,WAAW,EACpB,iBAAiB,CAAC,EAAE,iBAAiB,GACnC,kBAAkB,CAkKpB"}
+{"version":3,"file":"session-memory.d.ts","sourceRoot":"","sources":["../../../src/plugin/hooks/session-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAarD,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,CAAC,KAAK,EAAE;QAChB,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,CAAC;KAC9D,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,YAAY,EAAE,CACb,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EAC5B,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAC1C,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACvC,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,WAAW,EACnB,iBAAiB,CAAC,EAAE,iBAAiB,EACrC,QAAQ,CAAC,EAAE,gBAAgB,GACzB,kBAAkB,CAoOpB"}

package/dist/plugin/hooks/session-memory.js

@@ -1,20 +1,4 @@
-/**
- * Get the current git branch name.
- */
-async function getCurrentBranch() {
-    try {
-        const proc = Bun.spawn(['git', 'branch', '--show-current'], {
-            stdout: 'pipe',
-            stderr: 'pipe',
-        });
-        const stdout = await new Response(proc.stdout).text();
-        await proc.exited;
-        return stdout.trim() || 'unknown';
-    }
-    catch {
-        return 'unknown';
-    }
-}
+import { getCurrentBranch, buildCustomCompactionPrompt, fetchAndFormatPlanningState, getImageDescriptions, getRecentToolCallSummaries, storePreCompactionSnapshot, formatCompactionDiagnostics, countListItems, } from './compaction-utils';
 /**
  * Session memory hooks handle compaction for non-Cadence sessions.
  *
@@ -22,7 +6,7 @@ async function getCurrentBranch() {
  * 1. On compacting: Inject Memory system info into compaction prompt
  * 2. On session.compacted: Tell Lead to have Memory save the summary (it's already in context!)
  */
-export function createSessionMemoryHooks(ctx, _config, backgroundManager) {
+export function createSessionMemoryHooks(ctx, config, backgroundManager, dbReader) {
     const log = (msg) => {
         ctx.client.app.log({
             body: {
@@ -118,51 +102,116 @@ Then continue with the current task if there is one.`,
         },
         /**
          * Inject Memory system info during compaction.
-         * This gets included in OpenCode's generated summary.
+         * Uses output.prompt to REPLACE the default compaction prompt with
+         * enriched context (planning state, images, tool calls, diagnostics).
          */
         async onCompacting(input, output) {
             const sessionId = input.sessionID;
             log(`Compacting session ${sessionId}`);
-            // Get current git branch
-            const branch = await getCurrentBranch();
-            // Get active background tasks for this session
+            // Config flags for compaction behavior
+            const compactionCfg = config?.compaction ?? {};
+            const useCustomPrompt = compactionCfg.customPrompt !== false;
+            const useInlinePlanning = compactionCfg.inlinePlanning !== false;
+            const useImageAwareness = compactionCfg.imageAwareness !== false;
+            const useSnapshotToKV = compactionCfg.snapshotToKV !== false;
+            const maxTokens = compactionCfg.maxContextTokens ?? 4000;
+            // 1. Build custom compaction instructions
+            const instructions = useCustomPrompt ? buildCustomCompactionPrompt('regular') : null;
+            // 2. Gather enrichment data in parallel
+            const toolCallLimit = config?.compaction?.toolCallSummaryLimit ?? 5;
+            const [branch, planningState, imageDescs, toolSummaries] = await Promise.all([
+                getCurrentBranch(),
+                useInlinePlanning ? fetchAndFormatPlanningState(sessionId) : Promise.resolve(null),
+                useImageAwareness
+                    ? Promise.resolve(getImageDescriptions(dbReader ?? null, sessionId))
+                    : Promise.resolve(null),
+                Promise.resolve(getRecentToolCallSummaries(dbReader ?? null, sessionId, toolCallLimit)),
+            ]);
+            // 3. Build session state section
+            const sessionStateSection = `## Session Memory
+
+This session's context is being saved to persistent memory.
+Session record location: \`session:${sessionId}\` in agentuity-opencode-memory
+Current branch: ${branch}
+
+After compaction:
+1. Memory will save this summary to the session record
+2. If planning is active, Memory should update planning.progress with this compaction
+3. Memory will apply inline reasoning if significant patterns/corrections emerged`;
+            // 4. Build background tasks section
             const tasks = backgroundManager?.getTasksByParent(sessionId) ?? [];
-            let backgroundTaskContext = '';
+            let backgroundSection = null;
             if (tasks.length > 0) {
                 const taskList = tasks
                     .map((t) => `- **${t.id}**: ${t.description || 'No description'} (session: ${t.sessionId ?? 'pending'}, status: ${t.status})`)
                     .join('\n');
-                backgroundTaskContext = `
-
-## Active Background Tasks
+                backgroundSection = `## Active Background Tasks
 
 This session has ${tasks.length} background task(s) running in separate sessions:
 ${taskList}
 
 **CRITICAL:** Task IDs and session IDs persist across compaction - these tasks are still running.
-Use \`agentuity_background_output({ task_id: "..." })\` to check their status.
-`;
+Use \`agentuity_background_output({ task_id: "..." })\` to check their status.`;
+            }
+            // 5. Combine everything into the full prompt
+            const sections = [];
+            if (instructions)
+                sections.push(instructions);
+            sections.push(sessionStateSection);
+            if (backgroundSection)
+                sections.push(backgroundSection);
+            if (planningState)
+                sections.push(planningState);
+            if (imageDescs)
+                sections.push(imageDescs);
+            if (toolSummaries)
+                sections.push(toolSummaries);
+            // 6. Add diagnostics
+            const stats = {
+                planningPhasesCount: countListItems(planningState),
+                backgroundTasksCount: tasks.length,
+                imageDescriptionsCount: countListItems(imageDescs),
+                toolCallSummariesCount: countListItems(toolSummaries),
+                estimatedTokens: Math.ceil(sections.join('\n\n').length / 4),
+            };
+            const diagnostics = formatCompactionDiagnostics(stats);
+            if (diagnostics)
+                sections.push(diagnostics);
+            // 7. Enforce token budget
+            let fullPrompt = sections.join('\n\n');
+            const estimatedTokens = Math.ceil(fullPrompt.length / 4);
+            if (maxTokens > 0 && estimatedTokens > maxTokens) {
+                // Trim least-critical sections first
+                const trimOrder = [diagnostics, toolSummaries, imageDescs, planningState].filter(Boolean);
+                let trimmed = [...sections];
+                for (const candidate of trimOrder) {
+                    if (Math.ceil(trimmed.join('\n\n').length / 4) <= maxTokens)
+                        break;
+                    trimmed = trimmed.filter((s) => s !== candidate);
+                }
+                fullPrompt = trimmed.join('\n\n');
+            }
+            // 8. Set the full prompt or push to context
+            if (useCustomPrompt) {
+                output.prompt = fullPrompt;
+            }
+            else {
+                output.context.push(fullPrompt);
+            }
+            // 9. Store pre-compaction snapshot to KV (fire-and-forget)
+            if (useSnapshotToKV) {
+                storePreCompactionSnapshot(sessionId, {
+                    timestamp: new Date().toISOString(),
+                    sessionId,
+                    planningState: planningState ? { raw: planningState } : undefined,
+                    backgroundTasks: tasks.map((t) => ({
+                        id: t.id,
+                        description: t.description || 'No description',
+                        status: t.status,
+                    })),
+                    branch,
+                }).catch(() => { }); // Fire and forget
             }
-            output.context.push(`
-## Session Memory
-
-This session's context is being saved to persistent memory.
-Session record location: \`session:${sessionId}\` in agentuity-opencode-memory
-Current branch: ${branch}
-
-**Planning State (if active):**
-If this session has planning active (user requested "track progress" or similar), the session record contains:
-- \`planning.prdKey\` - Link to PRD if one exists
-- \`planning.objective\` - What we're trying to accomplish
-- \`planning.phases\` - Current phases with status and notes
-- \`planning.findings\` - Discoveries made during work
-- \`planning.errors\` - Failures to avoid repeating
-${backgroundTaskContext}
-After compaction:
-1. Memory will save this summary to the session record
-2. If planning is active, Memory should update planning.progress with this compaction
-3. Memory will apply inline reasoning if significant patterns/corrections emerged
-`);
         },
     };
 }

package/dist/plugin/hooks/session-memory.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-memory.js","sourceRoot":"","sources":["../../../src/plugin/hooks/session-memory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-memory.js","sourceRoot":"","sources":["../../../src/plugin/hooks/session-memory.ts"],"names":[],"mappings":"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"}

package/dist/plugin/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAgF9D,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CA0KxE"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAgF9D,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAqMxE"}

package/dist/plugin/plugin.js

@@ -64,10 +64,13 @@ export async function createCoderPlugin(ctx) {
     const coderConfig = mergeConfig(getDefaultConfig(), userConfig);
     const resolvedDbPath = resolveOpenCodeDBPath();
     const dbReader = new OpenCodeDBReader(resolvedDbPath ? { dbPath: resolvedDbPath } : undefined);
+    // Shared Map: chat.params stores the user's message text per session,
+    // chat.message reads it for trigger detection (avoids scanning model output).
+    const lastUserMessages = new Map();
     const sessionHooks = createSessionHooks(ctx, coderConfig);
     const toolHooks = createToolHooks(ctx, coderConfig);
     const keywordHooks = createKeywordHooks(ctx, coderConfig);
-    const paramsHooks = createParamsHooks(ctx, coderConfig);
+    const paramsHooks = createParamsHooks(ctx, coderConfig, lastUserMessages);
     const tmuxManager = coderConfig.tmux?.enabled
         ? new TmuxSessionManager(ctx, coderConfig.tmux, {
             onLog: (message) => ctx.client.app.log({
@@ -121,10 +124,10 @@ export async function createCoderPlugin(ctx) {
         });
     });
     // Create hooks that need backgroundManager for task reference injection during compaction
-    const cadenceHooks = createCadenceHooks(ctx, coderConfig, backgroundManager, dbReader);
+    const cadenceHooks = createCadenceHooks(ctx, coderConfig, backgroundManager, dbReader, lastUserMessages);
     // Session memory hooks handle checkpointing and compaction for non-Cadence sessions
     // Orchestration (deciding which module handles which session) happens below in the hooks
-    const sessionMemoryHooks = createSessionMemoryHooks(ctx, coderConfig, backgroundManager);
+    const sessionMemoryHooks = createSessionMemoryHooks(ctx, coderConfig, backgroundManager, dbReader);
     const configHandler = createConfigHandler(coderConfig);
     // Create plugin tools using the @opencode-ai/plugin tool helper
     const tools = createTools(backgroundManager, dbReader);
@@ -187,15 +190,25 @@ export async function createCoderPlugin(ctx) {
             }
             // Orchestrate: route to appropriate module based on session type
             const sessionId = extractSessionIdFromEvent(input);
-            if (sessionId && cadenceHooks.isActiveCadenceSession(sessionId)) {
-                await cadenceHooks.onEvent(input);
-            }
-            else if (sessionId) {
-                // Non-Cadence sessions - handle session.compacted for checkpointing
-                await sessionMemoryHooks.onEvent(input);
+            if (sessionId) {
+                // Try lazy restore from KV if not in memory (survives plugin restarts)
+                if (!cadenceHooks.isActiveCadenceSession(sessionId)) {
+                    await cadenceHooks.tryRestoreFromKV(sessionId);
+                }
+                if (cadenceHooks.isActiveCadenceSession(sessionId)) {
+                    await cadenceHooks.onEvent(input);
+                }
+                else {
+                    // Non-Cadence sessions - handle session.compacted for checkpointing
+                    await sessionMemoryHooks.onEvent(input);
+                }
             }
         },
         'experimental.session.compacting': async (input, output) => {
+            // Try lazy restore from KV if not in memory (survives plugin restarts)
+            if (!cadenceHooks.isActiveCadenceSession(input.sessionID)) {
+                await cadenceHooks.tryRestoreFromKV(input.sessionID);
+            }
             // Orchestrate: route to appropriate module based on session type
             if (cadenceHooks.isActiveCadenceSession(input.sessionID)) {
                 await cadenceHooks.onCompacting(input, output);
@@ -265,6 +278,15 @@ function createConfigHandler(coderConfig) {
                 },
             };
         }
+        // Compaction config: increase reserved token buffer to accommodate our enriched
+        // compaction prompts (planning state, image descriptions, tool summaries, diagnostics).
+        // Default OpenCode reserved buffer is too small for the context we inject.
+        const existingCompaction = (config.compaction ?? {});
+        const existingReserved = existingCompaction.reserved;
+        config.compaction = {
+            ...existingCompaction,
+            reserved: typeof existingReserved === 'number' ? existingReserved : 40_000,
+        };
         config.command = {
             ...config.command,
             ...commands,