engrm 0.4.41 → 0.4.43

package/README.md

@@ -110,6 +110,7 @@ Add this to `~/.engrm/settings.json`:
     "port": 3767,
     "bearer_tokens": ["replace-with-a-long-random-token"]
   },
+  "tool_profile": "memory",
   "fleet": {
     "project_name": "shared-experience",
     "namespace": "ns_fleet_shared",
@@ -139,12 +140,23 @@ Hermes should connect with a bearer token header:
 }
 ```
 
+If Hermes and OpenClaw run on the same machine, use `http://localhost:3767/mcp`.
+That is the correct MCP URL for same-host deployments.
+
+On macOS, watch out for mixed global npm prefixes. If you have both
+`~/.npm-global` and `/opt/homebrew` installs, make sure the long-running Engrm
+HTTP service points at the same package location that your `npm install -g`
+updates. A stale LaunchAgent path can keep serving an older Engrm build even
+after a successful npm upgrade.
+
 Fleet writes:
 - use the reserved project name `shared-experience` by default
 - stay `shared` unless explicitly overridden
 - sync to the dedicated fleet namespace/key instead of the normal org namespace
 - get an extra outbound scrub pass that redacts hostnames, IPs, and MACs before upload
 
+For Hermes-style shared learning deployments, set `"tool_profile": "memory"` to expose a reduced Engrm tool set focused on durable memory, recall, and thread resumption instead of the full developer-oriented surface.
+
 ---
 
 ## How It Works
@@ -655,7 +667,7 @@ Engrm auto-registers in:
 - **Local storage:** SQLite via `better-sqlite3`, FTS5 full-text search, `sqlite-vec` for embeddings
 - **Embeddings:** all-MiniLM-L6-v2 via `@xenova/transformers` (384 dims, ~23MB)
 - **Remote backend:** Candengo Vector (BGE-M3, Qdrant, hybrid dense+sparse search)
-- **MCP:** `@modelcontextprotocol/sdk` (stdio transport)
+- **MCP:** `@modelcontextprotocol/sdk` (stdio for local agents, Streamable HTTP + SSE compatibility for Hermes-style remote clients)
 - **AI extraction:** `@anthropic-ai/claude-agent-sdk` (optional, for richer observations)
 
 ---

package/dist/cli.js

