opencode-lcm 0.11.0 → 0.13.0

package/README.md

@@ -1,9 +1,10 @@
-# opencode-lcm
+# Opencode-lcm (Lossless Context Memory)
 
+[![npm version](https://img.shields.io/npm/v/opencode-lcm)](https://www.npmjs.com/package/opencode-lcm)
 [![CI](https://github.com/Plutarch01/opencode-lcm/actions/workflows/ci.yml/badge.svg)](https://github.com/Plutarch01/opencode-lcm/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-A transparent long-memory plugin for [OpenCode](https://github.com/sst/opencode), based on the [Lossless Context Memory (LCM)](https://papers.voltropy.com/LCM) research. It captures older session context outside the active prompt, compresses it into searchable summaries and artifacts, then automatically recalls relevant details back into the prompt when the current turn needs them. The model does not become smarter, but it behaves much better across long, compacted sessions because important prior context stops disappearing.
+A transparent long-memory plugin for [OpenCode](https://github.com/sst/opencode), based on the [Lossless Context Memory (LCM)](https://papers.voltropy.com/LCM) research by Voltropy. It captures older session context outside the active prompt, compresses it into searchable summaries and artifacts, then automatically recalls relevant details back into the prompt when the current turn needs them. The model does not become smarter, but it behaves much better across long, compacted sessions because important prior context stops disappearing.
 
 <!-- Add a demo screenshot or GIF here -->
 <!-- ![opencode-lcm in action](assets/images/lcm-demo.png) -->
@@ -31,12 +32,24 @@ OpenCode will automatically download the latest version from npm on startup. No
 ### From source
 
 ```sh
-git clone https://github.com/plutarch01/opencode-lcm.git
+git clone https://github.com/Plutarch01/opencode-lcm.git
 cd opencode-lcm
 npm install
 npm run build
 ```
 
+Then copy or symlink the built plugin into your plugins directory:
+
+```sh
+# Project-level
+cp dist/index.js .opencode/plugins/opencode-lcm.js
+
+# Or global
+cp dist/index.js ~/.config/opencode/plugins/opencode-lcm.js
+```
+
+Local plugins in `.opencode/plugins/` or `~/.config/opencode/plugins/` are loaded automatically by OpenCode at startup.
+
 ## How It Works
 
 OpenCode handles compaction normally — when the conversation gets too large, it shrinks the prompt. `opencode-lcm` works alongside that by saving older details *outside* the prompt, then searching that archive later to pull back only what matters.

package/dist/store.d.ts

@@ -78,8 +78,14 @@ type SqliteRuntimeOptions = {
     isBunRuntime?: boolean;
     platform?: string | undefined;
 };
+type CaptureHydrationMode = 'full' | 'targeted';
+type CaptureHydrationOptions = {
+    isBunRuntime?: boolean;
+    platform?: string | undefined;
+};
 export declare function resolveSqliteRuntimeCandidates(options?: SqliteRuntimeOptions): SqliteRuntime[];
 export declare function resolveSqliteRuntime(options?: SqliteRuntimeOptions): SqliteRuntime;
+export declare function resolveCaptureHydrationMode(options?: CaptureHydrationOptions): CaptureHydrationMode;
 export declare class SqliteLcmStore {
     private readonly options;
     private static readonly deferredPartUpdateDelayMs;
@@ -89,11 +95,17 @@ export declare class SqliteLcmStore {
     private readonly workspaceDirectory;
     private db?;
     private dbReadyPromise?;
+    private deferredInitTimer?;
+    private deferredInitPromise?;
+    private deferredInitRequested;
+    private activeOperationCount;
     private readonly pendingPartUpdates;
     private pendingPartUpdateTimer?;
     private pendingPartUpdateFlushPromise?;
     constructor(projectDir: string, options: OpencodeLcmOptions);
     init(): Promise<void>;
+    private withStoreActivity;
+    private waitForDeferredInitIfRunning;
     private prepareForRead;
     private scheduleDeferredPartUpdateFlush;
     private clearDeferredPartUpdateTimer;
@@ -105,6 +117,9 @@ export declare class SqliteLcmStore {
     private ensureDbReady;
     private openAndInitializeDb;
     private deferredInitCompleted;
+    private runDeferredInit;
+    private scheduleDeferredInit;
+    private ensureDeferredInitComplete;
     private readSchemaVersionSync;
     private assertSupportedSchemaVersionSync;
     private writeSchemaVersionSync;
@@ -141,10 +156,6 @@ export declare class SqliteLcmStore {
     private shouldRecordEvent;
     private shouldSyncDerivedLineageSubtree;
     private shouldCleanupOrphanBlobsForEvent;
-    private captureArtifactHydrationMessageIDs;
-    private archivedMessageIDs;
-    private didArchivedMessagesChange;
-    private isArchivedMessage;
     private shouldSyncDerivedSessionStateForEvent;
     private syncAllDerivedSessionStateSync;
     private syncDerivedSessionStateSync;
@@ -287,6 +298,7 @@ export declare class SqliteLcmStore {
     private resolveLineageSync;
     private applyEvent;
     private getResumeSync;
+    private materializeSessionRow;
     private readSessionHeaderSync;
     private clearSessionDataSync;
     private readChildSessionsSync;
@@ -296,6 +308,10 @@ export declare class SqliteLcmStore {
     private readSessionSync;
     private prepareSessionForPersistence;
     private sanitizeParentSessionIDSync;
+    private readSessionForCaptureSync;
+    private readMessageSync;
+    private readMessageCountSync;
+    private isMessageArchivedSync;
     private persistCapturedSession;
     private persistSession;
     private persistStoredSessionSync;