Skip to content

Commit 3ab4b9b

Browse files
Refresh stale OOPIF flow notes in CDP docs
Co-authored-by: Shri Sukhani <shrisukhani@users.noreply.github.com>
1 parent 1cba1fb commit 3ab4b9b

2 files changed

Lines changed: 7 additions & 6 deletions

File tree

currentState.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -163,6 +163,7 @@ HyperAgent exposes a TypeScript SDK for browser automation with three primary pa
163163
- guard trap-prone `page.context`, `context.newCDPSession`, `page.frames`, and `page.mainFrame` reads,
164164
- short-circuit gracefully when required APIs are unavailable,
165165
- emit sanitized diagnostics in debug logs for getter/method trap failures.
166+
- Refreshed stale CDP deep-dive flow notes that previously described OOPIF capture as incomplete; docs now reflect the current runtime OOPIF discovery + map-sync + multi-frame accessibility capture flow.
166167
- Hardened A11y DOM option ingestion (`useCache`, `onFrameChunk`, `filterAdTrackingFrames`) with trap-safe reads, so malformed option objects no longer break extraction setup.
167168
- Hardened A11y DOM debug-option lookup (`getDebugOptions`) with trap-safe fallback defaults and sanitized warning diagnostics.
168169
- Hardened OpenAI/Anthropic structured-schema debug-option reads so trap-prone debug-option access no longer interrupts structured invocation paths.

docs/cdp-overview.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2885,14 +2885,14 @@ From ensureInitialized (Phase 1):
28852885
backendNodeId: 123,
28862886
sessionId: "oopif-sess" } ✅ Has separate session
28872887
2888-
Status: ❌ INCOMPLETE - Need Phase 3 to get OOPIF content
2889-
→ captureOOPIFs will call buildBackendIdMaps(oopifSession)
2888+
Status: ✅ COMPLETE - OOPIF content is captured in runtime flow
2889+
→ captureOOPIFs discovers per-frame sessions, then buildBackendIdMaps(oopifSession, pierce: false) materializes OOPIF maps
28902890
28912891
────────────────────────────────────────────────────────────────
2892-
NEXT STEPS:
2893-
1. Phase 3: Fetch OOPIF content via their separate CDP sessions
2894-
2. Phase 4: syncFrameContextManager to populate missing frameIds
2895-
3. Phase 5: Fetch accessibility trees for all frames
2892+
CURRENT FLOW:
2893+
1. OOPIF discovery creates/refreshes per-frame sessions (with optional ad/tracking filtering).
2894+
2. Frame graph sync backfills frame IDs/execution-context state from discovered sessions.
2895+
3. Accessibility tree + map capture runs across main frame, same-origin iframes, and discovered OOPIF sessions.
28962896
```
28972897

28982898
---

0 commit comments

Comments
 (0)