Observability and state tools
Bounded observations
BrowserMesh maintains per-page bounded ring buffers. Reads remain explicitly addressed and follow the session queue.
| Tool | Event types |
|---|---|
browser_console_list | console level and optional redacted text |
browser_page_errors_list | page error and optional redacted text |
browser_network_list | request and response metadata |
browser_failed_requests_list | failed-request metadata |
All accept sessionId, pageId, optional timeoutMs, optional sinceEventId, and optional limit (maximum 200). Console and page-error tools also accept includeText (default false).
Results contain events, nextCursor, droppedCount, and gap. Event URLs remove credentials/fragments and redact sensitive query values. Headers, bodies, cookies, raw stacks, and console object serialization are excluded.
Persisted state
| Tool | Input | Output |
|---|---|---|
browser_state_save | sessionId, stateId | safe state metadata |
browser_state_list | none | logical IDs and creation times |
browser_state_remove | stateId | removed: true |
Restore state by passing stateId to browser_session_create. BrowserMesh never returns state contents or accepts a caller-controlled path.
Saving is serialized with the live session. This makes the order deterministic:
navigate → fill → state_save → clickThe stored state represents browser state at the accepted save position.