clawpowers 2.2.5 → 2.2.7

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.
Files changed (138) hide show
  1. package/CHANGELOG.md +186 -160
  2. package/COMPATIBILITY.md +48 -13
  3. package/KNOWN_LIMITATIONS.md +20 -19
  4. package/LICENSE +44 -44
  5. package/LICENSING.md +10 -10
  6. package/README.md +486 -462
  7. package/SECURITY.md +52 -52
  8. package/dist/index.d.ts +17 -5
  9. package/dist/index.js +187 -92
  10. package/dist/index.js.map +1 -1
  11. package/native/Cargo.lock +4927 -4927
  12. package/native/Cargo.toml +73 -73
  13. package/native/crates/canonical/Cargo.toml +24 -24
  14. package/native/crates/canonical/src/lib.rs +677 -673
  15. package/native/crates/compression/Cargo.toml +20 -20
  16. package/native/crates/compression/benches/compression_bench.rs +42 -42
  17. package/native/crates/compression/src/lib.rs +393 -393
  18. package/native/crates/evm-eth/Cargo.toml +13 -13
  19. package/native/crates/evm-eth/src/lib.rs +105 -105
  20. package/native/crates/fee/Cargo.toml +15 -15
  21. package/native/crates/fee/src/lib.rs +281 -281
  22. package/native/crates/index/Cargo.toml +16 -16
  23. package/native/crates/index/src/lib.rs +277 -277
  24. package/native/crates/policy/Cargo.toml +17 -17
  25. package/native/crates/policy/src/lib.rs +614 -614
  26. package/native/crates/security/Cargo.toml +22 -22
  27. package/native/crates/security/src/lib.rs +478 -478
  28. package/native/crates/tokens/Cargo.toml +13 -13
  29. package/native/crates/tokens/src/lib.rs +534 -534
  30. package/native/crates/verification/Cargo.toml +23 -23
  31. package/native/crates/verification/src/lib.rs +333 -333
  32. package/native/crates/wallet/Cargo.toml +20 -20
  33. package/native/crates/wallet/src/lib.rs +261 -261
  34. package/native/crates/x402/Cargo.toml +30 -30
  35. package/native/crates/x402/src/lib.rs +423 -423
  36. package/native/ffi/Cargo.toml +34 -34
  37. package/native/ffi/build.rs +4 -4
  38. package/native/ffi/src/lib.rs +352 -352
  39. package/native/ffi/tests/integration.rs +354 -354
  40. package/native/pyo3/Cargo.toml +26 -26
  41. package/native/pyo3/pyproject.toml +16 -16
  42. package/native/pyo3/src/lib.rs +407 -407
  43. package/native/pyo3/tests/test_smoke.py +180 -180
  44. package/native/wasm/Cargo.toml +47 -44
  45. package/native/wasm/pkg/.gitignore +6 -6
  46. package/native/wasm/pkg/clawpowers_wasm.d.ts +208 -208
  47. package/native/wasm/pkg/clawpowers_wasm.js +872 -872
  48. package/native/wasm/pkg/clawpowers_wasm_bg.wasm.d.ts +40 -40
  49. package/native/wasm/pkg/package.json +16 -16
  50. package/native/wasm/pkg-node/clawpowers_wasm.d.ts +143 -143
  51. package/native/wasm/pkg-node/clawpowers_wasm.js +798 -798
  52. package/native/wasm/pkg-node/clawpowers_wasm_bg.wasm.d.ts +40 -40
  53. package/native/wasm/pkg-node/package.json +12 -12
  54. package/native/wasm/src/lib.rs +433 -433
  55. package/package.json +13 -8
  56. package/scripts/build-wasm.mjs +59 -0
  57. package/scripts/generate_hermes_wrappers.py +211 -0
  58. package/scripts/hermes_wrapper_overrides.json +184 -0
  59. package/scripts/run-python-script.mjs +48 -0
  60. package/scripts/verify-consumer-install.mjs +109 -0
  61. package/scripts/verify-wasm-artifacts.mjs +26 -3
  62. package/scripts/verify_hermes_wrappers.py +154 -0
  63. package/skill.json +20 -0
  64. package/skills/1password/SKILL.md +34 -0
  65. package/skills/README.md +44 -0
  66. package/skills/agent-nexus-2/SKILL.md +34 -0
  67. package/skills/apple-notes/SKILL.md +34 -0
  68. package/skills/apple-reminders/SKILL.md +34 -0
  69. package/skills/autoresearch/SKILL.md +43 -0
  70. package/skills/bear-notes/SKILL.md +34 -0
  71. package/skills/blogwatcher/SKILL.md +34 -0
  72. package/skills/blucli/SKILL.md +34 -0
  73. package/skills/bluebubbles/SKILL.md +34 -0
  74. package/skills/business-strategy/SKILL.md +41 -0
  75. package/skills/camsnap/SKILL.md +34 -0
  76. package/skills/canvas/SKILL.md +34 -0
  77. package/skills/clawhub/SKILL.md +34 -0
  78. package/skills/coding-agent/SKILL.md +34 -0
  79. package/skills/coding-discipline.skill/SKILL.md +34 -0
  80. package/skills/content-writer/SKILL.md +41 -0
  81. package/skills/discord/SKILL.md +34 -0
  82. package/skills/eightctl/SKILL.md +34 -0
  83. package/skills/execution-validation.skill/SKILL.md +34 -0
  84. package/skills/gemini/SKILL.md +34 -0
  85. package/skills/gh-issues/SKILL.md +34 -0
  86. package/skills/gifgrep/SKILL.md +34 -0
  87. package/skills/github/SKILL.md +41 -0
  88. package/skills/gog/SKILL.md +34 -0
  89. package/skills/goplaces/SKILL.md +34 -0
  90. package/skills/healthcheck/SKILL.md +34 -0
  91. package/skills/himalaya/SKILL.md +34 -0
  92. package/skills/humanize/SKILL.md +41 -0
  93. package/skills/imsg/SKILL.md +34 -0
  94. package/skills/itp/SKILL.md +112 -0
  95. package/skills/mcporter/SKILL.md +34 -0
  96. package/skills/model-usage/SKILL.md +34 -0
  97. package/skills/nano-pdf/SKILL.md +34 -0
  98. package/skills/node-connect/SKILL.md +34 -0
  99. package/skills/notion/SKILL.md +34 -0
  100. package/skills/obsidian/SKILL.md +34 -0
  101. package/skills/openai-whisper/SKILL.md +34 -0
  102. package/skills/openai-whisper-api/SKILL.md +34 -0
  103. package/skills/openhue/SKILL.md +34 -0
  104. package/skills/oracle/SKILL.md +34 -0
  105. package/skills/ordercli/SKILL.md +34 -0
  106. package/skills/peekaboo/SKILL.md +34 -0
  107. package/skills/polyclaw/SKILL.md +34 -0
  108. package/skills/prospector/SKILL.md +41 -0
  109. package/skills/rsi.skill/SKILL.md +34 -0
  110. package/skills/sag/SKILL.md +34 -0
  111. package/skills/security/SKILL.md +41 -0
  112. package/skills/session-logs/SKILL.md +34 -0
  113. package/skills/sherpa-onnx-tts/SKILL.md +34 -0
  114. package/skills/skill-creator/SKILL.md +34 -0
  115. package/skills/slack/SKILL.md +34 -0
  116. package/skills/songsee/SKILL.md +34 -0
  117. package/skills/sonoscli/SKILL.md +34 -0
  118. package/skills/spotify-player/SKILL.md +34 -0
  119. package/skills/strykr-prism/SKILL.md +41 -0
  120. package/skills/summarize/SKILL.md +34 -0
  121. package/skills/taskbridge/SKILL.md +34 -0
  122. package/skills/things-mac/SKILL.md +34 -0
  123. package/skills/tmux/SKILL.md +34 -0
  124. package/skills/trello/SKILL.md +34 -0
  125. package/skills/validator-agent/SKILL.md +41 -0
  126. package/skills/video-frames/SKILL.md +34 -0
  127. package/skills/voice-call/SKILL.md +34 -0
  128. package/skills/wacli/SKILL.md +34 -0
  129. package/skills/weather/SKILL.md +34 -0
  130. package/skills/webmcp-payments/SKILL.md +41 -0
  131. package/skills/xurl/SKILL.md +34 -0
  132. package/src/skills/catalog.ts +435 -435
  133. package/src/skills/executor.ts +56 -56
  134. package/src/skills/index.ts +3 -3
  135. package/src/skills/itp/SKILL.md +112 -112
  136. package/src/skills/loader.ts +262 -193
  137. package/native/ffi/index.node +0 -0
  138. package/native/wasm/pkg-node/.gitignore +0 -6
