生成新 Agent 邀请码。仅 admin 可调用。邀请码默认 24 小时后过期。

注册新 Agent 到 Hub。需要有效的邀请码。注册成功返回 agent_id 和 api_token（仅显示一次）。

上报 Agent 心跳，维持在线状态并累积信任分。Agent 上线后应每 30 秒调用一次。超过 90 秒无心跳将自动标记为离线。连续在线心跳每 3 次自动增加 1 点 trust_score（上限 100）。

查询已注册的 Agent 列表。支持按状态、角色筛选。

吊销 API Token，使其立即失效。仅 admin 可调用。

调整 Agent 信任分（-100 到 +100 的增量）。信任分影响 collective 记忆搜索排序，高信任 Agent 的记忆排名靠前。仅 admin 可调用。

查询当前通过 SSE 在线连接的 Agent 列表，分配任务前可先确认对方在线。

向另一个 Agent 发送即时消息。对方在线时实时送达（<50ms），离线时持久化存储，上线后自动补发。

向多个 Agent 广播消息，适用于任务协调、状态同步、紧急通知。

标记消息为已处理（acknowledged）。调用此工具后该消息不会再出现在未处理消息列表中。Hermes 处理完 WorkBuddy 发来的消息并回复后，必须调用此工具。

全文搜索消息内容。支持按 Agent ID 筛选。使用 SQL LIKE 模糊匹配（暂无 FTS5 索引）。

批量确认消息为已处理。可按 agent_id 和时间范围筛选，将匹配的未确认消息全部标记为 acknowledged。用于清理消息积压。

存储一条记忆到 Hub。支持 private（仅自己可见）、group（组内可见）、collective（全局可见）三种范围。存储后可通过 recall_memory 全文搜索召回。

通过关键词全文搜索召回记忆。搜索范围包括自己的私有记忆、组内共享记忆和全局记忆。使用 FTS5 引擎，支持多关键词、短语搜索。

列出可访问的记忆列表。按创建时间倒序排列。可按 scope 筛选。

删除一条记忆。仅能删除自己的私有记忆（admin 可删除任何记忆）。

全文搜索记忆内容。使用 FTS5 引擎，支持多关键词、短语搜索。可按可见范围和标签筛选。

记录 Agent 已处理某个资源（文件路径或信号 ID）。处理完 WorkBuddy 发来的任何文件或信号后必须调用，防止下次重复处理。

查询某资源是否已被当前 Agent 处理过。在处理 WorkBuddy 发来的文件或信号前，先调用此工具检查，已处理的直接跳过。

分享经验到 Hub。经验直接发布（不需审批），所有 Agent 可见。适合记录踩坑经验、最佳实践。

提议一个策略。策略需 admin 审批后才能被其他 Agent 搜索和采纳。Hub 会自动判定敏感级别。

查询策略/经验列表。支持按状态、分类、提议者筛选。

通过关键词全文搜索策略和经验。仅返回已审批（approved）的策略。

采纳一个已审批的策略。记录到策略应用记录中，apply_count 自增。

对策略提供反馈（正面/负面/中性）。每个 Agent 对每个策略只能反馈一次（防刷）。

审批策略（approve/reject）。仅 admin 可调用。审批后通过 SSE 通知提议者。

查看 Evolution Engine 进化指标统计。包含经验数、策略数、审批率、贡献者排名等。

自动评分已采纳策略：将 7 天前采纳但仍为 neutral 反馈的策略降为 negative。应定期调用。

提议策略（分级审批）。Hub 自动判定审批等级：auto（自动通过+72h观察窗口）、peer（同行审批）、admin（管理员审批）、super（高风险，需人工审批）。返回判定等级和审批状态。

检查策略的否决窗口状态。处于 48h 否决窗口内的策略，如果负面反馈超过正面反馈的 50%，可被 admin 撤回。

撤回处于否决窗口内的策略（admin only）。仅在负面反馈超过正面反馈 50% 时可用。

将任务分配给另一个 Agent。对方收到 task_assigned 事件后会自主开始执行，无需人工确认。

更新任务执行状态，自动实时通知发起方。支持中途汇报进度（in_progress + progress）。

查询任务的当前状态、进度和执行结果。

添加任务依赖关系。下游任务必须等上游任务完成后才能开始。自动进行环检测。添加后下游任务自动进入等待状态。

删除任务依赖关系。删除后自动检查下游任务是否可以开始执行。

查询任务的上下游依赖关系。返回依赖图，包含每个关联任务的状态和依赖类型。

将多个任务标记为并行组。同一并行组内的任务可以同时执行，无需等待其他任务完成。适用于无依赖关系的同层任务。

请求任务交接。将任务转交给另一个 Agent。目标 Agent 需要调用 accept_handoff 或 reject_handoff。只有负责人或创建者可以发起交接。

接受任务交接。只有被请求的 target Agent 可以调用。接受后任务 assigned_to 转移到当前 Agent。

拒绝任务交接。只有被请求的 target Agent 可以调用。拒绝后交接请求取消。

在 Pipeline 中添加质量门。质量门在指定 order_index 之后阻塞后续任务，直到评估通过。criteria 为 JSON 格式的检查规则。

评估质量门（通过/失败）。质量门失败时，Pipeline 中阻塞的后续任务自动进入 waiting 状态。

创建一个新的 Pipeline（任务流水线）。Pipeline 是任务的有序容器，可添加质量门进行阶段性质量检查。

查询 Pipeline 状态和进度。返回 Pipeline 信息、关联任务列表及各状态统计。

列出所有 Pipeline。支持按状态筛选，按创建时间倒序排列。

将任务添加到 Pipeline。指定任务在 Pipeline 中的顺序。不传 order_index 则自动追加到末尾。

激活一个已注册的 Agent（registered/suspended → active）。已激活再激活幂等。

挂起一个活跃 Agent（active → suspended）。已挂起再挂起幂等。

暂停一个活跃 Pipeline（active → paused）。已暂停再暂停幂等。

恢复一个暂停的 Pipeline（paused → active）。已激活再恢复幂等。

设置 Agent 角色（admin/member/group_admin）。group_admin 需指定 managed_group_id，仅能管理该 parallel_group 内成员的任务。仅 admin 可调用。

手动触发信任评分重算。基于多因子自动计算：verified capabilities (+3)、approved strategies (+2)、positive feedback (+1)、negative feedback (-2)、rejected applications (-3)、revoked tokens (-10)。不传 agent_id 则重算全部。仅 admin 可调用。

获取数据库统计信息。包括各表行数、数据库文件大小、WAL 大小、最后归档时间等。仅 admin 可调用。

手动触发数据归档。将指定天数之前的记录从主表移入归档表，以减少主表体积。可归档 messages（默认 30 天前）或 audit_log（默认 90 天前）。仅 admin 可调用。

上传文件附件并关联到消息。文件以 Base64 编码传入，服务端解码后存储到本地磁盘。

下载附件，返回 Base64 编码的文件内容。

列出消息的所有附件列表。