agentcache 0.2.0 → 0.2.4

package/README.md

@@ -58,8 +58,8 @@ No `init`. No `setup`. No config. No second command. The install itself:
 
 ### The Cycle
 
-1. **Session starts** — agent calls `agentcache_inject_context` → gets compiled rules, lessons, decisions
-2. **During session** — agent calls `agentcache_compile_submit` incrementally as it learns things
+1. **Session starts** — agent calls `inject_context` → gets compiled rules, lessons, decisions
+2. **During session** — agent calls `compile_submit` incrementally as it learns things
 3. **Session ends** — knowledge is already saved. If agent didn't submit (abrupt exit), transcript recovery handles it next session.
 
 ### Knowledge Types
@@ -75,18 +75,18 @@ Rules and lessons are **global** — they apply to all your projects. Decisions
 
 ## MCP Tools
 
-AgentCache exposes 8 tools via the Model Context Protocol:
+AgentCache exposes 8 tools via the Model Context Protocol (prefixed as `mcp--agentcache--<tool>` in IDEs):
 
 | Tool | Purpose |
 |------|---------|
-| `agentcache_inject_context` | Load compiled knowledge at session start |
-| `agentcache_compile_submit` | Submit observations incrementally during session |
-| `agentcache_compile_cluster` | Resolve clustering when observations overlap existing knowledge |
-| `agentcache_compile_extract` | Process queued transcripts from previous sessions |
-| `agentcache_enforce` | Check tool calls against enforced policy rules |
-| `agentcache_save_observation` | Save a permanent observation (USER authority, never auto-deprecated) |
-| `agentcache_get_knowledge` | Query the knowledge database |
-| `agentcache_deprecate_knowledge` | Mark knowledge as deprecated when it's no longer valid |
+| `inject_context` | Load compiled knowledge at session start |
+| `compile_submit` | Submit observations incrementally during session |
+| `compile_cluster` | Resolve clustering when observations overlap existing knowledge |
+| `compile_extract` | Process queued transcripts from previous sessions |
+| `enforce` | Check tool calls against enforced policy rules |
+| `save_observation` | Save a permanent observation (USER authority, never auto-deprecated) |
+| `get_knowledge` | Query the knowledge database |
+| `deprecate_knowledge` | Mark knowledge as deprecated when it's no longer valid |
 
 ## CLI Commands
 

package/dist/{chunk-LDQPTAZ7.js → chunk-H3S3HDHK.js}

@@ -90,14 +90,14 @@ function isVscodeExtensionIde(ide) {
   return ide.name === "Roo Code" || ide.name === "Continue";
 }
 var ALL_TOOLS = [
-  "agentcache_inject_context",
-  "agentcache_compile_submit",
-  "agentcache_compile_cluster",
-  "agentcache_compile_extract",
-  "agentcache_enforce",
-  "agentcache_save_observation",
-  "agentcache_get_knowledge",
-  "agentcache_deprecate_knowledge"
+  "inject_context",
+  "compile_submit",
+  "compile_cluster",
+  "compile_extract",
+  "enforce",
+  "save_observation",
+  "get_knowledge",
+  "deprecate_knowledge"
 ];
 function registerMcpServer(ide) {
   if (!ide.detected) return false;
@@ -149,18 +149,16 @@ function registerClaudeCode() {
     }
     if (!settings.permissions) settings.permissions = {};
     if (!settings.permissions.allow) settings.permissions.allow = [];
-    const allowList = settings.permissions.allow;
+    let allowList = settings.permissions.allow;
+    allowList = allowList.filter((p) => !p.startsWith("mcp__agentcache__loop_") && !p.startsWith("mcp__agentcache__agentcache_"));
+    settings.permissions.allow = allowList;
     const mcpPerms = ALL_TOOLS.map((t) => `mcp__agentcache__${t}`);
-    let permsUpdated = false;
     for (const perm of mcpPerms) {
       if (!allowList.includes(perm)) {
         allowList.push(perm);
-        permsUpdated = true;
       }
     }
-    if (permsUpdated) {
-      writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
-    }
+    writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
   }
   return serverRegistered;
 }
