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

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, 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,8 @@ 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>;
     close(): void;
 }
 export declare function loadSecretFromEnv(logger?: LoggerLike): string | undefined;

package/dist/libravdb-client.js

@@ -337,6 +337,15 @@ 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);
+    }
     close() {
         this.closed = true;
     }

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

@@ -141,4 +141,52 @@ 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>>;
+};
 export {};

package/dist/tools/memory-recall.js

@@ -422,3 +422,92 @@ 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: "Read what you know about a speaker. Returns the full prose card with metadata. " +
+            "Use this when you need to remember who someone is, or before making a claim about them " +
+            "that might be wrong. Cross-reference with memory_search for deeper context.",
+        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) });
+            }
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xdarkicex/openclaw-memory-libravdb",
-  "version": "1.9.10-beta.16",
+  "version": "1.9.10-beta.17",
   "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"
   }
 }