会话工具

目标：小型、不易误用的工具集，使代理可以列出会话、获取历史并向另一会话发送。

工具名称

• sessions_list
• sessions_history
• sessions_send
• sessions_spawn

键模型

• 主直聊桶的键恒为字面量 "main"（解析为当前代理的主 key）。
• 群聊使用 agent:<agentId>:<channel>:group:<id> 或 agent:<agentId>:<channel>:channel:<id>（传入完整 key）。
• 定时任务使用 cron:<job.id>。
• 钩子使用 hook:<uuid>（除非显式设置）。
• 节点会话使用 node-<nodeId>（除非显式设置）。

global 与 unknown 为保留值，不会出现在列表中。若 session.scope = "global"，在所有工具中将其别名为 main，调用方不会看到 global。

sessions_list

将会话以行数组列出。参数：kinds?（过滤）、limit?、activeMinutes?、messageLimit?。行为：messageLimit > 0 时会为每会话获取 chat.history 并包含最后 N 条消息；列表输出中会过滤掉工具结果；使用 sessions_history 获取工具消息。在沙箱代理会话中运行时，会话工具默认仅对衍生会话可见。行结构（JSON）：key、kind、channel、displayName、updatedAt、sessionId、model、contextTokens、totalTokens 等；messages? 仅在 messageLimit > 0 时存在。

sessions_history

获取指定会话的对话历史。参数与行为见英文文档。

sessions_send

向指定会话键发送消息。参数与行为见英文文档。

sessions_spawn

衍生新会话或向衍生会话发送。参数与行为见英文文档。沙箱内默认仅可访问衍生会话（spawned-only visibility）。完整 API 与参数见英文 Session Tool 文档。