release: v0.10.8

Author: tenequm

.github/workflows/ci.yml

@@ -20,3 +20,7 @@ jobs:
       - run: pnpm check
       - run: pnpm build
       - run: pnpm --filter x402-proxy test
+      - run: pnpm stage:release
+      - run: pnpm verify:release
+      - run: npm pack --json packages/x402-proxy/.release/x402-proxy > /dev/null
+      - run: npm pack --json packages/x402-proxy/.release/x402-proxy-openclaw > /dev/null

.github/workflows/publish.yml

@@ -24,7 +24,12 @@ jobs:
       - run: pnpm check
       - run: pnpm build
       - run: pnpm --filter x402-proxy test
-      - run: pnpm --filter x402-proxy publish --provenance --access public --no-git-checks
+      - run: pnpm stage:release
+      - run: pnpm verify:release
+      - run: npm pack --json packages/x402-proxy/.release/x402-proxy > /dev/null
+      - run: npm pack --json packages/x402-proxy/.release/x402-proxy-openclaw > /dev/null
+      - run: npm publish --provenance --access public packages/x402-proxy/.release/x402-proxy
+      - run: npm publish --provenance --access public packages/x402-proxy/.release/x402-proxy-openclaw
       - name: Extract changelog and create GitHub release
         env:
           GH_TOKEN: ${{ github.token }}

.gitignore

@@ -1,6 +1,8 @@
 node_modules/
 dist/
 .turbo/
+.artifacts/
+.release/
 *.tsbuildinfo
 .env
 .env.*

package.json

@@ -7,10 +7,13 @@
     "check": "turbo run build type-check test && biome check --write",
     "lint": "biome check --write",
     "build": "turbo run build",
+    "stage:release": "pnpm --filter x402-proxy stage:release",
+    "verify:release": "node scripts/verify-staged-x402-packages.mjs",
     "test": "vitest --project x402-proxy"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.9",
+    "tsdown": "^0.21.5",
     "turbo": "^2.8.20",
     "typescript": "^6.0.2",
     "vitest": "^4.1.1"

packages/x402-proxy/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.10.8] - 2026-04-02
+
+### Added
+- Separate published OpenClaw plugin package: `x402-proxy-openclaw`
+- Release staging and verification flow that produces `x402-proxy` and `x402-proxy-openclaw` together from the same source package directory
+- MCP payment retry tests covering structured x402 errors and paid tool result metadata preservation
+
+### Changed
+- Build output now stages separate CLI and OpenClaw artifacts before publish, while keeping one shared version and release tag
+- OpenClaw install documentation now points to `openclaw plugins install x402-proxy-openclaw`
+
+### Fixed
+- MCP proxy now preserves structured tool metadata such as `outputSchema`, resource metadata, `structuredContent`, and `_meta` when auto-paying x402 tool calls
+- Paid MCP retries now resend tool calls with the `x402/payment` payload while keeping the original result shape intact
+
 ## [0.10.7] - 2026-04-01
 
 ### Added
@@ -393,7 +408,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `appendHistory` / `readHistory` / `calcSpend` - JSONL transaction history
 - Re-exports from `@x402/fetch`, `@x402/svm`, `@x402/evm`
 
-[Unreleased]: https://github.com/cascade-protocol/x402-proxy/compare/v0.10.7...HEAD
+[Unreleased]: https://github.com/cascade-protocol/x402-proxy/compare/v0.10.8...HEAD
+[0.10.8]: https://github.com/cascade-protocol/x402-proxy/compare/v0.10.7...v0.10.8
 [0.10.7]: https://github.com/cascade-protocol/x402-proxy/compare/v0.10.6...v0.10.7
 [0.10.6]: https://github.com/cascade-protocol/x402-proxy/compare/v0.10.5...v0.10.6
 [0.10.5]: https://github.com/cascade-protocol/x402-proxy/compare/v0.10.4...v0.10.5

packages/x402-proxy/README.md

