trace_list_sessions

[analysis]

Lists stored GliderTrace sessions from the local session index, with filters for mode, status, label, and start time.

Why this tool exists

Stored runtime sessions need query, comparison, and export tools so agents can work from bounded evidence.

How it helps the agent

The model can inspect, compare, and package evidence without rereading raw logs or artifacts.

Try it locally in the GliderTrace playground

Parameters

NameTypeRequiredDescription
modestringNoOptional session mode filter: 'run', 'test', 'build', 'restore', 'attach', 'dump', 'gcdump', or 'import'.
statusstringNoOptional session status filter: 'created', 'running', 'completed', 'failed', 'timeout', or 'cancelled'.
labelstringNoOptional label filter. The value must be the whole stored label. Letter case is ignored.
sincestringNoOptional ISO 8601 date and time. Only sessions that started at or after this time are returned.
limitnumberNoMaximum number of sessions to return. Clamped to 1..200. Defaults to 50.
cursorstringNoPagination cursor returned by a previous call.

Examples

Find a labelled baseline run

Request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "trace_list_sessions",
    "arguments": {
      "label": "nightly-baseline"
    }
  }
}

Response Notes

Returns session id, mode, status, exit code, start and end times, byte size, pinned state, and label, with a pagination cursor.

↑/↓ NavigateEnter OpenSpace Expand