@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 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.19 pair <INVITE_CODE> --engram <CANISTER_ID> --target openclaw
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.19 migrate --engram <CANISTER_ID>
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.19 migrate --engram <CANISTER_ID> --recover
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.19 rollback` to undo.
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.19 pair <INVITE_CODE> --engram <ENGRAM_ID> --target openclaw --host http://localhost:4943
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.19 pair <INVITE_CODE> --engram <CANISTER_ID> --target openclaw
310
- npx @engramx/client@0.16.0-rc.19 migrate --engram <CANISTER_ID> --recover
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.19 rollback` to undo.
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
- `Agents: ${about.agentCount}`,
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}`,
@@ -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;QACtC,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"}
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.19",
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.19",
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
  },