Live Tools

Inspect live session evidence and invoke guarded app capabilities from the local host player or structured CLI.

A connected session can expose live evidence and app-owned remote tools. The local player presents the visual parts of that surface while the CLI provides precise discovery, filtering, invocation, and JSON output.

Live evidence

The player can update a selected session as the host receives:

  • screenshots and playback frames;
  • logs, exceptions, lifecycle events, and network metadata;
  • performance and custom telemetry;
  • touch input and inferred gestures;
  • visual tree snapshots and bounded-node overlays;
  • annotations and captured artifacts;
  • App Graph exploration progress and linked test traces.

Scrubbing away from the end pauses live following. Use Go live to return to the newest evidence without reconnecting the app.

App tools

Remote tools are declared by the app SDK and filtered by the app’s active guard and policy. Discover before calling:

ansight app tools <session-id> --policy read --detail summary --json
ansight app call <session-id> <tool-id> --arguments-json '{}' --json

The browser and CLI do not bypass an unavailable, denied, or higher-risk tool. Write and critical operations require explicit authorization appropriate to the workflow.

Visual trees

Captured trees are shown as searchable hierarchies with node properties. Selecting a bounded node can overlay its geometry on the corresponding screenshot. Live semantic UI commands remain available through ansight ui for agents and tests.

Disconnected state

Recorded evidence remains reviewable after an app disconnects. Live app tools, simulator control, new screenshots, and sandbox browsing require an eligible connected session and the corresponding SDK capability.