@bamdra/bamdra-openclaw-memory 0.3.4 → 0.3.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@bamdra/bamdra-openclaw-memory",
3
- "version": "0.3.4",
3
+ "version": "0.3.5",
4
4
  "description": "Unified topic-aware memory plugin for OpenClaw with durable SQLite recall and bounded context growth.",
5
5
  "license": "MIT",
6
6
  "homepage": "https://www.bamdra.com",
@@ -59,8 +59,8 @@
59
59
  }
60
60
  },
61
61
  "dependencies": {
62
- "@bamdra/bamdra-user-bind": "^0.1.1",
63
- "@bamdra/bamdra-memory-vector": "^0.1.1"
62
+ "@bamdra/bamdra-user-bind": "^0.1.2",
63
+ "@bamdra/bamdra-memory-vector": "^0.1.2"
64
64
  },
65
65
  "devDependencies": {
66
66
  "@types/node": "^24.5.2"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@bamdra/bamdra-openclaw-memory",
3
- "version": "0.3.4",
3
+ "version": "0.3.5",
4
4
  "description": "Unified topic-aware memory plugin for OpenClaw with durable SQLite recall and bounded context growth.",
5
5
  "license": "MIT",
6
6
  "homepage": "https://www.bamdra.com",
@@ -32,6 +32,10 @@
32
32
  "engines": {
33
33
  "node": ">=22"
34
34
  },
35
+ "scripts": {
36
+ "bundle": "node ../../scripts/run-local-bin.mjs tsup && cp ../../packages/memory-sqlite/src/schema.sql ./dist/ && node ../../scripts/prepare-plugin-dist.mjs bamdra-openclaw-memory",
37
+ "prepublishOnly": "pnpm run bundle"
38
+ },
35
39
  "openclaw": {
36
40
  "id": "bamdra-openclaw-memory",
37
41
  "type": "context-engine",
@@ -55,13 +59,10 @@
55
59
  }
56
60
  },
57
61
  "dependencies": {
58
- "@bamdra/bamdra-user-bind": "^0.1.1",
59
- "@bamdra/bamdra-memory-vector": "^0.1.1"
62
+ "@bamdra/bamdra-user-bind": "^0.1.2",
63
+ "@bamdra/bamdra-memory-vector": "^0.1.2"
60
64
  },
61
65
  "devDependencies": {
62
66
  "@types/node": "^24.5.2"
63
- },
64
- "scripts": {
65
- "bundle": "node ../../scripts/run-local-bin.mjs tsup && cp ../../packages/memory-sqlite/src/schema.sql ./dist/ && node ../../scripts/prepare-plugin-dist.mjs bamdra-openclaw-memory"
66
67
  }
67
- }
68
+ }
@@ -9,6 +9,8 @@ Use `bamdra-memory` tools to preserve continuity without making the conversation
9
9
 
10
10
  This skill is an optional behavior layer. It improves tool judgment, but the runtime memory chain must still be provided by the plugin itself.
11
11
 
12
+ Treat `bamdra-user-bind` as the primary user personalization layer. In practice it should cover most of what a per-user `USER.md` file would normally do: preferred address, long-lived preferences, role, personality notes, and other stable profile traits for the current bound user.
13
+
12
14
  ## Operating Goal
13
15
 
14
16
  Make memory feel natural:
@@ -18,6 +20,7 @@ Make memory feel natural:
18
20
  - recover prior context quietly when it helps
19
21
  - avoid leaking unrelated memory into the current answer
20
22
  - avoid narrating internal storage mechanics unless the user asks
23
+ - personalize tone and defaults from the bound user profile when that improves the response
21
24
 
22
25
  ## Decision Policy
23
26
 
@@ -31,6 +34,7 @@ Prefer memory tools when one of these is true:
31
34
  - the conversation appears to branch into a new thread
32
35
  - the answer may already exist in memory
33
36
  - the user explicitly asks to keep topics separate, resume an older branch, or start fresh
