@xdarkicex/openclaw-memory-libravdb 1.9.10-beta.17 → 1.9.10-beta.19

package/dist/context-engine.d.ts

@@ -20,6 +20,11 @@ type OpenClawCompatibleAssembleResult = {
     promptAuthority: OpenClawCompatiblePromptAuthority;
     debug?: AssembleContextInternalResponse["debug"];
 };
+export interface Speaker {
+    name: string;
+    displayName: string;
+}
+export declare function extractSpeakers(messages: OpenClawCompatibleMessage[]): Speaker[];
 type OpenClawCompatibleCompactResult = {
     ok: boolean;
     compacted: boolean;

package/dist/context-engine.js

@@ -24,6 +24,29 @@ const SELECTED_CONTEXT_HEADER = "Conversation context (untrusted, chronological,
 const RETRIEVAL_QUERY_MAX_CHARS = 1000;
 const SELECTED_CONTEXT_TURN_RE = /^#\d+\s+[A-Za-z]{3}\s+\d{4}-\d{2}-\d{2}\s+\d{2}:\d{2}(?::\d{2})?\s+\S+\s+([^:\n]{1,80}):\s*(.*)$/;
 const ASSISTANT_SPEAKER_RE = /\b(?:assistant|openclaw|z3robot|bot)\b/i;
+// Multi-speaker envelope regex: matches [HH:MM] Speaker: text
+const MULTI_SPEAKER_LINE_RE = /^\[\d{2}:\d{2}\]\s+(\S[^:]{0,80}):\s/;
+export function extractSpeakers(messages) {
+    const seen = new Set();
+    const speakers = [];
+    for (const msg of messages) {
+        if (msg.role !== "user")
+            continue;
+        const text = normalizeKernelContent(msg.content);
+        for (const line of text.split("\n")) {
+            const match = line.match(MULTI_SPEAKER_LINE_RE);
+            if (match) {
+                const displayName = match[1].trim();
+                const name = displayName.toLowerCase();
+                if (name && !ASSISTANT_SPEAKER_RE.test(name) && !seen.has(name)) {
+                    seen.add(name);
+                    speakers.push({ name, displayName });
+                }
+            }
+        }
+    }
+    return speakers;
+}
 const OPENCLAW_METADATA_HEADERS = [
     "Conversation info (untrusted metadata):",
     "Sender (untrusted metadata):",

package/dist/index.js

@@ -16789,82 +16789,6 @@ var require_undici = __commonJS({
   }
 });
 
-// src/index.ts
-import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
-
-// src/cli.ts
-import { createInterface } from "node:readline/promises";
-import { stdin, stdout } from "node:process";
-
-// src/cli-descriptors.ts
-var PLUGIN_ID = "libravdb-memory";
-var MEMORY_CLI_DESCRIPTOR = {
-  name: "memory",
-  description: "Manage LibraVDB memory",
-  hasSubcommands: true
-};
-function isMemorySlotSelected(api) {
-  const slots = api.config?.plugins?.slots;
-  return slots?.memory === PLUGIN_ID;
-}
-function registerMemoryCliMetadata(api) {
-  if (!isMemorySlotSelected(api)) {
-    return;
-  }
-  api.registerCli?.(() => {
-  }, {
-    descriptors: [MEMORY_CLI_DESCRIPTOR]
-  });
-}
-
-// src/memory-scopes.ts
-var SESSION_KEY_NAMESPACE_PREFIX = "session-key:";
-var AGENT_ID_NAMESPACE_PREFIX = "agent-id:";
-var USER_COLLECTION_PREFIX = "user:";
-var RESERVED_NAMESPACE_PREFIXES = [SESSION_KEY_NAMESPACE_PREFIX, AGENT_ID_NAMESPACE_PREFIX, USER_COLLECTION_PREFIX];
-var COLLECTION_NAME_RE = /^[a-zA-Z][a-zA-Z0-9_.:@#-]{0,127}$/;
-function validateNamespace(name) {
-  if (!COLLECTION_NAME_RE.test(name)) {
-    throw new Error(
-      `Invalid collection namespace: "${name}". Must match ${COLLECTION_NAME_RE.source}`
-    );
-  }
-  return name;
-}
-function resolveDurableNamespace(params) {
-  const explicitUserId = firstNonEmpty(params.userId);
-  if (explicitUserId) {
-    for (const prefix of RESERVED_NAMESPACE_PREFIXES) {
-      if (explicitUserId.startsWith(prefix)) {
-        throw new Error(
-          `Invalid userId "${explicitUserId}": must not start with reserved prefix "${prefix}"`
-        );
-      }
-    }
-    return validateNamespace(explicitUserId);
-  }
-  const sessionKey = firstNonEmpty(params.sessionKey);
-  if (sessionKey) return validateNamespace(`${SESSION_KEY_NAMESPACE_PREFIX}${sessionKey}`);
-  const agentId = firstNonEmpty(params.agentId);
-  if (agentId) return validateNamespace(`${AGENT_ID_NAMESPACE_PREFIX}${agentId}`);
-  const fallback2 = firstNonEmpty(params.fallback);
-  if (fallback2) return validateNamespace(fallback2);
-  return "default";
-}
-function resolveUserCollection(userId) {
-  const namespace = firstNonEmpty(userId);
-  if (!namespace) {
-    throw new Error("Invalid user collection namespace: userId must be non-empty");
-  }
-  validateNamespace(namespace);
-  return validateNamespace(`${USER_COLLECTION_PREFIX}${namespace}`);
-}
-function firstNonEmpty(value) {
-  if (typeof value !== "string") return void 0;
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : void 0;
-}
-
 // src/identity.ts
 import { userInfo, hostname } from "node:os";
 import { createHash } from "node:crypto";
@@ -16987,6 +16911,82 @@ function resolveTenantKey(cfg) {
   }).userId;
 }
 
