Observe Executable Examples

Observe Executable Examples

Each section provides one runnable baseline call, expected response shape, and one failure example with a concrete fix. Use these as copy/paste starters and then adjust for your page or workflow.

Quick Reference

{
  "tool": "observe",
  "arguments": {
    "what": "errors"
  }
}

Common Parameters

Parameter	Type	Description
what	string	Mode name to execute.
tab_id	number	Optional target browser tab.
telemetry_mode	string	Optional telemetry verbosity: off, auto, full.

Modes

errors

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "errors"
  }
}

Expected response shape

{
  "what": "errors",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. errors.

logs

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "logs"
  }
}

Expected response shape

{
  "what": "logs",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. logs.

extension_logs

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "extension_logs"
  }
}

Expected response shape

{
  "what": "extension_logs",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. extension_logs.

network_waterfall

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "network_waterfall"
  }
}

Expected response shape

{
  "what": "network_waterfall",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. network_waterfall.

network_bodies

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "network_bodies",
    "url": "/api",
    "status_min": 400
  }
}

Expected response shape

{
  "what": "network_bodies",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "network_bodies",
    "url": 404,
    "status_min": 400
  }
}

Fix: Use a fully qualified URL string, e.g. https://example.com.

websocket_events

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "websocket_events",
    "last_n": 20
  }
}

Expected response shape

{
  "what": "websocket_events",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode",
    "last_n": 20
  }
}

Fix: Use a valid observe mode value, e.g. websocket_events.

websocket_status

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "websocket_status"
  }
}

Expected response shape

{
  "what": "websocket_status",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. websocket_status.

actions

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "actions"
  }
}

Expected response shape

{
  "what": "actions",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. actions.

vitals

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "vitals"
  }
}

Expected response shape

{
  "what": "vitals",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. vitals.

page

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "page"
  }
}

Expected response shape

{
  "what": "page",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. page.

tabs

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "tabs"
  }
}

Expected response shape

{
  "what": "tabs",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. tabs.

history

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "history"
  }
}

Expected response shape

{
  "what": "history",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. history.

pilot

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "pilot"
  }
}

Expected response shape

{
  "what": "pilot",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. pilot.

timeline

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "timeline"
  }
}

Expected response shape

{
  "what": "timeline",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. timeline.

error_bundles

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "error_bundles"
  }
}

Expected response shape

{
  "what": "error_bundles",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. error_bundles.

screenshot

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "screenshot",
    "full_page": true
  }
}

Expected response shape

{
  "what": "screenshot",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode",
    "full_page": true
  }
}

Fix: Use a valid observe mode value, e.g. screenshot.

storage

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "storage"
  }
}

Expected response shape

{
  "what": "storage",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. storage.

indexeddb

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "indexeddb"
  }
}

Expected response shape

{
  "what": "indexeddb",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. indexeddb.

command_result

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "command_result",
    "correlation_id": "cmd_123"
  }
}

Expected response shape

{
  "what": "command_result",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode",
    "correlation_id": "cmd_123"
  }
}

Fix: Use a valid observe mode value, e.g. command_result.

pending_commands

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "pending_commands"
  }
}

Expected response shape

{
  "what": "pending_commands",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. pending_commands.

failed_commands

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "failed_commands"
  }
}

Expected response shape

{
  "what": "failed_commands",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. failed_commands.

saved_videos

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "saved_videos"
  }
}

Expected response shape

{
  "what": "saved_videos",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. saved_videos.

recordings

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "recordings"
  }
}

Expected response shape

{
  "what": "recordings",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. recordings.

recording_actions

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "recording_actions",
    "recording_id": "rec_123"
  }
}

Expected response shape

{
  "what": "recording_actions",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "recording_actions",
    "recording_id": 123
  }
}

Fix: Use recording_id as a string like rec_123.

playback_results

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "playback_results",
    "recording_id": "rec_123"
  }
}

Expected response shape

{
  "what": "playback_results",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "playback_results",
    "recording_id": 123
  }
}

Fix: Use recording_id as a string like rec_123.

log_diff_report

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "log_diff_report",
    "original_id": "rec_123",
    "replay_id": "rec_456"
  }
}

Expected response shape

{
  "what": "log_diff_report",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode",
    "original_id": "rec_123",
    "replay_id": "rec_456"
  }
}

Fix: Use a valid observe mode value, e.g. log_diff_report.

summarized_logs

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "summarized_logs"
  }
}

Expected response shape

{
  "what": "summarized_logs",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. summarized_logs.

page_inventory

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "page_inventory"
  }
}

Expected response shape

{
  "what": "page_inventory",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. page_inventory.

transients

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "transients"
  }
}

Expected response shape

{
  "what": "transients",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. transients.

inbox

Minimal call

{
  "tool": "observe",
  "arguments": {
    "what": "inbox"
  }
}

Expected response shape

{
  "what": "inbox",
  "items": [
    {
      "id": "sample",
      "summary": "...mode-specific payload..."
    }
  ],
  "metadata": {
    "limit": 100,
    "next_cursor": "cursor_123"
  }
}

Failure example and fix

{
  "tool": "observe",
  "arguments": {
    "what": "not_a_real_mode"
  }
}

Fix: Use a valid observe mode value, e.g. inbox.