Pup - the AI's own browser

@@ -12043,9 +12043,7 @@ const VERB_META = {   pup_record_stop: { hint: 'Stops recording and returns the saved file path.', related: ['pup_record_start', 'pup_record_list'], pitfalls: ['no-op if nothing is recording for this session'] },   pup_record_status: { hint: 'Whether a recording is active for the session.', related: ['pup_record_start', 'pup_record_stop'], pitfalls: [] },   pup_record_list: { hint: 'Lists saved page recordings.', related: ['pup_record_start'], pitfalls: [] },-  desktop_recorder_open: { hint: 'Opens the desktop screen-recorder UI window. OWNERSHIP: the desktop_ namespace is ab-core\'s; pup serves these on ab\'s behalf only until ab-core\'s native whole-desktop recorder lands (adom-bridge#143), then they leave pup. Tab recording (pup_record_*) is pup\'s own.', related: ['desktop_record_start', 'desktop_recorder_close'], pitfalls: [] },   desktop_record_start: { hint: 'Starts a full desktop screen recording (served by pup for ab-core until adom-bridge#143 lands; needs ffmpeg on the box for the duration header).', related: ['desktop_record_stop', 'desktop_record_status'], pitfalls: ['only one desktop recording at a time'] },-  desktop_record_stop: { hint: 'Stops the desktop recording and returns the file.', related: ['desktop_record_start', 'desktop_record_list'], pitfalls: [] },   pup_readiness: { hint: 'Cold-start readiness probe: {ready, chromeForTestingInstalled, installing, installProgressPct}. On a fresh PC, poll this until ready:true before pup_open_window — the bridge auto-installs Chrome for Testing on its own.', related: ['pup_prewarm', 'pup_open_window'], pitfalls: ['ready:false with installing:true just means Chrome for Testing is still downloading — wait + poll, do NOT treat it as an error', 'installPhase:"failed" → surface lastError to the user (usually network/proxy blocking the download, or low disk)'] },   pup_prewarm: { hint: 'Installs Chrome for Testing (the browser pup drives) WITHOUT opening a window — the warm-before-first-use path. Returns fast; poll pup_readiness for completion.', related: ['pup_readiness', 'pup_open_window'], pitfalls: ['the ~150 MB download needs network access to storage.googleapis.com', 'does not open a window — call pup_open_window once readiness reports ready:true'] },   pup_import_scan: { hint: 'READ-ONLY discovery for the comprehensive credential import (adom-you seed): enumerates every profile of every Chromium browser (Chrome/Edge/Brave) with its source account email(s), saved-password count, and ABE status. Decrypts NOTHING — actual decryption needs the Bridge-core elevated SYSTEM helper (adom/adom-bridge #51).', related: ['pup_open_window'], pitfalls: ['Windows-only', 'passwordCount is null if python is not on PATH', 'ABE (v20) passwords cannot be decrypted by this user process — that is the Bridge SYSTEM helper’s job'] },@@ -15053,9 +15051,7 @@ const server = http.createServer(async (req, res) => {             V('pup_screen_record_status', 'Status of the Chrome screen recorder + any active clip.', {}, 10, {}),             V('pup_screen_record_list', 'List completed Chrome screen recordings on disk.', {}, 10, {}),             V('pup_recorder_close', 'Close the Chrome screen-recorder HUD (auto-stops a clip).', {}, 15, {}),-            V('desktop_recorder_open', 'ALIAS of pup_recorder_open (routes to ab-core once its native recorder lands, adom-bridge#143).', {}, 20, {}),             V('desktop_record_start', 'ALIAS of pup_screen_record_start (routes to ab-core once its native recorder lands, adom-bridge#143).', { outPath: 'optional str' }, 20, {}),-            V('desktop_record_stop', 'ALIAS of pup_screen_record_stop.', {}, 30, {}),             V('pup_readiness', 'Readiness + which browser pup will drive (installed Chrome/Edge, or cached Chrome for Testing) + the full candidate list and current default. READ-ONLY; never downloads.', {}, 10, {}),             V('pup_prewarm', 'Install Chrome for Testing WITHOUT opening a window, and pin it as the default. Use when you specifically want CfT rather than the machine\'s installed Chrome/Edge.', { wait: 'optional bool — block until installed', setDefault: 'optional bool (default true) — pin CfT as the default' }, 240, {}),             V('pup_use', 'Pin (or clear) the browser pup drives by default: chrome | edge | cft | auto (or an explicit executablePath). "cft" fetches Chrome for Testing then pins it. With {browser:"chrome", install:true} it DOWNLOADS & INSTALLS real Google Chrome on an Edge-only box, then pins it — SILENT on a normal PC; on a locked-down box (VM/managed device) it needs a Windows approval, so the bridge pops a native "click YES on the UAC" notification and, if it expires, re-notifies with a one-tap "Approve now" (all autonomous — no AI turn). Poll pup_readiness.chromeStablePhase: installing → awaiting_uac → ready. Persists across restarts; launch still spawn-verifies + falls back.', { browser: '"chrome" | "edge" | "cft" | "auto"', install: 'optional bool — with browser:"chrome", install real Chrome if missing', elevate: 'optional "auto"(default)|true|false — auto: quiet install, prompt only if it needs admin; false: never prompt; true: go straight to the prompt', executablePath: 'optional — pin an exact browser binary' }, 240, {}),@@ -15086,9 +15082,6 @@ const server = http.createServer(async (req, res) => {             V('pup_wait', 'Wait N ms (or for a selector) before the next step.', { sessionId: 'required str', ms: 'optional int', selector: 'optional str' }, 60, { sessionId: 'work', ms: 500 }),             V('pup_rescan', 'Recover orphaned sessions: reconnect dropped CDP sockets + rebuild sessions from window titles. Pass adoptOrphans:true to also adopt untagged tabs.', { adoptOrphans: 'optional bool' }, 30, {}),             V('pup_close', 'Close ALL pup sessions + windows at once (destructive). NOTE: `{}` here does NOT mean "the active session" the way it does on other session-scoped verbs — with no args this closes EVERY window, across every AI thread on the machine, with no confirmation. To close ONE window use pup_close_window {sessionId}. Pass {sessionId} here only if you genuinely mean that one session.', {}, 20, {}),-            V('desktop_record_status', 'ALIAS of pup_screen_record_status.', {}, 10, {}),-            V('desktop_record_list', 'ALIAS of pup_screen_record_list.', {}, 10, {}),-            V('desktop_recorder_close', 'ALIAS of pup_recorder_close.', {}, 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"', taskbarActivity: 'optional "progress"|"flash"|"off" — how pup signals it is working on a window, on that window\'s taskbar button: a determinate progress bar sized to the operation\'s running-average time (default), the old orange flash, or nothing. Replaces the former openFlash/autoFlash/agentActivity toggles.', 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, {}),           ] });@@ -19978,8 +19971,7 @@ const server = http.createServer(async (req, res) => {         }          // ─── Desktop recording (HUD) ───────────────────────────────────-        case 'pup_recorder_open':-        case 'desktop_recorder_open': {+        case 'pup_recorder_open': {           try {             await ensureRecorderWindowOpen(args.reason);             sendJSON(res, { success: true, _hint: SCREEN_RECORDER_HINT, output: JSON.stringify({@@ -19990,8 +19982,7 @@ const server = http.createServer(async (req, res) => {           }           return;         }-        case 'pup_screen_record_start':-        case 'desktop_record_start': {+        case 'pup_screen_record_start': {           try {             const r = await desktopRecordStartImpl(args);             sendJSON(res, { success: true, _hint: SCREEN_RECORDER_HINT, output: JSON.stringify({ ok: true, ...r })});@@ -20000,8 +19991,7 @@ const server = http.createServer(async (req, res) => {           }           return;         }-        case 'pup_screen_record_stop':-        case 'desktop_record_stop': {+        case 'pup_screen_record_stop': {           try {             const r = await desktopRecordStopImpl(args);             sendJSON(res, { success: true, _hint: SCREEN_RECORDER_HINT, output: JSON.stringify({ ok: true, ...r })});@@ -20010,8 +20000,7 @@ const server = http.createServer(async (req, res) => {           }           return;         }-        case 'pup_screen_record_status':-        case 'desktop_record_status': {+        case 'pup_screen_record_status': {           const cur = desktopRecorder.current;           const status = {             ok: true,@@ -20029,15 +20018,13 @@ const server = http.createServer(async (req, res) => {           sendJSON(res, { success: true, _hint: SCREEN_RECORDER_HINT, output: JSON.stringify(status) });           return;         }-        case 'pup_screen_record_list':-        case 'desktop_record_list': {+        case 'pup_screen_record_list': {           sendJSON(res, { success: true, _hint: SCREEN_RECORDER_HINT, output: JSON.stringify({             ok: true, recordings: desktopRecordListImpl(),           })});           return;         }-        case 'pup_recorder_close':-        case 'desktop_recorder_close': {+        case 'pup_recorder_close': {           try {             const summary = await closeRecorderWindow();             sendJSON(res, { success: true, _hint: SCREEN_RECORDER_HINT, output: JSON.stringify({@@ -21140,7 +21127,7 @@ let FFMPEG_PATH = null; // v1.8.20: re-callable (was a boot-only IIFE). Recording verbs call it LAZILY when // FFMPEG_PATH is still null, so a user who installs ffmpeg AFTER the bridge started can // record immediately — no bridge restart needed. Re-scans cleanly each call.-const SCREEN_RECORDER_HINT = 'This is pup\'s CHROME screen-share recorder (getDisplayMedia -> WebM VP9, consent = the visible recorder HUD, system audio + mic mixing, cross-platform). Canonical names: pup_screen_record_start/stop/status/list + pup_recorder_open/close (pup-bridge#94); the desktop_record_* / desktop_recorder_* names are aliases that route to ab-core once its native recorder lands (adom-bridge#143). For a no-browser MP4 of ONE window captured in the background (occluded is fine, no picker), use ab-core\'s desktop_record_window_start/stop/status instead.';+const SCREEN_RECORDER_HINT = 'This is pup\'s CHROME screen-share recorder (getDisplayMedia -> WebM VP9, consent = the visible recorder HUD, system audio + mic mixing, cross-platform). Canonical names: pup_screen_record_start/stop/status/list + pup_recorder_open/close (pup-bridge#94). ab-core serves desktop_record_* NATIVELY since ab 2.1.36 (WGC + system audio to MP4, no browser, no picker): use that for a whole-monitor or single-window recording; use this Chrome recorder when you need the OS share picker, tab audio, WebM, or a non-Windows box.'; function detectFFmpeg() {   FFMPEG_PATH = null;   const { spawnSync } = require('child_process');