@martian-engineering/lossless-claw 0.1.0 → 0.1.1

package/README.md

@@ -26,12 +26,17 @@ Nothing is lost. Raw messages stay in the database. Summaries link back to their
 
 ### Install the plugin
 
+**From npm** (recommended):
+
+```bash
+npm install @martian-engineering/lossless-claw
+```
+
+**From source** (for development):
+
 ```bash
-# Clone the repo
 git clone https://github.com/Martian-Engineering/lossless-claw.git
 cd lossless-claw
-
-# Install dependencies
 npm install
 ```
 
@@ -39,6 +44,21 @@ npm install
 
 Add the plugin to your OpenClaw config (`~/.openclaw/openclaw.json`):
 
+```json
+{
+  "plugins": {
+    "paths": [
+      "node_modules/@martian-engineering/lossless-claw"
+    ],
+    "slots": {
+      "contextEngine": "lossless-claw"
+    }
+  }
+}
+```
+
+If installed from source, use the absolute path to the cloned repo instead:
+
 ```json
 {
   "plugins": {

package/docs/configuration.md

@@ -2,12 +2,16 @@
 
 ## Quick start
 
-Add LCM to your OpenClaw config:
+Install the plugin and add it to your OpenClaw config:
+
+```bash
+npm install @martian-engineering/lossless-claw
+```
 
 ```json
 {
   "plugins": {
-    "paths": ["/path/to/lossless-claw"],
+    "paths": ["node_modules/@martian-engineering/lossless-claw"],
     "slots": {
       "contextEngine": "lossless-claw"
     }
@@ -15,6 +19,8 @@ Add LCM to your OpenClaw config:
 }
 ```
 
+If installed from source, use the absolute path to the repo instead of `node_modules/...`.
+
 Set recommended environment variables:
 
 ```bash

package/openclaw.plugin.json

@@ -0,0 +1,62 @@
+{
+  "id": "lossless-claw",
+  "uiHints": {
+    "contextThreshold": {
+      "label": "Context Threshold",
+      "help": "Fraction of context window that triggers compaction (0.0–1.0)"
+    },
+    "incrementalMaxDepth": {
+      "label": "Incremental Max Depth",
+      "help": "How deep incremental compaction goes (0 = leaf only)"
+    },
+    "freshTailCount": {
+      "label": "Fresh Tail Count",
+      "help": "Number of recent messages protected from compaction"
+    },
+    "dbPath": {
+      "label": "Database Path",
+      "help": "Path to LCM SQLite database (default: ~/.openclaw/lcm.db)"
+    }
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "enabled": {
+        "type": "boolean"
+      },
+      "contextThreshold": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1
+      },
+      "incrementalMaxDepth": {
+        "type": "integer",
+        "minimum": 0
+      },
+      "freshTailCount": {
+        "type": "integer",
+        "minimum": 1
+      },
+      "leafMinFanout": {
+        "type": "integer",
+        "minimum": 2
+      },
+      "condensedMinFanout": {
+        "type": "integer",
+        "minimum": 2
+      },
+      "condensedMinFanoutHard": {
+        "type": "integer",
+        "minimum": 2
+      },
+      "dbPath": {
+        "type": "string"
+      },
+      "largeFileThresholdTokens": {
+        "type": "integer",
+        "minimum": 1000
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@martian-engineering/lossless-claw",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Lossless Context Management plugin for OpenClaw — DAG-based conversation summarization with incremental compaction",
   "type": "module",
   "main": "index.ts",
@@ -18,6 +18,7 @@
   "files": [
     "index.ts",
     "src/**/*.ts",
+    "openclaw.plugin.json",
     "docs/",
     "README.md",
     "LICENSE"

package/src/engine.ts

@@ -647,9 +647,7 @@ export class LcmContextEngine implements ContextEngine {
     customInstructions?: string;
   }): Promise<(text: string, aggressive?: boolean) => Promise<string>> {
     const lp = params.legacyParams ?? {};
-    console.error(`[lcm] resolveSummarize called, legacyParams keys: ${Object.keys(lp).join(",")}, has summarize fn: ${typeof lp.summarize === "function"}`);
     if (typeof lp.summarize === "function") {
-      console.error(`[lcm] resolveSummarize: using legacy summarize function`);
       return lp.summarize as (text: string, aggressive?: boolean) => Promise<string>;
     }
     try {
@@ -659,7 +657,6 @@ export class LcmContextEngine implements ContextEngine {
         customInstructions: params.customInstructions,
       });
       if (runtimeSummarizer) {
-        console.error(`[lcm] resolveSummarize: got runtime summarizer`);
         return runtimeSummarizer;
       }
       console.error(`[lcm] resolveSummarize: createLcmSummarizeFromLegacyParams returned undefined`);

package/src/summarize.ts

@@ -338,12 +338,10 @@ export async function createLcmSummarizeFromLegacyParams(params: {
   const modelHint =
     typeof params.legacyParams.model === "string" ? params.legacyParams.model.trim() : "";
   const modelRef = modelHint || undefined;
-  console.error(`[lcm] createLcmSummarize: providerHint="${providerHint}", modelHint="${modelHint}", modelRef="${modelRef}"`);
 
   let resolved: { provider: string; model: string };
   try {
     resolved = params.deps.resolveModel(modelRef, providerHint || undefined);
-    console.error(`[lcm] createLcmSummarize: resolved model=${resolved.model}, provider=${resolved.provider}`);
   } catch (err) {
     console.error(`[lcm] createLcmSummarize: resolveModel FAILED:`, err instanceof Error ? err.message : err);
     return undefined;