Adom Bridge

@@ -111,7 +111,7 @@ Anything Adom Bridge can see, it can screenshot, losslessly, with **no focus ste 
 Adom Bridge records a monitor or a single window to an **MP4**, on your machine, with the system audio mixed in — native Windows Graphics Capture + Media Foundation, hardware-encoded (NVENC / Quick Sync / AMD) with the frames kept on the GPU end to end. A 4 by 4 pixel teal square sits in a screen corner for the whole take, so a recording can never run with nothing on screen; it is small enough to survive the 10x speed-up clips usually get. The Orbital Lab mark is available separately as `desktop_orbital` when you want something people can see. Choose **H.264** (default, plays everywhere) or **H.265/HEVC** for roughly **half the file size**; `desktop_record_encoders` lists what your machine can hardware-encode. Verbs: `desktop_record_start` / `desktop_record_stop` / `desktop_record_status`; `pup_record_start` / `pup_record_stop` for a pup browser session. Built for smooth, high-frame-rate video, not a choppy screenshot loop.
 
-Deep dive on the recorder and the H.264/H.265 codec choice: [recording](docs/recording.md).
+Deep dive on the recorder and the H.264/H.265 codec choice: [recording](docs/recording.md). **The defaults are tuned for the AI that never picks an option:** Windows only hands over a frame when the screen changes, so a still screen costs almost nothing (a 9.5 s still take is 7 frames and 0.2 MB) while the encoded length stays exact, and the default rate control is a generous variable bit rate with a peak, so fast motion stays sharp instead of smearing against a cap. Five example takes with the numbers: [how a take spends its bits](docs/recording.md).
 
 ## Bridges
 

@@ -439,7 +439,7 @@ <p>Anything Adom Bridge can see, it can screenshot, losslessly, with <strong>no focus steal</strong> (<code>PrintWindow</code> or full-screen DXGI, never a foreground grab). <em>Every image on this page was produced by these verbs.</em> <code>desktop_screenshot_window</code> returns a <strong><code>screenshots[]</code> array</strong>: the window plus each owned popup or child dialog as its own image (so a confirm bubble hovering over an app comes back alongside the parent, never missed); <code>desktop_screenshot_screen</code> grabs the full virtual screen including borderless popups; <code>pup_screenshot</code> grabs the pup viewport. Every shot carries a <strong><code>coordMap</code></strong> so the AI clicks <em>what it sees</em> (<code>{space:"image", shotId, x, y}</code> to real screen px, no DPI math). It stays generic: Adom Bridge returns the rich array, the AI decides. <code>ad_scroll</code> even lets the AI page Adom Bridge's own window to capture content below the fold.</p>
 <h2>Recording</h2>
 <p>Adom Bridge records a monitor or a single window to an <strong>MP4</strong>, on your machine, with the system audio mixed in — native Windows Graphics Capture + Media Foundation, hardware-encoded (NVENC / Quick Sync / AMD) with the frames kept on the GPU end to end. A 4 by 4 pixel teal square sits in a screen corner for the whole take, so a recording can never run with nothing on screen; it is small enough to survive the 10x speed-up clips usually get. The Orbital Lab mark is available separately as <code>desktop_orbital</code> when you want something people can see. Choose <strong>H.264</strong> (default, plays everywhere) or <strong>H.265/HEVC</strong> for roughly <strong>half the file size</strong>; <code>desktop_record_encoders</code> lists what your machine can hardware-encode. Verbs: <code>desktop_record_start</code> / <code>desktop_record_stop</code> / <code>desktop_record_status</code>; <code>pup_record_start</code> / <code>pup_record_stop</code> for a pup browser session. Built for smooth, high-frame-rate video, not a choppy screenshot loop.</p>
-<p>Deep dive on the recorder and the H.264/H.265 codec choice: <a href="https://wiki.adom.inc/adom/adom-bridge/files/docs/recording.md">recording</a>.</p>
+<p>Deep dive on the recorder and the H.264/H.265 codec choice: <a href="https://wiki.adom.inc/adom/adom-bridge/files/docs/recording.md">recording</a>. <strong>The defaults are tuned for the AI that never picks an option:</strong> Windows only hands over a frame when the screen changes, so a still screen costs almost nothing (a 9.5 s still take is 7 frames and 0.2 MB) while the encoded length stays exact, and the default rate control is a generous variable bit rate with a peak, so fast motion stays sharp instead of smearing against a cap. Five example takes with the numbers: <a href="https://wiki.adom.inc/adom/adom-bridge/files/docs/recording.md">how a take spends its bits</a>.</p>
 <h2>Bridges</h2>
 <p>Each bridge is a small, independently-versioned process the app spawns, supervises, health-checks, and auto-updates from its own wiki page. Every install ships with the six below, and each shows up in the Bridges sidebar as a card: its billboard, a health LED, and language/source badges.</p>
 <h3>Puppeteer (<code>pup_*</code>)</h3>