@joshuaswarren/openclaw-engram 9.0.89 → 9.0.92

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-O4KLNIZ3.js → chunk-DDJJSZIV.js}

@@ -1216,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));
@@ -1331,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
   };
@@ -1812,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(", ")}`);
     }
@@ -3859,4 +3888,4 @@ export {
   serializeEntityFile,
   StorageManager
 };
-//# sourceMappingURL=chunk-O4KLNIZ3.js.map
+//# sourceMappingURL=chunk-DDJJSZIV.js.map