tool_start and tool_end events. The SDK provides typed helpers to parse these into readable tool event objects.
Tool event types
Each tool type has a dedicated interface with readable field names:
All share a common shape:
start (boolean), the tool-specific name field, action, result, and error.
Parse tool events
Tool names in the stream
The rawtoolName field in tool_start/tool_end events maps to tool types:
Display metadata
Every tool event includes optionaldisplay metadata from the runtime:
display.name and display.summary for UI rendering — they’re already formatted for humans.