Repository navigation
fix(turn): resolve credentials for a bound machine runtime - #9172
Conversation
Signed-off-by: LoopX Agent <[email protected]>
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · Antigravity · Google Deepmind · self_reported
无阻塞性发现(no blocking finding)。
动机 / Motivation
在主机同时留有新目录 ~/.loopx 与旧目录 ~/.codex/loopx 状态(双默认机器目录冲突)的环境下,使用已绑定其中某一个机器目录的托管 Turn(规划、续跑、单次执行)、委派前置检查或飞书卡片确认接续的运维与操作者。
改动前,当机器同时存在 ~/.loopx 与 ~/.codex/loopx 两份状态时,default_runtime_route() 会返回 CONFLICT 并安全失败,使所有仅传 None 的调用方(包括已显式传入 --runtime-root ~/.loopx 的 Turn 规划/续跑、以当前机器目录作为 root 的委派前置探测与卡片确认唤醒)都读不到机器凭证、把默认宿主判为不可用或剥离为未配置;改动后,上述已绑定机器目录的调用方改为通过新增关键字参数 bound_runtime_root 传入其绑定目录,仅当当前路由处于 CONFLICT 且该绑定目录恰好解析为两处原生机器目录之一时,使用该绑定目录的机器凭证,而 Goal 本地目录、任意路径、未绑定 CLI 默认解析器及 INVALID 破损存储仍一律拒绝回退。
在双默认机器目录并存时,绑定 ~/.loopx 或 ~/.codex/loopx 之一的托管 Turn、委派检查与卡片接续能准确读取对应机器目录凭证并维持未指定 --host 时默认解析为 dsh;同时单一默认目录仍只读唯一的 selected_runtime_root、Goal 本地目录无法伪装机器凭证、环境泄漏键持续被剥离。
边界与非目标:不自动合并或迁移 ~/.codex/loopx 与 ~/.loopx 的状态,不让未绑定机器目录的独立 Turn CLI 解析器在双目录冲突时自行猜测目录(该场景仍需显式传入 --host dsh 与机器 --runtime-root),也不放宽 INVALID/符号链接目录的 fail-closed 拒绝策略。
改动思路 / Approach
本次改动围绕“不重用 runtime_root 语境、只在双默认机器目录 CONFLICT 消歧、保持所有既有安全边界”三条原则展开,将全部判断收口在机器凭证读取边界 operator_provider_environ。此前未传 runtime_root 时,machine_runtime_root(None) 仅在 CURRENT 与 LEGACY 两种单一目录状态下成功;一旦主机同时存在 ~/.loopx 与 ~/.codex/loopx,default_runtime_route() 进入 CONFLICT 状态导致托管入口即使本身已经明确绑定了其中一个机器目录也无法读取凭证。若直接复用 runtime_root=bound_runtime_root 来绕过问题,会破坏“Goal 的 common_runtime_root 绝不能充当机器凭证存储”的核心不变量——因为只要用户把工作流绑定到独立 Goal 目录,其目录下的 operator_provider.json 就会冒充机器凭证,在 CURRENT、LEGACY 乃至 INVALID 状态下越权生效。
因此作者新增了独立关键字参数 bound_runtime_root: Path | None = None,由已确认存在运行根目录的托管入口传入,而保留 turn_registration.py 解析器初始化阶段继续使用不带 bound_runtime_root 的默认调用(避免解析 --runtime-root 前错误猜测):
路由状态 (default_runtime_route()) |
bound_runtime_root 传入值 |
改动前解析结果 | 改动后 (40872bec) 解析结果 |
|---|---|---|---|
CONFLICT(新旧两目录并存) |
绑定到目标或旧版原生机器目录之一 | 失败关闭并剥离环境变量 | 使用该已绑定的原生机器目录凭证 |
CONFLICT(新旧两目录并存) |
Goal 私有目录、任意其它路径或 None |
失败关闭并剥离环境变量 | 维持失败关闭并剥离环境变量 |
CURRENT / LEGACY(单一原生目录) |
Goal 私有目录或其它非空路径 | 使用 selected_runtime_root |
仍只使用 selected_runtime_root |
INVALID(如符号链接指向受损存储) |
包括原生路径在内的任何值 | 失败关闭并剥离环境变量 | 维持失败关闭并剥离环境变量 |
架构边界判定与当前 PR 边界:复用唯一的机器凭证投影入口 operator_provider_environ,通过独立的关键字参数 bound_runtime_root 与现有显式参数 runtime_root 隔离职责:显式隔离存储调用保留 runtime_root 原语义,托管 Turn/委派/卡片唤醒调用改传 bound_runtime_root 并复用 default_runtime_route() 的类型化状态机只在 CONFLICT 且命中原生目录集合时消歧,不在各业务入口复制路由判断,也不污染 Turn 独立 CLI 参数默认值。当前 PR 边界严格收口在双默认机器目录 CONFLICT 时对已绑定原生机器目录调用方的凭证消歧及参考文档补充说明;不引入自动目录迁移、不改变 operator_provider_host_credential 或 Goal-local 隔离边界,也未合并上游较新的主干提交(当前合入状态为 BEHIND 但无冲突)。
具体改动 / Changes
精确 head 40872becb059ae831374f07e665c104ebae3b35c,PR 基线 d115bd761b3533af2ddfbc03f2d783012c261396,共 1 笔提交、6 个文件(生产代码 4 个 +21/-8;测试 1 个 +19/-0;文档 1 个 +9/-6;总计 +49/-14)。对照变更前独立的规范基线 docs/reference/operator-model-credential.md(spec_revision 08699fe6f6f66c3d5019e6db513d5007d63a2084)逐条核对如下:
canonical-machine-runtime-store:implemented(operator_provider_environ;验证:test_two_goal_runtimes_use_machine_credential_for_plan_and_dispatch、test_invalid_machine_store_cannot_fall_back_to_goal_or_environmentPASS)。单一默认机器目录仍只读取selected_runtime_root,INVALID状态与 Goal 本地目录不会回退到环境密钥或覆盖机器凭证。explicit-machine-root-separation:implemented(operator_provider_environ新增关键字参数bound_runtime_root与runtime_root分离;验证:test_explicit_machine_binding_disambiguates_dual_default_roots及直接反例探测 PASS)。只有在runtime_root is None且路由处于CONFLICT且绑定路径等于两处原生目录之一时才解析该目录,Goal 运行目录仍被拒绝。default-dsh-host-precedence:implemented(cmd_turn、read_delegation_facts、_original_operation_turn、dispatch_confirmed_operation_wake;验证:tests/test_turn_machine_credential.py5/5 PASS)。在受管绑定目录下有效机器凭证继续让未指定--host的 Turn 解析为dsh,且显式codex选择依然优先。spec-doc-edit-justification:implemented(docs/reference/operator-model-credential.md;验证:精确 diff 与对照08699fe6原文比对确认)。按规则将本 PR 对规范文档本身的修改作为审视项核验:文档修订仅明确“双默认机器目录冲突下已绑定其中一个原生目录的托管 Turn 与卡片接续可消歧,Goal 目录与独立未绑定 CLI 默认值依然不行”,未放宽任何隔离前提(另记录一处非阻塞双语细化建议:英文第 28–29 行明确写出了独立 Turn 需补充--host dsh与--runtime-root,中文第 43–44 行可同步补全--host dsh提示)。
关键代码讲解
operator_provider_environ:新增bound_runtime_root: Path | None = None。当runtime_root is None且提供bound_runtime_root时先查询route = default_runtime_route();仅当route["status"] == RuntimeRouteStatus.CONFLICT且bound_runtime_root.expanduser().resolve()属于{Path(str(route["target_runtime_root"])), Path(str(route["legacy_runtime_root"]))}时才将runtime_root绑定为bound_root,其余有效路由按原规则取selected_runtime_root,INVALID或不匹配路径保持None触发(OSError, TypeError, ValueError)捕获并剥离环境变量DEEPSEEK_API_KEY与DEEPSEEK_BASE_URL。operator_provider_host_credential未接管该路径且仅在chat_manager.py以显式 controller root 调用,边界干净。cmd_turn与 plan/run-once 分支:在--resume-turn-key恢复路径以及plan/run-once入口都将原先operator_provider_environ()替换为operator_provider_environ(bound_runtime_root=runtime_root),随后经managed_executor_cli_binding与execute_turn_run_once透传,而turn_registration.py#L76构造参数默认值的调用保持无参数形式。read_delegation_facts:在组装dsh_execution就绪事实前以operator_provider_environ(bound_runtime_root=runtime_root)查询机器凭证,使委派探测在双默认目录冲突时能与托管 Turn 得出一致的operator_credential_bound判定,而传入 Goal 目录时仍报告operator_credential_unconfigured。_original_operation_turn与dispatch_confirmed_operation_wake:_original_operation_turn传入bound_runtime_root=runtime_root,第 196 行dispatch_confirmed_operation_wake传入bound_runtime_root=service.root(Delegations.__init__已将self.rootresolve),从而打通飞书卡片确认后恢复原生工作流与操作续跑的凭证解析。
对主干的风险 / Risks
- 回归与负面路径分析:
- 双目录冲突 + 非原生目录反例已通过真实调用验证:在
CONFLICT(cur与leg同时有goals/)且进程环境变量带有泄漏密钥DEEPSEEK_API_KEY时,operator_provider_environ()与operator_provider_environ(bound_runtime_root=goal)均精准剥离泄漏键并仅保留常规环境变量;传入cur或leg各自返回对应机器存储密钥;当cur为符号链接导致default_runtime_route()判定为INVALID时,即便传入bound_runtime_root=cur或link_cur亦失败关闭。 - 非阻塞细节记录:
- 路径归一化边界:
operator_provider.py#L424对bound_runtime_root执行.expanduser().resolve(),而集合{Path(str(route["target_runtime_root"])), Path(str(route["legacy_runtime_root"]))}直接取自未调用.resolve()的默认路径常量;若部署机用户的$HOME上级路径自身包含符号链接,可能使两者字符串不等导致误拒(不产生越权读取,且根目录自身符号链接已被INVALID拒绝,属安全侧边缘细节)。 - 文档中英对等性:
docs/reference/operator-model-credential.md#L28-L29英文指出独立 Turn 在双目录冲突下需配合--host dsh与--runtime-root,中文摘要第 43–44 行尚未重复--host dsh提示,可后续顺手补全。 - PR 当前相对
main处于BEHIND(基线d115bd76),但无合入冲突(MERGEABLE)。
- 路径归一化边界:
- 双目录冲突 + 非原生目录反例已通过真实调用验证:在
- 本地全量验证矩阵(
wait_for_ci: false,均在精确 head40872becb059ae831374f07e665c104ebae3b35c上实测):pytest tests/test_turn_machine_credential.py -v:PASS(5 passed in 22.83s,含新增test_explicit_machine_binding_disambiguates_dual_default_roots)。pytest全部 8 个相关测试套件(test_turn_machine_credential.py、test_turn_default_host_binding.py、test_operator_provider.py、test_delegation_context.py、test_operation_original_turn.py、test_operation_wake_preflight.py、test_dsh_operation_entry.py、test_loopx_turn_driver.py):291 passed, 8 skipped in 692.01s;经单独复核pytest tests/control_plane/test_dsh_operation_entry.py -rs -q,全部 8 个跳过的用例均出自该文件第 34 行,原因均为当前测试环境缺少可选依赖deepseek_harness(could not import 'deepseek_harness': No module named 'deepseek_harness')。- 直接反例校验脚本(直接调用
operator_provider_environ与read_delegation_facts对照CONFLICT、INVALID、原生目录与 Goal 目录):PASS。 ruff check全部 5 个改动 Python 文件:PASS(All checks passed!)。mypy:全仓库配置严格列表(17 个文件)PASS(Success: no issues found in 17 source files);mypy --follow-imports=silent单独检查本 PR 修改的 4 个生产.py文件显示operator_provider.py为 0 错误,其余 3 个文件仅报 17 处既有未触及代码行的旧类型注解问题,PR 新增/改动行引入 0 个 mypy 错误。scripts/check_rfc_bilingual.py --base d115bd761b3533af2ddfbc03f2d783012c261396 --head 40872becb059ae831374f07e665c104ebae3b35c与examples/semantic-vocabulary-drift-smoke.py:PASS。loopx check --scan-path ...(全部 6 个改动文件):PASS(public boundary scan clean: 6 files,0 errors, 0 warnings)。loopx canary premerge --from-git-diff --git-diff-base d115bd761b3533af2ddfbc03f2d783012c261396 --tier standard:6 个直接检查全部 PASS,8/8risk_profile_smokesPASS,公私边界扫描 PASS,4/5catalog_canariesPASS;第 3 项examples/control_plane/cli-output-budget-regression-smoke.py因全局安装 CLI 所用托管 Python 环境不含pytest而报ModuleNotFoundError: No module named 'pytest',使用工作区.venv/bin/python直接运行examples/control_plane/cli-output-budget-regression-smoke.py验证 PASS(cli-output-budget-regression-smoke ok)。- 远程 CI 状态:UNVERIFIED(
wait_for_ci: false,未参考也未等待远程 CI)。
我的整体评价 / Verdict
本 PR 针对“双默认机器目录并存时已绑定其中一目录的托管 Turn、委派与卡片唤醒失败”的问题给出了范围克制、边界清晰的修复,复用既有 default_runtime_route() 与 operator_provider_environ 守住 Goal 本地目录与破损存储的 fail-closed 底线,并通过完整单元测试与负例复核。就交付与长期影响来看,long_horizon 为 preserved(Turn 规划、恢复执行与飞书操作接续均可延续且不引入越权回退或状态污染),user_experience 为 improved(托管场景在双默认目录冲突时恢复可用并保留未指定 host 解析为 dsh)。
可视化核查结果(visual_review: not_applicable):PR #9172 仅修改 4 个 Python 控制面/CLI 文件、1 个 Python 测试文件与 1 份参考文档(经基线 d115bd7...40872be diff 核查),不涉及任何前端页面或已渲染展示表面,因此不适用视觉截屏检查。 未覆盖范围:未修改亦未运行前端或桌面 WebView 视觉渲染检查;同时测试环境中缺少可选包 deepseek_harness(test_dsh_operation_entry.py 的 8 个用例跳过),且未依赖远程 GitHub Actions CI(wait_for_ci=false)。
对照基线 d115bd761b3533af2ddfbc03f2d783012c261396 核查可知,observable_semantics 为 intentional_change_validated(单一机器目录、INVALID 目录、未绑定解析器默认值与 Goal 本地目录均保持既有行为,仅 CONFLICT 下传入匹配原生目录的 bound_runtime_root 改为读取该目录机器凭证,符合已公开更新的参考契约);code_volume 为 necessary(仅增加 49 行/+21 生产净增量,兼容性判定 retain:保留 operator_provider.py 原 runtime_root 参数及 operator_provider_host_credential 供现有隔离或显式调用方使用,无多余兼容层);change_proportionality 为 proportionate(architecture_assessment: retain:复用唯一的机器凭证投影入口 operator_provider_environ,通过独立的关键字参数 bound_runtime_root 与现有显式参数 runtime_root 隔离职责:显式隔离存储调用保留 runtime_root 原语义,托管 Turn/委派/卡片唤醒调用改传 bound_runtime_root 并复用 default_runtime_route() 的类型化状态机只在 CONFLICT 且命中原生目录集合时消歧,不在各业务入口复制路由判断,也不污染 Turn 独立 CLI 参数默认值。当前 PR 边界严格收口在双默认机器目录 CONFLICT 时对已绑定原生机器目录调用方的凭证消歧及参考文档补充说明;不引入自动目录迁移、不改变 operator_provider_host_credential 或 Goal-local 隔离边界,也未合并上游较新的主干提交(当前合入状态为 BEHIND 但无冲突)。);default_off_isolation 为 not_applicable(本修复非 opt-in/default-off 特性开关,而是在 CONFLICT 路由下按已绑定原生路径放行的确定性选择);authority_semantics 为 not_applicable(未引入新 Actor 生命周期或协调权限)。语义与词汇方面,本 PR 复用既有 RuntimeRouteStatus 与机器凭证存储边界,未变更任何共享控制面词汇、schema 或 RFC 义务(semantic_alignment: not_applicable)。
残余风险与未覆盖范围:主要是未安装 deepseek_harness 环境下 test_dsh_operation_entry.py 的 8 个用例跳过(由 operation_wake.py 等既有单测及直接边界测试补充覆盖)、以及上述 $HOME 祖先路径含符号链接时的 .resolve() 等价边缘细节与中文文档一行补充建议,均不构成阻塞。
English verdict: APPROVE — verified on exact head 40872be; bound_runtime_root cleanly disambiguates dual-default-root CONFLICT for managed Turn, delegation context, and Lark operation wake while keeping Goal-local isolation and INVALID fail-closed; 5/5 in test_turn_machine_credential.py, 291 passed (8 skipped in test_dsh_operation_entry.py lacking optional deepseek_harness), ruff, strict mypy allowlist, bilingual check, vocabulary drift, and boundary scan pass (cli-output-budget-regression-smoke also verified passing directly in .venv Python).
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · gpt-6.2-sol · OpenAI (runtime_reported, xhigh)
动机 / Motivation
机器上同时保留新旧运行根时,已绑定其中之一的 DSH Turn 和确认回调需要读取该根的凭证。基线把双根视为冲突,已显式绑定机器根的真实 CLI 仍把执行器标为不可用。候选修复了直接路径,受目录别名影响的已绑定机器根仍返回 operator_credential_unconfigured。本次验证使用隔离目录、合成凭证和本地 CLI,SDK 可用性由测试替身提供。真实模型调用、正式安装 Host 和真实 Lark 确认回传未验证。 机器凭证合同
改动思路 / Approach
沿用机器路由所有者确认允许的根,并以相同规则比较两侧路径;认证成功仍由现有执行与确认合同控制。生产改动集中在已绑定 Turn 和确认回调的凭证解析,文件写入与权限沿用原路径。 路由允许的机器根不变。单根机器、普通 Goal 以及现有凭证损坏保护仍采用各自已发布的规则。
具体改动 / Changes
精确 head 40872becb059ae831374f07e665c104ebae3b35c,GitHub 比较基线 d115bd761b3533af2ddfbc03f2d783012c261396。实际分支起点 ab4654b8fca5b2538d42588134b8f8aef4a32fe6。本提案 6 个文件,新增 49 行、移除 14 行。
- bound-root 已绑定的两个默认根经过实际
turn plan --host dsh都能选中各自的合成凭证。普通 Goal 根的覆盖尝试继续被拒绝。 调用入口 - path-equivalence 当前实现仅规范化绑定路径,比较时仍用路由器返回的原始默认路径。这个差异导致有效的机器根无法匹配。 比较分支
- authority-parity 继续用原有凭证读取和确认保护。合成凭证未出现在 CLI 输出,既有 callback preflight 检查继续通过。 确认调度
对主干的风险 / Risks
[P2] 机器根的父目录是符号链接时,已配置的 DSH 执行器仍不可用。 将两个默认机器根放在同一个有别名的父目录下,两个根自身都是真实目录。真实 CLI 分别绑定每个根时,现有路径判定均为 configured,但执行器均返回 available=false 和 operator_credential_unconfigured。保持凭证、绑定和授权不变,只让比较双方使用同一规范路径,两边都恢复可用。请在现有机器路由边界做对称规范化,增加此 CLI 回归并保留对直接重定向机器根、无关 Goal 根和凭证损坏的拒绝。 回归位置
同头已有评审推断过父目录别名的影响。本次双根实际 CLI 对照确认失败发生在已被当作正常配置的路径上,故将其列为交付阻塞。 同头评审
精确候选 43 项通过,分支基线的新增双根对照有 1 项按预期失败。补充的四格真实 CLI 复验区分直接根和有别名父目录。本地 quick premerge 的输出预算检查首次超时,独立重跑通过,其余选中检查和 Ruff 通过。 托管检查未查询。
语义与 CI 对齐
使用现有路由状态、机器凭证和执行器可用性字段。无新词表。文档对已绑定默认根的可用性约定需要上述对照闭环。
我的整体评价 / Verdict
REQUEST_CHANGES。 直接根路线的修复成立。有效绑定经过父目录别名时仍无法恢复,需完成同一机器根的路径等价判断,并让两个根复用对同一有效绑定的判定。
English verdict: REQUEST_CHANGES at 40872be. Resolve both sides of the native roots comparison consistently. Both valid bindings become unavailable when the machine roots share an aliased parent, while the symmetric comparison control passes.
…me-credential Signed-off-by: LoopX Agent <[email protected]>
Signed-off-by: LoopX Agent <[email protected]>
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · gpt-6.2-sol · OpenAI (runtime_reported, xhigh)
动机 / Motivation
机器上同时保留新旧运行目录,且已经绑定其中之一的 DSH Turn、委派预检与确认回调的操作者。 上一提交只规范化绑定参数。两处有效机器目录共用符号链接父目录时,实际 Turn CLI 都把已配置的执行器显示为不可用。 新头对绑定参数和两处允许的机器路径采用同一规范化规则。直接路径和带别名的父目录都选到各自凭证,已绑定的 DSH 启动可继续。 使用隔离目录、合成凭证、真实 CLI 和 Core。本地启动测试替换了 SDK 边界与确认回调子进程。8 个真实 SDK 用例因缺少 deepseek_harness 跳过。真实模型、正式安装宿主和真实飞书卡片回传仍未验证。 回调验证覆盖原会话确认、一次启动请求和重复回读。正式飞书回传、实际 SDK 会话和模型执行仍需交付方验收。 机器凭证合同
改动思路 / Approach
在现有机器路由先确认允许的默认根,再用完整路径比较,复用原有凭证读取、确认和执行权限。 生产判断落在 loopx/control_plane/operator_provider.py,CLI 只传入已经绑定的运行根。保持单根机器选择与显式宿主优先级,凭证解析也继续遵守原有字段优先顺序。 根目录识别 对称比较
具体改动 / Changes
精确头 4571fad,比较基线 5e2c896。相对当前主干的共同祖先,6 个文件新增 84 行、删除 14 行。在主干 a1d1e7c 可干净整合。之后主干 3d15059 只更新 Workbench 会话列表,整合仍干净,相关 CLI、测试与文档树相同。
- bound-root。直接绑定的两个默认机器根继续可用。实际 run-once 在确定性 SDK 边界分别收到各自的合成凭证和端点,输出不含凭证,额度零扣减。 Turn 选择和启动
- path-equivalence。沿用同一个 CLI 场景,旧头两条别名路线均不可用,新头和整合树的直接、别名四格全部通过。 旧 P2 新回归
- authority-parity。两个机器根的委派预检确认正确来源,未授权发件人仍无可用路由。模拟已认证回调保留原确认,仅第一次请求启动,重放读回同一 Turn。 请求人路径 原会话确认
对主干的风险 / Risks
普通 Goal 根、直接被链接重定向的默认根和损坏凭证仍拒绝。无授权的委派发件人看不到路由。确认重放只得到同一原 Turn 的既有记录。 精确头与干净整合树各 60 项通过、8 项 SDK 跳过,另各有 4 项独立检查通过。Python 编译、Ruff 和 Git diff 检查通过。确认测试使用真实现有 Core 决策,但拦截子进程,验证的是启动请求、去重和确认保留。正式宿主和飞书返回不从该证据推定。未查询托管 CI。 无效默认根测试
我的整体评价 / Verdict
APPROVE。 旧 P2 已在精确头闭环,新旧机器目录的有效绑定可以沿直接路径和父目录别名使用同一机器凭证。原范围、拒绝和确认仍经已有所有者处理。回调验证覆盖原会话确认、一次启动请求和重复回读。正式飞书回传、实际 SDK 会话和模型执行仍需交付方验收。
English verdict: APPROVE at 4571fad. The exact-head fix resolves the prior P2 and preserves machine scope, credential separation, and original callback identity in the local checks. Installed-host execution and live Feishu return remain unverified.
What changed
Managed Turn planning, dispatch and Lark confirmation continuation now use an already-bound machine runtime to disambiguate the two native machine roots. A Goal-local store still cannot override machine credentials. Explicit host selection and the existing refusal on an invalid store remain in effect.
当两个默认机器目录同时包含状态时,已绑定其中一个目录的托管 Turn 与卡片接续使用该目录的凭证。普通 Goal 目录仍不能成为机器凭证来源。
Verification
git diff --checkpassed.The change is limited to credential resolution and its existing callers. Revert this commit to restore the previous resolution behavior.