Repository navigation
Conversation
When a should-run decision advertises a managed claim before work and the builtin run-once bridge declines it, the flow previously fell through to the generic not-host-executable rejection. A bounded caller then retried the identical blocked route without ever invoking the Host. Refuse with a typed boundary instead: the run-once packet now carries status=execution_preparation_required with the turn_execution_preparation _claim_not_consumed reason code, the advertised claim command and the bound Todo, and exits without host invocation or quota spend. The existing consumption path, its admission wait and the ready postcondition are unchanged. Signed-off-by: BigDataDZ <76271875+BigDataDZ@users.noreply.github.com>
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · reasoning_effort=max
评审提交 634002f1ce9595541b6cf8b2d8bd63b027aca4c2,分叉基线 83809355f84aac19649924416cd8b90d1ff9e79c;用当前主干 74ca883d5bd3e4bc64671bac54210eac9e97ed05 检查集成范围。
[P1] 已持租约的 App Server 任务在执行前被拒绝。 用户在原生 App Server 中显式选择已准备就绪的任务。无需再领取,原生准备回调返回 None。 拒绝分支进入两种 Host 共用的代码块;helper 只在 builtin CLI 的分支导入。File 和 SQLite 的原生 Steward 测试中,基线均完成并结算,候选两条 ready 路径均报未绑定局部变量,Host 未启动、额度未扣。需要领租约的原生路径仍通过;另一个独立反例也证实原生回调拒绝从原受控阻断变成异常。 位置
[P2] 默认终端没有给出申领恢复动作,JSON 则用成功计划表示拒绝。 直接执行 turn run-once --host codex-cli --execute,且当前已投影申领但 builtin 没有消费。 两库中退出码都为 1。显式 JSON 有原因和命令,却仍是 ok=true 的 loopx_turn_plan_v1;默认 Markdown 只显示 Turn Plan / blocked,省掉状态、原因和命令。成功计划读法与拒绝的机器退出语义冲突,终端用户也仍得再查 guard。 位置
动机 / Motivation
使用 LoopX 管理 Codex 任务的用户,希望在某一轮缺少任务租约时明确知道如何接回原任务。 一轮已经选定任务,却在模型启动前卡在申领。此前重复运行只收到同一个拒绝;候选在 JSON 中明确报出需要申领,并带上已有恢复动作。 File 和 SQLite 上,候选在显式 JSON 中返回 typed wait、精确 claim 命令和零 Host/零扣额。内置 CLI 的合法领取、同任务重新准入、执行和原轮结算仍成功,冲突 Turn 仍不能替另一 Todo 领租约。 本 PR 只处理启动前缺少准备的反馈。普通申领、当前任务和原轮的复核继续由现有控制面管理,未转移任何执行或合并权限。 原始现场 #8587 · 同任务复核契约
改动思路 / Approach
本 PR 只处理启动前缺少准备的反馈。普通申领、当前任务和原轮的复核继续由现有控制面管理,未转移任何执行或合并权限。 把 builtin 分支的诊断送入现有执行结果/渲染契约,作用域锁定实际 builtin 适配器;保留 claim 授权检查和同一 Todo/Turn 就绪复核,避免新增一套 plan/execute 解释。 直接沿用通用拒绝会让用户再读 guard;自动扩大申领也不需要。把原因和原有下一步送进已有执行结果,可以保持两条 Host 的拒绝和正常执行分开。
具体改动 / Changes
3 个文件,增加 118 行。其中 52 行实现诊断,66 行用于测试。builtin 读取授权并领取、新 helper 和 原生准备回调 各有清晰作用域。新状态词是当前 run-once 结果的扩展;当前补丁把它放在 计划渲染器,默认看不到新行为。执行准备契约 分别要求准确领取与同轮复核、可操作的拒绝和原生宿主作用域。已有的原子领取、同任务重新确认和通过后的一次结算在 builtin 路径已保留。关键区别在于,原生回调返回空值有两种正常含义:此任务已经就绪,或者当前输入确实没有可消费的准备。两者都不应转入 builtin 的专用拒绝。
对主干的风险 / Risks
聚焦套件为分叉基线 29 项、候选 32 项;两库 JSON/Markdown、普通 claim/冲突对照通过预期检查;现有原生 Steward 正常执行套件基线 4/4,候选仅 2/4,两条 ready 用例失败。Ruff、DCO、diff、与当前主干的模拟合并通过。 当前发现是代码路径和输出合同的问题,即使作者测试通过也能复现。在 macOS 上使用真实 CLI、File/SQLite 和可观察的假 Codex。退回 None 的条件通过同一准备回调注入;未复现 #8587 的 Windows 原始环境,也未查看托管 CI。
我的整体评价 / Verdict
请求修改。保留 JSON 中已有的可操作信息,同时恢复默认 CLI 的可用诊断和其他宿主的原有拒绝。File/SQLite 隔离环境中让真实 guard 给出可由 Host 处理的缺租约结果,再注入准备返回 None;分别比较 JSON、默认 Markdown 及调用原生准备回调的 app-server;另用现有原生 Steward 测试对照正常显式选择和需申领两种路径。 只有确实适用且可见的恢复动作才应对外承诺。
English verdict: REQUEST_CHANGES at 634002f. A ready, explicitly selected native app-server task now fails before launch with an unbound-local error on both File and SQLite (baseline 4/4; candidate 2/4). The builtin's default Markdown hides the remedy, while JSON returns an ok=true plan despite exit 1. Preserve the existing execution-result boundary and limit the new branch to the builtin adapter.
| or decision.get("normal_delivery_allowed") is not True): | ||
| raise ValueError(preparation_error) | ||
| else: | ||
| refusal = unconsumed_preparation_refusal(decision) |
There was a problem hiding this comment.
[P1] 已持租约的 App Server 任务在执行前被拒绝。 拒绝分支进入两种 Host 共用的代码块;helper 只在 builtin CLI 的分支导入。File 和 SQLite 的原生 Steward 测试中,基线均完成并结算,候选两条 ready 路径均报未绑定局部变量,Host 未启动、额度未扣。需要领租约的原生路径仍通过;另一个独立反例也证实原生回调拒绝从原受控阻断变成异常。 将新拒绝限定在 builtin Codex CLI 实际安装的准备回调,原生回调沿用既有拒绝路径;若确有共用需求,让 adapter 提供明确的处置结果并先验证两条路径。
| blocked_plan.update(mode="run_once", status="execution_preparation_required", | ||
| execute=True, executed=False, **refusal) | ||
| project_preparation_effects(blocked_plan) | ||
| print_payload(blocked_plan, output_format(args), _render_loopx_turn_plan_markdown) |
There was a problem hiding this comment.
[P2] 默认终端没有给出申领恢复动作,JSON 则用成功计划表示拒绝。 两库中退出码都为 1。显式 JSON 有原因和命令,却仍是 ok=true 的 loopx_turn_plan_v1;默认 Markdown 只显示 Turn Plan / blocked,省掉状态、原因和命令。成功计划读法与拒绝的机器退出语义冲突,终端用户也仍得再查 guard。 沿用现有 run-once 执行结果及渲染边界输出明确未执行、非成功的准备拒绝。只在原 guard 授权并绑定准确身份时展示原命令及就地复核要求,保留零 Host/零扣额。
Motivation / 动机
#8587 报告:
quota should-run返回 true 且工作契约声明execution_preparation.state=claim_required(task_lease_missing,claim.host_execution_allowed=true)时,builtinturn run-once --host codex-cli --execute陷入 14 次完全相同的LoopX Turn route is not host executable拒绝——零次 Host 调用、零扣额、Goal 保持 active。根因(
main83809355f代码勘察):loopx/cli_commands/turn.py在execution_preparer返回None(builtin_execution_preparation_claim不识别该准备、静默不作为,按设计"left untouched")时直接落入后续通用流程,带着normal_delivery_allowed=false的决策走到 executor 的通用 not-host-executable 拒绝。没有任何类型化边界告诉调用方"该路由已死,去执行广告的 claim"。Change / 变更
loopx/control_plane/turn_driver/codex_execution_preparation.py:新增unconsumed_preparation_refusal()——决策声明claim_required但未被消费时,产出类型化拒绝(turn_execution_preparation_claim_not_consumed+ 广告的 claim 命令 + 绑定 Todo)。loopx/cli_commands/turn.py:builtin run-once(+execute) 路径在桥未消费时,按capability_action_required分支的既有先例输出 plan payload(status=execution_preparation_required,剥离 settlement_plan),return 1,不调 Host、不扣额。消费成功路径、admission wait、ready 后验校验全部不变。这正是 #8587 "Expected boundary" 的第二个选项(typed wait/action boundary),与第一个选项(既有消费桥)互补:能消费的照旧消费,不能消费的不再让调用方无限重试。
Regression / 回归
unconsumed_preparation_refusal命名广告命令 / 其他状态返回 None / 无 command 时不携带 claim_command。main([...turn run-once --execute...]))+_write_live_fixture(handoff_mode="hard_lease")让真实决策管线自然产出claim_required(task_lease_missing),仅注入"桥拒绝"这一真实失败模式;断言 exit 1、status=execution_preparation_required、reason_code 与 claim_command 齐备、effects无写入无扣额、fake codex 标记文件不存在(Host 从未被调用)。Validation / 验证
基于
main83809355f,真实 Windows 运行:uv run --extra test python -m pytest -q tests/control_plane/test_turn_run_once_claim_preparation.py→ 29 passed(含新用例)tests/test_codex_operation_launch_admission.py的 2 个 owner-stop 失败已验证在未修改main上同样失败(既有环境问题,与本 PR 无关),其余通过。Fixes #8587.