openzoo 0.50.94 → 0.50.96

package/bin/claude-zoo.js

@@ -6,7 +6,7 @@
  * the local openzoo proxy on :8402 (x402 per-call payment, no Anthropic
  * subscription, no login):
  *
- *   - starts the proxy if it is not already listening
+ *   - starts the proxy if it is not already THIS version on :8402 (steals stale)
  *   - applies claudeZooEnv(): ANTHROPIC_BASE_URL=localhost:PORT/v1,
  *     AUTH_TOKEN=sk-openzoo, ANTHROPIC_API_KEY deleted, compaction disabled
  *     (the proxy binds the prefix), 1M-token ceiling restored
@@ -16,7 +16,8 @@
  * `claude-code-cli` (same directory, symlinked to occ).
  */
 import { spawn } from 'node:child_process';
-import { existsSync, readdirSync as fsReaddir } from 'node:fs';
+import { existsSync, readdirSync as fsReaddir, readFileSync } from 'node:fs';
+import { execSync } from 'node:child_process';
 import { homedir, platform } from 'node:os';
 import { dirname, join, sep } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -50,10 +51,34 @@ if (!occ) {
 const PROXY_PORT = Number(process.env.OPENZOO_PROXY_PORT || 8402);
 const PROXY_URL = `http://localhost:${PROXY_PORT}/v1`;
 
+function mineVersion() {
+  try {
+    return JSON.parse(readFileSync(join(shimRoot, 'package.json'), 'utf8')).version;
+  } catch { return ''; }
+}
+
+function stealPort(port) {
+  const n = Number(port);
+  for (const cmd of [
+    `lsof -t -iTCP:${n} -sTCP:LISTEN | xargs kill -9`,
+    `fuser -k ${n}/tcp`,
+  ]) {
+    try { execSync(cmd, { stdio: 'ignore', timeout: 2000, shell: true }); } catch { /* missing */ }
+  }
+}
+
 async function proxyUp() {
   try {
     const r = await fetch(`http://localhost:${PROXY_PORT}/v1/info`, { signal: AbortSignal.timeout(1500) });
-    return r.ok;
+    if (!r.ok) return false;
+    const j = await r.json().catch(() => ({}));
+    const mine = mineVersion();
+    if (mine && String(j.version || '') !== mine) {
+      console.error(`claude: stale proxy v${j.version || '?'} on :${PROXY_PORT} — stealing for v${mine}`);
+      stealPort(PROXY_PORT);
+      return false;
+    }
+    return true;
   } catch { return false; }
 }
 

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>] [--web [--web-results N]]');
+      if (!question) throw new Error('usage: openzoo ask "<question>" [--context <id>] [--model <id>] [--system <text>]');
       const ci = process.argv.indexOf('--context');
       const mi = process.argv.indexOf('--model');
       // A BARE QUESTION IS A DIFFERENT PRODUCT FROM A BRIEFED ONE.
@@ -344,20 +344,7 @@ 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');
-      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 system = si !== -1 ? process.argv[si + 1] : '';
       const { PayClient } = await import('../lib/pay.js');
       const { config } = await import('../lib/config.js');
       const client = new PayClient();
