context-mode 1.0.53 → 1.0.56

package/configs/codex/AGENTS.md

@@ -56,3 +56,22 @@ Search results can flood context. Use `ctx_execute(language: "shell", code: "gre
 | `ctx stats` | Call the `stats` MCP tool and display the full output verbatim |
 | `ctx doctor` | Call the `doctor` MCP tool, run the returned shell command, display as checklist |
 | `ctx upgrade` | Call the `upgrade` MCP tool, run the returned shell command, display as checklist |
+
+## Windows notes
+
+**PowerShell cmdlets in shell scripts** — The sandbox executes scripts via bash. PowerShell
+cmdlets (`Format-List`, `Format-Table`, `Get-Culture`, etc.) do not exist in bash and will fail
+with `command not found`. Wrap them with `pwsh -NoProfile -Command "..."` instead.
+
+**Relative paths** — The sandbox CWD is a temp directory, not your project root. Always convert
+any user-supplied path to an absolute path before passing it to `rg`, `grep`, or `find`.
+Ask the user to confirm the absolute path if it is not already known.
+
+**Windows drive letter paths** — The sandbox runs Git Bash / MSYS2, not WSL. Drive letters must
+use the MSYS2 convention, NOT the WSL convention:
+`X:\path` → `/x/path` (lowercase letter, no `/mnt/` prefix).
+Never emit `/mnt/<letter>/` prefixes regardless of which drive the project is on.
+
+**Always quote paths** — If a path contains spaces, bash splits it into separate arguments.
+Always wrap every path in double quotes: `rg "symbol" "$REPO_ROOT/some dir/Source"`.
+This applies to all tools: `rg`, `grep`, `find`, `ls`, etc.

package/configs/kilo/AGENTS.md

@@ -0,0 +1,58 @@
+# context-mode — MANDATORY routing rules
+
+You have context-mode MCP tools available. These rules are NOT optional — they protect your context window from flooding. A single unrouted command can dump 56 KB into context and waste the entire session.
+
+## BLOCKED commands — do NOT attempt these
+
+### curl / wget — BLOCKED
+Any shell command containing `curl` or `wget` will be intercepted and blocked by the context-mode plugin. Do NOT retry.
+Instead use:
+- `context-mode_ctx_fetch_and_index(url, source)` to fetch and index web pages
+- `context-mode_ctx_execute(language: "javascript", code: "const r = await fetch(...)")` to run HTTP calls in sandbox
+
+### Inline HTTP — BLOCKED
+Any shell command containing `fetch('http`, `requests.get(`, `requests.post(`, `http.get(`, or `http.request(` will be intercepted and blocked. Do NOT retry with shell.
+Instead use:
+- `context-mode_ctx_execute(language, code)` to run HTTP calls in sandbox — only stdout enters context
+
+### Direct web fetching — BLOCKED
+Do NOT use any direct URL fetching tool. Use the sandbox equivalent.
+Instead use:
+- `context-mode_ctx_fetch_and_index(url, source)` then `context-mode_ctx_search(queries)` to query the indexed content
+
+## REDIRECTED tools — use sandbox equivalents
+
+### Shell (>20 lines output)
+Shell is ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`, and other short-output commands.
+For everything else, use:
+- `context-mode_ctx_batch_execute(commands, queries)` — run multiple commands + search in ONE call
+- `context-mode_ctx_execute(language: "shell", code: "...")` — run in sandbox, only stdout enters context
+
+### File reading (for analysis)
+If you are reading a file to **edit** it → reading is correct (edit needs content in context).
+If you are reading to **analyze, explore, or summarize** → use `context-mode_ctx_execute_file(path, language, code)` instead. Only your printed summary enters context.
+
+### grep / search (large results)
+Search results can flood context. Use `context-mode_ctx_execute(language: "shell", code: "grep ...")` to run searches in sandbox. Only your printed summary enters context.
+
+## Tool selection hierarchy
+
+1. **GATHER**: `context-mode_ctx_batch_execute(commands, queries)` — Primary tool. Runs all commands, auto-indexes output, returns search results. ONE call replaces 30+ individual calls.
+2. **FOLLOW-UP**: `context-mode_ctx_search(queries: ["q1", "q2", ...])` — Query indexed content. Pass ALL questions as array in ONE call.
+3. **PROCESSING**: `context-mode_ctx_execute(language, code)` | `context-mode_ctx_execute_file(path, language, code)` — Sandbox execution. Only stdout enters context.
+4. **WEB**: `context-mode_ctx_fetch_and_index(url, source)` then `context-mode_ctx_search(queries)` — Fetch, chunk, index, query. Raw HTML never enters context.
+5. **INDEX**: `context-mode_ctx_index(content, source)` — Store content in FTS5 knowledge base for later search.
+
+## Output constraints
+
+- Keep responses under 500 words.
+- Write artifacts (code, configs, PRDs) to FILES — never return them as inline text. Return only: file path + 1-line description.
+- When indexing content, use descriptive source labels so others can `search(source: "label")` later.
+
+## ctx commands
+
+| Command | Action |
+|---------|--------|
+| `ctx stats` | Call the `stats` MCP tool and display the full output verbatim |
+| `ctx doctor` | Call the `doctor` MCP tool, run the returned shell command, display as checklist |
+| `ctx upgrade` | Call the `upgrade` MCP tool, run the returned shell command, display as checklist |

package/configs/kilo/kilo.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://app.kilo.ai/config.json",
+  "mcp": {
+    "context-mode": {
+      "type": "local",
+      "command": ["context-mode"]
+    }
+  },
+  "plugin": ["context-mode"]
+}

package/hooks/core/tool-naming.mjs

@@ -20,6 +20,7 @@ const TOOL_PREFIXES = {
   "gemini-cli":     (tool) => `mcp__context-mode__${tool}`,
   "antigravity":    (tool) => `mcp__context-mode__${tool}`,
   "opencode":       (tool) => `context-mode_${tool}`,
+  "kilo":           (tool) => `context-mode_${tool}`,
   "vscode-copilot": (tool) => `context-mode_${tool}`,
   "kiro":           (tool) => `@context-mode/${tool}`,
   "zed":            (tool) => `mcp:context-mode:${tool}`,

package/hooks/ensure-deps.mjs

@@ -8,13 +8,22 @@
  * hook that needs native modules. Fast path: existsSync check (~0.1ms).
  * Slow path: npm install (first run only, ~5-30s).
  *
+ * Also handles ABI compatibility (#148, #203): when the current Node.js
+ * version differs from the one better-sqlite3 was compiled against,
+ * automatically swaps in a cached binary or rebuilds. This protects
+ * both the MCP server AND hooks from ABI mismatch crashes when users
+ * have multiple Node versions via mise/volta/fnm/nvm.
+ *
+ * @see https://github.com/mksglu/context-mode/issues/148
  * @see https://github.com/mksglu/context-mode/issues/172
+ * @see https://github.com/mksglu/context-mode/issues/203
  */
 
-import { existsSync } from "node:fs";
+import { existsSync, copyFileSync } from "node:fs";
 import { execSync } from "node:child_process";
 import { resolve, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
+import { createRequire } from "node:module";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const root = resolve(__dirname, "..");
@@ -23,7 +32,9 @@ const NATIVE_DEPS = ["better-sqlite3"];
 
 export function ensureDeps() {
   for (const pkg of NATIVE_DEPS) {
-    if (!existsSync(resolve(root, "node_modules", pkg))) {
+    const pkgDir = resolve(root, "node_modules", pkg);
+    if (!existsSync(pkgDir)) {
+      // Package not installed at all
       try {
         execSync(`npm install ${pkg} --no-package-lock --no-save --silent`, {
           cwd: root,
@@ -31,9 +42,76 @@ export function ensureDeps() {
           timeout: 120000,
         });
       } catch { /* best effort — hook degrades gracefully without DB */ }
+    } else if (
+      !existsSync(resolve(pkgDir, "build", "Release")) &&
+      !existsSync(resolve(pkgDir, "prebuilds"))
+    ) {
+      // Package installed but native binary missing (e.g., npm ignore-scripts=true)
+      try {
+        execSync(`npm rebuild ${pkg} --ignore-scripts=false`, {
+          cwd: root,
+          stdio: "pipe",
+          timeout: 120000,
+        });
+      } catch { /* best effort — hook degrades gracefully without DB */ }
+    }
+  }
+}
+
+/**
+ * ABI-aware native binary caching for better-sqlite3 (#148, #203).
+ *
+ * Users with mise/asdf/volta/fnm may run sessions with different Node
+ * versions. Each ABI needs its own compiled binary — cache them
+ * side-by-side so switching Node versions doesn't require a rebuild
+ * every time.
+ *
+ * Flow:
+ *   1. Check if ABI-specific cache exists → swap in
+ *   2. Probe-load better-sqlite3 → if OK, cache current binary
+ *   3. If ABI mismatch → npm rebuild, then cache the new binary
+ */
+export function ensureNativeCompat(pluginRoot) {
+  try {
+    const abi = process.versions.modules;
+    const nativeDir = resolve(pluginRoot, "node_modules", "better-sqlite3", "build", "Release");
+    const binaryPath = resolve(nativeDir, "better_sqlite3.node");
+    const abiCachePath = resolve(nativeDir, `better_sqlite3.abi${abi}.node`);
+
+    if (!existsSync(nativeDir)) return;
+
+    // Fast path: cached binary for this ABI already exists
+    if (existsSync(abiCachePath)) {
+      copyFileSync(abiCachePath, binaryPath);
+      return;
+    }
+
+    if (!existsSync(binaryPath)) return;
+
+    // Probe: try loading better-sqlite3 with current Node
+    try {
+      const req = createRequire(resolve(pluginRoot, "package.json"));
+      req("better-sqlite3");
+      // Load succeeded — cache the working binary for this ABI
+      copyFileSync(binaryPath, abiCachePath);
+    } catch (probeErr) {
+      if (probeErr?.message?.includes("NODE_MODULE_VERSION")) {
+        // ABI mismatch — rebuild for current Node version
+        execSync("npm rebuild better-sqlite3", {
+          cwd: pluginRoot,
+          stdio: "pipe",
+          timeout: 60000,
+        });
+        if (existsSync(binaryPath)) {
+          copyFileSync(binaryPath, abiCachePath);
+        }
+      }
     }
+  } catch {
+    /* best effort — caller will report the error on first DB access */
   }
 }
 
 // Auto-run on import (like suppress-stderr.mjs)
 ensureDeps();
+ensureNativeCompat(root);

package/hooks/pretooluse.mjs

@@ -87,39 +87,44 @@ try {
       writeFileSync(ipPath, JSON.stringify(ip, null, 2) + "\n", "utf-8");
     }
 
-    // 3. Update hook path + matcher in settings.json
+    // 3. Update hook paths + matcher in settings.json for ALL hook types (#187)
+    //    Previously only fixed PreToolUse — SessionStart, PostToolUse, PreCompact,
+    //    UserPromptSubmit paths remained stale after marketplace auto-update.
     const settingsPath = resolve(homedir(), ".claude", "settings.json");
     try {
       const settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
-      const hooks = settings.hooks?.PreToolUse;
-      if (Array.isArray(hooks)) {
-        let changed = false;
-        for (const entry of hooks) {
-          // Fix deprecated Task-only matcher → Agent|Task
-          if (entry.matcher && entry.matcher.includes("Task") && !entry.matcher.includes("Agent")) {
+      const allHooks = settings.hooks || {};
+      let changed = false;
+
+      for (const hookType of Object.keys(allHooks)) {
+        const entries = allHooks[hookType];
+        if (!Array.isArray(entries)) continue;
+
+        for (const entry of entries) {
+          // Fix deprecated Task-only matcher (PreToolUse only)
+          if (hookType === "PreToolUse" && entry.matcher?.includes("Task") && !entry.matcher.includes("Agent")) {
             entry.matcher = entry.matcher.replace("Task", "Agent|Task");
             changed = true;
           }
+          // Rewrite stale context-mode hook paths to point to current version
           for (const h of (entry.hooks || [])) {
-            if (h.command?.includes("pretooluse.mjs") && !h.command.includes(targetDir)) {
-              h.command = "node " + resolve(targetDir, "hooks", "pretooluse.mjs");
-              changed = true;
+            if (h.command && h.command.includes(".mjs") && h.command.includes("context-mode") && !h.command.includes(targetDir)) {
+              // Extract the script filename (e.g., sessionstart.mjs, pretooluse.mjs)
+              const scriptMatch = h.command.match(/([a-z]+\.mjs)\s*"?\s*$/);
+              if (scriptMatch) {
+                h.command = "node " + resolve(targetDir, "hooks", scriptMatch[1]);
+                changed = true;
+              }
             }
           }
         }
-        if (changed) writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
       }
+
+      if (changed) writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
     } catch { /* skip settings update */ }
 
-    // 4. Nuke stale version dirs (keep only targetDir and current running dir)
-    try {
-      const keepDirs = new Set([basename(targetDir), myDirName]);
-      for (const d of readdirSync(cacheParent)) {
-        if (!keepDirs.has(d)) {
-          try { rmSync(resolve(cacheParent, d), { recursive: true, force: true }); } catch { /* skip */ }
-        }
-      }
-    } catch { /* skip */ }
+    // Old version dirs are cleaned lazily by sessionstart.mjs (age-gated >1h)
+    // to avoid breaking active sessions that still reference them (#181).
 
     writeFileSync(marker, Date.now().toString(), "utf-8");
   }

package/hooks/routing-block.mjs

@@ -35,12 +35,21 @@ export function createRoutingBlock(t) {
     - DO NOT use Read for analysis (use execute_file). Read IS correct for files you intend to Edit.
     - DO NOT use WebFetch (use ${t("ctx_fetch_and_index")} instead).
     - Bash is ONLY for git/mkdir/rm/mv/navigation.
+    - DO NOT use ${t("ctx_execute")} or ${t("ctx_execute_file")} to create, modify, or overwrite files.
+      ctx_execute is for data analysis, log processing, and computation only.
   </forbidden_actions>
 
+  <file_writing_policy>
+    ALWAYS use the native Write tool to create files and Edit tool to modify files.
+    NEVER use ${t("ctx_execute")}, ${t("ctx_execute_file")}, or Bash to write file content.
+    This applies to all file types: code, configs, plans, specs, YAML, JSON, markdown.
+  </file_writing_policy>
+
   <output_constraints>
     <word_limit>Keep your final response under 500 words.</word_limit>
     <artifact_policy>
-      Write artifacts (code, configs, PRDs) to FILES. NEVER return them as inline text.
+      Write artifacts (code, configs, PRDs) to FILES using the native Write tool. NEVER return them as inline text.
+      Use Edit tool for modifications to existing files.
       Return only: file path + 1-line description.
     </artifact_policy>
     <response_format>

package/hooks/session-snapshot.bundle.mjs

@@ -1,14 +1,14 @@
-function p(t,e){return t.length<=e?t:t.slice(0,Math.max(0,e-3))+"..."}function a(t){return t.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&apos;")}var G=2048,J=10;function q(t){if(t.length===0)return"";let e=new Map;for(let u of t){let l=u.data,i=e.get(l);i||(i={ops:new Map,last:""},e.set(l,i));let r;u.type==="file_write"?r="write":u.type==="file_read"?r="read":u.type==="file_edit"?r="edit":r=u.type,i.ops.set(r,(i.ops.get(r)??0)+1),i.last=r}let s=Array.from(e.entries()).slice(-J),c=["  <active_files>"];for(let[u,{ops:l,last:i}]of s){let r=Array.from(l.entries()).map(([f,d])=>`${f}:${d}`).join(",");c.push(`    <file path="${a(u)}" ops="${a(r)}" last="${a(i)}" />`)}return c.push("  </active_files>"),c.join(`
-`)}function z(t){if(t.length===0)return"";let e=[],n={};for(let i of t)try{let r=JSON.parse(i.data);typeof r.subject=="string"?e.push(r.subject):typeof r.taskId=="string"&&typeof r.status=="string"&&(n[r.taskId]=r.status)}catch{}if(e.length===0)return"";let s=new Set(["completed","deleted","failed"]),c=Object.keys(n).sort((i,r)=>Number(i)-Number(r)),u=[];for(let i=0;i<e.length;i++){let r=c[i],f=r?n[r]??"pending":"pending";s.has(f)||u.push(e[i])}if(u.length===0)return"";let l=["  <task_state>"];for(let i of u)l.push(`    - ${a(p(i,100))}`);return l.push("  </task_state>"),l.join(`
-`)}function K(t){if(t.length===0)return"";let e=new Set,n=["  <rules>"];for(let s of t){let c=s.data;e.has(c)||(e.add(c),s.type==="rule_content"?n.push(`    <rule_content>${a(p(s.data,400))}</rule_content>`):n.push(`    - ${a(p(s.data,200))}`))}return n.push("  </rules>"),n.join(`
-`)}function U(t){if(t.length===0)return"";let e=new Set,n=["  <decisions>"];for(let s of t){let c=s.data;e.has(c)||(e.add(c),n.push(`    - ${a(p(s.data,200))}`))}return n.push("  </decisions>"),n.join(`
-`)}function V(t,e,n){let s=[];if(!t&&e.length===0&&!n)return"";s.push("  <environment>"),t&&s.push(`    <cwd>${a(t.data)}</cwd>`),n&&s.push(`    <git op="${a(n.data)}" />`);for(let c of e)s.push(`    <env>${a(p(c.data,150))}</env>`);return s.push("  </environment>"),s.join(`
-`)}function Y(t){if(t.length===0)return"";let e=["  <errors_encountered>"];for(let n of t)e.push(`    - ${a(p(n.data,150))}`);return e.push("  </errors_encountered>"),e.join(`
-`)}function H(t){return`  <intent mode="${a(t.data)}">${a(p(t.data,100))}</intent>`}function N(t){if(t.length===0)return"";let e=["  <subagents>"];for(let n of t){let s=n.type==="subagent_completed"?"completed":n.type==="subagent_launched"?"launched":"unknown";e.push(`    <agent status="${s}">${a(p(n.data,200))}</agent>`)}return e.push("  </subagents>"),e.join(`
+function l(t,e){return t.length<=e?t:t.slice(0,Math.max(0,e-3))+"..."}function a(t){return t.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&apos;")}var G=2048,J=10;function q(t){if(t.length===0)return"";let e=new Map;for(let u of t){let p=u.data,i=e.get(p);i||(i={ops:new Map,last:""},e.set(p,i));let r;u.type==="file_write"?r="write":u.type==="file_read"?r="read":u.type==="file_edit"?r="edit":r=u.type,i.ops.set(r,(i.ops.get(r)??0)+1),i.last=r}let s=Array.from(e.entries()).slice(-J),c=["  <active_files>"];for(let[u,{ops:p,last:i}]of s){let r=Array.from(p.entries()).map(([f,g])=>`${f}:${g}`).join(",");c.push(`    <file path="${a(u)}" ops="${a(r)}" last="${a(i)}" />`)}return c.push("  </active_files>"),c.join(`
+`)}function z(t){if(t.length===0)return"";let e=[],n={};for(let i of t)try{let r=JSON.parse(i.data);typeof r.subject=="string"?e.push(r.subject):typeof r.taskId=="string"&&typeof r.status=="string"&&(n[r.taskId]=r.status)}catch{}if(e.length===0)return"";let s=new Set(["completed","deleted","failed"]),c=Object.keys(n).sort((i,r)=>Number(i)-Number(r)),u=[];for(let i=0;i<e.length;i++){let r=c[i],f=r?n[r]??"pending":"pending";s.has(f)||u.push(e[i])}if(u.length===0)return"";let p=["  <task_state>"];for(let i of u)p.push(`    - ${a(l(i,100))}`);return p.push("  </task_state>"),p.join(`
+`)}function U(t){if(t.length===0)return"";let e=new Set,n=["  <rules>"];for(let s of t){let c=s.data;e.has(c)||(e.add(c),s.type==="rule_content"?n.push(`    <rule_content>${a(l(s.data,400))}</rule_content>`):n.push(`    - ${a(l(s.data,200))}`))}return n.push("  </rules>"),n.join(`
+`)}function V(t){if(t.length===0)return"";let e=new Set,n=["  <decisions>"];for(let s of t){let c=s.data;e.has(c)||(e.add(c),n.push(`    - ${a(l(s.data,200))}`))}return n.push("  </decisions>"),n.join(`
+`)}function Y(t,e,n){let s=[];if(!t&&e.length===0&&!n)return"";s.push("  <environment>"),t&&s.push(`    <cwd>${a(t.data)}</cwd>`),n&&s.push(`    <git op="${a(n.data)}" />`);for(let c of e)s.push(`    <env>${a(l(c.data,150))}</env>`);return s.push("  </environment>"),s.join(`
+`)}function H(t){if(t.length===0)return"";let e=["  <errors_encountered>"];for(let n of t)e.push(`    - ${a(l(n.data,150))}`);return e.push("  </errors_encountered>"),e.join(`
+`)}function K(t){return`  <intent mode="${a(t.data)}">${a(l(t.data,100))}</intent>`}function P(t){if(t.length===0)return"";let e=["  <subagents>"];for(let n of t){let s=n.type==="subagent_completed"?"completed":n.type==="subagent_launched"?"launched":"unknown";e.push(`    <agent status="${s}">${a(l(n.data,200))}</agent>`)}return e.push("  </subagents>"),e.join(`
 `)}function Q(t){if(t.length===0)return"";let e=new Map;for(let s of t){let c=s.data.split(":")[0].trim();e.set(c,(e.get(c)??0)+1)}let n=["  <mcp_tools>"];for(let[s,c]of e)n.push(`    <tool name="${a(s)}" calls="${c}" />`);return n.push("  </mcp_tools>"),n.join(`
-`)}function et(t,e){let n=e?.maxBytes??G,s=e?.compactCount??1,c=new Date().toISOString(),u=[],l=[],i=[],r=[],f=[],d=[],_=[],h=[],k=[],b=[],B=[],S=[];for(let o of t)switch(o.category){case"file":u.push(o);break;case"task":l.push(o);break;case"rule":i.push(o);break;case"decision":r.push(o);break;case"cwd":f.push(o);break;case"error":d.push(o);break;case"env":_.push(o);break;case"git":h.push(o);break;case"subagent":k.push(o);break;case"intent":b.push(o);break;case"mcp":B.push(o);break;case"plan":S.push(o);break}let m=[],w=q(u);w&&m.push(w);let x=z(l);x&&m.push(x);let L=K(i);L&&m.push(L);let g=[],j=U(r);j&&g.push(j);let P=f.length>0?f[f.length-1]:void 0,R=h.length>0?h[h.length-1]:void 0,M=V(P,_,R);M&&g.push(M);let I=Y(d);I&&g.push(I);let D=k.filter(o=>o.type==="subagent_completed"),T=N(D);T&&g.push(T),S.length>0&&S[S.length-1].type==="plan_enter"&&g.push('  <plan_mode status="active" />');let v=[];if(b.length>0){let o=b[b.length-1];v.push(H(o))}let O=Q(B);O&&v.push(O);let X=k.filter(o=>o.type==="subagent_launched"),A=N(X);A&&v.push(A);let E=`<session_resume compact_count="${s}" events_captured="${t.length}" generated_at="${c}">`,$="</session_resume>",C=[m,g,v];for(let o=C.length;o>=0;o--){let F=C.slice(0,o).flat().join(`
-`),y;if(F?y=`${E}
-${F}
-${$}`:y=`${E}
-${$}`,Buffer.byteLength(y)<=n)return y}return`${E}
-${$}`}export{et as buildResumeSnapshot,q as renderActiveFiles,U as renderDecisions,V as renderEnvironment,Y as renderErrors,H as renderIntent,Q as renderMcpTools,K as renderRules,N as renderSubagents,z as renderTaskState};
+`)}function et(t,e){let n=e?.maxBytes??G,s=e?.compactCount??1,c=new Date().toISOString(),u=[],p=[],i=[],r=[],f=[],g=[],$=[],h=[],E=[],S=[],w=[],m=[];for(let o of t)switch(o.category){case"file":u.push(o);break;case"task":p.push(o);break;case"rule":i.push(o);break;case"decision":r.push(o);break;case"cwd":f.push(o);break;case"error":g.push(o);break;case"env":$.push(o);break;case"git":h.push(o);break;case"subagent":E.push(o);break;case"intent":S.push(o);break;case"mcp":w.push(o);break;case"plan":m.push(o);break}let b=[],x=q(u);x&&b.push(x);let B=z(p);B&&b.push(B);let j=U(i);j&&b.push(j);let d=[],I=V(r);I&&d.push(I);let R=f.length>0?f[f.length-1]:void 0,F=h.length>0?h[h.length-1]:void 0,L=Y(R,$,F);L&&d.push(L);let M=H(g);M&&d.push(M);let D=E.filter(o=>o.type==="subagent_completed"),O=P(D);O&&d.push(O),m.length>0&&m[m.length-1].type==="plan_enter"&&d.push('  <plan_mode status="active" />');let v=[];if(S.length>0){let o=S[S.length-1];v.push(K(o))}let T=Q(w);T&&v.push(T);let X=E.filter(o=>o.type==="subagent_launched"),A=P(X);A&&v.push(A);let _=`<session_resume compact_count="${s}" events_captured="${t.length}" generated_at="${c}">`,k="</session_resume>",C=[b,d,v];for(let o=C.length;o>=0;o--){let N=C.slice(0,o).flat().join(`
+`),y;if(N?y=`${_}
+${N}
+${k}`:y=`${_}
+${k}`,Buffer.byteLength(y)<=n)return y}return`${_}
+${k}`}export{et as buildResumeSnapshot,q as renderActiveFiles,V as renderDecisions,Y as renderEnvironment,H as renderErrors,K as renderIntent,Q as renderMcpTools,U as renderRules,P as renderSubagents,z as renderTaskState};

