@joshuaswarren/openclaw-engram 9.0.88 → 9.0.91

package/README.md

@@ -134,7 +134,24 @@ Run the stdio MCP server:
 openclaw engram access mcp-serve
 ```
 
-Point your MCP client's command at `openclaw engram access mcp-serve`. Works with Claude Code, and any other MCP-compatible client. The server exposes the same 8 tools as the HTTP endpoint.
+Point your MCP client's command at `openclaw engram access mcp-serve`. Works with Claude Code, and any other MCP-compatible client. The server exposes the same tools as the HTTP endpoint.
+
+**Claude Code (MCP over HTTP):** Start the Engram HTTP server, then add to `~/.claude.json`:
+
+```json
+{
+  "mcpServers": {
+    "engram": {
+      "url": "http://localhost:4318/mcp",
+      "headers": {
+        "Authorization": "Bearer ${ENGRAM_TOKEN}"
+      }
+    }
+  }
+}
+```
+
+See the [Standalone Server Guide](docs/guides/standalone-server.md) for multi-tenant setups and connecting multiple agent harnesses.
 
 ## How It Works
 
@@ -202,6 +219,10 @@ Use a preset to jump to a recommended level: `conservative`, `balanced`, `resear
 - **Scripts & automation** — Authenticated REST API for custom integrations
 - **Local LLMs** — Run extraction and reranking with local models (Ollama, LM Studio, etc.)
 
+### Standalone Multi-Tenant Server
+
+Run Engram as a standalone HTTP server that multiple agent harnesses share. Isolate tenants with namespace policies, feed conversations from any client via the observe endpoint, and search archived history with LCM full-text search. Works with OpenClaw, Codex CLI, Claude Code, and custom HTTP agents. See the [Standalone Server Guide](docs/guides/standalone-server.md).
+
 ### Built for production
 
 - **672 tests** with CI enforcement
@@ -215,6 +236,7 @@ Use a preset to jump to a recommended level: `conservative`, `balanced`, `resear
 ### Core
 
 - **Automatic memory extraction** — Facts, decisions, preferences, corrections extracted from conversations
+- **Observe endpoint** — Feed conversation messages from any agent into the extraction pipeline via HTTP or MCP
 - **Recall injection** — Relevant memories injected before each agent turn
 - **Entity tracking** — People, projects, tools, companies tracked as structured entities
 - **Lifecycle management** — Memories age through active, validated, stale, archived states
@@ -320,6 +342,8 @@ Available via both stdio and HTTP transports:
 | `engram.suggestion_submit` | Queue a memory for review |
 | `engram.entity_get` | Look up a known entity |
 | `engram.review_queue_list` | View the governance review queue |
+| `engram.observe` | Feed conversation messages into memory pipeline (LCM + extraction) |
+| `engram.lcm_search` | Full-text search over LCM-archived conversations |
 | `engram_context_search` | Full-text search across all archived conversation history (LCM) |
 | `engram_context_describe` | Get a compressed summary of a turn range (LCM) |
 | `engram_context_expand` | Retrieve raw lossless messages for a turn range (LCM) |
@@ -395,6 +419,7 @@ All settings live in `openclaw.json` under `plugins.entries.openclaw-engram.conf
 - [Writing a Search Backend](docs/writing-a-search-backend.md) — Build your own adapter
 - [API Reference](docs/api.md) — HTTP, MCP, and CLI documentation
 - [Codex CLI Integration](docs/guides/codex-cli.md) — Setup Engram with OpenAI's Codex
+- [Standalone Server Guide](docs/guides/standalone-server.md) — Multi-tenant HTTP server for multiple agent harnesses
 - [Local LLM Guide](docs/guides/local-llm.md) — Local-first extraction and reranking
 - [Cost Control Guide](docs/guides/cost-control.md) — Budget mappings and presets
 - [Namespaces](docs/namespaces.md) — Multi-agent memory isolation

package/dist/{chunk-C26MLXQM.js → chunk-DDJJSZIV.js}

@@ -109,6 +109,7 @@ var SPECULATIVE_TTL_DAYS = 30;
 
 // src/memory-projection-store.ts
 import path2 from "path";
