Refactor protocol and transport modules to use type hints for improved clarity and consistency

- Updated Codec class to use abstract methods for encoding and decoding envelopes.
- Changed Envelope class to use Dict and Optional for payload and error fields.
- Refined error handling in RPCError class with Optional type hints for details.
- Enhanced manifest validation logic with type hints for better type safety.
- Improved plugin loading mechanism with consistent type annotations.
- Updated RPCClient to utilize Optional for codec and connection attributes.
- Refactored transport classes to use Optional for server attributes and socket paths.
This commit is contained in:
DrSmoothl
2026-03-11 00:07:13 +08:00
parent 7f1e79ea28
commit 69219e36f7
19 changed files with 273 additions and 253 deletions

View File

@@ -9,6 +9,8 @@
6. 转发插件的能力调用到 Host
"""
from typing import List
import asyncio
import contextlib
import inspect
@@ -43,7 +45,7 @@ class PluginRunner:
self,
host_address: str,
session_token: str,
plugin_dirs: list[str],
plugin_dirs: List[str],
) -> None:
self._host_address: str = host_address
self._session_token: str = session_token
@@ -114,7 +116,7 @@ class PluginRunner:
async def _register_plugin(self, meta: PluginMeta) -> None:
"""向 Host 注册单个插件"""
# 收集插件组件声明
components: list[ComponentDeclaration] = []
components: List[ComponentDeclaration] = []
instance = meta.instance
# 从插件实例获取组件声明SDK 插件须实现 get_components 方法)
@@ -284,7 +286,7 @@ class PluginRunner:
# ─── sys.path 隔离 ────────────────────────────────────────
def _isolate_sys_path(plugin_dirs: list[str]) -> None:
def _isolate_sys_path(plugin_dirs: List[str]) -> None:
"""清理 sys.path限制 Runner 子进程只能访问标准库、SDK 和插件目录。
防止插件代码 import 主程序模块读取运行时数据。