openzoo 0.51.11 → 0.51.12

package/launcher/savings-renderer.js

@@ -2,7 +2,8 @@ const usd = n => typeof n === 'number' && Number.isFinite(n) ? '$' + Math.abs(n)
 window.savings.listen(d => {
   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';
 });

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.12",
   "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",