openzoo 0.51.11 → 0.51.13

package/launcher/savings-preload.cjs

@@ -1,5 +1,11 @@
 const { contextBridge, ipcRenderer } = require('electron');
 contextBridge.exposeInMainWorld('savings', {
   listen: fn => ipcRenderer.on('savings', (_event, value) => fn(value)),
+  deposit: () => ipcRenderer.send("open-deposit"),
+  back: () => ipcRenderer.send("close-deposit"),
+  copy: chain => ipcRenderer.send("copy-deposit", chain),
+  card: () => ipcRenderer.send("deposit-card"),
+  wallet: fn => ipcRenderer.on("deposit-wallet", (_event, value) => fn(value)),
+  copied: fn => ipcRenderer.on("deposit-copied", (_event, value) => fn(value)),
   close: () => ipcRenderer.send('close-savings'),
 });

package/launcher/savings-renderer.js

@@ -1,9 +1,52 @@
+let onboarding = false;
+try { onboarding = localStorage.getItem('openzoo-onboarded-v1') !== 'yes'; } catch {}
+const finishOnboarding = () => {
+  try { localStorage.setItem('openzoo-onboarded-v1','yes'); } catch {}
+  onboarding=false;
+  document.getElementById('welcome').hidden=true;
+  document.getElementById('totals').hidden=false;
+  document.getElementById('later').hidden=true;
+  document.getElementById('funding').hidden=true;
+  window.savings.back();
+};
 const usd = n => typeof n === 'number' && Number.isFinite(n) ? '$' + Math.abs(n).toFixed(Math.abs(n) < .01 && n !== 0 ? 4 : 2) : '—';
 window.savings.listen(d => {
+  if (onboarding) {
+    const funded=d.online && ((d.walletUsd || 0)+(d.creditUsd || 0)>0);
+    document.getElementById("back").textContent=funded ? "Ready — start chatting" : "Waiting for funds…";
+    document.getElementById("back").disabled=!funded;
+  }
   for (const [id, value] of [['wallet',d.walletUsd],['credit',d.creditUsd],['spent',d.billing?.calls > 0 ? d.billing.chargedUsd : null],['direct',d.comparison?.calls > 0 ? d.comparison.directUsd : null]]) document.getElementById(id).textContent=usd(value);
   const saved=d.comparison?.calls > 0 ? d.comparison.directUsd-d.comparison.spentUsd : null;
-  document.getElementById('saved').textContent=usd(saved);
+  const pct=d.comparison?.directUsd > 0 && saved !== null ? Math.abs(saved)/d.comparison.directUsd*100 : null;
+  document.getElementById('saved').textContent=usd(saved)+(pct===null?'':` (${pct.toFixed(1)}%)`);
   document.getElementById('saving-label').textContent=saved!==null && saved<0 ? 'Extra cost' : 'Saved';
   document.getElementById('state').textContent=d.online ? (d.billing?.calls > 0 ? 'Final charges · saved receipts' : 'Waiting for final billing · balance is live') : 'Reconnecting · showing last known amounts';
 });
 document.getElementById('close').addEventListener('click',()=>window.savings.close());
+
+document.getElementById('deposit').addEventListener('click', () => {
+  document.getElementById('funding').hidden=false;
+  if (!onboarding) { document.getElementById('back').disabled=false; document.getElementById('back').textContent='Back to savings'; }
+  window.savings.deposit();
+});
+window.savings.wallet(d => {
+  document.getElementById('fund-status').textContent=d.error || 'Fund this wallet. Click an address to copy it.';
+  for (const chain of ['solana','evm']) {
+    document.getElementById(chain+'-address').textContent=d[chain] || '';
+    document.getElementById('copy-'+chain).disabled=!d[chain];
+  }
+});
+for (const chain of ['solana','evm']) document.getElementById('copy-'+chain).addEventListener('click',()=>window.savings.copy(chain));
+window.savings.copied(chain => { document.getElementById('fund-status').textContent=(chain==='solana'?'Solana':'Base')+' address copied.'; });
+document.getElementById('card').addEventListener('click',()=>window.savings.card());
+document.getElementById('back').addEventListener('click',finishOnboarding);
+document.getElementById('later').addEventListener('click',finishOnboarding);
+if (onboarding) {
+  document.getElementById('welcome').hidden=false;
+  document.getElementById('totals').hidden=true;
+  document.getElementById('later').hidden=false;
+  document.getElementById('funding').hidden=false;
+  if (!onboarding) { document.getElementById('back').disabled=false; document.getElementById('back').textContent='Back to savings'; }
+  window.savings.deposit();
+}

package/launcher/savings.cjs

