summarize_tool_calls
Summarize tool call outcomes, failures, and usage for a given session, returning per-tool counts and total token cost.
Instructions
Summarize a session's tool calls: per-tool outcomes, failures, usage.
session accepts a full session UUID, a unique UUID prefix, or
"latest" (resolved including the current session, since
summarizing "my own" live session is a valid use case here).
Returns per-tool invocation counts broken down by outcome
(ok / error / pending / in_progress), overall
totals, a main/sidechain split (tool calls made by
subagents are included and tagged, never blended in untagged),
the list of failing calls (each labeled error or rejected
for permission denials), and the session's total token/cost
usage. If this session is currently live (the most recently
active discovered session), its trailing pending calls are
labeled in_progress instead of pending. If session is
ambiguous or matches no session, returns a structured
{"error": ...} dict instead of raising. Read-only.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| session | Yes |