app
Pup - the AI's own browser
Public Made by Adomby adom
pup gives your AI a real browser on your desktop that it drives completely, in the background, signed in as you: windows that never jump in front of your work, one shared profile that learns your logins, and every window labeled on the taskbar with its AI thread's name.
← Commit history
Notched category tiles (John's idea): punch a transparent rounded notch into the UPPER-RIGHT of each pup category .ico so the favicon overlay AD paints there sits on the clean taskbar background instead of the busy teal art. Generated at bridge runtime (sharp, desktop-only) into a cache dir via a minimal PNG-frame ICO encoder (format validated); baked into the static tile so there's NO per-window/per-favicon churn, only a one-time re-stamp. pupIconPath serves the notched copy once built. Notch geometry (50% upper-right) tuned live.
4 files changed
+82−9
adom-bridge-puppeteer-manifest.json+4−4@@ -1,10 +1,10 @@ { "manifest_version": 1, "name": "puppeteer",- "version": "1.9.326",- "url": "https://wiki.adom.inc/download/adom/adom-desktop-puppeteer-bridge/1.9.326/adom-bridge-puppeteer-v1.9.326.zip",- "sha256": "fcea9f2a447d0704af560167d24320d44ba3d77d2875ec333895cc4d7d535f94",- "size": 621971,+ "version": "1.9.327",+ "url": "https://wiki.adom.inc/download/adom/adom-desktop-puppeteer-bridge/1.9.327/adom-bridge-puppeteer-v1.9.327.zip",+ "sha256": "50c9b58316604a194d65a0a697a61b6cd51642b761a9b3a65a7f1730b585c52f",+ "size": 623730, "verbPrefixes": [ "browser_", "desktop_recorder_",
src/BRIDGE_VERSION+1−1@@ -1 +1 @@-1.9.326+1.9.327
src/bridge.json+1−1@@ -2,7 +2,7 @@ "manifest_version": 1, "name": "puppeteer", "displayName": "Puppeteer (Chrome for Testing + Native)",- "version": "1.9.326",+ "version": "1.9.327", "description": "Drives a browser ALREADY on the machine \u2014 installed Chrome, else Microsoft Edge (every Windows PC ships with Edge) \u2014 launched with a FRESH isolated profile, so the common case has NO ~150 MB Chrome-for-Testing download and it never touches the user's real tabs/logins. Binds its local server to LOOPBACK (127.0.0.1) only, so no Windows Firewall 'allow Node through the firewall' prompt ever pops. Chrome for Testing is fetched only as a LAST RESORT if the machine has no Chromium browser at all. SPAWN-VERIFIED fallback: pup tries each detected browser (Chrome \u2192 Edge \u2192 CfT) and actually launches it, falling through to the next if one won't start (and handling browsers like Edge that relaunch onto another PID), so a corrupt/partial install never hard-fails an open. The browser that launches is cached as the default (persisted across restarts) so it isn't re-probed each time. On spawn the bridge SELF-WARMS: detects browsers + disk, and only if the box has no Chrome/Edge and no cached CfT does it background-fetch CfT so the first open is instant. browser_use pins a specific browser (chrome | edge | cft | auto); {browser:'chrome',install:true} downloads & installs REAL Google Chrome (user-scoped, no admin) on an Edge-only box. browser_readiness (READ-ONLY) reports which browser will be used + the full candidate list + the default + free disk. Every failure returns a specific errorCode + _hint (chrome_install_no_disk, chrome_download_network, chrome_install_permission, chrome_stable_not_detected, \u2026). Launches with FULL browser permissions by default for full debug (strictPermissions:true opts out). Headful automation: open/close windows+tabs, navigate, screenshot, eval JS, record. pup is a GENERIC, non-profile browser only \u2014 every session is a fresh isolated Chrome/Edge process, never the user's real signed-in browser; profile defaults to sessionId. To drive the user's REAL Chrome/Edge (their profile, cookies, SSO), use the Adom browser EXTENSION's nbrowser_* verbs \u2014 a separate bridge, not pup's job. macOS (v1.9.74+): full parity with mac-native mechanics \u2014 background-by-default is the app-level hide (windows stay drivable/screenshottable while hidden), raise/lower map to unhide+activate/hide, browser_alert_window posts a native toast whose click focuses the window, browser_use {browser:'chrome',install:true} installs Chrome from the official dmg, and taskbar identity/badging remains Windows-only.", "homepage": "https://wiki.adom.inc/adom/adom-desktop", "author": "Adom Inc.",
src/server.js+76−3@@ -3030,14 +3030,84 @@ function pupSessionAuthed(sessionId) { try { const s = sessionId && sessions.get(sessionId); return !!(s && s._wikiAuthed); } catch (e) { return false; } } function pupIconPath(sessionId) {- if (sessionId === 'pup-dashboard') return path.join(__dirname, 'icons', PUP_CAT_ICONS.app || PUP_ICON_DEFAULT);+ if (sessionId === 'pup-dashboard') return notchedIconPath(path.join(__dirname, 'icons', PUP_CAT_ICONS.app || PUP_ICON_DEFAULT)); // v1.9.261 (John): aumidIconStyle 'standard' = ONE icon for every AUMID window (the default pup // tile); 'category' = the custom per-category set (wiki signed-out, wiki signed-IN padlock, world // icon for the open web, adom app icon, mixed).- if (pupSettings().aumidIconStyle !== 'category') return path.join(__dirname, 'icons', PUP_ICON_DEFAULT);+ if (pupSettings().aumidIconStyle !== 'category') return notchedIconPath(path.join(__dirname, 'icons', PUP_ICON_DEFAULT)); const cat = pupCategory(sessionId); const file = (cat && PUP_CAT_ICONS[cat]) || PUP_ICON_DEFAULT;- return path.join(__dirname, 'icons', file);+ return notchedIconPath(path.join(__dirname, 'icons', file));+}+// ── Notched category tiles (John, 2026-08-04): "cut a notch out of the main icons so the overlay+// favicon has a clean background to sit on." AD paints the favicon overlay OVER the base tile's+// UPPER-RIGHT (it overhangs, and already shows the taskbar through the tile's transparent rounded+// corners). We punch a bigger transparent rounded notch into the upper-right of each STATIC category+// .ico so the whole favicon floats on the taskbar instead of on the busy teal art. Baked into the+// static tile ⇒ NO per-window / per-favicon churn (only the one-time re-stamp any icon-gen bump+// causes). Generated at runtime on the DESKTOP (sharp; the container has no sharp) into a cache dir.+const NOTCH = { frac: 0.50, rx: 0.30 }; // upper-right square side = 50% of tile; corner radius 30%. Tuned live.+const _NOTCH_CACHE = path.join(os.tmpdir(), 'pup-notched-icons', PUP_ICON_GEN);+let _notchDone = false;+function notchedIconPath(origPath) {+ if (!_notchDone) return origPath; // not built yet → original tile (harmless; a later reconcile swaps it)+ try {+ const dest = path.join(_NOTCH_CACHE, path.basename(origPath));+ if (fs.existsSync(dest) && fs.statSync(dest).size > 0) return dest;+ } catch (e) {}+ return origPath;+}+// Minimal ICO writer: embed PNG frames (valid on Win10/11 for every size).+function _icoEncode(frames) {+ const count = frames.length;+ const dir = Buffer.alloc(6 + 16 * count);+ dir.writeUInt16LE(0, 0); dir.writeUInt16LE(1, 2); dir.writeUInt16LE(count, 4);+ let offset = 6 + 16 * count; const bodies = [];+ frames.forEach((f, i) => {+ const e = 6 + 16 * i;+ dir[e] = f.size >= 256 ? 0 : f.size;+ dir[e + 1] = f.size >= 256 ? 0 : f.size;+ dir.writeUInt16LE(1, e + 4); dir.writeUInt16LE(32, e + 6);+ dir.writeUInt32LE(f.png.length, e + 8); dir.writeUInt32LE(offset, e + 12);+ offset += f.png.length; bodies.push(f.png);+ });+ return Buffer.concat([dir, ...bodies]);+}+async function _buildNotchedIco(sharp, srcPath, destPath) {+ const largest = icoLargestPng(fs.readFileSync(srcPath));+ if (!largest) throw new Error('no PNG frame in ' + path.basename(srcPath));+ const frames = [];+ for (const N of [256, 128, 64, 48, 32, 16]) {+ const base = await sharp(largest).resize(N, N, { fit: 'contain', background: { r: 0, g: 0, b: 0, alpha: 0 } }).png().toBuffer();+ const s = Math.round(N * NOTCH.frac), rx = Math.round(s * NOTCH.rx);+ const mask = Buffer.from(`<svg xmlns="http://www.w3.org/2000/svg" width="${N}" height="${N}"><rect x="${N - s}" y="0" width="${s}" height="${s}" rx="${rx}" ry="${rx}" fill="#fff"/></svg>`);+ const png = await sharp(base).composite([{ input: mask, blend: 'dest-out' }]).png().toBuffer(); // dest-out punches a transparent notch+ frames.push({ size: N, png });+ }+ fs.mkdirSync(path.dirname(destPath), { recursive: true });+ fs.writeFileSync(destPath, _icoEncode(frames));+}+let _notchReady = null;+function ensureNotchedIcons() {+ if (process.platform !== 'win32') return Promise.resolve();+ if (_notchReady) return _notchReady;+ _notchReady = (async () => {+ let sharp; try { sharp = require('sharp'); } catch (e) { console.log('[notch] sharp unavailable — using un-notched tiles'); return; }+ const files = [...new Set([PUP_ICON_DEFAULT, ...Object.values(PUP_CAT_ICONS)].filter(Boolean))];+ for (const f of files) {+ try {+ const src = path.join(__dirname, 'icons', f), dest = path.join(_NOTCH_CACHE, f);+ if (!fs.existsSync(src)) continue;+ if (!(fs.existsSync(dest) && fs.statSync(dest).size > 0)) await _buildNotchedIco(sharp, src, dest);+ } catch (e) { console.log(`[notch] FAILED ${f}: ${e.message}`); }+ }+ _notchDone = true;+ console.log(`[notch] ready (${files.length} tiles, notch=${Math.round(NOTCH.frac * 100)}% upper-right) — forcing a re-stamp so buttons pick it up`);+ // Force ONE re-stamp so live buttons swap to the notched icon (the appId is unchanged, but+ // desktop_set_window_identity recreates the button, which is what repaints the tile).+ try { for (const [, s] of sessions) { s._curAppId = null; s._lastCat = undefined; } await reconcileModel('notched-icons-ready'); } catch (e) {}+ })();+ return _notchReady; } function pupRelaunchCommand(sessionId) { const cli = path.join(process.env.LOCALAPPDATA || path.join(os.homedir(), 'AppData', 'Local'), 'Adom Desktop', 'adom-desktop-cli.exe');@@ -13678,6 +13748,9 @@ server.listen(PORT, BIND_HOST, async () => { // v1.9.279: the reconciler runs UNGATED (bookkeeping + identity only, never a process kill), so // closed windows are reaped and stamp/settings drift is corrected within seconds, in every mode. setInterval(() => { reconcileModel('periodic').catch(() => {}); }, 8000);+ // Build the notched category tiles once at boot (John's clean-backdrop-for-the-overlay idea).+ // Fire-and-forget: pupIconPath serves the un-notched tile until this finishes, then it re-stamps.+ ensureNotchedIcons().catch(() => {}); // v1.9.179 — TAB RECONCILER. Prune dead/detached and duplicate tab entries so the taskbar count // badge reflects the REAL live tabs (rapid reconnects had inflated 1-tab windows to "4") and the // favicon overlay reads from a LIVE active tab instead of a detached phantom. Runs on a gentle