docs(browser): document six browser tools and enablement gates

README.md

@@ -519,6 +519,33 @@ hooks:
     - notify
 ```
 
+## Browser Automation Tools
+
+Flynn ships six browser tools:
+
+- `browser.navigate`
+- `browser.screenshot`
+- `browser.click`
+- `browser.type`
+- `browser.content`
+- `browser.eval`
+
+These tools are backed by a Puppeteer/CDP browser manager and are only registered when `browser.enabled: true`.
+They can still be filtered out by tool policy (`tools.profile`, `tools.allow`, `tools.deny`).
+
+```yaml
+browser:
+  enabled: true
+  headless: true
+  max_pages: 5
+  default_timeout: 30000
+  # executable_path: /usr/bin/google-chrome
+  # ws_endpoint: ws://127.0.0.1:9222/devtools/browser/<id>
+
+tools:
+  profile: coding  # or full
+```
+
 ## Cron Scheduling
 
 Schedule automated messages on cron schedules. Each job fires an inbound message through the agent pipeline and routes the response to a configured output channel.