Class ToolEvent

src/tool_system/renderers.py:21–35

Discrete event observed by the agent loop while executing tools. ``kind`` is one of ``tool_use`` (model emitted a tool_use block), ``tool_result`` (tool returned successfully), or ``tool_error`` / ``tool_result`` with ``is_error=True`` (tool failed). The bridge layer maps these to U

@dataclass(frozen=True)
class ToolEvent:
    """Discrete event observed by the agent loop while executing tools.

    ``kind`` is one of ``tool_use`` (model emitted a tool_use block),
    ``tool_result`` (tool returned successfully), or ``tool_error`` /
    ``tool_result`` with ``is_error=True`` (tool failed). The bridge
    layer maps these to UI rendering or stream-json events.
    """
    kind: str
    tool_name: str
    tool_input: dict[str, Any] | None = None
    tool_output: Any | None = None
    tool_use_id: str | None = None
    is_error: bool = False
    error: str | None = None


@dataclass(frozen=True)