openzoo 0.50.88 → 0.50.90

package/bin/openzoo.js

@@ -330,7 +330,7 @@ async function main() {
     }
     case 'ask': {
       const question = process.argv[3];
-      if (!question) throw new Error('usage: openzoo ask "<question>" [--context <id>] [--model <id>] [--system <text>]');
+      if (!question) throw new Error('usage: openzoo ask "<question>" [--context <id>] [--model <id>] [--system <text>] [--web [--web-results N]]');
       const ci = process.argv.indexOf('--context');
       const mi = process.argv.indexOf('--model');
       // A BARE QUESTION IS A DIFFERENT PRODUCT FROM A BRIEFED ONE.
@@ -344,7 +344,20 @@ async function main() {
       // DHH, Hyprland and theming. Same gateway, same product, one had context.
       // A caller that knows where it is running can now say so.
       const si = process.argv.indexOf('--system');
-      const system = si !== -1 ? process.argv[si + 1] : '';
+      let system = si !== -1 ? process.argv[si + 1] : '';
+      // --web: a keyless DuckDuckGo search, top results injected into THIS
+      // call's system prompt. The x402 rail strips OpenRouter's `plugins`
+      // field, so search-then-inject has to happen here, on the caller's
+      // side. EGRESS: the question text goes to duckduckgo.com. Also on with
+      // OPENZOO_ASK_WEB=1; --web-results N caps the count (default 5).
+      const wantWeb = process.argv.includes('--web') || process.env.OPENZOO_ASK_WEB === '1';
+      if (wantWeb) {
+        const wi = process.argv.indexOf('--web-results');
+        const n = wi !== -1 ? Number(process.argv[wi + 1]) || 5 : 5;
+        const { webSearch, formatWebResults } = await import('../lib/websearch.js');
+        const hits = await webSearch(question, n).catch((e) => { console.error(`web search failed: ${e.message}`); return []; });
+        if (hits.length) system = (system ? system + '\n\n' : '') + formatWebResults(question, hits);
+      }
       const { PayClient } = await import('../lib/pay.js');
       const { config } = await import('../lib/config.js');
       const client = new PayClient();

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/lib/websearch.js

@@ -0,0 +1,31 @@
+// Keyless web search for `openzoo ask --web`: DuckDuckGo's HTML endpoint,
+// scraped for title / url / snippet. No API key, no account, one GET. The
+// only thing that leaves is the question text, to duckduckgo.com.
+const strip = (s) => String(s || '')
+  .replace(/<[^>]+>/g, '')
+  .replace(/&amp;/g, '&').replace(/&quot;/g, '"').replace(/&#x27;/g, "'").replace(/&lt;/g, '<').replace(/&gt;/g, '>')
+  .replace(/\s+/g, ' ').trim();
+
+export async function webSearch(query, max = 5) {
+  const res = await fetch('https://html.duckduckgo.com/html/?q=' + encodeURIComponent(query), {
+    headers: { 'user-agent': 'Mozilla/5.0 openzoo-ask/1.0' },
+    signal: AbortSignal.timeout(12_000),
+  });
+  if (!res.ok) throw new Error(`duckduckgo HTTP ${res.status}`);
+  const html = await res.text();
+  const out = [];
+  const re = /<a[^>]*class="result__a"[^>]*href="([^"]+)"[^>]*>([\s\S]*?)<\/a>[\s\S]*?class="result__snippet"[^>]*>([\s\S]*?)<\/a>/g;
+  let m;
+  while ((m = re.exec(html)) && out.length < Math.max(1, Math.min(10, max))) {
+    let url = m[1];
+    const redirected = url.match(/uddg=([^&]+)/);
+    if (redirected) url = decodeURIComponent(redirected[1]);
+    out.push({ title: strip(m[2]), url, snippet: strip(m[3]).slice(0, 400) });
+  }
+  return out;
+}
+
+export function formatWebResults(query, hits) {
+  const lines = hits.map((h, i) => `${i + 1}. ${h.title} — ${h.url}\n   ${h.snippet}`);
+  return `Web search results for "${query}" (DuckDuckGo, fetched just now; cite the url when you rely on one):\n${lines.join('\n')}`;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "openzoo",
-  "version": "0.50.88",
-  "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": {