openzoo 0.51.8 → 0.51.9

package/launcher/README.md

@@ -0,0 +1,7 @@
+# OpenZoo Launcher
+
+One installer for ChatGPT. Setup starts automatically when you open the launcher, with a floating savings window showing wallet balance, spend, and savings. Node and npm are bundled; no global runtime or terminal is required. The launcher checks npm's stable `openzoo` release on each launch, installs newer versions into its per-user application data directory, and falls back to the bundled or last successfully installed CLI when offline. It never downgrades. The selected CLI downloads the current chat app if missing and preserves existing installations.
+
+Build natively with `npm ci`, `npm run prepare:bundle`, then `npm run dist`. Preparation resolves current Node LTS from nodejs.org, checks the archive SHA-256, and bundles this checkout's OpenZoo package. Push a `launcher-v1.0.0` style tag to publish six native installers through Actions; manual dispatch builds downloadable workflow artifacts without publishing a release. macOS uses existing Apple signing/notarization secrets. Windows currently ships unsigned.
+
+Downloaded CLI updates execute as the current user, just like installing OpenZoo from npm. Updates are staged and promoted after a CLI smoke check. Launcher/Electron updates require downloading a newer installer. Configuration, wallets, downloaded apps and background proxy processes belong to OpenZoo and survive closing/uninstalling the launcher.

package/launcher/main.cjs

@@ -0,0 +1,34 @@
+const { app, BrowserWindow, ipcMain } = require('electron');
+const path = require('node:path');
+const { resolveCLI, run } = require('./runtime.cjs');
+const { showSavings } = require('./savings.cjs');
+let window, busy = false;
+if (!app.requestSingleInstanceLock({ savingsReady: process.env.OPENZOO_SAVINGS_READY })) app.quit();
+else {
+  app.on('second-instance', (_event, argv, _cwd, data) => { if (argv.includes('--savings-only')) {
+    const pill = showSavings();
+    const ready = () => { if (data?.savingsReady) { try { require('node:fs').writeFileSync(data.savingsReady, 'ready'); } catch {} } };
+    if (pill.webContents.isLoading()) pill.webContents.once('did-finish-load', ready); else ready();
+  } else { window?.show(); window?.focus(); } });
+  app.whenReady().then(() => {
+    if (process.argv.includes('--savings-only')) { showSavings(); return; }
+    window = new BrowserWindow({ width: 740, height: 660, backgroundColor: '#101110', webPreferences: { preload: path.join(__dirname, 'preload.cjs'), contextIsolation: true, nodeIntegration: false, sandbox: true } });
+    window.webContents.setWindowOpenHandler(() => ({ action: 'deny' }));
+    window.webContents.on('will-navigate', event => event.preventDefault());
+    window.loadFile(path.join(__dirname, 'index.html'));
+    ipcMain.handle('launch', async (event, command) => {
+      if (event.sender !== window.webContents || command !== 'chatgpt' || busy) throw new Error('Launch unavailable');
+      busy = true;
+      const log = message => { if (!window.isDestroyed()) window.webContents.send('log', message); };
+      try {
+        const bundle = app.isPackaged ? path.join(process.resourcesPath, 'bundle') : path.join(__dirname, 'bundle');
+        const { node, cli } = await resolveCLI(bundle, app.getPath('userData'), log);
+        showSavings();
+        await run(node, [cli, 'chatgpt', '--no-pill'], log);
+        log('\nLaunched. You can close this window.\n');
+      } catch (e) { log(`\n${e.message}\n`); throw e; }
+      finally { busy = false; }
+    });
+  });
+  app.on('window-all-closed', () => app.quit());
+}

