Skip to content

Commit 47c41c2

Browse files
committed
docs: explain monitor lease proof and replay contract
Signed-off-by: huangruiteng <14976749+huangruiteng@users.noreply.github.com>
1 parent e7f720a commit 47c41c2

1 file changed

Lines changed: 10 additions & 0 deletions

File tree

‎docs/project-agent-todo-contract.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -159,6 +159,12 @@ requires the caller to place the fresh observation digest in
159159
`LOOPX_MONITOR_RESULT_HASH` and exposes separate unchanged and material-change
160160
commands; omitting either the Turn binding or result digest fails closed before
161161
monitor writeback.
162+
The generated command transports an existing hard-lease proof with
163+
`--use-current-task-lease`. It reads the canonical provider's active lease for
164+
the exact Monitor and agent, or reuses the same Turn's durable transaction
165+
proof during recovery; it never acquires or renews a lease. Missing, expired,
166+
or foreign leases fail before creating a provider-pending receipt. The
167+
canonical TypeScript transaction still checks the proof atomically.
162168
The canonical watch-only/ordinary-due partition is produced inside the existing
163169
TypeScript Todo summary and quota-planning owners after Agent scope and
164170
capability admission; Python compatibility code only adapts legacy facts and
@@ -172,6 +178,10 @@ replan 压力,也不会抢占 runnable advancement;二者同时存在时,
172178
该 CLI 路由仅在绑定当前 Turn 时可用;调用方必须把本次新鲜 observation digest
173179
写入 `LOOPX_MONITOR_RESULT_HASH`,并在 unchanged 与 material-change 两条命令中
174180
明确选择。缺少 Turn 绑定或 result digest 时,monitor writeback 会在写入前失败关闭。
181+
生成命令使用 `--use-current-task-lease` 传递已有的 hard-lease 证明:从
182+
canonical provider 读取该 Monitor 与 Agent 的有效租约;若是同一 Turn 的恢复,
183+
则复用持久交易回执中的原证明。该入口不会获取或续租;租约缺失、过期或归属不符
184+
会在形成 provider-pending 回执前失败,最终仍由 TypeScript 权威事务原子校验。
175185
watch-only/普通 due 的权威分区由既有 TypeScript Todo summary 与 quota-planning
176186
owner 在 Agent scope 和 capability admission 之后生成;Python 兼容层只适配旧事实并
177187
渲染已选中的 CLI/Lark 路由。

0 commit comments

Comments
 (0)