agent402-openclaw 0.5.7 → 0.5.8

package/README.md

@@ -2,9 +2,9 @@
 
 Part of [Agent402](https://agent402.tools), the open-source paid door for AI agents.
 
-Agent402 as an [OpenClaw](https://openclaw.ai) model provider: the auto-routed
-tier at a **flat per-call price** and explicit frontier models **priced per
-request** from the body, paid in **USDC over x402** from a wallet or with a
+Agent402 as an [OpenClaw](https://openclaw.ai) model provider: explicit models
+**priced per request** from the body by default (metered), and the auto-routed
+tier at a **flat per-call price**, paid in **USDC over x402** from a wallet or with a
 prepaid credits key (agent402.tools/credits says whether packs are on sale). The
 same key and gateway reach Agent402's 500+ pay-per-call tools; credits pay
 Agent402's own services, so the routes that buy from an outside seller
@@ -57,7 +57,9 @@ install from a packed archive and from the npm registry, doctor, setup, model
 listing, gateway boot and one agent turn (`test-real-install.js`).
 
 No OpenClaw? `agent402-openclaw proxy` runs the proxy alone; point any OpenAI
-client at `http://127.0.0.1:8412/v1` with model `auto`.
+client at `http://127.0.0.1:8412/v1`. An explicit model rides the metered route
+by default (each request quoted from its body, and settlement never exceeds the
+quote); model `auto` takes the flat routed tier.
 
 **Claude Code and other Anthropic-wire clients** (0.5.0): the proxy also answers
 `POST /v1/messages` and forwards it to the gateway's metered Messages route,

package/index.js

@@ -130,7 +130,7 @@ let registeredOnce = false;
 const plugin = {
   id: PLUGIN_ID,
   name: "Agent402",
-  description: "Agent402 model provider: routed + explicit models at a flat per-call price, paid by card or USDC.",
+  description: "Agent402 model provider: routed + explicit models at a flat per-call price, paid in USDC from a wallet, or with a credits key already issued.",
   register(api) {
     const cfg = api.pluginConfig || {};
     const port = Number(cfg.port) || DEFAULT_PORT;
@@ -149,7 +149,7 @@ const plugin = {
           try { setCachedRoutes(await loadRoutes(upstream, fetch, { pricing })); } catch (e) { log(`[agent402-openclaw] could not read ${upstream}/v1/models yet: ${e?.message || e}`); }
           started = await startProxy({ upstream, creditsKey, payFetch, port, pricing, log });
           setActiveProxy(started);
-          if (started.mode === "unpaid") log("[agent402-openclaw] no payment configured: run `agent402-openclaw setup` (card credits key) - paid calls will answer 402 until then");
+          if (started.mode === "unpaid") log("[agent402-openclaw] no payment configured: run `agent402-openclaw setup` (a wallet key, or a credits key already issued) - paid calls will answer 402 until then");
         },
         stop: async () => { if (started) { await started.close(); started = null; setActiveProxy(null); } },
       });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent402-openclaw",
-  "version": "0.5.7",
+  "version": "0.5.8",
   "description": "OpenClaw model provider for Agent402: an auto-routed tier at a flat per-call price and explicit LLM models priced per request, paid in USDC over x402, or with a prepaid credits key, through a local proxy. Zero dependencies; x402 wallet payment is an optional peer.",
   "type": "module",
   "main": "index.js",
@@ -44,9 +44,9 @@
     "test": "node test.js"
   },
   "peerDependencies": {
-    "@x402/evm": ">=2.20.0",
-    "@x402/fetch": ">=2.20.0",
-    "viem": ">=2.48.11"
+    "@x402/evm": ">=2.20.0 <3",
+    "@x402/fetch": ">=2.20.0 <3",
+    "viem": ">=2.48.11 <3"
   },
   "peerDependenciesMeta": {
     "@x402/evm": {

package/proxy.js

@@ -6,7 +6,7 @@
 //              SDK pay from a wallet too (ANTHROPIC_BASE_URL=http://127.0.0.1:<port>).
 //
 // Two ways to pay, chosen at start:
-//   creditsKey  - a prepaid card-credits key (a402_...) sent as a Bearer; the
+//   creditsKey  - a prepaid credits key (a402_...) sent as a Bearer; the
 //                 gateway authorizes against the balance before the handler and
 //                 debits only on a final 200. No wallet, no chain.
 //   payFetch    - an x402-paying fetch (e.g. @x402/fetch wrapped around a
@@ -45,6 +45,8 @@ import { AUTO_ID, routesFromCatalog, stripTrailingSlashes } from "./models.js";
 
 export const DEFAULT_UPSTREAM = "https://agent402.tools";
 export const PKG_VERSION = JSON.parse(readFileSync(new URL("./package.json", import.meta.url), "utf8")).version;
+// The User-Agent product token that names this package on every request.
+const USER_AGENT = `agent402-openclaw/${PKG_VERSION}`;
 const MAX_BODY = 2 * 1024 * 1024;
 
 // The model catalog read (GET /v1/models) settles nothing, so a 503 the
@@ -78,7 +80,8 @@ async function discoveryFetch(fetchImpl, label, url, init) {
   let attempts = 0;
   for (;;) {
     attempts++;
-    r = await fetchImpl(url, typeof init === "function" ? init() : init);
+    const i = (typeof init === "function" ? init() : init) || {};
+    r = await fetchImpl(url, { ...i, headers: { "User-Agent": USER_AGENT, ...(i.headers || {}) } });
     if (r.ok) return r;
     if (attempts >= DISCOVERY_ATTEMPTS) break;
     const wait = await shedRetryWaitMs(r);
@@ -177,7 +180,7 @@ export async function startProxy({ upstream = DEFAULT_UPSTREAM, creditsKey = nul
   // error shape (wire.mapRefusal); every other upstream body is relayed as sent.
   async function forward(req, res, endpoint, outbound, extraHeaders, wire) {
     const clientIdem = typeof req.headers["idempotency-key"] === "string" && /^[\w.:-]{8,128}$/.test(req.headers["idempotency-key"]) ? req.headers["idempotency-key"] : null;
-    const headers = { "content-type": "application/json", accept: req.headers.accept || "application/json", "idempotency-key": clientIdem || randomUUID(), "user-agent": `agent402-openclaw/${PKG_VERSION}`, ...extraHeaders };
+    const headers = { "content-type": "application/json", accept: req.headers.accept || "application/json", "idempotency-key": clientIdem || randomUUID(), "user-agent": USER_AGENT, ...extraHeaders };
     if (key) headers.authorization = `Bearer ${key}`;
     // A paid request never follows a redirect: followed, it would pay another
     // origin's 402 or carry a signature (or the credits key) to another host.