context-mode 1.0.28 → 1.0.29

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Claude Code plugins by Mert Koseoğlu",
-    "version": "1.0.28"
+    "version": "1.0.29"
   },
   "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.28",
+      "version": "1.0.29",
       "author": {
         "name": "Mert Koseoğlu"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.28",
+  "version": "1.0.29",
   "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.28",
+  "version": "1.0.29",
   "sandbox": {
     "mode": "permissive",
     "filesystem_access": "full",

package/.openclaw-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.28",
+  "version": "1.0.29",
   "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

@@ -978,8 +978,35 @@ server.registerTool("ctx_fetch_and_index", {
             .string()
             .optional()
             .describe("Label for the indexed content (e.g., 'React useEffect docs', 'Supabase Auth API')"),
+        force: z
+            .boolean()
+            .optional()
+            .describe("Skip cache and re-fetch even if content was recently indexed"),
     }),
-}, async ({ url, source }) => {
+}, async ({ url, source, force }) => {
+    // TTL cache: if source was indexed within 24h, return cached hint
+    if (!force) {
+        const store = getStore();
+        const label = source ?? url;
+        const meta = store.getSourceMeta(label);
+        if (meta) {
+            const indexedAt = new Date(meta.indexedAt + "Z"); // SQLite datetime is UTC without Z
+            const ageMs = Date.now() - indexedAt.getTime();
+            const TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+            if (ageMs < TTL_MS) {
+                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";
+                return trackResponse("ctx_fetch_and_index", {
+                    content: [{
+                            type: "text",
+                            text: `Cached: **${meta.label}** — ${meta.chunkCount} sections, indexed ${ageStr} (fresh, TTL: 24h).\nTo refresh: call ctx_fetch_and_index again with \`force: true\`.\n\nYou MUST call search() to answer questions about this content — this cached response contains no content.\nUse: search(queries: [...], source: "${meta.label}")`,
+                        }],
+                });
+            }
+            // Stale (>24h) — fall through to re-fetch silently
+        }
+    }
     // Generate a unique temp file path for the subprocess to write fetched content.
     // This bypasses the executor's 100KB stdout truncation — content goes file→handler directly.
     const outputPath = join(tmpdir(), `ctx-fetch-${Date.now()}-${Math.random().toString(36).slice(2)}.dat`);

package/build/store.d.ts

@@ -41,6 +41,12 @@ export declare class ContentStore {
     searchTrigram(query: string, limit?: number, source?: string, mode?: "AND" | "OR", contentType?: "code" | "prose"): SearchResult[];
     fuzzyCorrect(query: string): string | null;
     searchWithFallback(query: string, limit?: number, source?: string, contentType?: "code" | "prose"): SearchResult[];
+    getSourceMeta(label: string): {
+        label: string;
+        chunkCount: number;
+        codeChunkCount: number;
+        indexedAt: string;
+    } | null;
     listSources(): Array<{
         label: string;
         chunkCount: number;

package/build/store.js

@@ -194,6 +194,7 @@ export class ContentStore {
     #stmtSourceChunkCount;
     #stmtChunkContent;
     #stmtStats;
+    #stmtSourceMeta;
     constructor(dbPath) {
         const Database = loadDatabase();
         this.#dbPath =
@@ -385,6 +386,7 @@ export class ContentStore {
        ORDER BY c.rowid`);
         this.#stmtSourceChunkCount = this.#db.prepare("SELECT chunk_count FROM sources WHERE id = ?");
         this.#stmtChunkContent = this.#db.prepare("SELECT content FROM chunks WHERE source_id = ?");
+        this.#stmtSourceMeta = this.#db.prepare("SELECT label, chunk_count, code_chunk_count, indexed_at FROM sources WHERE label = ?");
         this.#stmtStats = this.#db.prepare(`
       SELECT
         (SELECT COUNT(*) FROM sources) AS sources,
@@ -648,6 +650,12 @@ export class ContentStore {
         return [];
     }
     // ── Sources ──
+    getSourceMeta(label) {
+        const row = this.#stmtSourceMeta.get(label);
+        if (!row)
+            return null;
+        return { label: row.label, chunkCount: row.chunk_count, codeChunkCount: row.code_chunk_count, indexedAt: row.indexed_at };
+    }
     listSources() {
         return this.#stmtListSources.all();
     }