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
Make the taskbar identity ladder provable live: the button nudge fires on every landed identity change so tiles-to-aumid switches repaint, switching to plain strips all pup identity from existing windows immediately so they fall back to the stock Chrome button, and the Settings preview now shows what the SELECTED mode looks like instead of always showing Thread Tiles.
4 files changed
+70−14
adom-bridge-puppeteer-manifest.json+4−4@@ -1,10 +1,10 @@ { "manifest_version": 1, "name": "puppeteer",- "version": "2.0.179",- "url": "https://wiki.adom.inc/download/adom/pup-bridge/2.0.179/adom-bridge-puppeteer-v2.0.179.zip",- "sha256": "3b72fc96d7bcd7dfcfa8d1ab027e0c1f0d32931c717e9cf949977f5c5c8a8c18",- "size": 918612,+ "version": "2.0.180",+ "url": "https://wiki.adom.inc/download/adom/pup-bridge/2.0.180/adom-bridge-puppeteer-v2.0.180.zip",+ "sha256": "d409ec700331875057389621ad67ced7606290684b3c63ca6bbfcb271392b8fd",+ "size": 919650, "verbPrefixes": [ "browser_", "desktop_recorder_",
src/BRIDGE_VERSION+1−1@@ -1 +1 @@-2.0.179+2.0.180
src/bridge.json+1−1@@ -2,7 +2,7 @@ "manifest_version": 1, "name": "puppeteer", "displayName": "Puppeteer (Chrome for Testing + Native)",- "version": "2.0.179",+ "version": "2.0.180", "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. pup_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. pup_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, pup_alert_window posts a native toast whose click focuses the window, pup_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-bridge", "author": "Adom Inc.",
src/server.js+64−8@@ -4169,6 +4169,12 @@ async function stampPupIdentity(sessionId, opts) { // SetOverlayIcon call can latch the button association (the 2.0.167 regression). if (appId.startsWith(`${PUP_APP_ID}.thread.`)) { sess._threadStampAt = Date.now();+ }+ // v2.0.180 (the "prove it" run): the button nudge now fires on EVERY landed identity+ // CHANGE, not just thread stamps — this Win11 build never rebuilds a button on an in-place+ // AUMID change, so tiles<->aumid mode switches (and any future identity move) need the same+ // hide/re-show the thread transition needed. Once per (session, appId), foreground-skipped.+ if (true) { // v2.0.169 THE BUTTON NUDGE (measured live, the missing last mile): on this Win11 build the // shell does NOT recreate a taskbar button when a live window's AUMID changes — the button // stays latched to the birth identity (default CfT) no matter how cleanly the stamp applied@@ -4535,6 +4541,31 @@ function pruneStaleAumids() { // both failed the #46 live-window invariant and was a real flicker on the user's screen. 80ms still // makes the shell destroy + recreate the button (verified live: a restamped window's button renamed // to the new thread), so we keep the only effect that matters and drop 87% of the blind spot.+// v2.0.180 (plain mode must apply LIVE, for the "prove it" ladder walk): stamped identity used to+// persist on existing windows until they closed ("already-stamped windows keep their icon"). On a+// switch to plain, strip everything now: drop every session's identity bookkeeping, unregister the+// Adom.Pup.* registry keys, and nudge each window — an UNREGISTERED appId falls back to the owning+// exe's icon (AD's own doc), i.e. the stock Chrome-for-Testing look John calls plain jane.+async function stripAllPupIdentities(reason) {+ if (process.platform !== 'win32') return;+ const ids = new Set(); const targets = [];+ for (const [sid, s] of [...sessions]) {+ if (s._curAppId && s._curAppId !== PUP_APP_ID) ids.add(s._curAppId);+ s._curAppId = null; s._frozenAppId = null; s._desiredAppId = null; s._threadNudged = null;+ targets.push([sid, s]);+ }+ for (const id of ids) {+ try { await chrome.abCommand('desktop_set_window_jumplist', { appId: id, tasks: [] }, { timeoutMs: 5000 }); } catch (e) {}+ try { await chrome.abCommand('desktop_unregister_app_identity', { appId: id }, { timeoutMs: 5000 }); } catch (e) {}+ try { execFileSync('reg', ['delete', `HKCU\\Software\\Classes\\AppUserModelId\\${id}`, '/f'], { timeout: 5000, windowsHide: true, stdio: 'ignore' }); } catch (e) {}+ }+ try { _registeredPupAumids.clear(); } catch (e) {}+ for (const [sid, s] of targets) {+ try { if (!s._hwnd) await resolveSessionHwndByBounds(s, sid); } catch (e) {}+ if (s._hwnd) nudgeTaskbarButton(s._hwnd, sid);+ }+ console.log(`[identity] stripped ${ids.size} pup identit(ies) + nudged ${targets.length} window(s) (${reason})`);+} let _nudgeUntil = 0; // v2.0.172: while set, ignore window-opened events caused by our own nudge function nudgeTaskbarButton(hwnd, sessionId) { if (process.platform !== 'win32' || !hwnd) return;@@ -11206,6 +11237,8 @@ select,input{background:#111b23;color:#e6edf3;border:1px solid #23303c;border-ra .tex canvas{width:44px;height:44px;border-radius:7px;display:block} .texn{font:400 9.5px ui-monospace,monospace;color:#8b949e;text-align:center;line-height:1.2;word-break:break-word} .texcap{margin-top:6px;font-size:11px;color:#8b949e}+.texwide{width:auto}+.texbase{width:44px;height:44px;border-radius:7px;display:block} .srow{display:flex;align-items:flex-start;gap:12px;padding:11px 0;border-bottom:1px solid #21262d} .srow:last-child{border-bottom:none} .srow .stxt{flex:1 1 auto;min-width:0}@@ -11618,6 +11651,23 @@ function renderDlg(){ // so the strip always shows a range of name lengths. function paintThreadExamples(){ const strip=_q('#texstrip'); if(!strip) return;+ // v2.0.180 (John: "if plain is a choice, SHOW them what plain means — you keep previewing Thread+ // Tiles for every mode and it's crazy confusing"): the preview now follows the SELECTED mode.+ const st2=(SNAP&&SNAP.bridge&&SNAP.bridge.settings)||{};+ const mode=st2.aumidIcons!=='on'?'plain':(st2.threadTiles==='on'?'tiles':'aumid');+ const cap=strip.parentElement?strip.parentElement.querySelector('.texcap'):null;+ if(mode==='plain'){+ strip.innerHTML='<div class="tex texwide"><img class="texbase" src="/dashboard/baseicon?profile=adom-you" alt="" onerror="this.style.display=String.fromCharCode(110,111,110,101)">'+ +'<span class="texn">every pup window</span></div>';+ if(cap)cap.textContent='Plain: pup does no branding at all. All pup windows stack under the stock Chrome-for-Testing button (its real icon shown above), exactly like any unbranded app. No name tiles, no per-window icons, no overlay badges.';+ return;+ }+ if(mode==='aumid'){+ strip.innerHTML='<img class="sexample" src="/dashboard/example?n=iconstylecat&v='+PAGE_VERSION+'" alt="aumid category icons" data-fallback="hide">';+ if(cap)cap.textContent='AUMID: every window gets its OWN taskbar button wearing a pup/category icon (real capture above). Tune it with the grouping and icon-style options below; the overlay badge rides each button.';+ return;+ }+ if(cap)cap.textContent='Your real thread names, drawn exactly as the taskbar draws them. The badge in the corner is the favicon of the active tab.'; const live=[]; try{ ((SNAP&&SNAP.windows)||[]).forEach(w=>{const t=w.owner||w.ownerThread;if(t&&live.indexOf(t)<0)live.push(t);}); }catch(e){} const fill=['kicad','nb','fusion','ah build','shotlog','adom-tts','pup bridge maintenance'];@@ -11917,10 +11967,13 @@ const server = http.createServer(async (req, res) => { : { aumidIcons: 'off', threadTiles: 'off' }; savePupSettings({ ...pair, _chosen: { ...(pupSettings()._chosen || {}), aumidIcons: true, threadTiles: true } }); console.log(`[settings] taskbarMode -> ${val} (dashboard dialog)`);- for (const [, s7] of [...sessions]) { try { s7._curAppId = null; s7._frozenAppId = null; } catch (e) {} }- try { _registeredPupAumids.clear(); } catch (e) {}- brandSweep('settings-taskbarmode').catch(() => {});- reconcileModel('setting taskbarMode').catch(() => {});+ if (val === 'plain') { stripAllPupIdentities('settings-taskbarmode-plain').catch(() => {}); }+ else {+ for (const [, s7] of [...sessions]) { try { s7._curAppId = null; s7._frozenAppId = null; } catch (e) {} }+ try { _registeredPupAumids.clear(); } catch (e) {}+ brandSweep('settings-taskbarmode').catch(() => {});+ reconcileModel('setting taskbarMode').catch(() => {});+ } return done({ ok: true, settings: pupSettings() }); } if (key === 'floatyHitPx') {@@ -13235,10 +13288,13 @@ const server = http.createServer(async (req, res) => { : { aumidIcons: 'off', threadTiles: 'off' }; savePupSettings({ ...pair, _chosen: { ...(pupSettings()._chosen || {}), aumidIcons: true, threadTiles: true } }); console.log(`[configure] taskbarMode -> ${tm} (${JSON.stringify(pair)})`);- for (const [, s] of [...sessions]) { try { s._curAppId = null; s._frozenAppId = null; } catch (e) {} }- try { _registeredPupAumids.clear(); } catch (e) {}- brandSweep('configure-taskbarmode').catch(() => {});- reconcileModel('setting taskbarMode').catch(() => {});+ if (tm === 'plain') { stripAllPupIdentities('configure-taskbarmode-plain').catch(() => {}); }+ else {+ for (const [, s] of [...sessions]) { try { s._curAppId = null; s._frozenAppId = null; } catch (e) {} }+ try { _registeredPupAumids.clear(); } catch (e) {}+ brandSweep('configure-taskbarmode').catch(() => {});+ reconcileModel('setting taskbarMode').catch(() => {});+ } } // v1.8.82: user-facing pup preferences. Currently: taskbarGrouping 'split'|'grouped'. const valid = ['split', 'grouped'];