package/launcher/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "openzoo-launcher",
+  "version": "1.1.0",
+  "private": true,
+  "main": "main.cjs",
+  "scripts": {
+    "prepare:bundle": "node prepare.mjs",
+    "dist": "electron-builder",
+    "test": "node --test test.cjs"
+  },
+  "devDependencies": {
+    "electron": "44.3.0",
+    "electron-builder": "26.15.3"
+  },
+  "build": {
+    "appId": "fun.openzoo.launcher",
+    "productName": "OpenZoo Launcher",
+    "files": [
+      "main.cjs",
+      "runtime.cjs",
+      "preload.cjs",
+      "index.html",
+      "savings.cjs",
+      "savings-preload.cjs",
+      "savings.html",
+      "savings-renderer.js"
+    ],
+    "extraResources": [
+      {
+        "from": "bundle",
+        "to": "bundle"
+      },
+      {
+        "from": "openzoo-overlay.json",
+        "to": "openzoo-overlay.json"
+      }
+    ],
+    "artifactName": "OpenZoo-Launcher-${version}-${os}-${arch}.${ext}",
+    "mac": {
+      "target": "dmg",
+      "hardenedRuntime": true
+    },
+    "win": {
+      "target": "nsis"
+    },
+    "nsis": {
+      "oneClick": false,
+      "perMachine": false,
+      "allowToChangeInstallationDirectory": true
+    },
+    "linux": {
+      "target": "AppImage",
+      "category": "Network"
+    }
+  }
+}

package/launcher/runtime.cjs

@@ -0,0 +1,59 @@
+const path = require('node:path');
+const fs = require('node:fs/promises');
+const { spawn } = require('node:child_process');
+const stable = v => /^\d+\.\d+\.\d+$/.test(v);
+const newer = (a, b) => {
+  if (!stable(a) || !stable(b)) return false;
+  const aa = a.split('.').map(Number), bb = b.split('.').map(Number);
+  for (let i = 0; i < 3; i++) if (aa[i] !== bb[i]) return aa[i] > bb[i];
+  return false;
+};
+function environment(node) {
+  const env = { ...process.env, PATH: `${path.dirname(node)}${path.delimiter}${process.env.PATH || ''}` };
+  delete env.ELECTRON_RUN_AS_NODE;
+  delete env.NODE_OPTIONS;
+  return env;
+}
+function run(node, args, log, timeout = 600000) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(node, args, { env: environment(node), windowsHide: true });
+    const timer = setTimeout(() => { child.kill(); reject(new Error('Operation timed out. Please try again.')); }, timeout);
+    child.stdout.on('data', b => log(b.toString()));
+    child.stderr.on('data', b => log(b.toString()));
+    child.on('error', e => { clearTimeout(timer); reject(e); });
+    child.on('exit', code => { clearTimeout(timer); code === 0 ? resolve() : reject(new Error(`OpenZoo exited with code ${code}`)); });
+  });
+}
+async function resolveCLI(bundle, userData, log) {
+  const node = path.join(bundle, 'runtime', process.platform === 'win32' ? 'node.exe' : 'bin/node');
+  const npm = path.join(bundle, 'runtime', process.platform === 'win32' ? 'node_modules/npm/bin/npm-cli.js' : 'lib/node_modules/npm/bin/npm-cli.js');
+  const pkg = dir => path.join(dir, 'node_modules/openzoo');
+  let selected = path.join(bundle, 'sidecar');
+  let version = JSON.parse(await fs.readFile(path.join(pkg(selected), 'package.json'), 'utf8')).version;
+  const updates = path.join(userData, 'versions');
+  await fs.mkdir(updates, { recursive: true });
+  for (const v of await fs.readdir(updates)) {
+    if (newer(v, version)) {
+      try { if (JSON.parse(await fs.readFile(path.join(pkg(path.join(updates, v)), 'package.json'), 'utf8')).version === v) { selected = path.join(updates, v); version = v; } } catch {}
+    }
+  }
+  try {
+    log('Checking for the latest OpenZoo…\n');
+    const response = await fetch('https://registry.npmjs.org/openzoo/latest', { signal: AbortSignal.timeout(10000) });
+    if (!response.ok) throw new Error(`Registry returned ${response.status}`);
+    const latest = (await response.json()).version;
+    if (newer(latest, version)) {
+      const stage = await fs.mkdtemp(path.join(updates, '.install-'));
+      try {
+        await run(node, [npm, 'install', '--prefix', stage, '--registry=https://registry.npmjs.org', '--omit=dev', '--no-audit', '--no-fund', `openzoo@${latest}`], log);
+        await run(node, [path.join(stage, 'node_modules/dugite/script/download-git.js')], log);
+        await run(node, [path.join(pkg(stage), 'bin/openzoo.js'), '--help'], () => {}, 30000);
+        await fs.rename(stage, path.join(updates, latest));
+        selected = path.join(updates, latest); version = latest;
+      } finally { await fs.rm(stage, { recursive: true, force: true }); }
+    }
+  } catch (e) { log(`Update unavailable (${e.message}). Using installed OpenZoo ${version}.\n`); }
+  log(`Starting OpenZoo ${version}…\n`);
+  return { node, cli: path.join(pkg(selected), 'bin/openzoo.js') };
+}
+module.exports = { newer, environment, resolveCLI, run };

