refactor(langgraph): migrate to AgentRunConverter class and enhance event handling

The AgentRunConverter has been updated to use a class-based approach for better state management. The conversion functions are now static methods of the AgentRunConverter class, providing improved tool call ID consistency and event sequencing. The deprecated conversion functions have been removed from the public API.

The AGUI protocol handler has been enhanced with copilotkit compatibility mode to handle sequential tool calls and improved event ordering. New protocol configuration options have been added to support these features.

Several tests have been updated to reflect these changes, including new test files for comprehensive event handling coverage.

feat: add AGUIProtocolConfig with copilotkit compatibility option
refactor: migrate convert functions to AgentRunConverter static methods
refactor: enhance AGUI protocol handler with improved event sequencing
test: add comprehensive tests for AgentRunConverter and AGUI protocol

重构 langgraph 事件转换器以使用 AgentRunConverter 类并增强事件处理

AgentRunConverter 已更新为使用基于类的方法，以实现更好的状态管理。转换函数现在是 AgentRunConverter 类的静态方法，提供改进的工具调用 ID 一致性和事件排序。已从公共 API 中删除了已弃用的转换函数。

AGUI 协议处理器已通过 copilotkit 兼容模式增强，以处理顺序工具调用和改进的事件排序。已添加新的协议配置选项以支持这些功能。

已更新多个测试以反映这些更改，包括为全面事件处理覆盖范围添加的新测试文件。

新功能: 添加带有 copilotkit 兼容性选项的 AGUIProtocolConfig
重构: 将转换函数迁移到 AgentRunConverter 静态方法
重构: 使用改进的事件排序增强 AGUI 协议处理器
测试: 为 AgentRunConverter 和 AGUI 协议添加全面测试

Change-Id: I9e73626b3bf17d6d5af90038d0f2eb229f93dee6
Signed-off-by: OhYee <oyohyee@oyohyee.com>

Author: OhYee

agentrun/integration/langchain/__init__.py

@@ -16,20 +16,14 @@
 - agent.astream(input, stream_mode="updates") - 异步按节点输出
 """
 
-from agentrun.integration.langgraph.agent_converter import (  # 向后兼容
+from agentrun.integration.langgraph.agent_converter import (
     AgentRunConverter,
-    AguiEventConverter,
-    convert,
-    to_agui_events,
-)
+)  # 向后兼容
 
 from .builtin import model, sandbox_toolset, toolset
 
 __all__ = [
     "AgentRunConverter",
-    "AguiEventConverter",  # 向后兼容
-    "to_agui_events",  # 向后兼容
-    "convert",  # 向后兼容
     "model",
     "toolset",
     "sandbox_toolset",

agentrun/integration/langgraph/__init__.py

@@ -10,21 +10,25 @@
     ...         for item in converter.convert(event):
     ...             yield item
 
+或使用静态方法（无状态）：
+
+    >>> from agentrun.integration.langgraph import AgentRunConverter
+    >>>
+    >>> async for event in agent.astream_events(input_data, version="v2"):
+    ...     for item in AgentRunConverter.to_agui_events(event):
+    ...         yield item
+
 支持多种调用方式：
 - agent.astream_events(input, version="v2") - 支持 token by token
 - agent.stream(input, stream_mode="updates") - 按节点输出
 - agent.astream(input, stream_mode="updates") - 异步按节点输出
 """
 
-from .agent_converter import AguiEventConverter  # 向后兼容
-from .agent_converter import AgentRunConverter, convert, to_agui_events
+from .agent_converter import AgentRunConverter
 from .builtin import model, sandbox_toolset, toolset
 
 __all__ = [
     "AgentRunConverter",
-    "AguiEventConverter",  # 向后兼容
-    "to_agui_events",  # 向后兼容
-    "convert",  # 向后兼容
     "model",
     "toolset",
     "sandbox_toolset",