agent402-client 0.8.16 → 0.8.17

package/README.md

@@ -215,7 +215,7 @@ that runs as one.
 
 | Method | What |
 |---|---|
-| `new Agent402({ baseUrl?, fetch?, x402Client?, creditsKey?, cache?, fetchImpl?, maxPerCallUsd?, dailyLimitUsd?, maxPerHostUsd?, maxResponseBytes?, outputValidator?, respondAsync?, asyncTimeoutMs?, onProgress? })` | `fetch` is your x402- or MPP-wrapped fetch for paid tools (optional); `x402Client` is the `@x402/core` client that `fetch` wraps, so the caps are enforced on the payment that is signed (see below); `creditsKey` is a prepaid card-credits key (`a402_...`) used for paid tools when no `fetch` is given; `cache` (default `true`) memoizes deterministic results; the three USD caps set optional spending limits (see below); `maxResponseBytes` (default 32MB, `null` to disable) refuses an oversized response body before it is parsed; `outputValidator` binds a caller-supplied delivery check; `respondAsync` (default `"auto"`), `asyncTimeoutMs` (default 15 minutes) and `onProgress` control slow routes run as jobs (see above) |
+| `new Agent402({ baseUrl?, fetch?, x402Client?, creditsKey?, cache?, fetchImpl?, maxPerCallUsd?, dailyLimitUsd?, maxPerHostUsd?, payNetworks?, maxResponseBytes?, outputValidator?, respondAsync?, asyncTimeoutMs?, onProgress? })` | `fetch` is your x402- or MPP-wrapped fetch for paid tools (optional); `x402Client` is the `@x402/core` client that `fetch` wraps, so the caps are enforced on the payment that is signed (see below); `payNetworks` (for example `["base"]`, the names `withNetworkPreference` takes) tells the caps which chains a pre-wrapped `fetch` without an `x402Client` pays on, so a call is counted at the dearest option on those chains (when none of a 402's options is on them, the dearest of all counts); `creditsKey` is a prepaid card-credits key (`a402_...`) used for paid tools when no `fetch` is given; `cache` (default `true`) memoizes deterministic results; the three USD caps set optional spending limits (see below); `maxResponseBytes` (default 32MB, `null` to disable) refuses an oversized response body before it is parsed; `outputValidator` binds a caller-supplied delivery check; `respondAsync` (default `"auto"`), `asyncTimeoutMs` (default 15 minutes) and `onProgress` control slow routes run as jobs (see above) |
 | `await a.find(task, { k = 5 })` | Resolve a plain-language task to the best-matching tools on **this host** (route, price, schema, example) |
 | `await a.route(task, { k?, include?, network? })` | Cross-seller Smart Order Router: rank eligible/routable seller rows from the host's current index (free, read-only; opaque results may include server-reported `executeVia`) |
 | `await a.findWorkflows(task, { k = 2 })` | Resolve a task to matching multi-tool workflow templates (skill packs) |

package/index.js

@@ -30,7 +30,7 @@ export { AsyncJobPendingError } from "./async-job.js";
 // `User-Agent: agent402-client/<version>` - a standard header, no extra
 // network calls - so a seller can attribute traffic (and settled payments)
 // to this SDK. Product token only; nothing about the caller rides along.
-const VERSION = "0.8.16";
+const VERSION = "0.8.17";
 const USER_AGENT = `agent402-client/${VERSION}`;
 // 32MB: about a hundred times any realistic response from this catalog (the
 // largest is a base64 image at a few MB), so it cannot break a legitimate
@@ -91,6 +91,9 @@ export class Agent402 {
    * @param {number} [opts.maxPerHostUsd]    hard ceiling on rolling-24h paid spend to one seller host (USD)
    * @param {object} [opts.x402Client]       the @x402/core x402Client your `fetch` wraps: the caps are then
    *                                         enforced on the payment that is signed (see guardX402Client)
+   * @param {string[]} [opts.payNetworks]    the chains your pre-wrapped `fetch` pays on (e.g. ["base"], the
+   *                                         names withNetworkPreference takes): without an x402Client the
+   *                                         caps count the dearest accept on these chains, not on every chain
    * @param {string} [opts.creditsKey]       a prepaid card-credits key (a402_...) already issued (new credits are
    *                                         not on sale) - pays wallet-only tools when no payFetch is given
    * @param {number|null} [opts.maxResponseBytes=33554432]
@@ -109,7 +112,7 @@ export class Agent402 {
    *        ({ status, stage, progress, etaSeconds, ... }) while a job runs
    */
   constructor({ baseUrl = "https://agent402.tools", fetch: payFetch, cache = true, fetchImpl = undefined, tlsDistrust = true,
-    maxPerCallUsd = null, dailyLimitUsd = null, maxPerHostUsd = null, creditsKey = null, x402Client = null,
+    maxPerCallUsd = null, dailyLimitUsd = null, maxPerHostUsd = null, creditsKey = null, x402Client = null, payNetworks = null,
     maxResponseBytes = DEFAULT_MAX_RESPONSE_BYTES, outputValidator = null,
     respondAsync = "auto", asyncTimeoutMs = DEFAULT_ASYNC_TIMEOUT_MS, onProgress = null } = {}) {
     this.respondAsync = respondAsync;
@@ -155,6 +158,10 @@ export class Agent402 {
     this._signCtx = new AsyncLocalStorage();
     this._guarded = false;
     if (x402Client) this.guardX402Client(x402Client);
+    // The chains a pre-wrapped fetch pays on, as CAIP-2 ids (null = unknown).
+    this._payNetworks = Array.isArray(payNetworks) && payNetworks.length
+      ? new Set(payNetworks.map((n) => String(NETWORK_CAIP2[String(n).trim().toLowerCase()] || String(n).trim()).toLowerCase()))
+      : null;
     // A response-size ceiling, enforced before parsing. See _readJson.
     this.maxResponseBytes = maxResponseBytes === null ? null : (numOrNull(maxResponseBytes) ?? DEFAULT_MAX_RESPONSE_BYTES);
     // Buyer-owned delivery policy. The callback stays entirely local and may
@@ -649,8 +656,11 @@ export class Agent402 {
    *  "guarded" (the signing guard holds every signature to the caps, so the
    *  cheapest known accept is what can be paid, and unknown ones are dropped
    *  there), "wallet" (no guard: the wallet may sign any accept, so the dearest
-   *  one counts, and one that cannot be priced is refused here), or "credits"
-   *  (nothing is signed; the dearest known accept counts).
+   *  one counts, among the chains in `payNetworks` when they are given, and one
+   *  that cannot be priced is refused here), or "credits" (nothing is signed:
+   *  the credits gate debits the route's own quote, and no accept is below it,
+   *  since a chain premium or price floor only raises an accept, so the
+   *  cheapest known accept counts).
    *  @returns {Promise<number>} the quoted amount, or `listUsd` when there is no readable 402 */
   async _quotedUsd(send, listUsd, { slug = "", mode = "wallet" } = {}) {
     if (!this._spendCapsConfigured()) return listUsd;
@@ -658,7 +668,14 @@ export class Agent402 {
     try {
       const pre = await send();
       if (pre?.status !== 402) return listUsd;
-      q = quoteOf(await challengeAccepts(pre));
+      let accepts = await challengeAccepts(pre);
+      if (mode === "wallet" && this._payNetworks && Array.isArray(accepts)) {
+        const onChains = accepts.filter((a) => this._payNetworks.has(String(a?.network || "").toLowerCase()));
+        // No option on the declared chains (or a name that maps to none): the
+        // wallet may still sign any of them, so the dearest of all counts.
+        if (onChains.length) accepts = onChains;
+      }
+      q = quoteOf(accepts);
     } catch (e) {
       // A redirect is refused here, before anything is reserved or signed.
       if (e instanceof PaymentRedirectError) throw e;
@@ -671,7 +688,7 @@ export class Agent402 {
         `refusing to pay for "${slug}" - ${q.max == null ? "no" : "a"} payment option it offers is in an asset this client cannot price, and a capped wallet signs only what it can price${mode === "wallet" ? " (pass your x402Client to guard signing and pay the options it can price)" : ""}`,
         { limit: "knownAsset", slug, priceUsd: null, unknownOptions: q.unknown });
     }
-    const quoted = mode === "guarded" ? q.min : q.max;
+    const quoted = mode === "wallet" ? q.max : q.min;
     // Larger of the two: an understated catalog must not lower the ceiling
     // the cap is checked against.
     return Math.max(listUsd, quoted);
@@ -955,8 +972,15 @@ export const NETWORK_CAIP2 = {
   "base-sepolia": "eip155:84532",
   robinhood: "eip155:4663",
   arc: "eip155:5042",
+  monad: "eip155:143",
+  celo: "eip155:42220",
+  avalanche: "eip155:43114",
+  sei: "eip155:1329",
+  optimism: "eip155:10",
   solana: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
   "solana-devnet": "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
+  stellar: "stellar:pubnet",
+  algorand: "algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=",
 };
 
 export function withNetworkPreference(client, networks) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent402-client",
-  "version": "0.8.16",
+  "version": "0.8.17",
   "description": "Agent402 buyer SDK: resolve a task to a tool across 500+ pay-per-call endpoints and call it with payment handled - free via proof-of-work, or over x402 or MPP (a stock mppx fetch works) with a wallet you keep; the buy side of Agentic Finance. Caching, idempotent retries (Idempotency-Key), non-custodial, zero dependencies.",
   "type": "module",
   "main": "index.js",