Repository navigation
Fix Steward card readback and callback readiness diagnostics - #8870
Conversation
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
…rameters Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
Signed-off-by: LoopX Agent <337587101+loopx-agent@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
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
APPROVE。 对 c21333dbc385d4716c8cefa12052a445df689b3e 的完整八文件改动未发现阻断问题。源码、独立安装候选及原权限边界已验证;真实平台完整点击闭环仍待原交付验收。
动机 / Motivation
在飞书原管家私聊中用 /triage 或按钮查询进展的用户,需要在原会话读到结果,并在回调暂不可用时知道怎样恢复。
同一张三按钮卡片被平台省略 value、补空 i18n 或改写文本标签后,旧 reader 会拒绝正常回读;候选容纳这些限定投影,再独立校验点击的完整参数与当前权限。
隔离安装的候选沿原 callback 入口接受正常不透明回读并送出只读查询结果,保持同一 Session 且无额外模型调用;十种身份、结构、时效或参数反例继续拒绝。
本次独评验证 provider/readiness 源码与隔离安装切片,不代表候选已部署或真实飞书客户端的完整点击返回链已经验收。
真实平台部署后的 click → callback → 同会话结果仍由原 Steward 交付职责继续验证;安装、模型采用和平台样式保持未验证。
改动思路 / Approach
只在只读 Steward adapter 内兼容平台的已观察投影,真实动作仍由原 outbound record 与当前 binding 授权;共享 privileged-card reader 保持不变,避免把可见标签当动作凭据。
本 PR 交付原管家只读卡片的回读兼容、回调健康诊断和可执行恢复文案;沿原监听器与私有 ingress,不引入新配置、决策台账或第二个监听服务。
原始卡片收据保存哪些动作确实被发送,平台回读只证明这张消息当前的有限可见结构。二者不能相互替代。容忍空 i18n、合法文本标签改写及不透明按钮编号,并不意味着按标签猜回隐藏参数。真正点击仍须提交原收据包含的完整 action,匹配 App、聊天、操作者、消息、时间、Session 和当前 Goal grants。
可用性与错误原因由同一 companion stream 对象投影,JSON 在 consumer 中解析一次。这里是 provider IO 和诊断,没有新的执行策略或授权来源。默认未绑定、普通project、非owner入口不启动这条订阅;已有群team-plan仍按原绑定chat过滤。恢复只重连callback子流,保留消息consumer及App租约。
| 情况 | 旧行为 | 当前候选 |
|---|---|---|
| 合法卡片回读省略value | 拒绝正常卡片 | 结构通过后,另核完整点击action |
| 可见卡片但完整action增加未发送Goal | 不应授权 | 原outbound fence继续拒绝 |
| 发卡时callback不可用 | 文字查询仍可用,恢复步骤不清楚 | 明确恢复后重发/triage,旧fallback仍无按钮 |
具体改动 / Changes
完整 diff 为8文件 +186/-48:六个产品模块、一项模块预算和一个native ingress测试模块。没有新增配置、CLI命令、监听服务或持久协议。按 docs/development/frontend-delivery.md,不可变版本 0c3b2fd21800a536ccaa61bad85c4dd8257aad8e 的Task-first要求核验:original-query-journey 已在原Session完成授权查询;authority-and-failure 已核参数、来源、撤销、时效和断线恢复;packaged-readback 已独立构建wheel、安装并运行原入口,六个模块与候选字节一致;real-client-acceptance 明确保留给原Steward交付owner,尚未部署或在线验收。
关键代码讲解
- _read_exact_card 继续由共享provider reader核精确App/message/chat,再逐项验证header、控件数量和已知结构变体。未知字段、附加behavior、重复opaque id、标题变化及可转发配置拒绝;空i18n或省略callback值本身不再造成误拒。
- capture_callback 保留真正的动作权限边界。完整action必须属于原outbound buttons;当前binding、Session、scope及到期检查继续执行,然后才写原私有callback记录。callback去重和send UUID恢复仍归既有owner。
- TeamPlanReviewCallbackStream 精确识别
card.action.trigger的ready marker,从structured error得出bounded诊断。health_snapshot 读取同一对象,不暴露private provider错误正文。启动失败、前置条件失败及断开不会被笼统标成已就绪。
对主干的风险 / Risks
最值得反驳的承诺是“接受lossy回读,但绝不据此恢复隐藏动作权限”。我在真实隔离Core/binding/Session上调用原service callback入口,对同一fixture分别使用不可变0c3的历史reader和候选reader;历史替换仅用于敏感性验证,不冒充整个旧安装包。旧reader拒绝正常opaque投影,候选接受并最终送出只读结果。完整原card在两边的返回相同;修改标题、加未知字段或behavior、重复编号、forwarding、错误App/chat/operator、未发送参数与过期均被拒绝。来源撤销后旧卡也不能继续。
- PASS 三个相关源码模块115项;独立wheel安装后native ingress8项,六个产品模块逐字节一致。
- PASS 源码及安装模块各12组独立配对探测,query确实送出、Session不变、额外模型调用为0。初次负例误选了同卡另一合法按钮,已保留该验证脚本失败并修正为未发送Goal,再用全新隔离fixture重跑;这不是产品漏洞。
- PASS whole-checkout base/head的unbound、ordinary、nonowner及group-only对照输出完全相同。相关测试覆盖丢send响应、重复callback、readback竞态、错误marker和断线恢复。
- PASS 标准premerge:4项直接检查、13项选择检查,无manual hold;bundle、wheel及安装验证通过。
语义与 CI 对齐
局部provider词汇和既有权限owner保持;没有新增generic obligation。预算实测为base2582行、head2585行,原上限2583确实拒绝。当前只把这一模块上限校准到2585、余量0,Any计数仍114。保留正常TYPE_CHECKING与单stream对象,比删必要语义或另拆平行owner更合适;当前ratchet重新通过,原失败仍是失败。远端CI依本轮契约未查询。
我的整体评价 / Verdict
这是有实际调用者和可回退范围的修复增量。长程连续性改善为callback子流故障不要求重启消息服务,原收据继续保护重复投递;用户能在原会话直接得到只读结果,也能看懂不可用时的下一步。已查看候选轮子卡片 JSON 的公开合成预览:1180px桌面及390px窄屏均包含菜单、前后fallback和带部分源警告的长结果;恢复指令与文字命令同组,失败/未知范围保持在结果前。
预览近似平台样式,不能证明真实飞书渲染或候选在线点击回路;本次只改变fallback恢复文字,不改菜单及结果布局。
兼容限制留在只读provider边界,通用受保护卡片保持原语义;集中stream诊断及一次JSON解析是同域简化。真实平台部署后的 click → callback → 同会话结果仍由原 Steward 交付职责继续验证;安装、模型采用和平台样式保持未验证。
English verdict: APPROVE at c21333d. Independent installed-module checks accept the bounded provider projection while preserving original action, identity and scope fences. Live Feishu deployment and the complete click-result journey remain unverified.
|
This pull request has merge conflicts with Choose the remote for the base repository, not an out-of-date fork. git fetch upstream
git rebase upstream/main
# Resolve each conflict, git add the resolved files, then git rebase --continue.
git push --force-with-lease origin HEADFor a same-repository clone whose Keep the DCO |
Retain native mention steering and qualify the integrated private callback module at its measured 2654 lines. Preserve the original 2651-line ratchet failure in validation evidence. Signed-off-by: LoopX Agent <337587101+loopx-agent@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
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
APPROVE。 完整审查 69e0a080b22fd17442d081a96bca6905aa960008,未发现阻断问题。新主干整合和隔离安装候选已验证;现用飞书服务采用及真实点击闭环仍未验收。
动机 / Motivation
在飞书原管家私聊中查询任务、点击卡片或等待回调恢复的用户,需要在同一会话得到只读结果,并保留原消息与授权范围。
平台省略按钮 value、补空 i18n 或改写文本标签时,旧读取器会拒绝正常卡片;候选接受限定的可见投影,仍用完整点击参数和当前绑定判断动作权限。
当前源码与独立安装包均能沿原入口接受合法不透明投影并送出只读查询,Session 不变且不增加模型调用;错误身份、参数、结构、时效和撤销仍拒绝。
本次验证现有 provider 修复和当前主干整合,不代表候选已被现用服务采用,也不代表真实飞书客户端点击闭环已验收。
原 Steward 交付职责仍需在获准采用候选后验证真实平台的 click → callback → 原会话结果;本轮未执行 live 安装、重启或私聊写入。
改动思路 / Approach
把兼容性限制在只读 Steward adapter,并复用原 outbound action 与 current binding 鉴权;共享受保护卡片保持严格匹配,避免把可见标签当执行凭据。
本 PR 交付现有只读卡片兼容、同一 callback stream 的健康诊断及恢复说明;没有新配置、持久台账、控制面决策 owner 或额外监听服务。
省略 value 的平台读回只能证明原 App、消息、聊天和可见控件,不能恢复隐藏动作的授权。真正点击继续匹配原发卡记录中的完整 action,再核当前 binding、Session、Goal scope 和时效。比仅忽略 i18n 完整,也把宽松匹配挡在通用受保护卡片之外。
原 companion stream 同时提供 ready 与有界诊断,consumer 只解析一次 JSON;启动失败、前置条件失败和断开均不会误称就绪。局部重连保留消息 listener 和 App 租约,普通文字查询仍可用。旧 fallback 卡保持原样,恢复后新发 /triage 才获得按钮,无新增确认步骤。
具体改动 / Changes
相对 d210e4cc1d002f92498b2811c565b9430e79f4c1 的整 PR 仍为8文件 +186/-48:六个产品模块、一个测试模块和一项模块预算。相对上轮 c21333dbc385d4716c8cefa12052a445df689b3e,triage owner、renderer 和 stream 字节未变;本次重核 main 新增的原生 mention/steering 及所有相关调用者,没有继承旧批准。
依据接受的 docs/development/frontend-delivery.md,不可变版本 d210e4cc1d002f92498b2811c565b9430e79f4c1:original-query-journey 已沿原 Session 验证;authority-and-failure 已覆盖拒绝及故障恢复;packaged-readback 已通过当前 wheel 的实际入口;real-client-acceptance 保留给原产品交付 owner。
关键代码讲解
- _read_exact_card 限定 header、控件数量、按钮类型及已知投影,拒绝未知字段、额外行为、重复不透明编号、标题漂移和转发。空 i18n、文本标签变化和参数省略本身不再拒绝正常查询。
- capture_callback 先核完整原 action、消息和操作者,再核当前绑定、App、Goal grants 与有效期;最后才写原 callback 记录。去重、丢响应恢复和只读结果仍沿原 owner。
- TeamPlanReviewCallbackStream 只接受精确
card.action.triggerready marker,结构化前置条件错误只投影有界 code。health_snapshot 读取同一个 stream,不公开 provider 原始错误内容;关闭时原注册和进程回收仍完整。
对主干的风险 / Risks
最强反例是“可见卡片相同,但完整点击添加原卡未发送的 Goal”。当前 base/head 通过相同合成 Core/SQLite 与原 service callback 入口运行12种 wire 情况:完整正常卡返回相同;只有合法 opaque 投影从旧拒绝变为新接受;十类结构、来源、权限和时效负例的异常类型与完整文字保持,撤销后也拒绝。原 base 的 strict reader 与历史敏感性 reader 的 AST 相同,放回当前 caller 会再次拒绝正常 opaque 投影,证明检查能识别该缺陷。
- PASS 六个当前源码模块708项;当前独立 wheel 安装后卡片和 native mention/steering 28项。1993个 LoopX 载荷文件与源码、wheel、安装内容逐字节相同;761个已加载 LoopX 模块均来自该 wheel。
- PASS 独立安装入口另跑12组 wire 探测,结果确实送出、Session 不变、额外模型调用为0。重复、未知 send 回执、错误 marker、断线重连及当前授权拒绝由相关用例验证。
- PASS whole-base/head 的 unbound、ordinary、nonowner 与 group-only 对照,输出相同;没有把 CLI 可用、卡片可见或 ready 当启用或授权。
- PASS 当前标准 premerge 的6项直接检查和13项选中检查。首次因根目录未安装 TypeScript 开发依赖失败,base/head 签名一致;补齐后语义 smoke 和完整 gate 均通过。首次打包命令缺 build 模块、首次安装测试误选非测试 helper 的准备失败也保留,修正后实际入口通过。未查询 CI。
语义与 CI 对齐
这是局部 provider 词汇与诊断,没有新增通用工作义务。预算按同一 owner 实测 base2651行、head2654行,Any均115;原2651上限确实拒绝,新上限2654、余量0。多出的三行保留必要 TYPE_CHECKING 类型导入,比删类型或压缩结构更合适;没有放宽冻结实验门。原错误和后续通过分别保留。
我的整体评价 / Verdict
本头是有实际调用者、失败恢复和明确回退范围的修复增量。长程连续性在回调子流故障后保持原消息服务及收据;用户可在原会话完成只读查询,文字备用和重取卡片的下一步清楚。兼容旧投影仍属 provider 边界,原持久 action 记录保持,内部 stream 调用者同部署更新;不需要第二个权限或状态 owner。
重新查看原 c21333d 的1180px桌面与390px窄屏合成预览:菜单、前后fallback及长的部分源结果均可读,恢复指令紧邻文字命令;renderer、triage owner 和 stream 与本头逐字节相同,当前wheel载荷也已独立核对。
合成卡片预览近似平台样式,不能证明真实飞书渲染或现用客户端点击成功;原截图保持 c21333d 的实际来源版本。
原 Steward 交付职责仍需在获准采用候选后验证真实平台的 click → callback → 原会话结果;本轮未执行 live 安装、重启或私聊写入。
English verdict: APPROVE at 69e0a08. Independent full-base/head and installed-wheel checks preserve original action, identity and scope fences while accepting the bounded provider projection; native steering remains intact. Live Feishu adoption and the complete click-result journey remain unverified.
huangruiteng
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · Codex · OpenAI · self_reported
动机 / Motivation
在飞书原管家私聊中使用 /triage 或按钮查询进展的用户,需要继续读取同一条消息、同一 Session 和原有授权范围。平台可能省略卡片按钮的 callback value、补空 i18n 或把 plain_text 改写成 lark_md,旧 reader 会因此拒绝一张本来正常的只读卡片;callback 子流启动、前置条件失败或断开时,用户也只看到笼统的不可用状态。
当前提交只放宽已观察到的 provider 只读投影,并在真正点击时继续匹配原发卡记录中的完整 action、当前 binding、Session、Goal scope 和时效。若 callback 尚不可用,fallback 卡明确提示恢复后重发 /triage。本次不改变通用受保护卡片的严格语义,也不宣称现用飞书服务已经采用候选。
改动思路 / Approach
入口仍是现有 LarkPrivateConversations 私有投递和 TeamPlanReviewCallbackStream。卡片回读只验证 provider 能证明的 App、message、chat、header 和可见控件;隐藏参数不能由投影恢复,完整点击仍交给 capture_callback 按原 outbound record 和当前权限核验。
callback health 与 ready 状态由同一个 stream 对象提供,health_snapshot 只投影有界错误码,不反射 provider 原文。启动中、前置条件失败和已断开分别使用固定类别;私有 callback 子流重连时保留原消息 listener 和租约。
| 情况 | 当前行为 |
|---|---|
| 合法卡片省略 value / 空 i18n / 文本标签投影 | 只读回读通过,点击仍重核完整原 action |
| 回读增加了原卡未发送的 Goal 或修改身份 | 原 outbound/binding fence 拒绝 |
| callback 启动或连接失败 | 显示固定 readiness 错误码和恢复说明 |
| 普通 unbound、ordinary project、non-owner 入口 | 不启动这条 callback 订阅 |
具体改动 / Changes
相对当前 PR base d210e4cc1d002f92498b2811c565b9430e79f4c1,完整差异为 8 个文件、+186/-48:六个 Lark 产品模块、一项模块预算和 native ingress 测试。diff --check 通过,没有新增配置、CLI 命令、持久协议或第二套监听服务。
关键代码讲解
private_steward_triage.py::_read_exact_card只接受 exact App/message/chat 上的已知 header、控件数量和受限投影;未知字段、额外 behavior、重复不透明编号、标题漂移和 forwarding 仍拒绝。private_steward_triage.py::capture_callback保持真正的权限边界:完整 action 必须属于原 outbound buttons,然后重新核当前 binding、Session、scope 和到期时间,最后才记录 callback。team_plan_confirmation.py::TeamPlanReviewCallbackStream精确识别card.action.triggerready marker,从 typed failure 生成有界 code;JSON 只解析一次,readiness_error()不公开 provider 原始错误。goal_topic_runtime_service.py::health_snapshot读取同一个 stream,不再把“进程已启动”误当成 callback ready;关闭时原 stream 注册仍会被移除。
验收依据 docs/development/frontend-delivery.md 的 task-first 路径:原 Session 查询和权限拒绝在当前源码有覆盖,独立 wheel 和安装候选由作者此前的 exact-head 记录验证;真实飞书部署后的 click → callback → 原会话结果仍由产品交付 owner 继续验收。
对主干的风险 / Risks
PASS:当前 exact head 的 tests/extensions/test_lark_private_steward_triage.py 8 项通过;相邻 runtime、triage、card、callback、readiness 和 reconnect 用例 37 项通过;六个改动 Python 模块语法编译通过;diff hygiene 通过。作者在相同 head 另记录六个源码模块 708 项及独立安装 wheel 的 28 项通过。
最强反例仍是“可见卡片相同,但点击提交了原卡未发送的 Goal”。放宽只作用于 provider 回读,capture_callback 仍使用完整原 action,因此可见投影不能增加执行权限。真实飞书渲染、现用客户端点击闭环、live 安装和部署未在本轮执行,作为剩余 evidence gap 保留。
我的整体评价 / Verdict
APPROVE。该提交把兼容性限制在 Steward provider 边界,修复正常 opaque 卡片被判坏和 callback 健康状态不准确的问题,同时保留原动作、身份、Session、Goal 和时效校验。当前 head 的聚焦与相邻测试均通过,没有未解决 review thread;真实飞书平台采用仍保持独立验收。
English verdict: APPROVE at 69e0a08. Bounded card projections now pass readback while original actions and current authority remain the click boundary; focused triage and adjacent runtime tests pass.
Goal And Delivered Outcome
飞书回读会为空的
i18n、文本标签和按钮参数生成不同于发卡 JSON 的投影。原来的逐字段比较会拒绝正常卡片。这次修复让原生只读 Steward 查询识别已观察到的平台投影,并区分回调订阅启动、供方前置条件失败和断开;发卡时按钮不可用的旧卡会明确指向恢复后重新获取/triage。main至d210e4cc1d002f92498b2811c565b9430e79f4c1,保留主干新增的原生 @ steering。相对该基线仍为原八个文件。Author Declaration
AGENTS.md和 frontend-delivery contract。Scope And Continuation
卡片读回检查精确 Bot/App、消息、会话和可见控件。它不能认证供方省略的参数映射。 完整认证点击值仍必须与原发卡记录匹配,并通过当前绑定与 Goal 范围校验。兼容处理只用于只读 Steward 查询;通用特权卡片 reader 不变。未知按钮字段、额外行为、重复不透明标识、标题漂移和转发继续拒绝。
同一个 callback stream 提供可用性与有界诊断,消费处只解析一次 JSON,不把供方原始错误文本暴露到健康输出。组聊/default-off 行为保留。Python 继续作为现有 Lark provider adapter;没有新消费者、配置、控制面决策 owner 或共享状态词汇。
本 PR 是 provider/readiness 修复提案。安装包中的合成传输验证不等于真实飞书点击成功;原 Steward 用户旅程仍保留实际服务版本、唯一回调归属和点击结果的验收。
Validation
69e0a080b22fd17442d081a96bca6905aa960008.integrationreal_entrypointintegrationstaticstaticintegrationstaticmanual源码检查使用:
uv run --extra test python -m pytest -q \ tests/test_native_steward_fast_path_triage.py \ tests/extensions/test_lark_private_steward_triage.py \ tests/extensions/test_lark_goal_topic_runtime.py \ tests/test_lark_private_conversations.py \ tests/extensions/test_lark_team_plan_confirmation.py \ tests/test_lark_control_source_admission.py模块预算:原 PR 的 2585 行与当前 main 的 2651 行整合后为 2654 行;相对 main 增加三行有用的
TYPE_CHECKING类型导入。原 2651 上限的实际失败保留,仅将本模块上限校准为 2654,零余量;Any为 115,dict[str, Any]为 0。保留类型边界和常规分隔,不为三行限制压缩可读结构,也不捆绑无接收方的模块重构。原 ratchet 和完整标准检查已重跑通过。Change-quality author assessment: eight files, fingerprint
21c58605193f5b8b42bff2c4e62e64972b2e2aad8e86263b5309c49e2f22e8c4; receiptcqr_21c58605193f5b8b42bfverified. Zero unresolved blockers; one opaque-parameter warning and one resolved budget advisory. No quality safe-fix pass. This is an author assessment; exact-head independent review, merge authority and installation remain separate.Frontend / Visual Evidence
主要问题是旧卡在发送时没有可用按钮时,用户如何继续。恢复说明与原文字命令放在同一卡片;部分来源警告位于结果之前,结果仍保留刷新、选项目和返回。
复用并重新目视检查原
c21333d的 1180/390px 公开安全截图:card renderer 与 triage owner 在本次整合中逐字节不变,最终 wheel 也已核对同源。默认菜单直接显示三个操作;恢复文字和长的部分来源结果可换行,窄屏下底部操作仍完整可见。截图使用安装包 renderer 的合成卡片,平台样式为近似,不是实际部署的飞书截图或新头真实点击验收。没有发布私人客户端截图。Type / Area / Boundary