描述新工具推荐使用的统一执行结果格式。

skill package 结构或元数据不合法时抛出的异常。

描述工具静态元信息。 它回答的是“这个工具叫什么、做什么、属于哪类、需要什么输入”。

工作记忆管理类。

跟踪最近动作，用于判断是否出现“连续重复”。

非法任务状态迁移。

面向主循环的轻量控制台日志接口。 这个类不维护复杂状态，只负责把主循环中的事件输出整理成统一格式。 这样 orchestration 可以更专注于“发生了什么”，而不是“怎么打印出来”。

描述工具实例共享的运行时上下文。 所有工具都共享同一个 workspace 和 system_name，确保它们对执行环境的理解一致。

模型返回的一次结构化动作。

一次程序运行期间共享的总状态容器。 `Runtime` 不是业务对象本身，而是 orchestration 层的“上下文背包”： 主循环、执行器、验证器、工具系统都会从这里取自己需要的共享依赖。

工作记忆中的单步记录。 一条记忆通常由三部分组成： - step: 第几步 - tool_call: 调用了什么 - result: 得到了什么结果

工作记忆里保存的“某一步做了什么调用”。

管理本次运行内的 session memory。

从目录化 skill package 中加载出的 skill 定义。

加载和查询目录化 skill package。

任务卡片。 可以把它理解成 Planner 与 Executor 之间共享的最小任务契约： Planner 负责生成和调整任务卡片，Executor/Validator 则围绕这张卡片推进。

待办事项列表管理类。

集中处理参数校验和结果归一化的工具基类。 子类只需要声明 spec 并实现 run()，不必重复编写公共控制流。

把命令执行能力适配到统一工具协议。 这个工具虽然名字叫 `bash`，但实际目标是提供一个“通用命令执行入口”。 在 Windows 环境下，它会优先通过 PowerShell 执行命令；在类 Unix 环境下，则通过 bash 执行命令。这样能尽量贴近当前平台的默认用法，

按 replacement 列表顺序修改文件内容。

封装 glob 搜索，并把文件与目录分别返回。

在文件或目录树中搜索文本，优先复用 ripgrep 的忽略规则。

默认按行分段读取，也支持显式指定行范围。

为固定内置工具提供渲染、实例化和执行能力。

统一封装覆盖、追加和仅创建三种写入模式。