opencode-lcm 0.13.4 → 0.13.5

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.13.5] - 2026-04-11
+
+### Fixed
+- Restored schema-v2 compatibility for persisted stores after the PR #6 merge
+- Removed the unfinished `llm-cli` summary configuration surface before shipping it
+- Restored Biome-clean formatting so the full cross-platform CI matrix passes again
+
 ## [0.13.4] - 2026-04-09
 
 ### Fixed

package/dist/constants.d.ts

@@ -5,7 +5,7 @@
 export declare const SUMMARY_LEAF_MESSAGES = 6;
 export declare const SUMMARY_BRANCH_FACTOR = 3;
 export declare const SUMMARY_NODE_CHAR_LIMIT = 260;
-export declare const STORE_SCHEMA_VERSION = 1;
+export declare const STORE_SCHEMA_VERSION = 2;
 export declare const EXPAND_MESSAGE_LIMIT = 6;
 export declare const AUTOMATIC_RETRIEVAL_QUERY_TOKENS = 8;
 export declare const AUTOMATIC_RETRIEVAL_RECENT_MESSAGES = 3;

package/dist/constants.js

@@ -7,7 +7,7 @@ export const SUMMARY_LEAF_MESSAGES = 6;
 export const SUMMARY_BRANCH_FACTOR = 3;
 export const SUMMARY_NODE_CHAR_LIMIT = 260;
 // Store schema
-export const STORE_SCHEMA_VERSION = 1;
+export const STORE_SCHEMA_VERSION = 2;
 // Message retrieval limits
 export const EXPAND_MESSAGE_LIMIT = 6;
 // Automatic retrieval configuration

package/dist/options.d.ts

@@ -1,3 +1,4 @@
-import type { OpencodeLcmOptions } from './types.js';
+import type { OpencodeLcmOptions, SummaryV2Options } from './types.js';
+export declare const DEFAULT_SUMMARY_V2: SummaryV2Options;
 export declare const DEFAULT_OPTIONS: OpencodeLcmOptions;
 export declare function resolveOptions(raw: unknown): OpencodeLcmOptions;

package/dist/options.js

@@ -36,6 +36,10 @@ const DEFAULT_AUTOMATIC_RETRIEVAL = {
         stopOnFirstScopeWithHits: false,
     },
 };
+export const DEFAULT_SUMMARY_V2 = {
+    strategy: 'deterministic-v2',
+    perMessageBudget: 110,
+};
 export const DEFAULT_OPTIONS = {
     interop: DEFAULT_INTEROP,
     scopeDefaults: DEFAULT_SCOPE_DEFAULTS,
@@ -60,6 +64,7 @@ export const DEFAULT_OPTIONS = {
         'zip-metadata',
     ],
     previewBytePeek: 16,
+    summaryV2: DEFAULT_SUMMARY_V2,
 };
 function asRecord(value) {
     if (!value || typeof value !== 'object' || Array.isArray(value))
@@ -184,6 +189,16 @@ function asAutomaticRetrievalStopOptions(value, fallback) {
         stopOnFirstScopeWithHits: asBoolean(record?.stopOnFirstScopeWithHits, fallback.stopOnFirstScopeWithHits),
     };
 }
+function asSummaryStrategy(value, fallback) {
+    return value === 'deterministic-v1' || value === 'deterministic-v2' ? value : fallback;
+}
+function asSummaryV2Options(value, fallback) {
+    const record = asRecord(value);
+    return {
+        strategy: asSummaryStrategy(record?.strategy, fallback.strategy),
+        perMessageBudget: asNumber(record?.perMessageBudget, fallback.perMessageBudget),
+    };
+}
 export function resolveOptions(raw) {
     const options = asRecord(raw);
     const interop = asRecord(options?.interop);
@@ -213,5 +228,6 @@ export function resolveOptions(raw) {
         artifactViewChars: asNumber(options?.artifactViewChars, DEFAULT_OPTIONS.artifactViewChars),
         binaryPreviewProviders: asStringArray(options?.binaryPreviewProviders, DEFAULT_OPTIONS.binaryPreviewProviders),
         previewBytePeek: asNumber(options?.previewBytePeek, DEFAULT_OPTIONS.previewBytePeek),
+        summaryV2: asSummaryV2Options(options?.summaryV2, DEFAULT_SUMMARY_V2),
     };
 }

package/dist/store-snapshot.d.ts

@@ -1,4 +1,5 @@
 import type { SqlDatabaseLike } from './store-types.js';
