Class AssistantEvent

tutorials/05_agentic_loop_complete.py:159–176

AI 返回的一个事件。 AI 的回复不是一次性返回的，而是一个个事件： TextDelta("让我") → TextDelta("算一下") → ToolUse("add", "2,2") → Usage(...) → Stop 这就像看直播一样，内容一点一点出来，而不是等全部完成才显示。 这叫做"流式传输"（Streaming），让用户能更快看到 AI 在干什么。 对应源码: conversation.rs:23-32

@dataclass(frozen=True)
class AssistantEvent:
    """
    AI 返回的一个事件。

    AI 的回复不是一次性返回的，而是一个个事件：
      TextDelta("让我") → TextDelta("算一下") → ToolUse("add", "2,2") → Usage(...) → Stop

    这就像看直播一样，内容一点一点出来，而不是等全部完成才显示。
    这叫做"流式传输"（Streaming），让用户能更快看到 AI 在干什么。

    对应源码: conversation.rs:23-32
    """
    event_type: str  # "text_delta" | "tool_use" | "usage" | "message_stop"
    text: str = ""
    tool_id: str = ""
    tool_name: str = ""
    tool_input: str = ""
    usage: Optional[TokenUsage] = None


class ApiClient(Protocol):