@engramx/openclaw 0.16.0-rc.19 → 0.16.0-rc.20
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/README.md +8 -8
- package/dist/status.js +11 -1
- package/dist/status.js.map +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -104,17 +104,17 @@ the data, in whichever direction you ask for.
|
|
|
104
104
|
|
|
105
105
|
```bash
|
|
106
106
|
# 1. Pair this machine's agent — generate the key for this engram, pair it, install and configure the plugin
|
|
107
|
-
npx @engramx/client@0.16.0-rc.
|
|
107
|
+
npx @engramx/client@0.16.0-rc.20 pair <INVITE_CODE> --engram <CANISTER_ID> --target openclaw
|
|
108
108
|
|
|
109
109
|
# 2a. First machine — push existing local memory files up to the engram
|
|
110
|
-
npx @engramx/client@0.16.0-rc.
|
|
110
|
+
npx @engramx/client@0.16.0-rc.20 migrate --engram <CANISTER_ID>
|
|
111
111
|
|
|
112
112
|
# 2b. Replacement machine — restore database backups down from the engram instead
|
|
113
|
-
npx @engramx/client@0.16.0-rc.
|
|
113
|
+
npx @engramx/client@0.16.0-rc.20 migrate --engram <CANISTER_ID> --recover
|
|
114
114
|
```
|
|
115
115
|
|
|
116
116
|
`--recover` belongs to `migrate`; passing it to `pair` is refused with a message saying so. A local
|
|
117
|
-
checkpoint is saved before `migrate` changes anything — run `npx @engramx/client@0.16.0-rc.
|
|
117
|
+
checkpoint is saved before `migrate` changes anything — run `npx @engramx/client@0.16.0-rc.20 rollback` to undo.
|
|
118
118
|
After `--recover`, memory files sync automatically on next OpenClaw startup.
|
|
119
119
|
|
|
120
120
|
⟨2026-10-13⟩ The two commands above are now what `pair` does: it moves no memory unless you add
|
|
@@ -234,7 +234,7 @@ icp canister call <ENGRAM_ID> createAgentInvite \
|
|
|
234
234
|
-e local
|
|
235
235
|
|
|
236
236
|
# Pair and configure OpenClaw in one step
|
|
237
|
-
npx @engramx/client@0.16.0-rc.
|
|
237
|
+
npx @engramx/client@0.16.0-rc.20 pair <INVITE_CODE> --engram <ENGRAM_ID> --target openclaw --host http://localhost:4943
|
|
238
238
|
```
|
|
239
239
|
|
|
240
240
|
`--target openclaw` installs the plugin config in `~/.openclaw/openclaw.json` automatically.
|
|
@@ -306,15 +306,15 @@ If you lose your machine:
|
|
|
306
306
|
|
|
307
307
|
```bash
|
|
308
308
|
# On a clean machine — create a new agent invite from the dashboard, then:
|
|
309
|
-
npx @engramx/client@0.16.0-rc.
|
|
310
|
-
npx @engramx/client@0.16.0-rc.
|
|
309
|
+
npx @engramx/client@0.16.0-rc.20 pair <INVITE_CODE> --engram <CANISTER_ID> --target openclaw
|
|
310
|
+
npx @engramx/client@0.16.0-rc.20 migrate --engram <CANISTER_ID> --recover
|
|
311
311
|
```
|
|
312
312
|
|
|
313
313
|
`pair` pairs the agent again with a new key and installs the plugin; `migrate --recover` restores the latest
|
|
314
314
|
database backups (SQLite, QMD, LanceDB — whichever were detected) and saves a checkpoint. Memory
|
|
315
315
|
files sync automatically on next OpenClaw startup.
|
|
316
316
|
|
|
317
|
-
A local checkpoint is saved before any changes. Run `npx @engramx/client@0.16.0-rc.
|
|
317
|
+
A local checkpoint is saved before any changes. Run `npx @engramx/client@0.16.0-rc.20 rollback` to undo.
|
|
318
318
|
|
|
319
319
|
Restoring reads backups, so the new agent grant needs `canReadBackup` — see the invite note under
|
|
320
320
|
Local Development. Without it the restore is refused with a message naming the permission.
|
package/dist/status.js
CHANGED
|
@@ -38,6 +38,12 @@ export async function readCyclesRow(engram) {
|
|
|
38
38
|
return `(not read — ${err instanceof Error ? err.message : String(err)})`;
|
|
39
39
|
}
|
|
40
40
|
}
|
|
41
|
+
/** ⟨2026-10-29, review F1⟩ " (a active, e ended)" when the engram serves both parts, else "". */
|
|
42
|
+
function agentSplit(active, ended) {
|
|
43
|
+
return active.length === 1 && ended.length === 1
|
|
44
|
+
? ` (${active[0]} active, ${ended[0]} ended)`
|
|
45
|
+
: '';
|
|
46
|
+
}
|
|
41
47
|
/**
|
|
42
48
|
* Every row of the table, in order. Each row other than Canister, Host and Cycles reads a field
|
|
43
49
|
* that `about()` serves to every caller (`type About` in the engram's .did).
|
|
@@ -48,7 +54,11 @@ export async function engramStatusLines(engram, where) {
|
|
|
48
54
|
`Canister: ${where.canisterId}`,
|
|
49
55
|
`Host: ${where.host ?? 'https://ic0.app'}`,
|
|
50
56
|
`Memory files: ${about.memoryFileCount}`,
|
|
51
|
-
|
|
57
|
+
// ⟨2026-10-29, the owner's ruling: "agent count should report both active and inactive agents"⟩
|
|
58
|
+
// The total is every agent on the roster; the engram now serves which are active and which ended.
|
|
59
|
+
// ⟨2026-10-29, review F1⟩ The split is `opt` (ADR-0018 rule 1): an engram older than it serves
|
|
60
|
+
// none, and the row is then the total alone, never "undefined active".
|
|
61
|
+
`Agents: ${about.agentCount}${agentSplit(about.activeAgentCount, about.endedAgentCount)}`,
|
|
52
62
|
`Audit log: ${about.auditLogSize} entries`,
|
|
53
63
|
`Cycles: ${cycles}`,
|
|
54
64
|
`Backups: ${about.backupCount}`,
|
package/dist/status.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"status.js","sourceRoot":"","sources":["../status.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,+FAA+F;AAC/F,6FAA6F;AAC7F,EAAE;AACF,wFAAwF;AACxF,EAAE;AACF,kGAAkG;AAClG,kCAAkC;AAClC,mDAAmD;AACnD,EAAE;AACF,oGAAoG;AACpG,mFAAmF;AACnF,4FAA4F;AAC5F,mGAAmG;AACnG,+FAA+F;AAC/F,mGAAmG;AACnG,0FAA0F;AAE1F,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AASlD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,iDAAiD,CAAC;AAEjF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAmD;IAEnD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,eAAe,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,eAAe,CAAC;QACrF,OAAO,eAAe,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;IAC5E,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAA0B,EAC1B,KAAwD;IAExD,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACpF,OAAO;QACL,oBAAoB,KAAK,CAAC,UAAU,EAAE;QACtC,oBAAoB,KAAK,CAAC,IAAI,IAAI,iBAAiB,EAAE;QACrD,oBAAoB,KAAK,CAAC,eAAe,EAAE;QAC3C,oBAAoB,KAAK,CAAC,UAAU,EAAE;
|
|
1
|
+
{"version":3,"file":"status.js","sourceRoot":"","sources":["../status.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,+FAA+F;AAC/F,6FAA6F;AAC7F,EAAE;AACF,wFAAwF;AACxF,EAAE;AACF,kGAAkG;AAClG,kCAAkC;AAClC,mDAAmD;AACnD,EAAE;AACF,oGAAoG;AACpG,mFAAmF;AACnF,4FAA4F;AAC5F,mGAAmG;AACnG,+FAA+F;AAC/F,mGAAmG;AACnG,0FAA0F;AAE1F,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AASlD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,iDAAiD,CAAC;AAEjF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAmD;IAEnD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,eAAe,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,eAAe,CAAC;QACrF,OAAO,eAAe,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;IAC5E,CAAC;AACH,CAAC;AAED,iGAAiG;AACjG,SAAS,UAAU,CAAC,MAAqB,EAAE,KAAoB;IAC7D,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAC9C,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS;QAC7C,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAA0B,EAC1B,KAAwD;IAExD,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACpF,OAAO;QACL,oBAAoB,KAAK,CAAC,UAAU,EAAE;QACtC,oBAAoB,KAAK,CAAC,IAAI,IAAI,iBAAiB,EAAE;QACrD,oBAAoB,KAAK,CAAC,eAAe,EAAE;QAC3C,gGAAgG;QAChG,kGAAkG;QAClG,+FAA+F;QAC/F,uEAAuE;QACvE,oBAAoB,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,eAAe,CAAC,EAAE;QAClG,oBAAoB,KAAK,CAAC,YAAY,UAAU;QAChD,oBAAoB,MAAM,EAAE;QAC5B,oBAAoB,KAAK,CAAC,WAAW,EAAE;QACvC,oBAAoB,KAAK,CAAC,OAAO,EAAE;QACnC,oBAAoB,KAAK,CAAC,YAAY,EAAE;QACxC,oBAAoB,KAAK,CAAC,cAAc,EAAE;KAC3C,CAAC;AACJ,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@engramx/openclaw",
|
|
3
|
-
"version": "0.16.0-rc.
|
|
3
|
+
"version": "0.16.0-rc.20",
|
|
4
4
|
"description": "EngramX memory plugin for OpenClaw — persistent, decentralized agent memory",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"author": "EngramX <developer@engramx.ai>",
|
|
@@ -27,7 +27,7 @@
|
|
|
27
27
|
},
|
|
28
28
|
"//openclaw": "openclaw (>=2026.1.26) is the HOST platform that loads this plugin at runtime — it is intentionally NOT declared as a dependency or peer. Declaring it (even as an optional peer) makes pnpm auto-install the entire OpenClaw AI-platform tree (Pi Agent, AWS Bedrock SDK, etc. — dozens of advisories + a postinstall script) into the dev install, which EngramX never ships. When developing this plugin against the host, install openclaw yourself.",
|
|
29
29
|
"dependencies": {
|
|
30
|
-
"@engramx/client": "^0.16.0-rc.
|
|
30
|
+
"@engramx/client": "^0.16.0-rc.20",
|
|
31
31
|
"@icp-sdk/core": "^6.1.1",
|
|
32
32
|
"@sinclair/typebox": "^0.34.52"
|
|
33
33
|
},
|