@@ -184,35 +182,28 @@ function registerMcpJson(ide) {
       alwaysAllow: ALL_TOOLS,
       disabled: false
     };
-  } else if (!existing) {
+  } else {
     const agentcacheBin = findAgentcacheScript();
     config.mcpServers.agentcache = {
       command: agentcacheBin,
-      args: ["serve"]
+      args: ["serve"],
+      alwaysAllow: ALL_TOOLS
     };
-  } else {
-    return false;
   }
   mkdirSync(dirname(ide.mcpConfigPath), { recursive: true });
   writeFileSync(ide.mcpConfigPath, JSON.stringify(config, null, 2));
-  return !existing;
+  return true;
 }
 function registerContinue(ide) {
   const configPath = ide.mcpConfigPath;
-  if (existsSync2(configPath)) {
-    try {
-      const existing = JSON.parse(readFileSync(configPath, "utf-8"));
-      if (existing.mcpServers?.agentcache) return false;
-    } catch {
-    }
-  }
   const nodeBin = findNodeBinary();
   const script = findAgentcacheScript();
   const config = {
     mcpServers: {
       agentcache: {
         command: nodeBin,
-        args: [script, "serve"]
+        args: [script, "serve"],
+        alwaysAllow: ALL_TOOLS
       }
     }
   };

package/dist/cli.js

@@ -5,7 +5,7 @@ import { Command } from "commander";
 var program = new Command();
 program.name("agentcache").description("Engineering Knowledge Compiler \u2014 universal, zero-config").version("0.3.0");
 program.command("setup").description("Detect IDEs and register AgentCache (runs automatically on install)").action(async () => {
-  const { runSetup } = await import("./setup-YCFTG2KT.js");
+  const { runSetup } = await import("./setup-TVSEXURZ.js");
   await runSetup();
 });
 program.command("serve").description("Start AgentCache MCP server (spawned by IDEs automatically)").action(async () => {

package/dist/mcp.js

@@ -570,7 +570,7 @@ async function startMcpServer() {
     { name: "agentcache", version: "0.1.0" },
     {
       capabilities: { tools: {} },
-      instructions: "AgentCache is your knowledge cache. At the START of every session, call agentcache_inject_context to load compiled rules, lessons, decisions, and context. Submit observations INCREMENTALLY via agentcache_compile_submit as you learn them \u2014 do not wait until session end."
+      instructions: "AgentCache is your knowledge cache. At the START of every session, call inject_context to load compiled rules, lessons, decisions, and context. Submit observations INCREMENTALLY via compile_submit as you learn them \u2014 do not wait until session end."
     }
   );
   server.oninitialized = async () => {
@@ -582,7 +582,7 @@ async function startMcpServer() {
   server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
       {
-        name: "agentcache_inject_context",
+        name: "inject_context",
         description: "Get compiled engineering knowledge for this project. Returns global rules/lessons (apply everywhere) + project-specific decisions/context. Call this at the START of every session.",
         inputSchema: {
           type: "object",
@@ -593,7 +593,7 @@ async function startMcpServer() {
         }
       },
       {
-        name: "agentcache_compile_submit",
+        name: "compile_submit",
         description: "Submit observations extracted from your session. Call this INCREMENTALLY \u2014 each time you learn a rule, lesson, decision, or context item. Do NOT batch until end of session; sessions can terminate without warning.",
         inputSchema: {
           type: "object",
@@ -619,12 +619,12 @@ async function startMcpServer() {
         }
       },
       {
-        name: "agentcache_compile_cluster",
-        description: "Submit clustering decisions when agentcache_compile_submit returns needs_clustering. Determines whether observations create new knowledge or relate to existing items.",
+        name: "compile_cluster",
+        description: "Submit clustering decisions when compile_submit returns needs_clustering. Determines whether observations create new knowledge or relate to existing items.",
         inputSchema: {
           type: "object",
           properties: {
-            sessionId: { type: "string", description: "Session ID from agentcache_compile_submit response" },
+            sessionId: { type: "string", description: "Session ID from compile_submit response" },
             clusters: {
               type: "array",
               items: {
@@ -644,8 +644,8 @@ async function startMcpServer() {
         }
       },
       {
-        name: "agentcache_compile_extract",
-        description: "For PREVIOUS sessions stored as transcript files. Reads a queued transcript and returns an extraction prompt for you to process. After processing, call agentcache_compile_submit with the results.",
+        name: "compile_extract",
+        description: "For PREVIOUS sessions stored as transcript files. Reads a queued transcript and returns an extraction prompt for you to process. After processing, call compile_submit with the results.",
         inputSchema: {
           type: "object",
           properties: {
@@ -655,7 +655,7 @@ async function startMcpServer() {
         }
       },
       {
-        name: "agentcache_enforce",
+        name: "enforce",
         description: "Check if a tool call is allowed by AgentCache policy rules. Call this BEFORE executing risky operations (file deletions, force pushes, etc). Returns allow or block with reason.",
         inputSchema: {
           type: "object",
@@ -668,7 +668,7 @@ async function startMcpServer() {
         }
       },
       {
-        name: "agentcache_save_observation",
+        name: "save_observation",
         description: "Save a single observation immediately with USER authority (never overwritten by compiler). Use for important rules or decisions that should persist permanently.",
         inputSchema: {
           type: "object",
@@ -683,7 +683,7 @@ async function startMcpServer() {
         }
       },
       {
-        name: "agentcache_get_knowledge",
+        name: "get_knowledge",
         description: "Query knowledge items from AgentCache knowledge database.",
         inputSchema: {
           type: "object",
@@ -697,7 +697,7 @@ async function startMcpServer() {
         }
       },
       {
-        name: "agentcache_deprecate_knowledge",
+        name: "deprecate_knowledge",
         description: "Mark a knowledge item as deprecated. Use when a rule, lesson, or decision is no longer valid. Works on both auto-compiled and user-saved items.",
         inputSchema: {
           type: "object",
@@ -719,7 +719,7 @@ async function startMcpServer() {
     const detectedProject = getResolvedProjectId();
     try {
       switch (request.params.name) {
-        case "agentcache_inject_context": {
+        case "inject_context": {
           const args = request.params.arguments || {};
           const project = args.project || detectedProject;
           const items = repo.getKnowledgeForContext(project);
@@ -742,15 +742,20 @@ async function startMcpServer() {
           }
           if (!output) output = "No compiled knowledge yet. This will populate as you use AgentCache across sessions.\n";
           const pendingCount = repo.getPendingCount();
-          if (pendingCount > 0) {
-            output = `<!-- ${pendingCount} previous session(s) pending compilation. Call agentcache_compile_extract to process. -->
-
-` + output;
+          if (pendingCount > 20) {
+            output += `
+---
+KNOWLEDGE COMPILATION AVAILABLE: You have ${pendingCount} past sessions that haven't been compiled into knowledge yet. Ask the user: "I can compile knowledge from your past ${pendingCount} sessions (~60s). Process now or later?" If they agree, call compile_extract up to 5 times, submitting results with compile_submit after each. If they decline, move on.
+`;
+          } else if (pendingCount > 0) {
+            output += `
+<!-- ${pendingCount} session(s) pending compilation (below threshold, will process when backlog grows). -->
+`;
           }
-          output += "\n---\nIMPORTANT: Submit observations incrementally as they happen during this session.\nWhen you learn something (rule, lesson, decision, context), call agentcache_compile_submit immediately.\nDo NOT wait until the end \u2014 sessions can terminate without warning.\n";
+          output += "\n---\nIMPORTANT: Submit observations incrementally as they happen during this session.\nWhen you learn something (rule, lesson, decision, context), call compile_submit immediately.\nDo NOT wait until the end \u2014 sessions can terminate without warning.\n";
           return { content: [{ type: "text", text: output.trim() }] };
         }
-        case "agentcache_compile_submit": {
+        case "compile_submit": {
           const args = request.params.arguments;
           const project = args.project || detectedProject;
           const sessionId = `sess_${randomUUID4().slice(0, 8)}`;
@@ -768,14 +773,14 @@ async function startMcpServer() {
             content: [{ type: "text", text: JSON.stringify({ status: "needs_clustering", sessionId: result.sessionId, clusteringContext: result.clusteringPrompt }) }]
           };
         }
-        case "agentcache_compile_cluster": {
+        case "compile_cluster": {
           const args = request.params.arguments;
           const project = args.project || detectedProject;
           const responseText = JSON.stringify({ clusters: args.clusters });
           const result = processClustering(repo, responseText, args.sessionId, project, projectRoot);
           return { content: [{ type: "text", text: JSON.stringify({ status: "complete", diagnostics: result.diagnostics }) }] };
         }
-        case "agentcache_compile_extract": {
+        case "compile_extract": {
           const args = request.params.arguments || {};
           const entry = repo.popPendingTranscript();
           if (!entry) {
@@ -793,14 +798,14 @@ async function startMcpServer() {
           const state = startCompile(events, sessionId, project, entry.projectRoot || projectRoot, repo, entry.transcriptPath);
           return { content: [{ type: "text", text: JSON.stringify({ sessionId: state.sessionId, prompt: state.prompt }) }] };
         }
-        case "agentcache_enforce": {
+        case "enforce": {
           const args = request.params.arguments;
           const project = args.project || detectedProject;
           const input = { tool_name: args.tool_name, tool_input: args.tool_input || {} };
           const result = evaluatePolicy(input, repo.getEnforcedRules(project));
           return { content: [{ type: "text", text: JSON.stringify(result) }] };
         }
-        case "agentcache_save_observation": {
+        case "save_observation": {
           const args = request.params.arguments;
           const project = args.project || detectedProject;
           const scope = args.scope || defaultScope(args.type);
@@ -849,7 +854,7 @@ async function startMcpServer() {
           });
           return { content: [{ type: "text", text: JSON.stringify({ saved: true, scope }) }] };
         }
-        case "agentcache_get_knowledge": {
+        case "get_knowledge": {
           const args = request.params.arguments || {};
           const project = args.project || detectedProject;
           const items = repo.getKnowledgeItems(project, {
@@ -860,7 +865,7 @@ async function startMcpServer() {
           const summary = filtered.map((i) => `[${i.id}] [${i.scope}/${i.confidence}] (${i.type}) ${i.content}`).join("\n");
           return { content: [{ type: "text", text: summary || "No knowledge items found." }] };
         }
-        case "agentcache_deprecate_knowledge": {
+        case "deprecate_knowledge": {
           const args = request.params.arguments;
           const item = repo.getKnowledgeItem(args.id);
           if (!item) {

package/dist/postinstall.js

@@ -2,7 +2,7 @@ import {
   detectInstalledIdes,
   registerClaudeHooks,
   registerMcpServer
-} from "./chunk-LDQPTAZ7.js";
+} from "./chunk-H3S3HDHK.js";
 import {
   getDataDir,
   getDbPath,

package/dist/{setup-YCFTG2KT.js → setup-TVSEXURZ.js}

@@ -2,7 +2,7 @@ import {
   detectInstalledIdes,
   registerClaudeHooks,
   registerMcpServer
-} from "./chunk-LDQPTAZ7.js";
+} from "./chunk-H3S3HDHK.js";
 import {
   getDataDir,
   getDbPath,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentcache",
-  "version": "0.2.0",
+  "version": "0.2.4",
   "description": "Knowledge cache for AI agents — learns how you work, remembers across sessions, works everywhere",
   "type": "module",
   "license": "MIT",