browser_execute: docs cleanup + parameter description standardization#55
Merged
Conversation
added 4 commits
May 10, 2026 17:42
Providers stream tool-call args in schema-declared order, so a leading description field commits the model to a stated intent before code generation. Matches the shell tool's command-first, description-last shape.
Renames the primary browser_execute guide and updates every code/doc reference. The file's role is the same; the name now states what it documents.
Single skill file is sufficient: agent can derive stop/swap behavior from the inline Way 3 example plus the BU API docs link. Rewrites guide intro and Way sections for concision, adds runtime self-discovery hints (Object.keys(session.domains), CdpError.data) so the agent can probe the CDP surface without docs round-trip. Updates README, src/index.ts, src/skills.ts, opencode comment, and skills test to drop cloud-browser.md references.
Aligns annotation style with the shell tool: code mentions the snippet model and points at the guide; timeout uses the canonical 'Optional X (default Y, max Z)' format; description swaps 'summary' for 'description' to match the field name. Tool top-line tightened and a Returns bullet added in browser-execute.txt.
![cubic-dev-ai[bot]](https://avatars.githubusercontent.com/in/1082092?s=60&v=4){kind=small}
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
1 participant
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.
Summary
browser_executetool surface cleanup. No behavior changes.1e264bcd8):code->timeout?->description, matching the shell tool. Prevents the model from being walled into a stated intent before reading the snippet.85fc1d339):BROWSER.md->browser-execute-guide.md. Old name was generic; new name signals what the file is for.6119a41fa): Dropscloud-browser.md; Way 3 (provision/stop a BU cloud browser via raw HTTP) now lives in the main guide. Adds runtime self-discovery hints (Object.keys(session.domains),CdpError.datafor missing-field detail) and makes Way 4 (env-preconfiguredBU_CDP_WS/BU_CDP_URL) explicit.2aa3e2ae7): Annotation style aligned with the shell tool.codepoints at the guide for the snippet model;timeoutuses the canonical "Optional X (default Y, max Z)" format;descriptionmatches its own field name.Net: -266 / +80 lines across the guide + supporting files. Embedded skills payload shrinks ~5 KB (cloud-browser.md removed).