convex-monitor 是一个面向 Convex 应用的监听模板,核心用途是让开发者或其工具链阻塞等待下一条需要处理的事件,而不是反复轮询。
主要能力:它同时竞速三类事件来源——本地错误日志、部署订阅以及 Sentinel 的生产错误记录,返回最先触发的一条事件;若超时且无事件,则返回安静心跳。事件采用固定且带版本的 schema,同一触发条件产生同一类型事件,保证行为可预期。
使用方式:调用 wait_for_event,传入 project_dir、event_kinds、timeout_ms 三个参数。随后按事件类型分支处理:kind=convex_error/next_error 时解码并修复;kind=prod_error 时先分诊(参见 sentinel)再修复;kind=feature_request 时进行构建;kind=quiet 时继续循环。在阻塞式 MCP 支持较弱的运行环境(例如 Copilot cloud)中,该包会运行具有相同事件契约的轮询循环,行为一致但机制不同。规则上优先使用阻塞工具,仅在阻塞式 MCP 较弱处回退到轮询循环。
适用场景:需要持续响应 Convex 应用开发错误、生产错误或功能请求的开发工作流。
限制:生产事件(kind=prod_error)需要已部署的云应用以及 Sentinel;具体安装命令、收费与价格信息暂未提供。