docs(examples): add reference browser tool definitions for custom tools

[lawrencechen98]

Problem

#364 lets a caller serve its own tools through N2ComputerAgent(tools=[...]), but left the reader to invent the definitions. The shape is easy to get subtly wrong — a schema the server rejects, or one the model reads as something other than what the adapter implements.

Change

examples/browser_tools.json: the eight browser tools the feature was evaluated with, in the shape the API expects.

• navigation — goto_url, go_back, go_forward, refresh
• DOM — extract_elements, find, set_element_value, execute_js

tools = json.loads(Path("examples/browser_tools.json").read_text())
agent = N2ComputerAgent(computer=computer, completions=..., model=..., tools=tools)

These are ordinary caller tools — nothing here is served by the built-in tool set. The adapter implements run_custom_tool(name, arguments); the agent handles routing, results and frames.

Data and docs only. Nothing imports the file, and no runtime behaviour changes.

Notes for the reviewer

Two things worth a look, since this is a public repo:

• It documents a shape as supported. The API does not implement these tools — the caller does — but shipping them as an official example may read as a support commitment. Happy to swap in a generic single-tool example if that is the wrong signal.
• set_element_value is not independently useful. Its ref argument only means something alongside extract_elements, which issues the references. The README says to serve the subset you implement; the DOM four travel together in practice.

Generated from the praxis navigator constants the evaluation actually served, so the file cannot drift from what was measured.

Testing

920 passed, 3 skipped on the full suite; the JSON parses and carries all eight definitions.

🤖 Generated with Claude Code

https://claude.ai/code/session_01PHkcDvvjaw6TNukT99af2o

---

Note

Low Risk
Docs and static JSON only; no production code paths or behavioral changes.

Overview
Adds examples/browser_tools.json, a copy-pasteable set of eight OpenAI-style function tool schemas for browser control via N2ComputerAgent(tools=[...]): navigation (goto_url, go_back, go_forward, refresh) and DOM helpers (extract_elements, find, set_element_value, execute_js).

examples/README.md gains a browser_tools.json section that explains these are caller-defined tools (adapter implements run_custom_tool, not built-in model tools), shows loading the JSON into the agent, and notes you can ship only the tools your adapter supports.

Documentation and example data only — nothing imports the file and runtime behavior is unchanged.

^{Reviewed by Cursor Bugbot for commit 70417d1. Bugbot is set up for automated code reviews on this repo. Configure here.}