+import { readFileSync } from "fs";
 import Database from "better-sqlite3";
 var MEMORY_PROJECTION_SCHEMA_VERSION = 2;
 function getMemoryProjectionPath(memoryDir) {
@@ -453,9 +454,6 @@ function readProjectedMemoryTimeline(memoryDir, memoryId, limit) {
 function readProjectedMemoryBrowse(memoryDir, options) {
   return withProjectionReadonly(memoryDir, (db) => {
     const normalizedQuery = options.query?.trim().toLowerCase() ?? "";
-    if (normalizedQuery) {
-      return null;
-    }
     const currentSelect = memoryCurrentSelectExpressions(db);
     const whereClauses = [];
     const params = [];
@@ -482,6 +480,57 @@ function readProjectedMemoryBrowse(memoryDir, options) {
       }
     })();
     const whereSql = whereClauses.length > 0 ? `WHERE ${whereClauses.join(" AND ")}` : "";
+    if (normalizedQuery) {
+      const allRows = db.prepare(`
+          SELECT
+            memory_id,
+            path_rel,
+            category,
+            status,
+            created_at,
+            updated_at,
+            entity_ref,
+            ${currentSelect.tagsJson},
+            ${currentSelect.previewText}
+          FROM memory_current
+          ${whereSql}
+          ORDER BY ${orderBySql}
+        `).all(...params);
+      const filtered = allRows.filter((row) => {
+        if (typeof row.memory_id !== "string" || typeof row.path_rel !== "string") return false;
+        const preview = typeof row.preview_text === "string" ? row.preview_text.toLowerCase() : "";
+        const category = typeof row.category === "string" ? row.category.toLowerCase() : "";
+        const entityRef = typeof row.entity_ref === "string" ? row.entity_ref.toLowerCase() : "";
+        const tags = typeof row.tags_json === "string" ? row.tags_json.toLowerCase() : "";
+        if (preview.includes(normalizedQuery) || category.includes(normalizedQuery) || entityRef.includes(normalizedQuery) || tags.includes(normalizedQuery)) {
+          return true;
+        }
+        try {
+          const filePath = path2.join(memoryDir, row.path_rel);
+          const content = readFileSync(filePath, "utf-8").toLowerCase();
+          return content.includes(normalizedQuery);
+        } catch {
+          return false;
+        }
+      });
+      const pageRows = filtered.slice(options.offset, options.offset + options.limit);
+      return {
+        total: filtered.length,
+        memories: pageRows.filter(
+          (row) => typeof row.memory_id === "string" && typeof row.path_rel === "string" && typeof row.category === "string" && typeof row.status === "string"
+        ).map((row) => ({
+          id: row.memory_id,
+          path: path2.join(memoryDir, row.path_rel),
+          category: row.category,
+          status: row.status,
+          created: typeof row.created_at === "string" ? row.created_at : void 0,
+          updated: typeof row.updated_at === "string" ? row.updated_at : void 0,
+          tags: parseStringArray(row.tags_json),
+          entityRef: typeof row.entity_ref === "string" ? row.entity_ref : void 0,
+          preview: typeof row.preview_text === "string" ? row.preview_text : ""
+        }))
+      };
+    }
     const totalRow = db.prepare(`SELECT COUNT(*) AS total FROM memory_current ${whereSql}`).get(...params);
     const rows = db.prepare(`
         SELECT
@@ -1167,9 +1216,29 @@ function serializeFrontmatter(fm) {
   if (fm.sourceMemoryId) lines.push(`sourceMemoryId: ${fm.sourceMemoryId}`);
   if (fm.sourceTurnId) lines.push(`sourceTurnId: ${fm.sourceTurnId}`);
   if (fm.memoryKind) lines.push(`memoryKind: ${fm.memoryKind}`);
+  if (fm.structuredAttributes && Object.keys(fm.structuredAttributes).length > 0) {
+    lines.push(`structuredAttributes: ${JSON.stringify(fm.structuredAttributes)}`);
+  }
   lines.push("---");
   return lines.join("\n");
 }
+function parseStructuredAttributes(raw) {
+  if (!raw || !raw.trim()) return void 0;
+  try {
+    const parsed = JSON.parse(raw);
+    if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+      const result = {};
+      for (const [k, v] of Object.entries(parsed)) {
+        if (typeof k === "string" && typeof v === "string") {
+          result[k] = v;
+        }
+      }
+      return Object.keys(result).length > 0 ? result : void 0;
+    }
+  } catch {
+  }
+  return void 0;
+}
 function parseLinkReasonValue(rawValue) {
   const legacyValue = rawValue.replace(/\\"/g, '"');
   const looksLikeLegacyPath = !rawValue.includes("\\\\") && (/[A-Za-z]:\\[A-Za-z0-9._ -]+(?:\\[A-Za-z0-9._ -]+)*/.test(rawValue) || /\\[A-Za-z0-9._ -]+\\[A-Za-z0-9._ -]+/.test(rawValue));
@@ -1282,7 +1351,9 @@ function parseFrontmatter2(raw) {
       sourceMemoryId: fm.sourceMemoryId || void 0,
       sourceTurnId: fm.sourceTurnId || void 0,
       // v8.0 Phase 2B: HiMem episode/note classification
-      memoryKind: fm.memoryKind || void 0
+      memoryKind: fm.memoryKind || void 0,
+      // Structured attributes (JSON on a single line)
+      structuredAttributes: parseStructuredAttributes(fm.structuredAttributes)
     },
     content
   };
@@ -1763,9 +1834,16 @@ var StorageManager = class _StorageManager {
       artifactType: options.artifactType,
       sourceMemoryId: options.sourceMemoryId,
       sourceTurnId: options.sourceTurnId,
-      memoryKind: options.memoryKind
+      memoryKind: options.memoryKind,
+      structuredAttributes: options.structuredAttributes
     };
-    const sanitized = sanitizeMemoryContent(content);
+    let enrichedContent = content;
+    if (options.structuredAttributes && Object.keys(options.structuredAttributes).length > 0) {
+      const attrLines = Object.entries(options.structuredAttributes).map(([k, v]) => `${k}: ${v}`).join("; ");
+      enrichedContent = `${content}
+[Attributes: ${attrLines}]`;
+    }
+    const sanitized = sanitizeMemoryContent(enrichedContent);
     if (!sanitized.clean) {
       log.warn(`memory content sanitized for ${id}; violations=${sanitized.violations.join(", ")}`);
     }
@@ -3810,4 +3888,4 @@ export {
   serializeEntityFile,
   StorageManager
 };
-//# sourceMappingURL=chunk-C26MLXQM.js.map
+//# sourceMappingURL=chunk-DDJJSZIV.js.map