@xdarkicex/openclaw-memory-libravdb 1.9.10-beta.2 → 1.9.10-beta.21

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 } 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;
@@ -65,6 +65,9 @@ export declare class LibravDBClient {
     summarizeMessages(req: PartialMessage<SummarizeMessagesRequest>): Promise<SummarizeMessagesResponse>;
     expandSummary(req: PartialMessage<ExpandSummaryRequest>): Promise<ExpandSummaryResponse>;
     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

@@ -337,6 +337,19 @@ export class LibravDBClient {
         this.guardOpen();
         return this.client.rankCandidates(req);
     }
+    // ── User Card ────────────────────────────────────────────────────
+    async upsertUserCard(req) {
+        this.guardOpen();
+        return this.client.upsertUserCard(req);
+    }
+    async getUserCard(req) {
+        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

@@ -141,4 +141,73 @@ export declare function createMemoryGrepTool(getClient: ClientGetter, getSession
     execute: (_toolCallId: string, rawParams: unknown) => Promise<ToolResult<MemoryGrepDetails>>;
 };
 export declare function memoryRecallPromptSection(): string[];
+type UpdateUserCardDetails = {
+    ok: boolean;
+    error?: string;
+};
+type GetUserCardDetails = {
+    card?: string | null;
+    updatedAt?: number;
+    version?: number;
+    error?: string;
+};
+export declare function createUpdateUserCardTool(getClient: ClientGetter, logger?: LoggerLike): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly user_id: {
+                readonly type: "string";
+                readonly description: "The user ID to update the card for.";
+            };
+            readonly card: {
+                readonly type: "string";
+                readonly description: "Prose description of what you've learned about this person. Write like describing a friend. Include identity, values, history, communication style, triggers, and what matters to them. Merge with previous understanding — don't replace entirely unless the user explicitly contradicts the record. Max ~1200 characters.";
+            };
+        };
+        readonly required: readonly ["user_id", "card"];
+    };
+    execute: (_toolCallId: string, rawParams: unknown) => Promise<ToolResult<UpdateUserCardDetails>>;
+};
+export declare function createGetUserCardTool(getClient: ClientGetter, logger?: LoggerLike): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly user_id: {
+                readonly type: "string";
+                readonly description: "The user ID to retrieve the card for.";
+            };
+        };
+        readonly required: readonly ["user_id"];
+    };
+    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

@@ -422,3 +422,149 @@ const RECALL_GUIDANCE = [
 export function memoryRecallPromptSection() {
     return [...RECALL_GUIDANCE];
 }
+// ── User Card tool schemas ──
+const UPDATE_USER_CARD_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        user_id: {
+            type: "string",
+            description: "The user ID to update the card for.",
+        },
+        card: {
+            type: "string",
+            description: "Prose description of what you've learned about this person. Write like describing a friend. Include identity, values, history, communication style, triggers, and what matters to them. Merge with previous understanding — don't replace entirely unless the user explicitly contradicts the record. Max ~1200 characters.",
+        },
+    },
+    required: ["user_id", "card"],
+};
+const GET_USER_CARD_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        user_id: {
+            type: "string",
+            description: "The user ID to retrieve the card for.",
+        },
+    },
+    required: ["user_id"],
+};
+// ── User Card tool factories ──
+export function createUpdateUserCardTool(getClient, logger = console) {
+    return {
+        name: "update_user_card",
+        label: "Update User Card",
+        description: "Write what you've learned about a speaker. Prose format — write like you're describing a friend. " +
+            "Include identity, values, history, communication style, triggers, and what matters to them. " +
+            "This is the canonical record of who they are. If something changes, update it. " +
+            "Merge with previous understanding, don't replace entirely unless the user explicitly contradicts the record.",
+        parameters: UPDATE_USER_CARD_SCHEMA,
+        execute: async (_toolCallId, rawParams) => {
+            const params = asParams(rawParams);
+            const userId = readStr(params, "user_id");
+            const card = readStr(params, "card");
+            if (!userId)
+                throw new Error("update_user_card requires user_id");
+            if (!card)
+                throw new Error("update_user_card requires card");
+            try {
+                const client = await getClient();
+                const resp = await client.upsertUserCard({
+                    userId,
+                    cardJson: JSON.stringify({ card, updatedAt: Date.now() }),
+                });
+                return jsonResult({ ok: resp.ok });
+            }
+            catch (error) {
+                logger.warn?.(`update_user_card failed: ${formatError(error)}`);
+                return jsonResult({ error: formatError(error), ok: false });
+            }
+        },
+    };
+}
+export function createGetUserCardTool(getClient, logger = console) {
+    return {
+        name: "get_user_card",
+        label: "Get User Card",
+        description: "PRIMARY identity lookup. Call this FIRST whenever someone asks about a person " +
+            "('who is X', 'tell me about X', 'what do you know about X'). " +
+            "Returns the full prose identity card with metadata. " +
+            "Only use memory_search AFTER get_user_card if the card lacks detail.",
+        parameters: GET_USER_CARD_SCHEMA,
+        execute: async (_toolCallId, rawParams) => {
+            const params = asParams(rawParams);
+            const userId = readStr(params, "user_id");
+            if (!userId)
+                throw new Error("get_user_card requires user_id");
+            try {
+                const client = await getClient();
+                const resp = await client.getUserCard({ userId });
+                return jsonResult({
+                    card: resp.cardJson || null,
+                    updatedAt: resp.updatedAt ? Number(resp.updatedAt) : undefined,
+                    version: resp.version || undefined,
+                });
+            }
+            catch (error) {
+                logger.warn?.(`get_user_card failed: ${formatError(error)}`);
+                return jsonResult({ error: formatError(error) });
+            }
+        },
+    };
+}
+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 FIRST when asked about multiple people, 'who do you know?', 'who is everyone?', " +
+            "or when you're unsure which people have cards. Then use get_user_card on specific IDs " +
+            "for full detail. Use memory_search only to supplement gaps.",
+        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.2",
+  "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.21",
   "kind": [
     "memory",
     "context-engine"
@@ -15,7 +15,10 @@
       "memory_get",
       "memory_describe",
       "memory_expand",
-      "memory_grep"
+      "memory_grep",
+      "update_user_card",
+      "get_user_card",
+      "list_user_cards"
     ]
   },
   "activation": {
@@ -178,6 +181,10 @@
       "beforeTurnEnabled": {
         "type": "boolean"
       },
+      "beforeTurnDebug": {
+        "type": "boolean",
+        "description": "Enable verbose BeforeTurnKernel diagnostic logging. Default: false"
+      },
       "beforeTurnTimeoutMs": {
         "type": "number"
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xdarkicex/openclaw-memory-libravdb",
-  "version": "1.9.10-beta.2",
+  "version": "1.9.10-beta.21",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -65,7 +65,7 @@
     "build:daemon": "bash scripts/build-daemon.sh"
   },
   "devDependencies": {
-    "@bufbuild/protobuf": "1.7.2",
+    "@bufbuild/protobuf": "1.10.1",
     "@grpc/grpc-js": "^1.14.3",
     "@grpc/proto-loader": "^0.8.0",
     "@openclaw/plugin-inspector": "0.3.7",
@@ -80,11 +80,6 @@
   "dependencies": {
     "@connectrpc/connect": "^1.7.0",
     "@connectrpc/connect-node": "^1.7.0",
-    "@xdarkicex/libravdb-contracts": "^2.0.20"
-  },
-  "pnpm": {
-    "overrides": {
-      "undici": "8.3.0"
-    }
+    "@xdarkicex/libravdb-contracts": "^2.0.25"
   }
 }