@wafermapxyz/cli 0.4.8 → 0.4.9

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.4.9 (7 Nov 2026)
+
+**`wafermap call <llm> --stream`: watch the answer arrive.**
+
+- With `--stream`, an LLM resource answers as server-sent events and the CLI prints each piece as it comes. The payment is the same signature as before; Wafermap settles it only after the last piece, so a model that stops halfway charges nothing (the CLI then exits with `stream_broken`).
+- Free calls ($WAFERMAP Pro) and `--pay wafermap` still answer in one JSON body; `--stream` prints that the usual way.
+- `Wafermap.call()` takes `onDelta(text)` for the same thing from code.
+
 ## 0.4.8 (5 Nov 2026)
 
 **Two more payment networks: Arc and Soneium.**

package/README.md

@@ -84,6 +84,8 @@ Pass `approve: (a) => boolean` to confirm each payment or swap yourself, and `le
 
 A wallet that holds at least 100,000 $WAFERMAP on Robinhood Chain pays 50% less for Wafermap's own resources when it pays on an EVM network (Robinhood Chain, Base, Arbitrum, Polygon, Arc, Soneium). Nothing to set up: `wafermap call` names the wallet to Wafermap and the quote comes back discounted; the server re-checks the balance of the wallet that signs. Marketplace listings and Solana payments keep the regular price. Check a wallet: https://wafermap.xyz/api/holder?address=0x…, or run `wafermap holder`.
 
+LLM resources can **stream**: `wafermap call gemma-4 prompt="hi" --stream` prints the answer as it arrives, and the payment settles only once the model finishes.
+
 Wafermap's own resources can also be **paid in $WAFERMAP at 50% off, and the tokens are burned**: `wafermap approve-wafermap` once (a Permit2 approval, one Robinhood Chain transaction), then `wafermap call <id> --pay wafermap`. Each payment is a Permit2 signature for one exact amount, usable for two minutes only by Wafermap's relayer (fixed in the client), checked against a market price the client reads itself.
 
 With 1,000,000 $WAFERMAP the wallet is **Pro**: 10 free calls a day (UTC) to resources listed at $0.01 or less. `wafermap call` sends a holder pass (a signed message, no transaction, valid 24 hours) to Wafermap only; when a call is free, nothing is signed for payment and it prints `✓ Free call`. Holders of 100,000 also unlock x402 Tracker Pro: `wafermap pass` prints a pass for its API. Details: https://wafermap.xyz/docs#holders

package/dist/cli.js

@@ -932,19 +932,59 @@ var init_core = __esm({
           throw new WafermapError("approve_failed", e?.shortMessage ?? e?.message ?? "The approval failed.");
         }
       }
+      /** Reads /v1's server-sent events for an LLM call: delta pieces as they arrive, then receipt (or error), then done. */
+      async readStream(res, onDelta) {
+        const reader = res.body.pipeThrough(new TextDecoderStream()).getReader();
+        let buf = "";
+        let receipt = null;
+        let done = null;
+        let error = null;
+        for (; ; ) {
+          const { value, done: end } = await reader.read();
+          if (end) break;
+          buf += value;
+          let i;
+          while ((i = buf.indexOf("\n\n")) >= 0) {
+            const block = buf.slice(0, i);
+            buf = buf.slice(i + 2);
+            const ev = /^event: (.+)$/m.exec(block)?.[1];
+            let data = null;
+            try {
+              data = JSON.parse(/^data: (.*)$/m.exec(block)?.[1] ?? "null");
+            } catch {
+            }
+            if (ev === "delta" && typeof data?.text === "string") onDelta(data.text);
+            else if (ev === "receipt") receipt = data;
+            else if (ev === "done") done = data;
+            else if (ev === "error") error = data;
+          }
+        }
+        return { receipt, done, error };
+      }
       async call(id, input = {}, o = {}) {
         const inToken = o.payIn === "wafermap";
+        const stream = !!o.onDelta && !inToken;
         if (inToken && id.startsWith("m/")) throw new WafermapError("token_not_offered", "Marketplace listings are paid in USDG or USDC to their seller, not in $WAFERMAP.");
         if (inToken && !await this.wafermapApproved().catch(() => true)) throw new WafermapError("permit2_not_approved", "Paying in $WAFERMAP needs a one-time approval of Permit2. Run `wafermap approve-wafermap` (one transaction on Robinhood Chain, paid in ETH), then call again.");
         const pass = id.startsWith("m/") ? null : await this.holderPass();
-        const go = () => this.paidFetch("resource", id, `${this.baseUrl}/v1/${id}`, { method: "POST", headers: { "content-type": "application/json", "x-wafermap-payer": this.address, ...pass ? { [PASS_HEADER]: pass } : {} }, body: JSON.stringify(input) }, o.network, inToken ? "wafermap" : void 0);
+        const go = () => this.paidFetch("resource", id, `${this.baseUrl}/v1/${id}`, { method: "POST", headers: { "content-type": "application/json", "x-wafermap-payer": this.address, ...stream ? { accept: "text/event-stream" } : {}, ...pass ? { [PASS_HEADER]: pass } : {} }, body: JSON.stringify(input) }, o.network, inToken ? "wafermap" : void 0);
         const settle = (r2, out2) => {
           if (!r2.paid || !r2.id) return;
-          const status = r2.res.status === 402 ? "refused" : r2.res.ok ? "ok" : "failed";
+          const status = r2.res.status === 402 ? "refused" : r2.res.ok && !out2?.streamError ? "ok" : "failed";
           this.outcome(r2.id, "resource", id, r2.paid, status, out2?.receipt?.tx ?? r2.paid.tx, typeof out2?.receipt?.amountUsd === "number" ? out2.receipt.amountUsd : null);
         };
         const host = new URL(this.baseUrl).host;
-        const read = (r2) => this.body(r2.res, () => r2.res.json(), {}, host, r2.paid?.auth ?? (r2.paid ? {} : null));
+        const read = (r2) => this.body(
+          r2.res,
+          async () => {
+            if (!(stream && r2.res.ok && (r2.res.headers.get("content-type") ?? "").includes("text/event-stream"))) return r2.res.json();
+            const s = await this.readStream(r2.res, o.onDelta);
+            return { resource: id, result: { text: s.done?.text ?? "", model: s.done?.model, usage: s.done?.usage }, receipt: s.receipt, streamError: s.error };
+          },
+          {},
+          host,
+          r2.paid?.auth ?? (r2.paid ? {} : null)
+        );
         let r = await go();
         let out = await read(r);
         settle(r, out);
@@ -959,6 +999,7 @@ var init_core = __esm({
         const { res, paid } = r;
         const refused = this.rejected(res, out, paid);
         if (refused) throw refused;
+        if (out?.streamError) throw new WafermapError(out.streamError.code ?? "stream_failed", out.streamError.message ?? "The answer did not finish. You were not charged.");
         if (!res.ok) throw new WafermapError(out?.error?.code ?? "http_error", out?.error?.message ?? (typeof out?.error === "string" ? out.error : `HTTP ${res.status}`));
         return out;
       }
@@ -1247,7 +1288,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = "0.4.8";
+    VERSION = "0.4.9";
   }
 });
 
@@ -1810,6 +1851,7 @@ Pay
   wafermap resources [words]            Wafermap's pay-per-call catalog
   wafermap call <id> [field=value ...]  run a resource and pay its price  (--json '{...}' for complex input)
   wafermap call <id> ... --pay wafermap pay a Wafermap resource in $WAFERMAP at 50% off (the tokens are burned)
+  wafermap call <llm> ... --stream       print the answer as it arrives; you pay only once the model finishes
   wafermap approve-wafermap             one-time approval so the wallet can pay in $WAFERMAP (Robinhood Chain, ETH gas)
   wafermap holder                       what this wallet's $WAFERMAP unlocks: holder price, Pro free calls left today
   wafermap pass                         print a holder pass (X-Wafermap-Pass) for scripts and x402 Tracker Pro
@@ -1831,7 +1873,7 @@ function parse(argv) {
     if (a.startsWith("--")) {
       const [k, v] = a.slice(2).split("=", 2);
       if (v !== void 0) out.flags[k] = v;
-      else if (argv[i + 1] && !argv[i + 1].startsWith("--") && !["yes", "post", "import"].includes(k)) out.flags[k] = argv[++i];
+      else if (argv[i + 1] && !argv[i + 1].startsWith("--") && !["yes", "post", "import", "stream"].includes(k)) out.flags[k] = argv[++i];
       else out.flags[k] = true;
     } else out._.push(a);
   }
@@ -2050,12 +2092,15 @@ Total $${total.toFixed(4)} in ${pays.length} payments. From 0.3.3 every payment
       const id = a._[0] ?? die("Which resource? e.g. wafermap call gas-now network=base");
       const wm = openWallet(await password(), approver(yes));
       const payIn = a.flags.pay === "wafermap" ? "wafermap" : a.flags.pay === void 0 || a.flags.pay === "usd" ? void 0 : die("--pay must be wafermap (or leave it out to pay in USDG/USDC)");
-      const out = await wm.call(id, inputOf(a, 1), { network: net(a.flags.network), payIn });
+      let streamed = false;
+      const onDelta = a.flags.stream === true ? (t) => (streamed = true, process.stdout.write(t)) : void 0;
+      const out = await wm.call(id, inputOf(a, 1), { network: net(a.flags.network), payIn, onDelta });
+      if (streamed) process.stdout.write("\n");
       if (out.receipt?.asset === "WAFERMAP") console.error(`\u2713 Paid ${out.receipt.amountTokens} $WAFERMAP (\u2248 $${out.receipt.amountUsd}), burned \xB7 ${EXPLORER(out.receipt.network)}/tx/${out.receipt.tx}`);
       else if (out.receipt) console.error(`\u2713 Paid $${out.receipt.amountUsd} ${out.receipt.asset} \xB7 ${EXPLORER(out.receipt.network)}/tx/${out.receipt.tx}`);
       else if (out.free) console.error(`\u2713 Free call ($WAFERMAP Pro) \xB7 ${out.free.left} of ${out.free.perDay} left today. Nothing was paid.`);
       if (typeof a.flags.out === "string") await saveMedia(out.result, a.flags.out);
-      return printResult(out.result);
+      return streamed ? void 0 : printResult(out.result);
     }
     case "pay": {
       const url = a._[0] ?? die("Which URL? e.g. wafermap pay https://example.com/api city=Paris");

package/dist/index.js

@@ -871,19 +871,59 @@ var Wafermap = class {
       throw new WafermapError("approve_failed", e?.shortMessage ?? e?.message ?? "The approval failed.");
     }
   }
+  /** Reads /v1's server-sent events for an LLM call: delta pieces as they arrive, then receipt (or error), then done. */
+  async readStream(res, onDelta) {
+    const reader = res.body.pipeThrough(new TextDecoderStream()).getReader();
+    let buf = "";
+    let receipt = null;
+    let done = null;
+    let error = null;
+    for (; ; ) {
+      const { value, done: end } = await reader.read();
+      if (end) break;
+      buf += value;
+      let i;
+      while ((i = buf.indexOf("\n\n")) >= 0) {
+        const block = buf.slice(0, i);
+        buf = buf.slice(i + 2);
+        const ev = /^event: (.+)$/m.exec(block)?.[1];
+        let data = null;
+        try {
+          data = JSON.parse(/^data: (.*)$/m.exec(block)?.[1] ?? "null");
+        } catch {
+        }
+        if (ev === "delta" && typeof data?.text === "string") onDelta(data.text);
+        else if (ev === "receipt") receipt = data;
+        else if (ev === "done") done = data;
+        else if (ev === "error") error = data;
+      }
+    }
+    return { receipt, done, error };
+  }
   async call(id, input = {}, o = {}) {
     const inToken = o.payIn === "wafermap";
+    const stream = !!o.onDelta && !inToken;
     if (inToken && id.startsWith("m/")) throw new WafermapError("token_not_offered", "Marketplace listings are paid in USDG or USDC to their seller, not in $WAFERMAP.");
     if (inToken && !await this.wafermapApproved().catch(() => true)) throw new WafermapError("permit2_not_approved", "Paying in $WAFERMAP needs a one-time approval of Permit2. Run `wafermap approve-wafermap` (one transaction on Robinhood Chain, paid in ETH), then call again.");
     const pass = id.startsWith("m/") ? null : await this.holderPass();
-    const go = () => this.paidFetch("resource", id, `${this.baseUrl}/v1/${id}`, { method: "POST", headers: { "content-type": "application/json", "x-wafermap-payer": this.address, ...pass ? { [PASS_HEADER]: pass } : {} }, body: JSON.stringify(input) }, o.network, inToken ? "wafermap" : void 0);
+    const go = () => this.paidFetch("resource", id, `${this.baseUrl}/v1/${id}`, { method: "POST", headers: { "content-type": "application/json", "x-wafermap-payer": this.address, ...stream ? { accept: "text/event-stream" } : {}, ...pass ? { [PASS_HEADER]: pass } : {} }, body: JSON.stringify(input) }, o.network, inToken ? "wafermap" : void 0);
     const settle = (r2, out2) => {
       if (!r2.paid || !r2.id) return;
-      const status = r2.res.status === 402 ? "refused" : r2.res.ok ? "ok" : "failed";
+      const status = r2.res.status === 402 ? "refused" : r2.res.ok && !out2?.streamError ? "ok" : "failed";
       this.outcome(r2.id, "resource", id, r2.paid, status, out2?.receipt?.tx ?? r2.paid.tx, typeof out2?.receipt?.amountUsd === "number" ? out2.receipt.amountUsd : null);
     };
     const host = new URL(this.baseUrl).host;
-    const read = (r2) => this.body(r2.res, () => r2.res.json(), {}, host, r2.paid?.auth ?? (r2.paid ? {} : null));
+    const read = (r2) => this.body(
+      r2.res,
+      async () => {
+        if (!(stream && r2.res.ok && (r2.res.headers.get("content-type") ?? "").includes("text/event-stream"))) return r2.res.json();
+        const s = await this.readStream(r2.res, o.onDelta);
+        return { resource: id, result: { text: s.done?.text ?? "", model: s.done?.model, usage: s.done?.usage }, receipt: s.receipt, streamError: s.error };
+      },
+      {},
+      host,
+      r2.paid?.auth ?? (r2.paid ? {} : null)
+    );
     let r = await go();
     let out = await read(r);
     settle(r, out);
@@ -898,6 +938,7 @@ var Wafermap = class {
     const { res, paid } = r;
     const refused = this.rejected(res, out, paid);
     if (refused) throw refused;
+    if (out?.streamError) throw new WafermapError(out.streamError.code ?? "stream_failed", out.streamError.message ?? "The answer did not finish. You were not charged.");
     if (!res.ok) throw new WafermapError(out?.error?.code ?? "http_error", out?.error?.message ?? (typeof out?.error === "string" ? out.error : `HTTP ${res.status}`));
     return out;
   }

package/dist/types/src/core.d.ts

@@ -155,9 +155,12 @@ export declare class Wafermap {
      *  transaction on Robinhood Chain, paid in ETH. Each payment after that is a signature for one exact amount,
      *  spendable only by Wafermap's relayer for two minutes. */
     approveWafermap(): Promise<string>;
+    /** Reads /v1's server-sent events for an LLM call: delta pieces as they arrive, then receipt (or error), then done. */
+    private readStream;
     call(id: string, input?: Record<string, unknown>, o?: {
         network?: Net;
         payIn?: "stablecoin" | "wafermap";
+        onDelta?: (text: string) => void;
     }): Promise<{
         resource: string;
         result: any;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wafermapxyz/cli",
-  "version": "0.4.8",
+  "version": "0.4.9",
   "description": "Wafermap for agents: an encrypted local wallet that pays x402 resources, discovers and pays third-party x402 services (USDG on Robinhood Chain; USDC on Solana, Base, Arbitrum, Polygon, Arc, Soneium), and swaps on Robinhood Chain and Base. CLI, SDK and MCP server.",
   "type": "module",
   "bin": {