browser

Drive a real browser: open a page, act on it, read regions of it. Separate from web on purpose. web is for searching and fetching the public web; browser holds a session and can change pages, so it is its own capability grant.

Property	Value
Module id	browser
Version	1.0.0
Tools	open, act, read

Configuration

yaml

tools:
  modules:
    browser:
      config:
        actions: ask      # ask (default) | free | none
        profile: false    # true = user's visible login profile

• ask - navigate and fill freely, stop before committing actions
• free - run anything (for pages you own)
• none - look only, never touch

Tools

Tool	Purpose
open	Open a URL and return a page model (elements with ref).
act	Run interactions (click, type, ...) then return what changed. Use approved: true only after the user confirmed a committing action.
read	Read main content or a region by ref.

web.fetch can also drive page actions when you need search/fetch in the same module; prefer browser when the app's capability story is "this agent may drive a browser".