package/launcher/savings-preload.cjs

@@ -0,0 +1,5 @@
+const { contextBridge, ipcRenderer } = require('electron');
+contextBridge.exposeInMainWorld('savings', {
+  listen: fn => ipcRenderer.on('savings', (_event, value) => fn(value)),
+  close: () => ipcRenderer.send('close-savings'),
+});

package/launcher/savings-renderer.js

@@ -0,0 +1,10 @@
+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 => {
+  for (const [id, value] of [['wallet',d.walletUsd],['credit',d.creditUsd],['spent',d.spendUsd],['direct',d.directUsd]]) document.getElementById(id).textContent=usd(value);
+  const comparable=typeof d.directUsd==='number' && typeof d.spendUsd==='number' && (d.directUsd>0 || d.spendUsd===0);
+  const saved=comparable ? d.directUsd-d.spendUsd : null;
+  document.getElementById('saved').textContent=usd(saved);
+  document.getElementById('saving-label').textContent=saved!==null && saved<0 ? 'Extra cost' : 'Saved';
+  document.getElementById('state').textContent=d.online ? 'Balance updates automatically' : 'Reconnecting · showing last known amounts';
+});
+document.getElementById('close').addEventListener('click',()=>window.savings.close());

package/launcher/savings.cjs

@@ -0,0 +1,41 @@
+const { BrowserWindow, screen, ipcMain } = require('electron');
+const path = require('node:path');
+let pill;
+function showSavings(port = Number(process.env.OPENZOO_SAVINGS_PORT) || 8402) {
+  if (pill && !pill.isDestroyed()) { pill.show(); return pill; }
+  const { x, y, width, height } = screen.getPrimaryDisplay().workArea;
+  pill = new BrowserWindow({ width: 420, height: 270, x: x + width - 440, y: y + height - 290,
+    frame: false, transparent: true, alwaysOnTop: true, skipTaskbar: true, resizable: false,
+    webPreferences: { preload: path.join(__dirname, 'savings-preload.cjs'), contextIsolation: true, sandbox: true, nodeIntegration: false } });
+  pill.setAlwaysOnTop(true, 'floating');
+  pill.setVisibleOnAllWorkspaces(true, { visibleOnFullScreen: true });
+  pill.webContents.setWindowOpenHandler(() => ({ action: 'deny' }));
+  pill.webContents.on('will-navigate', e => e.preventDefault());
+  pill.loadFile(path.join(__dirname, 'savings.html'));
+  const window = pill;
+  let busy = false, last = null;
+  const poll = async () => {
+    if (busy || window.isDestroyed()) return;
+    busy = true;
+    try {
+      const r = await fetch(`http://127.0.0.1:${port}/v1/info`, { signal: AbortSignal.timeout(2500) });
+      const d = await r.json();
+      if (!r.ok || d.youAreTalkingTo !== 'openzoo proxy') throw Error('Unavailable');
+      last = d;
+      if (!window.isDestroyed()) window.webContents.send('savings', { ...d, online: true });
+    } catch { if (!window.isDestroyed()) window.webContents.send('savings', { ...last, online: false }); }
+    finally { busy = false; }
+  };
+  window.webContents.on('did-finish-load', () => {
+    poll();
+    if (process.env.OPENZOO_SAVINGS_READY) {
+      try { require('node:fs').writeFileSync(process.env.OPENZOO_SAVINGS_READY, 'ready'); } catch {}
+    }
+  });
+  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; });
+  return pill;
+}
+module.exports = { showSavings };

package/launcher/savings.html

@@ -0,0 +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>Spent</dt><dd id="spent">—</dd><dt>Would’ve cost · estimate</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>Shared OpenZoo totals · drag the orange bar to move</small></main></div><script src="savings-renderer.js"></script></body></html>

package/lib/chatgpt-spend.js