+import type { SummaryStrategyName } from './types.js';
 export type SnapshotScope = 'session' | 'root' | 'worktree' | 'all';
 export type SnapshotWorktreeMode = 'auto' | 'preserve' | 'current';
 export type SessionRow = {
@@ -38,6 +39,7 @@ export type SummaryNodeRow = {
     end_index: number;
     message_ids_json: string;
     summary_text: string;
+    strategy: SummaryStrategyName;
     created_at: number;
 };
 export type SummaryEdgeRow = {

package/dist/store-snapshot.js

@@ -81,8 +81,8 @@ export async function importStoreSnapshot(bindings, input) {
         const insertBlob = db.prepare(`INSERT OR REPLACE INTO artifact_blobs (content_hash, content_text, char_count, created_at) VALUES (?, ?, ?, ?)`);
         const insertArtifact = db.prepare(`INSERT OR REPLACE INTO artifacts (artifact_id, session_id, message_id, part_id, artifact_kind, field_name, preview_text, content_text, content_hash, metadata_json, char_count, created_at)
        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
-        const insertNode = db.prepare(`INSERT OR REPLACE INTO summary_nodes (node_id, session_id, level, node_kind, start_index, end_index, message_ids_json, summary_text, created_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+        const insertNode = db.prepare(`INSERT OR REPLACE INTO summary_nodes (node_id, session_id, level, node_kind, start_index, end_index, message_ids_json, summary_text, strategy, created_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
         const insertEdge = db.prepare(`INSERT OR REPLACE INTO summary_edges (session_id, parent_id, child_id, child_position) VALUES (?, ?, ?, ?)`);
         const insertState = db.prepare(`INSERT OR REPLACE INTO summary_state (session_id, archived_count, latest_message_created, archived_signature, root_node_ids_json, updated_at)
        VALUES (?, ?, ?, ?, ?, ?)`);
@@ -101,7 +101,7 @@ export async function importStoreSnapshot(bindings, input) {
             insertArtifact.run(row.artifact_id, row.session_id, row.message_id, row.part_id, row.artifact_kind, row.field_name, row.preview_text, row.content_text, row.content_hash, row.metadata_json, row.char_count, row.created_at);
         }
         for (const row of snapshot.summary_nodes) {
-            insertNode.run(row.node_id, row.session_id, row.level, row.node_kind, row.start_index, row.end_index, row.message_ids_json, row.summary_text, row.created_at);
+            insertNode.run(row.node_id, row.session_id, row.level, row.node_kind, row.start_index, row.end_index, row.message_ids_json, row.summary_text, row.strategy, row.created_at);
         }
         for (const row of snapshot.summary_edges)
             insertEdge.run(row.session_id, row.parent_id, row.child_id, row.child_position);
@@ -232,6 +232,7 @@ function parseSummaryNodeRow(value) {
         end_index: expectNumber(row.end_index, 'summary_nodes[].end_index'),
         message_ids_json: expectString(row.message_ids_json, 'summary_nodes[].message_ids_json'),
         summary_text: expectString(row.summary_text, 'summary_nodes[].summary_text'),
+        strategy: expectString(row.strategy ?? 'deterministic-v1', 'summary_nodes[].strategy'),
         created_at: expectNumber(row.created_at, 'summary_nodes[].created_at'),
     };
 }

package/dist/store.d.ts

@@ -264,6 +264,8 @@ export declare class SqliteLcmStore {
     private compactMessageInPlace;
     private shouldIgnoreTool;
     private summarizeMessages;
+    private summarizeMessagesDeterministicV1;
+    private summarizeMessagesDeterministicV2;
     private listTools;
     private buildArchivedSignature;
     private getArchivedMessages;
@@ -294,6 +296,7 @@ export declare class SqliteLcmStore {
     private refreshSearchIndexesSync;
     private ensureSessionColumnsSync;
     private ensureSummaryStateColumnsSync;
+    private ensureSummaryNodeColumnsSync;
     private ensureArtifactColumnsSync;
     private backfillArtifactBlobsSync;
     private refreshAllLineageSync;

package/dist/store.js

@@ -170,6 +170,8 @@ function getValidMessageInfo(info) {
     return info;
 }
 function filterValidConversationMessages(messages, context) {
+    if (context?.operation === 'transformMessages')
+        return messages;
     const valid = messages.filter((message) => Boolean(getValidMessageInfo(message?.info)));
     const dropped = messages.length - valid.length;
     if (dropped > 0 && context) {
@@ -204,16 +206,18 @@ function getDeferredPartUpdateKey(event) {
         return undefined;
     return `${event.properties.part.sessionID}:${event.properties.part.messageID}:${event.properties.part.id}`;
 }
+function messageCreatedAt(message) {
+    const created = message?.info?.time?.created;
+    return typeof created === 'number' && Number.isFinite(created) ? created : 0;
+}
+function messageParts(message) {
+    return Array.isArray(message?.parts) ? message.parts : [];
+}
+function signatureString(value, fallback = '') {
+    return typeof value === 'string' ? value : fallback;
+}
 function compareMessages(a, b) {
-    const aInfo = getValidMessageInfo(a.info);
-    const bInfo = getValidMessageInfo(b.info);
-    if (!aInfo && !bInfo)
-        return 0;
-    if (!aInfo)
-        return 1;
-    if (!bInfo)
-        return -1;
-    return aInfo.time.created - bInfo.time.created || aInfo.id.localeCompare(bInfo.id);
+    return messageCreatedAt(a) - messageCreatedAt(b);
 }
 function emptySession(sessionID) {
     return {
@@ -289,22 +293,24 @@ function isSyntheticLcmTextPart(part, markers) {
 }
 function guessMessageText(message, ignoreToolPrefixes) {
     const segments = [];
-    for (const part of message.parts) {
+    for (const part of messageParts(message)) {
         switch (part.type) {
             case 'text': {
                 if (isSyntheticLcmTextPart(part, ['archive-summary', 'retrieved-context', 'archived-part']))
                     break;
-                if (part.text.startsWith('[Archived by opencode-lcm:'))
+                const text = typeof part.text === 'string' ? part.text : '';
+                if (text.startsWith('[Archived by opencode-lcm:'))
                     break;
-                const sanitized = sanitizeAutomaticRetrievalSourceText(part.text);
+                const sanitized = sanitizeAutomaticRetrievalSourceText(text);
                 if (sanitized)
                     segments.push(sanitized);
                 break;
             }
             case 'reasoning': {
-                if (part.text.startsWith('[Archived by opencode-lcm:'))
+                const text = typeof part.text === 'string' ? part.text : '';
+                if (text.startsWith('[Archived by opencode-lcm:'))
                     break;
-                const sanitized = sanitizeAutomaticRetrievalSourceText(part.text);
+                const sanitized = sanitizeAutomaticRetrievalSourceText(text);
                 if (sanitized)
                     segments.push(sanitized);
                 break;
@@ -317,15 +323,16 @@ function guessMessageText(message, ignoreToolPrefixes) {
                 break;
             }
             case 'tool': {
-                if (ignoreToolPrefixes.some((prefix) => part.tool.startsWith(prefix)))
+                const toolName = typeof part.tool === 'string' ? part.tool : '';
+                if (ignoreToolPrefixes.some((prefix) => toolName.startsWith(prefix)))
                     break;
                 const state = part.state;
                 if (state.status === 'completed')
-                    segments.push(`${part.tool}: ${state.output}`);
+                    segments.push(`${toolName}: ${state.output}`);
                 if (state.status === 'error')
-                    segments.push(`${part.tool}: ${state.error}`);
+                    segments.push(`${toolName}: ${state.error}`);
                 if (state.status === 'pending' || state.status === 'running') {
-                    segments.push(`${part.tool}: ${JSON.stringify(state.input)}`);
+                    segments.push(`${toolName}: ${JSON.stringify(state.input)}`);
                 }
                 if (state.status === 'completed' && state.attachments && state.attachments.length > 0) {
                     const attachmentNames = state.attachments
@@ -333,7 +340,7 @@ function guessMessageText(message, ignoreToolPrefixes) {
                         .filter(Boolean)
                         .slice(0, 4);
                     if (attachmentNames.length > 0)
-                        segments.push(`${part.tool} attachments: ${attachmentNames.join(', ')}`);
+                        segments.push(`${toolName} attachments: ${attachmentNames.join(', ')}`);
                 }
                 break;
             }
@@ -775,6 +782,7 @@ export class SqliteLcmStore {
         end_index INTEGER NOT NULL,
         message_ids_json TEXT NOT NULL,
         summary_text TEXT NOT NULL,
+        strategy TEXT NOT NULL DEFAULT 'deterministic-v1',
         created_at INTEGER NOT NULL,
         FOREIGN KEY (session_id) REFERENCES sessions(session_id) ON DELETE CASCADE
       );
@@ -830,6 +838,7 @@ export class SqliteLcmStore {
     `);
             this.ensureSessionColumnsSync();
             this.ensureSummaryStateColumnsSync();
+            this.ensureSummaryNodeColumnsSync();
             this.ensureArtifactColumnsSync();
             logStartupPhase('open-db:create-indexes');
             db.exec('CREATE INDEX IF NOT EXISTS idx_artifacts_content_hash ON artifacts(content_hash)');
@@ -1262,7 +1271,7 @@ export class SqliteLcmStore {
                 issues.push('unexpected-summary-edges');
             return issues.length > 0 ? { sessionID: session.sessionID, issues } : undefined;
         }
-        const latestMessageCreated = archived.at(-1)?.info?.time?.created ?? 0;
+        const latestMessageCreated = messageCreatedAt(archived.at(-1));
         const archivedSignature = this.buildArchivedSignature(archived);
         const rootIDs = state ? parseJson(state.root_node_ids_json) : [];
         const roots = rootIDs
@@ -1373,7 +1382,7 @@ export class SqliteLcmStore {
             case 'message.updated': {
                 const existing = session.messages.find((message) => message.info.id === payload.properties.info.id);
                 if (existing) {
-                    return this.isMessageArchivedSync(session.sessionID, existing.info.id, existing.info?.time?.created ?? 0);
+                    return this.isMessageArchivedSync(session.sessionID, existing.info.id, messageCreatedAt(existing));
                 }
                 return this.readMessageCountSync(session.sessionID) >= this.options.freshTailMessages;
             }
@@ -1387,13 +1396,13 @@ export class SqliteLcmStore {
                 const message = session.messages.find((entry) => entry.info.id === payload.properties.part.messageID);
                 if (!message)
                     return false;
-                return this.isMessageArchivedSync(session.sessionID, message.info.id, message.info?.time?.created ?? 0);
+                return this.isMessageArchivedSync(session.sessionID, message.info.id, messageCreatedAt(message));
             }
             case 'message.part.removed': {
                 const message = session.messages.find((entry) => entry.info.id === payload.properties.messageID);
                 if (!message)
                     return false;
-                return this.isMessageArchivedSync(session.sessionID, message.info.id, message.info?.time?.created ?? 0);
+                return this.isMessageArchivedSync(session.sessionID, message.info.id, messageCreatedAt(message));
             }
             default:
                 return false;
@@ -2711,6 +2720,12 @@ export class SqliteLcmStore {
         return this.options.interop.ignoreToolPrefixes.some((prefix) => toolName.startsWith(prefix));
     }
     summarizeMessages(messages, limit = SUMMARY_NODE_CHAR_LIMIT) {
+        const strategy = this.options.summaryV2?.strategy ?? 'deterministic-v1';
+        return strategy === 'deterministic-v2'
+            ? this.summarizeMessagesDeterministicV2(messages, limit)
+            : this.summarizeMessagesDeterministicV1(messages, limit);
+    }
+    summarizeMessagesDeterministicV1(messages, limit = SUMMARY_NODE_CHAR_LIMIT) {
         const goals = messages
             .filter((message) => message.info.role === 'user')
             .map((message) => guessMessageText(message, this.options.interop.ignoreToolPrefixes))
@@ -2735,6 +2750,55 @@ export class SqliteLcmStore {
             return truncate(`Archived messages ${messages.length}`, limit);
         return truncate(segments.join(' || '), limit);
     }
+    summarizeMessagesDeterministicV2(messages, limit = SUMMARY_NODE_CHAR_LIMIT) {
+        const perMsgBudget = this.options.summaryV2?.perMessageBudget ?? 110;
+        const ignoreToolPrefixes = this.options.interop.ignoreToolPrefixes;
+        const userTexts = messages
+            .filter((message) => message.info.role === 'user')
+            .map((message) => guessMessageText(message, ignoreToolPrefixes))
+            .filter(Boolean);
+        const assistantTexts = messages
+            .filter((message) => message.info.role === 'assistant')
+            .map((message) => guessMessageText(message, ignoreToolPrefixes))
+            .filter(Boolean);
+        const allFiles = [...new Set(messages.flatMap(listFiles))];
+        const allTools = [...new Set(this.listTools(messages))];
+        const hasErrors = messages.some((message) => message.parts.some((part) => (part.type === 'tool' && 'state' in part && part.state?.status === 'error') ||
+            (part.type === 'text' &&
+                /\b(?:error|exception|fail(?:ed|ure)?)\b/i.test(part.text ?? ''))));
+        const segments = [];
+        if (userTexts.length > 0) {
+            const first = truncate(userTexts[0], perMsgBudget);
+            if (userTexts.length > 1) {
+                const last = truncate(userTexts[userTexts.length - 1], perMsgBudget);
+                segments.push(`Goals: ${first} → ${last}`);
+            }
+            else {
+                segments.push(`Goals: ${first}`);
+            }
+        }
+        if (assistantTexts.length > 0) {
+            const recent = assistantTexts
+                .slice(-2)
+                .map((text) => truncate(text, perMsgBudget))
+                .join(' | ');
+            segments.push(`Work: ${recent}`);
+        }
+        if (allFiles.length > 0) {
+            const shown = allFiles.slice(0, 6).join(', ');
+            segments.push(allFiles.length > 6 ? `Files[${allFiles.length}]: ${shown}` : `Files: ${shown}`);
+        }
+        if (allTools.length > 0) {
+            const shown = allTools.slice(0, 6).join(', ');
+            segments.push(allTools.length > 6 ? `Tools[${allTools.length}]: ${shown}` : `Tools: ${shown}`);
+        }
+        if (hasErrors)
+            segments.push('⚠err');
+        segments.push(`${messages.length}msg(u:${userTexts.length}/a:${assistantTexts.length})`);
+        if (segments.length === 0)
+            return truncate(`Archived ${messages.length} messages`, limit);
+        return truncate(segments.join(' || '), limit);
+    }
     listTools(messages) {
         const tools = [];
         for (const message of messages) {
@@ -2751,13 +2815,13 @@ export class SqliteLcmStore {
     buildArchivedSignature(messages) {
         const hash = createHash('sha256');
         for (const message of messages) {
-            hash.update(message.info.id);
-            hash.update(message.info.role);
-            hash.update(String(message.info?.time?.created ?? 0));
-            hash.update(guessMessageText(message, this.options.interop.ignoreToolPrefixes));
+            hash.update(signatureString(message.info?.id, 'unknown-message'));
+            hash.update(signatureString(message.info?.role, 'unknown-role'));
+            hash.update(String(messageCreatedAt(message)));
+            hash.update(String(guessMessageText(message, this.options.interop.ignoreToolPrefixes) ?? ''));
             hash.update(JSON.stringify(listFiles(message)));
             hash.update(JSON.stringify(this.listTools([message])));
-            hash.update(String(message.parts.length));
+            hash.update(String(messageParts(message).length));
         }
         return hash.digest('hex');
     }
@@ -2777,7 +2841,7 @@ export class SqliteLcmStore {
             this.clearSummaryGraphSync(sessionID);
             return [];
         }
-        const latestMessageCreated = archivedMessages.at(-1)?.info?.time?.created ?? 0;
+        const latestMessageCreated = messageCreatedAt(archivedMessages.at(-1));
         const archivedSignature = this.buildArchivedSignature(archivedMessages);
         const state = safeQueryOne(this.getDb().prepare('SELECT * FROM summary_state WHERE session_id = ?'), [sessionID], 'ensureSummaryGraphSync');
         if (state &&
@@ -2824,6 +2888,8 @@ export class SqliteLcmStore {
             const expectedSummaryText = this.summarizeMessages(archivedMessages.slice(node.startIndex, node.endIndex + 1));
             if (node.summaryText !== expectedSummaryText)
                 return false;
+            if (node.strategy !== (this.options.summaryV2?.strategy ?? 'deterministic-v1'))
+                return false;
             const children = this.readSummaryChildrenSync(node.nodeID);
             if (node.nodeKind === 'leaf') {
                 return (children.length === 0 && node.endIndex - node.startIndex + 1 <= SUMMARY_LEAF_MESSAGES);
@@ -2858,6 +2924,7 @@ export class SqliteLcmStore {
     }
     rebuildSummaryGraphSync(sessionID, archivedMessages, archivedSignature) {
         const now = Date.now();
+        const summaryStrategy = this.options.summaryV2?.strategy ?? 'deterministic-v1';
         let level = 0;
         const nodes = [];
         const edges = [];
@@ -2870,6 +2937,7 @@ export class SqliteLcmStore {
             endIndex: input.endIndex,
             messageIDs: input.messageIDs,
             summaryText: input.summaryText,
+            strategy: summaryStrategy,
             createdAt: now,
         });
         let currentLevel = [];
@@ -2922,13 +2990,13 @@ export class SqliteLcmStore {
         withTransaction(db, 'rebuildSummaryGraph', () => {
             this.clearSummaryGraphSync(sessionID);
             const insertNode = db.prepare(`INSERT INTO summary_nodes
-         (node_id, session_id, level, node_kind, start_index, end_index, message_ids_json, summary_text, created_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+         (node_id, session_id, level, node_kind, start_index, end_index, message_ids_json, summary_text, strategy, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
             const insertEdge = db.prepare(`INSERT INTO summary_edges (session_id, parent_id, child_id, child_position)
          VALUES (?, ?, ?, ?)`);
             const insertSummaryFts = db.prepare('INSERT INTO summary_fts (session_id, node_id, level, created_at, content) VALUES (?, ?, ?, ?, ?)');
             for (const node of nodes) {
-                insertNode.run(node.nodeID, node.sessionID, node.level, node.nodeKind, node.startIndex, node.endIndex, JSON.stringify(node.messageIDs), node.summaryText, node.createdAt);
+                insertNode.run(node.nodeID, node.sessionID, node.level, node.nodeKind, node.startIndex, node.endIndex, JSON.stringify(node.messageIDs), node.summaryText, node.strategy, node.createdAt);
                 insertSummaryFts.run(node.sessionID, node.nodeID, String(node.level), String(node.createdAt), node.summaryText);
             }
             for (const edge of edges) {
@@ -2941,7 +3009,7 @@ export class SqliteLcmStore {
             latest_message_created = excluded.latest_message_created,
             archived_signature = excluded.archived_signature,
             root_node_ids_json = excluded.root_node_ids_json,
-            updated_at = excluded.updated_at`).run(sessionID, archivedMessages.length, archivedMessages.at(-1)?.info?.time?.created ?? 0, archivedSignature, JSON.stringify(roots.map((node) => node.nodeID)), now);
+            updated_at = excluded.updated_at`).run(sessionID, archivedMessages.length, messageCreatedAt(archivedMessages.at(-1)), archivedSignature, JSON.stringify(roots.map((node) => node.nodeID)), now);
         });
         return roots;
     }
@@ -2958,6 +3026,7 @@ export class SqliteLcmStore {
             endIndex: row.end_index,
             messageIDs: parseJson(row.message_ids_json),
             summaryText: row.summary_text,
+            strategy: row.strategy,
             createdAt: row.created_at,
         };
     }
@@ -3238,6 +3307,14 @@ export class SqliteLcmStore {
             return;
         db.exec("ALTER TABLE summary_state ADD COLUMN archived_signature TEXT NOT NULL DEFAULT ''");
     }
+    ensureSummaryNodeColumnsSync() {
+        const db = this.getDb();
+        const columns = db.prepare('PRAGMA table_info(summary_nodes)').all();
+        const names = new Set(columns.map((column) => column.name));
+        if (names.has('strategy'))
+            return;
+        db.exec("ALTER TABLE summary_nodes ADD COLUMN strategy TEXT NOT NULL DEFAULT 'deterministic-v1'");
+    }
     ensureArtifactColumnsSync() {
         const db = this.getDb();
         const columns = db.prepare('PRAGMA table_info(artifacts)').all();

package/dist/types.d.ts

@@ -45,6 +45,11 @@ export type AutomaticRetrievalOptions = {
     scopeBudgets: AutomaticRetrievalScopeBudgets;
     stop: AutomaticRetrievalStopOptions;
 };
+export type SummaryStrategyName = 'deterministic-v1' | 'deterministic-v2';
+export type SummaryV2Options = {
+    strategy: SummaryStrategyName;
+    perMessageBudget: number;
+};
 export type OpencodeLcmOptions = {
     interop: InteropOptions;
     scopeDefaults: ScopeDefaults;
@@ -64,6 +69,7 @@ export type OpencodeLcmOptions = {
     artifactViewChars: number;
     binaryPreviewProviders: string[];
     previewBytePeek: number;
+    summaryV2: SummaryV2Options;
 };
 export type CapturedEvent = {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-lcm",
-  "version": "0.13.4",
+  "version": "0.13.5",
   "description": "Long-memory plugin for OpenCode with context-mode interop",
   "type": "module",
   "main": "./dist/index.js",

package/src/constants.ts

@@ -9,7 +9,7 @@ export const SUMMARY_BRANCH_FACTOR = 3;
 export const SUMMARY_NODE_CHAR_LIMIT = 260;
 
 // Store schema
-export const STORE_SCHEMA_VERSION = 1;
+export const STORE_SCHEMA_VERSION = 2;
 
 // Message retrieval limits
 export const EXPAND_MESSAGE_LIMIT = 6;

package/src/options.ts

@@ -9,6 +9,8 @@ import type {
   ScopeDefaults,
   ScopeName,
   ScopeProfile,
+  SummaryStrategyName,
+  SummaryV2Options,
 } from './types.js';
 
 const DEFAULT_INTEROP: InteropOptions = {
@@ -54,6 +56,11 @@ const DEFAULT_AUTOMATIC_RETRIEVAL: AutomaticRetrievalOptions = {
   },
 };
 
+export const DEFAULT_SUMMARY_V2: SummaryV2Options = {
+  strategy: 'deterministic-v2',
+  perMessageBudget: 110,
+};
+
 export const DEFAULT_OPTIONS: OpencodeLcmOptions = {
   interop: DEFAULT_INTEROP,
   scopeDefaults: DEFAULT_SCOPE_DEFAULTS,
@@ -78,6 +85,7 @@ export const DEFAULT_OPTIONS: OpencodeLcmOptions = {
     'zip-metadata',
   ],
   previewBytePeek: 16,
+  summaryV2: DEFAULT_SUMMARY_V2,
 };
 
 function asRecord(value: unknown): Record<string, unknown> | undefined {
@@ -238,6 +246,18 @@ function asAutomaticRetrievalStopOptions(
   };
 }
 
+function asSummaryStrategy(value: unknown, fallback: SummaryStrategyName): SummaryStrategyName {
+  return value === 'deterministic-v1' || value === 'deterministic-v2' ? value : fallback;
+}
+
+function asSummaryV2Options(value: unknown, fallback: SummaryV2Options): SummaryV2Options {
+  const record = asRecord(value);
+  return {
+    strategy: asSummaryStrategy(record?.strategy, fallback.strategy),
+    perMessageBudget: asNumber(record?.perMessageBudget, fallback.perMessageBudget),
+  };
+}
+
 export function resolveOptions(raw: unknown): OpencodeLcmOptions {
   const options = asRecord(raw);
   const interop = asRecord(options?.interop);
@@ -293,5 +313,6 @@ export function resolveOptions(raw: unknown): OpencodeLcmOptions {
       DEFAULT_OPTIONS.binaryPreviewProviders,
     ),
     previewBytePeek: asNumber(options?.previewBytePeek, DEFAULT_OPTIONS.previewBytePeek),
+    summaryV2: asSummaryV2Options(options?.summaryV2, DEFAULT_SUMMARY_V2),
   };
 }

package/src/store-snapshot.ts

@@ -3,6 +3,7 @@ import path from 'node:path';
 
 import { withTransaction } from './sql-utils.js';
 import type { SqlDatabaseLike } from './store-types.js';
+import type { SummaryStrategyName } from './types.js';
 import { resolveWorkspacePath } from './workspace-path.js';
 import { normalizeWorktreeKey } from './worktree-key.js';
 
@@ -50,6 +51,7 @@ export type SummaryNodeRow = {
   end_index: number;
   message_ids_json: string;
   summary_text: string;
+  strategy: SummaryStrategyName;
   created_at: number;
 };
 
@@ -254,8 +256,8 @@ export async function importStoreSnapshot(
        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
     );
     const insertNode = db.prepare(
-      `INSERT OR REPLACE INTO summary_nodes (node_id, session_id, level, node_kind, start_index, end_index, message_ids_json, summary_text, created_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      `INSERT OR REPLACE INTO summary_nodes (node_id, session_id, level, node_kind, start_index, end_index, message_ids_json, summary_text, strategy, created_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
     );
     const insertEdge = db.prepare(
       `INSERT OR REPLACE INTO summary_edges (session_id, parent_id, child_id, child_position) VALUES (?, ?, ?, ?)`,
@@ -315,6 +317,7 @@ export async function importStoreSnapshot(
         row.end_index,
         row.message_ids_json,
         row.summary_text,
+        row.strategy,
         row.created_at,
       );
     }
@@ -464,6 +467,10 @@ function parseSummaryNodeRow(value: unknown): SummaryNodeRow {
     end_index: expectNumber(row.end_index, 'summary_nodes[].end_index'),
     message_ids_json: expectString(row.message_ids_json, 'summary_nodes[].message_ids_json'),
     summary_text: expectString(row.summary_text, 'summary_nodes[].summary_text'),
+    strategy: expectString(
+      row.strategy ?? 'deterministic-v1',
+      'summary_nodes[].strategy',
+    ) as SummaryStrategyName,
     created_at: expectNumber(row.created_at, 'summary_nodes[].created_at'),
   };
 }

package/src/store.ts

@@ -72,6 +72,7 @@ import type {
   ScopeName,
   SearchResult,
   StoreStats,
+  SummaryStrategyName,
 } from './types.js';
 import {
   asRecord,
@@ -101,6 +102,7 @@ type SummaryNodeData = {
   endIndex: number;
   messageIDs: string[];
   summaryText: string;
+  strategy: SummaryStrategyName;
   createdAt: number;
 };
 
@@ -379,6 +381,7 @@ function filterValidConversationMessages(
   messages: ConversationMessage[],
   context?: MessageValidationContext,
 ): ConversationMessage[] {
+  if (context?.operation === 'transformMessages') return messages;
   const valid = messages.filter((message) => Boolean(getValidMessageInfo(message?.info)));
   const dropped = messages.length - valid.length;
   if (dropped > 0 && context) {
@@ -416,14 +419,21 @@ function getDeferredPartUpdateKey(event: Event): string | undefined {
   return `${event.properties.part.sessionID}:${event.properties.part.messageID}:${event.properties.part.id}`;
 }
 
-function compareMessages(a: ConversationMessage, b: ConversationMessage): number {
-  const aInfo = getValidMessageInfo(a.info);
-  const bInfo = getValidMessageInfo(b.info);
-  if (!aInfo && !bInfo) return 0;
-  if (!aInfo) return 1;
-  if (!bInfo) return -1;
+function messageCreatedAt(message: ConversationMessage | undefined): number {
+  const created = message?.info?.time?.created;
+  return typeof created === 'number' && Number.isFinite(created) ? created : 0;
+}
+
+function messageParts(message: ConversationMessage | undefined): Part[] {
+  return Array.isArray(message?.parts) ? message.parts : [];
+}
 
-  return aInfo.time.created - bInfo.time.created || aInfo.id.localeCompare(bInfo.id);
+function signatureString(value: unknown, fallback = ''): string {
+  return typeof value === 'string' ? value : fallback;
+}
+
+function compareMessages(a: ConversationMessage, b: ConversationMessage): number {
+  return messageCreatedAt(a) - messageCreatedAt(b);
 }
 
 function emptySession(sessionID: string): NormalizedSession {
@@ -501,19 +511,21 @@ function isSyntheticLcmTextPart(part: Part, markers?: string[]): boolean {
 function guessMessageText(message: ConversationMessage, ignoreToolPrefixes: string[]): string {
   const segments: string[] = [];
 
-  for (const part of message.parts) {
+  for (const part of messageParts(message)) {
     switch (part.type) {
       case 'text': {
         if (isSyntheticLcmTextPart(part, ['archive-summary', 'retrieved-context', 'archived-part']))
           break;
-        if (part.text.startsWith('[Archived by opencode-lcm:')) break;
-        const sanitized = sanitizeAutomaticRetrievalSourceText(part.text);
+        const text = typeof part.text === 'string' ? part.text : '';
+        if (text.startsWith('[Archived by opencode-lcm:')) break;
+        const sanitized = sanitizeAutomaticRetrievalSourceText(text);
         if (sanitized) segments.push(sanitized);
         break;
       }
       case 'reasoning': {
-        if (part.text.startsWith('[Archived by opencode-lcm:')) break;
-        const sanitized = sanitizeAutomaticRetrievalSourceText(part.text);
+        const text = typeof part.text === 'string' ? part.text : '';
+        if (text.startsWith('[Archived by opencode-lcm:')) break;
+        const sanitized = sanitizeAutomaticRetrievalSourceText(text);
         if (sanitized) segments.push(sanitized);
         break;
       }
@@ -525,12 +537,13 @@ function guessMessageText(message: ConversationMessage, ignoreToolPrefixes: stri
         break;
       }
       case 'tool': {
-        if (ignoreToolPrefixes.some((prefix) => part.tool.startsWith(prefix))) break;
+        const toolName = typeof part.tool === 'string' ? part.tool : '';
+        if (ignoreToolPrefixes.some((prefix) => toolName.startsWith(prefix))) break;
         const state = part.state;
-        if (state.status === 'completed') segments.push(`${part.tool}: ${state.output}`);
-        if (state.status === 'error') segments.push(`${part.tool}: ${state.error}`);
+        if (state.status === 'completed') segments.push(`${toolName}: ${state.output}`);
+        if (state.status === 'error') segments.push(`${toolName}: ${state.error}`);
         if (state.status === 'pending' || state.status === 'running') {
-          segments.push(`${part.tool}: ${JSON.stringify(state.input)}`);
+          segments.push(`${toolName}: ${JSON.stringify(state.input)}`);
         }
         if (state.status === 'completed' && state.attachments && state.attachments.length > 0) {
           const attachmentNames = state.attachments
@@ -538,7 +551,7 @@ function guessMessageText(message: ConversationMessage, ignoreToolPrefixes: stri
             .filter(Boolean)
             .slice(0, 4);
           if (attachmentNames.length > 0)
-            segments.push(`${part.tool} attachments: ${attachmentNames.join(', ')}`);
+            segments.push(`${toolName} attachments: ${attachmentNames.join(', ')}`);
         }
         break;
       }
@@ -1065,6 +1078,7 @@ export class SqliteLcmStore {
         end_index INTEGER NOT NULL,
         message_ids_json TEXT NOT NULL,
         summary_text TEXT NOT NULL,
+        strategy TEXT NOT NULL DEFAULT 'deterministic-v1',
         created_at INTEGER NOT NULL,
         FOREIGN KEY (session_id) REFERENCES sessions(session_id) ON DELETE CASCADE
       );
@@ -1121,6 +1135,7 @@ export class SqliteLcmStore {
 
       this.ensureSessionColumnsSync();
       this.ensureSummaryStateColumnsSync();
+      this.ensureSummaryNodeColumnsSync();
       this.ensureArtifactColumnsSync();
       logStartupPhase('open-db:create-indexes');
       db.exec('CREATE INDEX IF NOT EXISTS idx_artifacts_content_hash ON artifacts(content_hash)');
@@ -1710,7 +1725,7 @@ export class SqliteLcmStore {
       return issues.length > 0 ? { sessionID: session.sessionID, issues } : undefined;
     }
 
-    const latestMessageCreated = archived.at(-1)?.info?.time?.created ?? 0;
+    const latestMessageCreated = messageCreatedAt(archived.at(-1));
     const archivedSignature = this.buildArchivedSignature(archived);
     const rootIDs = state ? parseJson<string[]>(state.root_node_ids_json) : [];
     const roots = rootIDs
@@ -1863,7 +1878,7 @@ export class SqliteLcmStore {
           return this.isMessageArchivedSync(
             session.sessionID,
             existing.info.id,
-            existing.info?.time?.created ?? 0,
+            messageCreatedAt(existing),
           );
         }
 
@@ -1888,7 +1903,7 @@ export class SqliteLcmStore {
         return this.isMessageArchivedSync(
           session.sessionID,
           message.info.id,
-          message.info?.time?.created ?? 0,
+          messageCreatedAt(message),
         );
       }
       case 'message.part.removed': {
@@ -1899,7 +1914,7 @@ export class SqliteLcmStore {
         return this.isMessageArchivedSync(
           session.sessionID,
           message.info.id,
-          message.info?.time?.created ?? 0,
+          messageCreatedAt(message),
         );
       }
       default:
@@ -3588,6 +3603,16 @@ export class SqliteLcmStore {
   private summarizeMessages(
     messages: ConversationMessage[],
     limit = SUMMARY_NODE_CHAR_LIMIT,
+  ): string {
+    const strategy = this.options.summaryV2?.strategy ?? 'deterministic-v1';
+    return strategy === 'deterministic-v2'
+      ? this.summarizeMessagesDeterministicV2(messages, limit)
+      : this.summarizeMessagesDeterministicV1(messages, limit);
+  }
+
+  private summarizeMessagesDeterministicV1(
+    messages: ConversationMessage[],
+    limit = SUMMARY_NODE_CHAR_LIMIT,
   ): string {
     const goals = messages
       .filter((message) => message.info.role === 'user')
@@ -3617,6 +3642,71 @@ export class SqliteLcmStore {
     return truncate(segments.join(' || '), limit);
   }
 
+  private summarizeMessagesDeterministicV2(
+    messages: ConversationMessage[],
+    limit = SUMMARY_NODE_CHAR_LIMIT,
+  ): string {
+    const perMsgBudget = this.options.summaryV2?.perMessageBudget ?? 110;
+    const ignoreToolPrefixes = this.options.interop.ignoreToolPrefixes;
+    const userTexts = messages
+      .filter((message) => message.info.role === 'user')
+      .map((message) => guessMessageText(message, ignoreToolPrefixes))
+      .filter(Boolean);
+    const assistantTexts = messages
+      .filter((message) => message.info.role === 'assistant')
+      .map((message) => guessMessageText(message, ignoreToolPrefixes))
+      .filter(Boolean);
+    const allFiles = [...new Set(messages.flatMap(listFiles))];
+    const allTools = [...new Set(this.listTools(messages))];
+    const hasErrors = messages.some((message) =>
+      message.parts.some(
+        (part) =>
+          (part.type === 'tool' && 'state' in part && part.state?.status === 'error') ||
+          (part.type === 'text' &&
+            /\b(?:error|exception|fail(?:ed|ure)?)\b/i.test(part.text ?? '')),
+      ),
+    );
+
+    const segments: string[] = [];
+    if (userTexts.length > 0) {
+      const first = truncate(userTexts[0], perMsgBudget);
+      if (userTexts.length > 1) {
+        const last = truncate(userTexts[userTexts.length - 1], perMsgBudget);
+        segments.push(`Goals: ${first} → ${last}`);
+      } else {
+        segments.push(`Goals: ${first}`);
+      }
+    }
+
+    if (assistantTexts.length > 0) {
+      const recent = assistantTexts
+        .slice(-2)
+        .map((text) => truncate(text, perMsgBudget))
+        .join(' | ');
+      segments.push(`Work: ${recent}`);
+    }
+
+    if (allFiles.length > 0) {
+      const shown = allFiles.slice(0, 6).join(', ');
+      segments.push(
+        allFiles.length > 6 ? `Files[${allFiles.length}]: ${shown}` : `Files: ${shown}`,
+      );
+    }
+
+    if (allTools.length > 0) {
+      const shown = allTools.slice(0, 6).join(', ');
+      segments.push(
+        allTools.length > 6 ? `Tools[${allTools.length}]: ${shown}` : `Tools: ${shown}`,
+      );
+    }
+
+    if (hasErrors) segments.push('⚠err');
+    segments.push(`${messages.length}msg(u:${userTexts.length}/a:${assistantTexts.length})`);
+
+    if (segments.length === 0) return truncate(`Archived ${messages.length} messages`, limit);
+    return truncate(segments.join(' || '), limit);
+  }
+
   private listTools(messages: ConversationMessage[]): string[] {
     const tools: string[] = [];
     for (const message of messages) {
@@ -3632,13 +3722,13 @@ export class SqliteLcmStore {
   private buildArchivedSignature(messages: ConversationMessage[]): string {
     const hash = createHash('sha256');
     for (const message of messages) {
-      hash.update(message.info.id);
-      hash.update(message.info.role);
-      hash.update(String(message.info?.time?.created ?? 0));
-      hash.update(guessMessageText(message, this.options.interop.ignoreToolPrefixes));
+      hash.update(signatureString(message.info?.id, 'unknown-message'));
+      hash.update(signatureString(message.info?.role, 'unknown-role'));
+      hash.update(String(messageCreatedAt(message)));
+      hash.update(String(guessMessageText(message, this.options.interop.ignoreToolPrefixes) ?? ''));
       hash.update(JSON.stringify(listFiles(message)));
       hash.update(JSON.stringify(this.listTools([message])));
-      hash.update(String(message.parts.length));
+      hash.update(String(messageParts(message).length));
     }
     return hash.digest('hex');
   }
@@ -3665,7 +3755,7 @@ export class SqliteLcmStore {
       return [];
     }
 
-    const latestMessageCreated = archivedMessages.at(-1)?.info?.time?.created ?? 0;
+    const latestMessageCreated = messageCreatedAt(archivedMessages.at(-1));
     const archivedSignature = this.buildArchivedSignature(archivedMessages);
     const state = safeQueryOne<SummaryStateRow>(
       this.getDb().prepare('SELECT * FROM summary_state WHERE session_id = ?'),
@@ -3729,6 +3819,7 @@ export class SqliteLcmStore {
         archivedMessages.slice(node.startIndex, node.endIndex + 1),
       );
       if (node.summaryText !== expectedSummaryText) return false;
+      if (node.strategy !== (this.options.summaryV2?.strategy ?? 'deterministic-v1')) return false;
 
       const children = this.readSummaryChildrenSync(node.nodeID);
       if (node.nodeKind === 'leaf') {
@@ -3768,6 +3859,7 @@ export class SqliteLcmStore {
     archivedSignature: string,
   ): SummaryNodeData[] {
     const now = Date.now();
+    const summaryStrategy = this.options.summaryV2?.strategy ?? 'deterministic-v1';
     let level = 0;
     const nodes: SummaryNodeData[] = [];
     const edges: Array<{
@@ -3794,6 +3886,7 @@ export class SqliteLcmStore {
       endIndex: input.endIndex,
       messageIDs: input.messageIDs,
       summaryText: input.summaryText,
+      strategy: summaryStrategy,
       createdAt: now,
     });
 
@@ -3857,8 +3950,8 @@ export class SqliteLcmStore {
 
       const insertNode = db.prepare(
         `INSERT INTO summary_nodes
-         (node_id, session_id, level, node_kind, start_index, end_index, message_ids_json, summary_text, created_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+         (node_id, session_id, level, node_kind, start_index, end_index, message_ids_json, summary_text, strategy, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
       );
       const insertEdge = db.prepare(
         `INSERT INTO summary_edges (session_id, parent_id, child_id, child_position)
@@ -3878,6 +3971,7 @@ export class SqliteLcmStore {
           node.endIndex,
           JSON.stringify(node.messageIDs),
           node.summaryText,
+          node.strategy,
           node.createdAt,
         );
         insertSummaryFts.run(
@@ -3905,7 +3999,7 @@ export class SqliteLcmStore {
       ).run(
         sessionID,
         archivedMessages.length,
-        archivedMessages.at(-1)?.info?.time?.created ?? 0,
+        messageCreatedAt(archivedMessages.at(-1)),
         archivedSignature,
         JSON.stringify(roots.map((node) => node.nodeID)),
         now,
@@ -3932,6 +4026,7 @@ export class SqliteLcmStore {
       endIndex: row.end_index,
       messageIDs: parseJson<string[]>(row.message_ids_json),
       summaryText: row.summary_text,
+      strategy: row.strategy,
       createdAt: row.created_at,
     };
   }
@@ -4370,6 +4465,17 @@ export class SqliteLcmStore {
     db.exec("ALTER TABLE summary_state ADD COLUMN archived_signature TEXT NOT NULL DEFAULT ''");
   }
 
+  private ensureSummaryNodeColumnsSync(): void {
+    const db = this.getDb();
+    const columns = db.prepare('PRAGMA table_info(summary_nodes)').all() as Array<{ name: string }>;
+    const names = new Set(columns.map((column) => column.name));
+    if (names.has('strategy')) return;
+
+    db.exec(
+      "ALTER TABLE summary_nodes ADD COLUMN strategy TEXT NOT NULL DEFAULT 'deterministic-v1'",
+    );
+  }
+
   private ensureArtifactColumnsSync(): void {
     const db = this.getDb();
     const columns = db.prepare('PRAGMA table_info(artifacts)').all() as Array<{ name: string }>;

package/src/types.ts

@@ -55,6 +55,13 @@ export type AutomaticRetrievalOptions = {
   stop: AutomaticRetrievalStopOptions;
 };
 
+export type SummaryStrategyName = 'deterministic-v1' | 'deterministic-v2';
+
+export type SummaryV2Options = {
+  strategy: SummaryStrategyName;
+  perMessageBudget: number;
+};
+
 export type OpencodeLcmOptions = {
   interop: InteropOptions;
   scopeDefaults: ScopeDefaults;
@@ -74,6 +81,7 @@ export type OpencodeLcmOptions = {
   artifactViewChars: number;
   binaryPreviewProviders: string[];
   previewBytePeek: number;
+  summaryV2: SummaryV2Options;
 };
 
 export type CapturedEvent = {