trace_pin_session

[analysis]

Pins or unpins a stored GliderTrace session. Retention never deletes a pinned session.

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
sessionIdstringYesTrace session id, for example trc_20260507_123044_ab12cd34.
pinnedbooleanNoSet to true to pin the session, or false to unpin it. Defaults to true.

Examples

Keep a baseline session

Request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "trace_pin_session",
    "arguments": {
      "sessionId": "trc_20260507_123044_ab12cd34",
      "pinned": true
    }
  }
}

Response Notes

Returns the pin state, whether the change was applied, and the pinned bytes against the pinned-bytes quota.

↑/↓ NavigateEnter OpenSpace Expand