Class ConversationRuntime

tutorials/05_agentic_loop_complete.py:232–386

对话运行时 —— 把 API、工具、权限、Session 全部组合在一起。 这就是 Claude Code 的核心引擎。 对应源码: conversation.rs:100-168 在 Rust 源码里它是泛型的：ConversationRuntime C = ApiClient 类型, T = ToolExecutor 类型 Python 里我们直接用 Protocol，效果一样。

class ConversationRuntime:
    """
    对话运行时 —— 把 API、工具、权限、Session 全部组合在一起。

    这就是 Claude Code 的核心引擎。
    对应源码: conversation.rs:100-168

    在 Rust 源码里它是泛型的：ConversationRuntime<C, T>
    C = ApiClient 类型, T = ToolExecutor 类型
    Python 里我们直接用 Protocol，效果一样。
    """

    def __init__(
        self,
        session: Session,
        api_client: ApiClient,
        tool_executor: ToolExecutor,
        permission_policy: PermissionPolicy,
        system_prompt: list[str],
        max_iterations: int = 10,
    ):
        self.session = session
        self.api_client = api_client
        self.tool_executor = tool_executor
        self.permission_policy = permission_policy
        self.system_prompt = system_prompt
        self.max_iterations = max_iterations
        self.usage_tracker = UsageTracker()

    def run_turn(
        self,
        user_input: str,
        prompter: Optional[PermissionPrompter] = None,
    ) -> TurnSummary:
        """
        执行一个完整的对话轮次。

        这就是 Tutorial 01 里的 run_turn，但现在是完整版！

        对应源码: conversation.rs:170-283
        """
        # 步骤 1: 添加用户消息
        self.session.messages.append(ConversationMessage.user_text(user_input))

        assistant_messages: list[ConversationMessage] = []
        tool_results: list[ConversationMessage] = []
        iterations = 0

        # 步骤 2: Agentic Loop
        while True:
            iterations += 1
            if iterations > self.max_iterations:
                raise RuntimeError("exceeded maximum iterations")

            # 步骤 2a: 调用 API
            request = ApiRequest(
                system_prompt=self.system_prompt,
                messages=self.session.messages,