@@ -402,17 +389,6 @@ async function main() {
     case '-h':
       console.log(HELP);
       break;
-    case 'version':
-    case '--version':
-    case '-v':
-    case '-V': {
-      // Every installer, mise shim and shell script that probes a CLI asks
-      // this first; answering "unknown command" to it failed real installs.
-      const { readFileSync } = await import('fs');
-      const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
-      console.log(pkg.version);
-      break;
-    }
     default:
       console.error(`unknown command: ${cmd}\n`);
       console.log(HELP);

package/lib/aoe.js

@@ -287,9 +287,15 @@ export async function setupAoe(argv = []) {
 
   const base = `http://localhost:${config.port}/v1`;
   if (!flags.has('--no-proxy')) {
-    if (await proxyUp(base)) {
-      console.error(`openzoo: proxy already up on ${base}`);
+    const { oursOn, packageVersion, killListen } = await import('./proxy.js');
+    if (await oursOn(config.port)) {
+      console.error(`openzoo: proxy v${packageVersion()} already on ${base}`);
     } else {
+      if (await proxyUp(base)) {
+        console.error(`openzoo: stale proxy on ${base} — stealing :${config.port}`);
+        killListen(config.port);
+        await new Promise((r) => setTimeout(r, 400));
+      }
       const { pid, logPath } = startDetachedProxy({ tunnel: flags.has('--tunnel') });
       let up = false;
       for (let i = 0; i < 40 && !up; i++) {

package/lib/cursorbackend.js

@@ -44,7 +44,8 @@ import {
   readWakeups, writeWakeups, shapeWakeup, parseWakeupEvery, wantsWakeupCron,
   DEFAULT_WAKEUP_PROMPT, addDeletedIds, filterDeleted,
 } from './grokbotAccount.js';
-import { formatSpendFooter, mergeTurnProof } from './spendProof.js';
+import { spendChipLabel, formatSpendFooter, mergeTurnProof } from './spendProof.js';
+import { spendLinesOnly, writeSpendHud } from './ozSpendChip.js';
 import { zooModelIds, zooModelRow, mediaKindOf } from './models.js';
 import { prefixVisitorRichText } from './grokbotweb.js';
 import {
@@ -1880,7 +1881,15 @@ async function zooSpendOverlay(data) {
   const bal = Number.isFinite(wallet) && wallet > 0.004
     ? wallet
     : (Number.isFinite(credit) && credit > 0.004 ? credit : null);
-  return formatSpendFooter({
+  const label = spent > 0.00005 ? spendChipLabel({
+    billedUsd: x.billedUsd,
+    directUsd: x.directUsd,
+    spent,
+    would,
+    saved,
+    pct,
+  }) : '';
+  const footer = formatSpendFooter({
     billedUsd: x.billedUsd,
     directUsd: x.directUsd,
     spent,
@@ -1890,6 +1899,12 @@ async function zooSpendOverlay(data) {
     balance: bal,
     x402: x,
   });
+  const body = spendLinesOnly(footer) || (spent > 0.00005
+    ? `spent $${spent.toFixed(4)} · OpenRouter would $${would.toFixed(4)} · saved $${saved.toFixed(4)} (${pct.toFixed(0)}%)`
+    : '');
+  const state = { spent, would, saved, pct, label, billedUsd: x.billedUsd, directUsd: x.directUsd, balance: bal, body };
+  try { writeSpendHud(state); } catch { /* */ }
+  return state;
 }
 
 const MODELS_PATH = path.join(os.homedir(), '.openzoo', 'grokbot-models.json');
@@ -2941,7 +2956,7 @@ async function zooComplete(prompt, log, agentId, parsed = {}, opts = {}) {
           'This is a public visitor chat. You do not have filesystem, shell, or local-exec access on the host Mac.',
           'Reply in chat only. Do not claim you will write files, run commands, or use local tools.',
           'Each human line is prefixed with that visitor\'s shortname and a colon, like "rex: hello". Different shortnames are different people. Address them by that name.',
-          'A spend footer is appended after your reply by the host -- ignore it.',
+          'Do not write spend totals, solscan links, memos, or ::oz-spend:: into the reply. The host paints a HUD pill.',
           'Prior turns of THIS Grok Bot chat are in the messages below. Do not claim the thread starts blank or that earlier questions did not arrive.',
         ].join(' ')
         : [
@@ -2984,8 +2999,8 @@ async function zooComplete(prompt, log, agentId, parsed = {}, opts = {}) {
           'Never claim you lack filesystem access or local-exec. If a tool errors, report the error.',
           'After using tools you MUST still write a normal chat reply: what you did, file paths written, and what to open. Empty content is a bug. A new user message cancels this turn — leave a visible reply before that happens.',
           'Do not stop mid-task. Do not write "Stopped on research", "nothing to open yet", "no app files written this turn", or "say go again". Keep using tools until the files the user asked for exist on disk THIS turn. Summarize only after those writes succeed.',
-          'A spend footer is appended after your reply by the host — ignore it.',
-          'The operator wallet pays every zoo call via x402 (TOKEN/USDC on Solana; SOL gas is sponsored). If this thread has a spend footer or solscan/basescan tx, the call WAS paid. Do not say you have no money, cannot afford tools, or need the human to fund you. A 402/underfunded tool error is a host retry — continue the job.',
+          'Do not write spend totals, solscan links, memos, or ::oz-spend:: into the reply. The host paints a HUD pill.',
+          'The operator wallet pays every zoo call via x402 (TOKEN/USDC on Solana; SOL gas is sponsored). If the spend HUD is visible or a prior turn paid, the call WAS paid. Do not say you have no money, cannot afford tools, or need the human to fund you. A 402/underfunded tool error is a host retry — continue the job.',
           'Prior turns of THIS Grok Bot chat are in the messages below. Do not claim the thread starts blank or that earlier questions did not arrive.',
         ].join(' '),
     },
@@ -3075,17 +3090,22 @@ 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');
+        // Settle/upstream 402s keep the real message. Whop copy-paste only
+        // when this is a genuine empty-wallet / fund-me instruction.
+        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 };
@@ -3232,7 +3252,7 @@ async function zooComplete(prompt, log, agentId, parsed = {}, opts = {}) {
   if (lastData && typeof lastData === 'object') {
     lastData.x402 = mergeTurnProof(turnX402, lastData);
   }
-  try { text += await zooSpendOverlay(lastData); } catch { /* overlay must never eat the reply */ }
+  try { await zooSpendOverlay(lastData); } catch { /* HUD dump; never append to the reply */ }
   return { text, data: lastData };
 }
 
@@ -3297,6 +3317,12 @@ async function handleHijackedPodHttp(req, res, full, body, log) {
   // Revive: the minutely cron (scripts/revive-bots.sh) calls this after it has
   // made sure the hijack + app are alive. Every non-group bot gets a wakeup
   // timer if it lost one; nothing is spawned, nothing already armed is touched.
+  if (name === 'ozSpend') {
+    let state = { spent: 0, would: 0, saved: 0, pct: 0, label: '' };
+    try { state = await zooSpendOverlay(null); } catch { /* */ }
+    jsonSend(res, { ok: true, ...state });
+    return true;
+  }
   if (name === 'ozRevive') {
     let parsed = {};
     try { parsed = JSON.parse(String(body || '{}')); } catch { parsed = {}; }
@@ -3603,7 +3629,6 @@ async function handleHijackedPodHttp(req, res, full, body, log) {
               text = `model set to ${id}`;
             }
           }
-          try { text += await zooSpendOverlay({}); } catch { /* */ }
         } else {
           const members = groupMemberIds(agentId);
           if (members.length) {

package/lib/grokbotweb.js

@@ -18,7 +18,7 @@ import { exec } from 'node:child_process';
 import { config } from './config.js';
 import { readHouseRoster } from './grokbotAccount.js';
 import { ingestUpload, lookupUpload } from './grokbotUploads.js';
-import { spendChipSource } from './ozSpendChip.js';
+import { spendChipSource, sessionSpendState } from './ozSpendChip.js';
 
 const HERE = path.dirname(fileURLToPath(import.meta.url));
 const SHIM_PATH = path.join(HERE, 'grokbotweb-shim.js');
@@ -763,6 +763,15 @@ export async function startGrokBotWeb(opts = {}) {
 
   const server = http.createServer((req, res) => {
     const urlPath = decodeURIComponent((req.url || '/').split('?')[0]);
+    if (urlPath === '/oz-spend') {
+      writeHead(res, 200, {
+        'content-type': 'application/json',
+        'cache-control': 'no-store',
+        'access-control-allow-origin': '*',
+      }, req);
+      res.end(JSON.stringify({ ok: true, ...sessionSpendState() }));
+      return;
+    }
     if (urlPath === '/oz-health') {
       writeHead(res, 200, { 'content-type': 'application/json' }, req);
       res.end(JSON.stringify({

package/lib/launch.js

@@ -190,18 +190,21 @@ export function claudeZooEnv(baseEnv = process.env, { base, port } = {}) {
  * DEFAULT is the desktop app; `--terminal` (or `-t`) runs the Claude Code CLI.
  * Both get ANTHROPIC_BASE_URL so inference pays x402.
  */
+
+
 export async function launchClaude(argv) {
-  // let, not const: startProxy can heal onto a different port and every URL
-  // below must follow the port we actually bound.
+  // NEVER hop. :8402 is the product. startProxy steals a stale listener.
   let base = `http://localhost:${config.port}/v1`;
-  // AUTO-START THE PROXY. One command should just work — if nothing is listening,
-  // boot the proxy in THIS process (it stays alive because claude runs in the
-  // foreground below), rather than making the user run `npx openzoo` first.
+  // AUTO-START THE PROXY. One command should just work — if nothing is listening
+  // (or a leftover npx cache is), boot THIS version on :8402 in this process.
   let up = false;
-  // /info, not /models — see the poll below. "Is a proxy already listening" must
-  // not be answered by an endpoint that needs the gateway, or a user whose
-  // upstream is flaky gets told to start a proxy that is already running.
-  try { up = (await fetch(`${base}/info`, { signal: AbortSignal.timeout(3000) })).ok; } catch { up = false; }
+  const { startProxy, oursOn, packageVersion } = await import('./proxy.js');
+  const mine = packageVersion();
+  if (await oursOn(config.port)) {
+    up = true;
+  } else {
+    process.stderr.write(`openzoo: claiming :${config.port} for v${mine}\n`);
+  }
   if (!up) {
     // NEVER GO SILENT DURING STARTUP. silent:true routes the proxy's own lines
     // to ~/.openzoo/proxy.log so payment receipts cannot corrupt Claude Code's
@@ -218,7 +221,6 @@ export async function launchClaude(argv) {
     tick.unref?.();
     const done = (msg) => { clearInterval(tick); process.stderr.write(`\r\x1b[2Kopenzoo: ${msg}\n`); };
     try {
-      const { startProxy } = await import('./proxy.js');
       await startProxy({ silent: true, autoTunnel: true });
     } catch (err) {
       // An exception here used to surface as an eternal spinner. Say what broke.
@@ -227,9 +229,6 @@ export async function launchClaude(argv) {
       console.error('  try: OPENZOO_NO_TUNNEL=1 npx openzoo claude   (skips the cloudflared download)');
       process.exit(1);
     }
-    // The proxy may have healed onto a different port (8402 busy). config.port
-    // is the one it ACTUALLY bound, so re-derive every URL from it — the old
-    // code kept polling the port it wished for and timed out on a live proxy.
     base = `http://localhost:${config.port}/v1`;
     // PROBE /v1/info, NOT /v1/models. `models` is PROXIED UPSTREAM, so on a
     // network with a bad path to the gateway the local proxy is listening and
@@ -580,17 +579,12 @@ export async function launchClaude(argv) {
 }
 
 export async function launchHarness(cmd, args) {
-  const base = `http://localhost:${config.port}/v1`;
-  // Fail early with a clear message rather than letting the harness spew
-  // connection errors — the #1 support question would otherwise be "why won't
-  // claude connect" when the answer is "the proxy isn't up".
-  try {
-    const r = await fetch(`${base}/models`, { signal: AbortSignal.timeout(4000) });
-    if (!r.ok) throw new Error(String(r.status));
-  } catch {
-    console.error(`openzoo: no proxy reachable at ${base}`);
-    console.error('start it first in another terminal:  npx openzoo');
-    process.exit(1);
+  let base = `http://localhost:${config.port}/v1`;
+  const { startProxy, oursOn, packageVersion } = await import('./proxy.js');
+  if (!(await oursOn(config.port))) {
+    process.stderr.write(`openzoo: claiming :${config.port} for v${packageVersion()}\n`);
+    await startProxy({ silent: true, autoTunnel: true });
+    base = `http://localhost:${config.port}/v1`;
   }
 
   const env = claudeZooEnv(process.env, { base });

package/lib/models.js

@@ -168,39 +168,9 @@ const tokensOf = (id) => id.toLowerCase().split(/[^a-z0-9.]+/).filter((t) => t &
  * the id is already servable (no rewrite), otherwise the closest zoo id.
  * OPENZOO_DEFAULT_MODEL is an explicit user override, not a fallback tier.
  */
-/**
- * UNOPENROUTER. OpenRouter is not an upstream any more (gateway, 2026-09-02):
- * every completion is bought from an x402 door, and doors publish BARE ids
- * (`grok-4.3`, `claude-sonnet-5`, `gemini-2.5-flash`). A harness that still
- * sends the OpenRouter spelling (`x-ai/grok-4.3`, `anthropic/claude-sonnet-5`)
- * is rewritten to the bare id whenever the live catalog serves that bare id.
- *
- *   OPENZOO_UNOPENROUTER=1  strip the vendor prefix ALWAYS, catalog or not
- *   OPENZOO_UNOPENROUTER=0  never strip
- *   unset                   strip when the bare id is in the catalog
- *
- * Router aliases and `openzoo-` twins are never touched: their slash is not a
- * vendor.
- */
-export function unopenrouter(requested, ids) {
-  const mode = process.env.OPENZOO_UNOPENROUTER;
-  if (mode === '0') return null;
-  const s = String(requested || '');
-  if (!s || isAutoModel(s) || /^openzoo[-/]/i.test(s)) return null;
-  const slash = s.indexOf('/');
-  if (slash <= 0) return null;
-  const bare = s.slice(slash + 1);
-  if (!bare || bare.includes('/')) return null;
-  if (mode === '1') return bare;
-  return Array.isArray(ids) && ids.includes(bare) ? bare : null;
-}
-
 export function resolveModel(requested, ids) {
   // Virtual router id — never family-match, never steal via OPENZOO_DEFAULT_MODEL.
   if (isAutoModel(requested)) return null;
-  // Vendor-prefixed OpenRouter spelling → the bare id the doors serve.
-  const bareVendor = unopenrouter(requested, ids);
-  if (bareVendor) return bareVendor;
   // Bare Anthropic / Claude Code ids are never live on Fly/OpenRouter
   // (`claude-opus-5` → 500 unknown model). Rewrite even on a catalog miss
   // or if a gateway row lists the bare name — the request must not leave

package/lib/ozSpendChip.js

@@ -1,5 +1,6 @@
 /**
- * Cafe spend chip — the ⓘ $N <details> that folds formatSpendFooter.
+ * Cafe/Grok Bot spend HUD. Live totals come from /oz-spend and /api/ozSpend;
+ * leftover ::oz-spend:: footers in old transcripts still fold into a chip.
  *
  * Cafe injects this via grokbotweb-shim concatenation. Grok Bot.app cannot
  * be patched (asar integrity), so `openzoo bot` launches Chromium with a
@@ -14,18 +15,82 @@ import { spendChipLabel } from './spendProof.js';
 
 export const GROKBOT_CDP_PORT = Number(process.env.OZ_GROKBOT_CDP_PORT || 9444);
 
-/** Session totals for a floating pill when the open canvas has no footer. */
-export function sessionSpendLabel(home = os.homedir()) {
+export function spendHudPath(home = os.homedir()) {
+  return path.join(home, '.openzoo', 'spend-hud.json');
+}
+
+export function writeSpendHud(state, home = os.homedir()) {
+  try {
+    const spent = Number(state?.spent) || 0;
+    const would = Number(state?.would) || 0;
+    const saved = Number(state?.saved) || 0;
+    const pct = Number(state?.pct) || 0;
+    const payload = {
+      spent,
+      would,
+      saved,
+      pct,
+      label: String(state?.label || ''),
+      body: String(state?.body || ''),
+      billedUsd: state?.billedUsd ?? null,
+      updatedAt: Date.now(),
+    };
+    fs.mkdirSync(path.dirname(spendHudPath(home)), { recursive: true, mode: 0o700 });
+    fs.writeFileSync(spendHudPath(home), JSON.stringify(payload), { mode: 0o600 });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export function readSpendHud(home = os.homedir()) {
+  try {
+    const j = JSON.parse(fs.readFileSync(spendHudPath(home), 'utf8'));
+    return j && typeof j === 'object' ? j : null;
+  } catch {
+    return null;
+  }
+}
+
+function sessionTotals(home) {
   try {
     const s = JSON.parse(fs.readFileSync(path.join(home, '.openzoo', 'session.json'), 'utf8'));
     const spent = Number(s.spentUsd || s.spendUsd || 0);
     const would = Number(s.directUsd || 0);
     const saved = Number(s.savedUsd != null ? s.savedUsd : Math.max(0, would - spent));
-    if (!(spent > 0.00005)) return '';
-    return spendChipLabel({ spent, would, saved, pct: would > 0 ? (100 * saved) / would : 0 });
+    const pct = would > 0 ? (100 * saved) / would : 0;
+    const label = spent > 0.00005 ? spendChipLabel({ spent, would, saved, pct }) : '';
+    return { spent, would, saved, pct, label };
   } catch {
-    return '';
+    return { spent: 0, would: 0, saved: 0, pct: 0, label: '' };
+  }
+}
+
+function sessionBody(sess) {
+  if (!(sess.spent > 0.00005)) return '';
+  return `spent $${sess.spent.toFixed(4)} · OpenRouter would $${sess.would.toFixed(4)} · saved $${sess.saved.toFixed(4)} (${Math.round(sess.pct)}%)`;
+}
+
+/** Session totals + last-call dump for the HUD pill. */
+export function sessionSpendState(home = os.homedir()) {
+  const sess = sessionTotals(home);
+  const hud = readSpendHud(home);
+  if (hud && (hud.label || hud.body)) {
+    return {
+      spent: Number(hud.spent) || sess.spent,
+      would: Number(hud.would) || sess.would,
+      saved: Number(hud.saved) || sess.saved,
+      pct: Number(hud.pct) || sess.pct,
+      label: String(hud.label || sess.label || ''),
+      body: String(hud.body || sessionBody(sess)),
+      billedUsd: hud.billedUsd ?? null,
+    };
   }
+  return { ...sess, body: sessionBody(sess), billedUsd: null };
+}
+
+export function sessionSpendLabel(home = os.homedir()) {
+  return sessionSpendState(home).label;
 }
 
 export function grokBotChromiumArgs(port = GROKBOT_CDP_PORT) {
@@ -159,9 +224,13 @@ function ozEnsureSpendCss() {
   }
   s.textContent = [
     '.oz-spend{margin:.55rem 0 0;font-size:12px;color:inherit;opacity:.82;max-width:36em}',
-    '#oz-spend-float>summary{cursor:grab}',
+    '#oz-spend-hud{opacity:1;max-width:min(28em,calc(100vw - 24px));pointer-events:auto}',
+    '#oz-spend-hud>summary{cursor:grab;background:#e85d1c;color:#fff;font-weight:600;font-size:13px;',
+    'border:0;box-shadow:0 4px 18px rgba(0,0,0,.5)}',
+    '#oz-spend-hud>.oz-spend-body{background:rgba(20,20,22,.94);color:#f4f4f5;padding:8px 10px;',
+    'border-radius:10px;margin-top:6px}',
     '.oz-spend>summary{cursor:help;list-style:none;display:inline-flex;align-items:center;gap:.35rem;',
-    'padding:3px 9px;border-radius:999px;border:1px solid rgba(255,255,255,.18);white-space:nowrap;',
+    'padding:6px 12px;border-radius:999px;border:1px solid rgba(255,255,255,.18);white-space:nowrap;',
     'max-width:100%;overflow:hidden;text-overflow:ellipsis}',
     '.oz-spend>summary::-webkit-details-marker{display:none}',
     '.oz-spend-body{white-space:pre-wrap;margin:.55rem 0 0;font-size:11px;line-height:1.45;opacity:.88;overflow-wrap:anywhere}',
@@ -213,11 +282,19 @@ export function stripSpendFromText(s) {
   return t;
 }
 
+function ozInComposer(el) {
+  if (!el) return false;
+  if (el.tagName === 'TEXTAREA' || el.tagName === 'INPUT' || el.isContentEditable) return true;
+  return !!(el.closest && el.closest('textarea, input, [contenteditable="true"]'));
+}
+
 function ozBlankSpendIn(root) {
+  if (ozInComposer(root)) return;
   const w = document.createTreeWalker(root, NodeFilter.SHOW_TEXT, null);
   while (w.nextNode()) {
     const tn = w.currentNode;
     if (tn.parentElement && tn.parentElement.closest && tn.parentElement.closest('.oz-spend')) continue;
+    if (ozInComposer(tn.parentElement)) continue;
     const next = stripSpendFromText(tn.nodeValue || '');
     if (next !== tn.nodeValue) tn.nodeValue = next;
   }
@@ -228,6 +305,7 @@ function ozHideSpendLeftovers() {
   for (let i = 0; i < nodes.length; i += 1) {
     const el = nodes[i];
     if (el.closest && el.closest('.oz-spend')) continue;
+    if (ozInComposer(el)) continue;
     if (el.querySelector && el.querySelector('.oz-spend')) continue;
     const vis = ozVisibleSpendText(el);
     if (!spendOnlyText(vis)) continue;
@@ -290,10 +368,11 @@ function ozCollapseSpend() {
   for (let i = 0; i < nodes.length; i += 1) {
     const el = nodes[i];
     if (el.closest && el.closest('.oz-spend')) continue;
+    if (ozInComposer(el)) continue;
     const t = ozVisibleSpendText(el);
     if (!/::oz-spend::|this call \$|spent \$/i.test(t)) continue;
     const host = ozSpendHost(el);
-    if (!host || seen.has(host)) continue;
+    if (!host || seen.has(host) || ozInComposer(host)) continue;
     seen.add(host);
     hosts.push(host);
   }
@@ -302,10 +381,11 @@ function ozCollapseSpend() {
     const vis = ozVisibleSpendText(host);
     const split = splitSpendText(vis);
     if (!split || !split.body || split.body.length < 12) continue;
+    if (split.summary) window.__OZ_SPEND_LAST__ = split.summary;
     ozEnsureSpendCss();
     if (spendOnlyText(vis)) {
       const prev = ozPreviousMessageCard(host);
-      if (prev && prev !== host) {
+      if (prev && prev !== host && !ozInComposer(prev)) {
         ozAttachSpendChip(prev, split);
         host.setAttribute('data-oz-spend-hide', '1');
         continue;
@@ -318,19 +398,44 @@ function ozCollapseSpend() {
   ozEnsureFloatSpend();
 }
 
-function ozEnsureFloatSpend() {
-  const label = String(window.__OZ_SESSION_SPEND__ || '').trim();
-  const msgPills = document.querySelectorAll('.oz-spend:not(#oz-spend-float)').length;
-  let el = document.getElementById('oz-spend-float');
-  if (!label || msgPills) {
-    if (el) el.remove();
-    return;
+/** Live HUD label: latest folded chip, then a read-only canvas scan, then inject snapshot. */
+function ozFloatLabel() {
+  const pills = document.querySelectorAll('.oz-spend:not(#oz-spend-hud):not(#oz-spend-float) summary');
+  if (pills.length) {
+    const lab = String(pills[pills.length - 1].textContent || '').replace(/^ⓘ\s*/, '').trim();
+    if (lab) {
+      window.__OZ_SPEND_LAST__ = lab;
+      return lab;
+    }
   }
+  try {
+    const nodes = document.querySelectorAll('[class*="sand-message"]');
+    for (let i = nodes.length - 1; i >= 0; i -= 1) {
+      if (ozInComposer(nodes[i])) continue;
+      const vis = ozVisibleSpendText(nodes[i]);
+      if (!/::oz-spend::|this call \$|spent \$/i.test(vis)) continue;
+      const split = splitSpendText(vis);
+      if (split && split.summary) {
+        window.__OZ_SPEND_LAST__ = split.summary;
+        return split.summary;
+      }
+    }
+  } catch (e) {}
+  if (window.__OZ_SPEND_LAST__) return String(window.__OZ_SPEND_LAST__);
+  return String(window.__OZ_SESSION_SPEND__ || '').trim();
+}
+
+function ozEnsureFloatSpend() {
+  const leftover = document.getElementById('oz-spend-float');
+  if (leftover) leftover.remove();
+  const label = ozFloatLabel() || String(window.__OZ_SESSION_SPEND__ || '').trim() || 'openzoo';
+  let el = document.getElementById('oz-spend-hud');
   ozEnsureSpendCss();
   if (!el) {
     el = document.createElement('details');
-    el.id = 'oz-spend-float';
+    el.id = 'oz-spend-hud';
     el.className = 'oz-spend';
+    el.open = true;
     const sum = document.createElement('summary');
     const body = document.createElement('div');
     body.className = 'oz-spend-body';
@@ -343,6 +448,9 @@ function ozEnsureFloatSpend() {
   ozDragFloat(el);
   const sum = el.querySelector('summary');
   if (sum) sum.textContent = 'ⓘ ' + label;
+  const bodyEl = el.querySelector('.oz-spend-body');
+  const dump = String(window.__OZ_SPEND_BODY__ || '').trim();
+  if (bodyEl && dump) bodyEl.textContent = dump;
 }
 
 function ozSavedFloatPos() {
@@ -357,9 +465,15 @@ function ozPlaceFloat(el) {
   if (!el) return;
   el.style.position = 'fixed';
   el.style.zIndex = '2147483646';
-  el.style.opacity = '0.95';
+  el.style.opacity = '1';
+  el.style.pointerEvents = 'auto';
+  const vw = Math.max(320, Number(window.innerWidth) || 800);
+  const vh = Math.max(240, Number(window.innerHeight) || 600);
   const saved = ozSavedFloatPos();
-  if (saved) {
+  const onScreen = saved
+    && saved.left >= 0 && saved.top >= 0
+    && saved.left < vw - 24 && saved.top < vh - 24;
+  if (onScreen) {
     el.style.left = Math.max(8, saved.left) + 'px';
     el.style.top = Math.max(8, saved.top) + 'px';
     el.style.right = 'auto';
@@ -368,8 +482,8 @@ function ozPlaceFloat(el) {
   }
   el.style.left = 'auto';
   el.style.right = '16px';
-  el.style.top = '48px';
-  el.style.bottom = 'auto';
+  el.style.top = 'auto';
+  el.style.bottom = '88px';
 }
 
 function ozDragFloat(el) {
@@ -414,31 +528,71 @@ function ozDragFloat(el) {
   }, true);
 }
 
+function ozLabelFromInfo(j) {
+  if (!j || typeof j !== 'object') return '';
+  if (typeof j.label === 'string' && j.label.trim()) return j.label.trim();
+  const spent = Number(j.spentUsd ?? j.spendUsd ?? j.spent ?? 0);
+  const would = Number(j.directUsd ?? j.would ?? 0);
+  const saved = Number(j.savedUsd != null ? j.savedUsd : (j.saved != null ? j.saved : Math.max(0, would - spent)));
+  if (!(spent > 0.00005)) return '';
+  return labelFromSpendBody(
+    'spent $' + spent.toFixed(4) + ' OpenRouter would $' + would.toFixed(4) + ' saved $' + saved.toFixed(4),
+    '',
+  );
+}
+
+function ozPollSpend() {
+  const urls = ['/oz-spend', '/api/ozSpend', 'https://127.0.0.1:8443/api/ozSpend', 'http://127.0.0.1:8402/v1/info'];
+  (async () => {
+    for (let i = 0; i < urls.length; i += 1) {
+      try {
+        const r = await fetch(urls[i], { signal: AbortSignal.timeout(1500) });
+        if (!r || !r.ok) continue;
+        const j = await r.json();
+        const lab = ozLabelFromInfo(j);
+        if (!lab) continue;
+        window.__OZ_SESSION_SPEND__ = lab;
+        if (typeof j.body === 'string' && j.body.trim()) window.__OZ_SPEND_BODY__ = j.body.trim();
+        ozEnsureFloatSpend();
+        return;
+      } catch (e) {}
+    }
+  })();
+}
+
 function ozWatchSpend() {
   let t = 0;
+  const inComposer = () => ozInComposer(document.activeElement);
   const run = () => {
-    const a = document.activeElement;
-    if (a && (a.tagName === 'TEXTAREA' || a.tagName === 'INPUT' || a.isContentEditable)) return;
-    try { ozCollapseSpend(); } catch (e) {}
+    try {
+      if (inComposer()) {
+        ozEnsureSpendCss();
+        ozEnsureFloatSpend();
+      } else {
+        ozCollapseSpend();
+      }
+    } catch (e) {}
   };
-  const debounced = () => { clearTimeout(t); t = setTimeout(run, 600); };
+  const debounced = () => { clearTimeout(t); t = setTimeout(run, 400); };
   if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', run);
   else run();
   try {
     const mo = new MutationObserver(debounced);
-    const start = () => { if (document.body) mo.observe(document.body, { childList: true, subtree: false }); };
+    const start = () => { if (document.body) mo.observe(document.body, { childList: true, subtree: true }); };
     if (document.body) start();
     else document.addEventListener('DOMContentLoaded', start);
   } catch (e) {}
   try { window.addEventListener('resize', debounced); } catch (e) {}
+  try { setInterval(() => { run(); ozPollSpend(); }, 2000); } catch (e) {}
+  try { ozPollSpend(); } catch (e) {}
 }
 
 export function spendChipSource() {
   return [
     '(function ozSpendChip(){',
     "'use strict';",
-    'if (window.__OZ_SPEND_CHIP__ === 12) return;',
-    'window.__OZ_SPEND_CHIP__ = 12;',
+    'if (window.__OZ_SPEND_CHIP__ === 16) return;',
+    'window.__OZ_SPEND_CHIP__ = 16;',
     chipUsd.toString(),
     labelFromSpendBody.toString(),
     spendLinesOnly.toString(),
@@ -448,15 +602,19 @@ export function spendChipSource() {
     ozSpendHost.toString(),
     ozVisibleSpendText.toString(),
     stripSpendFromText.toString(),
+    ozInComposer.toString(),
     ozBlankSpendIn.toString(),
     ozHideSpendLeftovers.toString(),
     ozPreviousMessageCard.toString(),
     ozAttachSpendChip.toString(),
     ozCollapseSpend.toString(),
+    ozFloatLabel.toString(),
     ozEnsureFloatSpend.toString(),
     ozSavedFloatPos.toString(),
     ozPlaceFloat.toString(),
     ozDragFloat.toString(),
+    ozLabelFromInfo.toString(),
+    ozPollSpend.toString(),
     ozWatchSpend.toString(),
     'ozWatchSpend();',
     '})();',

package/lib/proxy.js

@@ -9,11 +9,11 @@ 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';
-import { modelsListForRequest, isHarnessAliasId, resolveModel, quoteableRows, unopenrouter } from './models.js';
+import { modelsListForRequest, isHarnessAliasId, resolveModel, quoteableRows } from './models.js';
 
 /**
  * Quoteable catalog ids, cached 5 minutes, for the fuzzy /v1/models/<id> probe.
@@ -38,19 +38,89 @@ import { receiptUsedCogs, receiptDirectUsd, pairActualBilled } from './racesettl
 import { fetchHeaders } from './fetch.js';
 import { attachX402Proof } from './spendProof.js';
 
-/** Kill whatever is LISTEN on this port except this process. */
+/** Kill whatever is LISTEN on this port except this process.
+ *  lsof first (macOS), then fuser, then /proc (Omarchy/Arch with neither).
+ *  Every openzoo subcommand that binds :8402 goes through this. Hopping to
+ *  8403 was the second-burner bug. */
 export function killListen(port, run = execSync) {
-  try {
-    const pids = run(`lsof -nP -iTCP:${Number(port)} -sTCP:LISTEN -t`, {
-      encoding: 'utf8', timeout: 2000,
-    }).trim().split('\n').map(Number).filter((n) => Number.isInteger(n) && n > 0 && n !== process.pid);
-    for (const pid of pids) {
-      try { run(`kill ${pid}`, { stdio: 'ignore', timeout: 2000 }); } catch { /* already gone */ }
+  const n = Number(port);
+  const seen = new Set();
+  const addFrom = (out) => {
+    for (const tok of String(out || '').split(/[^\d]+/)) {
+      const pid = Number(tok);
+      if (Number.isInteger(pid) && pid > 0 && pid !== process.pid) seen.add(pid);
     }
-    return pids;
-  } catch {
-    return [];
+  };
+  const tryRun = (cmd, opts = {}) => {
+    try {
+      return run(cmd, { encoding: 'utf8', timeout: 2000, stdio: ['ignore', 'pipe', 'ignore'], ...opts });
+    } catch { return ''; }
+  };
+  addFrom(tryRun(`lsof -nP -iTCP:${n} -sTCP:LISTEN -t`));
+  addFrom(tryRun(`fuser -n tcp ${n}`));
+  if (process.platform === 'linux' && seen.size === 0) {
+    addFrom(tryRun(`python3 - ${n}`, {
+      timeout: 2500,
+      input: `import os, glob, sys
+port=int(sys.argv[1]); hx=f'{port:04X}'
+inodes=set(); pids=set()
+for path in ('/proc/net/tcp','/proc/net/tcp6'):
+    try:
+        for line in open(path):
+            p=line.split()
+            if len(p)<10: continue
+            if p[1].split(':')[-1].upper()==hx: inodes.add(p[9])
+    except FileNotFoundError:
+        pass
+for fd in glob.glob('/proc/[0-9]*/fd/[0-9]*'):
+    try: t=os.readlink(fd)
+    except OSError: continue
+    if any(ino and ino!='0' and ino in t for ino in inodes):
+        try: pids.add(int(fd.split('/')[2]))
+        except (OSError, ValueError): pass
+print('\\n'.join(str(p) for p in pids if p != os.getpid()))
+`,
+    }));
   }
+  for (const pid of seen) {
+    try { run(`kill ${pid}`, { stdio: 'ignore', timeout: 2000 }); } catch { /* already gone */ }
+    try { run(`kill -9 ${pid}`, { stdio: 'ignore', timeout: 2000 }); } catch { /* already gone */ }
+  }
+  return [...seen];
+}
+
+/** This package.json version. Same one /v1/info and /v1/session publish. */
+export function packageVersion() {
+  return JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;
+}
+
+/** True when the listener on this port is THIS openzoo version or newer.
+ *  Missing / unparseable version is stale (0.49.x answered with no version).
+ *  Older than us is stale. Newer we leave alone so we never downgrade. */
+export async function oursOn(port = config.port) {
+  const mine = packageVersion();
+  const parse = (v) => {
+    const m = String(v || '').trim().match(/^(\d+)\.(\d+)\.(\d+)/);
+    return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
+  };
+  const attachable = (theirs) => {
+    const a = parse(theirs), b = parse(mine);
+    if (!a || !b) return false;
+    for (let i = 0; i < 3; i++) {
+      if (a[i] > b[i]) return true;
+      if (a[i] < b[i]) return false;
+    }
+    return true;
+  };
+  for (const path of ['/v1/info', '/v1/session']) {
+    try {
+      const r = await fetch(`http://127.0.0.1:${Number(port)}${path}`, { signal: AbortSignal.timeout(1500) });
+      if (!r.ok) continue;
+      const j = await r.json().catch(() => ({}));
+      if (attachable(j.version)) return true;
+    } catch { /* try next */ }
+  }
+  return false;
 }
 
 // THE SHIM IS A FACILITATOR, NOT A MIDDLEBOX.
@@ -511,9 +581,17 @@ export async function startProxy({ silent = false, requireToken = null, sessionM
         const self = viaTunnel && tunnelGate?.publicUrl
           ? `${tunnelGate.publicUrl}/v1`
           : `http://localhost:${config.port}/v1`;
-        res.writeHead(200, { 'content-type': 'application/json' });
+        res.writeHead(200, {
+          'content-type': 'application/json',
+          'access-control-allow-origin': '*',
+        });
+        const { version: ozVersion } = JSON.parse(
+          readFileSync(new URL('../package.json', import.meta.url), 'utf8'),
+        );
         res.end(JSON.stringify({
           youAreTalkingTo: 'openzoo proxy',
+          version: ozVersion,
+          solana: client.address,
           yourEndpoint: self,
           reachedVia: viaTunnel ? 'public tunnel' : 'localhost',
           publicTunnel: tunnelGate?.publicUrl ? `${tunnelGate.publicUrl}/v1` : null,
@@ -618,43 +696,10 @@ export async function startProxy({ silent = false, requireToken = null, sessionM
     const isPaidPost = req.method === 'POST'
       && /\/(chat\/completions|completions|messages|responses)$/.test(rawPath);
     let wantsStream = false;
-    // RECEIPTS ARE OPT-OUT. `disableStats: true` in the body (or the
-    // x-openzoo-disable-stats header) means this caller does not want the x402
-    // block, so we neither attach our settle proof nor pass the gateway's
-    // receipt through. The field is deliberately FORWARDED, not stripped: the
-    // gateway reads it too and drops its own half. Absent/false keeps today's
-    // behaviour, because our own spend line reads that block.
-    let statsOff = false;
-    if (isPaidPost) {
-      try {
-        const b = JSON.parse(bodyBuf.toString('utf8'));
-        const h = req.headers['x-openzoo-disable-stats'];
-        const truthy = (v) => v === true || v === 'true' || v === '1' || v === 1;
-        statsOff = truthy(b?.disableStats) || truthy(Array.isArray(h) ? h[0] : h);
-      } catch { /* not JSON */ }
-    }
     if (isPaidPost) {
       servedRequests += 1;
       say(`\n<- request #${servedRequests} from ${(req.headers['user-agent'] || 'unknown').slice(0, 40)}`);
       try { wantsStream = JSON.parse(bodyBuf.toString('utf8'))?.stream === true; } catch { /* not JSON */ }
-      // UNOPENROUTER THE MODEL ID before anything downstream sees the body —
-      // the replay key, the outage gate, the wire. A vendor-prefixed
-      // OpenRouter spelling becomes the bare id the doors serve when the
-      // catalog lists it (OPENZOO_UNOPENROUTER=1 forces it, =0 disables).
-      // This is the one place the body is rewritten; see models.js.
-      try {
-        const parsed = JSON.parse(bodyBuf.toString('utf8'));
-        if (parsed && typeof parsed.model === 'string') {
-          let ids = [];
-          try { ids = await catalogIdsCached(`${config.apiBase}/v1/models`, upstreamHeaders(req)); } catch { /* catalog unreachable: only the forced mode rewrites */ }
-          const bare = unopenrouter(parsed.model, ids);
-          if (bare) {
-            say(`   model ${parsed.model} -> ${bare} (bare id: doors, not OpenRouter)`);
-            parsed.model = bare;
-            bodyBuf = Buffer.from(JSON.stringify(parsed));
-          }
-        }
-      } catch { /* not JSON */ }
     }
 
     // Retry of a body we answered seconds ago? Serve the cached completion —
@@ -825,11 +870,7 @@ export async function startProxy({ silent = false, requireToken = null, sessionM
           say(`credit -> $${x.billedUsd.toFixed(6)}  ·  session $${sessionSpent.toFixed(6)}`);
         }
         if (data?.object === 'chat.completion') {
-          if (statsOff) {
-            // The gateway already dropped its half; drop ours, and any block an
-            // older gateway in front of us still attached.
-            delete data.x402;
-          } else if (paid && receipt) {
+          if (paid && receipt) {
             attachX402Proof(data, {
               tx: receipt.tx,
               memo: receipt.memo || accept?.extra?.memo,
@@ -866,14 +907,13 @@ export async function startProxy({ silent = false, requireToken = null, sessionM
         rememberSpend();
         say(`credit -> $${x.billedUsd.toFixed(6)}  ·  session $${sessionSpent.toFixed(6)}`);
       };
-      // A 402 AFTER we attempted payment is a SETTLEMENT failure, not a quote —
-      // the client-side balance check is advisory, so a wallet that looks
-      // fundable can still fail on-chain, and the gateway answers the paid
-      // retry with a fresh 402. Relaying that raw meant Claude Code printed a
-      // 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.
+      // A 402 AFTER we attempted payment is a SETTLEMENT failure, not a quote.
+      // The client-side balance check is advisory, so a funded wallet can still
+      // fail on-chain / at the facilitator, and the gateway answers the paid
+      // retry with a fresh 402. Relaying that as "wallet underfunded" + Whop
+      // copy-paste blamed burners that already paid. Surface the gateway's
+      // real reason; only prepend fund-me copy on genuine insufficient_funds.
       if (response.status === 402) {
-        let quoted = '';
         let usd;
         let q402 = null;
         try { q402 = await response.clone().json(); } catch { q402 = null; }
@@ -890,18 +930,21 @@ 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);
+        // paid:true → never "wallet underfunded", never Whop unless the
+        // gateway itself named insufficient_funds. UnderfundedError (empty
+        // wallet preflight) is handled in the catch below.
+        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);
@@ -934,11 +977,18 @@ export async function startProxy({ silent = false, requireToken = null, sessionM
   // OPENZOO_BIND=0.0.0.0 AND a tunnel token, so that port stays gated exactly
   // like the public tunnel path.
   const bindHost = process.env.OPENZOO_BIND || '127.0.0.1';
-  // SELF-HEAL A TAKEN PORT. Walk up to the next free port instead of dying;
-  // the caller reads config.port back out, so every URL printed afterwards is
-  // the one we actually bound. A healthy proxy already on the port is KILLED
-  // — reusing it left a stale PayClient serving $0 after a TOKEN top-up.
-  const wanted = config.port;
+  // SELF-HEAL :8402. Kill whoever is on THIS port, then bind it. Never hop to
+  // 8403 — that was the second-burner. Every subcommand that calls startProxy
+  // (openzoo, claude, bot, web, cursor, aoe, grok, tunnel) goes through here.
+  // Reusing a leftover listener left a stale PayClient serving $0 after a
+  // TOKEN top-up, and an old npx cache answering /v1 with no version.
+  {
+    const pids = killListen(config.port);
+    if (pids.length) {
+      say(`openzoo: killed proxy on :${config.port} (pids ${pids.join(',')})`);
+      await new Promise((r) => setTimeout(r, 400));
+    }
+  }
   for (let attempt = 0; ; attempt++) {
     try {
       await new Promise((resolve, reject) => {
@@ -948,20 +998,12 @@ export async function startProxy({ silent = false, requireToken = null, sessionM
       });
       break;
     } catch (e) {
-      if (e?.code !== 'EADDRINUSE' || attempt >= 12) throw e;
-      if (attempt === 0) {
-        const pids = killListen(config.port);
-        if (pids.length) {
-          say(`openzoo: killed proxy on :${config.port} (pids ${pids.join(',')})`);
-          await new Promise((r) => setTimeout(r, 400));
-          continue;
-        }
-      }
-      config.port += 1;
-      say(`openzoo: :${config.port - 1} busy — trying :${config.port}`);
+      if (e?.code !== 'EADDRINUSE' || attempt >= 8) throw e;
+      const pids = killListen(config.port);
+      if (pids.length) say(`openzoo: killed proxy on :${config.port} (pids ${pids.join(',')})`);
+      await new Promise((r) => setTimeout(r, 300));
     }
   }
-  if (config.port !== wanted) say(`openzoo: listening on :${config.port} (:${wanted} was busy)`);
 
   // AUTO-PREPAY. Paying on-chain per call is where the latency lives: credit
   // is applied automatically server-side whenever a balance covers the quote,

package/lib/setup.js

@@ -214,7 +214,7 @@ async function printStartupDiagnostic(base, which) {
 
   console.log('openzoo diagnostic');
   console.log(`  version    : ${version}   node ${process.version}   ${process.platform}/${process.arch}`);
-  console.log(`  port ${config.port}  : ${portBusy ? 'ALREADY SERVING (an older proxy may still be running — kill it if this build is newer)' : 'free'}`);
+  console.log(`  port ${config.port}  : ${portBusy ? 'occupied (steal unless this exact version)' : 'free'}`);
   console.log(`  editor     : ${picked ? `${picked.which} @ ${picked.cmd}` : 'NONE FOUND'}`);
   console.log(`  running    : ${picked ? (q(() => editorRunning(picked.which), false) ? 'yes — will be quit so settings stick' : 'no') : '-'}`);
   console.log(`  backend    : ${hosts}`);
@@ -245,9 +245,17 @@ export async function setupEditor(which, target) {
   // Declared out here: the tunnel-rebind hook is registered further down, well
   // outside the block that starts the proxy.
   let started = null;
-  if (!(await proxyUp(base))) {
-    console.log(`starting proxy on ${base} (+ public tunnel)...`);
-    const { startProxy } = await import('./proxy.js');
+  const { startProxy, oursOn, packageVersion } = await import('./proxy.js');
+  if (await oursOn(config.port)) {
+    console.log(`proxy v${packageVersion()} already on ${base} — keeping it`);
+    try {
+      const info = await (await fetch(`${base}/info`)).json();
+      publicUrl = (info?.publicTunnel || '').replace(/\/v1$/, '') || null;
+      tunnelKey = info?.tunnelToken ?? tunnelKey;
+      if (publicUrl) console.log(`tunnel:  ${publicUrl}/v1 (from the running proxy)`);
+    } catch { /* no /info */ }
+  } else {
+    console.log(`${(await proxyUp(base)) ? 'stale proxy — stealing' : 'starting proxy on'} ${base} (+ public tunnel)...`);
     started = await startProxy({ silent: true, autoTunnel: true });
     publicUrl = started?.publicUrl ?? null;
     tunnelKey = started?.tunnelToken ?? null;
@@ -298,15 +306,6 @@ export async function setupEditor(which, target) {
       console.log('         most common cause here: no working IPv6 route (we already force');
       console.log('         --edge-ip-version 4). check: npx openzoo tunnel   for the raw log.');
     }
-  } else {
-    console.log(`proxy already running on ${base}`);
-    // A proxy someone else started owns the tunnel; ask it for the public URL.
-    try {
-      const info = await (await fetch(`${base}/info`)).json();
-      publicUrl = (info?.publicTunnel || '').replace(/\/v1$/, '') || null;
-      tunnelKey = info?.tunnelToken ?? tunnelKey;
-      if (publicUrl) console.log(`tunnel:  ${publicUrl}/v1 (from the running proxy)`);
-    } catch { /* no /info — fall through to the localhost warning below */ }
   }
   // What the EDITOR is configured with. Localhost only as a last resort, and
   // said out loud, because it will fail with the private-networks error.

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,6 +1,6 @@
 {
   "name": "openzoo",
-  "version": "0.50.94",
+  "version": "0.50.96",
   "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.",
   "license": "MIT",
   "type": "module",

package/lib/websearch.js

@@ -1,31 +0,0 @@
-// 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')}`;
-}