PromptShuttle
get_run
Gets the full debugging detail of a single run (a ShuttleRequest / LLM invocation) by ID. Use list_runs to find run IDs, then this to inspect one. Returns: run metadata (status, model, timing, cost, agent-tree position, callback origin); the per-iteration inference requests and provider responses (model, provider, timing, token usage, assistant text, tool calls); one row per tool call naming the endpoint it was actually placed against and where that origin came from (tool / environment / callback); the resolved conversation (system/user prompts plus tool calls and their results); any errors (including tool calls that returned an HTTP error to the model); the immediate child agent runs (for agentic flows — call get_run on a child ID to drill down); and feedback. Optionally include the streaming event timeline. IMPORTANT: check Run.Outcome, not Run.Status — a run that answered while every tool call returned 502 is Status=Succeeded but Outcome=succeededWithWarnings, and Run.Warnings says why. Outcome is one of: running, cancelling, cancelled, succeeded, succeededWithWarnings, failed. 'cancelled' means somebody stopped the run and its answer is partial; 'running' means it is still executing and can be stopped with cancel_run. Run.Progress appears only when the flow opted into verification: a verifier model graded how far the run got (Score, 0-1) and how sure it was (Certainty, 0-1), with Lowest being the worst reading. Its ABSENCE means unscored, never a score of zero. Do not compare scores across runs with different Verifier values. Run.DetailDropped is true when the tenant's sample rate skipped persisting this run's prompt/response text — metadata is still here, Conversation and assistant text are not.
Remote (network-hosted) · Needs a self-provisionable API key
Other tools also called get_run?
See providers with this name
Input Schema
{
"type": "object",
"properties": {
"runId": {
"description": "Run ID (ShuttleRequest ObjectId), e.g. an Id returned by list_runs",
"type": "string"
},
"includeMessages": {
"description": "Include the resolved conversation (prompts, tool calls and their results). Default true; set false for a lighter summary.",
"type": "boolean",
"default": true
},
"includeEvents": {
"description": "Include the streaming event timeline (agent/tool started/completed/failed events). Default false; can be verbose on large agent trees.",
"type": "boolean",
"default": false
},
"maxFieldLength": {
"description": "Max characters per large text field (message text, tool results, error bodies) before truncation. Default 4000; raise to inspect full payloads.",
"type": "integer",
"default": 4000
}
},
"required": [
"runId"
]
}