用途:在指定主题上阻塞等待消息,实现智能体之间的同步与协调交接。适用于等待其他智能体完成工作、协调交接、等待响应或确认、在分布式工作流中同步等场景。
主要能力:hive msg sub --wait 命令每 500ms 轮询指定主题,直到消息到达(成功,退出码 0)或超时(打印 JSON 状态,退出码 1)。--wait 模式默认超时为 24h;除非使用 --ack,否则消息不会被确认。支持自定义超时(s/m/h)、通配符主题(如 agent.*.response)、--listen 持续监听(输出所有消息直到超时,与 --wait 只返回一条不同)。收件箱简写 hive msg inbox --wait 等价于订阅 agent.<id>.inbox 并自动识别主题。
使用方式:等待单条消息用 hive msg sub --wait --topic <topic>;自定义超时加 --timeout <duration>;确认消息加 --ack;通配符主题直接写在 --topic 中;持续监听用 hive msg sub --listen --topic <topic> --timeout <duration>。输出为 stdout 上的 JSON Lines,超时打印如 {"status":"timeout","topic":"agent.abc.inbox","duration":"30s"}。
超时建议:5-30s 用于活跃智能体间快速交接;1-5m 用于常规交接或人工审核;10m-1h 用于构建/测试或后台处理;1-24h 用于过夜任务或异步协作。
限制:默认超时 24h;未加 --ack 时消息不会被标记为已读;--wait 只返回一条消息,需全部消息应改用 --listen。更多高级模式与故障排查见 references/troubleshooting.md。相关技能包括 /hive:inbox、/hive:publish、/hive:session-info。