From bf36d2b873d694b1415cd88160a8729eaaddb616 Mon Sep 17 00:00:00 2001
From: dormouse-bot <287024035+dormouse-bot@users.noreply.github.com>
Date: Sun, 2 Aug 2026 08:44:28 +0000
Subject: [PATCH] docs(agent-browser): fix RenderMode absent-default (iframe,
 not ab-screencast)

---
 lib/src/components/wall/agent-browser-screen.ts | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/lib/src/components/wall/agent-browser-screen.ts b/lib/src/components/wall/agent-browser-screen.ts
index 8045dcdc..68d6f661 100644
--- a/lib/src/components/wall/agent-browser-screen.ts
+++ b/lib/src/components/wall/agent-browser-screen.ts
@@ -31,8 +31,11 @@ export type ScreenState = 'SYNCED' | 'SCALED';
  *      becomes a stub.
  *    - `iframe`        — the page's own DOM in a proxied iframe: native + zero-lag,
  *      but loopback-only and not agent-drivable.
- *  Absent ⇒ `ab-screencast` — a surface with no explicit mode reads as a
- *  screencast. */
+ *  Absent from params ⇒ `iframe` — a surface with no explicit mode resolves to
+ *  the engine-less embed (`resolveRenderMode` in browser-surface.ts;
+ *  docs/specs/dor-browser.md → "Canonical Params"). Note this differs from the
+ *  `ScreenSnapshot.renderMode` glyph default below, which reads absent as
+ *  `ab-screencast`. */
 export type RenderMode = 'ab-screencast' | 'ab-popout' | 'iframe';
 
 export interface ScreenSnapshot {