@bamdra/bamdra-openclaw-memory 0.3.0 → 0.3.2

package/dist/index.js

@@ -218,9 +218,9 @@ function stableKeyFragment(text) {
 // ../../packages/memory-cache-memory/src/index.ts
 function logCacheEvent(event, details = {}) {
   try {
-    console.info("[bamdra-memory-cache]", event, JSON.stringify(details));
+    console.info("[bamdra-openclaw-memory-cache]", event, JSON.stringify(details));
   } catch {
-    console.info("[bamdra-memory-cache]", event);
+    console.info("[bamdra-openclaw-memory-cache]", event);
   }
 }
 var InMemoryCacheStore = class {
@@ -291,7 +291,17 @@ var import_promises = require("node:fs/promises");
 var import_node_path = require("node:path");
 var import_node_sqlite = require("node:sqlite");
 var import_node_url = require("node:url");
-var SCHEMA_VERSION = 1;
+var SCHEMA_VERSION = 2;
+var TABLES = {
+  schemaMigrations: "bamdra_memory_schema_migrations",
+  messages: "bamdra_memory_messages",
+  topics: "bamdra_memory_topics",
+  topicMembership: "bamdra_memory_topic_membership",
+  facts: "bamdra_memory_facts",
+  factTags: "bamdra_memory_fact_tags",
+  contextSnapshots: "bamdra_memory_context_snapshots",
+  sessionState: "bamdra_memory_session_state"
+};
 var MemorySqliteStore = class {
   constructor(options) {
     this.options = options;
@@ -305,15 +315,19 @@ var MemorySqliteStore = class {
   async applyMigrations() {
     const schemaSql = await loadSchemaSql();
     this.db.exec(schemaSql);
+    applyUserIdentityMigrations(this.db);
   }
   async close() {
     this.db.close();
   }
   async upsertMessage(record) {
     this.db.prepare(
-      `INSERT INTO messages (
+      `INSERT INTO ${TABLES.messages} (
           id,
           session_id,
+          user_id,
+          channel_type,
+          sender_open_id,
           turn_id,
           parent_turn_id,
           role,
@@ -321,9 +335,12 @@ var MemorySqliteStore = class {
           text,
           ts,
           raw_json
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
         ON CONFLICT(id) DO UPDATE SET
           session_id = excluded.session_id,
+          user_id = excluded.user_id,
+          channel_type = excluded.channel_type,
+          sender_open_id = excluded.sender_open_id,
           turn_id = excluded.turn_id,
           parent_turn_id = excluded.parent_turn_id,
           role = excluded.role,
@@ -334,6 +351,9 @@ var MemorySqliteStore = class {
     ).run(
       record.id,
       record.sessionId,
+      record.userId,
+      record.channelType,
+      record.senderOpenId,
       record.turnId,
       record.parentTurnId,
       record.role,
@@ -345,28 +365,31 @@ var MemorySqliteStore = class {
   }
   async getSessionState(sessionId) {
     const row = this.db.prepare(
-      `SELECT session_id, active_topic_id, last_compacted_at, last_turn_id, updated_at
-         FROM session_state
+      `SELECT session_id, user_id, active_topic_id, last_compacted_at, last_turn_id, updated_at
+         FROM ${TABLES.sessionState}
          WHERE session_id = ?`
     ).get(sessionId);
     return row ? mapSessionStateRow(row) : null;
   }
   async upsertSessionState(record) {
     this.db.prepare(
-      `INSERT INTO session_state (
+      `INSERT INTO ${TABLES.sessionState} (
           session_id,
+          user_id,
           active_topic_id,
           last_compacted_at,
           last_turn_id,
           updated_at
-        ) VALUES (?, ?, ?, ?, ?)
+        ) VALUES (?, ?, ?, ?, ?, ?)
         ON CONFLICT(session_id) DO UPDATE SET
+          user_id = excluded.user_id,
           active_topic_id = excluded.active_topic_id,
           last_compacted_at = excluded.last_compacted_at,
           last_turn_id = excluded.last_turn_id,
           updated_at = excluded.updated_at`
     ).run(
       record.sessionId,
+      record.userId,
       record.activeTopicId,
       record.lastCompactedAt,
       record.lastTurnId,
@@ -378,6 +401,7 @@ var MemorySqliteStore = class {
       `SELECT
           id,
           session_id,
+          user_id,
           title,
           status,
           parent_topic_id,
@@ -387,7 +411,7 @@ var MemorySqliteStore = class {
           labels_json,
           created_at,
           last_active_at
-         FROM topics
+         FROM ${TABLES.topics}
          WHERE session_id = ?
          ORDER BY last_active_at DESC`
     ).all(sessionId);
@@ -398,6 +422,7 @@ var MemorySqliteStore = class {
       `SELECT
           id,
           session_id,
+          user_id,
           title,
           status,
           parent_topic_id,
@@ -407,16 +432,17 @@ var MemorySqliteStore = class {
           labels_json,
           created_at,
           last_active_at
-         FROM topics
+         FROM ${TABLES.topics}
          WHERE id = ?`
     ).get(topicId);
     return row ? mapTopicRow(row) : null;
   }
   async upsertTopic(record) {
     this.db.prepare(
-      `INSERT INTO topics (
+      `INSERT INTO ${TABLES.topics} (
           id,
           session_id,
+          user_id,
           title,
           status,
           parent_topic_id,
@@ -426,9 +452,10 @@ var MemorySqliteStore = class {
           labels_json,
           created_at,
           last_active_at
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
         ON CONFLICT(id) DO UPDATE SET
           session_id = excluded.session_id,
+          user_id = excluded.user_id,
           title = excluded.title,
           status = excluded.status,
           parent_topic_id = excluded.parent_topic_id,
@@ -441,6 +468,7 @@ var MemorySqliteStore = class {
     ).run(
       record.id,
       record.sessionId,
+      record.userId,
       record.title,
       record.status,
       record.parentTopicId,
@@ -454,7 +482,7 @@ var MemorySqliteStore = class {
   }
   async upsertTopicMembership(record) {
     this.db.prepare(
-      `INSERT INTO topic_membership (
+      `INSERT INTO ${TABLES.topicMembership} (
           message_id,
           topic_id,
           score,
@@ -480,7 +508,7 @@ var MemorySqliteStore = class {
     this.db.exec("BEGIN");
     try {
       this.db.prepare(
-        `INSERT INTO facts (
+        `INSERT INTO ${TABLES.facts} (
             id,
             scope,
             category,
@@ -517,9 +545,9 @@ var MemorySqliteStore = class {
         record.sourceTopicId,
         record.updatedAt
       );
-      this.db.prepare(`DELETE FROM fact_tags WHERE fact_id = ?`).run(record.id);
+      this.db.prepare(`DELETE FROM ${TABLES.factTags} WHERE fact_id = ?`).run(record.id);
       const insertTag = this.db.prepare(
-        `INSERT INTO fact_tags (fact_id, tag) VALUES (?, ?)`
+        `INSERT INTO ${TABLES.factTags} (fact_id, tag) VALUES (?, ?)`
       );
       for (const tag of tags) {
         insertTag.run(record.id, tag);
@@ -545,8 +573,8 @@ var MemorySqliteStore = class {
           f.source_topic_id,
           f.updated_at,
           COALESCE(json_group_array(ft.tag) FILTER (WHERE ft.tag IS NOT NULL), '[]') AS tags_json
-         FROM facts f
-         LEFT JOIN fact_tags ft ON ft.fact_id = f.id
+         FROM ${TABLES.facts} f
+         LEFT JOIN ${TABLES.factTags} ft ON ft.fact_id = f.id
          WHERE f.scope = ?
          GROUP BY
           f.id,
@@ -584,9 +612,9 @@ var MemorySqliteStore = class {
           f.source_topic_id,
           f.updated_at,
           COALESCE(json_group_array(DISTINCT ft_all.tag) FILTER (WHERE ft_all.tag IS NOT NULL), '[]') AS tags_json
-         FROM facts f
-         JOIN fact_tags ft_match ON ft_match.fact_id = f.id
-         LEFT JOIN fact_tags ft_all ON ft_all.fact_id = f.id
+         FROM ${TABLES.facts} f
+         JOIN ${TABLES.factTags} ft_match ON ft_match.fact_id = f.id
+         LEFT JOIN ${TABLES.factTags} ft_all ON ft_all.fact_id = f.id
          WHERE ft_match.tag IN (${tagPlaceholders})
            AND f.recall_policy IN (${recallPolicyPlaceholders})
          GROUP BY
@@ -616,6 +644,9 @@ var MemorySqliteStore = class {
           tm.created_at,
           m.id,
           m.session_id,
+          m.user_id,
+          m.channel_type,
+          m.sender_open_id,
           m.turn_id,
           m.parent_turn_id,
           m.role,
@@ -623,8 +654,8 @@ var MemorySqliteStore = class {
           m.text,
           m.ts,
           m.raw_json
-         FROM topic_membership tm
-         JOIN messages m ON m.id = tm.message_id
+         FROM ${TABLES.topicMembership} tm
+         JOIN ${TABLES.messages} m ON m.id = tm.message_id
          WHERE tm.topic_id = ?
          ORDER BY m.ts DESC
          LIMIT ?`
@@ -650,7 +681,7 @@ var MemorySqliteStore = class {
           labels_json,
           created_at,
           last_active_at
-         FROM topics
+         FROM ${TABLES.topics}
          WHERE session_id = ?
            AND (
              lower(title) LIKE ? ESCAPE '\\'
@@ -671,6 +702,7 @@ var MemorySqliteStore = class {
     const likeValue = `%${escapeLike(normalizedQuery)}%`;
     const topicScope = args.topicId ? `topic:${args.topicId}` : null;
     const sessionScope = `session:${args.sessionId}`;
+    const userScope = args.userId ? `user:${args.userId}` : null;
     const rows = this.db.prepare(
       `SELECT
           f.id,
@@ -685,15 +717,16 @@ var MemorySqliteStore = class {
           f.source_topic_id,
           f.updated_at,
           COALESCE(json_group_array(DISTINCT ft_all.tag) FILTER (WHERE ft_all.tag IS NOT NULL), '[]') AS tags_json
-         FROM facts f
-         LEFT JOIN fact_tags ft_match ON ft_match.fact_id = f.id
-         LEFT JOIN fact_tags ft_all ON ft_all.fact_id = f.id
+         FROM ${TABLES.facts} f
+         LEFT JOIN ${TABLES.factTags} ft_match ON ft_match.fact_id = f.id
+         LEFT JOIN ${TABLES.factTags} ft_all ON ft_all.fact_id = f.id
          WHERE (
             f.scope IN ('global', 'shared')
             OR f.scope = ?
             OR f.scope = ?
+            OR f.scope = ?
             OR f.source_topic_id IN (
-              SELECT id FROM topics WHERE session_id = ?
+              SELECT id FROM ${TABLES.topics} WHERE session_id = ? AND (? IS NULL OR user_id = ?)
             )
          )
            AND (
@@ -716,7 +749,19 @@ var MemorySqliteStore = class {
           f.updated_at
          ORDER BY f.updated_at DESC
          LIMIT ?`
-    ).all(sessionScope, topicScope, args.sessionId, likeValue, likeValue, likeValue, likeValue, args.limit);
+    ).all(
+      sessionScope,
+      topicScope,
+      userScope,
+      args.sessionId,
+      args.userId ?? null,
+      args.userId ?? null,
+      likeValue,
+      likeValue,
+      likeValue,
+      likeValue,
+      args.limit
+    );
     return rows.map((row) => mapFactSearchResult(row, normalizedQuery)).sort((a, b) => b.score - a.score);
   }
 };
@@ -738,6 +783,7 @@ async function loadSchemaSql() {
 function mapSessionStateRow(row) {
   return {
     sessionId: row.session_id,
+    userId: row.user_id,
     activeTopicId: row.active_topic_id,
     lastCompactedAt: row.last_compacted_at,
     lastTurnId: row.last_turn_id,
@@ -748,6 +794,7 @@ function mapTopicRow(row) {
   return {
     id: row.id,
     sessionId: row.session_id,
+    userId: row.user_id,
     title: row.title,
     status: row.status,
     parentTopicId: row.parent_topic_id,
@@ -787,7 +834,8 @@ function mapTopicSearchResult(row, normalizedQuery) {
   return {
     topic,
     score: scoreTopicSearch(topic, matchReasons),
-    matchReasons
+    matchReasons,
+    source: "topic"
   };
 }
 function mapFactSearchResult(row, normalizedQuery) {
@@ -802,7 +850,8 @@ function mapFactSearchResult(row, normalizedQuery) {
   return {
     fact,
     score: scoreFactSearch(fact, matchReasons),
-    matchReasons
+    matchReasons,
+    source: "fact"
   };
 }
 function mapRecentTopicMessageRow(row) {
@@ -818,6 +867,9 @@ function mapRecentTopicMessageRow(row) {
     message: {
       id: row.id,
       sessionId: row.session_id,
+      userId: row.user_id,
+      channelType: row.channel_type,
+      senderOpenId: row.sender_open_id,
       turnId: row.turn_id,
       parentTurnId: row.parent_turn_id,
       role: row.role,
@@ -877,6 +929,20 @@ function scoreFactSearch(fact, matchReasons) {
   }
   return score;
 }
+function applyUserIdentityMigrations(db) {
+  ensureColumn(db, TABLES.messages, "user_id", "TEXT");
+  ensureColumn(db, TABLES.messages, "channel_type", "TEXT");
+  ensureColumn(db, TABLES.messages, "sender_open_id", "TEXT");
+  ensureColumn(db, TABLES.topics, "user_id", "TEXT");
+  ensureColumn(db, TABLES.sessionState, "user_id", "TEXT");
+}
+function ensureColumn(db, tableName, columnName, columnSql) {
+  const rows = db.prepare(`PRAGMA table_info(${tableName})`).all();
+  if (rows.some((row) => row.name === columnName)) {
+    return;
+  }
+  db.exec(`ALTER TABLE ${tableName} ADD COLUMN ${columnName} ${columnSql}`);
+}
 
 // ../../packages/summary-refresher/src/index.ts
 var SummaryRefresher = class {
@@ -1117,10 +1183,12 @@ var STOP_TOKENS = /* @__PURE__ */ new Set([
   "topics"
 ]);
 
-// ../bamdra-memory-context-engine/src/index.ts
+// ../../packages/bamdra-memory-context-engine/src/index.ts
 var import_node_crypto = require("crypto");
 var import_node_os = require("os");
 var import_node_path2 = require("node:path");
+var USER_BIND_GLOBAL_KEY = "__OPENCLAW_BAMDRA_USER_BIND__";
+var VECTOR_GLOBAL_KEY = "__OPENCLAW_BAMDRA_MEMORY_VECTOR__";
 var DEFAULT_DB_PATH = (0, import_node_path2.join)(
   (0, import_node_os.homedir)(),
   ".openclaw",
@@ -1129,9 +1197,9 @@ var DEFAULT_DB_PATH = (0, import_node_path2.join)(
 );
 function logMemoryEvent(event, details = {}) {
   try {
-    console.info("[bamdra-memory]", event, JSON.stringify(details));
+    console.info("[bamdra-openclaw-memory]", event, JSON.stringify(details));
   } catch {
-    console.info("[bamdra-memory]", event);
+    console.info("[bamdra-openclaw-memory]", event);
   }
 }
 function createContextEngineMemoryV2Plugin(inputConfig, api) {
@@ -1156,7 +1224,7 @@ function createContextEngineMemoryV2Plugin(inputConfig, api) {
   }
   let hooksRegistered = false;
   const plugin = {
-    name: "bamdra-memory-context-engine",
+    name: "bamdra-openclaw-memory",
     type: "context-engine",
     slot: "memory",
     capabilities: ["memory"],
@@ -1260,6 +1328,7 @@ function createContextEngineMemoryV2Plugin(inputConfig, api) {
         throw new Error(`Topic ${topicId} does not belong to session ${sessionId}`);
       }
       const now = (/* @__PURE__ */ new Date()).toISOString();
+      const userId = getResolvedUserId(sessionId);
       await cache.setSessionState(sessionId, {
         activeTopicId: topicId,
         updatedAt: now
@@ -1273,6 +1342,7 @@ function createContextEngineMemoryV2Plugin(inputConfig, api) {
       await store.upsertTopic(updatedTopic);
       await store.upsertSessionState({
         sessionId,
+        userId,
         activeTopicId: topicId,
         lastCompactedAt: previousState?.lastCompactedAt ?? null,
         lastTurnId: previousState?.lastTurnId ?? null,
@@ -1287,8 +1357,9 @@ function createContextEngineMemoryV2Plugin(inputConfig, api) {
       const sessionState = await resolveSessionState(store, cache, args.sessionId);
       const resolvedTopicId = args.topicId ?? sessionState?.activeTopicId ?? null;
       const resolvedTopic = resolvedTopicId != null ? await store.getTopic(resolvedTopicId) : null;
+      const userId = getResolvedUserId(args.sessionId);
       const normalizedScope = normalizeFactScope(args.scope, args.sessionId);
-      const scope = normalizedScope ?? (resolvedTopic != null ? `topic:${resolvedTopic.id}` : "shared");
+      const scope = normalizedScope ?? (resolvedTopic != null ? `topic:${resolvedTopic.id}` : userId != null ? `user:${userId}` : "shared");
       const tags = dedupeTextItems([
         ...resolvedTopic?.labels ?? [],
         ...args.tags ?? [],
@@ -1313,6 +1384,15 @@ function createContextEngineMemoryV2Plugin(inputConfig, api) {
       if (resolvedTopic) {
         await refreshTopicSummary(store, summaryRefresher, config, resolvedTopic.id, now);
       }
+      pushVectorMemoryRecord({
+        userId,
+        sessionId: args.sessionId,
+        topicId: resolvedTopic?.id ?? null,
+        sourcePath: (0, import_node_path2.join)("user", userId ?? "shared", "facts", `${args.key}.md`),
+        title: args.key,
+        text: args.value,
+        tags
+      });
       logMemoryEvent("save-fact", {
         sessionId: args.sessionId,
         topicId: resolvedTopic?.id ?? null,
@@ -1346,6 +1426,7 @@ function createContextEngineMemoryV2Plugin(inputConfig, api) {
       );
       await store.upsertSessionState({
         sessionId: args.sessionId,
+        userId: getResolvedUserId(args.sessionId),
         activeTopicId: sessionState?.activeTopicId ?? topic.id,
         lastCompactedAt: now,
         lastTurnId: sessionState?.lastTurnId ?? null,
@@ -1367,20 +1448,30 @@ function createContextEngineMemoryV2Plugin(inputConfig, api) {
       const sessionState = await resolveSessionState(store, cache, args.sessionId);
       const limit = args.limit ?? 5;
       const resolvedTopicId = args.topicId ?? sessionState?.activeTopicId ?? null;
+      const userId = getResolvedUserId(args.sessionId);
       const [topics, facts] = await Promise.all([
         store.searchTopics(args.sessionId, args.query, limit),
         store.searchFacts({
           sessionId: args.sessionId,
+          userId,
           query: args.query,
           topicId: resolvedTopicId,
           limit
         })
       ]);
+      const vectors = searchVectorMemory({
+        query: args.query,
+        userId,
+        topicId: resolvedTopicId,
+        limit
+      });
       return {
         sessionId: args.sessionId,
+        userId,
         query: args.query,
         topics,
-        facts
+        facts,
+        vectors
       };
     },
     async routeTopic(sessionId, text) {
@@ -1398,6 +1489,7 @@ function createContextEngineMemoryV2Plugin(inputConfig, api) {
       await ensureMigrations();
       const sessionState = await resolveSessionState(store, cache, sessionId);
       const topic = sessionState?.activeTopicId != null ? await store.getTopic(sessionState.activeTopicId) : null;
+      const userId = getResolvedUserId(sessionId);
       const recentMessages = topic != null ? await store.listRecentMessagesForTopic(
         topic.id,
         config.contextAssembly?.recentTurns ?? 6
@@ -1405,13 +1497,14 @@ function createContextEngineMemoryV2Plugin(inputConfig, api) {
       const alwaysFacts = await store.listFactsByScope("global");
       const sharedFacts = await store.listFactsByScope("shared");
       const sessionFacts = await store.listFactsByScope(`session:${sessionId}`);
+      const userFacts = userId != null ? await store.listFactsByScope(`user:${userId}`) : [];
       const scopedTopicFacts = topic != null ? await store.listFactsByScope(`topic:${topic.id}`) : [];
       const labelFacts = topic != null ? await store.listFactsByTags(topic.labels, ["always", "topic_bound"]) : [];
       return assembler.assemble({
         sessionId,
         topic,
         recentMessages,
-        alwaysFacts: dedupeFacts([...alwaysFacts, ...sharedFacts, ...sessionFacts]),
+        alwaysFacts: dedupeFacts([...alwaysFacts, ...sharedFacts, ...sessionFacts, ...userFacts]),
         topicFacts: dedupeFacts([...scopedTopicFacts, ...labelFacts])
       });
     },
@@ -1427,9 +1520,10 @@ function createContextEngineMemoryV2Plugin(inputConfig, api) {
         recentTopics
       });
       const now = (/* @__PURE__ */ new Date()).toISOString();
+      const userId = getResolvedUserId(sessionId);
       const topicId = decision.action === "spawn" ? createTopicId(sessionId, text) : decision.topicId;
       const messageId = (0, import_node_crypto.randomUUID)();
-      const topicRecord = decision.action === "spawn" ? createSpawnedTopic(sessionId, topicId, text, now, persistedState?.activeTopicId ?? null) : await store.getTopic(topicId);
+      const topicRecord = decision.action === "spawn" ? createSpawnedTopic(sessionId, userId, topicId, text, now, persistedState?.activeTopicId ?? null) : await store.getTopic(topicId);
       if (!topicRecord) {
         throw new Error(`Unable to resolve topic ${topicId} after routing`);
       }
@@ -1438,6 +1532,7 @@ function createContextEngineMemoryV2Plugin(inputConfig, api) {
       } else {
         await store.upsertTopic({
           ...topicRecord,
+          userId,
           status: "active",
           openLoops: mergeOpenLoops(topicRecord.openLoops, text),
           lastActiveAt: now
@@ -1446,6 +1541,9 @@ function createContextEngineMemoryV2Plugin(inputConfig, api) {
       const messageRecord = {
         id: messageId,
         sessionId,
+        userId,
+        channelType: getResolvedChannelType(sessionId),
+        senderOpenId: getResolvedSenderOpenId(sessionId),
         turnId: messageId,
         parentTurnId: persistedState?.lastTurnId ?? null,
         role: "user",
@@ -1484,12 +1582,22 @@ function createContextEngineMemoryV2Plugin(inputConfig, api) {
         );
       }
       await refreshTopicSummary(store, summaryRefresher, config, topicId, now);
+      pushVectorMemoryRecord({
+        userId,
+        sessionId,
+        topicId,
+        sourcePath: (0, import_node_path2.join)("user", userId ?? "shared", "topics", topicId, `${messageId}.md`),
+        title: deriveTopicTitle(text),
+        text,
+        tags: dedupeTextItems(topicRecord.labels)
+      });
       await cache.setSessionState(sessionId, {
         activeTopicId: topicId,
         updatedAt: now
       });
       await store.upsertSessionState({
         sessionId,
+        userId,
         activeTopicId: topicId,
         lastCompactedAt: persistedState?.lastCompactedAt ?? null,
         lastTurnId: messageId,
@@ -1497,6 +1605,7 @@ function createContextEngineMemoryV2Plugin(inputConfig, api) {
       });
       logMemoryEvent("route-and-track", {
         sessionId,
+        userId,
         action: decision.action,
         reason: decision.reason,
         topicId,
@@ -1519,6 +1628,7 @@ async function resolveSessionState(store, cache, sessionId) {
 function mapCachedStateToSessionState(sessionId, cached) {
   return {
     sessionId,
+    userId: getResolvedUserId(sessionId),
     activeTopicId: cached.activeTopicId,
     lastCompactedAt: null,
     lastTurnId: null,
@@ -1544,12 +1654,50 @@ function normalizeFactScope(scope, sessionId) {
   if (normalized === "session") {
     return `session:${sessionId}`;
   }
+  if (normalized === "user") {
+    const userId = getResolvedUserId(sessionId);
+    return userId != null ? `user:${userId}` : null;
+  }
   return normalized;
 }
-function createSpawnedTopic(sessionId, topicId, text, now, parentTopicId) {
+function getResolvedIdentity(sessionId) {
+  const api = globalThis[USER_BIND_GLOBAL_KEY];
+  if (!api?.getIdentityForSession) {
+    return null;
+  }
+  return api.getIdentityForSession(sessionId);
+}
+function getResolvedUserId(sessionId) {
+  const identity = getResolvedIdentity(sessionId);
+  const userId = identity?.userId;
+  return typeof userId === "string" && userId.trim() ? userId : null;
+}
+function getResolvedChannelType(sessionId) {
+  const identity = getResolvedIdentity(sessionId);
+  const channelType = identity?.channelType;
+  return typeof channelType === "string" && channelType.trim() ? channelType : null;
+}
+function getResolvedSenderOpenId(sessionId) {
+  const identity = getResolvedIdentity(sessionId);
+  const senderOpenId = identity?.senderOpenId;
+  return typeof senderOpenId === "string" && senderOpenId.trim() ? senderOpenId : null;
+}
+function pushVectorMemoryRecord(args) {
+  const api = globalThis[VECTOR_GLOBAL_KEY];
+  api?.upsertMemoryRecord?.(args);
+}
+function searchVectorMemory(args) {
+  const api = globalThis[VECTOR_GLOBAL_KEY];
+  if (!api?.search) {
+    return [];
+  }
+  return api.search(args);
+}
+function createSpawnedTopic(sessionId, userId, topicId, text, now, parentTopicId) {
   return {
     id: topicId,
     sessionId,
+    userId,
     title: deriveTopicTitle(text),
     status: "active",
     parentTopicId,
@@ -1772,15 +1920,32 @@ function buildBeforePromptBuildResult(assembled) {
 }
 
 // src/index.ts
+var import_node_fs2 = require("node:fs");
+var import_node_module = require("module");
+var import_node_os2 = require("os");
+var import_node_path3 = require("node:path");
 var PLUGIN_ID = "bamdra-openclaw-memory";
 var ENGINE_GLOBAL_KEY = "__OPENCLAW_BAMDRA_MEMORY_CONTEXT_ENGINE__";
-var TOOLS_REGISTERED_KEY = /* @__PURE__ */ Symbol.for("bamdra-memory.tools-registered");
-var ENGINE_REGISTERED_KEY = /* @__PURE__ */ Symbol.for("bamdra-memory.context-engine-registered");
+var TOOLS_REGISTERED_KEY = /* @__PURE__ */ Symbol.for("bamdra-openclaw-memory.tools-registered");
+var ENGINE_REGISTERED_KEY = /* @__PURE__ */ Symbol.for("bamdra-openclaw-memory.context-engine-registered");
+var BOOTSTRAP_STARTED_KEY = /* @__PURE__ */ Symbol.for("bamdra-openclaw-memory.host-bootstrap-started");
+var SKILL_ID = "bamdra-memory-operator";
+var REQUIRED_TOOL_NAMES = [
+  "memory_list_topics",
+  "memory_switch_topic",
+  "memory_save_fact",
+  "memory_compact_topic",
+  "memory_search"
+];
+var REQUIRED_PLUGIN_IDS = ["bamdra-user-bind"];
+var OPTIONAL_PLUGIN_IDS = ["bamdra-memory-vector"];
+var AUTO_PROVISION_PLUGIN_IDS = [...REQUIRED_PLUGIN_IDS, ...OPTIONAL_PLUGIN_IDS];
+var runtimeRequire = (0, import_node_module.createRequire)(__filename);
 function logUnifiedMemoryEvent(event, details = {}) {
   try {
-    console.info("[bamdra-memory]", event, JSON.stringify(details));
+    console.info("[bamdra-openclaw-memory]", event, JSON.stringify(details));
   } catch {
-    console.info("[bamdra-memory]", event);
+    console.info("[bamdra-openclaw-memory]", event);
   }
 }
 function register(api) {
@@ -1791,6 +1956,18 @@ async function activate(api) {
 }
 function initializeUnifiedPlugin(api, phase) {
   logUnifiedMemoryEvent(`${phase}-plugin`, { id: PLUGIN_ID });
+  if (!api[BOOTSTRAP_STARTED_KEY]) {
+    api[BOOTSTRAP_STARTED_KEY] = true;
+    queueMicrotask(() => {
+      try {
+        bootstrapOpenClawHost();
+      } catch (error) {
+        logUnifiedMemoryEvent("host-bootstrap-failed", {
+          message: error instanceof Error ? error.message : String(error)
+        });
+      }
+    });
+  }
   const engine = brandContextEngine(createContextEngineMemoryV2Plugin(api.pluginConfig ?? api.config, api));
   exposeContextEngine(engine);
   engine.registerHooks(api);
@@ -1826,8 +2003,7 @@ function exposeContextEngine(engine) {
 function registerUnifiedTools(api, engine) {
   const definitions = [
     createToolDefinitions({
-      canonicalName: "memory_list_topics",
-      aliasName: "bamdra_memory_list_topics",
+      name: "memory_list_topics",
       description: "List known topics for a session",
       parameters: {
         type: "object",
@@ -1842,8 +2018,7 @@ function registerUnifiedTools(api, engine) {
       }
     }),
     createToolDefinitions({
-      canonicalName: "memory_switch_topic",
-      aliasName: "bamdra_memory_switch_topic",
+      name: "memory_switch_topic",
       description: "Switch the active topic for a session",
       parameters: {
         type: "object",
@@ -1859,8 +2034,7 @@ function registerUnifiedTools(api, engine) {
       }
     }),
     createToolDefinitions({
-      canonicalName: "memory_save_fact",
-      aliasName: "bamdra_memory_save_fact",
+      name: "memory_save_fact",
       description: "Persist a pinned memory fact for the current or selected topic",
       parameters: {
         type: "object",
@@ -1886,8 +2060,7 @@ function registerUnifiedTools(api, engine) {
       }
     }),
     createToolDefinitions({
-      canonicalName: "memory_compact_topic",
-      aliasName: "bamdra_memory_compact_topic",
+      name: "memory_compact_topic",
       description: "Force refresh the summary for the current or selected topic",
       parameters: {
         type: "object",
@@ -1903,8 +2076,7 @@ function registerUnifiedTools(api, engine) {
       }
     }),
     createToolDefinitions({
-      canonicalName: "memory_search",
-      aliasName: "bamdra_memory_search",
+      name: "memory_search",
       description: "Search topics and durable facts for a session",
       parameters: {
         type: "object",
@@ -1930,20 +2102,20 @@ function registerUnifiedTools(api, engine) {
   }
 }
 function createToolDefinitions(definition) {
-  return [definition.canonicalName, definition.aliasName].map((name) => ({
-    name,
+  return [{
+    name: definition.name,
     description: definition.description,
     parameters: definition.parameters,
     async execute(invocationId, params) {
       const result = await definition.execute(params);
       logUnifiedMemoryEvent("tool-execute", {
-        name,
+        name: definition.name,
         invocationId,
         sessionId: params && typeof params === "object" && "sessionId" in params ? params.sessionId : null
       });
       return asTextResult(result);
     }
-  }));
+  }];
 }
 function asTextResult(value) {
   return {
@@ -1955,6 +2127,283 @@ function asTextResult(value) {
     ]
   };
 }
+function bootstrapOpenClawHost() {
+  const openclawHome = (0, import_node_path3.resolve)((0, import_node_os2.homedir)(), ".openclaw");
+  const extensionRoot = (0, import_node_path3.join)(openclawHome, "extensions");
+  const memoryRoot = (0, import_node_path3.join)(openclawHome, "memory");
+  const pluginRuntimeRoot = (0, import_node_path3.resolve)((0, import_node_path3.dirname)(__dirname));
+  const configPath = (0, import_node_path3.join)(openclawHome, "openclaw.json");
+  const globalSkillsDir = (0, import_node_path3.join)(openclawHome, "skills");
+  const bundledSkillDir = (0, import_node_path3.join)((0, import_node_path3.resolve)((0, import_node_path3.dirname)(__dirname)), "skills", SKILL_ID);
+  const targetSkillDir = (0, import_node_path3.join)(globalSkillsDir, SKILL_ID);
+  const forceBootstrap = process.env.OPENCLAW_BAMDRA_MEMORY_FORCE_BOOTSTRAP === "1";
+  if (!forceBootstrap && !pluginRuntimeRoot.startsWith(extensionRoot)) {
+    logUnifiedMemoryEvent("host-bootstrap-skipped", {
+      reason: "non-installed-runtime",
+      pluginRuntimeRoot
+    });
+    return;
+  }
+  if (!(0, import_node_fs2.existsSync)(configPath)) {
+    logUnifiedMemoryEvent("host-bootstrap-skipped", { reason: "missing-openclaw-config" });
+    return;
+  }
+  (0, import_node_fs2.mkdirSync)(openclawHome, { recursive: true });
+  (0, import_node_fs2.mkdirSync)(extensionRoot, { recursive: true });
+  (0, import_node_fs2.mkdirSync)(memoryRoot, { recursive: true });
+  materializeBundledDependencyPlugins(pluginRuntimeRoot, extensionRoot);
+  materializeBundledSkill(bundledSkillDir, targetSkillDir);
+  const original = (0, import_node_fs2.readFileSync)(configPath, "utf8");
+  const config = JSON.parse(original);
+  const changed = ensureHostConfig(config, targetSkillDir);
+  if (!changed) {
+    logUnifiedMemoryEvent("host-bootstrap-noop", { configPath });
+    return;
+  }
+  (0, import_node_fs2.writeFileSync)(configPath, `${JSON.stringify(config, null, 2)}
+`, "utf8");
+  logUnifiedMemoryEvent("host-bootstrap-updated", {
+    configPath,
+    targetSkillDir,
+    pluginId: PLUGIN_ID
+  });
+}
+function materializeBundledDependencyPlugins(pluginRuntimeRoot, extensionRoot) {
+  for (const pluginId of AUTO_PROVISION_PLUGIN_IDS) {
+    const targetDir = (0, import_node_path3.join)(extensionRoot, pluginId);
+    if ((0, import_node_fs2.existsSync)(targetDir)) {
+      continue;
+    }
+    const sourceDir = resolveBundledDependencySource(pluginRuntimeRoot, pluginId);
+    if (!sourceDir) {
+      logUnifiedMemoryEvent("dependency-plugin-copy-skipped", {
+        pluginId,
+        reason: "source-not-found"
+      });
+      continue;
+    }
+    (0, import_node_fs2.mkdirSync)((0, import_node_path3.dirname)(targetDir), { recursive: true });
+    (0, import_node_fs2.cpSync)(sourceDir, targetDir, { recursive: true });
+    logUnifiedMemoryEvent("dependency-plugin-copied", {
+      pluginId,
+      sourceDir,
+      targetDir
+    });
+  }
+}
+function resolveBundledDependencySource(pluginRuntimeRoot, pluginId) {
+  const packageNameByPluginId = {
+    "bamdra-user-bind": "@bamdra/bamdra-user-bind",
+    "bamdra-memory-vector": "@bamdra/bamdra-memory-vector"
+  };
+  const candidateRoots = [];
+  const packageName = packageNameByPluginId[pluginId];
+  if (packageName) {
+    try {
+      const packageJsonPath = runtimeRequire.resolve(`${packageName}/package.json`);
+      candidateRoots.push((0, import_node_path3.dirname)(packageJsonPath));
+    } catch {
+    }
+  }
+  candidateRoots.push((0, import_node_path3.join)(pluginRuntimeRoot, "bundled-plugins", pluginId));
+  candidateRoots.push((0, import_node_path3.resolve)(pluginRuntimeRoot, "..", "..", "..", pluginId));
+  for (const root of candidateRoots) {
+    const distDir = (0, import_node_fs2.existsSync)((0, import_node_path3.join)(root, "dist")) ? (0, import_node_path3.join)(root, "dist") : root;
+    if ((0, import_node_fs2.existsSync)((0, import_node_path3.join)(distDir, "index.js")) && (0, import_node_fs2.existsSync)((0, import_node_path3.join)(distDir, "openclaw.plugin.json")) && (0, import_node_fs2.existsSync)((0, import_node_path3.join)(distDir, "package.json"))) {
+      return distDir;
+    }
+  }
+  return null;
+}
+function materializeBundledSkill(sourceDir, targetDir) {
+  if (!(0, import_node_fs2.existsSync)(sourceDir)) {
+    logUnifiedMemoryEvent("skill-copy-skipped", {
+      reason: "missing-bundled-skill",
+      sourceDir
+    });
+    return;
+  }
+  if ((0, import_node_fs2.existsSync)(targetDir)) {
+    logUnifiedMemoryEvent("skill-copy-skipped", {
+      reason: "target-exists",
+      targetDir
+    });
+    return;
+  }
+  (0, import_node_fs2.mkdirSync)((0, import_node_path3.dirname)(targetDir), { recursive: true });
+  (0, import_node_fs2.cpSync)(sourceDir, targetDir, { recursive: true });
+  logUnifiedMemoryEvent("skill-copied", { sourceDir, targetDir });
+}
+function ensureHostConfig(config, targetSkillDir) {
+  let changed = false;
+  const plugins = ensureObject(config, "plugins");
+  const tools = ensureObject(config, "tools");
+  const skills = ensureObject(config, "skills");
+  const skillsLoad = ensureObject(skills, "load");
+  const agents = ensureObject(config, "agents");
+  const entries = ensureObject(plugins, "entries");
+  const installs = ensureObject(plugins, "installs");
+  const load = ensureObject(plugins, "load");
+  const slots = ensureObject(plugins, "slots");
+  const pluginEntry = ensureObject(entries, PLUGIN_ID);
+  const userBindEntry = ensureObject(entries, REQUIRED_PLUGIN_IDS[0]);
+  const vectorEntry = ensureObject(entries, OPTIONAL_PLUGIN_IDS[0]);
+  const pluginConfig = ensureObject(pluginEntry, "config");
+  const pluginStore = ensureObject(pluginConfig, "store");
+  const pluginCache = ensureObject(pluginConfig, "cache");
+  changed = ensureArrayIncludes(plugins, "allow", PLUGIN_ID) || changed;
+  for (const dependencyId of REQUIRED_PLUGIN_IDS) {
+    changed = ensureArrayIncludes(plugins, "allow", dependencyId) || changed;
+    const dependencyEntry = dependencyId === REQUIRED_PLUGIN_IDS[0] ? userBindEntry : ensureObject(entries, dependencyId);
+    if (dependencyEntry.enabled !== true) {
+      dependencyEntry.enabled = true;
+      changed = true;
+    }
+  }
+  for (const optionalId of OPTIONAL_PLUGIN_IDS) {
+    changed = ensureArrayIncludes(plugins, "allow", optionalId) || changed;
+  }
+  changed = ensureArrayIncludes(plugins, "deny", "memory-core") || changed;
+  changed = ensureArrayIncludes(load, "paths", (0, import_node_path3.join)((0, import_node_os2.homedir)(), ".openclaw", "extensions")) || changed;
+  changed = ensureArrayIncludes(skillsLoad, "extraDirs", (0, import_node_path3.join)((0, import_node_os2.homedir)(), ".openclaw", "skills")) || changed;
+  if (slots.memory !== PLUGIN_ID) {
+    slots.memory = PLUGIN_ID;
+    changed = true;
+  }
+  if (slots.contextEngine !== PLUGIN_ID) {
+    slots.contextEngine = PLUGIN_ID;
+    changed = true;
+  }
+  if (pluginEntry.enabled !== true) {
+    pluginEntry.enabled = true;
+    changed = true;
+  }
+  if (pluginConfig.enabled !== true) {
+    pluginConfig.enabled = true;
+    changed = true;
+  }
+  if (pluginStore.provider !== "sqlite") {
+    pluginStore.provider = "sqlite";
+    changed = true;
+  }
+  if (typeof pluginStore.path !== "string" || pluginStore.path.length === 0) {
+    pluginStore.path = "~/.openclaw/memory/main.sqlite";
+    changed = true;
+  }
+  if (pluginCache.provider !== "memory") {
+    pluginCache.provider = "memory";
+    changed = true;
+  }
+  if (typeof pluginCache.maxSessions !== "number") {
+    pluginCache.maxSessions = 128;
+    changed = true;
+  }
+  if (typeof userBindEntry.config !== "object" || userBindEntry.config == null) {
+    userBindEntry.config = {
+      enabled: true,
+      adminAgents: []
+    };
+    changed = true;
+  }
+  if (vectorEntry.enabled !== false) {
+    vectorEntry.enabled = false;
+    changed = true;
+  }
+  if (typeof vectorEntry.config !== "object" || vectorEntry.config == null) {
+    vectorEntry.config = {
+      enabled: false,
+      markdownRoot: "~/.openclaw/memory/vector/markdown",
+      privateMarkdownRoot: "~/.openclaw/memory/vector/markdown/private",
+      sharedMarkdownRoot: "~/.openclaw/memory/vector/markdown/shared",
+      indexPath: "~/.openclaw/memory/vector/index.json",
+      topK: 5
+    };
+    changed = true;
+  } else {
+    const vectorConfig = ensureObject(vectorEntry, "config");
+    if (vectorConfig.enabled !== false) {
+      vectorConfig.enabled = false;
+      changed = true;
+    }
+    if (typeof vectorConfig.markdownRoot !== "string" || vectorConfig.markdownRoot.length === 0) {
+      vectorConfig.markdownRoot = "~/.openclaw/memory/vector/markdown";
+      changed = true;
+    }
+    if (typeof vectorConfig.privateMarkdownRoot !== "string" || vectorConfig.privateMarkdownRoot.length === 0) {
+      vectorConfig.privateMarkdownRoot = "~/.openclaw/memory/vector/markdown/private";
+      changed = true;
+    }
+    if (typeof vectorConfig.sharedMarkdownRoot !== "string" || vectorConfig.sharedMarkdownRoot.length === 0) {
+      vectorConfig.sharedMarkdownRoot = "~/.openclaw/memory/vector/markdown/shared";
+      changed = true;
+    }
+    if (typeof vectorConfig.indexPath !== "string" || vectorConfig.indexPath.length === 0) {
+      vectorConfig.indexPath = "~/.openclaw/memory/vector/index.json";
+      changed = true;
+    }
+    if (typeof vectorConfig.topK !== "number") {
+      vectorConfig.topK = 5;
+      changed = true;
+    }
+  }
+  if (PLUGIN_ID in installs) {
+  }
+  changed = ensureToolAllowlist(tools) || changed;
+  changed = ensureAgentSkills(agents, SKILL_ID) || changed;
+  if (!(0, import_node_fs2.existsSync)(targetSkillDir)) {
+    logUnifiedMemoryEvent("host-bootstrap-skill-pending", { targetSkillDir });
+  }
+  return changed;
+}
+function ensureToolAllowlist(tools) {
+  let changed = false;
+  for (const toolName of REQUIRED_TOOL_NAMES) {
+    changed = ensureArrayIncludes(tools, "allow", toolName) || changed;
+  }
+  return changed;
+}
+function ensureAgentSkills(agents, skillId) {
+  const list = Array.isArray(agents.list) ? agents.list : [];
+  let changed = false;
+  for (const item of list) {
+    if (!item || typeof item !== "object") {
+      continue;
+    }
+    const agent = item;
+    const currentSkills = Array.isArray(agent.skills) ? [...agent.skills] : [];
+    if (!Array.isArray(agent.skills)) {
+      agent.skills = currentSkills;
+      changed = true;
+    }
+    if (!currentSkills.includes(skillId)) {
+      currentSkills.push(skillId);
+      agent.skills = currentSkills;
+      changed = true;
+    }
+  }
+  return changed;
+}
+function ensureObject(parent, key) {
+  const current = parent[key];
+  if (current && typeof current === "object" && !Array.isArray(current)) {
+    return current;
+  }
+  const next = {};
+  parent[key] = next;
+  return next;
+}
+function ensureArrayIncludes(parent, key, value) {
+  const current = Array.isArray(parent[key]) ? [...parent[key]] : [];
+  if (current.includes(value)) {
+    if (!Array.isArray(parent[key])) {
+      parent[key] = current;
+    }
+    return false;
+  }
+  current.push(value);
+  parent[key] = current;
+  return true;
+}
 // Annotate the CommonJS export names for ESM import in node:
 module.exports = {activate,
   register};