docs(browser): add CDP recovery boundaries#115
Open
MagMueller wants to merge 1 commit into
Open
Conversation
MagMueller
force-pushed
the
stale-proxy-guide
branch
from
July 23, 2026 21:03
9f4aaae to
8f5d2b9
Compare
MagMueller
force-pushed
the
stale-proxy-guide
branch
from
July 23, 2026 21:03
8f5d2b9 to
9a2da04
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
Two CDP failures require different recovery layers:
-32001means the attached target session is stale even when the browser socket remains usable. Reconnecting the root socket does not replace that target session.ERR_TUNNEL_CONNECTION_FAILEDbelongs to the browser proxy route. Reloading, reattaching, or reconnecting to the same endpoint preserves that route.Without this distinction, an agent can repeatedly retry the wrong layer.
Change
-32001.Page.navigate.errorTextand switch source or replace the browser after a persistent tunnel failure.Validation
bun typecheckinpackages/bcode-browsergit diff --checkSummary by cubic
Clarified CDP recovery boundaries in the browser execution skill docs to stop retries at the wrong layer. For
-32001, list targets again, reattach withsession.use(...), and retry once (note:session.connect()does not replace a stale target session); forPage.navigatewitherrorTextlike persistentERR_TUNNEL_CONNECTION_FAILED, treat it as a proxy route issue and switch source or replace the cloud browser instead of reloading, reattaching, or reconnecting.Written for commit 8f5d2b9. Summary will update on new commits.