context-mode 1.0.32 → 1.0.34

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Claude Code plugins by Mert Koseoğlu",
-    "version": "1.0.32"
+    "version": "1.0.34"
   },
   "plugins": [
     {
       "name": "context-mode",
       "source": "./",
       "description": "Claude Code MCP 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.32",
+      "version": "1.0.34",
       "author": {
         "name": "Mert Koseoğlu"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.32",
+  "version": "1.0.34",
   "description": "MCP server that saves 98% of your context window with session continuity. Sandboxed code execution in 11 languages, FTS5 knowledge base with BM25 ranking, and automatic state restore across compactions.",
   "author": {
     "name": "Mert Koseoğlu",

package/.openclaw-plugin/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.32",
+  "version": "1.0.34",
   "sandbox": {
     "mode": "permissive",
     "filesystem_access": "full",

package/.openclaw-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.32",
+  "version": "1.0.34",
   "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.",
   "author": {
     "name": "Mert Koseoğlu",

package/build/server.js

@@ -115,6 +115,8 @@ const sessionStats = {
     bytesReturned: {},
     bytesIndexed: 0,
     bytesSandboxed: 0, // network I/O consumed inside sandbox (never enters context)
+    cacheHits: 0,
+    cacheBytesSaved: 0, // bytes avoided by TTL cache hits
     sessionStart: Date.now(),
 };
 function trackResponse(toolName, response) {
@@ -802,7 +804,8 @@ function coerceCommandsArray(val) {
 }
 server.registerTool("ctx_search", {
     title: "Search Indexed Content",
-    description: "Search indexed content. Pass ALL search questions as queries array in ONE call.\n\n" +
+    description: "Search indexed content. Requires prior indexing via ctx_batch_execute, ctx_index, or ctx_fetch_and_index. " +
+        "Pass ALL search questions as queries array in ONE call.\n\n" +
         "TIPS: 2-4 specific terms per query. Use 'source' to scope results.",
     inputSchema: z.object({
         queries: z.preprocess(coerceJsonArray, z
@@ -826,6 +829,23 @@ server.registerTool("ctx_search", {
 }, async (params) => {
     try {
         const store = getStore();
+        // Guard: redirect when the index is empty — ctx_search is a follow-up
+        // tool that requires prior indexing. Guide the model to the right tool.
+        if (store.getStats().chunks === 0) {
+            return trackResponse("ctx_search", {
+                content: [{
+                        type: "text",
+                        text: "Knowledge base is empty — no content has been indexed yet.\n\n" +
+                            "ctx_search is a follow-up tool that queries previously indexed content. " +
+                            "To gather and index content first, use:\n" +
+                            "  • ctx_batch_execute(commands, queries) — run commands, auto-index output, and search in one call\n" +
+                            "  • ctx_fetch_and_index(url) — fetch a URL, index it, then search with ctx_search\n" +
+                            "  • ctx_index(content, source) — manually index text content\n\n" +
+                            "After indexing, ctx_search becomes available for follow-up queries.",
+                    }],
+                isError: true,
+            });
+        }
         const raw = params;
         // Normalize: accept both query (string) and queries (array)
         const queryList = [];
@@ -1025,6 +1045,10 @@ server.registerTool("ctx_fetch_and_index", {
                 const ageHours = Math.floor(ageMs / (60 * 60 * 1000));
                 const ageMin = Math.floor(ageMs / (60 * 1000));
                 const ageStr = ageHours > 0 ? `${ageHours}h ago` : ageMin > 0 ? `${ageMin}m ago` : "just now";
+                // Track cache savings — estimate ~1.6KB per chunk (average indexed content size)
+                const estimatedBytes = meta.chunkCount * 1600;
+                sessionStats.cacheHits++;
+                sessionStats.cacheBytesSaved += estimatedBytes;
                 return trackResponse("ctx_fetch_and_index", {
                     content: [{
                             type: "text",
@@ -1366,6 +1390,17 @@ server.registerTool("ctx_stats", {
         if (keptOut > 0) {
             lines.push("", `Without context-mode, **${kb(totalProcessed)}** of raw output would flood your context window. Instead, **${reductionPct}%** stayed in sandbox.`);
         }
+        // Cache savings section
+        if (sessionStats.cacheHits > 0 || sessionStats.cacheBytesSaved > 0) {
+            const totalWithCache = totalProcessed + sessionStats.cacheBytesSaved;
+            const totalSavingsRatio = totalWithCache / Math.max(totalBytesReturned, 1);
+            const ttlHoursLeft = Math.max(0, 24 - Math.floor((Date.now() - sessionStats.sessionStart) / (60 * 60 * 1000)));
+            lines.push("", `### TTL Cache`, "", `| Metric | Value |`, `|--------|------:|`, `| Cache hits | **${sessionStats.cacheHits}** |`, `| Data avoided by cache | **${kb(sessionStats.cacheBytesSaved)}** |`, `| Network requests saved | **${sessionStats.cacheHits}** |`, `| TTL remaining | **~${ttlHoursLeft}h** |`, "", `Content was already indexed in the knowledge base — ${sessionStats.cacheHits} fetch${sessionStats.cacheHits > 1 ? "es" : ""} skipped entirely. **${kb(sessionStats.cacheBytesSaved)}** of network I/O avoided. Search results served directly from local FTS5 index.`);
+            // Update total savings to include cache
+            if (totalSavingsRatio > savingsRatio) {
+                lines.push("", `**Total context savings (sandbox + cache): ${totalSavingsRatio.toFixed(1)}x** — ${kb(totalWithCache)} processed, only ${kb(totalBytesReturned)} entered context.`);
+            }
+        }
     }
     // ── Session Continuity ──
     try {