@@ -114,7 +114,8 @@ function createDefaultConfig() {
       project_name: "shared-experience",
       namespace: "",
       api_key: ""
-    }
+    },
+    tool_profile: "full"
   };
 }
 function loadConfig() {
@@ -185,7 +186,8 @@ function loadConfig() {
       project_name: asString(config["fleet"]?.["project_name"], defaults.fleet.project_name),
       namespace: asString(config["fleet"]?.["namespace"], defaults.fleet.namespace),
       api_key: asString(config["fleet"]?.["api_key"], defaults.fleet.api_key)
-    }
+    },
+    tool_profile: asToolProfile(config["tool_profile"], defaults.tool_profile)
   };
 }
 function saveConfig(config) {
@@ -240,6 +242,11 @@ function asObserverMode(value, fallback) {
     return value;
   return fallback;
 }
+function asToolProfile(value, fallback) {
+  if (value === "full" || value === "memory")
+    return value;
+  return fallback;
+}
 function asTeams(value, fallback) {
   if (!Array.isArray(value))
     return fallback;
@@ -4006,7 +4013,8 @@ function createDefaultConfig2() {
       project_name: "shared-experience",
       namespace: "",
       api_key: ""
-    }
+    },
+    tool_profile: "full"
   };
 }
 function loadConfig2() {
@@ -4077,7 +4085,8 @@ function loadConfig2() {
       project_name: asString2(config["fleet"]?.["project_name"], defaults.fleet.project_name),
       namespace: asString2(config["fleet"]?.["namespace"], defaults.fleet.namespace),
       api_key: asString2(config["fleet"]?.["api_key"], defaults.fleet.api_key)
-    }
+    },
+    tool_profile: asToolProfile2(config["tool_profile"], defaults.tool_profile)
   };
 }
 function saveConfig2(config) {
@@ -4132,12 +4141,35 @@ function asObserverMode2(value, fallback) {
     return value;
   return fallback;
 }
+function asToolProfile2(value, fallback) {
+  if (value === "full" || value === "memory")
+    return value;
+  return fallback;
+}
 function asTeams2(value, fallback) {
   if (!Array.isArray(value))
     return fallback;
   return value.filter((t) => typeof t === "object" && t !== null && typeof t.id === "string" && typeof t.name === "string" && typeof t.namespace === "string");
 }
 
+// src/tool-profiles.ts
+var MEMORY_PROFILE_TOOLS = [
+  "save_observation",
+  "search_recall",
+  "resume_thread",
+  "list_recall_items",
+  "load_recall_item",
+  "recent_chat",
+  "search_chat",
+  "refresh_chat_recall",
+  "repair_recall"
+];
+function getEnabledToolNames(profile) {
+  if (!profile || profile === "full")
+    return null;
+  return new Set(MEMORY_PROFILE_TOOLS);
+}
+
 // src/tools/capture-status.ts
 var LEGACY_CODEX_SERVER_NAME2 = `candengo-${"mem"}`;
 function getCaptureStatus(db, input = {}) {
@@ -4242,6 +4274,8 @@ function getCaptureStatus(db, input = {}) {
     http_enabled: Boolean(config?.http?.enabled || process.env.ENGRM_HTTP_PORT),
     http_port: config?.http?.port ?? (process.env.ENGRM_HTTP_PORT ? Number(process.env.ENGRM_HTTP_PORT) : null),
     http_bearer_token_count: config?.http?.bearer_tokens?.length ?? 0,
+    tool_profile: config?.tool_profile ?? "full",
+    enabled_tool_count: config ? getEnabledToolNames(config.tool_profile)?.size ?? null : null,
     fleet_project_name: config?.fleet?.project_name ?? null,
     fleet_configured: Boolean(config?.fleet?.namespace && config?.fleet?.api_key),
     claude_mcp_registered: claudeMcpRegistered,
@@ -4724,6 +4758,7 @@ function handleStatus() {
   console.log(`    Sync:          ${config.sync.enabled ? "enabled" : "disabled"}`);
   console.log(`    HTTP MCP:      ${config.http.enabled ? `enabled (:${config.http.port})` : "disabled"}`);
   console.log(`    HTTP tokens:   ${config.http.bearer_tokens.length}`);
+  console.log(`    Tool profile:  ${config.tool_profile ?? "full"}`);
   console.log(`    Fleet project: ${config.fleet.project_name || "(not set)"}`);
   console.log(`    Fleet sync:    ${config.fleet.namespace && config.fleet.api_key ? "configured" : "not configured"}`);
   const claudeJson = join8(homedir5(), ".claude.json");
@@ -5083,6 +5118,7 @@ async function handleDoctor() {
   } else {
     info("HTTP MCP disabled");
   }
+  info(`Tool profile: ${config.tool_profile ?? "full"}`);
   if (config.fleet.project_name) {
     if (config.fleet.namespace && config.fleet.api_key) {
       pass(`Fleet project '${config.fleet.project_name}' is configured`);

package/dist/hooks/elicitation-result.js

@@ -986,7 +986,8 @@ function createDefaultConfig() {
       project_name: "shared-experience",
       namespace: "",
       api_key: ""
-    }
+    },
+    tool_profile: "full"
   };
 }
 function loadConfig() {
@@ -1057,7 +1058,8 @@ function loadConfig() {
       project_name: asString(config["fleet"]?.["project_name"], defaults.fleet.project_name),
       namespace: asString(config["fleet"]?.["namespace"], defaults.fleet.namespace),
       api_key: asString(config["fleet"]?.["api_key"], defaults.fleet.api_key)
-    }
+    },
+    tool_profile: asToolProfile(config["tool_profile"], defaults.tool_profile)
   };
 }
 function saveConfig(config) {
@@ -1112,6 +1114,11 @@ function asObserverMode(value, fallback) {
     return value;
   return fallback;
 }
+function asToolProfile(value, fallback) {
+  if (value === "full" || value === "memory")
+    return value;
+  return fallback;
+}
 function asTeams(value, fallback) {
   if (!Array.isArray(value))
     return fallback;

package/dist/hooks/post-tool-use.js

@@ -292,7 +292,8 @@ function createDefaultConfig() {
       project_name: "shared-experience",
       namespace: "",
       api_key: ""
-    }
+    },
+    tool_profile: "full"
   };
 }
 function loadConfig() {
@@ -363,7 +364,8 @@ function loadConfig() {
       project_name: asString(config["fleet"]?.["project_name"], defaults.fleet.project_name),
       namespace: asString(config["fleet"]?.["namespace"], defaults.fleet.namespace),
       api_key: asString(config["fleet"]?.["api_key"], defaults.fleet.api_key)
-    }
+    },
+    tool_profile: asToolProfile(config["tool_profile"], defaults.tool_profile)
   };
 }
 function saveConfig(config) {
@@ -418,6 +420,11 @@ function asObserverMode(value, fallback) {
     return value;
   return fallback;
 }
+function asToolProfile(value, fallback) {
+  if (value === "full" || value === "memory")
+    return value;
+  return fallback;
+}
 function asTeams(value, fallback) {
   if (!Array.isArray(value))
     return fallback;

package/dist/hooks/pre-compact.js

@@ -86,7 +86,8 @@ function createDefaultConfig() {
       project_name: "shared-experience",
       namespace: "",
       api_key: ""
-    }
+    },
+    tool_profile: "full"
   };
 }
 function loadConfig() {
@@ -157,7 +158,8 @@ function loadConfig() {
       project_name: asString(config["fleet"]?.["project_name"], defaults.fleet.project_name),
       namespace: asString(config["fleet"]?.["namespace"], defaults.fleet.namespace),
       api_key: asString(config["fleet"]?.["api_key"], defaults.fleet.api_key)
-    }
+    },
+    tool_profile: asToolProfile(config["tool_profile"], defaults.tool_profile)
   };
 }
 function saveConfig(config) {
@@ -212,6 +214,11 @@ function asObserverMode(value, fallback) {
     return value;
   return fallback;
 }
+function asToolProfile(value, fallback) {
+  if (value === "full" || value === "memory")
+    return value;
+  return fallback;
+}
 function asTeams(value, fallback) {
   if (!Array.isArray(value))
     return fallback;

package/dist/hooks/sentinel.js

@@ -162,7 +162,8 @@ function createDefaultConfig() {
       project_name: "shared-experience",
       namespace: "",
       api_key: ""
-    }
+    },
+    tool_profile: "full"
   };
 }
 function loadConfig() {
@@ -233,7 +234,8 @@ function loadConfig() {
       project_name: asString(config["fleet"]?.["project_name"], defaults.fleet.project_name),
       namespace: asString(config["fleet"]?.["namespace"], defaults.fleet.namespace),
       api_key: asString(config["fleet"]?.["api_key"], defaults.fleet.api_key)
-    }
+    },
+    tool_profile: asToolProfile(config["tool_profile"], defaults.tool_profile)
   };
 }
 function saveConfig(config) {
@@ -288,6 +290,11 @@ function asObserverMode(value, fallback) {
     return value;
   return fallback;
 }
+function asToolProfile(value, fallback) {
+  if (value === "full" || value === "memory")
+    return value;
+  return fallback;
+}
 function asTeams(value, fallback) {
   if (!Array.isArray(value))
     return fallback;

package/dist/hooks/session-start.js

@@ -3266,7 +3266,7 @@ import { existsSync as existsSync3, readFileSync as readFileSync2, writeFileSync
 import { join as join3 } from "node:path";
 import { homedir } from "node:os";
 var STATE_PATH = join3(homedir(), ".engrm", "config-fingerprint.json");
-var CLIENT_VERSION = "0.4.41";
+var CLIENT_VERSION = "0.4.42";
 function hashFile(filePath) {
   try {
     if (!existsSync3(filePath))
@@ -3480,7 +3480,8 @@ function createDefaultConfig() {
       project_name: "shared-experience",
       namespace: "",
       api_key: ""
-    }
+    },
+    tool_profile: "full"
   };
 }
 function loadConfig() {
@@ -3551,7 +3552,8 @@ function loadConfig() {
       project_name: asString(config["fleet"]?.["project_name"], defaults.fleet.project_name),
       namespace: asString(config["fleet"]?.["namespace"], defaults.fleet.namespace),
       api_key: asString(config["fleet"]?.["api_key"], defaults.fleet.api_key)
-    }
+    },
+    tool_profile: asToolProfile(config["tool_profile"], defaults.tool_profile)
   };
 }
 function saveConfig(config) {
@@ -3606,6 +3608,11 @@ function asObserverMode(value, fallback) {
     return value;
   return fallback;
 }
+function asToolProfile(value, fallback) {
+  if (value === "full" || value === "memory")
+    return value;
+  return fallback;
+}
 function asTeams(value, fallback) {
   if (!Array.isArray(value))
     return fallback;
@@ -3905,6 +3912,7 @@ class VectorClient {
   apiKey;
   siteId;
   namespace;
+  timeoutMs;
   constructor(config, overrides = {}) {
     const baseUrl = getBaseUrl(config);
     const apiKey = overrides.apiKey ?? getApiKey(config);
@@ -3915,6 +3923,7 @@ class VectorClient {
     this.apiKey = apiKey;
     this.siteId = overrides.siteId ?? config.site_id;
     this.namespace = overrides.namespace ?? config.namespace;
+    this.timeoutMs = overrides.timeoutMs ?? 1e4;
   }
   static isConfigured(config) {
     return getApiKey(config) !== null && getBaseUrl(config) !== null;
@@ -3977,6 +3986,7 @@ class VectorClient {
     if (body && method !== "GET") {
       init.body = JSON.stringify(body);
     }
+    init.signal = AbortSignal.timeout(this.timeoutMs);
     const response = await fetch(url, init);
     if (!response.ok) {
       const text = await response.text().catch(() => "");

package/dist/hooks/stop.js

@@ -399,7 +399,8 @@ function createDefaultConfig() {
       project_name: "shared-experience",
       namespace: "",
       api_key: ""
-    }
+    },
+    tool_profile: "full"
   };
 }
 function loadConfig() {
@@ -470,7 +471,8 @@ function loadConfig() {
       project_name: asString(config["fleet"]?.["project_name"], defaults.fleet.project_name),
       namespace: asString(config["fleet"]?.["namespace"], defaults.fleet.namespace),
       api_key: asString(config["fleet"]?.["api_key"], defaults.fleet.api_key)
-    }
+    },
+    tool_profile: asToolProfile(config["tool_profile"], defaults.tool_profile)
   };
 }
 function saveConfig(config) {
@@ -525,6 +527,11 @@ function asObserverMode(value, fallback) {
     return value;
   return fallback;
 }
+function asToolProfile(value, fallback) {
+  if (value === "full" || value === "memory")
+    return value;
+  return fallback;
+}
 function asTeams(value, fallback) {
   if (!Array.isArray(value))
     return fallback;
@@ -2271,6 +2278,7 @@ class VectorClient {
   apiKey;
   siteId;
   namespace;
+  timeoutMs;
   constructor(config, overrides = {}) {
     const baseUrl = getBaseUrl(config);
     const apiKey = overrides.apiKey ?? getApiKey(config);
@@ -2281,6 +2289,7 @@ class VectorClient {
     this.apiKey = apiKey;
     this.siteId = overrides.siteId ?? config.site_id;
     this.namespace = overrides.namespace ?? config.namespace;
+    this.timeoutMs = overrides.timeoutMs ?? 1e4;
   }
   static isConfigured(config) {
     return getApiKey(config) !== null && getBaseUrl(config) !== null;
@@ -2343,6 +2352,7 @@ class VectorClient {
     if (body && method !== "GET") {
       init.body = JSON.stringify(body);
     }
+    init.signal = AbortSignal.timeout(this.timeoutMs);
     const response = await fetch(url, init);
     if (!response.ok) {
       const text = await response.text().catch(() => "");
@@ -2811,7 +2821,7 @@ function buildSummaryVectorDocument(summary, config, project, targetOrObservatio
     }
   };
 }
-async function pushOutbox(db, config, batchSize = 50) {
+async function pushOutbox(db, config, batchSize = 50, options = {}) {
   const entries = getPendingEntries(db, batchSize);
   let pushed = 0;
   let failed = 0;
@@ -2922,7 +2932,8 @@ async function pushOutbox(db, config, batchSize = 50) {
     const client = new VectorClient(config, {
       apiKey: target.apiKey,
       namespace: target.namespace,
-      siteId: target.siteId
+      siteId: target.siteId,
+      timeoutMs: options.timeoutMs
     });
     try {
       await client.batchIngest(items.map((b) => b.doc));
@@ -3003,118 +3014,14 @@ function summarizeObservationSourceTools(observations) {
   });
 }
 
-// src/embeddings/embedder.ts
-var _available = null;
-var _pipeline = null;
-var MODEL_NAME = "Xenova/all-MiniLM-L6-v2";
-async function embedText(text) {
-  const pipe = await getPipeline();
-  if (!pipe)
-    return null;
-  try {
-    const output = await pipe(text, { pooling: "mean", normalize: true });
-    return new Float32Array(output.data);
-  } catch {
-    return null;
-  }
-}
-function composeEmbeddingText(obs) {
-  const parts = [obs.title];
-  if (obs.narrative)
-    parts.push(obs.narrative);
-  if (obs.facts) {
-    try {
-      const facts = JSON.parse(obs.facts);
-      if (Array.isArray(facts) && facts.length > 0) {
-        parts.push(facts.map((f) => `- ${f}`).join(`
-`));
-      }
-    } catch {
-      parts.push(obs.facts);
-    }
-  }
-  if (obs.concepts) {
-    try {
-      const concepts = JSON.parse(obs.concepts);
-      if (Array.isArray(concepts) && concepts.length > 0) {
-        parts.push(concepts.join(", "));
-      }
-    } catch {}
-  }
-  return parts.join(`
-
-`);
-}
-function composeChatEmbeddingText(text) {
-  return text.replace(/\s+/g, " ").trim().slice(0, 2000);
-}
-async function getPipeline() {
-  if (_pipeline)
-    return _pipeline;
-  if (_available === false)
-    return null;
-  try {
-    const { pipeline } = await import("@xenova/transformers");
-    _pipeline = await pipeline("feature-extraction", MODEL_NAME);
-    _available = true;
-    return _pipeline;
-  } catch (err) {
-    _available = false;
-    console.error(`[engrm] Local embedding model unavailable: ${err instanceof Error ? err.message : String(err)}`);
-    return null;
-  }
-}
-
-// src/sync/pull.ts
-async function pullSettings(client, config) {
-  try {
-    const settings = await client.fetchSettings();
-    if (!settings)
-      return false;
-    let changed = false;
-    if (settings.transcript_analysis !== undefined) {
-      const ta = settings.transcript_analysis;
-      if (typeof ta === "object" && ta !== null) {
-        const taObj = ta;
-        if (taObj.enabled !== undefined && taObj.enabled !== config.transcript_analysis.enabled) {
-          config.transcript_analysis.enabled = !!taObj.enabled;
-          changed = true;
-        }
-      }
-    }
-    if (settings.observer !== undefined) {
-      const obs = settings.observer;
-      if (typeof obs === "object" && obs !== null) {
-        const obsObj = obs;
-        if (obsObj.enabled !== undefined && obsObj.enabled !== config.observer.enabled) {
-          config.observer.enabled = !!obsObj.enabled;
-          changed = true;
-        }
-        if (obsObj.model !== undefined && typeof obsObj.model === "string" && obsObj.model !== config.observer.model) {
-          config.observer.model = obsObj.model;
-          changed = true;
-        }
-      }
-    }
-    if (changed) {
-      saveConfig(config);
-    }
-    return changed;
-  } catch {
-    return false;
-  }
-}
-
 // src/sync/push-once.ts
-async function pushOnce(db, config) {
+async function pushOnce(db, config, options = {}) {
   if (!config.sync.enabled)
     return 0;
   if (!VectorClient.isConfigured(config))
     return 0;
   try {
-    const client = new VectorClient(config);
-    const result = await pushOutbox(db, config, config.sync.batch_size);
-    await pullSettings(client, config);
+    const result = await pushOutbox(db, config, config.sync.batch_size, { timeoutMs: options.timeoutMs ?? 4000 });
     return result.pushed;
   } catch {
     return 0;
@@ -3338,7 +3245,7 @@ function buildBeacon(db, config, sessionId, metrics) {
     sentinel_used: valueSignals.security_findings_count > 0,
     risk_score: riskScore,
     stacks_detected: stacks,
-    client_version: "0.4.41",
+    client_version: "0.4.42",
     context_observations_injected: metrics?.contextObsInjected ?? 0,
     context_total_available: metrics?.contextTotalAvailable ?? 0,
     recall_attempts: metrics?.recallAttempts ?? 0,
@@ -3531,6 +3438,68 @@ import { readFileSync as readFileSync4, existsSync as existsSync4 } from "node:f
 import { join as join5 } from "node:path";
 import { homedir as homedir3 } from "node:os";
 
+// src/embeddings/embedder.ts
+var _available = null;
+var _pipeline = null;
+var MODEL_NAME = "Xenova/all-MiniLM-L6-v2";
+async function embedText(text) {
+  const pipe = await getPipeline();
+  if (!pipe)
+    return null;
+  try {
+    const output = await pipe(text, { pooling: "mean", normalize: true });
+    return new Float32Array(output.data);
+  } catch {
+    return null;
+  }
+}
+function composeEmbeddingText(obs) {
+  const parts = [obs.title];
+  if (obs.narrative)
+    parts.push(obs.narrative);
+  if (obs.facts) {
+    try {
+      const facts = JSON.parse(obs.facts);
+      if (Array.isArray(facts) && facts.length > 0) {
+        parts.push(facts.map((f) => `- ${f}`).join(`
+`));
+      }
+    } catch {
+      parts.push(obs.facts);
+    }
+  }
+  if (obs.concepts) {
+    try {
+      const concepts = JSON.parse(obs.concepts);
+      if (Array.isArray(concepts) && concepts.length > 0) {
+        parts.push(concepts.join(", "));
+      }
+    } catch {}
+  }
+  return parts.join(`
+
+`);
+}
+function composeChatEmbeddingText(text) {
+  return text.replace(/\s+/g, " ").trim().slice(0, 2000);
+}
+async function getPipeline() {
+  if (_pipeline)
+    return _pipeline;
+  if (_available === false)
+    return null;
+  try {
+    const { pipeline } = await import("@xenova/transformers");
+    _pipeline = await pipeline("feature-extraction", MODEL_NAME);
+    _available = true;
+    return _pipeline;
+  } catch (err) {
+    _available = false;
+    console.error(`[engrm] Local embedding model unavailable: ${err instanceof Error ? err.message : String(err)}`);
+    return null;
+  }
+}
+
 // src/tools/save.ts
 import { relative, isAbsolute } from "node:path";
 
@@ -4924,7 +4893,7 @@ async function main() {
         }
       } catch {}
     }
-    await pushOnce(db, config);
+    await pushOnce(db, config, { timeoutMs: 4000 });
     try {
       if (event.session_id) {
         const metrics = readSessionMetrics(event.session_id);

package/dist/hooks/user-prompt-submit.js

@@ -230,7 +230,8 @@ function createDefaultConfig() {
       project_name: "shared-experience",
       namespace: "",
       api_key: ""
-    }
+    },
+    tool_profile: "full"
   };
 }
 function loadConfig() {
@@ -301,7 +302,8 @@ function loadConfig() {
       project_name: asString(config["fleet"]?.["project_name"], defaults.fleet.project_name),
       namespace: asString(config["fleet"]?.["namespace"], defaults.fleet.namespace),
       api_key: asString(config["fleet"]?.["api_key"], defaults.fleet.api_key)
-    }
+    },
+    tool_profile: asToolProfile(config["tool_profile"], defaults.tool_profile)
   };
 }
 function saveConfig(config) {
@@ -356,6 +358,11 @@ function asObserverMode(value, fallback) {
     return value;
   return fallback;
 }
+function asToolProfile(value, fallback) {
+  if (value === "full" || value === "memory")
+    return value;
+  return fallback;
+}
 function asTeams(value, fallback) {
   if (!Array.isArray(value))
     return fallback;

package/dist/server.js

@@ -13643,7 +13643,8 @@ function createDefaultConfig() {
       project_name: "shared-experience",
       namespace: "",
       api_key: ""
-    }
+    },
+    tool_profile: "full"
   };
 }
 function loadConfig() {
@@ -13714,7 +13715,8 @@ function loadConfig() {
       project_name: asString(config2["fleet"]?.["project_name"], defaults.fleet.project_name),
       namespace: asString(config2["fleet"]?.["namespace"], defaults.fleet.namespace),
       api_key: asString(config2["fleet"]?.["api_key"], defaults.fleet.api_key)
-    }
+    },
+    tool_profile: asToolProfile(config2["tool_profile"], defaults.tool_profile)
   };
 }
 function saveConfig(config2) {
@@ -13769,6 +13771,11 @@ function asObserverMode(value, fallback) {
     return value;
   return fallback;
 }
+function asToolProfile(value, fallback) {
+  if (value === "full" || value === "memory")
+    return value;
+  return fallback;
+}
 function asTeams(value, fallback) {
   if (!Array.isArray(value))
     return fallback;
@@ -19471,6 +19478,26 @@ function getActivityFeed(db, input) {
 import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
 import { join as join3 } from "node:path";
+
+// src/tool-profiles.ts
+var MEMORY_PROFILE_TOOLS = [
+  "save_observation",
+  "search_recall",
+  "resume_thread",
+  "list_recall_items",
+  "load_recall_item",
+  "recent_chat",
+  "search_chat",
+  "refresh_chat_recall",
+  "repair_recall"
+];
+function getEnabledToolNames(profile) {
+  if (!profile || profile === "full")
+    return null;
+  return new Set(MEMORY_PROFILE_TOOLS);
+}
+
+// src/tools/capture-status.ts
 var LEGACY_CODEX_SERVER_NAME = `candengo-${"mem"}`;
 function getCaptureStatus(db, input = {}) {
   const hours = Math.max(1, Math.min(input.lookback_hours ?? 24, 24 * 30));
@@ -19574,6 +19601,8 @@ function getCaptureStatus(db, input = {}) {
     http_enabled: Boolean(config2?.http?.enabled || process.env.ENGRM_HTTP_PORT),
     http_port: config2?.http?.port ?? (process.env.ENGRM_HTTP_PORT ? Number(process.env.ENGRM_HTTP_PORT) : null),
     http_bearer_token_count: config2?.http?.bearer_tokens?.length ?? 0,
+    tool_profile: config2?.tool_profile ?? "full",
+    enabled_tool_count: config2 ? getEnabledToolNames(config2.tool_profile)?.size ?? null : null,
     fleet_project_name: config2?.fleet?.project_name ?? null,
     fleet_configured: Boolean(config2?.fleet?.namespace && config2?.fleet?.api_key),
     claude_mcp_registered: claudeMcpRegistered,
@@ -21598,6 +21627,7 @@ class VectorClient {
   apiKey;
   siteId;
   namespace;
+  timeoutMs;
   constructor(config2, overrides = {}) {
     const baseUrl = getBaseUrl(config2);
     const apiKey = overrides.apiKey ?? getApiKey(config2);
@@ -21608,6 +21638,7 @@ class VectorClient {
     this.apiKey = apiKey;
     this.siteId = overrides.siteId ?? config2.site_id;
     this.namespace = overrides.namespace ?? config2.namespace;
+    this.timeoutMs = overrides.timeoutMs ?? 1e4;
   }
   static isConfigured(config2) {
     return getApiKey(config2) !== null && getBaseUrl(config2) !== null;
@@ -21670,6 +21701,7 @@ class VectorClient {
     if (body && method !== "GET") {
       init.body = JSON.stringify(body);
     }
+    init.signal = AbortSignal.timeout(this.timeoutMs);
     const response = await fetch(url2, init);
     if (!response.ok) {
       const text = await response.text().catch(() => "");
@@ -21919,7 +21951,7 @@ function buildSummaryVectorDocument(summary, config2, project, targetOrObservati
     }
   };
 }
-async function pushOutbox(db, config2, batchSize = 50) {
+async function pushOutbox(db, config2, batchSize = 50, options = {}) {
   const entries = getPendingEntries(db, batchSize);
   let pushed = 0;
   let failed = 0;
@@ -22030,7 +22062,8 @@ async function pushOutbox(db, config2, batchSize = 50) {
     const client = new VectorClient(config2, {
       apiKey: target.apiKey,
       namespace: target.namespace,
-      siteId: target.siteId
+      siteId: target.siteId,
+      timeoutMs: options.timeoutMs
     });
     try {
       await client.batchIngest(items.map((b) => b.doc));
@@ -23083,8 +23116,16 @@ process.on("SIGTERM", () => {
 function buildServer() {
   const server = new McpServer({
     name: "engrm",
-    version: "0.4.41"
+    version: "0.4.42"
   });
+  const enabledToolNames = getEnabledToolNames(config2.tool_profile);
+  const originalTool = server.tool.bind(server);
+  server.tool = (name, ...args) => {
+    if (enabledToolNames && !enabledToolNames.has(name)) {
+      return server;
+    }
+    return originalTool(name, ...args);
+  };
   server.tool("save_observation", "Directly save a durable memory item now. Use this when something should be remembered on purpose instead of waiting for an end-of-session digest.", {
     type: exports_external.enum([
       "bugfix",
@@ -24146,6 +24187,7 @@ ${observationLines}`
           text: `Schema: v${result.schema_version} (${result.schema_current ? "current" : "outdated"})
 ` + `HTTP MCP: ${result.http_enabled ? `enabled${result.http_port ? ` (:${result.http_port})` : ""}` : "disabled"}
 ` + `HTTP bearer tokens: ${result.http_bearer_token_count}
+` + `Tool profile: ${result.tool_profile}${typeof result.enabled_tool_count === "number" ? ` (${result.enabled_tool_count} tools)` : ""}
 ` + `Fleet project: ${result.fleet_project_name ?? "none"}
 ` + `Fleet sync: ${result.fleet_configured ? "configured" : "not configured"}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "engrm",
-  "version": "0.4.41",
+  "version": "0.4.43",
   "description": "Shared memory across devices, sessions, and agents, with thin MCP tools for durable capture, live continuity, and Hermes-ready remote MCP support",
   "mcpName": "io.github.dr12hes/engrm",
   "type": "module",