@@ -1,4 +1,4 @@
-const { BrowserWindow, screen, ipcMain } = require('electron');
+const { BrowserWindow, screen, ipcMain, clipboard, shell } = require('electron');
 const path = require('node:path');
 let pill;
 function showSavings(port = Number(process.env.OPENZOO_SAVINGS_PORT) || 8402) {
@@ -13,7 +13,32 @@ function showSavings(port = Number(process.env.OPENZOO_SAVINGS_PORT) || 8402) {
   pill.webContents.on('will-navigate', e => e.preventDefault());
   pill.loadFile(path.join(__dirname, 'savings.html'));
   const window = pill;
-  let busy = false, last = null;
+  let busy = false, last = null, wallet = null;
+  const resize = height => {
+    const b = window.getBounds(), area = screen.getDisplayMatching(b).workArea;
+    window.setBounds({ ...b, height: Math.min(height, area.height), y: Math.max(area.y, Math.min(b.y, area.y + area.height - height)) });
+  };
+  const deposit = async event => {
+    if (event.sender !== window.webContents) return;
+    resize(620);
+    try {
+      const r = await fetch(`http://127.0.0.1:${port}/v1/wallet`, { signal: AbortSignal.timeout(5000) });
+      if (!r.ok) throw Error("Unavailable");
+      wallet = await r.json();
+      if (!window.isDestroyed()) window.webContents.send("deposit-wallet", { solana: wallet.solana, evm: wallet.evm });
+    } catch { if (!window.isDestroyed()) window.webContents.send("deposit-wallet", { error: "Couldn’t load your wallet. Try again." }); }
+  };
+  const copy = (event, chain) => {
+    if (event.sender !== window.webContents || !["solana", "evm"].includes(chain) || !wallet?.[chain]) return;
+    clipboard.writeText(wallet[chain]);
+    window.webContents.send("deposit-copied", chain);
+  };
+  const card = event => { if (event.sender === window.webContents) shell.openExternal("https://whop.com/staccoverflow/openzoo"); };
+  const back = event => { if (event.sender === window.webContents) resize(270); };
+  ipcMain.on("open-deposit", deposit);
+  ipcMain.on("copy-deposit", copy);
+  ipcMain.on("deposit-card", card);
+  ipcMain.on("close-deposit", back);
   const poll = async () => {
     if (busy || window.isDestroyed()) return;
     busy = true;
@@ -35,7 +60,7 @@ function showSavings(port = Number(process.env.OPENZOO_SAVINGS_PORT) || 8402) {
   const timer = setInterval(poll, 3000);
   const close = event => { if (event.sender === window.webContents) window.close(); };
   ipcMain.on('close-savings', close);
-  window.on('closed', () => { clearInterval(timer); ipcMain.removeListener('close-savings', close); if (pill === window) pill = null; });
+  window.on('closed', () => { clearInterval(timer); for (const [name, fn] of [["open-deposit",deposit],["copy-deposit",copy],["deposit-card",card],["close-deposit",back]]) ipcMain.removeListener(name,fn); ipcMain.removeListener('close-savings', close); if (pill === window) pill = null; });
   return pill;
 }
 module.exports = { showSavings };

package/launcher/savings.html

@@ -1,3 +1,3 @@
 <!doctype html><html><head><meta charset="utf-8"><meta http-equiv="Content-Security-Policy" content="default-src 'none'; style-src 'unsafe-inline'; script-src 'self'"><title>OpenZoo savings</title><style>
-*{box-sizing:border-box}body{margin:0;padding:8px;background:transparent;font:13px system-ui;color:#fff}.pill{border-radius:20px;background:#18181bf5;border:1px solid #ffffff25;overflow:hidden;box-shadow:0 4px 14px #0004}header{background:#e85d1c;padding:12px 16px;font-weight:650;-webkit-app-region:drag;display:flex;justify-content:space-between;align-items:center}button{-webkit-app-region:no-drag;border:0;background:none;color:inherit;font:18px system-ui;cursor:pointer;padding:0 5px}main{padding:12px 16px}dl{display:grid;grid-template-columns:1fr auto;margin:0;gap:7px}dd{margin:0;font-variant-numeric:tabular-nums}small{color:#bbb;display:block;margin-top:12px;font-size:11px}#state{color:#d8ff76}
-</style></head><body><div class="pill"><header><span>OpenZoo · costs & savings</span><button id="close" aria-label="Close savings pill">×</button></header><main><dl><dt>Wallet balance</dt><dd id="wallet">—</dd><dt>Prepaid credit</dt><dd id="credit">—</dd><dt>Charged · verified calls</dt><dd id="spent">—</dd><dt>Direct cost · verified calls</dt><dd id="direct">—</dd><dt id="saving-label">Saved</dt><dd id="saved">—</dd></dl><small id="state" role="status">Checking your balance…</small><small>Savings cover matching verified calls only. Drag the orange bar to move.</small></main></div><script src="savings-renderer.js"></script></body></html>
+*{box-sizing:border-box}body{max-height:100vh;overflow-y:auto;margin:0;padding:8px;background:transparent;font:13px system-ui;color:#fff}.pill{border-radius:20px;background:#18181bf5;border:1px solid #ffffff25;overflow:hidden;box-shadow:0 4px 14px #0004}header{background:#e85d1c;padding:12px 16px;font-weight:650;-webkit-app-region:drag;display:flex;justify-content:space-between;align-items:center}button{-webkit-app-region:no-drag;border:0;background:none;color:inherit;font:18px system-ui;cursor:pointer;padding:0 5px}main{padding:12px 16px}dl{display:grid;grid-template-columns:1fr auto;margin:0;gap:7px}dd{margin:0;font-variant-numeric:tabular-nums}small{color:#bbb;display:block;margin-top:12px;font-size:11px}#state{color:#d8ff76}.actions{display:flex;align-items:center;gap:8px}#deposit,.fund-button{font-size:12px;border:1px solid #ffffff60;border-radius:7px;padding:5px 10px}.fund-button{display:block;width:100%;text-align:left;margin:9px 0;overflow-wrap:anywhere;line-height:1.5}.fund-button span{display:block;font-size:11px;color:#ccc;user-select:text}[hidden]{display:none!important}#welcome p{font-size:12px;line-height:1.5;color:#ccc}#funding{border-top:1px solid #ffffff25;margin-top:12px}#funding p{font-size:12px;color:#ccc}
+</style></head><body><div class="pill"><header><span>OpenZoo · costs & savings</span><div class="actions"><button id="deposit">Deposit</button><button id="close" aria-label="Close savings pill">×</button></div></header><main><section id="welcome" hidden><h3>Welcome to OpenZoo</h3><p>Pay per request from your OpenZoo wallet. Add funds before your first chat.</p><p>1. Choose card or crypto below.<br>2. Add funds to this wallet.<br>3. Once your balance appears, start chatting.</p></section><div id="totals"><dl><dt>Wallet balance</dt><dd id="wallet">—</dd><dt>Prepaid credit</dt><dd id="credit">—</dd><dt>Charged · verified calls</dt><dd id="spent">—</dd><dt>Direct cost · verified calls</dt><dd id="direct">—</dd><dt id="saving-label">Saved</dt><dd id="saved">—</dd></dl><small id="state" role="status">Checking your balance…</small><small>Savings cover matching verified calls only. Drag the orange bar to move.</small></div><section id="funding" hidden><h3>Add funds</h3><p id="fund-status" role="status">Loading your wallet…</p><button class="fund-button" id="copy-solana" disabled>Solana · USDC / TOKEN / LEOS<span id="solana-address"></span><span>Click to copy address</span></button><button class="fund-button" id="copy-evm" disabled>Base · USDC<span id="evm-address"></span><span>Click to copy address</span></button><button class="fund-button" id="card">Pay by card · Whop ↗</button><p>At checkout, paste your Solana address to link the purchase to this wallet. Your balance updates automatically after confirmation.</p><button class="fund-button" id="back">Back to savings</button><button class="fund-button" id="later" hidden>Set up later</button></section></main></div><script src="savings-renderer.js"></script></body></html>

package/lib/billing.js

@@ -24,7 +24,7 @@ export function billingObserver(onReceipt) {
         else if (line.startsWith('data:')) {
           const event = JSON.parse(line.slice(5).trim());
           const value = event.response || event;
-          if (value.usage || value.x402) onReceipt({ ...value.x402, usage: value.usage, _completedResponse: event.type === 'response.completed' || value.status === 'completed' });
+          if (value.usage || value.x402) onReceipt({ ...value.x402, usage: value.usage, _responseId: value.id, _completedResponse: event.type === 'response.completed' || value.status === 'completed' });
         }
       } catch { /* Not a billing event. */ }
     }

package/lib/proxy.js

@@ -1,3 +1,4 @@
+import { receiptLedger } from './receipt-ledger.js';
 import { billingObserver, finalBilling } from './billing.js';
 import { liveBalance } from './funding-status.js';
 import { paymentError } from './payment-error.js';
@@ -35,7 +36,7 @@ async function catalogIdsCached(modelsUrl, headers) {
   return ids;
 }
 import { withNamespace } from './namespace.js';
-import { loadSessionSpend, saveSessionSpend } from './session.js';
+import { loadSessionSpend, saveSessionSpend, sessionSpendFile } from './session.js';
 import { creditBalance, quotedPrices } from './info.js';
 import { priceHoldings } from './livestatus.js';
 import { receiptUsedCogs, receiptDirectUsd, pairActualBilled } from './racesettle.js';
@@ -426,6 +427,12 @@ export async function startProxy({ silent = false, requireToken = null, sessionM
   let sessionDirect = restored.directUsd;
   let comparedSpent = restored.comparison?.spentUsd ?? 0, comparedDirect = restored.comparison?.directUsd ?? 0, comparedCalls = restored.comparison?.calls ?? 0;
   let verifiedCharged = restored.billing?.chargedUsd ?? 0, verifiedCalls = restored.billing?.calls ?? 0;
+  const ledger = receiptLedger(sessionSpendFile() + '.receipts.json', { billing: restored.billing, comparison: restored.comparison });
+  const applyLedger = ({billing, comparison}) => {
+    verifiedCharged = billing.chargedUsd; verifiedCalls = billing.calls;
+    comparedSpent = comparison.spentUsd; comparedDirect = comparison.directUsd; comparedCalls = comparison.calls;
+  };
+  applyLedger(ledger.totals());
   const rememberSpend = () => {
     saveSessionSpend({ spentUsd: sessionSpent, cogsUsd: sessionCogs, directUsd: sessionDirect, paidCalls, billing: { chargedUsd: verifiedCharged, calls: verifiedCalls }, comparison: { spentUsd: comparedSpent, directUsd: comparedDirect, calls: comparedCalls } });
   };
@@ -964,6 +971,7 @@ export async function startProxy({ silent = false, requireToken = null, sessionM
         }
         scheduleRefresh(4000); // settlement lands on-chain in a few seconds
       }
+      const requestReceiptId = crypto.randomUUID();
       let accounted = paid && receipt?.ok && typeof receipt.billedUsd === 'number' ? receipt.billedUsd : 0;
       let counted = paid && receipt?.ok && typeof receipt.billedUsd === 'number';
       let finalX = {}, finalUsage = {}, comparison = null, actualPair = null, verified = null;
@@ -989,6 +997,7 @@ export async function startProxy({ silent = false, requireToken = null, sessionM
         if (actualPair) { sessionActual -= actualPair.upstream; billedWithActual -= actualPair.charged; actualCalls--; }
         actualPair = final.upstream === null ? null : final;
         if (actualPair) { sessionActual += final.upstream; billedWithActual += final.charged; actualCalls++; }
+        applyLedger(ledger.record(finalX.settle?.transaction || finalX._responseId || receipt?.tx || requestReceiptId, final));
         rememberSpend();
         log(`final billing: charged $${final.charged.toFixed(6)} · upstream ${final.upstream === null ? 'unreported' : '$' + final.upstream.toFixed(6)} · direct ${final.direct === null ? 'unreported' : '$' + final.direct.toFixed(6)}`);
       };
@@ -996,7 +1005,7 @@ export async function startProxy({ silent = false, requireToken = null, sessionM
       if (isPaidPost && response.ok && upCt.includes('application/json')) {
         let data = null;
         try { data = await response.clone().json(); } catch { /* not JSON after all */ }
-        meterFinal({ ...data?.x402, usage: data?.usage, _completedResponse: response.ok });
+        meterFinal({ ...data?.x402, usage: data?.usage, _responseId: data?.id, _completedResponse: response.ok });
         if (data?.object === 'chat.completion') {
           if (statsOff) {
             // The gateway already dropped its half; drop ours, and any block an

package/lib/receipt-ledger.js

@@ -0,0 +1,22 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export function receiptLedger(file, base = {}) {
+  let state = { base, receipts: {} };
+  try { const saved=JSON.parse(fs.readFileSync(file,'utf8')); if(saved.receipts && saved.base)state=saved; } catch {}
+  const totals = () => {
+    const billing={chargedUsd:state.base.billing?.chargedUsd || 0,calls:state.base.billing?.calls || 0};
+    const comparison={spentUsd:state.base.comparison?.spentUsd || 0,directUsd:state.base.comparison?.directUsd || 0,calls:state.base.comparison?.calls || 0};
+    for(const r of Object.values(state.receipts)) {
+      billing.chargedUsd+=r.charged;billing.calls++;
+      if(r.direct!==null){comparison.spentUsd+=r.charged;comparison.directUsd+=r.direct;comparison.calls++;}
+    }
+    return {billing,comparison};
+  };
+  return { totals, record(id, receipt) {
+    if(!id || typeof receipt.charged!=='number' || !Number.isFinite(receipt.charged) || receipt.charged<0) return totals();
+    state.receipts[id]={charged:receipt.charged,direct:typeof receipt.direct==='number'&&Number.isFinite(receipt.direct)&&receipt.direct>=0?receipt.direct:null};
+    fs.mkdirSync(path.dirname(file),{recursive:true});
+    const tmp=file+'.tmp';fs.writeFileSync(tmp,JSON.stringify(state),{mode:0o600});fs.renameSync(tmp,file);
+    return totals();
+  }};
+}

package/package.json

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