37
+ - the answer should adapt to a stable user preference or role that is likely already in the bound profile
34
38
 
35
39
  Do not reach for memory tools when one of these is true:
36
40
 
@@ -38,6 +42,26 @@ Do not reach for memory tools when one of these is true:
38
42
  - the user is casually brainstorming and has not signaled that a detail should persist
39
43
  - using a tool would add noise without improving continuity or accuracy
40
44
  - the request would cross agent or user boundaries that should remain isolated
45
+ - the profile signal is already sufficient and an extra memory lookup would only add noise
46
+
47
+ ## User Profile Policy
48
+
49
+ Treat the bound user profile as the first personalization source for the current user.
50
+
51
+ Use it for:
52
+
53
+ - preferred form of address
54
+ - stable output preferences such as tone, structure, formatting, or brevity
55
+ - role-aware defaults such as whether to optimize for management summaries, technical detail, or documentation quality
56
+ - personality or collaboration style cues when they improve phrasing
57
+
58
+ Do not use it for:
59
+
60
+ - making up facts that are not actually present in the bound profile
61
+ - inferring private details about other users
62
+ - overriding an explicit instruction the user gives in the current turn
63
+
64
+ If the current turn conflicts with the stored profile, follow the current turn and let later updates refresh the profile deliberately.
41
65
 
42
66
  ## Topic Judgment
43
67
 
@@ -63,11 +87,17 @@ When uncertain:
63
87
 
64
88
  ## Tool Selection
65
89
 
66
- - Use `memory_save_fact` for stable facts the user is likely to expect later.
67
- - Use `memory_search` before asking the user to restate a stable fact or prior decision.
68
- - Use `memory_list_topics` when you need to inspect available branches before switching.
69
- - Use `memory_switch_topic` when the user clearly wants to move to, resume, or isolate a branch.
70
- - Use `memory_compact_topic` after a branch has materially changed and its summary is stale.
90
+ - Use `bamdra_memory_save_fact` for stable facts the user is likely to expect later.
91
+ - Use `bamdra_memory_search` before asking the user to restate a stable fact or prior decision.
92
+ - Use `bamdra_memory_list_topics` when you need to inspect available branches before switching.
93
+ - Use `bamdra_memory_switch_topic` when the user clearly wants to move to, resume, or isolate a branch.
94
+ - Use `bamdra_memory_compact_topic` after a branch has materially changed and its summary is stale.
95
+
96
+ If `bamdra-memory-vector` is enabled, treat `bamdra_memory_search` as a hybrid recall entrypoint rather than a pure keyword lookup. Use it especially when:
97
+
98
+ - the user references something fuzzily
99
+ - the user says “之前提过”, “你还记得吗”, “知识库里有没有”
100
+ - the answer may live in shared Markdown knowledge, not only session memory
71
101
 
72
102
  ## Privacy And Isolation
73
103
 
@@ -75,6 +105,7 @@ When uncertain:
75
105
  - Respect user isolation. Do not retrieve or reveal information outside the current user/session boundary.
76
106
  - Do not surface unrelated facts from memory just because they were found.
77
107
  - If memory retrieval feels privacy-sensitive or contextually risky, narrow the search or answer conservatively.
108
+ - Treat `bamdra-user-bind` profile data as private-by-default user context, not as a global team directory.
78
109
 
79
110
  ## Working Style
80
111
 
@@ -82,3 +113,4 @@ When uncertain:
82
113
  - Mention it briefly only when it helps the user trust continuity.
83
114
  - Use normal conversational language rather than tool narration.
84
115
  - Do not explain topic IDs, database actions, or storage internals unless asked.
116
+ - Let personalization feel natural. The user should experience it as “you remembered me”, not as “you loaded my profile record”.
package/LICENSE DELETED
@@ -1,21 +0,0 @@
1
- MIT License
2
-
3
- Copyright (c) 2026
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.