← Commit history

v2.0.262: New setting: overlay badge size, defaulting to HALF (John). At full size the favicon badge covers the thread tile's BOTTOM LINE of text, which is the whole point of thread tiles since that text is how you tell one thread's windows from another's. Windows offers no way to ask the shell for a smaller overlay slot, so the badge CONTENT is composited at half scale inside the same 48x48 canvas, anchored northeast (the tile draws its name from the bottom-left, so the far corner does the least damage) and the shell scales it as before. Wired end to end: default '50', dashboard Settings row (a labelled dropdown, the sel row type gained selLabels so a raw value like '50' reads as 'Half size' instead of a bare number), set-setting whitelist, live repaint on change so flipping it moves the taskbar immediately, pup_configure {overlaySize}, pup_describe, and pup_status.settings. The overlay cache key includes the size, without which a flip would serve the previously-composited badge and nothing would change on glass.

John Lauer ·563e4931b6 ·2mo ago ·parent 2a5e0ba
4 files changed +63−13
adom-bridge-puppeteer-manifest.json+5−5
@@ -1,10 +1,10 @@ {   "manifest_version": 1,   "name": "puppeteer",-  "version": "2.0.261",-  "url": "https://wiki.adom.inc/download/adom/pup-bridge/2.0.261/adom-bridge-puppeteer-v2.0.261.zip",-  "sha256": "f09bf7bd93dfd1d37256d58736e32663623cdb827072d5a95e30300bee4588f2",-  "size": 957681,+  "version": "2.0.262",+  "url": "https://wiki.adom.inc/download/adom/pup-bridge/2.0.262/adom-bridge-puppeteer-v2.0.262.zip",+  "sha256": "32f2f6533ed4e82b5aca535a1860c31e195697600c232b5dee6f5fcb84a96d73",+  "size": 959307,   "verbPrefixes": [     "browser_",     "desktop_recorder_",@@ -12,5 +12,5 @@   ],   "healthEndpoint": "/status",   "statusVerb": "browser_readiness",-  "released_at": "2026-08-20T12:43:44.102914Z"+  "released_at": "2026-08-21T00:15:39.513208Z" }
src/BRIDGE_VERSION+1−1
@@ -1 +1 @@-2.0.261\ No newline at end of file+2.0.262\ No newline at end of file
src/bridge.json+1−1
@@ -2,7 +2,7 @@   "manifest_version": 1,   "name": "puppeteer",   "displayName": "Puppeteer (Chrome for Testing + Native)",-  "version": "2.0.261",+  "version": "2.0.262",   "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+56−6
@@ -3492,6 +3492,13 @@ function pupSettings() {   // the _chosen tracking means flipping a default only moves users who never set the key.)   const D = { aumidIcons: 'on', jumpLists: 'on', fgWatch: 'on', fgCaption: 'on', fgCaptionMs: 2000,               overlayBadges: 'on', autoFlash: 'off', sleepRecovery: 'on', openFlash: 'off',+              // v2.0.262 (John): the badge at full size covers the BOTTOM LINE of the thread tile's+              // name, and that text is the whole point of thread tiles ("i'm finding that the text is+              // super valuable so i want to be able to see it"). '50' composites the same badge at half+              // scale inside the same canvas, so Windows draws it half-size in the corner and the tile+              // text stays readable. DEFAULT is '50' — the readable one — with '100' available for+              // anyone who wants the big badge back.+              overlaySize: '50',               aumidIconStyle: 'category', taskbarGrouping: 'split',               // v2.0.152 THREAD TILES (John): group every pup window/tab of one ai-thread under ONE               // taskbar button whose icon is that thread's NAME rendered on the teal tile (Familjen@@ -6504,7 +6511,9 @@ async function applyAppOverlay(session, sessionId) {     // symptom John kept reporting — "the code runs, no errors, and the icon is still wrong" — and it     // silently invalidated every badge fix from 1.9.203 onward, including the generic globe / PDF     // icons. Keying on BRIDGE_VERSION makes any new build rebuild its badges.-    const cacheKey = BRIDGE_VERSION + ':' + sessionId + ':' + (src.href || 'explicit') + ':' + (plateAuthed ? 'auth' : 'plain') + ':' + (pupSettings().aumidIcons === 'on' ? 'nomark' : 'mark');+    // v2.0.262: overlaySize is part of the key — without it, flipping the setting would serve the+    // previously-composited badge from cache and nothing would visibly change.+    const cacheKey = BRIDGE_VERSION + ':' + sessionId + ':' + (src.href || 'explicit') + ':' + (plateAuthed ? 'auth' : 'plain') + ':' + (pupSettings().aumidIcons === 'on' ? 'nomark' : 'mark') + ':sz' + (pupSettings().overlaySize === '100' ? '100' : '50');     let overlay = _appOverlayCache.get(cacheKey);     if (!overlay) {       let sharpMod = null;@@ -6636,7 +6645,23 @@ async function applyAppOverlay(session, sessionId) {           // Adom mark is GONE from the badge in every mode. The badge is the site favicon on its           // contrast card, nothing else; Adom identity lives in the base tile alone.           if (layers.length) img = img.composite(layers);-          overlay = (await img.png().toBuffer()).toString('base64');+          let _built = await img.png().toBuffer();+          // v2.0.262 (John): HALF-SIZE BADGE, and it is the default. At full size the badge covers the+          // thread tile's BOTTOM LINE of text — which is the whole point of thread tiles, since that+          // text is how you tell one thread's windows from another's ("the text is super valuable so i+          // want to be able to see it"). Windows gives us no way to ask the shell for a smaller overlay+          // slot, so we shrink the CONTENT inside the same canvas: composite the finished badge at half+          // scale into a transparent 48x48 and let the shell scale the whole thing as before. Net effect+          // on glass is a badge half the size, tucked in the corner, with the tile text clear.+          // Anchored NORTHEAST: the tile draws its name from the BOTTOM-LEFT, so the far corner from+          // the text is where the badge does the least damage.+          if (pupSettings().overlaySize !== '100') {+            const _h = Math.round(BSZ / 2);+            const _small = await sharpMod(_built).resize(_h, _h, { fit: 'cover' }).png().toBuffer();+            _built = await sharpMod({ create: { width: BSZ, height: BSZ, channels: 4, background: { r: 0, g: 0, b: 0, alpha: 0 } } })+              .composite([{ input: _small, gravity: 'northeast' }]).png().toBuffer();+          }+          overlay = _built.toString('base64');         } catch (e) { return false; }       }       _appOverlayCache.set(cacheKey, overlay);@@ -8274,7 +8299,7 @@ function statusCore() {     settings: {       taskbarMode: st.aumidIcons !== 'on' ? 'plain' : (st.threadTiles === 'on' ? 'tiles' : 'aumid'),       aumidIcons: st.aumidIcons, threadTiles: st.threadTiles,-      overlayBadges: st.overlayBadges, jumpLists: st.jumpLists,+      overlayBadges: st.overlayBadges, overlaySize: st.overlaySize, jumpLists: st.jumpLists,     },     iconAudit: _lastAudit ? { ok: _lastAudit.ok, at: _lastAudit.at, mode: _lastAudit.mode, findings: _lastAudit.findings.length, repaired: _lastAudit.repaired, reason: _lastAudit.reason } : null,     sessionCount: sessions.size,@@ -12274,6 +12299,7 @@ const SETTINGS_DEF=[  {k:'fgCaption',l:'Caption on AI foreground',d:'When an AI brings a window to your screen, show its stated reason as an on-screen caption. The AI is always forced to give a reason; this shows it to you.'},  {k:'fgCaptionMs',l:'',d:'',slider:[500,5000,250],dep:'fgCaption',test:1},  {k:'overlayBadges',l:'Favicon overlay badges',d:'Paint each pup taskbar icon with the favicon of its active tab plus the Adom mark.'},+ {k:'overlaySize',l:'Badge size',d:'How big the favicon badge is drawn on the taskbar button. Half size keeps the badge clear of the thread tile\u2019s bottom line of text, which is usually the part you want to read. Full size is the older, larger badge.',sel:['50','100'],selLabels:{'50':'Half size \u2014 keeps the tile text readable','100':'Full size'},dep:'overlayBadges'},  {k:'openFlash',l:'Taskbar flash on new window',d:'Flash the taskbar button (the Windows attention flash; accent-colored, salmon on your theme) when a new pup window opens, so you can spot it.',testflash:1},  {k:'autoFlash',l:'Taskbar flash on agent activity',d:'Flash a window taskbar button when an AI changes that window (navigate, click, type). One flash per burst.'},  {k:'agentActivity',l:'Taskbar progress bar',d:'Show a progress strip on a window taskbar button while an AI is actively driving it.'},@@ -12356,7 +12382,10 @@ function renderDlg(){     }     if(def.sel){       const on=def.depMode?(st.taskbarMode===def.depMode):(!def.dep||st[def.dep]==='on');-      const selHtml='<select data-sel="'+def.k+'" aria-label="'+esc(def.l||def.k)+'">'+def.sel.map(x=>'<option'+(st[def.k]===x?' selected':'')+'>'+x+'</option>').join('')+'</select>';+      // v2.0.262: optional selLabels gives a raw stored value a human option label ('50' -> 'Half+      // size'). Without it the select showed the literal value, which is fine for mode words like+      // "split"/"grouped" but meaningless for a number.+      const selHtml='<select data-sel="'+def.k+'" aria-label="'+esc(def.l||def.k)+'">'+def.sel.map(x=>'<option value="'+esc(x)+'"'+(st[def.k]===x?' selected':'')+'>'+esc((def.selLabels&&def.selLabels[x])||x)+'</option>').join('')+'</select>';       // v2.0.179: mainsel = a top-level MODE row (label + info + description + examples + select),       // used by the taskbar-identity ladder; plain sel rows stay compact subs.       if(def.mainsel){@@ -12770,7 +12799,7 @@ const server = http.createServer(async (req, res) => {           // v1.9.259: the dashboard settings dialog. Whitelisted keys only; values validated.           const ALLOWED = {             aumidIcons: ['on', 'off'], jumpLists: ['on', 'off'], fgWatch: ['on', 'off'],-            fgCaption: ['on', 'off'], overlayBadges: ['on', 'off'], autoFlash: ['on', 'off'],+            fgCaption: ['on', 'off'], overlayBadges: ['on', 'off'], overlaySize: ['50', '100'], autoFlash: ['on', 'off'],             openFlash: ['on', 'off'], sleepRecovery: ['on', 'off'], agentActivity: ['on', 'off'],             reportIssues: ['on', 'off'], autoLogin: ['on', 'off', 'submit', 'fill'], captureLogins: ['on', 'off'], minimalTouch: ['on', 'off'],             taskbarGrouping: ['split', 'grouped'],@@ -12821,6 +12850,17 @@ const server = http.createServer(async (req, res) => {             }             applyOverlayBadgeSetting(val, _obApply).catch(() => {});           }+          // v2.0.262: badge SIZE live-applies exactly like the badge on/off toggle — a size change+          // that only took effect on the next natural repaint would look broken (John flips it, the+          // taskbar does not move). Same repaint path, with its own progress entry.+          if (key === 'overlaySize') {+            let _szApply = null;+            if (!_modeApply || _modeApply.done || Date.now() - _modeApply.at > 20000) {+              _szApply = { at: Date.now(), token: ++_modeApplyTok, mode: 'overlaysize-' + val, steps: [{ label: val === '100' ? 'Repainting badges at full size' : 'Repainting badges at half size', state: 'run' }], done: false };+              _modeApply = _szApply;+            }+            applyOverlayBadgeSetting(pupSettings().overlayBadges === 'off' ? 'off' : 'on', _szApply).catch(() => {});+          }           // v2.0.90: the pencil hit-area slider live-applies — re-inject the floaty on every open           // page (the versioned guard includes the px value, so a change tears down and rebuilds).           if (key === 'floatyHitPx' || key === 'tbFloatyPencil' || key === 'tbSnipHotkey') {@@ -13528,7 +13568,7 @@ const server = http.createServer(async (req, res) => {             V('desktop_record_status', 'Status of the desktop screen recorder + any active clip.', {}, 10, {}),             V('desktop_record_list', 'List completed desktop recordings on disk.', {}, 10, {}),             V('desktop_recorder_close', 'Close the desktop screen-recorder UI.', {}, 15, {}),-            V('pup_configure', 'Get/set user-facing pup preferences (persisted across bridge updates). taskbarGrouping: "split" (default — one taskbar button PER WINDOW, each badged with its own tab count; best for telling AI threads apart) | "grouped" (all pup windows stack under ONE "Adom Pup" button, badge shows window count; tidy taskbar). Applies to live windows immediately. Ask the USER which they prefer before changing it — this is their taskbar. WINDOWS ONLY: macOS has no taskbar, so the setting is stored but INERT there; the reply carries platform + taskbarSupported so branch on those, not on this text.', { taskbarGrouping: 'optional "split"|"grouped"', agentActivity: 'optional "on"|"off" — the taskbar progress bar marking which window a thread is driving', reportIssues: 'optional "on"|"off" — pup\'s bug-report invitation (_reportIssues), on by default', autoLogin: 'optional "on"|"off" — auto-fill a vault-matched login form on page load (fill only, never submits), on by default' }, 15, { taskbarGrouping: 'grouped' }),+            V('pup_configure', 'Get/set user-facing pup preferences (persisted across bridge updates). taskbarGrouping: "split" (default — one taskbar button PER WINDOW, each badged with its own tab count; best for telling AI threads apart) | "grouped" (all pup windows stack under ONE "Adom Pup" button, badge shows window count; tidy taskbar). Applies to live windows immediately. Ask the USER which they prefer before changing it — this is their taskbar. WINDOWS ONLY: macOS has no taskbar, so the setting is stored but INERT there; the reply carries platform + taskbarSupported so branch on those, not on this text.', { taskbarGrouping: 'optional "split"|"grouped"', agentActivity: 'optional "on"|"off" — the taskbar progress bar marking which window a thread is driving', reportIssues: 'optional "on"|"off" — pup\'s bug-report invitation (_reportIssues), on by default', autoLogin: 'optional "on"|"off" — auto-fill a vault-matched login form on page load (fill only, never submits), on by default', overlaySize: 'optional "50"|"100" — how big the favicon badge is drawn on the taskbar button. "50" (the DEFAULT) draws it at half size so it stays clear of the thread tile\'s bottom line of text; "100" is the older, larger badge' }, 15, { taskbarGrouping: 'grouped' }),             V('pup_describe', 'This list — the bridge\'s verbs + schemas, for AD\'s Verbs tab.', {}, 10, {}),           ] });           return;@@ -14277,6 +14317,16 @@ const server = http.createServer(async (req, res) => {             console.log(`[configure] overlayBadges -> ${ob}`);             applyOverlayBadgeSetting(ob, null).catch(() => {});           }+          // v2.0.262: badge SIZE over the verb too. pup_configure has a habit of missing new keys+          // (selftest T6 caught exactly that for jumpLists), so it is wired in the same pass as the+          // dashboard rather than left for later.+          const osz = args.overlaySize;+          if (osz !== undefined && !['50', '100'].includes(String(osz))) { sendJSON(res, { success: false, error: `overlaySize must be one of 50|100 (50 = half size, the default — it keeps the thread tile's bottom line of text readable)` }); return; }+          if (osz !== undefined) {+            savePupSettings({ overlaySize: String(osz) });+            console.log(`[configure] overlaySize -> ${osz}`);+            applyOverlayBadgeSetting(pupSettings().overlayBadges === 'off' ? 'off' : 'on', null).catch(() => {});+          }           // v2.0.213 (selftest T6 caught it): pup_configure NEVER handled jumpLists — the arg was           // silently ignored (only the dashboard dialog was wired to refreshAllJumplists), so a           // toggle through the verb was a no-op and post-respawn re-commits could only come from