@@ -143,7 +143,13 @@ See the [library API docs](https://github.com/cascade-protocol/x402-proxy/tree/m
 
 ## OpenClaw Plugin
 
-x402-proxy ships as an [OpenClaw](https://openclaw.dev) plugin, giving your gateway automatic x402 and MPP payment capabilities. Registers `x_wallet` and `x_request` tools (aliased as `x_balance`/`x_payment`), `/x_wallet` and `/x_send` commands, and an HTTP route proxy for upstream inference endpoints.
+The OpenClaw plugin now ships as a separate npm package: `x402-proxy-openclaw`.
+
+```bash
+openclaw plugins install x402-proxy-openclaw
+```
+
+It gives your gateway automatic x402 and MPP payment capabilities. Registers `x_wallet` and `x_request` tools (aliased as `x_balance`/`x_payment`), `/x_wallet` and `/x_send` commands, and an HTTP route proxy for upstream inference endpoints.
 
 By default, the plugin registers a built-in `surf` provider at `/x402-proxy/v1` that points at `https://surf.cascade.fyi/api/v1/inference` and prefers MPP. Uses the standard wallet resolution (env vars or `wallet.json`).
 

packages/x402-proxy/README.openclaw.md

@@ -0,0 +1,35 @@
+# x402-proxy-openclaw
+
+OpenClaw plugin for x402 and MPP payments, wallet tools, and paid inference proxying.
+
+## Install
+
+```bash
+openclaw plugins install x402-proxy-openclaw
+```
+
+## What It Adds
+
+- `x_wallet` and `x_request` tools, with `x_balance` and `x_payment` aliases
+- `/x_wallet` and `/x_send` commands
+- an HTTP route proxy for upstream inference endpoints
+- a built-in `surf` provider at `/x402-proxy/v1`
+
+By default, the plugin proxies `https://surf.cascade.fyi/api/v1/inference` and prefers MPP.
+
+## Relationship To The CLI Package
+
+The standalone CLI and library remain published as `x402-proxy`.
+
+Use `x402-proxy` when you want:
+- paid HTTP requests from the command line
+- the MCP proxy
+- local wallet setup and export flows
+
+Use `x402-proxy-openclaw` when you want:
+- OpenClaw gateway integration
+- plugin-managed tools, commands, and routes
+
+## License
+
+Apache-2.0

packages/x402-proxy/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "x402-proxy",
   "name": "mpp/x402 Payments Proxy",
   "description": "x402 and MPP payments, wallet tools, and paid inference proxying",
-  "version": "1.0.0",
+  "version": "0.10.8",
   "providers": ["surf"],
   "autoEnableWhenConfiguredProviders": ["surf"],
   "skills": ["skills"],

packages/x402-proxy/package.json

@@ -1,7 +1,8 @@
 {
   "name": "x402-proxy",
-  "version": "0.10.7",
-  "description": "curl for x402 paid APIs. Auto-pays any endpoint on Base, Solana, and Tempo. Also works as an OpenClaw plugin.",
+  "private": true,
+  "version": "0.10.8",
+  "description": "curl for x402 paid APIs. Auto-pays any endpoint on Base, Solana, and Tempo.",
   "type": "module",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -37,12 +38,13 @@
     "x402-proxy": "./dist/bin/cli.js"
   },
   "scripts": {
-    "build": "rm -rf dist && tsdown --publint && cp openclaw.plugin.json dist/",
-    "dev": "tsdown --watch",
+    "build": "pnpm exec tsdown --config ../../tsdown.config.ts",
+    "dev": "pnpm exec tsdown --config ../../tsdown.config.ts --watch",
     "type-check": "tsc --noEmit",
     "test": "vitest run",
     "check": "pnpm type-check && biome check --write",
-    "prepublishOnly": "pnpm build"
+    "stage:release": "node ../../scripts/stage-x402-packages.mjs",
+    "verify:release": "node ../../scripts/verify-staged-x402-packages.mjs"
   },
   "dependencies": {
     "@clack/prompts": "^1.1.0",

packages/x402-proxy/skills/SKILL.md

@@ -167,12 +167,12 @@ stdout = response body, stderr = payment info. Pipes, redirects, and `jq` all wo
 
 ## OpenClaw Plugin
 
-x402-proxy ships as an [OpenClaw](https://openclaw.dev) plugin for automatic x402 payments, wallet management, and pay-per-use inference proxying. For full installation, provider/model configuration, and troubleshooting, read `references/openclaw-plugin.md`.
+x402-proxy also ships as a separate [OpenClaw](https://openclaw.dev) plugin package, `x402-proxy-openclaw`, for automatic x402 payments, wallet management, and pay-per-use inference proxying. For full installation, provider/model configuration, and troubleshooting, read `references/openclaw-plugin.md`.
 
 Quick install:
 
 ```bash
-openclaw plugins install x402-proxy
+openclaw plugins install x402-proxy-openclaw
 npx x402-proxy setup   # creates wallet if needed
 ```