openzoo 0.50.89 → 0.50.90

package/lib/cursorbackend.js

@@ -3075,17 +3075,20 @@ async function zooComplete(prompt, log, agentId, parsed = {}, opts = {}) {
     if (r.status === 402) {
       const raw = zooTextFromMessage(data?.choices?.[0]?.message, data)
         || data?.error?.message
-        || 'openzoo wallet underfunded.';
+        || 'openzoo payment required (HTTP 402).';
+      data.error = data.error || {};
+      data.error.message = raw;
       try {
-        const { withOnrampLink } = await import('./stripeOnramp.js');
-        const { loadOrCreateWallet } = await import('./wallet.js');
-        const w = loadOrCreateWallet();
-        const usd = Number(String(raw).match(/≈\$([0-9.]+)/)?.[1]);
-        data.error = data.error || {};
-        data.error.message = await withOnrampLink(raw, {
-          solana: w.keypair.publicKey.toBase58(),
-          usd,
-        });
+        const { withOnrampLink, isFundInstruction } = await import('./stripeOnramp.js');
+        if (isFundInstruction(raw)) {
+          const { loadOrCreateWallet } = await import('./wallet.js');
+          const w = loadOrCreateWallet();
+          const usd = Number(String(raw).match(/≈\$([0-9.]+)/)?.[1]);
+          data.error.message = await withOnrampLink(raw, {
+            solana: w.keypair.publicKey.toBase58(),
+            usd,
+          });
+        }
       } catch { /* keep proxy copy */ }
     }
     return { r, data };

package/lib/proxy.js

@@ -9,7 +9,7 @@ import {
 } from './config.js';
 import { execSync } from 'node:child_process';
 import { PayClient, QuoteTooHighError, UnderfundedError } from './pay.js';
-import { withOnrampLink } from './stripeOnramp.js';
+import { withOnrampLink, settleFailCopy, isFundInstruction } from './stripeOnramp.js';
 import { tokenBalance } from './x402.js';
 import { evmTokenBalance } from './evm.js';
 import { autoContext } from './autobind.js';
@@ -854,7 +854,6 @@ export async function startProxy({ silent = false, requireToken = null, sessionM
       // half-kilobyte accepts[] blob at the user instead of the one thing they
       // need: the price, what the wallet holds, and where to send funds.
       if (response.status === 402) {
-        let quoted = '';
         let usd;
         let q402 = null;
         try { q402 = await response.clone().json(); } catch { q402 = null; }
@@ -871,18 +870,18 @@ export async function startProxy({ silent = false, requireToken = null, sessionM
           return;
         }
         try {
-          const q = q402;
-          usd = Number(q?.accepts?.[0]?.extra?.billedUsd);
-          if (Number.isFinite(usd)) quoted = ` This call needs ≈$${usd.toFixed(4)}.`;
-        } catch { /* body was not the quote after all */ }
-        const msg = await withOnrampLink(
-          `openzoo wallet underfunded — payment did not settle.${quoted} `
-          + `Fund it and retry: send USDC (or TOKEN/LEOS for half price) to ${client.address} on Solana, `
-          + `or USDC to ${client.evmAddress} on Base. Check with: openzoo balance`,
-          { solana: client.address, usd },
-        );
-        log(/ties to your account/i.test(msg) ? 'onramp: whop + copy-paste solana' : 'onramp: no fund blurb');
-        jsonErr(res, 402, msg);
+          usd = Number(q402?.accepts?.[0]?.extra?.billedUsd);
+          if (!Number.isFinite(usd)) usd = undefined;
+        } catch { usd = undefined; }
+        const copy = settleFailCopy(q402);
+        let msg = copy.message;
+        const wantOnramp = copy.code === 'insufficient_funds'
+          || (!paid && isFundInstruction(copy.reason, copy));
+        if (wantOnramp) {
+          msg = await withOnrampLink(msg, { solana: client.address, usd, code: copy.code });
+        }
+        log(/ties to your account/i.test(msg) ? 'onramp: whop + copy-paste solana' : `402: ${msg.slice(0, 140)}`);
+        jsonErr(res, paid ? copy.status : 402, msg);
         return;
       }
       await relay(res, response, meterStreamed);

package/lib/stripeOnramp.js

@@ -103,8 +103,58 @@ export function whopFundBlurb(solana) {
   ].join('\n');
 }
 
+/**
+ * Genuine empty-wallet / fund-me copy. A post-pay settle failure
+ * ("payment did not settle" with a gateway reason and no underfunded
+ * wording) is NOT this — those wallets are often funded; the 402 is
+ * the facilitator or upstream.
+ */
+export function isFundInstruction(text, extra = {}) {
+  const code = extra.code ?? extra.advice?.code;
+  if (String(code || '') === 'insufficient_funds') return true;
+  const s = String(text || '');
+  if (!s) return false;
+  if (/\b(?:wallet underfunded|empty wallet|wallet is empty|needs more than the wallet holds|insufficient[_\s]funds)\b/i.test(s)) return true;
+  if (/\bunderfunded\b/i.test(s)) return true;
+  if (/\bsend (?:usdc|a few cents)\b/i.test(s)) return true;
+  if (/\bno offered payment row is affordable/i.test(s)) return true;
+  return false;
+}
+
+function gatewayReason(q402) {
+  if (!q402 || typeof q402 !== 'object') return '';
+  const err = q402.error;
+  const advice = q402.advice;
+  if (typeof err?.message === 'string' && err.message.trim()) return err.message.trim();
+  if (typeof err === 'string' && err.trim()) return err.trim();
+  if (typeof advice?.message === 'string' && advice.message.trim()) return advice.message.trim();
+  if (typeof advice === 'string' && advice.trim()) return advice.trim();
+  if (advice && typeof advice === 'object') {
+    const bits = [advice.code, advice.reason, advice.detail].filter((x) => typeof x === 'string' && x.trim());
+    if (bits.length) return bits.join(': ');
+  }
+  return '';
+}
+
+/**
+ * Copy for a 402 AFTER PayClient already signed and retried (paid:true).
+ * Never "wallet underfunded" — that string is reserved for preflight
+ * empty-wallet errors. Prefix stays greppable as "payment did not settle".
+ */
+export function settleFailCopy(q402) {
+  const reason = gatewayReason(q402);
+  const code = q402?.advice?.code || q402?.error?.code || '';
+  const fund = isFundInstruction(reason, { code, advice: q402?.advice });
+  const message = reason
+    ? `openzoo payment did not settle: ${reason}`
+    : 'openzoo payment did not settle';
+  const upstreamish = /upstream|facilitator|internal(?: server)? error|settle(?:ment)? (?:failed|error)/i.test(reason) && !fund;
+  return { message, status: upstreamish ? 502 : 402, fund, reason, code: String(code || '') };
+}
+
 export async function withOnrampLink(text, dest) {
   const body = String(text || '').trim();
+  if (!isFundInstruction(body, dest)) return body;
   const blurb = whopFundBlurb(dest?.solana);
   if (!blurb) return body;
   if (/ties to your account/i.test(body) && body.includes(String(dest.solana))) return body;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "openzoo",
-  "version": "0.50.89",
-  "description": "Local x402-paying proxy + MCP server for openzoo.fun — point any OpenAI-compatible harness (Cursor, Claude Code, aider, SDKs) at localhost and it pays per call from a local burner wallet. Solana and Base rails live; Robinhood experimental.",
+  "version": "0.50.90",
+  "description": "Local x402-paying proxy + MCP server for openzoo.fun \u2014 point any OpenAI-compatible harness (Cursor, Claude Code, aider, SDKs) at localhost and it pays per call from a local burner wallet. Solana and Base rails live; Robinhood experimental.",
   "license": "MIT",
   "type": "module",
   "bin": {