opencode-lcm 0.13.2 → 0.13.5

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;
             }
@@ -417,6 +424,13 @@ export function resolveCaptureHydrationMode(options) {
     // hydration there until Bun/Windows is proven stable again.
     return isBunRuntime && platform === 'win32' ? 'full' : 'targeted';
 }
+function shouldUseLightweightPartCapture(event, options) {
+    const isBunRuntime = options?.isBunRuntime ?? (typeof globalThis === 'object' && 'Bun' in globalThis);
+    const platform = options?.platform ?? process.platform;
+    if (!isBunRuntime || platform !== 'win32')
+        return false;
+    return event.type === 'message.part.updated' || event.type === 'message.part.removed';
+}
 function isSqliteRuntimeImportError(runtime, error) {
     const code = typeof error === 'object' && error && 'code' in error && typeof error.code === 'string'
         ? error.code
@@ -768,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
       );
@@ -823,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)');
@@ -970,9 +986,11 @@ export class SqliteLcmStore {
             }
             if (!normalized.sessionID || !shouldPersistSession)
                 return;
-            const session = resolveCaptureHydrationMode() === 'targeted'
-                ? this.readSessionForCaptureSync(normalized)
-                : this.readSessionSync(normalized.sessionID);
+            const session = shouldUseLightweightPartCapture(normalized)
+                ? this.readSessionForCaptureSync(normalized, { hydrateArtifacts: false })
+                : resolveCaptureHydrationMode() === 'targeted'
+                    ? this.readSessionForCaptureSync(normalized)
+                    : this.readSessionSync(normalized.sessionID);
             const previousParentSessionID = session.parentSessionID;
             const shouldSyncDerivedState = this.shouldSyncDerivedSessionStateForEvent(session, normalized);
             let next = this.applyEvent(session, normalized);
@@ -1253,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
@@ -1364,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);
+                    return this.isMessageArchivedSync(session.sessionID, existing.info.id, messageCreatedAt(existing));
                 }
                 return this.readMessageCountSync(session.sessionID) >= this.options.freshTailMessages;
             }
@@ -1378,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);
+                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);
+                return this.isMessageArchivedSync(session.sessionID, message.info.id, messageCreatedAt(message));
             }
             default:
                 return false;
@@ -2702,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))
@@ -2726,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) {
@@ -2742,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));
-            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');
     }
@@ -2768,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 &&
@@ -2815,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);
@@ -2849,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 = [];
@@ -2861,6 +2937,7 @@ export class SqliteLcmStore {
             endIndex: input.endIndex,
             messageIDs: input.messageIDs,
             summaryText: input.summaryText,
+            strategy: summaryStrategy,
             createdAt: now,
         });
         let currentLevel = [];
@@ -2913,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) {
@@ -2932,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;
     }
@@ -2949,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,
         };
     }
@@ -3229,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();
@@ -3639,7 +3725,7 @@ export class SqliteLcmStore {
         }
         return parentSessionID;
     }