@@ -163,21 +163,41 @@ export function nativeSavingsLauncher({ platform = process.platform, home = os.h
   return null;
 }
 
-export async function startChatGptSpend({ profile, proxyPort, spawnImpl = spawn } = {}) {
-  const native = nativeSavingsLauncher();
-  if (native && proxyPort === 8402) {
-    const child = spawnImpl(native, ['--savings-only'], { detached: true, stdio: 'ignore' });
-    await new Promise((resolve, reject) => { child.once('spawn', resolve); child.once('error', reject); });
-    child.unref();
-    return;
-  }
-  fs.mkdirSync(profile, { recursive: true });
-  const fd = fs.openSync(path.join(profile, 'openzoo-savings.log'), 'a', 0o600);
+export async function startChatGptSpend({ profile, proxyPort = 8402, spawnImpl = spawn } = {}) {
+  const app = fileURLToPath(new URL('../launcher/', import.meta.url));
+  const electron = path.join(app, 'node_modules/electron/dist', process.platform === 'darwin'
+    ? 'Electron.app/Contents/MacOS/Electron' : process.platform === 'win32' ? 'electron.exe' : 'electron');
+  const env = { ...process.env, OPENZOO_SAVINGS_PORT: String(proxyPort) };
+  delete env.ELECTRON_RUN_AS_NODE;
+  const readyDir = fs.mkdtempSync(path.join(os.tmpdir(), 'openzoo-pill-'));
+  env.OPENZOO_SAVINGS_READY = path.join(readyDir, 'ready');
+  const logDir = profile || path.join(os.homedir(), '.openzoo');
+  fs.mkdirSync(logDir, { recursive: true });
+  const logPath = path.join(logDir, 'openzoo-savings.log');
+  const fd = fs.openSync(logPath, 'a', 0o600);
+  let child, failure;
   try {
-    const child = spawnImpl(process.execPath, [fileURLToPath(import.meta.url), '--watch', profile, String(proxyPort)], { detached: true, stdio: ['ignore', fd, fd] });
-    await new Promise((resolve, reject) => { child.once('spawn', resolve); child.once('error', reject); });
+    if (fs.existsSync(electron)) {
+      child = spawnImpl(electron, [app, '--savings-only'], { detached: true, stdio: ['ignore', fd, fd], env });
+    } else {
+      // npm caches the standalone display runtime. The CLI ships the display itself.
+      // No ChatGPT debugging port or separate OpenZoo installer is required.
+      const args = ['exec', '--yes', '--package=electron@44.3.0', '--', 'electron', app, '--savings-only'];
+      const npmScript = process.env.npm_execpath;
+      child = npmScript && fs.existsSync(npmScript)
+        ? spawnImpl(process.execPath, [npmScript, ...args], { detached: true, stdio: ['ignore', fd, fd], env })
+        : spawnImpl(process.platform === 'win32' ? 'npm.cmd' : 'npm', args, { detached: true, stdio: ['ignore', fd, fd], env, shell: process.platform === 'win32' });
+    }
+    child.once('error', error => { failure = error; });
+    child.once('exit', code => { if (code) failure = new Error(`Display exited (${code})`); });
     child.unref();
-  } finally { fs.closeSync(fd); }
+    const deadline = Date.now() + 120000;
+    while (!fs.existsSync(env.OPENZOO_SAVINGS_READY)) {
+      if (failure) throw failure;
+      if (Date.now() > deadline) throw new Error(`Display did not open. See ${logPath}`);
+      await new Promise(resolve => setTimeout(resolve, 200));
+    }
+  } finally { fs.closeSync(fd); fs.rmSync(readyDir, { recursive: true, force: true }); }
 }
 
 /** One watcher per profile, including concurrent launcher invocations. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openzoo",
-  "version": "0.51.8",
+  "version": "0.51.9",
   "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",
@@ -10,7 +10,14 @@
   "files": [
     "bin",
     "lib",
-    "README.md"
+    "README.md",
+    "launcher/main.cjs",
+    "launcher/runtime.cjs",
+    "launcher/package.json",
+    "launcher/savings.cjs",
+    "launcher/savings.html",
+    "launcher/savings-preload.cjs",
+    "launcher/savings-renderer.js"
   ],
   "engines": {
     "node": ">=18"