Automation

Nexus 自动化

Automation 使用宿主提供的 nexus.command，并绑定当前 owner、Agent、DM/Room/IM Session 与可选 job/run。不要声明或覆盖这些 identity，也不要通过 shell、其他管理入口或文件构造命令。

固定生命周期

1. 每个新意图先调用 current contract：

   {"domain":"automation","action":"contract"}
   

   严格遵守返回的 contract。不要探测命令路径、临时文件或环境变量。

2. 只选择 current contract 实际列出的 operation。每次新输入前重新读取该 operation 的 exact contract，并把完整 closed object 直接放在 input 字段中；不要落盘或通过 shell 转码。

3. query 使用 inspect。mutation 固定走 inspect → plan → apply → verify：先定位唯一任务与 revision；检查 plan 的 normalized input、target、summary、risk、current_revision 和 plan_digest；apply 时复用同一结构化 input。

4. apply 的顶层 expected_revision 原样复制 plan 的 current_revision，顶层 plan_digest 原样复制同一 plan 的 plan_digest，业务参数使用该 plan 返回的 input。顶层 request_id 遵循工具 schema，同一意图重试保持不变，结果未知先 inspect 对账。缺字段按错误补齐；revision/digest 失配先重新 plan，不重复旧调用。由当前 Nexus/Room/IM 会话发起原生真人确认。没有真实 allow 就没有写入；plan 本身不代表用户批准或状态已改变。

5. apply 后用 fresh input inspect get；执行/投递问题读取 runs、events 或 report。只按返回的 typed object 判断结果。

按当前动作读取参考

• list/get/runs/events/report 与 scheduled-run 只读范围：references/queries.md
• create/update/delete/run/retry_delivery、schedule 与投递语义：references/scheduled-tasks.md

只读取当前动作需要的参考；字段目录以 current contract 的 operation definition 为准。

权限边界

• 普通 Agent 只能管理自身任务；Room 自动绑定当前可信会话。外部 IM 默认绑定当前会话，也可以从 Nexus 桌面会话先查询 delivery_targets，再选择同一 Agent 的 active-paired 私聊。
• 不要猜或拼装 channel、account、target、thread、Session 或 DeliveryGrant。delivery_session_key 只能原样使用 delivery_targets 的当前返回值；它只是宿主验证的选择器，不是授权凭据。外部 IM 的空任务查询仍只覆盖当前会话。
• 后台 scheduled run 只有宿主绑定 job/run 的查询权限，不得创建、修改、运行或删除任务。
• apply 的确认只批准管理命令。任务运行时仍服从其 permission mode、工具 allow/deny 快照与持久审批；页面或 IM 的 /y、/a、/d 只恢复对应 logical run，nexus.command 不直接批准工具 permission request。
• script task 属于人工控制面，Agent 不创建、修改、删除、修复或立即运行。

回复只说明真实变更、作用域、排程、投递和验证结果，不输出 capability、内部路由、权限快照或完整审计载荷。