openzoo 0.51.10 → 0.51.12

package/launcher/savings-renderer.js

@@ -2,8 +2,9 @@ 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 · since connection started' : 'Waiting for final billing · balance is live') : 'Reconnecting · showing last known amounts';
+  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());

package/lib/billing.js

@@ -2,10 +2,13 @@ const money = n => typeof n === 'number' && Number.isFinite(n) && n >= 0 ? n : n
 
 // Only final, explicitly reported charges. Never substitute upstream cost or a quote.
 export function finalBilling(x = {}, usage = {}) {
+  const receipt = x._completedResponse === true || x.settle?.success === true;
   const charged = [usage.billedUsd, x.billedActualUsd, x.settledBilledUsd, x.chargedUsd,
-    x.settledUsd, usage.cost_details?.upstream_inference_cost != null ? usage.cost : null].map(money).find(n => n !== null) ?? null;
-  const direct = x.pricing === 'counterfactual' ? money(x.directUsd) : null;
-  return { charged, direct, upstream: money(usage.cost_details?.upstream_inference_cost) };
+    x.settledUsd, receipt ? x.billedUsd : null,
+    usage.cost_details?.upstream_inference_cost != null ? usage.cost : null].map(money).find(n => n !== null) ?? null;
+  const direct = receipt ? money(x.directUsd) : null;
+  const upstream = money(usage.cost_details?.upstream_inference_cost) ?? (receipt ? money(x.actualUsd) : null);
+  return { charged, direct, upstream };
 }
 
 // Observe billing without retaining prompts, output text, or changing the stream.
@@ -21,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 });
+          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';
@@ -424,10 +425,16 @@ export async function startProxy({ silent = false, requireToken = null, sessionM
   let lastQuoteUsd = null;
   let sessionCogs = restored.cogsUsd;
   let sessionDirect = restored.directUsd;
-  let comparedSpent = 0, comparedDirect = 0, comparedCalls = 0;
-  let verifiedCharged = 0, verifiedCalls = 0;
+  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 });
+    saveSessionSpend({ spentUsd: sessionSpent, cogsUsd: sessionCogs, directUsd: sessionDirect, paidCalls, billing: { chargedUsd: verifiedCharged, calls: verifiedCalls }, comparison: { spentUsd: comparedSpent, directUsd: comparedDirect, calls: comparedCalls } });
   };
   if (restored.ok && (sessionSpent > 0 || paidCalls > 0)) {
     say(`session restored: $${sessionSpent.toFixed(6)} · ${paidCalls} paid call${paidCalls === 1 ? '' : 's'}`);
@@ -656,7 +663,7 @@ export async function startProxy({ silent = false, requireToken = null, sessionM
           creditUsd,
           // WHAT THE SAME CALLS WOULD HAVE COST DIRECT. Spend on its own is a
           // bill; spend beside the counterfactual is the product.
-          billing: { chargedUsd: verifiedCharged, calls: verifiedCalls, scope: "verified calls since proxy startup" },
+          billing: { chargedUsd: verifiedCharged, calls: verifiedCalls, scope: "saved verified receipts" },
           comparison: { spentUsd: comparedSpent, directUsd: comparedDirect, calls: comparedCalls },
           directUsd: sessionDirect,
           savedUsd: Math.max(0, sessionDirect - sessionSpent),
@@ -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 });
+        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/lib/session.js

@@ -30,6 +30,8 @@ export function loadSessionSpend(file = sessionSpendFile()) {
   try { data = JSON.parse(raw); }
   catch { return { ...EMPTY, ok: false, reason: 'corrupt' }; }
   return {
+    ...(data.billing ? { billing: { chargedUsd: num(data.billing.chargedUsd), calls: Math.floor(num(data.billing.calls)) } } : {}),
+    ...(data.comparison ? { comparison: { spentUsd: num(data.comparison.spentUsd), directUsd: num(data.comparison.directUsd), calls: Math.floor(num(data.comparison.calls)) } } : {}),
     spentUsd: num(data.spentUsd),
     cogsUsd: num(data.cogsUsd),
     directUsd: num(data.directUsd),
@@ -40,6 +42,8 @@ export function loadSessionSpend(file = sessionSpendFile()) {
 
 export function saveSessionSpend(stats, file = sessionSpendFile()) {
   const payload = {
+    ...(stats?.billing ? { billing: { chargedUsd: num(stats.billing.chargedUsd), calls: Math.floor(num(stats.billing.calls)) } } : {}),
+    ...(stats?.comparison ? { comparison: { spentUsd: num(stats.comparison.spentUsd), directUsd: num(stats.comparison.directUsd), calls: Math.floor(num(stats.comparison.calls)) } } : {}),
     spentUsd: num(stats?.spentUsd),
     cogsUsd: num(stats?.cogsUsd),
     directUsd: num(stats?.directUsd),

package/package.json

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