get_workspace_state
Retrieves the active notebook's current workspace state at the start of each turn, including cells, layout, chart configs, and last-run statuses, so agents know what to edit or run next.
Instructions
If notebook tools fail with BRIDGE_NOT_PAIRED, call get_pairing_credentials to begin pairing (the response includes a one-click URL to show the user; authentication runs in the browser, the bridge never sees credentials). Once paired, call get_workspace_state at the start of every notebook turn; the digest of edits since your last fetch is in get_recent_user_actions.
Return the current workspace + notebook context as text. Use this at the start of every notebook turn so you know which notebook is active, what cells exist, layout mode, chart configs, and last-run statuses. SQL/draw cells report their pane view: "editor" while there is nothing to show, else the stored result or editor_result arrangement. Their mode matches that presentation: null for editor-only, run for a table result, and draw for a chart. Markdown reports view, mode, and result_height as null. Pass include_user_events=true to also receive the digest of edits the user made since your last fetch.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_workspace_state"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| include_user_events | No |