-    readSessionForCaptureSync(event) {
+    readSessionForCaptureSync(event, options) {
         const sessionID = event.sessionID;
         if (!sessionID)
             return emptySession('');
@@ -3647,19 +3733,19 @@ export class SqliteLcmStore {
         const payload = event.payload;
         switch (payload.type) {
             case 'message.updated': {
-                const message = this.readMessageSync(sessionID, payload.properties.info.id);
+                const message = this.readMessageSync(sessionID, payload.properties.info.id, options);
                 if (message)
                     session.messages = [message];
                 return session;
             }
             case 'message.part.updated': {
-                const message = this.readMessageSync(sessionID, payload.properties.part.messageID);
+                const message = this.readMessageSync(sessionID, payload.properties.part.messageID, options);
                 if (message)
                     session.messages = [message];
                 return session;
             }
             case 'message.part.removed': {
-                const message = this.readMessageSync(sessionID, payload.properties.messageID);
+                const message = this.readMessageSync(sessionID, payload.properties.messageID, options);
                 if (message)
                     session.messages = [message];
                 return session;
@@ -3668,16 +3754,19 @@ export class SqliteLcmStore {
                 return session;
         }
     }
-    readMessageSync(sessionID, messageID) {
+    readMessageSync(sessionID, messageID, options) {
         const db = this.getDb();
         const row = safeQueryOne(db.prepare('SELECT * FROM messages WHERE session_id = ? AND message_id = ?'), [sessionID, messageID], 'readMessageSync');
         if (!row)
             return undefined;
+        const hydrateArtifacts = options?.hydrateArtifacts ?? true;
         const artifactsByPart = new Map();
-        for (const artifact of this.readArtifactsForMessageSync(messageID)) {
-            const list = artifactsByPart.get(artifact.partID) ?? [];
-            list.push(artifact);
-            artifactsByPart.set(artifact.partID, list);
+        if (hydrateArtifacts) {
+            for (const artifact of this.readArtifactsForMessageSync(messageID)) {
+                const list = artifactsByPart.get(artifact.partID) ?? [];
+                list.push(artifact);
+                artifactsByPart.set(artifact.partID, list);
+            }
         }
         const parts = db
             .prepare('SELECT * FROM parts WHERE session_id = ? AND message_id = ? ORDER BY sort_key ASC, part_id ASC')
@@ -3694,7 +3783,8 @@ export class SqliteLcmStore {
             info,
             parts: parts.map((partRow) => {
                 const part = parseJson(partRow.part_json);
-                hydratePartFromArtifacts(part, artifactsByPart.get(part.id) ?? []);
+                if (hydrateArtifacts)
+                    hydratePartFromArtifacts(part, artifactsByPart.get(part.id) ?? []);
                 return part;
             }),
         };
@@ -3744,22 +3834,34 @@ export class SqliteLcmStore {
                 return;
             case 'message.part.updated': {
                 const message = session.messages.find((entry) => entry.info.id === payload.properties.part.messageID);
+                const preservedArtifacts = message
+                    ? this.readArtifactsForMessageSync(message.info.id).filter((artifact) => artifact.partID !== payload.properties.part.id)
+                    : [];
                 const externalized = message ? await this.externalizeMessage(message) : undefined;
                 withTransaction(this.getDb(), 'capture', () => {
                     this.upsertSessionRowSync(session);
                     if (externalized) {
-                        this.replaceStoredMessageSync(session.sessionID, externalized.storedMessage, externalized.artifacts);
+                        this.replaceStoredMessageSync(session.sessionID, externalized.storedMessage, [
+                            ...preservedArtifacts,
+                            ...externalized.artifacts,
+                        ]);
                     }
                 });
                 return;
             }
             case 'message.part.removed': {
                 const message = session.messages.find((entry) => entry.info.id === payload.properties.messageID);
+                const preservedArtifacts = message
+                    ? this.readArtifactsForMessageSync(message.info.id).filter((artifact) => artifact.partID !== payload.properties.partID)
+                    : [];
                 const externalized = message ? await this.externalizeMessage(message) : undefined;
                 withTransaction(this.getDb(), 'capture', () => {
                     this.upsertSessionRowSync(session);
                     if (externalized) {
-                        this.replaceStoredMessageSync(session.sessionID, externalized.storedMessage, externalized.artifacts);
+                        this.replaceStoredMessageSync(session.sessionID, externalized.storedMessage, [
+                            ...preservedArtifacts,
+                            ...externalized.artifacts,
+                        ]);
                     }
                 });
                 return;

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.2",
+  "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-artifacts.ts

@@ -479,7 +479,7 @@ export async function externalizeMessage(
     const { storedPart, artifacts: nextArtifacts } = await externalizePart(
       bindings,
       part,
-      message.info.time.created,
+      message.info?.time?.created ?? 0,
     );
     artifacts.push(...nextArtifacts);
     storedParts.push(storedPart);
@@ -509,7 +509,7 @@ export async function externalizeSession(
       const { storedPart, artifacts: nextArtifacts } = await externalizePart(
         bindings,
         part,
-        message.info.time.created,
+        message.info?.time?.created ?? 0,
       );
       artifacts.push(...nextArtifacts);
       storedParts.push(storedPart);
@@ -607,7 +607,7 @@ export function persistStoredSessionSync(
     insertMessage.run(
       message.info.id,
       storedSession.sessionID,
-      message.info.time.created,
+      message.info?.time?.created ?? 0,
       JSON.stringify(message.info),
     );
 

package/src/store-search.ts

@@ -296,7 +296,7 @@ export function searchByScan(
         id: message.info.id,
         type: message.info.role,
         sessionID: session.sessionID,
-        timestamp: message.info.time.created,
+        timestamp: message.info?.time?.created ?? 0,
         snippet: buildSnippet(blob, query),
         content: blob,
         sourceKind: 'message',
@@ -361,7 +361,7 @@ function insertMessageSearchRowsSync(deps: FtsDeps, session: NormalizedSession):
       session.sessionID,
       message.info.id,
       message.info.role,
-      String(message.info.time.created),
+      String(message.info?.time?.created ?? 0),
       content,
     );
   }
@@ -380,7 +380,13 @@ export function replaceMessageSearchRowSync(
 
   db.prepare(
     'INSERT INTO message_fts (session_id, message_id, role, created_at, content) VALUES (?, ?, ?, ?, ?)',
-  ).run(sessionID, message.info.id, message.info.role, String(message.info.time.created), content);
+  ).run(
+    sessionID,
+    message.info.id,
+    message.info.role,
+    String(message.info?.time?.created ?? 0),
+    content,
+  );
 }
 
 export function replaceSummarySearchRowsSync(deps: FtsDeps, sessionIDs?: string[]): void {

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'),
   };
 }