v0.111.2 — openclaw plugin contract fixes, bump script improvement

- Fix stale info.version (was 0.108.0), bump script now replaces all
  version occurrences in index.ts (count=0)
- Add missing estimatedTokens to bootstrap CE assemble return
- Accept prompt/model params in assemble (use explicit prompt, fall back
  to extraction from last user message)
- Delegate compact() to runtime instead of no-op (fixes /compact and
  overflow recovery for non-owning engines)
- Fix dead source ternary in memory_search
- Fix onSubagentEnded reason type to match SubagentEndReason union
- Fix formatTurn test drift (bogus 500-char user limit → maxInlineLength)
- Add openclaw/plugin-sdk/* as external in esbuild config

Author: hughpyle

CLAUDE.md

@@ -22,9 +22,21 @@ If you accidentally stage private content, stop and alert the user before commit
 
 ## Release process
 
-1. `python scripts/bump_version.py X.Y.Z`
+```bash
+scripts/release.sh patch    # 0.111.1 → 0.111.2
+scripts/release.sh minor    # 0.111.1 → 0.112.0
+scripts/release.sh 0.112.0  # explicit version
+```
+
+The script handles: version bump, commit, tag, build, push, PyPI upload, GitHub release.
+
+- **Patch**: bug fixes, contract alignment, dependency updates. Release notes are the commit body (bullet list).
+- **Minor**: new features, behavioral changes. Release notes use `## What's new` with commit log since last minor.
+
+Manual steps (when needed):
+1. `python scripts/bump_version.py X.Y.Z` — bump all version strings
 2. Commit, tag `vX.Y.Z`, push with `--tags`
-3. `python -m build && twine upload dist/keep_skill-X.Y.Z*`
+3. `python -m build && uvx twine upload dist/keep_skill-X.Y.Z*`
 4. `gh release create vX.Y.Z`
 
 Both `keep-skill` and `langchain-keep` go to PyPI.

SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: keep
-version: 0.111.1
+version: 0.111.2
 description: Reflective Memory
 homepage: https://github.com/keepnotes-ai/keep
 runtime: python:3.12-slim

claude-code-plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "keep",
-  "version": "0.111.1",
+  "version": "0.111.2",
   "description": "Reflective memory with semantic search for AI agents",
   "author": {
     "name": "keepnotes-ai",

keep/data/openclaw-plugin/build.mjs

@@ -40,6 +40,8 @@ await build({
     "perf_hooks",
     "async_hooks",
     "diagnostics_channel",
+    // OpenClaw plugin SDK — resolved by jiti at runtime
+    "openclaw/*",
   ],
   // Banner for source identification
   banner: {

keep/data/openclaw-plugin/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "keep",
   "name": "keep",
   "description": "Reflective memory — context engine + memory tools",
-  "version": "0.111.1",
+  "version": "0.111.2",
   "kind": "context-engine",
   "configSchema": {
     "type": "object",

keep/data/openclaw-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keepnotes-ai/keep",
-  "version": "0.111.1",
+  "version": "0.111.2",
   "description": "keep — reflective memory plugin for OpenClaw (context engine + memory tools)",
   "type": "module",
   "license": "MIT",

keep/data/openclaw-plugin/src/index.test.ts

@@ -76,8 +76,7 @@ function formatTurn(messages: any[], maxInlineLength: number): string {
     const text = extractText(msg.content);
     if (!text.trim()) continue;
 
-    const limit = role === "user" ? 500 : maxInlineLength;
-    parts.push(`[${role}] ${truncate(text, limit)}`);
+    parts.push(`[${role}] ${truncate(text, maxInlineLength)}`);
   }
   return parts.join("\n\n");
 }
@@ -295,12 +294,12 @@ describe("formatTurn", () => {
     assert.ok(result.includes("[assistant] hi"));
   });
 
-  it("truncates user messages at 500 chars", () => {
+  it("truncates user messages at maxInlineLength", () => {
     const longContent = "x".repeat(600);
     const msgs = [{ role: "user", content: longContent }];
-    const result = formatTurn(msgs, 2000);
-    // [user] prefix + 500 chars + ellipsis
-    assert.ok(result.length < 520);
+    const result = formatTurn(msgs, 200);
+    // [user] prefix + 200 chars + ellipsis
+    assert.ok(result.length < 220);
     assert.ok(result.endsWith("…"));
   });
 

keep/data/openclaw-plugin/src/index.ts

@@ -11,6 +11,7 @@
 import { execFileSync } from "child_process";
 import path from "node:path";
 import fs from "node:fs";
+import { delegateCompactionToRuntime } from "openclaw/plugin-sdk/core";
 import { KeepMcpTransport } from "./mcp-transport.js";
 
 // ---------------------------------------------------------------------------
@@ -170,13 +171,14 @@ function registerBootstrapContextEngine(api: any, mode: "install" | "configure")
       info: {
         id: "keep",
         name: "keep (setup required)",
-        version: "0.111.1",
+        version: "0.111.2",
         ownsCompaction: false,
       },
       async assemble(params: { messages: any[]; tokenBudget?: number }) {
         return {
           messages: params.messages,
           systemPromptAddition: message,
+          estimatedTokens: 0,
         };
       },
     };
@@ -492,10 +494,7 @@ export default function register(api: any) {
                   const startLine = parseInt(tags._focus_start_line, 10) || 1;
                   const endLine = parseInt(tags._focus_end_line, 10) || startLine;
 
-                  // Source: memory for memory/ files
-                  const source = relPath.startsWith("memory/") || relPath === "MEMORY.md"
-                    ? "memory"
-                    : "memory";
+                  const source = "memory";
 
                   return {
                     path: relPath,
@@ -626,7 +625,7 @@ export default function register(api: any) {
       info: {
         id: "keep",
         name: "keep reflective memory",
-        version: "0.108.0",
+        version: "0.111.2",
         ownsCompaction: false,
       },
 
@@ -771,6 +770,8 @@ export default function register(api: any) {
         sessionKey?: string;
         messages: any[];
         tokenBudget?: number;
+        model?: string;
+        prompt?: string;
       }) {
         const conversationTokens = params.messages.reduce((sum: number, m: any) => {
           return sum + estimateTokens(extractText(m.content));
@@ -788,12 +789,11 @@ export default function register(api: any) {
         try {
           const cfg = getConfig();
 
-          const lastUser = [...params.messages]
-            .reverse()
-            .find((m: any) => m.role === "user");
-          const prompt = lastUser
-            ? truncate(extractText(lastUser.content), 500)
-            : "";
+          const prompt = params.prompt
+            ?? (() => {
+              const lastUser = [...params.messages].reverse().find((m: any) => m.role === "user");
+              return lastUser ? truncate(extractText(lastUser.content), 500) : "";
+            })();
 
           const totalBudget = params.tokenBudget || 8000;
           const keepBudget = Math.floor(totalBudget * cfg.contextBudgetRatio);
@@ -930,7 +930,7 @@ export default function register(api: any) {
       },
 
       // -------------------------------------------------------------------
-      // compact: advisory (ownsCompaction=false)
+      // compact: delegate to runtime (ownsCompaction=false)
       // -------------------------------------------------------------------
       async compact(params: {
         sessionId: string;
@@ -943,15 +943,13 @@ export default function register(api: any) {
         customInstructions?: string;
         runtimeContext?: Record<string, unknown>;
       }) {
-        if (params.currentTokenCount) {
-          api.logger?.debug(
-            `[keep] compact advisory: ${params.currentTokenCount} tokens, ` +
-              `target=${params.compactionTarget || "budget"}, ` +
-              `budget=${params.tokenBudget}`,
-          );
-        }
+        api.logger?.debug(
+          `[keep] compact: delegating to runtime (tokens=${params.currentTokenCount}, ` +
+            `target=${params.compactionTarget || "budget"}, ` +
+            `budget=${params.tokenBudget})`,
+        );
 
-        return { ok: true, compacted: false, reason: "advisory" };
+        return delegateCompactionToRuntime(params);
       },
 
       // -------------------------------------------------------------------
@@ -1015,7 +1013,7 @@ export default function register(api: any) {
       // -------------------------------------------------------------------
       async onSubagentEnded(params: {
         childSessionKey: string;
-        reason: string;
+        reason: "deleted" | "completed" | "swept" | "released";
       }) {
         sessionFirstAssemble.delete(params.childSessionKey);
         api.logger?.debug(

keep/data/openclaw-plugin/src/mcp-transport.ts

@@ -144,7 +144,7 @@ export class KeepMcpTransport {
     });
 
     this.client = new Client(
-      { name: "keep-openclaw-plugin", version: "0.111.1" },
+      { name: "keep-openclaw-plugin", version: "0.111.2" },
       { capabilities: {} },
     );
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "keep-skill"
-version = "0.111.1"
+version = "0.111.2"
 description = "Reflective memory - remember and search documents by meaning"
 readme = "README.md"
 requires-python = ">=3.11,<3.14"