package/hooks/sessionstart.mjs

@@ -24,7 +24,7 @@ import { writeSessionEventsFile, buildSessionDirective, getSessionEvents, getLat
 import { createSessionLoaders } from "./session-loaders.mjs";
 import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
-import { readFileSync, writeFileSync, unlinkSync } from "node:fs";
+import { readFileSync, writeFileSync, unlinkSync, readdirSync, rmSync, statSync } from "node:fs";
 import { homedir } from "node:os";
 
 // Resolve absolute path for imports (fileURLToPath for Windows compat)
@@ -120,6 +120,30 @@ try {
     }
 
     db.close();
+
+    // Age-gated lazy cleanup of old plugin cache version dirs (#181).
+    // Only delete dirs older than 1 hour to avoid breaking active sessions.
+    try {
+      const pluginRoot = process.env.CLAUDE_PLUGIN_ROOT;
+      if (pluginRoot) {
+        const cacheParentMatch = pluginRoot.match(/^(.*[\\/]plugins[\\/]cache[\\/][^\\/]+[\\/][^\\/]+[\\/])/);
+        if (cacheParentMatch) {
+          const cacheParent = cacheParentMatch[1];
+          const myDir = pluginRoot.replace(cacheParent, "").replace(/[\\/]/g, "");
+          const ONE_HOUR = 3600000;
+          const now = Date.now();
+          for (const d of readdirSync(cacheParent)) {
+            if (d === myDir) continue;
+            try {
+              const st = statSync(join(cacheParent, d));
+              if (now - st.mtimeMs > ONE_HOUR) {
+                rmSync(join(cacheParent, d), { recursive: true, force: true });
+              }
+            } catch { /* skip */ }
+          }
+        }
+      }
+    } catch { /* best effort — never block session start */ }
   }
   // "clear" — no action needed
 } catch (err) {

package/openclaw.plugin.json

@@ -3,7 +3,7 @@
   "name": "Context Mode",
   "kind": "tool",
   "description": "OpenClaw plugin that saves 98% of your context window. Sandboxed code execution in 11 languages, FTS5 knowledge base with BM25 ranking, and intent-driven search.",
-  "version": "1.0.53",
+  "version": "1.0.56",
   "sandbox": {
     "mode": "permissive",
     "filesystem_access": "full",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.53",
+  "version": "1.0.56",
   "type": "module",
   "description": "MCP plugin that saves 98% of your context window. Works with Claude Code, Gemini CLI, VS Code Copilot, OpenCode, and Codex CLI. Sandboxed code execution, FTS5 knowledge base, and intent-driven search.",
   "author": "Mert Koseoğlu",