pkg/

Package dao 按对话、Session、Turn、Item 读写存储，读和写分成 Query、Mutation 两组接口。

Package hook 运行用户配置的 hook：按事件找出命中的 hook，在事件所在的 Executor 上并行运行， 解析它们的输出并合并成一个决定。

Package mcpclient 定义 MCP server 配置，在执行环境的工作区里连接 MCP server，并经客户端连接转发客户端侧 MCP server 的消息。

Package prompt 生成发给模型的内置提示文本：系统提示里的各个块、工具说明，以及插进对话的通知。

Package runtime 提供一个进程内 OpenVaala 的公开根入口：按 ConversationID 路由多个对话并订阅其事件。

Package runtimeprotocol 是 serve 与客户端共用的 OpenVaala 线上协议类型、方法表和通知表。

Package runtimeserver 是 Runtime 外层的网络协议宿主：把 WebSocket 连接上的 JSON-RPC 请求转换为 Runtime 公开调用， 并把订阅事件推送为通知。

Package skill 解析通用 Agent Skills 格式（SKILL.md），按目录优先级生成去重、排序的 skill 目录， 显式引用时由 Session 读取正文；模型也可按 Path 用通用工具读取。

Package storage 定义 JSON 记录和追加日志的读写接口。

Package telemetry 是全项目统一的遥测出口：trace、指标与日志经同一条管道写出，实体身份经 ctx 下传。

Package terminal 管一个 Session 里后台命令的进程、输出、输入、时限和容量，不认识模型和 JSON。

Package turn 执行一轮 Agent，并保存输入、输出和本轮状态。

Package workspace 定义执行环境工具用的工作区：按路径读写文件、启动进程。