refactor(core): use generic package mapping for optional dependency checks

[Copilot]

The error handling in __getattr__ only checked for "fastapi" or "uvicorn" when catching ImportErrors from the server module, but ag-ui-protocol is also an optional dependency. Users attempting to use AGUIProtocolHandler without the server extras installed wouldn't receive the helpful error message.

Based on feedback, this PR refactors the implementation to use a more maintainable and scalable approach with a generic package mapping structure instead of hardcoded string checks.

Changes

• Created _OPTIONAL_PACKAGES dictionary that groups packages by their installation command
• Refactored __getattr__ to iterate through the package mapping instead of using hardcoded OR conditions
• All three server optional dependencies (fastapi, uvicorn, ag_ui) are now grouped together under their shared installation command

# Before
if "fastapi" in str(e) or "uvicorn" in str(e):

# After
_OPTIONAL_PACKAGES = {
    "agentrun-sdk[server]": ["fastapi", "uvicorn", "ag_ui"],
}

error_str = str(e)
for install_cmd, package_names in _OPTIONAL_PACKAGES.items():
    for package_name in package_names:
        if package_name in error_str:
            raise ImportError(...)

Benefits

• More Maintainable: Adding new optional dependencies only requires adding to the appropriate list
• More Scalable: Can easily extend to other optional dependency groups in the future
• Cleaner Code: Eliminated long if-condition with multiple OR checks
• Better Organization: Packages grouped by their installation command, showing clear relationships
• More Compact: Multiple packages sharing the same install command are grouped together

All three optional dependencies in the server extras (fastapi, uvicorn, ag-ui-protocol) are properly detected, and users get consistent error messages directing them to pip install agentrun-sdk[server].

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[OhYee]

未来可能会有更多的情况，使用更加通用的方式

packages = [
   ["引入错误的的包名"，"安装使用的报名"]
]

所有 import 均使用新方式引入
所有的直接依赖均在 packages 注册

[Copilot]

未来可能会有更多的情况，使用更加通用的方式

已实现通用的包映射方式。创建了 _OPTIONAL_PACKAGES 列表来维护 (导入错误包名, 安装包名) 的映射关系，并重构了 __getattr__ 函数使用循环检查。这样未来添加新的可选依赖会更加方便和可维护。

Implemented a generic package mapping approach. Created _OPTIONAL_PACKAGES list to maintain (import_error_name, install_name) mappings, and refactored __getattr__ to use iteration. This makes it easier to add new optional dependencies in the future.

Commit: 54bb23b

[OhYee]

_OPTIONAL_PACKAGES 是否可以合并同一个命令的包

[Copilot]

_OPTIONAL_PACKAGES 是否可以合并同一个命令的包

已优化为字典结构，将使用相同安装命令的包合并在一起。现在的结构为 {install_cmd: [package_names]}，这样更清晰地表达了安装命令与包之间的关系。

Optimized to a dictionary structure that groups packages with the same installation command. The new structure is {install_cmd: [package_names]}, which more clearly expresses the relationship between installation commands and packages.

Commit: 3e95d91