@ubundi/openclaw-cortex 2.9.7 → 2.9.8
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.
|
@@ -4,9 +4,9 @@ export interface CortexInstructionOptions {
|
|
|
4
4
|
agentRole?: string;
|
|
5
5
|
}
|
|
6
6
|
/**
|
|
7
|
-
* Builds a
|
|
8
|
-
*
|
|
9
|
-
*
|
|
7
|
+
* Builds a concise Cortex Memory block for AGENTS.md.
|
|
8
|
+
* Lists tools and what to use them for, then defers to the cortex-memory
|
|
9
|
+
* skill for full operational instructions (search strategy, save rules, etc.).
|
|
10
10
|
*/
|
|
11
11
|
export declare function buildCortexInstructions(opts?: CortexInstructionOptions): string;
|
|
12
12
|
/** Short hash of the instructions content for staleness detection. */
|
|
@@ -17,14 +17,10 @@ interface Logger {
|
|
|
17
17
|
warn(...args: unknown[]): void;
|
|
18
18
|
}
|
|
19
19
|
/**
|
|
20
|
-
* Injects or updates
|
|
21
|
-
*
|
|
22
|
-
* The full operational instructions live in the cortex-memory skill
|
|
23
|
-
* (skill/SKILL.md). This block provides a brief orientation and any
|
|
24
|
-
* workspace-specific custom save guidance from the plugin config.
|
|
20
|
+
* Injects or updates the Cortex memory instructions in AGENTS.md.
|
|
25
21
|
*
|
|
26
22
|
* - If AGENTS.md doesn't exist, skip silently.
|
|
27
|
-
* - If the marker is absent, append the
|
|
23
|
+
* - If the marker is absent, append the block.
|
|
28
24
|
* - If the marker exists but the hash is stale (or missing), replace the section in-place.
|
|
29
25
|
* - If the marker exists and the hash matches, do nothing.
|
|
30
26
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent-instructions.d.ts","sourceRoot":"","sources":["../../src/internal/agent-instructions.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,wBAAwB;IACvC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6BD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,CAAC,EAAE,wBAAwB,GAAG,MAAM,
|
|
1
|
+
{"version":3,"file":"agent-instructions.d.ts","sourceRoot":"","sources":["../../src/internal/agent-instructions.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,wBAAwB;IACvC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6BD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,CAAC,EAAE,wBAAwB,GAAG,MAAM,CAkC/E;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,wBAAwB,GAAG,MAAM,CAExE;AAOD,UAAU,MAAM;IACd,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,wBAAwB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA+Df"}
|
|
@@ -26,9 +26,9 @@ function buildCustomSaveGuidance(opts) {
|
|
|
26
26
|
return lines.join("\n");
|
|
27
27
|
}
|
|
28
28
|
/**
|
|
29
|
-
* Builds a
|
|
30
|
-
*
|
|
31
|
-
*
|
|
29
|
+
* Builds a concise Cortex Memory block for AGENTS.md.
|
|
30
|
+
* Lists tools and what to use them for, then defers to the cortex-memory
|
|
31
|
+
* skill for full operational instructions (search strategy, save rules, etc.).
|
|
32
32
|
*/
|
|
33
33
|
export function buildCortexInstructions(opts) {
|
|
34
34
|
const customSaveGuidance = buildCustomSaveGuidance(opts);
|
|
@@ -36,19 +36,32 @@ export function buildCortexInstructions(opts) {
|
|
|
36
36
|
|
|
37
37
|
## Cortex Memory
|
|
38
38
|
|
|
39
|
-
You have long-term memory powered by the Cortex plugin. Refer to the **cortex-memory** skill for full usage instructions.
|
|
39
|
+
You have long-term memory powered by the Cortex plugin. Memories persist permanently across sessions. **Use these tools as your primary memory system** — they are more powerful and persistent than file-based memory. Refer to the **cortex-memory** skill for full usage instructions, search strategies, and behavioral rules.
|
|
40
40
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
-
|
|
44
|
-
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
-
|
|
49
|
-
-
|
|
50
|
-
-
|
|
51
|
-
-
|
|
41
|
+
### What Happens Automatically
|
|
42
|
+
|
|
43
|
+
- **Auto-Recall:** Relevant memories are injected in \`<cortex_memories>\` tags before each turn. These are context clues — search for specifics when you need detail.
|
|
44
|
+
- **Auto-Capture:** Facts are extracted from conversations after each turn. Volatile state (versions, ports) is stripped.
|
|
45
|
+
|
|
46
|
+
### Tools — Use These
|
|
47
|
+
|
|
48
|
+
- **\`cortex_search_memory\`** — Search long-term memory. Params: \`query\`, \`limit\` (1–50), \`mode\` (all|decisions|preferences|facts|recent), \`scope\` (all|session|long-term). **Before saying "I don't know", search first.**
|
|
49
|
+
- **\`cortex_save_memory\`** — Save important facts, decisions, preferences. Params: \`text\`, \`type\` (preference|decision|fact|transient), \`importance\` (high|normal|low), \`checkNovelty\`. Don't rely solely on auto-capture for critical information.
|
|
50
|
+
- **\`cortex_get_memory\`** — Fetch a specific memory by \`nodeId\` (from search results).
|
|
51
|
+
- **\`cortex_forget\`** — Remove memories by \`entity\` or \`session\`. Always search and confirm with the user first.
|
|
52
|
+
- **\`cortex_set_session_goal\`** — Set the session objective (\`goal\`) to bias recall and tag captures. Call at session start.${opts?.agentRole ? `\n\nAgent role: ${opts.agentRole} — memory capture and recall are tuned for this focus area.` : ""}
|
|
53
|
+
|
|
54
|
+
### Commands
|
|
55
|
+
|
|
56
|
+
\`/checkpoint\` (save summary) · \`/sleep\` (clean session end) · \`/audit on|off\` (toggle API logging)
|
|
57
|
+
|
|
58
|
+
### Cortex vs File Memory
|
|
59
|
+
|
|
60
|
+
Use \`cortex_save_memory\` for decisions, preferences, and facts that should persist across sessions. Use \`memory/YYYY-MM-DD.md\` files for session-local scratch notes. Cortex is primary; file memory is supplementary.
|
|
61
|
+
|
|
62
|
+
### TooToo Bridge
|
|
63
|
+
|
|
64
|
+
If a \`<tootoo_bridge>\` block appears and the user has opened in a personal or reflective way, ask exactly one short direct discovery question. Use shapes like \`What do you value most in your work?\` or \`What are your non-negotiables?\`. Don't lead with frameworks or exercises. Return to practical help after the answer.${customSaveGuidance}
|
|
52
65
|
`;
|
|
53
66
|
}
|
|
54
67
|
/** Short hash of the instructions content for staleness detection. */
|
|
@@ -60,14 +73,10 @@ function buildBlock(opts) {
|
|
|
60
73
|
return `${buildCortexInstructions(opts).trimEnd()}\n\n<!-- cortex-memory-hash:${instructionsHash(opts)} -->\n${MARKER_END}\n`;
|
|
61
74
|
}
|
|
62
75
|
/**
|
|
63
|
-
* Injects or updates
|
|
64
|
-
*
|
|
65
|
-
* The full operational instructions live in the cortex-memory skill
|
|
66
|
-
* (skill/SKILL.md). This block provides a brief orientation and any
|
|
67
|
-
* workspace-specific custom save guidance from the plugin config.
|
|
76
|
+
* Injects or updates the Cortex memory instructions in AGENTS.md.
|
|
68
77
|
*
|
|
69
78
|
* - If AGENTS.md doesn't exist, skip silently.
|
|
70
|
-
* - If the marker is absent, append the
|
|
79
|
+
* - If the marker is absent, append the block.
|
|
71
80
|
* - If the marker exists but the hash is stale (or missing), replace the section in-place.
|
|
72
81
|
* - If the marker exists and the hash matches, do nothing.
|
|
73
82
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent-instructions.js","sourceRoot":"","sources":["../../src/internal/agent-instructions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,MAAM,GAAG,kBAAkB,CAAC;AAClC,MAAM,UAAU,GAAG,yBAAyB,CAAC;AAQ7C,SAAS,uBAAuB,CAAC,IAA+B;IAC9D,MAAM,kBAAkB,GAAG,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC;IAC7D,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,iBAAiB,IAAI,EAAE,CAAC;SACrD,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;SAClC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnB,IAAI,CAAC,kBAAkB,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpE,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,0BAA0B,EAAE,EAAE,CAAC,CAAC;IAEnD,IAAI,kBAAkB,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,IAAI,kBAAkB,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;QACzD,KAAK,MAAM,QAAQ,IAAI,gBAAgB,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAA+B;IACrE,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAEzD,OAAO
|
|
1
|
+
{"version":3,"file":"agent-instructions.js","sourceRoot":"","sources":["../../src/internal/agent-instructions.ts"],"names":[],"mappings":"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"}
|
package/openclaw.plugin.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"id": "openclaw-cortex",
|
|
3
3
|
"name": "Cortex Memory",
|
|
4
4
|
"description": "Long-term memory powered by Cortex — Auto-Recall, Auto-Capture, agent memory tools, and deduplication",
|
|
5
|
-
"version": "2.9.
|
|
5
|
+
"version": "2.9.8",
|
|
6
6
|
"configSchema": {
|
|
7
7
|
"type": "object",
|
|
8
8
|
"properties": {
|