+// src/index.ts
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
+
+// src/cli.ts
+import { createInterface } from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+
+// src/cli-descriptors.ts
+var PLUGIN_ID = "libravdb-memory";
+var MEMORY_CLI_DESCRIPTOR = {
+  name: "memory",
+  description: "Manage LibraVDB memory",
+  hasSubcommands: true
+};
+function isMemorySlotSelected(api) {
+  const slots = api.config?.plugins?.slots;
+  return slots?.memory === PLUGIN_ID;
+}
+function registerMemoryCliMetadata(api) {
+  if (!isMemorySlotSelected(api)) {
+    return;
+  }
+  api.registerCli?.(() => {
+  }, {
+    descriptors: [MEMORY_CLI_DESCRIPTOR]
+  });
+}
+
+// src/memory-scopes.ts
+var SESSION_KEY_NAMESPACE_PREFIX = "session-key:";
+var AGENT_ID_NAMESPACE_PREFIX = "agent-id:";
+var USER_COLLECTION_PREFIX = "user:";
+var RESERVED_NAMESPACE_PREFIXES = [SESSION_KEY_NAMESPACE_PREFIX, AGENT_ID_NAMESPACE_PREFIX, USER_COLLECTION_PREFIX];
+var COLLECTION_NAME_RE = /^[a-zA-Z][a-zA-Z0-9_.:@#-]{0,127}$/;
+function validateNamespace(name) {
+  if (!COLLECTION_NAME_RE.test(name)) {
+    throw new Error(
+      `Invalid collection namespace: "${name}". Must match ${COLLECTION_NAME_RE.source}`
+    );
+  }
+  return name;
+}
+function resolveDurableNamespace(params) {
+  const explicitUserId = firstNonEmpty(params.userId);
+  if (explicitUserId) {
+    for (const prefix of RESERVED_NAMESPACE_PREFIXES) {
+      if (explicitUserId.startsWith(prefix)) {
+        throw new Error(
+          `Invalid userId "${explicitUserId}": must not start with reserved prefix "${prefix}"`
+        );
+      }
+    }
+    return validateNamespace(explicitUserId);
+  }
+  const sessionKey = firstNonEmpty(params.sessionKey);
+  if (sessionKey) return validateNamespace(`${SESSION_KEY_NAMESPACE_PREFIX}${sessionKey}`);
+  const agentId = firstNonEmpty(params.agentId);
+  if (agentId) return validateNamespace(`${AGENT_ID_NAMESPACE_PREFIX}${agentId}`);
+  const fallback2 = firstNonEmpty(params.fallback);
+  if (fallback2) return validateNamespace(fallback2);
+  return "default";
+}
+function resolveUserCollection(userId) {
+  const namespace = firstNonEmpty(userId);
+  if (!namespace) {
+    throw new Error("Invalid user collection namespace: userId must be non-empty");
+  }
+  validateNamespace(namespace);
+  return validateNamespace(`${USER_COLLECTION_PREFIX}${namespace}`);
+}
+function firstNonEmpty(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+
 // src/format-error.ts
 function formatError(error2) {
   if (error2 instanceof Error && error2.message.trim()) {
@@ -18646,6 +18646,27 @@ var SELECTED_CONTEXT_HEADER = "Conversation context (untrusted, chronological, s
 var RETRIEVAL_QUERY_MAX_CHARS = 1e3;
 var SELECTED_CONTEXT_TURN_RE = /^#\d+\s+[A-Za-z]{3}\s+\d{4}-\d{2}-\d{2}\s+\d{2}:\d{2}(?::\d{2})?\s+\S+\s+([^:\n]{1,80}):\s*(.*)$/;
 var ASSISTANT_SPEAKER_RE = /\b(?:assistant|openclaw|z3robot|bot)\b/i;
+var MULTI_SPEAKER_LINE_RE = /^\[\d{2}:\d{2}\]\s+(\S[^:]{0,80}):\s/;
+function extractSpeakers(messages) {
+  const seen = /* @__PURE__ */ new Set();
+  const speakers = [];
+  for (const msg of messages) {
+    if (msg.role !== "user") continue;
+    const text = normalizeKernelContent(msg.content);
+    for (const line of text.split("\n")) {
+      const match = line.match(MULTI_SPEAKER_LINE_RE);
+      if (match) {
+        const displayName = match[1].trim();
+        const name = displayName.toLowerCase();
+        if (name && !ASSISTANT_SPEAKER_RE.test(name) && !seen.has(name)) {
+          seen.add(name);
+          speakers.push({ name, displayName });
+        }
+      }
+    }
+  }
+  return speakers;
+}
 var OPENCLAW_METADATA_HEADERS = [
   "Conversation info (untrusted metadata):",
   "Sender (untrusted metadata):",
@@ -31337,6 +31358,56 @@ function createGetUserCardTool(getClient, logger = console) {
     }
   };
 }
+function createListUserCardsTool(getClient, logger = console) {
+  return {
+    name: "list_user_cards",
+    label: "List User Cards",
+    description: "List every person you have a user card for. Returns user IDs and card previews. Use this when asked 'who do you know?' or when you need to see the full roster. For detailed information about a specific person, use get_user_card.",
+    parameters: { type: "object", additionalProperties: false, properties: {} },
+    execute: async (_toolCallId, _rawParams) => {
+      try {
+        const client = await getClient();
+        const resp = await client.listByMeta({
+          collection: "",
+          key: "type",
+          value: "user_card"
+        });
+        const users = [];
+        for (const result of resp.results) {
+          let userId = "";
+          let preview = "";
+          let updatedAt;
+          let version;
+          if (result.metadataJson && result.metadataJson.length > 0) {
+            try {
+              const decoder = new TextDecoder();
+              const meta = JSON.parse(decoder.decode(result.metadataJson));
+              userId = typeof meta._user_id === "string" ? meta._user_id : "";
+              const cardJson = typeof meta.card_json === "string" ? meta.card_json : null;
+              if (cardJson) {
+                try {
+                  preview = JSON.parse(cardJson).card ?? cardJson;
+                } catch {
+                  preview = cardJson;
+                }
+                preview = preview.slice(0, 200);
+              }
+              updatedAt = typeof meta.updated_at === "number" ? meta.updated_at : void 0;
+              version = typeof meta.version === "number" ? meta.version : void 0;
+            } catch {
+            }
+          }
+          if (!userId) continue;
+          users.push({ user_id: userId, preview, updated_at: updatedAt, version });
+        }
+        return jsonResult({ users, total: users.length });
+      } catch (error2) {
+        logger.warn?.(`list_user_cards failed: ${formatError(error2)}`);
+        return jsonResult({ users: [], total: 0, error: formatError(error2) });
+      }
+    }
+  };
+}
 
 // src/memory-tools.ts
 var MEMORY_SEARCH_SCHEMA = {
@@ -34780,6 +34851,10 @@ var LibravDBClient = class {
     this.guardOpen();
     return this.client.getUserCard(req);
   }
+  async listByMeta(req) {
+    this.guardOpen();
+    return this.client.listByMeta(req);
+  }
   close() {
     this.closed = true;
   }
@@ -35107,6 +35182,10 @@ function register(api) {
       const getClient = runtimeOrNull.getClient;
       return createGetUserCardTool(getClient, logger);
     }, { names: ["get_user_card"] });
+    api.registerTool?.((ctx) => {
+      const getClient = runtimeOrNull.getClient;
+      return createListUserCardsTool(getClient, logger);
+    }, { names: ["list_user_cards"] });
   }
   if (isLightweight || isDiscovery) {
     if (!isLightweight) {
@@ -35213,6 +35292,65 @@ function register(api) {
     const trigger = ctx?.trigger;
     if (sessionId) setSessionTrigger(sessionId, trigger);
   });
+  const MULTI_SPEAKER_PROVIDERS = /* @__PURE__ */ new Set([
+    "discord",
+    "telegram",
+    "imessage",
+    "slack",
+    "whatsapp",
+    "signal",
+    "matrix",
+    "irc"
+  ]);
+  api.on("before_prompt_build", async (event, ctx) => {
+    const c = ctx;
+    const provider = c.messageProvider;
+    if (!provider || !MULTI_SPEAKER_PROVIDERS.has(provider.toLowerCase())) return;
+    const e = event;
+    const messages = e.messages ?? [];
+    const speakers = extractSpeakers(messages);
+    if (speakers.length === 0) return;
+    const mainIdentity = resolveIdentity({
+      configUserId: cfg.userId,
+      identityPath: cfg.identityPath,
+      sessionKey: c.sessionKey,
+      logger,
+      noAutoPersist: true
+    });
+    const mainUserId = mainIdentity.userId.toLowerCase();
+    const otherSpeakers = speakers.filter((s) => s.name !== mainUserId);
+    if (otherSpeakers.length === 0) return;
+    try {
+      const client = await runtime.getClient();
+      const results = await Promise.all(
+        otherSpeakers.map(async (speaker) => {
+          try {
+            const resp = await client.getUserCard({ userId: speaker.name });
+            if (!resp.cardJson) return null;
+            let card;
+            try {
+              card = JSON.parse(resp.cardJson).card ?? resp.cardJson;
+            } catch {
+              card = resp.cardJson;
+            }
+            if (!card || !card.trim()) return null;
+            return `<speaker_context speaker="${speaker.displayName}">
+${card.trim()}
+</speaker_context>`;
+          } catch {
+            return null;
+          }
+        })
+      );
+      const validCards = results.filter((c2) => c2 !== null);
+      if (validCards.length === 0) return;
+      return { appendSystemContext: validCards.join("\n") };
+    } catch (error2) {
+      logger.warn?.(
+        `LibraVDB speaker card injection failed: ${error2 instanceof Error ? error2.message : String(error2)}`
+      );
+    }
+  });
   api.on("session_end", async (_event, ctx) => {
     const sessionId = ctx?.sessionId;
     if (sessionId) clearSessionTrigger(sessionId);

package/dist/libravdb-client.d.ts

@@ -1,7 +1,7 @@
 import type { Interceptor } from "@connectrpc/connect";
 import type { PartialMessage } from "@bufbuild/protobuf";
 import type { LoggerLike } from "./types.js";
-import type { AfterTurnKernelRequest, AfterTurnKernelResponse, BeforeTurnKernelRequest, BeforeTurnKernelResponse, AssembleContextInternalRequest, AssembleContextInternalResponse, BootstrapSessionKernelRequest, BootstrapSessionKernelResponse, CompactSessionRequest, CompactSessionResponse, DeleteAuthoredDocumentRequest, DeleteAuthoredDocumentResponse, DreamPromotionResponse, ExportMemoryRequest, ExportMemoryResponse, FlushNamespaceRequest, FlushNamespaceResponse, FlushRequest, FlushResponse, HealthRequest, HealthResponse, IngestMarkdownDocumentRequest, IngestMarkdownDocumentResponse, IngestMessageKernelRequest, IngestMessageKernelResponse, ListCollectionRequest, ListCollectionResponse, ListLifecycleJournalRequest, ListLifecycleJournalResponse, MarkMemorySupersededRequest, MarkMemorySupersededResponse, MemoryStatusRequest, MemoryStatusResponse, PromoteDreamEntriesRequest, RankCandidatesRequest, RankCandidatesResponse, RebuildIndexRequest, RebuildIndexResponse, ReindexAuthoredDocumentRequest, ReindexAuthoredDocumentResponse, SearchTextCollectionsRequest, SearchTextRequest, SearchTextResponse, SessionLifecycleHintRequest, SessionLifecycleHintResponse, SummarizeMessagesRequest, SummarizeMessagesResponse, ExpandSummaryRequest, ExpandSummaryResponse, UpsertUserCardRequest, UpsertUserCardResponse, GetUserCardRequest, GetUserCardResponse } from "@xdarkicex/libravdb-contracts";
+import type { AfterTurnKernelRequest, AfterTurnKernelResponse, BeforeTurnKernelRequest, BeforeTurnKernelResponse, AssembleContextInternalRequest, AssembleContextInternalResponse, BootstrapSessionKernelRequest, BootstrapSessionKernelResponse, CompactSessionRequest, CompactSessionResponse, DeleteAuthoredDocumentRequest, DeleteAuthoredDocumentResponse, DreamPromotionResponse, ExportMemoryRequest, ExportMemoryResponse, FlushNamespaceRequest, FlushNamespaceResponse, FlushRequest, FlushResponse, HealthRequest, HealthResponse, IngestMarkdownDocumentRequest, IngestMarkdownDocumentResponse, IngestMessageKernelRequest, IngestMessageKernelResponse, ListByMetaRequest, ListByMetaResponse, ListCollectionRequest, ListCollectionResponse, ListLifecycleJournalRequest, ListLifecycleJournalResponse, MarkMemorySupersededRequest, MarkMemorySupersededResponse, MemoryStatusRequest, MemoryStatusResponse, PromoteDreamEntriesRequest, RankCandidatesRequest, RankCandidatesResponse, RebuildIndexRequest, RebuildIndexResponse, ReindexAuthoredDocumentRequest, ReindexAuthoredDocumentResponse, SearchTextCollectionsRequest, SearchTextRequest, SearchTextResponse, SessionLifecycleHintRequest, SessionLifecycleHintResponse, SummarizeMessagesRequest, SummarizeMessagesResponse, ExpandSummaryRequest, ExpandSummaryResponse, UpsertUserCardRequest, UpsertUserCardResponse, GetUserCardRequest, GetUserCardResponse } from "@xdarkicex/libravdb-contracts";
 export interface LibravDBClientOptions {
     endpoint?: string;
     secret?: string;
@@ -67,6 +67,7 @@ export declare class LibravDBClient {
     rankCandidates(req: PartialMessage<RankCandidatesRequest>): Promise<RankCandidatesResponse>;
     upsertUserCard(req: PartialMessage<UpsertUserCardRequest>): Promise<UpsertUserCardResponse>;
     getUserCard(req: PartialMessage<GetUserCardRequest>): Promise<GetUserCardResponse>;
+    listByMeta(req: PartialMessage<ListByMetaRequest>): Promise<ListByMetaResponse>;
     close(): void;
 }
 export declare function loadSecretFromEnv(logger?: LoggerLike): string | undefined;

package/dist/libravdb-client.js

@@ -346,6 +346,10 @@ export class LibravDBClient {
         this.guardOpen();
         return this.client.getUserCard(req);
     }
+    async listByMeta(req) {
+        this.guardOpen();
+        return this.client.listByMeta(req);
+    }
     close() {
         this.closed = true;
     }

package/dist/tools/memory-recall.d.ts

@@ -189,4 +189,25 @@ export declare function createGetUserCardTool(getClient: ClientGetter, logger?:
     };
     execute: (_toolCallId: string, rawParams: unknown) => Promise<ToolResult<GetUserCardDetails>>;
 };
+type ListUserCardsDetails = {
+    users: Array<{
+        user_id: string;
+        preview: string;
+        updated_at?: number;
+        version?: number;
+    }>;
+    total: number;
+    error?: string;
+};
+export declare function createListUserCardsTool(getClient: ClientGetter, logger?: LoggerLike): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly properties: {};
+    };
+    execute: (_toolCallId: string, _rawParams: unknown) => Promise<ToolResult<ListUserCardsDetails>>;
+};
 export {};

package/dist/tools/memory-recall.js

@@ -511,3 +511,58 @@ export function createGetUserCardTool(getClient, logger = console) {
         },
     };
 }
+export function createListUserCardsTool(getClient, logger = console) {
+    return {
+        name: "list_user_cards",
+        label: "List User Cards",
+        description: "List every person you have a user card for. Returns user IDs and card previews. " +
+            "Use this when asked 'who do you know?' or when you need to see the full roster. " +
+            "For detailed information about a specific person, use get_user_card.",
+        parameters: { type: "object", additionalProperties: false, properties: {} },
+        execute: async (_toolCallId, _rawParams) => {
+            try {
+                const client = await getClient();
+                const resp = await client.listByMeta({
+                    collection: "",
+                    key: "type",
+                    value: "user_card",
+                });
+                const users = [];
+                for (const result of resp.results) {
+                    let userId = "";
+                    let preview = "";
+                    let updatedAt;
+                    let version;
+                    if (result.metadataJson && result.metadataJson.length > 0) {
+                        try {
+                            const decoder = new TextDecoder();
+                            const meta = JSON.parse(decoder.decode(result.metadataJson));
+                            userId = typeof meta._user_id === "string" ? meta._user_id : "";
+                            const cardJson = typeof meta.card_json === "string" ? meta.card_json : null;
+                            if (cardJson) {
+                                try {
+                                    preview = JSON.parse(cardJson).card ?? cardJson;
+                                }
+                                catch {
+                                    preview = cardJson;
+                                }
+                                preview = preview.slice(0, 200);
+                            }
+                            updatedAt = typeof meta.updated_at === "number" ? meta.updated_at : undefined;
+                            version = typeof meta.version === "number" ? meta.version : undefined;
+                        }
+                        catch { /* best-effort metadata parse */ }
+                    }
+                    if (!userId)
+                        continue;
+                    users.push({ user_id: userId, preview, updated_at: updatedAt, version });
+                }
+                return jsonResult({ users, total: users.length });
+            }
+            catch (error) {
+                logger.warn?.(`list_user_cards failed: ${formatError(error)}`);
+                return jsonResult({ users: [], total: 0, error: formatError(error) });
+            }
+        },
+    };
+}

package/openclaw.plugin.json

@@ -1,8 +1,8 @@
 {
   "id": "libravdb-memory",
   "name": "LibraVDB Memory",
-  "description": "Persistent vector memory with three-tier hybrid scoring",
-  "version": "1.9.10-beta.16",
+  "description": "Cognitive memory engine — causal graph reasoning, predictive context, identity tracking, and hybrid vector recall with back-door adjustment scoring",
+  "version": "1.9.10-beta.18",
   "kind": [
     "memory",
     "context-engine"
@@ -15,7 +15,9 @@
       "memory_get",
       "memory_describe",
       "memory_expand",
-      "memory_grep"
+      "memory_grep",
+      "update_user_card",
+      "get_user_card"
     ]
   },
   "activation": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xdarkicex/openclaw-memory-libravdb",
-  "version": "1.9.10-beta.17",
+  "version": "1.9.10-beta.19",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",