browser_execute: standardize parameter descriptions and tool prose

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.

Author: bcode

packages/bcode-browser/src/browser-execute.ts

@@ -56,14 +56,14 @@ const MAX_TIMEOUT_MS = 10 * 60 * 1000
 export const parameters = Schema.Struct({
   code: Schema.String.annotate({
     description:
-      "JavaScript source. Wrapped in an async function with `session` (CDP Session) and `console` (per-call capture; same `log/error/warn/info` API) bound.",
+      "The JavaScript snippet to execute. `session` (CDP Session) and `console` are in scope; see browser-execute-guide.md for the snippet model.",
   }),
   timeout: Schema.optional(Schema.Number).annotate({
-    description: `Timeout in milliseconds. Default ${DEFAULT_TIMEOUT_MS}, max ${MAX_TIMEOUT_MS}.`,
+    description: `Optional timeout in milliseconds (default ${DEFAULT_TIMEOUT_MS}, max ${MAX_TIMEOUT_MS})`,
   }),
   description: Schema.String.annotate({
     description:
-      "Clear, concise summary of what this snippet does in 3-7 words. Examples:\nInput: code that connects to local Chrome\nOutput: Connect to local Chrome\n\nInput: scrape product titles from current page\nOutput: Scrape product titles\n\nInput: capture a screenshot of the homepage\nOutput: Screenshot homepage",
+      "Clear, concise description of what this snippet does in 3-7 words. Examples:\nInput: code that connects to local Chrome\nOutput: Connect to local Chrome\n\nInput: scrape product titles from current page\nOutput: Scrape product titles\n\nInput: capture a screenshot of the homepage\nOutput: Screenshot homepage",
   }),
 })
 

packages/opencode/src/tool/browser-execute.txt

@@ -1,7 +1,7 @@
-Executes JavaScript in a connected browser.
+Executes JavaScript in a browser via CDP.
 
 Usage:
 - Use this tool whenever the task requires driving a real browser.
 - Use this tool to read webpages that block the webfetch tool.
 - IMPORTANT: you MUST use the Read tool first to read `{{SKILLS_DIR}}/browser-execute-guide.md`. This tool will fail if you did not read these directions first.
-- Always pass a clear, precise, and low verbosity `description` of what the JS snippet does.
+- Returns console output from the snippet; screenshots taken attach automatically as images.