agent402-openclaw 0.5.4 → 0.5.6

package/README.md

@@ -5,8 +5,10 @@ Part of [Agent402](https://agent402.tools), the open-source paid door for AI age
 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
-prepaid credits key already issued (new credits are not on sale). The same key
-and gateway reach Agent402's 500+ pay-per-call tools.
+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
+(the route-execute tiers, `seller-payability`, `decide-execute` and the flight routes) need a wallet.
 
 Guide: https://agent402.tools/guides/openclaw-model-provider
 
@@ -22,7 +24,7 @@ With no credits key and no `AGENT402_WALLET_KEY`, `setup` generates an EVM
 wallet into `~/.openclaw/agent402/wallet.key` (0600, the only copy, never
 printed) and prints its address: send it USDC on Base and every call is paid
 from it over x402. `agent402-openclaw wallet` shows the address and balance;
-`--no-wallet` skips the generation. Holding a credits key already issued? Run
+`--no-wallet` skips the generation. Holding a credits key? Run
 `AGENT402_CREDITS_KEY=a402_... npx agent402-openclaw setup --write` (key by env,
 or `--credits-key -` on stdin).
 

package/cli.js

@@ -100,7 +100,7 @@ async function main() {
           out(`  key:     ${WALLET_KEY_FILE()} (0600; back it up, it is the only copy)`);
           out(`fund it with USDC on Base (any amount; a call costs from $0.001), then every call is paid from it over x402.`);
           out(`optional: \`agent402-openclaw permit2-approve\` once (needs a little ETH on Base for gas) to pay actual usage instead of the per-request quote.`);
-          out(`holding a credits key already issued? rerun with --credits-key a402_... instead`);
+          out(`holding a credits key? rerun with --credits-key a402_... instead`);
         } else {
           out(`no payment method yet: install viem + @x402/fetch + @x402/evm and rerun to generate a wallet, set AGENT402_WALLET_KEY, or rerun with --credits-key a402_... if you hold a credits key`);
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agent402-openclaw",
-  "version": "0.5.4",
-  "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 already issued, through a local proxy. Zero dependencies; x402 wallet payment is an optional peer.",
+  "version": "0.5.6",
+  "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",
   "exports": {

package/proxy.js

@@ -140,6 +140,12 @@ export function refusalAsAnthropicError(status, doc) {
 // body, any model id the gateway lists (dated Claude ids resolve to the live one).
 export const MESSAGES_UPSTREAM_PATH = "/v1/metered/messages";
 
+// Each client wire's own error shapes: mapRefusal turns an upstream refusal
+// that carries an offer into the wire's error; error(type, message) is an
+// error the proxy makes itself (a refused redirect, an unreachable upstream).
+const OPENAI_WIRE = { mapRefusal: refusalAsOpenAIError, error: (type, message) => ({ error: { message, type } }) };
+const ANTHROPIC_WIRE = { mapRefusal: refusalAsAnthropicError, error: (type, message) => ({ type: "error", error: { type, message } }) };
+
 const json = (res, status, obj, headers = {}) => {
   res.writeHead(status, { "content-type": "application/json; charset=utf-8", ...headers });
   res.end(JSON.stringify(obj));
@@ -168,8 +174,8 @@ export async function startProxy({ upstream = DEFAULT_UPSTREAM, creditsKey = nul
 
   // Pays and forwards one call. Streams pass through byte for byte; a refused
   // paid call's offer-carrying JSON body is answered in the client wire's own
-  // error shape (mapRefusal); every other upstream body is relayed as sent.
-  async function forward(req, res, endpoint, outbound, extraHeaders, mapRefusal) {
+  // 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 };
     if (key) headers.authorization = `Bearer ${key}`;
@@ -180,7 +186,7 @@ export async function startProxy({ upstream = DEFAULT_UPSTREAM, creditsKey = nul
       stats.errors++;
       const loc = up.headers.get("location");
       const to = loc ? new URL(loc, `${upstream}${endpoint}`).href : null;
-      return json(res, 502, { error: { message: `refused to follow a redirect on a paid call: ${upstream}${endpoint} answered HTTP ${up.status || "redirect"}${to ? ` pointing to ${to}` : ""}. Paid requests never follow redirects${to ? `; if that is the address you meant, set the upstream to ${new URL(to).origin}` : ""}.`, type: "upstream_redirect_refused" } });
+      return json(res, 502, wire.error("upstream_redirect_refused", `refused to follow a redirect on a paid call: ${upstream}${endpoint} answered HTTP ${up.status || "redirect"}${to ? ` pointing to ${to}` : ""}. Paid requests never follow redirects${to ? `; if that is the address you meant, set the upstream to ${new URL(to).origin}` : ""}.`));
     }
     stats.forwarded++;
     const passthrough = {};
@@ -191,7 +197,7 @@ export async function startProxy({ upstream = DEFAULT_UPSTREAM, creditsKey = nul
       const raw = await up.text();
       let doc = null;
       try { doc = JSON.parse(raw); } catch { /* not JSON after all: relayed as sent */ }
-      const mapped = mapRefusal(up.status, doc);
+      const mapped = wire.mapRefusal(up.status, doc);
       if (mapped) {
         const { "content-type": _ct, ...rest } = passthrough;
         return json(res, up.status, mapped, rest);
@@ -207,6 +213,9 @@ export async function startProxy({ upstream = DEFAULT_UPSTREAM, creditsKey = nul
     return res.end();
   }
 
+  // forward() is awaited inside the try below, so a payment fetch that throws
+  // (an unreachable upstream, a refused signature) answers a 502 in the wire's
+  // own shape instead of escaping as an unhandled rejection.
   const server = createServer(async (req, res) => {
     stats.requests++;
     const url = new URL(req.url, "http://localhost");
@@ -234,11 +243,11 @@ export async function startProxy({ upstream = DEFAULT_UPSTREAM, creditsKey = nul
           return json(res, 400, { error: { message: `Unknown model "${requested}". Use "auto" or an id from GET /v1/models (${table.size} available).`, type: "invalid_request_error", code: "model_not_found" } });
         }
         if (!paid) {
-          return json(res, 402, { error: { message: "No payment method configured. Run `agent402-openclaw setup` to generate an x402 wallet, set AGENT402_WALLET_KEY, or set AGENT402_CREDITS_KEY to a credits key already issued.", type: "payment_required", code: "agent402_unconfigured" }, topup: `${upstream}/credits`, priceUsd: route.priceUsd });
+          return json(res, 402, { error: { message: "No payment method configured. Run `agent402-openclaw setup` to generate an x402 wallet, set AGENT402_WALLET_KEY, or set AGENT402_CREDITS_KEY to a prepaid credits key.", type: "payment_required", code: "agent402_unconfigured" }, topup: `${upstream}/credits`, priceUsd: route.priceUsd });
         }
         const outbound = { ...body };
         if (requested === AUTO_ID) delete outbound.model; else outbound.model = route.id;
-        return forward(req, res, route.endpoint, outbound, {}, refusalAsOpenAIError);
+        return await forward(req, res, route.endpoint, outbound, {}, OPENAI_WIRE);
       }
       if (req.method === "POST" && url.pathname === "/v1/messages") {
         const raw = await readBody(req);
@@ -248,18 +257,19 @@ export async function startProxy({ upstream = DEFAULT_UPSTREAM, creditsKey = nul
           return json(res, 400, { type: "error", error: { type: "invalid_request_error", message: "\"model\" is required (any id from GET /v1/models, or a Claude id such as claude-sonnet-5)" } });
         }
         if (!paid) {
-          return json(res, 402, { type: "error", error: { type: "payment_required", message: "No payment method configured. Set AGENT402_WALLET_KEY to an EVM key holding USDC on Base (or run `agent402-openclaw setup`), or set AGENT402_CREDITS_KEY to a credits key already issued." } });
+          return json(res, 402, { type: "error", error: { type: "payment_required", message: "No payment method configured. Set AGENT402_WALLET_KEY to an EVM key holding USDC on Base (or run `agent402-openclaw setup`), or set AGENT402_CREDITS_KEY to a prepaid credits key." } });
         }
         const outbound = { ...body, model: body.model.trim().replace(/^agent402\//, "") };
         const extra = {};
         for (const h of ["anthropic-version", "anthropic-beta"]) { const v = req.headers[h]; if (typeof v === "string" && v.length <= 512) extra[h] = v; }
-        return forward(req, res, MESSAGES_UPSTREAM_PATH, outbound, extra, refusalAsAnthropicError);
+        return await forward(req, res, MESSAGES_UPSTREAM_PATH, outbound, extra, ANTHROPIC_WIRE);
       }
       return json(res, 404, { error: { message: `No route for ${req.method} ${url.pathname}`, type: "invalid_request_error" } });
     } catch (e) {
       stats.errors++;
       log(`[agent402-openclaw] ${req.method} ${url.pathname}: ${e?.message || e}`);
-      if (!res.headersSent) return json(res, 502, { error: { message: `Upstream error: ${String(e?.message || e).slice(0, 200)}`, type: "upstream_error" } });
+      const wire = url.pathname === "/v1/messages" ? ANTHROPIC_WIRE : OPENAI_WIRE;
+      if (!res.headersSent) return json(res, 502, wire.error("upstream_error", `Upstream error: ${String(e?.message || e).slice(0, 200)}`));
       try { res.end(); } catch { /* ignore */ }
     }
   });