package/CHANGELOG.md CHANGED
@@ -1,160 +1,186 @@
1
- # Changelog
2
-
3
- All notable changes to ClawPowers are documented here.
4
-
5
- ## [2.2.4] - 2026-04-09
6
-
7
- ### Fixed
8
-
9
- - GitHub Actions CI WASM-artifact verification now correctly handles `npm pack --dry-run --json` output when `prepack` logs are present
10
- - Added `scripts/verify-wasm-artifacts.mjs` so packaged WASM checks are deterministic and reusable
11
- - Final GitHub release/version surfaces aligned to the live npm package version
12
-
13
- ## [2.2.3] - 2026-04-09
14
-
15
- ### Fixed
16
-
17
- - Added Dependabot, CodeQL, release automation, ROADMAP, and CI badge surfaces
18
- - Elevated wallet safety warning for Tier 3 fallback behavior
19
- - Added Node 22 coverage in CI and tightened launch-readiness docs
20
-
21
- ## [2.2.2] - 2026-04-09
22
-
23
- ### Fixed
24
-
25
- - `package.json` homepage corrected to npm page
26
- - Compatibility matrix updated to reflect current supported release lines
27
- - `skill.json` version synced to the published package version
28
-
29
- ## [2.2.1] - 2026-04-08
30
-
31
- ### Fixed
32
-
33
- - `skill.json` version bumped to 2.2.1
34
- - `package.json` homepage corrected to npm page
35
- - CHANGELOG publish dates corrected to 2026-04-08
36
- - RELEASING.md populated with published versions table
37
- - `npm pkg fix` repository URL normalization applied
38
-
39
- ## [2.2.0] - 2026-04-08
40
-
41
- ### Added
42
-
43
- - **Full secp256k1 Ethereum wallet derivation** (MetaMask-compatible): private key uncompressed public key (64 bytes) → Keccak-256 → last 20 bytes as EIP-55 checksummed address.
44
- - **Pure Rust `k256`** (RustCrypto) in `native/crates/evm-eth`, wired into **WASM** and **FFI** with exports: `deriveEthereumAddress`, `derivePublicKey`, `signEcdsa`, `verifyEcdsa`.
45
- - **TypeScript loader** (`src/native/index.ts`): `keccak256Digest`, `deriveEthereumAddress`, `derivePublicKey`, `signEcdsa`, `verifyEcdsa` (Tier 1 → Tier 2 → `null` / `false` as documented).
46
- - **`signMessage` overload**: `(privateKeyHex, message)` returns a 65-byte ECDSA signature hex (`r‖s‖v`); existing `(message, keyFile, passphrase)` unchanged in shape, now uses ECDSA+Keccak when tiers allow, else HMAC fallback.
47
- - **Tests**: `tests/wallet/secp256k1.test.ts` (Hardhat default account #0 vector).
48
-
49
- ### Notes
50
-
51
- - **WASM**: `getrandom` 0.2 `js` feature enabled for `wasm32` so `k256` builds under `wasm-pack`.
52
- - **Loader**: If Tier 1 (native) loads, Tier 2 (WASM) is still initialized when available so newer exports (e.g. secp256k1) work when an older `.node` lacks them. `getActiveTier()` remains `native` when the addon is present.
53
- - Existing keyfiles still use the stored `address` field as the source of truth; newly generated/imported keys use real Ethereum addresses when native or WASM is loaded.
54
-
55
- ## [2.1.0] - 2026-04-06
56
-
57
- ### Added
58
-
59
- - **Native acceleration layer** (parity with ClawPowers-Agent): `native/` Rust workspace (wallet, tokens, policy, fee, x402, canonical, compression, index, verification, security, ffi, WASM crate, PyO3 bindings).
60
- - **Pre-built WASM** in `native/wasm/pkg-node` and `native/wasm/pkg` so npm installs work **without** `wasm-pack` or Rust.
61
- - **3-tier TypeScript loader** (`src/native/index.ts`): Tier 1 optional `.node` addon, Tier 2 WASM, Tier 3 pure TypeScript fallbacks. Exported from the package root (`getActiveTier`, `isNativeAvailable`, `isWasmAvailable`, `getCapabilitySummary`, `computeSha256`, `digestForWalletAddress`, `tokenAmountFromHuman`, `calculateFee`, `evaluateWriteFirewall`, etc.).
62
- - **Payment bridges** (`calculateTransactionFee`, `createPaymentHeader`, `generateWalletAddress`) and **memory bridges** (`getBestCanonicalStore`, `compressVector`, `evaluateWriteSecurity`, …) via `src/payments/native-bridge.ts` and `src/memory/native-store.ts`.
63
- - **npm scripts:** `build:native`, `build:wasm`.
64
- - **WASM / native Keccak-256** for wallet address digest when Tier 1 or Tier 2 is active; **SHA-256** remains the Tier 3 fallback only.
65
-
66
- ### Notes
67
-
68
- - Tier 1 (native) is **optional**; building `native/ffi` requires Rust locally. Published tarballs focus on Tier 2 WASM + Tier 3 TS.
69
- - Backward compatible at the **API** level for v2.0.0 importers; wallet **address strings** for newly generated keys may differ from v2.0.0 when WASM/native is loaded (Keccak-256 vs former SHA-256-only digest). Existing keyfiles keep their stored `address` field.
70
-
71
- ## [2.0.0] - 2026-04-03
72
-
73
- ### Breaking Changes
74
-
75
- - **Complete TypeScript rewrite.** The v1.x shell-script runtime has been replaced with a fully typed TypeScript library.
76
- - **No agent control loop.** ClawPowers is now a pure capability library — bring your own agent framework.
77
- - **ESM-only.** Requires Node.js 20+.
78
-
79
- ### Added
80
-
81
- - **Payments module** — x402 detection (`detect402`), `SpendingPolicy` enforcement, `PaymentExecutor` with append-only audit log. Fees: 0.77% tx / 0.30% swap.
82
- - **Memory module** — `WorkingMemoryManager` (in-process, token-budgeted), `EpisodicMemory` (JSONL append-only), `ProceduralMemory` (atomic JSON), `CheckpointManager` (crash recovery), `ContextInjector` (relevant memory selection).
83
- - **RSI module** — `MetricsCollector`, `HypothesisEngine`, `MutationEngine`, `ABTestManager`, `RSIAuditLog`, `AutoResearcher`. Full measure → hypothesize → mutate → A/B test → promote/rollback cycle.
84
- - **Wallet module** — `WalletManager`, `generateWallet`, `importWallet`, `signMessage` with AES-256-GCM encryption at rest.
85
- - **Skills module** `discoverSkills`, `loadSkillManifest`, `SkillExecutor` with outcome tracking.
86
- - **Config module** Zod-validated config, dot-notation access, profile support.
87
- - **Framework demos** — LangChain (`demos/langchain.ts`), Claude Code (`demos/claude-code.md`), ElizaOS (`demos/elizaos.ts`).
88
- - **231 TypeScript tests** full coverage across all modules.
89
- - **BSL 1.1 license** with Change Date April 3, 2030.
90
- - **SECURITY.md** with vulnerability reporting policy and security design principles.
91
-
92
- ### Compatibility
93
-
94
- Drop-in library for: LangChain, LangGraph, Claude Code, Cursor, ElizaOS, AutoGen, CrewAI, Agent Zero, any MCP-compatible host.
95
-
96
- ### Removed
97
-
98
- - Shell-script runtime (v1.x skills)
99
- - CLI binary (`clawpowers` command)
100
- - Agent control loop (use ClawPowers-Agent for that)
101
-
102
-
103
- ## [1.1.3] - 2026-03-22
104
-
105
- ### Added
106
-
107
- - **Unified Payment Decision Pipeline** (`runtime/payments/pipeline.js`) 8-step flow for evaluating payment boundaries across all skills
108
- - **Agent-to-Agent Bounties skill** (`skills/agent-bounties/`) 6-phase escrow lifecycle for agent hiring
109
- - **Premium enrichment** in prospecting skill x402-aware paid data sources
110
- - **5-minute transaction quickstart** (`docs/quickstart-first-transaction.md`) JS + Python paths
111
- - **Demo README** (`runtime/demo/README.md`) x402 flow walkthrough with curl examples
112
- - **30 natural language triggers** in skill.json purchase intents, payment management, demo commands
113
- - "Payments are optional" README section with regulatory disclaimer and patent positioning
114
- - Smart `update` commanddetects npm vs git install
115
-
116
- ## [1.1.2] - 2026-03-22
117
-
118
- ### Added
119
-
120
- - **Config.json on init** payments disabled by default, dry-run mode, $0 limits
121
- - **Payment ledger** (`~/.clawpowers/logs/payments.jsonl`) — full audit trail
122
- - **Wallet activation wizard** (`npx clawpowers payments setup`) — interactive, non-scary
123
- - **x402 Mock Merchant** (`npx clawpowers demo x402`) — test payments with zero risk
124
- - **Dry-run mode** documentation in agent-payments skill
125
- - **Payment moment hooks** in market-intelligence + security-audit skills
126
- - Updated using-clawpowers trigger map
127
- - Standardized `.env.example` across all projects
128
-
129
- ## [1.1.1] - 2026-03-22
130
-
131
- ### Added
132
-
133
- - **economic-code-optimization skill** (25th skill) — ROI-tracked micro-budget spending
134
- - 4 RSI intelligence skills: meta-skill-evolution, self-healing-code, cross-project-knowledge, formal-verification-lite
135
- - 2 skills enhanced: test-driven-development (+mutation testing), systematic-debugging (+hypothesis memory)
136
-
137
- ### Changed
138
-
139
- - README rewritten (381 lines)
140
- - +994 lines inline JSDoc comments across 12 code files
141
-
142
- ## [1.1.0] - 2026-03-21
143
-
144
- ### Added
145
-
146
- - agent-payments skill rewritten for agentwallet-sdk v6.0.0
147
- - OpenClaw skill.json manifest
148
- - Security Model section in README
149
- - Agent Payment Demo (3-step walkthrough)
150
- - Demo GIF (asciinema recording, 621KB)
151
-
152
- ## [1.0.0] - 2026-03-21
153
-
154
- ### Added
155
-
156
- - Initial release — 20 core skills
157
- - Dual runtime (bash + Node.js)
158
- - Session hooks for Claude Code, Cursor, Codex, OpenCode, Gemini CLI
159
- - Metrics collection and RSI feedback loop
160
- - 366 tests passing
1
+ # Changelog
2
+
3
+ All notable changes to ClawPowers are documented here.
4
+
5
+ ## Unreleased
6
+
7
+ ## [2.2.7] - 2026-05-12
8
+
9
+ ### Fixed
10
+
11
+ - Launch-critical API fix: generated/imported wallets now return or accept caller-supplied passphrases so encrypted key files remain signable through `signMessage(message, keyFile, passphrase)`.
12
+ - Fixed skill discovery for Windows/CRLF `SKILL.md` frontmatter so packaged skills are actually visible after clean npm installs on Windows.
13
+ - Added a clean consumer-install smoke gate that packs the npm tarball, installs it in a fresh project, imports public ESM exports, verifies packaged skills, and exercises the WASM Ethereum wallet fallback.
14
+ - Published the current dependency metadata as an npm-visible patch release.
15
+
16
+ ## [2.2.6] - 2026-04-14
17
+
18
+ ### Fixed
19
+
20
+ - Corrected stale internal version surfaces that were still reporting older values inside the published package
21
+ - Added `skill.json` back to the npm tarball so the manifest ships with the package again
22
+ - Aligned compatibility/docs metadata to the repaired 2.2.6 release
23
+
24
+ ## [2.2.5] - 2026-04-09
25
+
26
+ ### Fixed
27
+
28
+ - Added clawpowers.ai canonical links across package metadata and docs
29
+ - Synced internal version surfaces so package metadata, manifest, and source constants all report 2.2.5
30
+
31
+ ## [2.2.4] - 2026-04-09
32
+
33
+ ### Fixed
34
+
35
+ - GitHub Actions CI WASM-artifact verification now correctly handles `npm pack --dry-run --json` output when `prepack` logs are present
36
+ - Added `scripts/verify-wasm-artifacts.mjs` so packaged WASM checks are deterministic and reusable
37
+ - Final GitHub release/version surfaces aligned to the live npm package version
38
+
39
+ ## [2.2.3] - 2026-04-09
40
+
41
+ ### Fixed
42
+
43
+ - Added Dependabot, CodeQL, release automation, ROADMAP, and CI badge surfaces
44
+ - Elevated wallet safety warning for Tier 3 fallback behavior
45
+ - Added Node 22 coverage in CI and tightened launch-readiness docs
46
+
47
+ ## [2.2.2] - 2026-04-09
48
+
49
+ ### Fixed
50
+
51
+ - `package.json` homepage corrected to npm page
52
+ - Compatibility matrix updated to reflect current supported release lines
53
+ - `skill.json` version synced to the published package version
54
+
55
+ ## [2.2.1] - 2026-04-08
56
+
57
+ ### Fixed
58
+
59
+ - `skill.json` version bumped to 2.2.1
60
+ - `package.json` homepage corrected to npm page
61
+ - CHANGELOG publish dates corrected to 2026-04-08
62
+ - RELEASING.md populated with published versions table
63
+ - `npm pkg fix` repository URL normalization applied
64
+
65
+ ## [2.2.0] - 2026-04-08
66
+
67
+ ### Added
68
+
69
+ - **Full secp256k1 Ethereum wallet derivation** (MetaMask-compatible): private key uncompressed public key (64 bytes) Keccak-256 last 20 bytes as EIP-55 checksummed address.
70
+ - **Pure Rust `k256`** (RustCrypto) in `native/crates/evm-eth`, wired into **WASM** and **FFI** with exports: `deriveEthereumAddress`, `derivePublicKey`, `signEcdsa`, `verifyEcdsa`.
71
+ - **TypeScript loader** (`src/native/index.ts`): `keccak256Digest`, `deriveEthereumAddress`, `derivePublicKey`, `signEcdsa`, `verifyEcdsa` (Tier 1 → Tier 2 → `null` / `false` as documented).
72
+ - **`signMessage` overload**: `(privateKeyHex, message)` returns a 65-byte ECDSA signature hex (`r‖s‖v`); existing `(message, keyFile, passphrase)` unchanged in shape, now uses ECDSA+Keccak when tiers allow, else HMAC fallback.
73
+ - **Tests**: `tests/wallet/secp256k1.test.ts` (Hardhat default account #0 vector).
74
+
75
+ ### Notes
76
+
77
+ - **WASM**: `getrandom` 0.2 `js` feature enabled for `wasm32` so `k256` builds under `wasm-pack`.
78
+ - **Loader**: If Tier 1 (native) loads, Tier 2 (WASM) is still initialized when available so newer exports (e.g. secp256k1) work when an older `.node` lacks them. `getActiveTier()` remains `native` when the addon is present.
79
+ - Existing keyfiles still use the stored `address` field as the source of truth; newly generated/imported keys use real Ethereum addresses when native or WASM is loaded.
80
+
81
+ ## [2.1.0] - 2026-04-06
82
+
83
+ ### Added
84
+
85
+ - **Native acceleration layer** (parity with ClawPowers-Agent): `native/` Rust workspace (wallet, tokens, policy, fee, x402, canonical, compression, index, verification, security, ffi, WASM crate, PyO3 bindings).
86
+ - **Pre-built WASM** in `native/wasm/pkg-node` and `native/wasm/pkg` so npm installs work **without** `wasm-pack` or Rust.
87
+ - **3-tier TypeScript loader** (`src/native/index.ts`): Tier 1 optional `.node` addon, Tier 2 WASM, Tier 3 pure TypeScript fallbacks. Exported from the package root (`getActiveTier`, `isNativeAvailable`, `isWasmAvailable`, `getCapabilitySummary`, `computeSha256`, `digestForWalletAddress`, `tokenAmountFromHuman`, `calculateFee`, `evaluateWriteFirewall`, etc.).
88
+ - **Payment bridges** (`calculateTransactionFee`, `createPaymentHeader`, `generateWalletAddress`) and **memory bridges** (`getBestCanonicalStore`, `compressVector`, `evaluateWriteSecurity`, …) via `src/payments/native-bridge.ts` and `src/memory/native-store.ts`.
89
+ - **npm scripts:** `build:native`, `build:wasm`.
90
+ - **WASM / native Keccak-256** for wallet address digest when Tier 1 or Tier 2 is active; **SHA-256** remains the Tier 3 fallback only.
91
+
92
+ ### Notes
93
+
94
+ - Tier 1 (native) is **optional**; building `native/ffi` requires Rust locally. Published tarballs focus on Tier 2 WASM + Tier 3 TS.
95
+ - Backward compatible at the **API** level for v2.0.0 importers; wallet **address strings** for newly generated keys may differ from v2.0.0 when WASM/native is loaded (Keccak-256 vs former SHA-256-only digest). Existing keyfiles keep their stored `address` field.
96
+
97
+ ## [2.0.0] - 2026-04-03
98
+
99
+ ### Breaking Changes
100
+
101
+ - **Complete TypeScript rewrite.** The v1.x shell-script runtime has been replaced with a fully typed TypeScript library.
102
+ - **No agent control loop.** ClawPowers is now a pure capability library — bring your own agent framework.
103
+ - **ESM-only.** Requires Node.js 20+.
104
+
105
+ ### Added
106
+
107
+ - **Payments module** x402 detection (`detect402`), `SpendingPolicy` enforcement, `PaymentExecutor` with append-only audit log. Fees: 0.77% tx / 0.30% swap.
108
+ - **Memory module** — `WorkingMemoryManager` (in-process, token-budgeted), `EpisodicMemory` (JSONL append-only), `ProceduralMemory` (atomic JSON), `CheckpointManager` (crash recovery), `ContextInjector` (relevant memory selection).
109
+ - **RSI module** `MetricsCollector`, `HypothesisEngine`, `MutationEngine`, `ABTestManager`, `RSIAuditLog`, `AutoResearcher`. Full measure → hypothesize → mutate → A/B test → promote/rollback cycle.
110
+ - **Wallet module** `WalletManager`, `generateWallet`, `importWallet`, `signMessage` with AES-256-GCM encryption at rest.
111
+ - **Skills module** — `discoverSkills`, `loadSkillManifest`, `SkillExecutor` with outcome tracking.
112
+ - **Config module** — Zod-validated config, dot-notation access, profile support.
113
+ - **Framework demos** LangChain (`demos/langchain.ts`), Claude Code (`demos/claude-code.md`), ElizaOS (`demos/elizaos.ts`).
114
+ - **231 TypeScript tests**full coverage across all modules.
115
+ - **BSL 1.1 license** with Change Date April 3, 2030.
116
+ - **SECURITY.md** with vulnerability reporting policy and security design principles.
117
+
118
+ ### Compatibility
119
+
120
+ Drop-in library for: LangChain, LangGraph, Claude Code, Cursor, ElizaOS, AutoGen, CrewAI, Agent Zero, any MCP-compatible host.
121
+
122
+ ### Removed
123
+
124
+ - Shell-script runtime (v1.x skills)
125
+ - CLI binary (`clawpowers` command)
126
+ - Agent control loop (use ClawPowers-Agent for that)
127
+
128
+
129
+ ## [1.1.3] - 2026-03-22
130
+
131
+ ### Added
132
+
133
+ - **Unified Payment Decision Pipeline** (`runtime/payments/pipeline.js`) — 8-step flow for evaluating payment boundaries across all skills
134
+ - **Agent-to-Agent Bounties skill** (`skills/agent-bounties/`) 6-phase escrow lifecycle for agent hiring
135
+ - **Premium enrichment** in prospecting skill x402-aware paid data sources
136
+ - **5-minute transaction quickstart** (`docs/quickstart-first-transaction.md`) — JS + Python paths
137
+ - **Demo README** (`runtime/demo/README.md`) — x402 flow walkthrough with curl examples
138
+ - **30 natural language triggers** in skill.json — purchase intents, payment management, demo commands
139
+ - "Payments are optional" README section with regulatory disclaimer and patent positioning
140
+ - Smart `update` command detects npm vs git install
141
+
142
+ ## [1.1.2] - 2026-03-22
143
+
144
+ ### Added
145
+
146
+ - **Config.json on init** — payments disabled by default, dry-run mode, $0 limits
147
+ - **Payment ledger** (`~/.clawpowers/logs/payments.jsonl`) — full audit trail
148
+ - **Wallet activation wizard** (`npx clawpowers payments setup`) — interactive, non-scary
149
+ - **x402 Mock Merchant** (`npx clawpowers demo x402`) — test payments with zero risk
150
+ - **Dry-run mode** documentation in agent-payments skill
151
+ - **Payment moment hooks** in market-intelligence + security-audit skills
152
+ - Updated using-clawpowers trigger map
153
+ - Standardized `.env.example` across all projects
154
+
155
+ ## [1.1.1] - 2026-03-22
156
+
157
+ ### Added
158
+
159
+ - **economic-code-optimization skill** (25th skill) ROI-tracked micro-budget spending
160
+ - 4 RSI intelligence skills: meta-skill-evolution, self-healing-code, cross-project-knowledge, formal-verification-lite
161
+ - 2 skills enhanced: test-driven-development (+mutation testing), systematic-debugging (+hypothesis memory)
162
+
163
+ ### Changed
164
+
165
+ - README rewritten (381 lines)
166
+ - +994 lines inline JSDoc comments across 12 code files
167
+
168
+ ## [1.1.0] - 2026-03-21
169
+
170
+ ### Added
171
+
172
+ - agent-payments skill rewritten around wallet workflow helpers
173
+ - OpenClaw skill.json manifest
174
+ - Security Model section in README
175
+ - Agent Payment Demo (3-step walkthrough)
176
+ - Demo GIF (asciinema recording, 621KB)
177
+
178
+ ## [1.0.0] - 2026-03-21
179
+
180
+ ### Added
181
+
182
+ - Initial release — 20 core skills
183
+ - Dual runtime (bash + Node.js)
184
+ - Session hooks for Claude Code, Cursor, Codex, OpenCode, Gemini CLI
185
+ - Metrics collection and RSI feedback loop
186
+ - 366 tests passing
package/COMPATIBILITY.md CHANGED
@@ -1,13 +1,48 @@
1
- # Compatibility Matrix
2
-
3
- ## Supported release line
4
-
5
- | clawpowers | Recommended consumer |
6
- | --- | --- |
7
- | 2.2.x (latest: 2.2.4) | capability-library consumers and `clawpowers-agent` 1.1.x |
8
-
9
- ## Notes
10
-
11
- - `clawpowers` is the capability library, not the stock OpenClaw wrapper runtime.
12
- - `clawpowers-agent` is the wrapper runtime that consumes this package.
13
- - When `clawpowers` ships updated skills or capability implementations, `clawpowers-agent` should pick them up through package updates and skill sync.
1
+ # Compatibility Matrix
2
+
3
+ ## Supported release line
4
+
5
+ | clawpowers | Node.js | Recommended consumer | Hermes Agent skill-surface status |
6
+ | --- | --- | --- | --- |
7
+ | 2.2.x (latest: 2.2.7) | >=22.0.0 | capability-library consumers and `clawpowers-agent` 1.1.x | top-level `skills/` bundles verified against latest `NousResearch/hermes-agent` `main` by CI |
8
+
9
+ ## Notes
10
+
11
+ - `clawpowers` is the capability library, not the stock OpenClaw wrapper runtime.
12
+ - `clawpowers-agent` is the OpenClaw wrapper runtime that consumes this package.
13
+ - `clawpowers-agent` 1.1.x currently aligns with `openclaw` 2026.5.7.
14
+ - When `clawpowers` ships updated skills or capability implementations, `clawpowers-agent` should pick them up through package updates and skill sync.
15
+ - This package requires Node.js 22+. CI and release workflows are aligned to Node 22.
16
+
17
+ ## Hermes Agent compatibility contract
18
+
19
+ The Hermes-supported surface is the top-level `skills/` directory. These bundles are standard `SKILL.md` skill bundles compatible with Hermes Agent's skills tooling.
20
+
21
+ Current verification:
22
+
23
+ - dedicated workflow: `.github/workflows/hermes-compatibility.yml`
24
+ - Hermes source: `NousResearch/hermes-agent` on `main`
25
+ - verifier: `python3 scripts/verify_hermes_wrappers.py`
26
+ - verification scope: discovery of every exported top-level skill plus representative `skill_view` samples
27
+
28
+ Currently validated sample bundles include:
29
+
30
+ - `skills/itp/SKILL.md`
31
+ - `skills/github/SKILL.md`
32
+ - `skills/content-writer/SKILL.md`
33
+ - `skills/webmcp-payments/SKILL.md`
34
+ - `skills/prospector/SKILL.md`
35
+ - `skills/security/SKILL.md`
36
+ - `skills/business-strategy/SKILL.md`
37
+
38
+ ## Boundary of the Hermes-native claim
39
+
40
+ Hermes Agent compatibility means the exported `skills/` bundles load through Hermes' own skill tooling.
41
+
42
+ It does not claim that the broader `clawpowers` npm library becomes a native Hermes runtime plugin. In particular, the following remain library/runtime APIs unless separately implemented and validated as Hermes-native integrations:
43
+
44
+ - wallet APIs
45
+ - payments / x402 runtime flows
46
+ - RSI, memory, swarm, and other TypeScript library modules
47
+
48
+ Reference: `HERMES_COMPATIBILITY.md`
@@ -1,19 +1,20 @@
1
- # Known Limitations
2
-
3
- ## Production-ready
4
-
5
- - capability library APIs for payments, memory, RSI, wallet, swarm, and ITP
6
- - native plus WASM fallback packaging when shipped correctly
7
- - local validation commands: lint, typecheck, test, build, pack
8
-
9
- ## Experimental or environment-dependent
10
-
11
- - prompt-cache economics in benchmark collateral remain modeled, not billed receipts
12
- - native acceleration availability depends on platform and install environment
13
- - some consumer behavior depends on the wrapper/runtime that integrates this package
14
-
15
- ## Important operational notes
16
-
17
- - non-native environments depend on packaged WASM fallback artifacts for real wallet derivation
18
- - users should not assume modeled prompt-cache savings are direct provider billing results
19
- - downstream runtimes should validate their own integration behavior separately from this library
1
+ # Known Limitations
2
+
3
+ ## Production-ready
4
+
5
+ - capability library APIs for payments, memory, RSI, wallet, swarm, and ITP
6
+ - native plus WASM fallback packaging when shipped correctly
7
+ - local validation commands: lint, typecheck, test, build, pack
8
+
9
+ ## Experimental or environment-dependent
10
+
11
+ - prompt-cache economics in benchmark collateral remain modeled, not billed receipts
12
+ - native acceleration availability depends on platform and install environment
13
+ - some consumer behavior depends on the wrapper/runtime that integrates this package
14
+
15
+ ## Important operational notes
16
+
17
+ - non-native environments depend on packaged WASM fallback artifacts for real wallet derivation
18
+ - ClawPowers encrypts wallet key files but does not store passphrases in plaintext. Callers must persist caller-supplied or generated passphrases securely; `listWallets()` cannot recover them later.
19
+ - users should not assume modeled prompt-cache savings are direct provider billing results
20
+ - downstream runtimes should validate their own integration behavior separately from this library
package/LICENSE CHANGED
@@ -1,44 +1,44 @@
1
- Business Source License 1.1
2
-
3
- Parameters
4
-
5
- Licensor: AI Agent Economy
6
- Licensed Work: ClawPowers v2.0.0
7
- The Licensed Work is (c) 2026 AI Agent Economy.
8
- Additional Use Grant: Non-production use (development, testing, personal
9
- projects, academic research) is permitted without a
10
- commercial license.
11
- Change Date: April 3, 2030
12
- Change License: Apache License, Version 2.0
13
-
14
- -----------------------------------------------------------------------------
15
-
16
- Terms
17
-
18
- The Licensor grants you the right to copy, modify, create derivative works,
19
- redistribute, and make non-production use of the Licensed Work. The Licensor
20
- may make an Additional Use Grant permitting limited production use.
21
-
22
- Effective on the Change Date, or the fourth anniversary of the first publicly
23
- available distribution of a specific version of the Licensed Work under this
24
- License, whichever comes first, the Licensor grants you rights under the terms
25
- of the Change License, and the rights granted above terminate.
26
-
27
- If your use of the Licensed Work does not comply with the requirements in this
28
- License, you must purchase a commercial license from the Licensor or refrain
29
- from using the Licensed Work.
30
-
31
- All copies of the original and modified Licensed Work, and derivative works,
32
- are subject to this License. This License applies separately for each version
33
- of the Licensed Work.
34
-
35
- You must conspicuously display this License on each original or modified copy
36
- of the Licensed Work.
37
-
38
- Any use of the Licensed Work in violation of this License will automatically
39
- terminate your rights under this License.
40
-
41
- TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
42
- AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
43
- EXPRESS OR IMPLIED, INCLUDING WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
44
- PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
1
+ Business Source License 1.1
2
+
3
+ Parameters
4
+
5
+ Licensor: AI Agent Economy
6
+ Licensed Work: ClawPowers v2.0.0
7
+ The Licensed Work is (c) 2026 AI Agent Economy.
8
+ Additional Use Grant: Non-production use (development, testing, personal
9
+ projects, academic research) is permitted without a
10
+ commercial license.
11
+ Change Date: April 3, 2030
12
+ Change License: Apache License, Version 2.0
13
+
14
+ -----------------------------------------------------------------------------
15
+
16
+ Terms
17
+
18
+ The Licensor grants you the right to copy, modify, create derivative works,
19
+ redistribute, and make non-production use of the Licensed Work. The Licensor
20
+ may make an Additional Use Grant permitting limited production use.
21
+
22
+ Effective on the Change Date, or the fourth anniversary of the first publicly
23
+ available distribution of a specific version of the Licensed Work under this
24
+ License, whichever comes first, the Licensor grants you rights under the terms
25
+ of the Change License, and the rights granted above terminate.
26
+
27
+ If your use of the Licensed Work does not comply with the requirements in this
28
+ License, you must purchase a commercial license from the Licensor or refrain
29
+ from using the Licensed Work.
30
+
31
+ All copies of the original and modified Licensed Work, and derivative works,
32
+ are subject to this License. This License applies separately for each version
33
+ of the Licensed Work.
34
+
35
+ You must conspicuously display this License on each original or modified copy
36
+ of the Licensed Work.
37
+
38
+ Any use of the Licensed Work in violation of this License will automatically
39
+ terminate your rights under this License.
40
+
41
+ TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
42
+ AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
43
+ EXPRESS OR IMPLIED, INCLUDING WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
44
+ PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
package/LICENSING.md CHANGED
@@ -1,10 +1,10 @@
1
- # Licensing and Commercial Use
2
-
3
- `clawpowers` is released under **BSL-1.1**.
4
-
5
- ## What this means in practice
6
-
7
- - this package is the core capability library
8
- - commercial users should review the BSL terms before deployment or redistribution
9
- - downstream runtimes such as `clawpowers-agent` may use different licenses for their own wrapper code
10
- - always evaluate the exact published version you plan to ship
1
+ # Licensing and Commercial Use
2
+
3
+ `clawpowers` is released under **BSL-1.1**.
4
+
5
+ ## What this means in practice
6
+
7
+ - this package is the core capability library
8
+ - commercial users should review the BSL terms before deployment or redistribution
9
+ - downstream runtimes such as `clawpowers-agent` may use different licenses for their own wrapper code
10
+ - always evaluate the exact published version you plan to ship