@team-agent/installer 0.5.127 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (421) hide show
  1. package/README.md +15 -4
  2. package/README.zh.md +1 -1
  3. package/package.json +4 -8
  4. package/skills/team-agent/SKILL.md +41 -26
  5. package/skills/team-agent/command-coverage.json +170 -184
  6. package/skills/team-agent/docs/reference/team-agent-operator.md +66 -32
  7. package/skills/team-agent/references/recovery-runbook.md +1 -1
  8. package/skills/team-agent/references/team-agent-operator.md +66 -32
  9. package/templates/team_state.md +1 -1
  10. package/Cargo.lock +0 -1063
  11. package/Cargo.toml +0 -36
  12. package/crates/team-agent/Cargo.toml +0 -69
  13. package/crates/team-agent/src/app_server_test_support.rs +0 -258
  14. package/crates/team-agent/src/cli/adapters.rs +0 -1298
  15. package/crates/team-agent/src/cli/arguments.rs +0 -401
  16. package/crates/team-agent/src/cli/attach_app_server_leader.rs +0 -98
  17. package/crates/team-agent/src/cli/diagnose.rs +0 -1675
  18. package/crates/team-agent/src/cli/emit.rs +0 -2898
  19. package/crates/team-agent/src/cli/grok_slot.rs +0 -384
  20. package/crates/team-agent/src/cli/helpers.rs +0 -91
  21. package/crates/team-agent/src/cli/intent/runtime.rs +0 -1189
  22. package/crates/team-agent/src/cli/intent/runtime_tests.rs +0 -821
  23. package/crates/team-agent/src/cli/intent/tests.rs +0 -691
  24. package/crates/team-agent/src/cli/intent.rs +0 -664
  25. package/crates/team-agent/src/cli/leader.rs +0 -300
  26. package/crates/team-agent/src/cli/leader_prompt.rs +0 -261
  27. package/crates/team-agent/src/cli/leaders.rs +0 -418
  28. package/crates/team-agent/src/cli/mod.rs +0 -6528
  29. package/crates/team-agent/src/cli/models.rs +0 -449
  30. package/crates/team-agent/src/cli/named_address.rs +0 -1651
  31. package/crates/team-agent/src/cli/profile.rs +0 -342
  32. package/crates/team-agent/src/cli/route.rs +0 -212
  33. package/crates/team-agent/src/cli/send/coordinator.rs +0 -164
  34. package/crates/team-agent/src/cli/send/mailbox.rs +0 -145
  35. package/crates/team-agent/src/cli/send/persist.rs +0 -192
  36. package/crates/team-agent/src/cli/send/presentation.rs +0 -370
  37. package/crates/team-agent/src/cli/send/resolve.rs +0 -573
  38. package/crates/team-agent/src/cli/send.rs +0 -201
  39. package/crates/team-agent/src/cli/shutdown_socket.rs +0 -288
  40. package/crates/team-agent/src/cli/spec.rs +0 -159
  41. package/crates/team-agent/src/cli/status.rs +0 -280
  42. package/crates/team-agent/src/cli/status_port/agents.rs +0 -358
  43. package/crates/team-agent/src/cli/status_port/approvals.rs +0 -79
  44. package/crates/team-agent/src/cli/status_port/brief.rs +0 -2043
  45. package/crates/team-agent/src/cli/status_port/compact.rs +0 -240
  46. package/crates/team-agent/src/cli/status_port/format.rs +0 -146
  47. package/crates/team-agent/src/cli/status_port/inbox.rs +0 -62
  48. package/crates/team-agent/src/cli/status_port/runtime.rs +0 -197
  49. package/crates/team-agent/src/cli/status_port/snapshot.rs +0 -208
  50. package/crates/team-agent/src/cli/status_port/store.rs +0 -416
  51. package/crates/team-agent/src/cli/status_port/tests.rs +0 -90
  52. package/crates/team-agent/src/cli/status_port.rs +0 -92
  53. package/crates/team-agent/src/cli/tests/base.rs +0 -885
  54. package/crates/team-agent/src/cli/tests/divergence.rs +0 -518
  55. package/crates/team-agent/src/cli/tests/lane_c.rs +0 -453
  56. package/crates/team-agent/src/cli/tests/leader_watch.rs +0 -372
  57. package/crates/team-agent/src/cli/tests/main_preserved.rs +0 -430
  58. package/crates/team-agent/src/cli/tests/missing_subcommands.rs +0 -336
  59. package/crates/team-agent/src/cli/tests/mod.rs +0 -137
  60. package/crates/team-agent/src/cli/tests/named_address.rs +0 -760
  61. package/crates/team-agent/src/cli/tests/parser_safety.rs +0 -383
  62. package/crates/team-agent/src/cli/tests/run_delegation.rs +0 -481
  63. package/crates/team-agent/src/cli/tests/shutdown_kill_plan.rs +0 -2179
  64. package/crates/team-agent/src/cli/tests/status_brief.rs +0 -1514
  65. package/crates/team-agent/src/cli/tests/status_send.rs +0 -1091
  66. package/crates/team-agent/src/cli/tests/verb_install_skill.rs +0 -93
  67. package/crates/team-agent/src/cli/tests/verb_profile.rs +0 -392
  68. package/crates/team-agent/src/cli/triage.rs +0 -234
  69. package/crates/team-agent/src/cli/types.rs +0 -591
  70. package/crates/team-agent/src/codex_app_server.rs +0 -546
  71. package/crates/team-agent/src/communication_mode/mod.rs +0 -56
  72. package/crates/team-agent/src/compiler/tests.rs +0 -842
  73. package/crates/team-agent/src/compiler.rs +0 -691
  74. package/crates/team-agent/src/conpty/backend.rs +0 -829
  75. package/crates/team-agent/src/conpty/mod.rs +0 -33
  76. package/crates/team-agent/src/contract_runtime/backend.rs +0 -1610
  77. package/crates/team-agent/src/contract_runtime/commands.rs +0 -671
  78. package/crates/team-agent/src/contract_runtime/config.rs +0 -354
  79. package/crates/team-agent/src/contract_runtime/config_tests.rs +0 -56
  80. package/crates/team-agent/src/contract_runtime/discovery.rs +0 -438
  81. package/crates/team-agent/src/contract_runtime/fork.rs +0 -368
  82. package/crates/team-agent/src/contract_runtime/forward.rs +0 -288
  83. package/crates/team-agent/src/contract_runtime/framework.rs +0 -350
  84. package/crates/team-agent/src/contract_runtime/mcp.rs +0 -399
  85. package/crates/team-agent/src/contract_runtime/mod.rs +0 -17
  86. package/crates/team-agent/src/contract_runtime/prompt.rs +0 -216
  87. package/crates/team-agent/src/contract_runtime/pump.rs +0 -271
  88. package/crates/team-agent/src/contract_runtime/registry.rs +0 -589
  89. package/crates/team-agent/src/contract_runtime/workspace.rs +0 -228
  90. package/crates/team-agent/src/coordinator/backoff.rs +0 -741
  91. package/crates/team-agent/src/coordinator/conpty_shim.rs +0 -805
  92. package/crates/team-agent/src/coordinator/health.rs +0 -1185
  93. package/crates/team-agent/src/coordinator/mod.rs +0 -119
  94. package/crates/team-agent/src/coordinator/orphan.rs +0 -110
  95. package/crates/team-agent/src/coordinator/runtime_detectors.rs +0 -798
  96. package/crates/team-agent/src/coordinator/runtime_observation.rs +0 -84
  97. package/crates/team-agent/src/coordinator/steps/abnormal.rs +0 -2309
  98. package/crates/team-agent/src/coordinator/steps/delivery.rs +0 -15
  99. package/crates/team-agent/src/coordinator/steps/health_sync.rs +0 -15
  100. package/crates/team-agent/src/coordinator/steps/mod.rs +0 -126
  101. package/crates/team-agent/src/coordinator/steps/persist.rs +0 -15
  102. package/crates/team-agent/src/coordinator/steps/runtime_prompts.rs +0 -15
  103. package/crates/team-agent/src/coordinator/steps/session_gate.rs +0 -16
  104. package/crates/team-agent/src/coordinator/tests/a0_lostupdate.rs +0 -158
  105. package/crates/team-agent/src/coordinator/tests/abnormal.rs +0 -312
  106. package/crates/team-agent/src/coordinator/tests/api_error_recovery.rs +0 -338
  107. package/crates/team-agent/src/coordinator/tests/basics.rs +0 -211
  108. package/crates/team-agent/src/coordinator/tests/daemon.rs +0 -514
  109. package/crates/team-agent/src/coordinator/tests/energy.rs +0 -549
  110. package/crates/team-agent/src/coordinator/tests/health_sync.rs +0 -461
  111. package/crates/team-agent/src/coordinator/tests/main_preserved.rs +0 -186
  112. package/crates/team-agent/src/coordinator/tests/mod.rs +0 -295
  113. package/crates/team-agent/src/coordinator/tests/s3_bounded.rs +0 -207
  114. package/crates/team-agent/src/coordinator/tests/spine.rs +0 -308
  115. package/crates/team-agent/src/coordinator/tests/takeover.rs +0 -286
  116. package/crates/team-agent/src/coordinator/tests/tick_core.rs +0 -237
  117. package/crates/team-agent/src/coordinator/tick.rs +0 -3112
  118. package/crates/team-agent/src/coordinator/types.rs +0 -540
  119. package/crates/team-agent/src/db/agent_health_capture.rs +0 -126
  120. package/crates/team-agent/src/db/message_store.rs +0 -1585
  121. package/crates/team-agent/src/db/migration.rs +0 -984
  122. package/crates/team-agent/src/db/mod.rs +0 -26
  123. package/crates/team-agent/src/db/schema.rs +0 -663
  124. package/crates/team-agent/src/diagnose/comms.rs +0 -242
  125. package/crates/team-agent/src/diagnose/mod.rs +0 -44
  126. package/crates/team-agent/src/diagnose/orphans.rs +0 -889
  127. package/crates/team-agent/src/event_log.rs +0 -502
  128. package/crates/team-agent/src/fake_worker.rs +0 -303
  129. package/crates/team-agent/src/kill_audit.rs +0 -106
  130. package/crates/team-agent/src/layout/manager.rs +0 -248
  131. package/crates/team-agent/src/layout/mod.rs +0 -36
  132. package/crates/team-agent/src/layout/overlay.rs +0 -134
  133. package/crates/team-agent/src/layout/placement.rs +0 -52
  134. package/crates/team-agent/src/layout/recovery.rs +0 -106
  135. package/crates/team-agent/src/layout/runtime_sessions.rs +0 -317
  136. package/crates/team-agent/src/layout/sessions.rs +0 -294
  137. package/crates/team-agent/src/layout/tmux_endpoint.rs +0 -165
  138. package/crates/team-agent/src/layout/worker_env.rs +0 -721
  139. package/crates/team-agent/src/layout/worker_window_helpers.rs +0 -37
  140. package/crates/team-agent/src/leader/helpers.rs +0 -178
  141. package/crates/team-agent/src/leader/incident.rs +0 -6
  142. package/crates/team-agent/src/leader/lease.rs +0 -3356
  143. package/crates/team-agent/src/leader/mod.rs +0 -104
  144. package/crates/team-agent/src/leader/owner_bind.rs +0 -400
  145. package/crates/team-agent/src/leader/prompt.rs +0 -905
  146. package/crates/team-agent/src/leader/provider_attribution.rs +0 -247
  147. package/crates/team-agent/src/leader/rediscover/tests.rs +0 -689
  148. package/crates/team-agent/src/leader/rediscover.rs +0 -1192
  149. package/crates/team-agent/src/leader/registry.rs +0 -883
  150. package/crates/team-agent/src/leader/start.rs +0 -4500
  151. package/crates/team-agent/src/leader/takeover.rs +0 -65
  152. package/crates/team-agent/src/leader/tests/basics.rs +0 -337
  153. package/crates/team-agent/src/leader/tests/byte_findings.rs +0 -355
  154. package/crates/team-agent/src/leader/tests/claim_leader_mailbox_flush_contract.rs +0 -544
  155. package/crates/team-agent/src/leader/tests/historical_inventory_upgrade_gate_red.rs +0 -624
  156. package/crates/team-agent/src/leader/tests/identity.rs +0 -465
  157. package/crates/team-agent/src/leader/tests/identity_session_names.rs +0 -42
  158. package/crates/team-agent/src/leader/tests/idle.rs +0 -113
  159. package/crates/team-agent/src/leader/tests/lease_api.rs +0 -520
  160. package/crates/team-agent/src/leader/tests/lease_claim.rs +0 -629
  161. package/crates/team-agent/src/leader/tests/mod.rs +0 -106
  162. package/crates/team-agent/src/leader/tests/prompt_contract.rs +0 -267
  163. package/crates/team-agent/src/leader/tests/rediscover.rs +0 -403
  164. package/crates/team-agent/src/leader/tests/rehomed_env.rs +0 -83
  165. package/crates/team-agent/src/leader/tests/team_in_team_state_scope_red.rs +0 -1273
  166. package/crates/team-agent/src/leader/tests/terminal_and_replay_vs_rerender_invariants_red.rs +0 -417
  167. package/crates/team-agent/src/leader/tests/wake_start_owner.rs +0 -168
  168. package/crates/team-agent/src/leader/types.rs +0 -534
  169. package/crates/team-agent/src/lib.rs +0 -145
  170. package/crates/team-agent/src/lifecycle/helpers.rs +0 -212
  171. package/crates/team-agent/src/lifecycle/launch/add_agent.rs +0 -848
  172. package/crates/team-agent/src/lifecycle/launch/add_agent_state.rs +0 -393
  173. package/crates/team-agent/src/lifecycle/launch/agent_state.rs +0 -332
  174. package/crates/team-agent/src/lifecycle/launch/clone_agent.rs +0 -178
  175. package/crates/team-agent/src/lifecycle/launch/fork_agent.rs +0 -82
  176. package/crates/team-agent/src/lifecycle/launch/fork_entry.rs +0 -63
  177. package/crates/team-agent/src/lifecycle/launch/identity.rs +0 -674
  178. package/crates/team-agent/src/lifecycle/launch/layout.rs +0 -350
  179. package/crates/team-agent/src/lifecycle/launch/leader_context.rs +0 -589
  180. package/crates/team-agent/src/lifecycle/launch/mcp_config.rs +0 -152
  181. package/crates/team-agent/src/lifecycle/launch/ownership.rs +0 -105
  182. package/crates/team-agent/src/lifecycle/launch/pi_mcp.rs +0 -629
  183. package/crates/team-agent/src/lifecycle/launch/pi_mcp_extension.js +0 -226
  184. package/crates/team-agent/src/lifecycle/launch/plan.rs +0 -269
  185. package/crates/team-agent/src/lifecycle/launch/quick_start.rs +0 -5176
  186. package/crates/team-agent/src/lifecycle/launch/quick_start_transport.rs +0 -368
  187. package/crates/team-agent/src/lifecycle/launch/readiness.rs +0 -519
  188. package/crates/team-agent/src/lifecycle/launch/role_source.rs +0 -287
  189. package/crates/team-agent/src/lifecycle/launch/spawn.rs +0 -450
  190. package/crates/team-agent/src/lifecycle/launch/spec_state.rs +0 -801
  191. package/crates/team-agent/src/lifecycle/launch/state_projection.rs +0 -624
  192. package/crates/team-agent/src/lifecycle/launch/worker_env.rs +0 -558
  193. package/crates/team-agent/src/lifecycle/launch.rs +0 -534
  194. package/crates/team-agent/src/lifecycle/lock.rs +0 -350
  195. package/crates/team-agent/src/lifecycle/mod.rs +0 -79
  196. package/crates/team-agent/src/lifecycle/pane_input_lock.rs +0 -239
  197. package/crates/team-agent/src/lifecycle/profile_launch.rs +0 -757
  198. package/crates/team-agent/src/lifecycle/profile_smoke.rs +0 -557
  199. package/crates/team-agent/src/lifecycle/restart/agent.rs +0 -2198
  200. package/crates/team-agent/src/lifecycle/restart/common.rs +0 -2052
  201. package/crates/team-agent/src/lifecycle/restart/orchestrator.rs +0 -65
  202. package/crates/team-agent/src/lifecycle/restart/preflight.rs +0 -113
  203. package/crates/team-agent/src/lifecycle/restart/rebuild.rs +0 -5135
  204. package/crates/team-agent/src/lifecycle/restart/remove.rs +0 -1504
  205. package/crates/team-agent/src/lifecycle/restart/selection.rs +0 -559
  206. package/crates/team-agent/src/lifecycle/restart/team_state.rs +0 -329
  207. package/crates/team-agent/src/lifecycle/restart.rs +0 -223
  208. package/crates/team-agent/src/lifecycle/role_config.rs +0 -1205
  209. package/crates/team-agent/src/lifecycle/tests/acceptance_b_batch_red.rs +0 -1021
  210. package/crates/team-agent/src/lifecycle/tests/agent_ops.rs +0 -1205
  211. package/crates/team-agent/src/lifecycle/tests/b0_legacy_snapshot_nonauthority_contract.rs +0 -265
  212. package/crates/team-agent/src/lifecycle/tests/b0_reader_hideone_audit_contract.rs +0 -490
  213. package/crates/team-agent/src/lifecycle/tests/behavioral_diff_264_red.rs +0 -656
  214. package/crates/team-agent/src/lifecycle/tests/claude_profile_launch_red.rs +0 -135
  215. package/crates/team-agent/src/lifecycle/tests/cli_argv_routing_red.rs +0 -1415
  216. package/crates/team-agent/src/lifecycle/tests/clone_agent_preserves_source_tools.rs +0 -427
  217. package/crates/team-agent/src/lifecycle/tests/clone_fork_copilot_perms_red.rs +0 -396
  218. package/crates/team-agent/src/lifecycle/tests/communication_mode_runtime_contract_red.rs +0 -418
  219. package/crates/team-agent/src/lifecycle/tests/copilot_provider_red.rs +0 -2039
  220. package/crates/team-agent/src/lifecycle/tests/core.rs +0 -1298
  221. package/crates/team-agent/src/lifecycle/tests/f032_startup_prompt_best_effort_red.rs +0 -315
  222. package/crates/team-agent/src/lifecycle/tests/fixtures/pi_list_models_g0.stdout.txt +0 -222
  223. package/crates/team-agent/src/lifecycle/tests/fixtures/pi_list_models_spaced_ids.stdout.txt +0 -9
  224. package/crates/team-agent/src/lifecycle/tests/fixtures/pi_native_mcp_host.mjs +0 -71
  225. package/crates/team-agent/src/lifecycle/tests/gate_fixtures.rs +0 -562
  226. package/crates/team-agent/src/lifecycle/tests/grok_require_explicit_model_red.rs +0 -110
  227. package/crates/team-agent/src/lifecycle/tests/harvest2_a_batch_red.rs +0 -472
  228. package/crates/team-agent/src/lifecycle/tests/host_cotenant_death_p0_contract.rs +0 -921
  229. package/crates/team-agent/src/lifecycle/tests/issue238_codex_effort_contract.rs +0 -68
  230. package/crates/team-agent/src/lifecycle/tests/lane_ops.rs +0 -1851
  231. package/crates/team-agent/src/lifecycle/tests/launch_spawn.rs +0 -3981
  232. package/crates/team-agent/src/lifecycle/tests/lifecycle_lock.rs +0 -339
  233. package/crates/team-agent/src/lifecycle/tests/lifecycle_rollback_red.rs +0 -596
  234. package/crates/team-agent/src/lifecycle/tests/main_preserved.rs +0 -513
  235. package/crates/team-agent/src/lifecycle/tests/mcp_tool_name_format_red.rs +0 -69
  236. package/crates/team-agent/src/lifecycle/tests/phase_b_contracts.rs +0 -824
  237. package/crates/team-agent/src/lifecycle/tests/phase_golden.rs +0 -723
  238. package/crates/team-agent/src/lifecycle/tests/pi_catalog_red.rs +0 -152
  239. package/crates/team-agent/src/lifecycle/tests/pi_command_red.rs +0 -182
  240. package/crates/team-agent/src/lifecycle/tests/pi_dual_entry_red.rs +0 -374
  241. package/crates/team-agent/src/lifecycle/tests/pi_executable_mcp_red.rs +0 -546
  242. package/crates/team-agent/src/lifecycle/tests/pi_lifecycle_doctor_red.rs +0 -31
  243. package/crates/team-agent/src/lifecycle/tests/pi_native_mcp_capability_red.rs +0 -528
  244. package/crates/team-agent/src/lifecycle/tests/pi_session_delivery_red.rs +0 -134
  245. package/crates/team-agent/src/lifecycle/tests/quick_start_worker_readiness_red.rs +0 -333
  246. package/crates/team-agent/src/lifecycle/tests/realmachine_clusters_1_6_red.rs +0 -786
  247. package/crates/team-agent/src/lifecycle/tests/realmachine_residual_g1_g4_red.rs +0 -648
  248. package/crates/team-agent/src/lifecycle/tests/restart.rs +0 -185
  249. package/crates/team-agent/src/lifecycle/tests/restart_build_before_destroy_0540_contract.rs +0 -1053
  250. package/crates/team-agent/src/lifecycle/tests/restart_liveness_red.rs +0 -679
  251. package/crates/team-agent/src/lifecycle/tests/restart_rebind_hotfix_252_red.rs +0 -1126
  252. package/crates/team-agent/src/lifecycle/tests/restart_session_capture_red.rs +0 -153
  253. package/crates/team-agent/src/lifecycle/tests/resume_recover_red.rs +0 -427
  254. package/crates/team-agent/src/lifecycle/tests/stale_team_saveconflict_contract.rs +0 -431
  255. package/crates/team-agent/src/lifecycle/tests/startup_latency_contract.rs +0 -1066
  256. package/crates/team-agent/src/lifecycle/tests/status_credential_redaction_contract.rs +0 -876
  257. package/crates/team-agent/src/lifecycle/tests/subprep_codex_trust_roundtrip_red.rs +0 -1026
  258. package/crates/team-agent/src/lifecycle/tests/swallow_batch4_semantics_red.rs +0 -90
  259. package/crates/team-agent/src/lifecycle/tests/team_in_team_identity_scope_red.rs +0 -543
  260. package/crates/team-agent/src/lifecycle/tests/team_in_team_sibling_quick_start_red.rs +0 -1103
  261. package/crates/team-agent/src/lifecycle/tests/team_in_team_state_scope_red.rs +0 -1276
  262. package/crates/team-agent/src/lifecycle/tests/team_key_retirement_roster_red.rs +0 -145
  263. package/crates/team-agent/src/lifecycle/tests/team_key_retirement_txn_red.rs +0 -603
  264. package/crates/team-agent/src/lifecycle/tests/test_isolation_escape_contract.rs +0 -936
  265. package/crates/team-agent/src/lifecycle/tests/upgrade_compat_0211_red.rs +0 -970
  266. package/crates/team-agent/src/lifecycle/tests/verify_rs031_window_consistency_red.rs +0 -996
  267. package/crates/team-agent/src/lifecycle/tests/worker_spawn_env_red.rs +0 -827
  268. package/crates/team-agent/src/lifecycle/tests.rs +0 -102
  269. package/crates/team-agent/src/lifecycle/types.rs +0 -861
  270. package/crates/team-agent/src/lifecycle/worker_command_context.rs +0 -370
  271. package/crates/team-agent/src/main.rs +0 -52
  272. package/crates/team-agent/src/mcp_server/helpers.rs +0 -510
  273. package/crates/team-agent/src/mcp_server/lifecycle_tools/mod.rs +0 -6
  274. package/crates/team-agent/src/mcp_server/lifecycle_tools/state_status.rs +0 -43
  275. package/crates/team-agent/src/mcp_server/mod.rs +0 -119
  276. package/crates/team-agent/src/mcp_server/normalize.rs +0 -485
  277. package/crates/team-agent/src/mcp_server/readiness.rs +0 -546
  278. package/crates/team-agent/src/mcp_server/readiness_tests.rs +0 -369
  279. package/crates/team-agent/src/mcp_server/tests/golden.rs +0 -285
  280. package/crates/team-agent/src/mcp_server/tests/normalize.rs +0 -247
  281. package/crates/team-agent/src/mcp_server/tests/scoped.rs +0 -168
  282. package/crates/team-agent/src/mcp_server/tests/send.rs +0 -388
  283. package/crates/team-agent/src/mcp_server/tests/tools.rs +0 -343
  284. package/crates/team-agent/src/mcp_server/tests/wire.rs +0 -254
  285. package/crates/team-agent/src/mcp_server/tests.rs +0 -43
  286. package/crates/team-agent/src/mcp_server/tools.rs +0 -1015
  287. package/crates/team-agent/src/mcp_server/types.rs +0 -396
  288. package/crates/team-agent/src/mcp_server/wire.rs +0 -867
  289. package/crates/team-agent/src/messaging/activity.rs +0 -461
  290. package/crates/team-agent/src/messaging/address.rs +0 -87
  291. package/crates/team-agent/src/messaging/delivery.rs +0 -3785
  292. package/crates/team-agent/src/messaging/delivery_consumption_tests.rs +0 -234
  293. package/crates/team-agent/src/messaging/enter_rescue.rs +0 -362
  294. package/crates/team-agent/src/messaging/enter_rescue_tests.rs +0 -633
  295. package/crates/team-agent/src/messaging/helpers.rs +0 -354
  296. package/crates/team-agent/src/messaging/leader_channel.rs +0 -287
  297. package/crates/team-agent/src/messaging/leader_receiver.rs +0 -786
  298. package/crates/team-agent/src/messaging/mod.rs +0 -166
  299. package/crates/team-agent/src/messaging/persist.rs +0 -377
  300. package/crates/team-agent/src/messaging/presentation.rs +0 -417
  301. package/crates/team-agent/src/messaging/results/collection_tests.rs +0 -719
  302. package/crates/team-agent/src/messaging/results.rs +0 -1415
  303. package/crates/team-agent/src/messaging/scheduler.rs +0 -217
  304. package/crates/team-agent/src/messaging/selftest.rs +0 -315
  305. package/crates/team-agent/src/messaging/send.rs +0 -981
  306. package/crates/team-agent/src/messaging/tests/basic.rs +0 -346
  307. package/crates/team-agent/src/messaging/tests/dup_inject.rs +0 -551
  308. package/crates/team-agent/src/messaging/tests/e23.rs +0 -49
  309. package/crates/team-agent/src/messaging/tests/leader_channel.rs +0 -169
  310. package/crates/team-agent/src/messaging/tests/leader_inject_acceptance.rs +0 -817
  311. package/crates/team-agent/src/messaging/tests/main_preserved.rs +0 -85
  312. package/crates/team-agent/src/messaging/tests/mod.rs +0 -306
  313. package/crates/team-agent/src/messaging/tests/runtime.rs +0 -3655
  314. package/crates/team-agent/src/messaging/tests/spine.rs +0 -837
  315. package/crates/team-agent/src/messaging/tests/wave2.rs +0 -381
  316. package/crates/team-agent/src/messaging/trust.rs +0 -215
  317. package/crates/team-agent/src/messaging/types.rs +0 -471
  318. package/crates/team-agent/src/messaging/wait.rs +0 -366
  319. package/crates/team-agent/src/messaging/watchers.rs +0 -916
  320. package/crates/team-agent/src/model/enums.rs +0 -356
  321. package/crates/team-agent/src/model/errors.rs +0 -18
  322. package/crates/team-agent/src/model/ids.rs +0 -165
  323. package/crates/team-agent/src/model/mod.rs +0 -29
  324. package/crates/team-agent/src/model/name_similarity.rs +0 -252
  325. package/crates/team-agent/src/model/pane_authority_refusal.rs +0 -359
  326. package/crates/team-agent/src/model/paths.rs +0 -257
  327. package/crates/team-agent/src/model/routing.rs +0 -387
  328. package/crates/team-agent/src/model/spec.rs +0 -1184
  329. package/crates/team-agent/src/model/task_graph.rs +0 -321
  330. package/crates/team-agent/src/model/testdata/fuzz.golden.yaml +0 -43
  331. package/crates/team-agent/src/model/testdata/fuzz.yaml +0 -43
  332. package/crates/team-agent/src/model/testdata/spec_invalid_a.yaml +0 -209
  333. package/crates/team-agent/src/model/testdata/team.spec.golden.yaml +0 -208
  334. package/crates/team-agent/src/model/testdata/team.spec.yaml +0 -208
  335. package/crates/team-agent/src/model/yaml/tests.rs +0 -188
  336. package/crates/team-agent/src/model/yaml.rs +0 -802
  337. package/crates/team-agent/src/os_probe.rs +0 -280
  338. package/crates/team-agent/src/packaging/install.rs +0 -219
  339. package/crates/team-agent/src/packaging/migrate.rs +0 -38
  340. package/crates/team-agent/src/packaging/mod.rs +0 -91
  341. package/crates/team-agent/src/packaging/repair.rs +0 -33
  342. package/crates/team-agent/src/packaging/tests.rs +0 -822
  343. package/crates/team-agent/src/packaging/types.rs +0 -417
  344. package/crates/team-agent/src/platform/argv.rs +0 -331
  345. package/crates/team-agent/src/platform/errors.rs +0 -104
  346. package/crates/team-agent/src/platform/file_lock.rs +0 -279
  347. package/crates/team-agent/src/platform/mod.rs +0 -5
  348. package/crates/team-agent/src/platform/process.rs +0 -545
  349. package/crates/team-agent/src/provider/adapter.rs +0 -898
  350. package/crates/team-agent/src/provider/adapters/copilot.rs +0 -75
  351. package/crates/team-agent/src/provider/adapters/copilot_fork.rs +0 -307
  352. package/crates/team-agent/src/provider/adapters/fake.rs +0 -18
  353. package/crates/team-agent/src/provider/adapters/mod.rs +0 -28
  354. package/crates/team-agent/src/provider/approvals/mod.rs +0 -3
  355. package/crates/team-agent/src/provider/approvals/parsing.rs +0 -586
  356. package/crates/team-agent/src/provider/approvals/runtime_prompts.rs +0 -205
  357. package/crates/team-agent/src/provider/argv_route.rs +0 -405
  358. package/crates/team-agent/src/provider/bypass_flags.rs +0 -116
  359. package/crates/team-agent/src/provider/classify.rs +0 -773
  360. package/crates/team-agent/src/provider/command_helpers.rs +0 -45
  361. package/crates/team-agent/src/provider/faults.rs +0 -165
  362. package/crates/team-agent/src/provider/helpers.rs +0 -52
  363. package/crates/team-agent/src/provider/mod.rs +0 -78
  364. package/crates/team-agent/src/provider/model_catalog.rs +0 -722
  365. package/crates/team-agent/src/provider/session/capture.rs +0 -2631
  366. package/crates/team-agent/src/provider/session/context_fork/outcome.rs +0 -168
  367. package/crates/team-agent/src/provider/session/context_fork.rs +0 -264
  368. package/crates/team-agent/src/provider/session/mod.rs +0 -36
  369. package/crates/team-agent/src/provider/session/resume.rs +0 -269
  370. package/crates/team-agent/src/provider/session_scan/common/tests.rs +0 -316
  371. package/crates/team-agent/src/provider/session_scan/common.rs +0 -618
  372. package/crates/team-agent/src/provider/session_scan/copilot.rs +0 -280
  373. package/crates/team-agent/src/provider/session_scan/pi.rs +0 -152
  374. package/crates/team-agent/src/provider/session_scan.rs +0 -61
  375. package/crates/team-agent/src/provider/startup_prompt.rs +0 -757
  376. package/crates/team-agent/src/provider/submit_now.rs +0 -71
  377. package/crates/team-agent/src/provider/testdata/copilot-ready-marker.txt +0 -5
  378. package/crates/team-agent/src/provider/testdata/copilot-trust-prompt.txt +0 -19
  379. package/crates/team-agent/src/provider/testdata/grok-models-authenticated.stdout +0 -9
  380. package/crates/team-agent/src/provider/testdata/grok-models-unauthenticated.stdout +0 -7
  381. package/crates/team-agent/src/provider/tests/adapter.rs +0 -354
  382. package/crates/team-agent/src/provider/tests/classify.rs +0 -201
  383. package/crates/team-agent/src/provider/tests/command_helpers.rs +0 -26
  384. package/crates/team-agent/src/provider/tests/copilot_fork.rs +0 -191
  385. package/crates/team-agent/src/provider/tests/faults.rs +0 -200
  386. package/crates/team-agent/src/provider/tests/idle.rs +0 -140
  387. package/crates/team-agent/src/provider/tests/wire.rs +0 -213
  388. package/crates/team-agent/src/provider/tests.rs +0 -32
  389. package/crates/team-agent/src/provider/types.rs +0 -529
  390. package/crates/team-agent/src/provider/wire.rs +0 -406
  391. package/crates/team-agent/src/redaction.rs +0 -259
  392. package/crates/team-agent/src/state/abnormal_watch/tests/mod.rs +0 -248
  393. package/crates/team-agent/src/state/abnormal_watch.rs +0 -144
  394. package/crates/team-agent/src/state/identity.rs +0 -914
  395. package/crates/team-agent/src/state/identity_keys.rs +0 -132
  396. package/crates/team-agent/src/state/mod.rs +0 -74
  397. package/crates/team-agent/src/state/owner_gate.rs +0 -482
  398. package/crates/team-agent/src/state/ownership.rs +0 -563
  399. package/crates/team-agent/src/state/paths.rs +0 -395
  400. package/crates/team-agent/src/state/persist.rs +0 -3811
  401. package/crates/team-agent/src/state/projection.rs +0 -1508
  402. package/crates/team-agent/src/state/repository/intent.rs +0 -14
  403. package/crates/team-agent/src/state/repository/tests.rs +0 -184
  404. package/crates/team-agent/src/state/repository.rs +0 -866
  405. package/crates/team-agent/src/state/selector.rs +0 -160
  406. package/crates/team-agent/src/state/testdata/state-rich.canonical.json +0 -133
  407. package/crates/team-agent/src/tmux_backend/enter_rescue.rs +0 -325
  408. package/crates/team-agent/src/tmux_backend/enter_rescue_tests.rs +0 -432
  409. package/crates/team-agent/src/tmux_backend/native_input.rs +0 -513
  410. package/crates/team-agent/src/tmux_backend/native_input_tests.rs +0 -742
  411. package/crates/team-agent/src/tmux_backend/tests.rs +0 -4254
  412. package/crates/team-agent/src/tmux_backend.rs +0 -4527
  413. package/crates/team-agent/src/topology.rs +0 -537
  414. package/crates/team-agent/src/transport/enter_rescue.rs +0 -166
  415. package/crates/team-agent/src/transport/native_input.rs +0 -491
  416. package/crates/team-agent/src/transport/test_support.rs +0 -743
  417. package/crates/team-agent/src/transport/tests/behavior.rs +0 -326
  418. package/crates/team-agent/src/transport/tests/mod.rs +0 -194
  419. package/crates/team-agent/src/transport/tests/wire.rs +0 -574
  420. package/crates/team-agent/src/transport.rs +0 -1655
  421. package/crates/team-agent/src/transport_factory.rs +0 -819
@@ -1,3785 +0,0 @@
1
- //! ---
2
- //! purpose: 把已认领消息注入目标 pane 并记录投递阶段
3
- //! contract:
4
- //! provides:
5
- //! - name: deliver_stored_message
6
- //! what: 单次物理注入;grok 队列默认再按回车顶出
7
- //! boundary:
8
- //! - 不把物理 success 写成 delivered
9
- //! - 不重粘文本
10
- //! - error-bypass(target_resolved+error)只经 claim 原子闸,禁止旁路双投
11
- //! - 物理 Enter 已出(pane/转录已有 token)后 observer/state 落盘失败不得返 Err 重投
12
- //! - 提交前持久化失败仍返 Err,由 batch 记 item_blocked 隔离
13
- //! - 同 message_id 的 token 已在 pane/转录则拒绝二次注入
14
- //! maturity: wired
15
- //! ---
16
- //!
17
- //! internal_delivery.py + delivery.py — coordinator/调度器侧 thin wrapper + 单条 tmux 注入投递
18
- //! + trust 有界重试 + turn-open arm (card §16/§65)。
19
-
20
- use std::cell::{Cell, RefCell};
21
- use std::path::Path;
22
-
23
- use rusqlite::{params, OptionalExtension};
24
-
25
- use crate::event_log::EventLog;
26
- use crate::message_store::MessageStore;
27
- use crate::model::enums::{PaneLiveness, Provider};
28
- use crate::model::ids::TeamKey;
29
- use crate::provider::wire::parse_canonical_provider;
30
- use crate::transport::{
31
- submit_verification_wire, turn_verification_wire, BusySignalKind, CaptureRange,
32
- CaptureSampleOutcome, InjectPayload, InjectReport, InjectVerification, InputSurfaceProbe, Key,
33
- PaneId, PaneInfo, QueryOutcome, SessionName, SubmitConsumptionReason, SubmitObserver,
34
- SubmitVerification, Target, Transport, WindowName,
35
- };
36
-
37
- use super::helpers::{message_exists, MessageStatusShadow};
38
- use super::{
39
- DeliveryOutcome, DeliveryRefusal, DeliveryStage, DeliveryStatus, MessagingError,
40
- PaneWidthQuery, TrustRetryPayload, SEND_RETRY_MAX_ATTEMPTS,
41
- };
42
- use crate::state::projection::OwnerTeamResolution;
43
-
44
- // ===========================================================================
45
- // internal_delivery.py — coordinator/调度器侧 thin wrapper (card §65)
46
- // ===========================================================================
47
-
48
- /// `deliver_stored_message` (`internal_delivery.py:16`):coordinator/调度器侧 team-scoped 单发
49
- /// (不重路由)。加 `_runtime_lock("send")`,直走 `_send_single_message_unlocked`。
50
- #[allow(clippy::too_many_arguments)]
51
- pub fn deliver_stored_message(
52
- workspace: &Path,
53
- target: Option<&str>,
54
- content: &str,
55
- task_id: Option<&crate::model::ids::TaskId>,
56
- sender: &str,
57
- requires_ack: bool,
58
- wait_visible: bool,
59
- timeout: f64,
60
- team: Option<&TeamKey>,
61
- ) -> Result<DeliveryOutcome, MessagingError> {
62
- let _ = (wait_visible, timeout);
63
- let recipient = target.unwrap_or("leader");
64
- let super::PersistResolution::Persisted(persisted) = super::persist::persist_internal_send(
65
- workspace,
66
- super::InternalSendKind::Delivery,
67
- team.map(TeamKey::as_str),
68
- task_id.map(crate::model::ids::TaskId::as_str),
69
- sender,
70
- recipient,
71
- content,
72
- None,
73
- requires_ack,
74
- None,
75
- super::InitialDisposition::Accepted,
76
- None,
77
- )?
78
- else {
79
- unreachable!("internal delivery does not accept caller-supplied ids")
80
- };
81
- let message_status = persisted.row_status.as_str().to_string();
82
- let message_id = persisted.message_id;
83
- Ok(DeliveryOutcome {
84
- ok: true,
85
- status: DeliveryStatus::Queued,
86
- message_status: MessageStatusShadow(message_status),
87
- message_id: Some(message_id),
88
- verification: None,
89
- stage: None,
90
- reason: None,
91
- channel: None,
92
- ack_forced_off: false,
93
- turn_verification: None,
94
- })
95
- }
96
-
97
- pub fn deliver_persisted_message(
98
- workspace: &Path,
99
- transport: &dyn Transport,
100
- message_id: &str,
101
- event_log: &EventLog,
102
- state: &serde_json::Value,
103
- ) -> Result<DeliveryOutcome, MessagingError> {
104
- let store = MessageStore::open(workspace)?;
105
- deliver_pending_message(workspace, &store, transport, message_id, event_log, state)
106
- }
107
-
108
- // ===========================================================================
109
- // delivery.py — 单条 tmux 注入投递 + trust 有界重试 + turn-open arm (card §16)
110
- // ===========================================================================
111
-
112
- /// `_tmux_pane_width` (`delivery.py:20`):查询 pane 列宽。**fail-safe** (bug-064/082):失败
113
- /// 返回 [`PaneWidthQuery::Failed`],**绝不**给默认宽度。借 step 9 transport 的 query。
114
- pub(crate) fn tmux_pane_width(transport: &dyn Transport, target: &Target) -> PaneWidthQuery {
115
- let queried = std::panic::catch_unwind(std::panic::AssertUnwindSafe(|| {
116
- transport.query(target, crate::transport::PaneField::PaneWidth)
117
- }));
118
- let result = match queried {
119
- Ok(result) => result,
120
- Err(_) => {
121
- return PaneWidthQuery::Failed {
122
- error: "tmux_query_failed:panic".to_string(),
123
- };
124
- }
125
- };
126
- match result {
127
- Ok(Some(raw)) => match raw.trim().parse::<u32>() {
128
- Ok(pane_width) if pane_width > 0 => PaneWidthQuery::Ok { pane_width },
129
- Ok(_) => PaneWidthQuery::Failed {
130
- error: "non_positive_width".to_string(),
131
- },
132
- Err(_) => PaneWidthQuery::Failed {
133
- error: "unparseable_output".to_string(),
134
- },
135
- },
136
- Ok(None) => PaneWidthQuery::Failed {
137
- error: "empty_output".to_string(),
138
- },
139
- Err(err) => PaneWidthQuery::Failed {
140
- error: format!("tmux_query_failed:{err}"),
141
- },
142
- }
143
- }
144
-
145
- pub(crate) fn worker_target_missing_due_to_stale_binding(
146
- state: &serde_json::Value,
147
- recipient: &str,
148
- transport: &dyn Transport,
149
- ) -> bool {
150
- let Some(agent) = state.get("agents").and_then(|agents| agents.get(recipient)) else {
151
- return false;
152
- };
153
- let session = state
154
- .get("session_name")
155
- .and_then(serde_json::Value::as_str)
156
- .unwrap_or_default();
157
- let window = agent
158
- .get("window")
159
- .and_then(serde_json::Value::as_str)
160
- .filter(|s| !s.is_empty())
161
- .unwrap_or(recipient);
162
- let Some(cached_pane) = agent
163
- .get("pane_id")
164
- .and_then(serde_json::Value::as_str)
165
- .filter(|s| !s.is_empty())
166
- else {
167
- return false;
168
- };
169
- let Ok(live_targets) = transport.list_targets() else {
170
- return false;
171
- };
172
- if live_pane_for_session_window(&live_targets, session, window).is_some() {
173
- return false;
174
- }
175
- live_targets.iter().any(|target| {
176
- target.pane_id.as_str() == cached_pane
177
- && stale_worker_pane_binding(target, session, window).is_some()
178
- })
179
- }
180
-
181
- /// `_deliver_pending_message` (`delivery.py:63`):对一条消息做 tmux 注入投递 (含 trust 提示
182
- /// 自动应答 + turn-open arm + first_send_at 戳)。daemon-path → Result。
183
- pub fn deliver_pending_message(
184
- workspace: &Path,
185
- store: &MessageStore,
186
- transport: &dyn Transport,
187
- message_id: &str,
188
- event_log: &EventLog,
189
- state: &serde_json::Value,
190
- ) -> Result<DeliveryOutcome, MessagingError> {
191
- if !message_exists(store, message_id)? {
192
- return Ok(DeliveryOutcome {
193
- ok: false,
194
- status: DeliveryStatus::Failed,
195
- message_status: MessageStatusShadow("failed".to_string()),
196
- message_id: Some(message_id.to_string()),
197
- verification: None,
198
- stage: None,
199
- reason: None,
200
- channel: None,
201
- ack_forced_off: false,
202
- turn_verification: None,
203
- });
204
- }
205
- let message = message_for_delivery(store, message_id)?;
206
- let Some(message) = message else {
207
- return Ok(DeliveryOutcome {
208
- ok: false,
209
- status: DeliveryStatus::Failed,
210
- message_status: MessageStatusShadow("failed".to_string()),
211
- message_id: Some(message_id.to_string()),
212
- verification: None,
213
- stage: None,
214
- reason: Some(DeliveryRefusal::UnknownRecipient),
215
- channel: None,
216
- ack_forced_off: false,
217
- turn_verification: None,
218
- });
219
- };
220
- match prepare_message_state(
221
- workspace, store, message_id, event_log, state, &message, false,
222
- )? {
223
- Ok(prepared) => deliver_prepared_message(
224
- workspace, store, transport, message_id, event_log, state, message, prepared,
225
- ),
226
- Err(outcome) => Ok(outcome),
227
- }
228
- }
229
-
230
- // Thread-local observation only; no production cache or scheduling hook.
231
- #[cfg(test)]
232
- pub(super) mod preparation_probe {
233
- std::thread_local! {
234
- pub static COUNTS: std::cell::Cell<(usize, usize, usize)> = const { std::cell::Cell::new((0, 0, 0)) };
235
- pub static BEFORE_CLAIM: std::cell::RefCell<Option<Box<dyn FnOnce()>>> = const { std::cell::RefCell::new(None) };
236
- }
237
- }
238
-
239
- struct PreparedMessageState {
240
- scoped: Option<serde_json::Value>,
241
- canonical_owner_team_id: Option<String>,
242
- }
243
-
244
- fn prepare_message_state(
245
- workspace: &Path,
246
- store: &MessageStore,
247
- message_id: &str,
248
- event_log: &EventLog,
249
- state: &serde_json::Value,
250
- message: &PendingMessage,
251
- batch: bool,
252
- ) -> Result<Result<PreparedMessageState, DeliveryOutcome>, MessagingError> {
253
- #[cfg(test)]
254
- preparation_probe::COUNTS.with(|counts| {
255
- let (prepare, project, claim) = counts.get();
256
- counts.set((prepare + 1, project, claim));
257
- });
258
- let mut prepared = PreparedMessageState {
259
- scoped: None,
260
- canonical_owner_team_id: message.owner_team_id.clone(),
261
- };
262
- if let Some(team) = message
263
- .owner_team_id
264
- .as_deref()
265
- .filter(|team| !team.is_empty())
266
- {
267
- match project_state_for_owner_team(
268
- workspace,
269
- team,
270
- state,
271
- Some(store),
272
- Some(message_id),
273
- Some(event_log),
274
- )? {
275
- OwnerTeamProjection::Projected {
276
- state,
277
- canonical_team,
278
- } => {
279
- prepared.scoped = Some(state);
280
- prepared.canonical_owner_team_id = Some(canonical_team);
281
- }
282
- OwnerTeamProjection::Refused(outcome) => {
283
- if batch {
284
- let _ = event_log.write(
285
- "delivery.projection_refused",
286
- serde_json::json!({
287
- "message_id": message_id,
288
- "owner_team_id": team,
289
- "status": super::helpers::status_wire(outcome.status),
290
- "verification": outcome.verification,
291
- "reason": format!("{:?}", outcome.reason),
292
- }),
293
- );
294
- }
295
- return Ok(Err(outcome));
296
- }
297
- }
298
- }
299
- Ok(Ok(prepared))
300
- }
301
-
302
- /// #372: how long a seat may wait for its MCP handshake, counted from its
303
- /// spawn or the message's creation (whichever is later), before the message
304
- /// parks instead of re-polling every tick.
305
- #[cfg(unix)]
306
- const MCP_HANDSHAKE_WAIT_LIMIT_SECS: i64 = 300;
307
-
308
- #[cfg(unix)]
309
- #[allow(clippy::too_many_arguments)]
310
- fn mcp_handshake_pending_outcome(
311
- workspace: &Path,
312
- store: &MessageStore,
313
- event_log: &EventLog,
314
- state: &serde_json::Value,
315
- owner: Option<&str>,
316
- message_id: &str,
317
- message: &PendingMessage,
318
- attempt: u32,
319
- reason: &str,
320
- ) -> Result<DeliveryOutcome, MessagingError> {
321
- let already_claimed = || DeliveryOutcome {
322
- ok: false,
323
- status: DeliveryStatus::Refused,
324
- message_status: MessageStatusShadow("target_resolved".to_string()),
325
- message_id: Some(message_id.to_string()),
326
- verification: None,
327
- stage: None,
328
- reason: Some(DeliveryRefusal::MessageAlreadyClaimed),
329
- channel: None,
330
- ack_forced_off: false,
331
- turn_verification: None,
332
- };
333
- let spawned_at = state["agents"][message.recipient.as_str()]["spawned_at"].as_str();
334
- let waited_s = [spawned_at, message.created_at.as_deref()]
335
- .into_iter()
336
- .flatten()
337
- .filter_map(|at| chrono::DateTime::parse_from_rfc3339(at).ok())
338
- .max()
339
- .map_or(0, |since| {
340
- (chrono::Utc::now() - since.with_timezone(&chrono::Utc)).num_seconds()
341
- });
342
- if waited_s >= MCP_HANDSHAKE_WAIT_LIMIT_SECS {
343
- if !store.park_delivery_before_input(message_id, attempt)? {
344
- return Ok(already_claimed());
345
- }
346
- // A receipt published between this preflight and the park found no
347
- // parked row to resume; one re-check keeps that publication from being lost.
348
- let published_meanwhile = owner.is_some_and(|owner| {
349
- crate::mcp_server::readiness::preflight(workspace, Some(owner), &message.recipient, state)
350
- .is_ok()
351
- });
352
- if published_meanwhile {
353
- store.requeue_parked_deliveries(&message.recipient, owner.unwrap_or_default())?;
354
- } else {
355
- event_log.write("delivery.mcp_handshake_parked", serde_json::json!({
356
- "message_id": message_id,
357
- "recipient": message.recipient,
358
- "reason": reason,
359
- "waited_s": waited_s,
360
- }))?;
361
- notify_mcp_handshake_parked(workspace, store, event_log, state, &message.recipient, reason, waited_s)?;
362
- }
363
- return Ok(DeliveryOutcome {
364
- ok: false,
365
- status: DeliveryStatus::Blocked,
366
- message_status: MessageStatusShadow(
367
- if published_meanwhile { "accepted" } else { "queued_until_start" }.to_string(),
368
- ),
369
- message_id: Some(message_id.to_string()),
370
- verification: Some(format!("{}:{reason}", crate::message_store::MCP_HANDSHAKE_TIMEOUT)),
371
- stage: None,
372
- reason: None,
373
- channel: None,
374
- ack_forced_off: false,
375
- turn_verification: None,
376
- });
377
- }
378
- // No paste/key has occurred. Only this exact claim may be released; a
379
- // concurrent cancellation or newer delivery must never be overwritten.
380
- if !store.release_delivery_before_input(message_id, attempt, reason)? {
381
- return Ok(already_claimed());
382
- }
383
- event_log.write("delivery.deferred_mcp_handshake", serde_json::json!({
384
- "message_id": message_id,
385
- "recipient": message.recipient,
386
- "reason": reason,
387
- "waited_s": waited_s,
388
- "effect": "none",
389
- }))?;
390
- Ok(DeliveryOutcome {
391
- ok: false,
392
- status: DeliveryStatus::Degraded,
393
- message_status: MessageStatusShadow("target_resolved".to_string()),
394
- message_id: Some(message_id.to_string()),
395
- verification: Some(reason.to_string()),
396
- stage: None,
397
- reason: None,
398
- channel: None,
399
- ack_forced_off: false,
400
- turn_verification: None,
401
- })
402
- }
403
-
404
- /// One leader notice per seat spawn; later parks of the same spawn stay quiet.
405
- #[cfg(unix)]
406
- fn notify_mcp_handshake_parked(
407
- workspace: &Path,
408
- store: &MessageStore,
409
- event_log: &EventLog,
410
- state: &serde_json::Value,
411
- recipient: &str,
412
- reason: &str,
413
- waited_s: i64,
414
- ) -> Result<(), MessagingError> {
415
- let agent = &state["agents"][recipient];
416
- let result_id = format!(
417
- "mcp_handshake.timeout:{recipient}:{}",
418
- agent["spawned_at"].as_str().unwrap_or("unknown")
419
- );
420
- let notified = crate::db::schema::open_db(store.db_path())?
421
- .query_row(
422
- "select 1 from leader_notification_log where result_id = ?1 limit 1",
423
- params![result_id],
424
- |_| Ok(()),
425
- )
426
- .optional()?
427
- .is_some();
428
- if notified {
429
- return Ok(());
430
- }
431
- let live = agent["pane_pid"]
432
- .as_u64()
433
- .and_then(|pid| u32::try_from(pid).ok())
434
- .map(crate::mcp_server::readiness::live_servers_under)
435
- .unwrap_or_default();
436
- let live = if live.is_empty() { "none".to_string() } else { format!("{live:?}") };
437
- let content = format!(
438
- "mcp_handshake.timeout\nerror: messages to {recipient} are parked after waiting {waited_s}s for its MCP handshake ({reason}); live mcp-server pids under its pane: {live}\naction: run team-agent restart {recipient}; parked messages resume automatically once its MCP server publishes a handshake\nlog: .team/logs/events.jsonl"
439
- );
440
- let outcome = crate::messaging::send_to_leader_receiver(
441
- workspace, state, "leader", &content, None, "coordinator", false, Some(&result_id), event_log,
442
- );
443
- event_log.write("delivery.mcp_handshake_parked_notification", serde_json::json!({
444
- "recipient": recipient,
445
- "result_id": result_id,
446
- "live_mcp_servers": live,
447
- "error": outcome.err().map(|error| error.to_string()),
448
- }))?;
449
- Ok(())
450
- }
451
-
452
- fn deliver_prepared_message(
453
- workspace: &Path,
454
- store: &MessageStore,
455
- transport: &dyn Transport,
456
- message_id: &str,
457
- event_log: &EventLog,
458
- fallback: &serde_json::Value,
459
- message: PendingMessage,
460
- prepared: PreparedMessageState,
461
- ) -> Result<DeliveryOutcome, MessagingError> {
462
- let canonical_owner_team_id = prepared.canonical_owner_team_id;
463
- let state = prepared.scoped.as_ref().unwrap_or(fallback);
464
- crate::provider::wire::require_active_state_providers(state, Some(&message.recipient))
465
- .map_err(|error| MessagingError::Provider(error.into()))?;
466
- if message.recipient == "leader"
467
- && matches!(
468
- message.status.as_str(),
469
- "submitted_pending_acceptance" | "injected_awaiting_receipt"
470
- )
471
- {
472
- return observe_pending_leader_acceptance(store, event_log, state, message_id);
473
- }
474
- if message.recipient == "leader" && message.status == "queued_until_leader_attach" {
475
- let Some(receiver) = leader_receiver_value(state) else {
476
- return Ok(leader_acceptance_pending_outcome(
477
- message_id,
478
- "queued_until_leader_attach",
479
- ));
480
- };
481
- let channel_transport =
482
- delivery_transport_for_recipient(workspace, transport, state, "leader");
483
- let resolution = crate::messaging::resolve_live_leader_channel(
484
- workspace,
485
- receiver,
486
- channel_transport.as_transport(),
487
- );
488
- let crate::messaging::LeaderChannelResolution::Live(channel) = resolution else {
489
- return Ok(leader_acceptance_pending_outcome(
490
- message_id,
491
- "queued_until_leader_attach",
492
- ));
493
- };
494
- let metadata_drift = match &channel {
495
- crate::messaging::LiveLeaderChannel::DirectTmux(channel) => {
496
- channel.metadata_drift.clone()
497
- }
498
- crate::messaging::LiveLeaderChannel::CodexAppServer(_) => Vec::new(),
499
- };
500
- store.mark(message_id, "accepted", None)?;
501
- event_log.write(
502
- "leader_receiver.mailbox_requeued",
503
- serde_json::json!({
504
- "message_id": message_id,
505
- "channel_live": true,
506
- "metadata_drift": metadata_drift,
507
- "requeue_trigger": "delivery_revalidation",
508
- "revalidated_at": chrono::Utc::now().to_rfc3339(),
509
- }),
510
- )?;
511
- }
512
- #[cfg(test)]
513
- {
514
- preparation_probe::BEFORE_CLAIM.with(|hook| {
515
- if let Some(hook) = hook.borrow_mut().take() {
516
- hook();
517
- }
518
- });
519
- preparation_probe::COUNTS.with(|counts| {
520
- let (prepare, project, claim) = counts.get();
521
- counts.set((prepare, project, claim + 1));
522
- });
523
- }
524
- let attempt = if store.claim_for_delivery(message_id)? {
525
- message.delivery_attempts.saturating_add(1)
526
- } else {
527
- return Ok(DeliveryOutcome {
528
- ok: false,
529
- status: DeliveryStatus::Refused,
530
- message_status: MessageStatusShadow("target_resolved".to_string()),
531
- message_id: Some(message_id.to_string()),
532
- verification: None,
533
- stage: None,
534
- reason: Some(DeliveryRefusal::MessageAlreadyClaimed),
535
- channel: None,
536
- ack_forced_off: false,
537
- turn_verification: None,
538
- });
539
- };
540
- // Attach may requeue this row after the coordinator captured `state` but
541
- // before this claim. Revalidate through the same owner-team projection
542
- // that carries a canonical top-level leader binding into the scoped view.
543
- let fresh_leader_state = if message.recipient == "leader" {
544
- Some(match canonical_owner_team_id.as_deref() {
545
- Some(team) => match project_state_for_owner_team(
546
- workspace,
547
- team,
548
- &serde_json::Value::Null,
549
- Some(store),
550
- Some(message_id),
551
- Some(event_log),
552
- )? {
553
- OwnerTeamProjection::Projected { state, .. } => state,
554
- OwnerTeamProjection::Refused(outcome) => return Ok(outcome),
555
- },
556
- None => crate::state::persist::load_runtime_state(workspace)?,
557
- })
558
- } else {
559
- None
560
- };
561
- let state = fresh_leader_state.as_ref().unwrap_or(state);
562
- if message.recipient == "leader" {
563
- let Some(receiver) = leader_receiver_value(state) else {
564
- store.mark(message_id, "failed", Some("leader_not_attached"))?;
565
- event_log.write(
566
- "leader_receiver.delivery_blocked",
567
- serde_json::json!({
568
- "message_id": message_id,
569
- "sender": message.sender,
570
- "reason": "leader_receiver_not_attached",
571
- "error": "leader_not_attached",
572
- "channel_reason": "receiver_missing",
573
- "channel": "rebind_required",
574
- "action": "run team-agent attach-leader or team-agent takeover",
575
- "status": "unbound",
576
- }),
577
- )?;
578
- return Ok(DeliveryOutcome {
579
- ok: false,
580
- status: DeliveryStatus::Refused,
581
- message_status: MessageStatusShadow("failed".to_string()),
582
- message_id: Some(message_id.to_string()),
583
- verification: Some(
584
- "run team-agent attach-leader or team-agent takeover".to_string(),
585
- ),
586
- stage: None,
587
- reason: Some(DeliveryRefusal::LeaderNotAttached),
588
- channel: Some("rebind_required".to_string()),
589
- ack_forced_off: false,
590
- turn_verification: None,
591
- });
592
- };
593
- if let Some(outcome) = leader_receiver_transport_conflict_outcome(
594
- store,
595
- event_log,
596
- message_id,
597
- receiver,
598
- &message.sender,
599
- )? {
600
- return Ok(outcome);
601
- }
602
- let channel_transport =
603
- delivery_transport_for_recipient(workspace, transport, state, "leader");
604
- match crate::messaging::resolve_live_leader_channel(
605
- workspace,
606
- receiver,
607
- channel_transport.as_transport(),
608
- ) {
609
- crate::messaging::LeaderChannelResolution::Live(_) => {}
610
- crate::messaging::LeaderChannelResolution::ProbeFailed(error) => {
611
- store.mark(message_id, "target_resolved", Some(&error))?;
612
- return Ok(DeliveryOutcome {
613
- ok: false,
614
- status: DeliveryStatus::Degraded,
615
- message_status: MessageStatusShadow("target_resolved".to_string()),
616
- message_id: Some(message_id.to_string()),
617
- verification: Some(error),
618
- stage: None,
619
- reason: None,
620
- channel: Some("rebind_required".to_string()),
621
- ack_forced_off: false,
622
- turn_verification: None,
623
- });
624
- }
625
- crate::messaging::LeaderChannelResolution::Unbound(reason) => {
626
- let receiver_status = receiver
627
- .get("status")
628
- .and_then(serde_json::Value::as_str)
629
- .unwrap_or("unbound");
630
- let refusal = match &reason {
631
- crate::messaging::LeaderChannelUnbound::PaneWorkspaceMismatch(_) => {
632
- DeliveryRefusal::PaneWorkspaceMismatch
633
- }
634
- _ => DeliveryRefusal::LeaderNotAttached,
635
- };
636
- store.mark(message_id, "failed", Some("leader_not_attached"))?;
637
- event_log.write(
638
- "leader_receiver.delivery_blocked",
639
- serde_json::json!({
640
- "message_id": message_id,
641
- "sender": message.sender,
642
- "reason": "leader_receiver_not_attached",
643
- "error": "leader_not_attached",
644
- "channel_reason": reason.reason_code(),
645
- "channel": "rebind_required",
646
- "action": "run team-agent attach-leader or team-agent takeover",
647
- "status": receiver_status,
648
- }),
649
- )?;
650
- return Ok(DeliveryOutcome {
651
- ok: false,
652
- status: DeliveryStatus::Refused,
653
- message_status: MessageStatusShadow("failed".to_string()),
654
- message_id: Some(message_id.to_string()),
655
- verification: Some(
656
- "run team-agent attach-leader or team-agent takeover".to_string(),
657
- ),
658
- stage: None,
659
- reason: Some(refusal),
660
- channel: Some("rebind_required".to_string()),
661
- ack_forced_off: false,
662
- turn_verification: None,
663
- });
664
- }
665
- }
666
- if crate::codex_app_server::receiver_is_app_server(receiver) {
667
- return deliver_leader_via_app_server(
668
- store,
669
- event_log,
670
- state,
671
- message_id,
672
- &message,
673
- canonical_owner_team_id.as_deref(),
674
- );
675
- }
676
- }
677
- let delivery_transport =
678
- delivery_transport_for_recipient(workspace, transport, state, &message.recipient);
679
- let transport = delivery_transport.as_transport();
680
- // U1-B: probe `list_targets()` ONCE per delivery and DEFER on Err. The prior
681
- // `.unwrap_or_default()` coerced server jitter (Err = subprocess fork failed)
682
- // to an empty vec, and the downstream cache-reuse branch
683
- // (`live_targets.is_empty() && !known_dead`) would then inject into a
684
- // never-validated cached pane on every tmux hiccup. Err is OBSERVED here as
685
- // jitter and the delivery is deferred (status stays `target_resolved`, no
686
- // inject attempted) so the next tick gets a fresh probe.
687
- let live_targets = match transport.list_targets() {
688
- Ok(targets) => targets,
689
- Err(err) => {
690
- let reason = format!("list_targets_server_jitter:{err}");
691
- event_log.write(
692
- "delivery.deferred_list_targets_jitter",
693
- serde_json::json!({
694
- "message_id": message_id,
695
- "recipient": message.recipient,
696
- "reason": reason,
697
- }),
698
- )?;
699
- store.mark(message_id, "target_resolved", Some(&reason))?;
700
- return Ok(DeliveryOutcome {
701
- ok: false,
702
- status: DeliveryStatus::Degraded,
703
- message_status: MessageStatusShadow("target_resolved".to_string()),
704
- message_id: Some(message_id.to_string()),
705
- verification: Some(reason),
706
- stage: None,
707
- reason: None,
708
- channel: None,
709
- ack_forced_off: false,
710
- turn_verification: None,
711
- });
712
- }
713
- };
714
- let resolved = resolve_inject_target(state, &message.recipient, transport, &live_targets);
715
- if let Some(stale) = resolved.stale_binding.as_ref() {
716
- event_log.write(
717
- "worker_pane_binding_stale",
718
- stale.as_event_payload(message_id, &message.recipient),
719
- )?;
720
- }
721
- let target = resolved.target.clone();
722
- if let Some(outcome) = block_missing_worker_target(
723
- store,
724
- event_log,
725
- message_id,
726
- &message.recipient,
727
- &target,
728
- &live_targets,
729
- )? {
730
- return Ok(outcome);
731
- }
732
- // Contract B / MUST-10 / N31/N32: physical paste+Enter into a startup trust/update
733
- // menu is NOT provider delivery — the menu consumes the Enter and the task text
734
- // is lost (PROBE-2 root-cause). Before injection, peek at the recipient's pane for
735
- // a Codex actionable startup prompt; if present, mark the row `queued_until_trust`
736
- // and DO NOT inject the task. The coordinator's startup-prompt phase will dismiss
737
- // the trust prompt, and the SAME message_id is later replayed through this same
738
- // delivery pipeline (no parallel side channel).
739
- if recipient_pane_has_actionable_startup_prompt(transport, state, &message.recipient, &target) {
740
- store.mark(message_id, "queued_until_trust", None)?;
741
- event_log.write(
742
- "delivery.deferred_startup_prompt",
743
- serde_json::json!({
744
- "message_id": message_id,
745
- "recipient": message.recipient,
746
- "reason": "actionable_startup_prompt",
747
- }),
748
- )?;
749
- return Ok(DeliveryOutcome {
750
- ok: false,
751
- status: DeliveryStatus::RetryScheduled,
752
- message_status: MessageStatusShadow("queued_until_trust".to_string()),
753
- message_id: Some(message_id.to_string()),
754
- verification: None,
755
- stage: Some(DeliveryStage::TrustAutoAnswerDismissalWait),
756
- reason: None,
757
- channel: None,
758
- ack_forced_off: false,
759
- turn_verification: None,
760
- });
761
- }
762
- if token_already_visible(transport, state, &message.recipient, &target, message_id) {
763
- // Visibility prevents a second paste; it does not prove consumption.
764
- let consumed = existing_token_consumed(transport, state, &message.recipient, &target, message_id);
765
- let status = if consumed { "delivered" } else { "submitted_unverified" };
766
- let reason = if consumed { "message_token_consumed" } else { "message_token_visible_without_consumption" };
767
- event_log.write(
768
- "delivery.duplicate_token_refused",
769
- serde_json::json!({
770
- "message_id": message_id,
771
- "recipient": message.recipient,
772
- "reason": reason,
773
- "consumed": consumed,
774
- }),
775
- )?;
776
- store.mark(message_id, status, (!consumed).then_some(reason))?;
777
- if !consumed {
778
- bind_enter_watchdog(store, transport, state, &target, message_id, &message,
779
- canonical_owner_team_id.as_deref(), event_log)?;
780
- }
781
- return Ok(DeliveryOutcome {
782
- ok: consumed,
783
- status: if consumed { DeliveryStatus::AlreadyDelivered } else { DeliveryStatus::Failed },
784
- message_status: MessageStatusShadow(status.to_string()),
785
- message_id: Some(message_id.to_string()),
786
- verification: Some(reason.to_string()),
787
- stage: Some(DeliveryStage::Submit),
788
- reason: None,
789
- channel: None,
790
- ack_forced_off: false,
791
- turn_verification: None,
792
- });
793
- }
794
- // Startup control must remain reachable before protocol admission: some
795
- // clients cannot initialize MCP until their trust prompt is answered.
796
- // No business input is allowed before the current tools/list flush. A
797
- // readiness-only refusal releases this exact claim without spending an
798
- // input attempt; it never holds a pane-input lock or sleeps for startup.
799
- #[cfg(unix)]
800
- {
801
- let admission = crate::mcp_server::readiness::preflight(
802
- workspace, canonical_owner_team_id.as_deref(), &message.recipient, state,
803
- ).and_then(|admission| {
804
- if let Some(admission) = admission.as_ref() {
805
- crate::mcp_server::readiness::revalidate(admission, &target, &live_targets)?;
806
- }
807
- Ok(())
808
- });
809
- if let Err(reason) = admission {
810
- return mcp_handshake_pending_outcome(
811
- workspace, store, event_log, state, canonical_owner_team_id.as_deref(),
812
- message_id, &message, attempt, reason,
813
- );
814
- }
815
- }
816
- let rendered = render_message(
817
- &message.sender,
818
- message.task_id.as_deref(),
819
- &message.content,
820
- message_id,
821
- );
822
- let is_leader_recipient = message.recipient == "leader";
823
- let payload = if is_leader_recipient {
824
- InjectPayload::TextSkipConsumptionPoll(rendered)
825
- } else {
826
- InjectPayload::Text(rendered)
827
- };
828
- let submit_observer = CurrentTurnSubmitObserver::new(
829
- workspace,
830
- &message.sender,
831
- &message.recipient,
832
- message_id,
833
- event_log,
834
- canonical_owner_team_id.as_deref(),
835
- resolved.metadata.as_ref(),
836
- );
837
- // v0.5.113 delivery: address/owner and pane serialization are authoritative;
838
- // composer appearance is not admission. Native CLIs buffer/queue input.
839
- let inject_attempt = transport.inject_with_submit_observer(
840
- &target,
841
- &payload,
842
- Key::Enter,
843
- true,
844
- Some(&submit_observer),
845
- );
846
- let inject_report = match inject_attempt {
847
- Ok(report) => {
848
- // grok 忙时第一次回车只入显式队列。默认 send-now:只重按回车顶出去。
849
- // 无 `Enter:send now` 时零次额外按键,claude/codex 行为不变。
850
- if !crate::provider::submit_now::keep_provider_queue_requested() {
851
- match crate::provider::submit_now::flush_explicit_queue(transport, &target) {
852
- Ok(flush) if flush.extra_enters > 0 => {
853
- let _ = event_log.write(
854
- "send.grok_send_now",
855
- serde_json::json!({
856
- "message_id": message_id,
857
- "recipient": message.recipient,
858
- "extra_enters": flush.extra_enters,
859
- "mark_cleared": flush.mark_cleared,
860
- }),
861
- );
862
- }
863
- Ok(_) => {}
864
- Err(error) => {
865
- let _ = event_log.write(
866
- "send.grok_send_now_failed",
867
- serde_json::json!({
868
- "message_id": message_id,
869
- "recipient": message.recipient,
870
- "error": error.to_string(),
871
- }),
872
- );
873
- }
874
- }
875
- }
876
- report
877
- }
878
- Err(error) => {
879
- let reason = format!("inject_failed:{error}");
880
- if message.recipient == "leader" {
881
- store.mark(message_id, "failed", Some("leader_not_attached"))?;
882
- event_log.write(
883
- "leader_receiver.delivery_blocked",
884
- serde_json::json!({
885
- "message_id": message_id,
886
- "sender": message.sender,
887
- "reason": "leader_not_attached",
888
- "channel": "rebind_required",
889
- "action": "run team-agent claim-leader or team-agent takeover",
890
- "error": error.to_string(),
891
- }),
892
- )?;
893
- return Ok(DeliveryOutcome {
894
- ok: false,
895
- status: DeliveryStatus::Refused,
896
- message_status: MessageStatusShadow("failed".to_string()),
897
- message_id: Some(message_id.to_string()),
898
- verification: Some(
899
- "run team-agent claim-leader or team-agent takeover".to_string(),
900
- ),
901
- stage: None,
902
- reason: Some(DeliveryRefusal::LeaderNotAttached),
903
- channel: Some("rebind_required".to_string()),
904
- ack_forced_off: false,
905
- turn_verification: None,
906
- });
907
- }
908
- if transport_error_is_target_missing(&error) {
909
- return mark_worker_target_missing(
910
- store,
911
- event_log,
912
- message_id,
913
- &message.recipient,
914
- Some(reason),
915
- );
916
- }
917
- event_log.write(
918
- "send.inject_failed",
919
- serde_json::json!({
920
- "message_id": message_id,
921
- "recipient": message.recipient,
922
- "attempts": attempt,
923
- "max_attempts": SEND_RETRY_MAX_ATTEMPTS,
924
- "error": error.to_string(),
925
- }),
926
- )?;
927
- if attempt >= u32::from(SEND_RETRY_MAX_ATTEMPTS) {
928
- store.mark(message_id, "failed", Some("send_inject_exhausted"))?;
929
- emit_send_failed_exhausted(
930
- workspace,
931
- state,
932
- event_log,
933
- message_id,
934
- &message.recipient,
935
- attempt,
936
- "send_inject_exhausted",
937
- &reason,
938
- None,
939
- )?;
940
- return Ok(DeliveryOutcome {
941
- ok: false,
942
- status: DeliveryStatus::Failed,
943
- message_status: MessageStatusShadow("failed".to_string()),
944
- message_id: Some(message_id.to_string()),
945
- verification: Some(reason),
946
- stage: Some(DeliveryStage::Inject),
947
- reason: None,
948
- channel: None,
949
- ack_forced_off: false,
950
- turn_verification: None,
951
- });
952
- }
953
- store.mark(message_id, "target_resolved", Some(&reason))?;
954
- return Ok(DeliveryOutcome {
955
- ok: false,
956
- status: DeliveryStatus::Degraded,
957
- message_status: MessageStatusShadow("target_resolved".to_string()),
958
- message_id: Some(message_id.to_string()),
959
- verification: Some(reason),
960
- stage: Some(DeliveryStage::Inject),
961
- reason: None,
962
- channel: None,
963
- ack_forced_off: false,
964
- turn_verification: None,
965
- });
966
- }
967
- };
968
- if let Some(error) = submit_observer.take_error() {
969
- // Token on pane/transcript = physical Enter already out → degrade.
970
- // Poison before submit (no token) still returns Err → item_blocked.
971
- absorb_state_error_only_after_physical_submit(
972
- transport,
973
- state,
974
- &message.recipient,
975
- &target,
976
- message_id,
977
- event_log,
978
- "submit_observer",
979
- error,
980
- )?;
981
- }
982
- persist_submit_verification(workspace, message_id, &inject_report);
983
- let turn_verification = inject_report.turn_verification;
984
- let submit_verified = inject_submit_verified(&inject_report);
985
- let readback_verified = pane_readback_verified(&inject_report);
986
- // A successful tmux command is never provider-acceptance proof. Leader and
987
- // worker delivery both require post-submit evidence; leader additionally
988
- // waits for its authoritative provider transcript below.
989
- let native_consumed = observed_token_consumed(transport, state, &message.recipient, &target, message_id);
990
- let mut verified = submit_verified && native_consumed != Some(false);
991
- // #379: a pane the verifier could not read is not a failed send. The
992
- // recipient's own transcript row (user turn or queued enqueue) is the
993
- // provider's receipt; native observers keep their veto.
994
- if !verified
995
- && native_consumed.is_none()
996
- && recipient_transcript_contains_within(
997
- state,
998
- &message.recipient,
999
- &message_token_marker(message_id),
1000
- TRANSCRIPT_RECEIPT_TAIL_BYTES,
1001
- )
1002
- {
1003
- verified = true;
1004
- event_log.write(
1005
- "send.unverified_reconciled",
1006
- serde_json::json!({
1007
- "message_id": message_id,
1008
- "recipient": message.recipient,
1009
- "source": "recipient_transcript",
1010
- "submit_verification": submit_verification_wire(inject_report.submit_verification),
1011
- "attempts": inject_report.attempts,
1012
- }),
1013
- )?;
1014
- }
1015
- if !verified {
1016
- let reason = if native_consumed == Some(false) {
1017
- "submit_unverified:current_composer_or_consumption_unknown".to_string()
1018
- } else if !readback_verified {
1019
- "pane_readback_unverified:capture_missing_token".to_string()
1020
- } else {
1021
- format!(
1022
- "submit_unverified:{}",
1023
- submit_verification_wire(inject_report.submit_verification)
1024
- )
1025
- };
1026
- // E50 PR-1 (0.3.24 P0): render forensic submit_diagnostics into the
1027
- // event so operators see per-attempt pane state without grepping. The
1028
- // legacy keys (`message_id` / `recipient` / `reason` / `attempts`)
1029
- // are preserved byte-for-byte for grep compatibility; new keys are
1030
- // ADDITIONAL.
1031
- let submit_attempts_detail = render_submit_diagnostics(&inject_report);
1032
- let mut unverified = serde_json::json!({
1033
- "message_id": message_id,
1034
- "recipient": message.recipient,
1035
- "reason": reason,
1036
- "attempts": inject_report.attempts,
1037
- "delivery_attempt": attempt,
1038
- "submit_attempts_detail": submit_attempts_detail,
1039
- });
1040
- merge_inject_readback_fields(
1041
- &mut unverified,
1042
- &inject_report,
1043
- Some(&target),
1044
- resolved.metadata.as_ref(),
1045
- );
1046
- event_log.write("send.unverified", unverified)?;
1047
- // #379: the budget is delivery attempts, not Enter presses inside one.
1048
- if attempt >= u32::from(SEND_RETRY_MAX_ATTEMPTS) {
1049
- store.mark(message_id, "failed", Some("send_unverified_exhausted"))?;
1050
- emit_send_failed_exhausted(
1051
- workspace,
1052
- state,
1053
- event_log,
1054
- message_id,
1055
- &message.recipient,
1056
- attempt,
1057
- "send_unverified_exhausted",
1058
- &reason,
1059
- Some(&inject_report),
1060
- )?;
1061
- return Ok(DeliveryOutcome {
1062
- ok: false,
1063
- status: DeliveryStatus::Failed,
1064
- message_status: MessageStatusShadow("failed".to_string()),
1065
- message_id: Some(message_id.to_string()),
1066
- verification: Some(reason),
1067
- stage: Some(DeliveryStage::Submit),
1068
- reason: None,
1069
- channel: None,
1070
- ack_forced_off: false,
1071
- turn_verification: Some(turn_verification),
1072
- });
1073
- }
1074
- store.mark(message_id, "submitted_unverified", Some(&reason))?;
1075
- bind_enter_watchdog(store, transport, state, &target, message_id, &message,
1076
- canonical_owner_team_id.as_deref(), event_log)?;
1077
- return Ok(DeliveryOutcome {
1078
- ok: false,
1079
- status: DeliveryStatus::Failed,
1080
- message_status: MessageStatusShadow("submitted_unverified".to_string()),
1081
- message_id: Some(message_id.to_string()),
1082
- verification: Some(reason),
1083
- stage: Some(DeliveryStage::Submit),
1084
- reason: None,
1085
- channel: None,
1086
- ack_forced_off: false,
1087
- turn_verification: Some(turn_verification),
1088
- });
1089
- }
1090
- if is_leader_recipient {
1091
- store.record_delivery_submission(message_id, readback_verified)?;
1092
- match observe_leader_receipt(state, message_id) {
1093
- LeaderReceiptObservation::SourceUnavailable => {
1094
- store.mark_injected_awaiting_receipt(message_id)?;
1095
- event_log.write(
1096
- "leader_receiver.receipt_source_unavailable",
1097
- serde_json::json!({"message_id": message_id}),
1098
- )?;
1099
- let mut outcome = leader_receipt_source_unavailable_outcome(message_id);
1100
- outcome.turn_verification = Some(turn_verification);
1101
- return Ok(outcome);
1102
- }
1103
- LeaderReceiptObservation::TokenAbsent => {
1104
- store.mark(message_id, "submitted_pending_acceptance", None)?;
1105
- event_log.write(
1106
- "leader_receiver.acceptance_pending",
1107
- serde_json::json!({
1108
- "message_id": message_id,
1109
- "reason": "provider_receipt_not_observed",
1110
- }),
1111
- )?;
1112
- let mut outcome =
1113
- leader_acceptance_pending_outcome(message_id, "submitted_pending_acceptance");
1114
- outcome.turn_verification = Some(turn_verification);
1115
- return Ok(outcome);
1116
- }
1117
- LeaderReceiptObservation::TokenObserved => {}
1118
- }
1119
- store.mark_delivered_with_receipt(message_id)?;
1120
- } else {
1121
- store.mark(message_id, "delivered", None)?;
1122
- }
1123
- let mut delivered_event = serde_json::json!({"message_id": message_id});
1124
- if let Some(metadata) = resolved.metadata.as_ref() {
1125
- append_target_metadata(&mut delivered_event, metadata);
1126
- }
1127
- event_log.write("message.delivered", delivered_event)?;
1128
- let outcome = DeliveryOutcome {
1129
- ok: true,
1130
- status: DeliveryStatus::Delivered,
1131
- message_status: MessageStatusShadow("delivered".to_string()),
1132
- message_id: Some(message_id.to_string()),
1133
- verification: None,
1134
- stage: None,
1135
- reason: None,
1136
- channel: None,
1137
- ack_forced_off: false,
1138
- turn_verification: Some(turn_verification),
1139
- };
1140
- if let Err(error) = stamp_first_send_at_if_leader_to_worker_scoped(
1141
- workspace,
1142
- &message.sender,
1143
- &message.recipient,
1144
- canonical_owner_team_id.as_deref(),
1145
- ) {
1146
- absorb_state_error_only_after_physical_submit(
1147
- transport,
1148
- state,
1149
- &message.recipient,
1150
- &target,
1151
- message_id,
1152
- event_log,
1153
- "stamp_first_send_at",
1154
- error,
1155
- )?;
1156
- }
1157
- if let Err(error) = record_turn_open_if_leader_to_worker_scoped(
1158
- workspace,
1159
- &message.sender,
1160
- &message.recipient,
1161
- &outcome,
1162
- event_log,
1163
- canonical_owner_team_id.as_deref(),
1164
- resolved.metadata.as_ref(),
1165
- ) {
1166
- absorb_state_error_only_after_physical_submit(
1167
- transport,
1168
- state,
1169
- &message.recipient,
1170
- &target,
1171
- message_id,
1172
- event_log,
1173
- "turn_open_after_delivery",
1174
- error,
1175
- )?;
1176
- }
1177
- Ok(outcome)
1178
- }
1179
-
1180
- fn block_missing_worker_target(
1181
- store: &MessageStore,
1182
- event_log: &EventLog,
1183
- message_id: &str,
1184
- recipient: &str,
1185
- target: &Target,
1186
- live_targets: &[PaneInfo],
1187
- ) -> Result<Option<DeliveryOutcome>, MessagingError> {
1188
- let Target::SessionWindow { session, window } = target else {
1189
- return Ok(None);
1190
- };
1191
- if live_targets.is_empty() {
1192
- return Ok(None);
1193
- }
1194
- if window.as_str().ends_with("_pane_conflicts_with_leader") {
1195
- return Ok(None);
1196
- }
1197
- if live_targets.iter().any(|pane| {
1198
- pane.session.as_str() == session.as_str()
1199
- && pane
1200
- .window_name
1201
- .as_ref()
1202
- .is_some_and(|name| name.as_str() == window.as_str())
1203
- }) {
1204
- return Ok(None);
1205
- }
1206
- mark_worker_target_missing(store, event_log, message_id, recipient, None).map(Some)
1207
- }
1208
-
1209
- pub(crate) fn mark_worker_target_missing(
1210
- store: &MessageStore,
1211
- event_log: &EventLog,
1212
- message_id: &str,
1213
- recipient: &str,
1214
- verification: Option<String>,
1215
- ) -> Result<DeliveryOutcome, MessagingError> {
1216
- let action = format!("run team-agent start-agent {recipient} --allow-fresh");
1217
- store.mark(
1218
- message_id,
1219
- "queued_pane_missing",
1220
- Some("tmux_target_missing"),
1221
- )?;
1222
- event_log.write(
1223
- "send.inject_blocked",
1224
- serde_json::json!({
1225
- "message_id": message_id,
1226
- "recipient": recipient,
1227
- "reason": "tmux_target_missing",
1228
- "channel": "delivery_blocked",
1229
- "action": action,
1230
- "verification": verification,
1231
- }),
1232
- )?;
1233
- Ok(DeliveryOutcome {
1234
- ok: false,
1235
- status: DeliveryStatus::Blocked,
1236
- message_status: MessageStatusShadow("queued_pane_missing".to_string()),
1237
- message_id: Some(message_id.to_string()),
1238
- verification: verification.or(Some(action)),
1239
- stage: Some(DeliveryStage::Inject),
1240
- reason: Some(DeliveryRefusal::TmuxTargetMissing),
1241
- channel: Some("delivery_blocked".to_string()),
1242
- ack_forced_off: false,
1243
- turn_verification: None,
1244
- })
1245
- }
1246
-
1247
- fn transport_error_is_target_missing(error: &crate::transport::TransportError) -> bool {
1248
- match error {
1249
- crate::transport::TransportError::TargetNotFound { .. } => true,
1250
- crate::transport::TransportError::Subprocess { stderr, .. } => {
1251
- let stderr = stderr.to_ascii_lowercase();
1252
- (stderr.contains("can't find") || stderr.contains("no such"))
1253
- && (stderr.contains("pane")
1254
- || stderr.contains("window")
1255
- || stderr.contains("session"))
1256
- }
1257
- _ => false,
1258
- }
1259
- }
1260
-
1261
- pub fn requeue_worker_target_missing_messages(
1262
- workspace: &Path,
1263
- store: &MessageStore,
1264
- event_log: &EventLog,
1265
- recipient: &str,
1266
- owner_team_id: Option<&str>,
1267
- ) -> Result<Vec<String>, MessagingError> {
1268
- let ids = store.recover_worker_pane_available(recipient, owner_team_id)?;
1269
- if !ids.is_empty() {
1270
- event_log.write(
1271
- "worker_receiver.blocked_messages_requeued",
1272
- serde_json::json!({
1273
- "recipient": recipient,
1274
- "owner_team_id": owner_team_id,
1275
- "count": ids.len(),
1276
- "message_ids": ids,
1277
- }),
1278
- )?;
1279
- }
1280
- let _ = workspace;
1281
- Ok(ids)
1282
- }
1283
-
1284
- /// 把 post-Enter 消费判定落到 workspace,供确认面扫盘。
1285
- ///
1286
- /// //! purpose: persist SubmitVerification after inject
1287
- /// //! contract: file contains Debug variant name (SubmitConsumptionUnverified / EnterSentWithoutPlaceholderCheck)
1288
- /// //! boundary: write failure must not fail delivery
1289
- fn persist_submit_verification(workspace: &Path, message_id: &str, report: &InjectReport) {
1290
- let dir = workspace.join(".team").join("runtime");
1291
- if std::fs::create_dir_all(&dir).is_err() {
1292
- return;
1293
- }
1294
- let mut body = serde_json::json!({
1295
- "message_id": message_id,
1296
- "submit_verification": format!("{:?}", report.submit_verification),
1297
- "inject_verification": format!("{:?}", report.inject_verification),
1298
- "turn_verification": turn_verification_wire(report.turn_verification),
1299
- "submit_verified": inject_submit_verified(report),
1300
- "attempts": report.attempts,
1301
- });
1302
- merge_inject_readback_fields(&mut body, report, None, None);
1303
- let _ = std::fs::write(dir.join("submit-verification.json"), format!("{body}\n"));
1304
- }
1305
-
1306
- /// 0.3.27: promoted to pub(crate) for leader_receiver.rs verification gate.
1307
- pub(crate) fn inject_submit_verified(report: &InjectReport) -> bool {
1308
- match report.submit_verification {
1309
- SubmitVerification::SendKeysFailed => false,
1310
- SubmitVerification::PastedContentPromptStillPresentAfterSubmit => false,
1311
- SubmitVerification::PastedContentPromptAbsentAfterSubmit => true,
1312
- SubmitVerification::KeySentAfterVisibleToken { .. } => true,
1313
- // MUST-10 preserved: EnterSentWithoutPlaceholderCheck still ⇒ delivered
1314
- // (provider_submit_verification_red.rs:113-159 contract). E46 narrows
1315
- // when transport returns this variant: it is now emitted ONLY after
1316
- // post-Enter input-consumption confirmation succeeds. Fresh TUI
1317
- // (bracketed-paste-stuck) instead returns SubmitConsumptionUnverified
1318
- // so this branch keeps delivered semantics intact.
1319
- SubmitVerification::EnterSentWithoutPlaceholderCheck => true,
1320
- // E46 (0.3.24 bug#5): Enter was sent but post-Enter consumption was
1321
- // NOT observed within the bounded resend cap. Treat as not delivered
1322
- // (submitted_unverified / failed) — prevents the macmini假阳 where
1323
- // demo-director's stuck bracketed-paste swallowed the Enter and
1324
- // delivery still reported delivered.
1325
- SubmitVerification::SubmitConsumptionUnverified => false,
1326
- }
1327
- }
1328
-
1329
- /// U1 #7 step-2: pane-readback gate. `CaptureMissingToken` is negative readback
1330
- /// evidence, but 0.3.30 submit evidence can supersede it: consumption or
1331
- /// post-submit token observation proves the message reached the pane.
1332
- /// 0.3.27: promoted to pub(crate) for leader_receiver.rs verification gate.
1333
- pub(crate) fn pane_readback_verified(report: &InjectReport) -> bool {
1334
- !matches!(
1335
- report.inject_verification,
1336
- InjectVerification::CaptureMissingToken
1337
- )
1338
- }
1339
-
1340
- /// Render a message into the worker-facing protocol block (port of `rust_core.py:render_message`,
1341
- /// golden-verified): `Team Agent message from {sender}[ for {task_id}]:\n\n{content}\n\n
1342
- /// [team-agent-token:{message_id}]`. The worker (fake or real provider) only builds a result_envelope
1343
- /// when it sees this block + extracts the token — the bare content gives WORKING but never a report
1344
- /// (rt-host-a loop #4). token == message_id (exactly-once correlation).
1345
- /// F1 (0.3.26): promoted to `pub` for direct pane send in cli/send.rs.
1346
- pub fn render_message(
1347
- sender: &str,
1348
- task_id: Option<&str>,
1349
- content: &str,
1350
- message_id: &str,
1351
- ) -> String {
1352
- let mut header = format!("Team Agent message from {sender}");
1353
- if let Some(task_id) = task_id.filter(|t| !t.is_empty()) {
1354
- header.push_str(&format!(" for {task_id}"));
1355
- }
1356
- format!("{header}:\n\n{content}\n\n[team-agent-token:{message_id}]")
1357
- }
1358
-
1359
- fn deliver_leader_via_app_server(
1360
- store: &MessageStore,
1361
- event_log: &EventLog,
1362
- state: &serde_json::Value,
1363
- message_id: &str,
1364
- message: &PendingMessage,
1365
- owner_team_id: Option<&str>,
1366
- ) -> Result<DeliveryOutcome, MessagingError> {
1367
- let receiver = leader_receiver_value(state).ok_or_else(|| {
1368
- MessagingError::Routing("codex_app_server leader_receiver missing".to_string())
1369
- })?;
1370
- let binding = match crate::codex_app_server::binding_from_receiver(receiver) {
1371
- Ok(binding) => binding,
1372
- Err(error) => {
1373
- return Ok(app_server_delivery_failure(
1374
- store,
1375
- event_log,
1376
- receiver,
1377
- message_id,
1378
- &message.sender,
1379
- owner_team_id,
1380
- &error,
1381
- )?);
1382
- }
1383
- };
1384
- let rendered = render_message(
1385
- &message.sender,
1386
- message.task_id.as_deref(),
1387
- &message.content,
1388
- message_id,
1389
- );
1390
- match crate::codex_app_server::submit_to_bound_thread(&binding, message_id, &rendered) {
1391
- Ok(submit) => {
1392
- store.record_delivery_submission(message_id, true)?;
1393
- store.mark_delivered_with_receipt(message_id)?;
1394
- event_log.write(
1395
- "message.delivered",
1396
- serde_json::json!({"message_id": message_id}),
1397
- )?;
1398
- event_log.write(
1399
- "leader_receiver.app_server_submitted",
1400
- serde_json::json!({
1401
- "message_id": message_id,
1402
- "owner_team_id": owner_team_id,
1403
- "owner_epoch": receiver_owner_epoch(receiver),
1404
- "socket": binding.socket,
1405
- "thread_id": binding.thread_id,
1406
- "turn_id": submit.turn_id,
1407
- "turn_status": submit.turn_status,
1408
- }),
1409
- )?;
1410
- Ok(DeliveryOutcome {
1411
- ok: true,
1412
- status: DeliveryStatus::Delivered,
1413
- message_status: MessageStatusShadow("delivered".to_string()),
1414
- message_id: Some(message_id.to_string()),
1415
- verification: None,
1416
- stage: None,
1417
- reason: None,
1418
- channel: Some("codex_app_server".to_string()),
1419
- ack_forced_off: false,
1420
- turn_verification: None,
1421
- })
1422
- }
1423
- Err(error) => app_server_delivery_failure(
1424
- store,
1425
- event_log,
1426
- receiver,
1427
- message_id,
1428
- &message.sender,
1429
- owner_team_id,
1430
- &error,
1431
- ),
1432
- }
1433
- }
1434
-
1435
- fn app_server_delivery_failure(
1436
- store: &MessageStore,
1437
- event_log: &EventLog,
1438
- receiver: &serde_json::Value,
1439
- message_id: &str,
1440
- sender: &str,
1441
- owner_team_id: Option<&str>,
1442
- error: &crate::codex_app_server::AppServerError,
1443
- ) -> Result<DeliveryOutcome, MessagingError> {
1444
- let action = app_server_rebind_action(owner_team_id, receiver);
1445
- match error {
1446
- crate::codex_app_server::AppServerError::LeaderBusy(message) => {
1447
- store.mark(message_id, "target_resolved", Some("leader_busy"))?;
1448
- event_log.write(
1449
- "leader_receiver.app_server_busy",
1450
- serde_json::json!({
1451
- "message_id": message_id,
1452
- "sender": sender,
1453
- "reason": "leader_busy",
1454
- "error": message,
1455
- }),
1456
- )?;
1457
- Ok(DeliveryOutcome {
1458
- ok: false,
1459
- status: DeliveryStatus::RetryScheduled,
1460
- message_status: MessageStatusShadow("target_resolved".to_string()),
1461
- message_id: Some(message_id.to_string()),
1462
- verification: Some("leader_busy".to_string()),
1463
- stage: None,
1464
- reason: Some(DeliveryRefusal::RecipientBusy),
1465
- channel: Some("leader_busy".to_string()),
1466
- ack_forced_off: false,
1467
- turn_verification: None,
1468
- })
1469
- }
1470
- crate::codex_app_server::AppServerError::ThreadStale { expected, actual } => {
1471
- store.mark(message_id, "failed", Some(error.code()))?;
1472
- event_log.write(
1473
- "leader_receiver.app_server_thread_stale",
1474
- serde_json::json!({
1475
- "message_id": message_id,
1476
- "sender": sender,
1477
- "owner_team_id": owner_team_id,
1478
- "owner_epoch": receiver_owner_epoch(receiver),
1479
- "expected": expected,
1480
- "actual": actual,
1481
- "action": action,
1482
- }),
1483
- )?;
1484
- Ok(rebind_required_outcome(message_id, &action))
1485
- }
1486
- crate::codex_app_server::AppServerError::ApprovalUnsupported(method) => {
1487
- store.mark(message_id, "failed", Some("approval_unsupported"))?;
1488
- event_log.write(
1489
- "codex_app_server.approval_unsupported",
1490
- serde_json::json!({
1491
- "message_id": message_id,
1492
- "sender": sender,
1493
- "method": method,
1494
- "action": "handle approval in the Codex app-server session",
1495
- }),
1496
- )?;
1497
- Ok(DeliveryOutcome {
1498
- ok: false,
1499
- status: DeliveryStatus::Blocked,
1500
- message_status: MessageStatusShadow("failed".to_string()),
1501
- message_id: Some(message_id.to_string()),
1502
- verification: Some("handle approval in the Codex app-server session".to_string()),
1503
- stage: None,
1504
- reason: Some(DeliveryRefusal::MissingPermissions),
1505
- channel: Some("codex_app_server".to_string()),
1506
- ack_forced_off: false,
1507
- turn_verification: None,
1508
- })
1509
- }
1510
- crate::codex_app_server::AppServerError::ProtocolMismatch(_)
1511
- | crate::codex_app_server::AppServerError::MissingUserAgent => {
1512
- store.mark(message_id, "failed", Some(error.code()))?;
1513
- event_log.write(
1514
- "leader_receiver.app_server_protocol_mismatch",
1515
- serde_json::json!({
1516
- "message_id": message_id,
1517
- "sender": sender,
1518
- "owner_team_id": owner_team_id,
1519
- "owner_epoch": receiver_owner_epoch(receiver),
1520
- "reason": error.code(),
1521
- "error": error.to_string(),
1522
- "action": action,
1523
- }),
1524
- )?;
1525
- Ok(rebind_required_outcome(message_id, &action))
1526
- }
1527
- crate::codex_app_server::AppServerError::SocketUnreachable(_)
1528
- | crate::codex_app_server::AppServerError::SocketOwnershipInvalid(_)
1529
- | crate::codex_app_server::AppServerError::ThreadNotLive(_)
1530
- | crate::codex_app_server::AppServerError::Io(_)
1531
- | crate::codex_app_server::AppServerError::Json(_) => {
1532
- store.mark(message_id, "failed", Some(error.code()))?;
1533
- event_log.write(
1534
- "leader_receiver.delivery_blocked",
1535
- serde_json::json!({
1536
- "message_id": message_id,
1537
- "sender": sender,
1538
- "reason": error.code(),
1539
- "channel": "rebind_required",
1540
- "action": action,
1541
- "error": error.to_string(),
1542
- }),
1543
- )?;
1544
- Ok(rebind_required_outcome(message_id, &action))
1545
- }
1546
- }
1547
- }
1548
-
1549
- fn rebind_required_outcome(message_id: &str, action: &str) -> DeliveryOutcome {
1550
- DeliveryOutcome {
1551
- ok: false,
1552
- status: DeliveryStatus::Refused,
1553
- message_status: MessageStatusShadow("failed".to_string()),
1554
- message_id: Some(message_id.to_string()),
1555
- verification: Some(action.to_string()),
1556
- stage: None,
1557
- reason: Some(DeliveryRefusal::LeaderNotAttached),
1558
- channel: Some("rebind_required".to_string()),
1559
- ack_forced_off: false,
1560
- turn_verification: None,
1561
- }
1562
- }
1563
-
1564
- fn app_server_rebind_action(owner_team_id: Option<&str>, receiver: &serde_json::Value) -> String {
1565
- let team = owner_team_id
1566
- .filter(|team| !team.is_empty())
1567
- .map(|team| format!(" --team {team}"))
1568
- .unwrap_or_default();
1569
- let Some(app) = receiver.get("app_server") else {
1570
- return format!("run team-agent attach-app-server-leader{team} --socket <socket> --thread-id <thread_id>");
1571
- };
1572
- let socket = app
1573
- .get("socket")
1574
- .and_then(serde_json::Value::as_str)
1575
- .unwrap_or("<socket>");
1576
- let thread_id = app
1577
- .get("thread_id")
1578
- .and_then(serde_json::Value::as_str)
1579
- .unwrap_or("<thread_id>");
1580
- format!(
1581
- "run team-agent attach-app-server-leader{team} --socket {socket} --thread-id {thread_id}"
1582
- )
1583
- }
1584
-
1585
- /// Resolve a recipient agent-id to a tmux-RESOLVABLE inject target: the persisted pane-id if present,
1586
- /// else a session-qualified `SessionWindow` (state.session_name + the agent's window, defaulting to the
1587
- /// id). NEVER the bare agent-id as a pane — a clientless coordinator cannot resolve that
1588
- /// ("can't find pane: w1", rt-host-a loop #3). Mirrors `coordinator/tick.rs::capture_target`.
1589
- ///
1590
- /// Leader delivery uses the bound leader receiver pane. The leader is not a worker agent and
1591
- /// must not fall through to a synthetic `SessionWindow{window="leader"}` target.
1592
- ///
1593
- /// `live_targets` is passed in BY THE CALLER (probed ONCE per delivery — see U1-B); this fn is
1594
- /// pure w.r.t. transport state. The caller must DEFER on `list_targets()` Err and never coerce
1595
- /// to an empty vec.
1596
- ///
1597
- /// **0.3.24 excision (U1-A real-machine RED v2, macmini fixture res_e4b40473d36f)**:
1598
- /// the wave-2 LEADER drift fallback chain (session+window probe) was removed — see
1599
- /// `.team/artifacts/u1-a-realmachine-v2-fix-or-excise.md` for the root-cause analysis.
1600
- /// Drift now fails loudly as `leader_not_attached` rather than silently selecting a stale
1601
- /// pane. U1-A real-machine fix is deferred to v0.3.25 (writer-shape + projection +
1602
- /// rediscover-writer triad). U1-B jitter defer at try_deliver_message:213-237 and
1603
- /// U1-C-Tail at the startup-prompt peek site are unchanged.
1604
- #[derive(Clone)]
1605
- struct ResolvedInjectTarget {
1606
- target: Target,
1607
- metadata: Option<TargetMetadata>,
1608
- stale_binding: Option<WorkerPaneBindingStale>,
1609
- }
1610
-
1611
- #[derive(Clone)]
1612
- struct TargetMetadata {
1613
- tmux_endpoint: Option<String>,
1614
- target_session: String,
1615
- target_window: String,
1616
- target_pane_id: String,
1617
- target_pane_pid: Option<u32>,
1618
- resolved_from: &'static str,
1619
- }
1620
-
1621
- #[derive(Clone)]
1622
- struct WorkerPaneBindingStale {
1623
- cached_pane_id: String,
1624
- expected_session: String,
1625
- expected_window: String,
1626
- observed_session: String,
1627
- observed_window: String,
1628
- observed_pane_pid: Option<u32>,
1629
- }
1630
-
1631
- impl WorkerPaneBindingStale {
1632
- fn as_event_payload(&self, message_id: &str, recipient: &str) -> serde_json::Value {
1633
- serde_json::json!({
1634
- "message_id": message_id,
1635
- "recipient": recipient,
1636
- "cached_pane_id": self.cached_pane_id,
1637
- "expected_session": self.expected_session,
1638
- "expected_window": self.expected_window,
1639
- "observed_session": self.observed_session,
1640
- "observed_window": self.observed_window,
1641
- "observed_pane_pid": self.observed_pane_pid,
1642
- })
1643
- }
1644
- }
1645
-
1646
- fn resolve_inject_target(
1647
- state: &serde_json::Value,
1648
- recipient: &str,
1649
- transport: &dyn Transport,
1650
- live_targets: &[PaneInfo],
1651
- ) -> ResolvedInjectTarget {
1652
- if recipient == "leader" {
1653
- if let Some(pane_id) = leader_receiver_pane_id(state) {
1654
- return ResolvedInjectTarget {
1655
- target: Target::Pane(PaneId::new(pane_id)),
1656
- metadata: None,
1657
- stale_binding: None,
1658
- };
1659
- }
1660
- }
1661
- let agent = state.get("agents").and_then(|a| a.get(recipient));
1662
- let session = state
1663
- .get("session_name")
1664
- .and_then(serde_json::Value::as_str)
1665
- .unwrap_or_default();
1666
- let window = agent
1667
- .and_then(|a| a.get("window"))
1668
- .and_then(serde_json::Value::as_str)
1669
- .filter(|s| !s.is_empty())
1670
- .unwrap_or(recipient);
1671
- let cached_pane = agent
1672
- .and_then(|a| a.get("pane_id"))
1673
- .and_then(serde_json::Value::as_str)
1674
- .filter(|s| !s.is_empty())
1675
- .map(PaneId::new);
1676
- // E51 (0.3.26 P0, delivery loop guard): if the worker's cached pane_id is
1677
- // the SAME as leader_receiver.pane_id (the leader's handle), injecting into
1678
- // it would deliver the worker's message back to the leader pane — a routing
1679
- // loop that the macmini "hand-handle mapping 灾難" truth source exposed. Fail
1680
- // loud with a SessionWindow target that will surface as a structured error
1681
- // (the SessionWindow "leader" target trips the existing leader_not_attached
1682
- // guard on any subsequent delivery attempt for this message). The root fix
1683
- // is in lease.rs (E51 guard #1) which prevents the conflation; this is the
1684
- // defence-in-depth in the delivery layer.
1685
- if let Some(pane) = cached_pane.as_ref() {
1686
- let worker_socket = worker_tmux_socket(state, agent, transport);
1687
- if leader_receiver_pane_binding(state).is_some_and(|leader| {
1688
- pane_conflicts_on_same_socket(pane.as_str(), worker_socket.as_deref(), leader)
1689
- }) {
1690
- return ResolvedInjectTarget {
1691
- target: Target::SessionWindow {
1692
- session: SessionName::new(session),
1693
- window: WindowName::new(format!("{recipient}_pane_conflicts_with_leader")),
1694
- },
1695
- metadata: None,
1696
- stale_binding: None,
1697
- };
1698
- }
1699
- }
1700
- let stale_binding = cached_pane.as_ref().and_then(|pane| {
1701
- live_targets
1702
- .iter()
1703
- .find(|target| target.pane_id.as_str() == pane.as_str())
1704
- .and_then(|target| stale_worker_pane_binding(target, session, window))
1705
- });
1706
- if let Some(live_pane) = live_pane_for_session_window(live_targets, session, window) {
1707
- return ResolvedInjectTarget {
1708
- target: Target::Pane(live_pane.pane_id.clone()),
1709
- metadata: Some(target_metadata(
1710
- transport,
1711
- live_pane,
1712
- "session_window_lookup",
1713
- )),
1714
- stale_binding,
1715
- };
1716
- }
1717
- if let Some(pane) = cached_pane {
1718
- if let Some(live_pane) = live_targets.iter().find(|target| {
1719
- target.pane_id.as_str() == pane.as_str()
1720
- && target.session.as_str() == session
1721
- && target
1722
- .window_name
1723
- .as_ref()
1724
- .is_some_and(|name| name.as_str() == window)
1725
- }) {
1726
- return ResolvedInjectTarget {
1727
- target: Target::Pane(pane),
1728
- metadata: Some(target_metadata(
1729
- transport,
1730
- live_pane,
1731
- "validated_cached_pane",
1732
- )),
1733
- stale_binding: None,
1734
- };
1735
- }
1736
- if live_targets.is_empty() {
1737
- return ResolvedInjectTarget {
1738
- target: Target::Pane(pane),
1739
- metadata: None,
1740
- stale_binding: None,
1741
- };
1742
- }
1743
- }
1744
- ResolvedInjectTarget {
1745
- target: Target::SessionWindow {
1746
- session: SessionName::new(session),
1747
- window: WindowName::new(window),
1748
- },
1749
- metadata: None,
1750
- stale_binding,
1751
- }
1752
- }
1753
-
1754
- fn live_pane_for_session_window<'a>(
1755
- targets: &'a [PaneInfo],
1756
- session: &str,
1757
- window: &str,
1758
- ) -> Option<&'a PaneInfo> {
1759
- targets.iter().find(|target| {
1760
- target.session.as_str() == session
1761
- && target
1762
- .window_name
1763
- .as_ref()
1764
- .is_some_and(|name| name.as_str() == window)
1765
- })
1766
- }
1767
-
1768
- fn stale_worker_pane_binding(
1769
- observed: &PaneInfo,
1770
- expected_session: &str,
1771
- expected_window: &str,
1772
- ) -> Option<WorkerPaneBindingStale> {
1773
- let observed_window = observed
1774
- .window_name
1775
- .as_ref()
1776
- .map(|window| window.as_str())
1777
- .unwrap_or_default();
1778
- if observed.session.as_str() == expected_session && observed_window == expected_window {
1779
- return None;
1780
- }
1781
- Some(WorkerPaneBindingStale {
1782
- cached_pane_id: observed.pane_id.as_str().to_string(),
1783
- expected_session: expected_session.to_string(),
1784
- expected_window: expected_window.to_string(),
1785
- observed_session: observed.session.as_str().to_string(),
1786
- observed_window: observed_window.to_string(),
1787
- observed_pane_pid: observed.pane_pid,
1788
- })
1789
- }
1790
-
1791
- fn target_metadata(
1792
- transport: &dyn Transport,
1793
- pane: &PaneInfo,
1794
- resolved_from: &'static str,
1795
- ) -> TargetMetadata {
1796
- TargetMetadata {
1797
- tmux_endpoint: transport.tmux_endpoint(),
1798
- target_session: pane.session.as_str().to_string(),
1799
- target_window: pane
1800
- .window_name
1801
- .as_ref()
1802
- .map(|window| window.as_str().to_string())
1803
- .unwrap_or_default(),
1804
- target_pane_id: pane.pane_id.as_str().to_string(),
1805
- target_pane_pid: pane.pane_pid,
1806
- resolved_from,
1807
- }
1808
- }
1809
-
1810
- fn append_target_metadata(event: &mut serde_json::Value, metadata: &TargetMetadata) {
1811
- let Some(obj) = event.as_object_mut() else {
1812
- return;
1813
- };
1814
- obj.insert("target_kind".to_string(), serde_json::json!("pane"));
1815
- obj.insert(
1816
- "tmux_endpoint".to_string(),
1817
- metadata
1818
- .tmux_endpoint
1819
- .as_ref()
1820
- .map(|endpoint| serde_json::json!(endpoint))
1821
- .unwrap_or(serde_json::Value::Null),
1822
- );
1823
- obj.insert(
1824
- "target_session".to_string(),
1825
- serde_json::json!(metadata.target_session),
1826
- );
1827
- obj.insert(
1828
- "target_window".to_string(),
1829
- serde_json::json!(metadata.target_window),
1830
- );
1831
- obj.insert(
1832
- "target_pane_id".to_string(),
1833
- serde_json::json!(metadata.target_pane_id),
1834
- );
1835
- obj.insert(
1836
- "target_pane_pid".to_string(),
1837
- metadata
1838
- .target_pane_pid
1839
- .map(|pid| serde_json::json!(pid))
1840
- .unwrap_or(serde_json::Value::Null),
1841
- );
1842
- obj.insert(
1843
- "resolved_from".to_string(),
1844
- serde_json::json!(metadata.resolved_from),
1845
- );
1846
- }
1847
-
1848
- #[derive(Clone, Copy)]
1849
- struct PaneSocketBinding<'a> {
1850
- pane_id: &'a str,
1851
- tmux_socket: Option<&'a str>,
1852
- }
1853
-
1854
- fn pane_conflicts_on_same_socket(
1855
- pane_id: &str,
1856
- worker_socket: Option<&str>,
1857
- leader: PaneSocketBinding<'_>,
1858
- ) -> bool {
1859
- leader.pane_id == pane_id && !tmux_sockets_known_different(worker_socket, leader.tmux_socket)
1860
- }
1861
-
1862
- fn tmux_sockets_known_different(left: Option<&str>, right: Option<&str>) -> bool {
1863
- let (Some(left), Some(right)) = (left, right) else {
1864
- return false;
1865
- };
1866
- if left == right {
1867
- return false;
1868
- }
1869
- std::path::Path::new(left).is_absolute() && std::path::Path::new(right).is_absolute()
1870
- }
1871
-
1872
- fn worker_tmux_socket(
1873
- state: &serde_json::Value,
1874
- agent: Option<&serde_json::Value>,
1875
- transport: &dyn Transport,
1876
- ) -> Option<String> {
1877
- agent
1878
- .and_then(tmux_socket_field)
1879
- .or_else(|| runtime_tmux_socket(state))
1880
- .map(str::to_string)
1881
- .or_else(|| transport.tmux_endpoint())
1882
- }
1883
-
1884
- fn runtime_tmux_socket(state: &serde_json::Value) -> Option<&str> {
1885
- tmux_socket_field(state)
1886
- .or_else(|| active_team_entry(state).and_then(tmux_socket_field))
1887
- .or_else(|| only_team_entry(state).and_then(tmux_socket_field))
1888
- }
1889
-
1890
- fn tmux_socket_field(value: &serde_json::Value) -> Option<&str> {
1891
- value
1892
- .get("tmux_endpoint")
1893
- .or_else(|| value.get("tmux_socket"))
1894
- .and_then(serde_json::Value::as_str)
1895
- .filter(|value| !value.is_empty())
1896
- }
1897
-
1898
- /// Read the bound leader pane id off the projected or team-scoped runtime state.
1899
- fn leader_receiver_pane_id(state: &serde_json::Value) -> Option<&str> {
1900
- leader_receiver_pane_id_in_state(state)
1901
- .or_else(|| active_team_entry(state).and_then(leader_receiver_pane_id_in_state))
1902
- .or_else(|| only_team_entry(state).and_then(leader_receiver_pane_id_in_state))
1903
- }
1904
-
1905
- fn leader_receiver_value(state: &serde_json::Value) -> Option<&serde_json::Value> {
1906
- leader_receiver_value_in_state(state)
1907
- .or_else(|| active_team_entry(state).and_then(leader_receiver_value_in_state))
1908
- .or_else(|| only_team_entry(state).and_then(leader_receiver_value_in_state))
1909
- }
1910
-
1911
- fn leader_receiver_value_in_state(state: &serde_json::Value) -> Option<&serde_json::Value> {
1912
- state.get("leader_receiver")
1913
- }
1914
-
1915
- fn receiver_owner_epoch(receiver: &serde_json::Value) -> Option<u64> {
1916
- receiver
1917
- .get("owner_epoch")
1918
- .and_then(serde_json::Value::as_u64)
1919
- }
1920
-
1921
- fn leader_receiver_transport_conflict_outcome(
1922
- store: &MessageStore,
1923
- event_log: &EventLog,
1924
- message_id: &str,
1925
- receiver: &serde_json::Value,
1926
- sender: &str,
1927
- ) -> Result<Option<DeliveryOutcome>, MessagingError> {
1928
- let mode = receiver.get("mode").and_then(serde_json::Value::as_str);
1929
- let transport_kind = receiver
1930
- .get("transport_kind")
1931
- .and_then(serde_json::Value::as_str);
1932
- if let (Some(mode), Some(transport_kind)) = (mode, transport_kind) {
1933
- if !mode.is_empty() && !transport_kind.is_empty() && mode != transport_kind {
1934
- store.mark(
1935
- message_id,
1936
- "failed",
1937
- Some("leader_receiver_transport_conflict"),
1938
- )?;
1939
- event_log.write(
1940
- "leader_receiver.delivery_blocked",
1941
- serde_json::json!({
1942
- "message_id": message_id,
1943
- "sender": sender,
1944
- "reason": "leader_receiver_transport_conflict",
1945
- "mode": mode,
1946
- "transport_kind": transport_kind,
1947
- "channel": "rebind_required",
1948
- "action": "run team-agent claim-leader, takeover, or attach-app-server-leader",
1949
- }),
1950
- )?;
1951
- return Ok(Some(DeliveryOutcome {
1952
- ok: false,
1953
- status: DeliveryStatus::Refused,
1954
- message_status: MessageStatusShadow("failed".to_string()),
1955
- message_id: Some(message_id.to_string()),
1956
- verification: Some(
1957
- "run team-agent claim-leader, takeover, or attach-app-server-leader"
1958
- .to_string(),
1959
- ),
1960
- stage: None,
1961
- reason: Some(DeliveryRefusal::LeaderNotAttached),
1962
- channel: Some("rebind_required".to_string()),
1963
- ack_forced_off: false,
1964
- turn_verification: None,
1965
- }));
1966
- }
1967
- }
1968
- Ok(None)
1969
- }
1970
-
1971
- fn leader_receiver_pane_binding(state: &serde_json::Value) -> Option<PaneSocketBinding<'_>> {
1972
- leader_receiver_pane_binding_in_state(state)
1973
- .or_else(|| active_team_entry(state).and_then(leader_receiver_pane_binding_in_state))
1974
- .or_else(|| only_team_entry(state).and_then(leader_receiver_pane_binding_in_state))
1975
- }
1976
-
1977
- /// 0.5.x Phase 1d Batch 4: the `Owned` variant now carries a boxed
1978
- /// `Transport` trait object rather than a concrete `TmuxBackend`. All
1979
- /// existing leader-fallback sites still supply a `TmuxBackend` here
1980
- /// (Batch 4 is a helper replacement at the leader channel only —
1981
- /// `transport_kind`-based dispatch belongs to the parallel
1982
- /// `feat/appserver-leader-host` work per leader msg_4ac2122489e0),
1983
- /// but the type is now open so a future conpty leader-hosting flow
1984
- /// can plug in without another enum widen.
1985
- enum DeliveryTransport<'a> {
1986
- Borrowed(&'a dyn Transport),
1987
- Owned(Box<dyn Transport>),
1988
- }
1989
-
1990
- impl<'a> DeliveryTransport<'a> {
1991
- fn as_transport(&'a self) -> &'a dyn Transport {
1992
- match self {
1993
- Self::Borrowed(transport) => *transport,
1994
- Self::Owned(transport) => transport.as_ref(),
1995
- }
1996
- }
1997
- }
1998
-
1999
- fn delivery_transport_for_recipient<'a>(
2000
- workspace: &Path,
2001
- product_transport: &'a dyn Transport,
2002
- state: &serde_json::Value,
2003
- recipient: &str,
2004
- ) -> DeliveryTransport<'a> {
2005
- if recipient != "leader" {
2006
- return DeliveryTransport::Borrowed(product_transport);
2007
- }
2008
- // 0.5.x Phase 1d Batch 4: leader-fallback chain uses the factory
2009
- // tmux channel helpers instead of `TmuxBackend::{new,for_workspace,
2010
- // for_tmux_endpoint}` directly. Semantics are identical (helpers
2011
- // are thin wrappers) but `grep -rn transport_factory::tmux_` at any
2012
- // future point returns every intentional tmux-only leader-channel
2013
- // site. Leader-channel dispatch by `transport_kind` is the parallel
2014
- // `feat/appserver-leader-host` work — this batch stays helper-swap
2015
- // only per leader msg_4ac2122489e0.
2016
- let pane_id = leader_receiver_pane_id(state);
2017
- let Some(socket) = leader_receiver_tmux_socket(state) else {
2018
- if let Some(pane_id) = pane_id {
2019
- let in_workspace = product_transport
2020
- .list_targets()
2021
- .unwrap_or_default()
2022
- .iter()
2023
- .any(|target| target.pane_id.as_str() == pane_id);
2024
- if !in_workspace {
2025
- let default_backend = crate::transport_factory::tmux_default_transport();
2026
- if default_backend
2027
- .list_targets()
2028
- .unwrap_or_default()
2029
- .iter()
2030
- .any(|target| target.pane_id.as_str() == pane_id)
2031
- {
2032
- return DeliveryTransport::Owned(Box::new(default_backend));
2033
- }
2034
- }
2035
- }
2036
- return DeliveryTransport::Borrowed(product_transport);
2037
- };
2038
- // An exact endpoint match can reuse the supplied channel; do not select
2039
- // another server merely because it has a pane with the same numeric id.
2040
- if product_transport.tmux_endpoint().as_deref() == Some(socket)
2041
- || socket == crate::tmux_backend::socket_name_for_workspace(workspace)
2042
- {
2043
- DeliveryTransport::Borrowed(product_transport)
2044
- } else {
2045
- // 0.5.4 gate054 cross-team leak fix: when `leader_receiver.tmux_socket`
2046
- // is present and non-canonical, it is a hard channel boundary — the
2047
- // caller (team A on socket X) explicitly recorded which tmux server
2048
- // hosts its leader pane. Pane ids (`%N`) are only unique per tmux
2049
- // server, so probing product/default servers for the same pane id and
2050
- // switching transports on a match can cross the team/tmux boundary and
2051
- // inject A's leader traffic into team B's leader pane. If the pane is
2052
- // absent on the recorded endpoint, let the downstream
2053
- // the shared leader-channel resolver produce `rebind_required`
2054
- // instead of falling back to another server.
2055
- let endpoint_backend = crate::transport_factory::tmux_endpoint_transport(socket);
2056
- DeliveryTransport::Owned(Box::new(endpoint_backend))
2057
- }
2058
- }
2059
-
2060
- fn leader_receiver_pane_id_in_state(state: &serde_json::Value) -> Option<&str> {
2061
- ["leader_receiver", "team_owner"]
2062
- .into_iter()
2063
- .find_map(|key| {
2064
- state
2065
- .get(key)
2066
- .and_then(|r| r.get("pane_id"))
2067
- .and_then(serde_json::Value::as_str)
2068
- .filter(|s| !s.is_empty() && *s != "__team_agent_unbound__")
2069
- })
2070
- }
2071
-
2072
- fn leader_receiver_pane_binding_in_state(
2073
- state: &serde_json::Value,
2074
- ) -> Option<PaneSocketBinding<'_>> {
2075
- ["leader_receiver", "team_owner"]
2076
- .into_iter()
2077
- .find_map(|key| state.get(key).and_then(pane_socket_binding))
2078
- }
2079
-
2080
- fn pane_socket_binding(value: &serde_json::Value) -> Option<PaneSocketBinding<'_>> {
2081
- let pane_id = value
2082
- .get("pane_id")
2083
- .and_then(serde_json::Value::as_str)
2084
- .filter(|s| !s.is_empty() && *s != "__team_agent_unbound__")?;
2085
- Some(PaneSocketBinding {
2086
- pane_id,
2087
- tmux_socket: tmux_socket_field(value),
2088
- })
2089
- }
2090
-
2091
- fn leader_receiver_tmux_socket(state: &serde_json::Value) -> Option<&str> {
2092
- leader_receiver_field(state, "tmux_socket")
2093
- }
2094
-
2095
- fn leader_receiver_field<'a>(state: &'a serde_json::Value, field: &str) -> Option<&'a str> {
2096
- leader_receiver_field_in_state(state, field)
2097
- .or_else(|| {
2098
- active_team_entry(state).and_then(|team| leader_receiver_field_in_state(team, field))
2099
- })
2100
- .or_else(|| {
2101
- only_team_entry(state).and_then(|team| leader_receiver_field_in_state(team, field))
2102
- })
2103
- }
2104
-
2105
- fn leader_receiver_field_in_state<'a>(
2106
- state: &'a serde_json::Value,
2107
- field: &str,
2108
- ) -> Option<&'a str> {
2109
- state
2110
- .get("leader_receiver")
2111
- .and_then(|receiver| receiver.get(field))
2112
- .and_then(serde_json::Value::as_str)
2113
- .filter(|value| !value.is_empty())
2114
- }
2115
-
2116
- /// E50 PR-1 (0.3.24 P0): render `InjectReport.submit_diagnostics` as a JSON
2117
- /// array suitable for inclusion in `send.unverified` / `send.failed` events.
2118
- /// `null` if no diagnostics were attached (e.g. the inject went through a
2119
- /// path that bypassed the paste-prompt + Enter instrumentation, or this is
2120
- /// the pre-PR-2 inject-failed path with no `InjectReport`).
2121
- fn render_submit_diagnostics(report: &InjectReport) -> serde_json::Value {
2122
- let Some(diag) = report.submit_diagnostics.as_ref() else {
2123
- return serde_json::Value::Null;
2124
- };
2125
- serde_json::Value::Array(
2126
- diag.attempts_detail
2127
- .iter()
2128
- .map(|obs| {
2129
- serde_json::json!({
2130
- "attempt_index": obs.attempt_index,
2131
- "matched": obs.matched,
2132
- "matched_literal": obs.matched_literal,
2133
- "where_in_tail": obs.where_in_tail,
2134
- "pane_tail_excerpt": obs.pane_tail_excerpt,
2135
- "pane_tail_lines": obs.pane_tail_lines,
2136
- "elapsed_ms": obs.elapsed_ms,
2137
- })
2138
- })
2139
- .collect(),
2140
- )
2141
- }
2142
-
2143
- fn json_opt_bool(value: Option<bool>) -> serde_json::Value {
2144
- match value {
2145
- Some(flag) => serde_json::Value::Bool(flag),
2146
- None => serde_json::Value::Null,
2147
- }
2148
- }
2149
-
2150
- fn inject_pane_id(target: &Target) -> Option<&str> {
2151
- match target {
2152
- Target::Pane(pane) => Some(pane.as_str()),
2153
- Target::SessionWindow { .. } => None,
2154
- }
2155
- }
2156
-
2157
- fn merge_inject_readback_fields(
2158
- event: &mut serde_json::Value,
2159
- report: &InjectReport,
2160
- target: Option<&Target>,
2161
- metadata: Option<&TargetMetadata>,
2162
- ) {
2163
- if let Some(metadata) = metadata {
2164
- append_target_metadata(event, metadata);
2165
- }
2166
- let Some(obj) = event.as_object_mut() else {
2167
- return;
2168
- };
2169
- let inject_pane = target.and_then(inject_pane_id);
2170
- if let Some(pane) = inject_pane {
2171
- obj.insert("inject_target_pane_id".to_string(), serde_json::json!(pane));
2172
- }
2173
- let resolved_pane = metadata.map(|meta| meta.target_pane_id.as_str());
2174
- obj.insert(
2175
- "target_pane_matched".to_string(),
2176
- json_opt_bool(match (inject_pane, resolved_pane) {
2177
- (Some(left), Some(right)) => Some(left == right),
2178
- _ => None,
2179
- }),
2180
- );
2181
- let inject_endpoint = metadata.and_then(|meta| meta.tmux_endpoint.as_deref());
2182
- // metadata.tmux_endpoint is the transport used to resolve; compare to
2183
- // itself is tautological. Equality vs inject target id is the pane check
2184
- // above. Socket equality is recorded when both sides exist on metadata.
2185
- obj.insert(
2186
- "resolved_tmux_endpoint_present".to_string(),
2187
- serde_json::Value::Bool(inject_endpoint.is_some()),
2188
- );
2189
- let diag = report.submit_diagnostics.as_ref();
2190
- obj.insert(
2191
- "token_seen_before_paste".to_string(),
2192
- json_opt_bool(diag.and_then(|d| d.token_seen_before_paste)),
2193
- );
2194
- obj.insert(
2195
- "token_seen_after_paste".to_string(),
2196
- json_opt_bool(diag.and_then(|d| d.token_seen_after_paste)),
2197
- );
2198
- obj.insert(
2199
- "token_seen_after_enter".to_string(),
2200
- json_opt_bool(diag.and_then(|d| d.token_seen_after_enter)),
2201
- );
2202
- obj.insert(
2203
- "capture_ok_count".to_string(),
2204
- serde_json::json!(diag.map(|d| d.capture_ok_count).unwrap_or(0)),
2205
- );
2206
- obj.insert(
2207
- "capture_err_count".to_string(),
2208
- serde_json::json!(diag.map(|d| d.capture_err_count).unwrap_or(0)),
2209
- );
2210
- obj.insert(
2211
- "capture_sample_count".to_string(),
2212
- serde_json::json!(diag.map(|d| d.capture_sample_count).unwrap_or(0)),
2213
- );
2214
- obj.insert(
2215
- "last_capture_outcome".to_string(),
2216
- serde_json::json!(diag
2217
- .map(|d| d.last_capture_outcome.as_str())
2218
- .unwrap_or(CaptureSampleOutcome::NotAttempted.as_str())),
2219
- );
2220
- obj.insert(
2221
- "consumption_reason".to_string(),
2222
- serde_json::json!(diag
2223
- .map(|d| d.consumption_reason.as_str())
2224
- .unwrap_or("unknown")),
2225
- );
2226
- obj.insert(
2227
- "before_busy_signal_kind".to_string(),
2228
- serde_json::json!(diag.and_then(|d| d.before_busy_signal_kind.map(|kind| kind.as_str()))),
2229
- );
2230
- obj.insert(
2231
- "busy_signal_kind".to_string(),
2232
- serde_json::json!(diag.and_then(|d| d.busy_signal_kind.map(|kind| kind.as_str()))),
2233
- );
2234
- obj.insert(
2235
- "busy_line_from_bottom".to_string(),
2236
- serde_json::json!(diag.and_then(|d| d.busy_line_from_bottom)),
2237
- );
2238
- obj.insert(
2239
- "current_marker_in_bottom_15".to_string(),
2240
- serde_json::json!(diag.and_then(|d| d.current_marker_in_bottom_15)),
2241
- );
2242
- obj.insert(
2243
- "paste_identity_in_composer".to_string(),
2244
- serde_json::json!(diag.and_then(|d| d.paste_identity_in_composer)),
2245
- );
2246
- obj.insert(
2247
- "consumption_from_capture_result".to_string(),
2248
- serde_json::json!(diag.and_then(|d| d.consumption_from_capture_result)),
2249
- );
2250
- obj.insert(
2251
- "pane_command_basename".to_string(),
2252
- diag.and_then(|d| d.pane_command_basename.as_deref())
2253
- .map(|name| serde_json::json!(name))
2254
- .unwrap_or(serde_json::Value::Null),
2255
- );
2256
- obj.insert(
2257
- "pane_command_query".to_string(),
2258
- serde_json::json!(diag
2259
- .map(|d| d.pane_command_query.as_str())
2260
- .unwrap_or(QueryOutcome::Unavailable.as_str())),
2261
- );
2262
- obj.insert(
2263
- "input_surface".to_string(),
2264
- serde_json::json!(diag
2265
- .map(|d| d.input_surface.as_str())
2266
- .unwrap_or(InputSurfaceProbe::Unavailable.as_str())),
2267
- );
2268
- obj.insert(
2269
- "diag_target_pane_id".to_string(),
2270
- diag.and_then(|d| d.target_pane_id.as_deref())
2271
- .map(|pane| serde_json::json!(pane))
2272
- .unwrap_or(serde_json::Value::Null),
2273
- );
2274
- obj.insert(
2275
- "diag_target_pane_query_matched".to_string(),
2276
- json_opt_bool(diag.and_then(|d| d.target_pane_query_matched)),
2277
- );
2278
- }
2279
-
2280
- #[allow(clippy::too_many_arguments)]
2281
- fn emit_send_failed_exhausted(
2282
- workspace: &Path,
2283
- state: &serde_json::Value,
2284
- event_log: &EventLog,
2285
- message_id: &str,
2286
- recipient: &str,
2287
- attempts: u32,
2288
- failure_reason: &str,
2289
- verification: &str,
2290
- inject_report: Option<&InjectReport>,
2291
- ) -> Result<(), MessagingError> {
2292
- // E50 PR-1 (0.3.24 P0): forensic fields on send.failed. Legacy keys
2293
- // (`message_id` / `recipient` / `attempts` / `max_attempts` / `reason` /
2294
- // `verification`) preserved byte-for-byte for grep compatibility.
2295
- let submit_attempts_detail = inject_report
2296
- .map(render_submit_diagnostics)
2297
- .unwrap_or_else(|| serde_json::Value::Array(Vec::new()));
2298
- let total_elapsed_ms = inject_report
2299
- .and_then(|r| r.submit_diagnostics.as_ref())
2300
- .map(|d| d.total_elapsed_ms)
2301
- .unwrap_or(0);
2302
- let last_matched_literal = inject_report
2303
- .and_then(|r| r.submit_diagnostics.as_ref())
2304
- .and_then(|d| d.attempts_detail.last())
2305
- .and_then(|a| a.matched_literal.clone());
2306
- let last_pane_tail_excerpt = inject_report
2307
- .and_then(|r| r.submit_diagnostics.as_ref())
2308
- .and_then(|d| d.attempts_detail.last())
2309
- .map(|a| a.pane_tail_excerpt.clone());
2310
- let mut failed = serde_json::json!({
2311
- "message_id": message_id,
2312
- "recipient": recipient,
2313
- "attempts": attempts,
2314
- "max_attempts": SEND_RETRY_MAX_ATTEMPTS,
2315
- "reason": failure_reason,
2316
- "verification": verification,
2317
- "submit_attempts_detail": submit_attempts_detail,
2318
- "total_elapsed_ms": total_elapsed_ms,
2319
- "last_matched_literal": last_matched_literal,
2320
- "last_pane_tail_excerpt": last_pane_tail_excerpt,
2321
- });
2322
- if let Some(report) = inject_report {
2323
- merge_inject_readback_fields(&mut failed, report, None, None);
2324
- }
2325
- event_log.write("send.failed", failed)?;
2326
- let content = format!(
2327
- "send.failed\nerror: send to {recipient} failed with {failure_reason} after {attempts}/{SEND_RETRY_MAX_ATTEMPTS} attempts\naction: inspect the target pane and retry the send\nlog: .team/logs/events.jsonl"
2328
- );
2329
- match crate::messaging::send_to_leader_receiver(
2330
- workspace,
2331
- state,
2332
- "leader",
2333
- &content,
2334
- None,
2335
- "coordinator",
2336
- false,
2337
- Some(&format!("send.failed:{message_id}")),
2338
- event_log,
2339
- ) {
2340
- Ok(outcome) => {
2341
- event_log.write(
2342
- "send.failed_notification",
2343
- serde_json::json!({
2344
- "message_id": message_id,
2345
- "recipient": recipient,
2346
- "leader_notification_status": super::helpers::status_wire(outcome.status),
2347
- "leader_message_id": outcome.message_id,
2348
- }),
2349
- )?;
2350
- }
2351
- Err(error) => {
2352
- event_log.write(
2353
- "send.failed_notification_failed",
2354
- serde_json::json!({
2355
- "message_id": message_id,
2356
- "recipient": recipient,
2357
- "error": error.to_string(),
2358
- }),
2359
- )?;
2360
- }
2361
- }
2362
- Ok(())
2363
- }
2364
-
2365
- fn active_team_entry(state: &serde_json::Value) -> Option<&serde_json::Value> {
2366
- let team = state
2367
- .get("active_team_key")
2368
- .and_then(serde_json::Value::as_str)?;
2369
- state
2370
- .get("teams")
2371
- .and_then(serde_json::Value::as_object)
2372
- .and_then(|teams| teams.get(team))
2373
- }
2374
-
2375
- fn only_team_entry(state: &serde_json::Value) -> Option<&serde_json::Value> {
2376
- let teams = state.get("teams").and_then(serde_json::Value::as_object)?;
2377
- if teams.len() == 1 {
2378
- teams.values().next()
2379
- } else {
2380
- None
2381
- }
2382
- }
2383
-
2384
- /// Deliver pending rows without activity/composer admission; native CLIs queue input.
2385
- /// Returns the message IDs whose post-submit evidence verified delivery.
2386
- pub fn deliver_pending_messages(
2387
- workspace: &Path,
2388
- state: &serde_json::Value,
2389
- transport: &dyn Transport,
2390
- event_log: &EventLog,
2391
- ) -> Result<Vec<String>, MessagingError> {
2392
- let store = MessageStore::open(workspace)?;
2393
- let message_ids = {
2394
- let conn = crate::db::schema::open_db(store.db_path())?;
2395
- // `stored_only` is intentionally absent: C6 chose durable presentation without C5.
2396
- let mut stmt = conn.prepare(
2397
- "select message_id from messages
2398
- where status in (
2399
- 'pending', 'accepted', 'target_resolved',
2400
- 'submitted_pending_acceptance', 'queued_until_leader_attach', ?1
2401
- )
2402
- order by created_at, message_id",
2403
- )?;
2404
- let rows = stmt.query_map(
2405
- [crate::message_store::MessageRowStatus::QueuedCoordinatorUnavailable.as_str()],
2406
- |row| row.get::<_, String>(0),
2407
- )?;
2408
- rows.collect::<Result<Vec<_>, _>>()?
2409
- };
2410
- let mut delivered = Vec::new();
2411
- for message_id in message_ids {
2412
- let Some(message) = message_for_delivery(&store, &message_id)? else {
2413
- continue;
2414
- };
2415
- let prepared = match prepare_message_state(
2416
- workspace,
2417
- &store,
2418
- &message_id,
2419
- event_log,
2420
- state,
2421
- &message,
2422
- true,
2423
- )? {
2424
- Ok(prepared) => prepared,
2425
- Err(_) => continue,
2426
- };
2427
- let outcome = match deliver_prepared_message(
2428
- workspace,
2429
- &store,
2430
- transport,
2431
- &message_id,
2432
- event_log,
2433
- state,
2434
- message,
2435
- prepared,
2436
- ) {
2437
- Ok(outcome) => outcome,
2438
- Err(error) => {
2439
- let _ = event_log.write(
2440
- "delivery.item_blocked",
2441
- serde_json::json!({
2442
- "message_id": message_id.as_str(),
2443
- "error": error.to_string(),
2444
- }),
2445
- );
2446
- continue;
2447
- }
2448
- };
2449
- if matches!(outcome.status, DeliveryStatus::Delivered) {
2450
- delivered.push(message_id);
2451
- }
2452
- }
2453
- Ok(delivered)
2454
- }
2455
-
2456
- struct PendingMessage {
2457
- sender: String,
2458
- recipient: String,
2459
- content: String,
2460
- task_id: Option<String>,
2461
- owner_team_id: Option<String>,
2462
- status: String,
2463
- error: Option<String>,
2464
- delivery_attempts: u32,
2465
- created_at: Option<String>,
2466
- }
2467
-
2468
- fn message_for_delivery(
2469
- store: &MessageStore,
2470
- message_id: &str,
2471
- ) -> Result<Option<PendingMessage>, MessagingError> {
2472
- let conn = crate::db::schema::open_db(store.db_path())?;
2473
- let message = conn
2474
- .query_row(
2475
- "select sender, recipient, content, task_id, owner_team_id, status, error, delivery_attempts, created_at from messages where message_id = ?1",
2476
- params![message_id],
2477
- |row| {
2478
- Ok(PendingMessage {
2479
- sender: row.get::<_, String>(0)?,
2480
- recipient: row.get::<_, String>(1)?,
2481
- content: row.get::<_, String>(2)?,
2482
- task_id: row.get::<_, Option<String>>(3)?,
2483
- owner_team_id: row.get::<_, Option<String>>(4)?,
2484
- status: row.get::<_, String>(5)?,
2485
- error: row.get::<_, Option<String>>(6)?,
2486
- delivery_attempts: row.get::<_, i64>(7)?.max(0) as u32,
2487
- created_at: row.get::<_, Option<String>>(8)?,
2488
- })
2489
- },
2490
- )
2491
- .optional()?;
2492
- Ok(message)
2493
- }
2494
-
2495
- /// Pre-inject gate (Contract B): peek the recipient pane and answer "is there an
2496
- /// actionable provider startup prompt right now (trust menu or update prompt)" using
2497
- /// the SHARED provider/startup_prompt recognizers — no second classifier, no provider
2498
- /// API calls. Returns `false` if capture fails so providers without a startup
2499
- /// recognizer (or any pane without the trust-menu shape) keep flowing through
2500
- /// normal delivery.
2501
- fn recipient_pane_has_actionable_startup_prompt(
2502
- transport: &dyn Transport,
2503
- state: &serde_json::Value,
2504
- recipient: &str,
2505
- target: &Target,
2506
- ) -> bool {
2507
- let agent = state
2508
- .get("agents")
2509
- .and_then(serde_json::Value::as_object)
2510
- .and_then(|agents| agents.get(recipient));
2511
- let provider = agent
2512
- .and_then(|agent| agent.get("provider"))
2513
- .and_then(serde_json::Value::as_str)
2514
- .and_then(parse_canonical_provider);
2515
- let Some(provider) = provider else {
2516
- return false;
2517
- };
2518
- if matches!(provider, Provider::GeminiCli | Provider::Fake) {
2519
- return false;
2520
- }
2521
- // step2-retry/scrollback root-cause (rt binary 6c9c6c1c): once the agent's
2522
- // `startup_prompts` has been flipped to `handled`/`complete`, the trust modal
2523
- // has been answered and is the AUTHORITATIVE record of "no actionable startup
2524
- // prompt remains". A `tmux capture-pane -S -` Full capture STILL contains the
2525
- // dismissed modal text in scrollback ("Do you trust …" + `› 1. Yes, continue`),
2526
- // so the recognizer's actionable-shape override matches the residue and the
2527
- // delivery gate would loop forever (49-attempt no-deliver in real machine).
2528
- // Trust the state (same source step1-idem uses) and skip the classify entirely.
2529
- let startup_prompts = agent
2530
- .and_then(|agent| agent.get("startup_prompts"))
2531
- .and_then(serde_json::Value::as_str);
2532
- if matches!(startup_prompts, Some("handled" | "complete")) {
2533
- return false;
2534
- }
2535
- // U1-C wave-2: Tail(80) instead of Full. The peek is the DELIVERY-SITE pre-check
2536
- // (NOT the startup-prompts dismissal phase, which legitimately needs the full
2537
- // scrollback to anchor recency). Limiting to the visible screen avoids matching
2538
- // residual already-answered trust modals that scrolled off — while a live trust
2539
- // modal would still appear in the last 80 lines because Codex pins it to the
2540
- // visible region until dismissed. Pair this with the U1-C recency guard in
2541
- // `has_actionable_trust_shape`: either fix alone covers the symptom; both
2542
- // together defend against both scrollback-residue AND pre-render pathologies.
2543
- let captured = match std::panic::catch_unwind(std::panic::AssertUnwindSafe(|| {
2544
- transport.capture(target, crate::transport::CaptureRange::Tail(80))
2545
- })) {
2546
- Ok(Ok(captured)) => captured.text,
2547
- _ => return false,
2548
- };
2549
- match provider {
2550
- Provider::Copilot => matches!(
2551
- crate::provider::classify_copilot_startup_screen(&captured),
2552
- crate::provider::StartupScreenDecision::AnswerWorkspaceTrust
2553
- ),
2554
- // Claude Code, Codex, Grok and Pi workers run only through their
2555
- // contract leaves; a legacy row was refused before this peek.
2556
- Provider::Claude
2557
- | Provider::ClaudeCode
2558
- | Provider::Codex
2559
- | Provider::Pi
2560
- | Provider::Grok
2561
- | Provider::GeminiCli
2562
- | Provider::Fake => false,
2563
- }
2564
- }
2565
-
2566
- fn recipient_provider(state: &serde_json::Value, recipient: &str) -> Option<Provider> {
2567
- state
2568
- .get("agents")
2569
- .and_then(serde_json::Value::as_object)
2570
- .and_then(|agents| agents.get(recipient))
2571
- .and_then(|agent| agent.get("provider"))
2572
- .and_then(serde_json::Value::as_str)
2573
- .and_then(parse_canonical_provider)
2574
- }
2575
-
2576
- fn leader_rollout_path(state: &serde_json::Value) -> Option<std::path::PathBuf> {
2577
- if let Some(receiver) = leader_receiver_value(state).filter(|receiver| {
2578
- receiver.get("provider").and_then(serde_json::Value::as_str) == Some("pi")
2579
- && receiver.get("native_session").is_some()
2580
- }) {
2581
- let native = receiver.get("native_session")?;
2582
- for key in ["pane_id", "tmux_socket", "leader_session_uuid", "owner_epoch"] {
2583
- let bound = native.get(key)?;
2584
- if bound.is_null() || receiver.get(key) != Some(bound) {
2585
- return None;
2586
- }
2587
- }
2588
- // Managed Pi's native ID is distinct from leader_session_uuid.
2589
- // The JSONL appears asynchronously. Resolve only inside the recorded
2590
- // root, by exact id/cwd/spawn time; ambiguity or an unknown
2591
- // NativeDefault root stays unavailable (no HOME scan).
2592
- let context = crate::provider::CaptureSessionContext {
2593
- agent_id: "leader".into(),
2594
- spawn_cwd: native.get("spawn_cwd")?.as_str()?.into(),
2595
- pane_id: None,
2596
- pane_pid: None,
2597
- spawned_at: Some(native.get("spawned_at")?.as_str()?.into()),
2598
- expected_session_id: native
2599
- .get("expected_session_id")
2600
- .and_then(|value| value.as_str())
2601
- .filter(|value| !value.is_empty())
2602
- .map(crate::provider::SessionId::new),
2603
- provider_projects_root: Some(native.get("provider_projects_root")?.as_str()?.into()),
2604
- };
2605
- if !context.spawn_cwd.is_absolute()
2606
- || !context.provider_projects_root.as_ref()?.is_absolute()
2607
- {
2608
- return None;
2609
- }
2610
- let candidates = crate::provider::session_scan::scan_session_candidates_once(
2611
- Provider::Pi,
2612
- &context,
2613
- )
2614
- .ok()?;
2615
- return match candidates.as_slice() {
2616
- [candidate] => candidate
2617
- .captured
2618
- .rollout_path
2619
- .as_ref()
2620
- .map(|path| path.as_path().to_path_buf()),
2621
- _ => None,
2622
- };
2623
- }
2624
- state
2625
- .get("leader")
2626
- .and_then(|leader| leader.get("rollout_path"))
2627
- .and_then(serde_json::Value::as_str)
2628
- .or_else(|| {
2629
- leader_receiver_value(state)
2630
- .and_then(|receiver| receiver.get("rollout_path"))
2631
- .and_then(serde_json::Value::as_str)
2632
- })
2633
- .filter(|path| !path.is_empty())
2634
- .map(std::path::PathBuf::from)
2635
- }
2636
-
2637
- #[derive(Debug, Clone, Copy, PartialEq, Eq)]
2638
- pub(crate) enum LeaderReceiptObservation {
2639
- SourceUnavailable,
2640
- TokenAbsent,
2641
- TokenObserved,
2642
- }
2643
-
2644
- pub(crate) fn observe_leader_receipt(
2645
- state: &serde_json::Value,
2646
- message_id: &str,
2647
- ) -> LeaderReceiptObservation {
2648
- let Some(path) = leader_rollout_path(state) else {
2649
- return LeaderReceiptObservation::SourceUnavailable;
2650
- };
2651
- let Ok(observed) = rollout_tail_contains_result(
2652
- &path,
2653
- &format!("[team-agent-token:{message_id}]"),
2654
- 64 * 1024,
2655
- ) else {
2656
- return LeaderReceiptObservation::SourceUnavailable;
2657
- };
2658
- if observed {
2659
- LeaderReceiptObservation::TokenObserved
2660
- } else {
2661
- LeaderReceiptObservation::TokenAbsent
2662
- }
2663
- }
2664
-
2665
- pub(crate) fn leader_transcript_has_token(state: &serde_json::Value, message_id: &str) -> bool {
2666
- observe_leader_receipt(state, message_id) == LeaderReceiptObservation::TokenObserved
2667
- }
2668
-
2669
- fn leader_acceptance_pending_outcome(message_id: &str, status: &str) -> DeliveryOutcome {
2670
- DeliveryOutcome {
2671
- ok: true,
2672
- status: DeliveryStatus::RetryScheduled,
2673
- message_status: MessageStatusShadow(status.to_string()),
2674
- message_id: Some(message_id.to_string()),
2675
- verification: Some("provider_receipt_not_observed".to_string()),
2676
- stage: Some(DeliveryStage::Submit),
2677
- reason: None,
2678
- channel: Some("leader_acceptance_pending".to_string()),
2679
- ack_forced_off: false,
2680
- turn_verification: None,
2681
- }
2682
- }
2683
-
2684
- pub(crate) fn leader_receipt_source_unavailable_outcome(message_id: &str) -> DeliveryOutcome {
2685
- DeliveryOutcome {
2686
- ok: true,
2687
- status: DeliveryStatus::Blocked,
2688
- message_status: MessageStatusShadow("injected_awaiting_receipt".to_string()),
2689
- message_id: Some(message_id.to_string()),
2690
- verification: Some("leader_receipt_source_unavailable".to_string()),
2691
- stage: Some(DeliveryStage::Submit),
2692
- reason: None,
2693
- channel: Some("leader_receipt_source_unavailable".to_string()),
2694
- ack_forced_off: false,
2695
- turn_verification: None,
2696
- }
2697
- }
2698
-
2699
- fn observe_pending_leader_acceptance(
2700
- store: &MessageStore,
2701
- event_log: &EventLog,
2702
- state: &serde_json::Value,
2703
- message_id: &str,
2704
- ) -> Result<DeliveryOutcome, MessagingError> {
2705
- match observe_leader_receipt(state, message_id) {
2706
- LeaderReceiptObservation::SourceUnavailable => {
2707
- store.mark_injected_awaiting_receipt(message_id)?;
2708
- event_log.write(
2709
- "leader_receiver.receipt_source_unavailable",
2710
- serde_json::json!({"message_id": message_id}),
2711
- )?;
2712
- return Ok(leader_receipt_source_unavailable_outcome(message_id));
2713
- }
2714
- LeaderReceiptObservation::TokenAbsent => {
2715
- return Ok(leader_acceptance_pending_outcome(
2716
- message_id,
2717
- "submitted_pending_acceptance",
2718
- ));
2719
- }
2720
- LeaderReceiptObservation::TokenObserved => {}
2721
- }
2722
- store.mark_delivered_with_receipt(message_id)?;
2723
- event_log.write(
2724
- "message.delivered",
2725
- serde_json::json!({"message_id": message_id}),
2726
- )?;
2727
- Ok(DeliveryOutcome {
2728
- ok: true,
2729
- status: DeliveryStatus::Delivered,
2730
- message_status: MessageStatusShadow("delivered".to_string()),
2731
- message_id: Some(message_id.to_string()),
2732
- verification: Some("provider_transcript_receipt".to_string()),
2733
- stage: None,
2734
- reason: None,
2735
- channel: Some("leader_receiver".to_string()),
2736
- ack_forced_off: false,
2737
- turn_verification: None,
2738
- })
2739
- }
2740
-
2741
- /// `_handle_trust_retry_needed` (`delivery.py:221`):trust 应答失败时调度有界退避重试
2742
- /// (`attempt < MAX` → schedule;`>= MAX` → 终态 mark failed + `trust_auto_answer_exhausted`)。
2743
- pub fn handle_trust_retry_needed(
2744
- store: &MessageStore,
2745
- payload: &TrustRetryPayload,
2746
- event_log: &EventLog,
2747
- ) -> Result<DeliveryOutcome, MessagingError> {
2748
- if payload.attempt >= payload.max_attempts {
2749
- let _ = store.mark(
2750
- &payload.message_id,
2751
- "failed",
2752
- Some("trust_auto_answer_exhausted"),
2753
- );
2754
- event_log.write(
2755
- "leader_panes.trust_auto_answer_exhausted",
2756
- serde_json::json!({"message_id": payload.message_id, "attempt": payload.attempt}),
2757
- )?;
2758
- return Ok(DeliveryOutcome {
2759
- ok: false,
2760
- status: DeliveryStatus::TrustAutoAnswerExhausted,
2761
- message_status: MessageStatusShadow("failed".to_string()),
2762
- message_id: Some(payload.message_id.clone()),
2763
- verification: None,
2764
- stage: Some(DeliveryStage::TrustAutoAnswerDismissalWait),
2765
- reason: None,
2766
- channel: None,
2767
- ack_forced_off: false,
2768
- turn_verification: None,
2769
- });
2770
- }
2771
- let next_attempt = payload.attempt.saturating_add(1);
2772
- let backoff = super::TRUST_RETRY_BACKOFF_SECONDS
2773
- .iter()
2774
- .find_map(|(attempt, seconds)| (*attempt == next_attempt).then_some(*seconds))
2775
- .unwrap_or(30);
2776
- let due_at = (chrono::Utc::now() + chrono::Duration::seconds(i64::from(backoff))).to_rfc3339();
2777
- let conn = crate::db::schema::open_db(store.db_path())?;
2778
- conn.execute(
2779
- "insert into scheduled_events(owner_team_id, due_at, target, kind, payload_json, status, created_at)
2780
- values (null, ?1, ?2, 'trust_retry', ?3, 'pending', ?4)",
2781
- params![
2782
- due_at,
2783
- payload.first_target.as_str(),
2784
- serde_json::json!({
2785
- "message_id": payload.message_id,
2786
- "attempt": next_attempt,
2787
- "max_attempts": payload.max_attempts,
2788
- "first_target": payload.first_target.as_str(),
2789
- })
2790
- .to_string(),
2791
- chrono::Utc::now().to_rfc3339(),
2792
- ],
2793
- )?;
2794
- let _ = store.mark(&payload.message_id, "queued_until_trust", None);
2795
- event_log.write(
2796
- "leader_panes.trust_auto_answer_retry_scheduled",
2797
- serde_json::json!({"message_id": payload.message_id, "attempt": next_attempt, "due_at": due_at}),
2798
- )?;
2799
- Ok(DeliveryOutcome {
2800
- ok: false,
2801
- status: DeliveryStatus::RetryScheduled,
2802
- message_status: MessageStatusShadow("queued_until_trust".to_string()),
2803
- message_id: Some(payload.message_id.clone()),
2804
- verification: None,
2805
- stage: Some(DeliveryStage::TrustAutoAnswerDismissalWait),
2806
- reason: None,
2807
- channel: None,
2808
- ack_forced_off: false,
2809
- turn_verification: None,
2810
- })
2811
- }
2812
-
2813
- /// `_execute_trust_retry` (`delivery.py:330`):trust_retry scheduled event 的消费者 ——
2814
- /// 把行重置回 `accepted`,attempt 穿透,重跑 `_deliver_pending_message`。
2815
- pub fn execute_trust_retry(
2816
- workspace: &Path,
2817
- store: &MessageStore,
2818
- transport: &dyn Transport,
2819
- payload: &TrustRetryPayload,
2820
- event_log: &EventLog,
2821
- owner_team_id: Option<&TeamKey>,
2822
- ) -> Result<DeliveryOutcome, MessagingError> {
2823
- let _ = owner_team_id;
2824
- let _ = store.mark(&payload.message_id, "accepted", None);
2825
- let state = crate::state::persist::load_runtime_state(workspace)?;
2826
- deliver_pending_message(
2827
- workspace,
2828
- store,
2829
- transport,
2830
- &payload.message_id,
2831
- event_log,
2832
- &state,
2833
- )
2834
- }
2835
-
2836
- /// `_record_turn_open_if_leader_to_worker` (`delivery.py:430`):**take-over arm 来自真实投递**
2837
- /// (card §121) —— 仅 leader→worker 注入/投递成功后才 arm,绝不凭空 arm。
2838
- pub(crate) fn record_turn_open_if_leader_to_worker(
2839
- workspace: &Path,
2840
- state: &serde_json::Value,
2841
- sender: &str,
2842
- recipient: &str,
2843
- delivered: &DeliveryOutcome,
2844
- event_log: &EventLog,
2845
- ) -> Result<(), MessagingError> {
2846
- let _ = state;
2847
- record_turn_open_if_leader_to_worker_scoped(
2848
- workspace, sender, recipient, delivered, event_log, None, None,
2849
- )
2850
- }
2851
-
2852
- /// A rescue that supplies the first successful Enter must arm the same turn
2853
- /// linkage as normal delivery, immediately after the key (not after UI polling).
2854
- pub(super) fn with_rescue_submit_observer<R>(
2855
- workspace: &Path,
2856
- store: &MessageStore,
2857
- context: &crate::transport::enter_rescue::EnterRescueContext,
2858
- event_log: &EventLog,
2859
- execute: impl FnOnce(&dyn SubmitObserver) -> Result<R, MessagingError>,
2860
- ) -> Result<R, MessagingError> {
2861
- let request = context;
2862
- let binding = context.target.as_ref().filter(|target| target.bound())
2863
- .ok_or_else(|| MessagingError::Validation("enter_rescue: original binding missing".into()))?;
2864
- let conn = crate::db::schema::open_db(store.db_path())?;
2865
- let sender: String = conn.query_row(
2866
- "select sender from messages where message_id=?1 and owner_team_id=?2 and recipient=?3 and status='submitted_unverified'",
2867
- params![request.message_id, request.owner_team_id, request.recipient],
2868
- |row| row.get(0),
2869
- )?;
2870
- let metadata = TargetMetadata {
2871
- tmux_endpoint: Some(binding.endpoint.clone()),
2872
- target_session: binding.session.clone(),
2873
- target_window: binding.window.clone(),
2874
- target_pane_id: binding.pane_id.clone(),
2875
- target_pane_pid: Some(binding.pane_pid),
2876
- resolved_from: "enter_rescue_owned_binding",
2877
- };
2878
- let mut observer = CurrentTurnSubmitObserver::new(
2879
- workspace, &sender, &request.recipient, &request.message_id, event_log,
2880
- Some(&request.owner_team_id), Some(&metadata),
2881
- );
2882
- observer.rescue_context = Some(context);
2883
- let result = execute(&observer)?;
2884
- if let Some(error) = observer.take_error() { return Err(error); }
2885
- Ok(result)
2886
- }
2887
-
2888
- struct CurrentTurnSubmitObserver<'a> {
2889
- workspace: &'a Path,
2890
- sender: &'a str,
2891
- recipient: &'a str,
2892
- message_id: &'a str,
2893
- event_log: &'a EventLog,
2894
- owner_team_id: Option<&'a str>,
2895
- metadata: Option<&'a TargetMetadata>,
2896
- rescue_context: Option<&'a crate::transport::enter_rescue::EnterRescueContext>,
2897
- fired: Cell<bool>,
2898
- error: RefCell<Option<MessagingError>>,
2899
- }
2900
-
2901
- impl<'a> CurrentTurnSubmitObserver<'a> {
2902
- fn new(
2903
- workspace: &'a Path,
2904
- sender: &'a str,
2905
- recipient: &'a str,
2906
- message_id: &'a str,
2907
- event_log: &'a EventLog,
2908
- owner_team_id: Option<&'a str>,
2909
- metadata: Option<&'a TargetMetadata>,
2910
- ) -> Self {
2911
- Self {
2912
- workspace,
2913
- sender,
2914
- recipient,
2915
- message_id,
2916
- event_log,
2917
- owner_team_id,
2918
- metadata,
2919
- rescue_context: None,
2920
- fired: Cell::new(false),
2921
- error: RefCell::new(None),
2922
- }
2923
- }
2924
-
2925
- fn take_error(&self) -> Option<MessagingError> {
2926
- self.error.borrow_mut().take()
2927
- }
2928
- }
2929
-
2930
- impl SubmitObserver for CurrentTurnSubmitObserver<'_> {
2931
- fn after_physical_submit(&self) {
2932
- if self.fired.replace(true) {
2933
- return;
2934
- }
2935
- let result = if let Some(context) = self.rescue_context {
2936
- record_rescue_turn_after_submit(self.workspace, self.sender, context, self.event_log, self.metadata)
2937
- } else {
2938
- record_current_turn_after_inject_if_leader_to_worker_scoped(
2939
- self.workspace, self.sender, self.recipient, self.message_id,
2940
- self.event_log, self.owner_team_id, self.metadata,
2941
- )
2942
- };
2943
- if let Err(error) = result { *self.error.borrow_mut() = Some(error); }
2944
- }
2945
- }
2946
-
2947
- fn record_rescue_turn_after_submit(
2948
- workspace: &Path,
2949
- sender: &str,
2950
- context: &crate::transport::enter_rescue::EnterRescueContext,
2951
- event_log: &EventLog,
2952
- metadata: Option<&TargetMetadata>,
2953
- ) -> Result<(), MessagingError> {
2954
- let request = context;
2955
- let target = context.target.as_ref().filter(|target| target.bound())
2956
- .ok_or_else(|| MessagingError::Validation("enter_rescue: original binding missing".into()))?;
2957
- if !matches!(sender, "leader" | "Leader") { return Ok(()); }
2958
- crate::state::repository::StateRepository::new(workspace).commit_messaging_checked(
2959
- crate::state::repository::StateWriteIntent::MessagingDeliveryState {
2960
- owner_team_id: Some(&request.owner_team_id),
2961
- },
2962
- |selected| {
2963
- let agent = selected.get("agents").and_then(|agents| agents.get(&request.recipient));
2964
- let matches = agent.is_some_and(|agent| {
2965
- agent.get("status").and_then(serde_json::Value::as_str) == Some("running")
2966
- && agent.get("explicit_stop").and_then(serde_json::Value::as_bool) != Some(true)
2967
- && agent.get("pane_id").and_then(serde_json::Value::as_str) == Some(target.pane_id.as_str())
2968
- && agent.get("pane_pid").and_then(serde_json::Value::as_u64) == Some(u64::from(target.pane_pid))
2969
- && agent.get("window").and_then(serde_json::Value::as_str).unwrap_or(&request.recipient) == target.window
2970
- && agent.get("provider").cloned().and_then(|value| serde_json::from_value::<Provider>(value).ok()) == Some(target.provider)
2971
- && selected.get("session_name").and_then(serde_json::Value::as_str) == Some(target.session.as_str())
2972
- });
2973
- if !matches {
2974
- return Err(crate::state::StateError::SaveConflict("rescue receiver changed before turn commit".into()));
2975
- }
2976
- arm_turn_open(selected, &request.recipient, &Some(request.message_id.clone()));
2977
- Ok(())
2978
- },
2979
- )?;
2980
- let mut event = serde_json::json!({"agent_id": request.recipient, "message_id": request.message_id});
2981
- if let Some(metadata) = metadata { append_target_metadata(&mut event, metadata); }
2982
- event_log.write("turn_open.armed_after_inject", event)?;
2983
- Ok(())
2984
- }
2985
-
2986
- fn record_current_turn_after_inject_if_leader_to_worker_scoped(
2987
- workspace: &Path,
2988
- sender: &str,
2989
- recipient: &str,
2990
- message_id: &str,
2991
- event_log: &EventLog,
2992
- owner_team_id: Option<&str>,
2993
- metadata: Option<&TargetMetadata>,
2994
- ) -> Result<(), MessagingError> {
2995
- if !matches!(sender, "leader" | "Leader") || recipient == "leader" {
2996
- return Ok(());
2997
- }
2998
- let message_id = Some(message_id.to_string());
2999
- let mut state = scoped_state_for_write(workspace, owner_team_id)?;
3000
- arm_turn_open(&mut state, recipient, &message_id);
3001
- save_scoped_state_reapplying_after_conflict(workspace, &state, owner_team_id, |latest| {
3002
- arm_turn_open(latest, recipient, &message_id);
3003
- })?;
3004
- let mut event = serde_json::json!({"agent_id": recipient, "message_id": message_id});
3005
- if let Some(metadata) = metadata {
3006
- append_target_metadata(&mut event, metadata);
3007
- }
3008
- event_log.write("turn_open.armed_after_inject", event)?;
3009
- Ok(())
3010
- }
3011
-
3012
- fn record_turn_open_if_leader_to_worker_scoped(
3013
- workspace: &Path,
3014
- sender: &str,
3015
- recipient: &str,
3016
- delivered: &DeliveryOutcome,
3017
- event_log: &EventLog,
3018
- owner_team_id: Option<&str>,
3019
- metadata: Option<&TargetMetadata>,
3020
- ) -> Result<(), MessagingError> {
3021
- if !delivered.ok || !matches!(sender, "leader" | "Leader") || recipient == "leader" {
3022
- return Ok(());
3023
- }
3024
- let mut state = scoped_state_for_write(workspace, owner_team_id)?;
3025
- arm_turn_open(&mut state, recipient, &delivered.message_id);
3026
- save_scoped_state_reapplying_after_conflict(workspace, &state, owner_team_id, |latest| {
3027
- arm_turn_open(latest, recipient, &delivered.message_id);
3028
- })?;
3029
- let mut event = serde_json::json!({"agent_id": recipient, "message_id": delivered.message_id});
3030
- if let Some(metadata) = metadata {
3031
- append_target_metadata(&mut event, metadata);
3032
- }
3033
- event_log.write("turn_open.armed_after_delivery", event)?;
3034
- Ok(())
3035
- }
3036
-
3037
- fn arm_turn_open(state: &mut serde_json::Value, recipient: &str, message_id: &Option<String>) {
3038
- let Some(root) = state.as_object_mut() else {
3039
- return;
3040
- };
3041
- let coordinator = root
3042
- .entry("coordinator")
3043
- .or_insert_with(|| serde_json::json!({}));
3044
- if let Some(obj) = coordinator.as_object_mut() {
3045
- obj.insert(
3046
- "turn_open".to_string(),
3047
- serde_json::json!({"armed": true, "node_id": recipient, "turn_id": message_id}),
3048
- );
3049
- }
3050
- if let Some(agent) = root
3051
- .get_mut("agents")
3052
- .and_then(serde_json::Value::as_object_mut)
3053
- .and_then(|agents| agents.get_mut(recipient))
3054
- .and_then(serde_json::Value::as_object_mut)
3055
- {
3056
- // Phase-DX E2 (CR P0 red line #5): the leader→worker turn message id.
3057
- // Renamed from a misleading legacy field name (which was never a task
3058
- // FSM id — task FSM is A1) to `current_turn_message_id`, matching its
3059
- // actual semantic. Reader compatibility lives in `coordinator/tick.rs`
3060
- // (whitelisted for the transition) and `mcp_server/helpers.rs`; other
3061
- // messaging/lifecycle/mcp_server code MUST NOT treat this as
3062
- // authoritative task state.
3063
- let field = message_id.as_ref().map_or(serde_json::Value::Null, |id| {
3064
- serde_json::Value::String(id.clone())
3065
- });
3066
- agent.insert("current_turn_message_id".to_string(), field);
3067
- }
3068
- }
3069
-
3070
- /// `_stamp_first_send_at_if_leader_to_worker` (`delivery.py:380`):首次 leader→worker 投递戳
3071
- /// `first_send_at` (step 13 restart Route B atomicity 决策读它)。
3072
- pub(crate) fn stamp_first_send_at_if_leader_to_worker(
3073
- workspace: &Path,
3074
- state: &serde_json::Value,
3075
- sender: &str,
3076
- recipient: &str,
3077
- ) -> Result<(), MessagingError> {
3078
- let _ = state;
3079
- stamp_first_send_at_if_leader_to_worker_scoped(workspace, sender, recipient, None)
3080
- }
3081
-
3082
- fn stamp_first_send_at_if_leader_to_worker_scoped(
3083
- workspace: &Path,
3084
- sender: &str,
3085
- recipient: &str,
3086
- owner_team_id: Option<&str>,
3087
- ) -> Result<(), MessagingError> {
3088
- if !matches!(sender, "leader" | "Leader") || recipient == "leader" {
3089
- return Ok(());
3090
- }
3091
- let mut state = scoped_state_for_write(workspace, owner_team_id)?;
3092
- let now = chrono::Utc::now().to_rfc3339();
3093
- if stamp_first_send_at(&mut state, recipient, &now) {
3094
- save_scoped_state_reapplying_after_conflict(workspace, &state, owner_team_id, |latest| {
3095
- let _ = stamp_first_send_at(latest, recipient, &now);
3096
- })?;
3097
- }
3098
- Ok(())
3099
- }
3100
-
3101
- fn stamp_first_send_at(state: &mut serde_json::Value, recipient: &str, now: &str) -> bool {
3102
- if let Some(agent) = state
3103
- .get_mut("agents")
3104
- .and_then(serde_json::Value::as_object_mut)
3105
- .and_then(|agents| agents.get_mut(recipient))
3106
- .and_then(serde_json::Value::as_object_mut)
3107
- {
3108
- if !agent.contains_key("first_send_at")
3109
- || agent
3110
- .get("first_send_at")
3111
- .is_some_and(serde_json::Value::is_null)
3112
- {
3113
- agent.insert(
3114
- "first_send_at".to_string(),
3115
- serde_json::Value::String(now.to_string()),
3116
- );
3117
- return true;
3118
- }
3119
- }
3120
- false
3121
- }
3122
-
3123
- fn scoped_state_for_write(
3124
- workspace: &Path,
3125
- owner_team_id: Option<&str>,
3126
- ) -> Result<serde_json::Value, MessagingError> {
3127
- match owner_team_id.filter(|team| !team.is_empty()) {
3128
- Some(team) => {
3129
- let raw = crate::state::persist::load_runtime_state(workspace)?;
3130
- match project_state_for_owner_team_value(&raw, team) {
3131
- Some(projected) => Ok(projected),
3132
- None => Ok(raw),
3133
- }
3134
- }
3135
- None => Ok(crate::state::persist::load_runtime_state(workspace)?),
3136
- }
3137
- }
3138
-
3139
- fn save_scoped_state(
3140
- workspace: &Path,
3141
- state: &serde_json::Value,
3142
- owner_team_id: Option<&str>,
3143
- ) -> Result<(), MessagingError> {
3144
- let scoped_owner_team_id = owner_team_id.filter(|team| !team.is_empty()).filter(|_| {
3145
- state
3146
- .get("teams")
3147
- .and_then(serde_json::Value::as_object)
3148
- .is_some_and(|teams| {
3149
- owner_team_id
3150
- .and_then(|team| {
3151
- crate::state::projection::resolve_owner_team_id(state, team)
3152
- .canonical_key()
3153
- .map(str::to_string)
3154
- })
3155
- .is_some_and(|team| teams.contains_key(&team))
3156
- })
3157
- });
3158
- crate::state::repository::StateRepository::new(workspace).save(
3159
- crate::state::repository::StateWriteIntent::MessagingDeliveryState {
3160
- owner_team_id: scoped_owner_team_id,
3161
- },
3162
- state,
3163
- )?;
3164
- Ok(())
3165
- }
3166
-
3167
- fn save_scoped_state_reapplying_after_conflict<F>(
3168
- workspace: &Path,
3169
- state: &serde_json::Value,
3170
- owner_team_id: Option<&str>,
3171
- reapply: F,
3172
- ) -> Result<(), MessagingError>
3173
- where
3174
- F: FnOnce(&mut serde_json::Value),
3175
- {
3176
- let scoped_owner_team_id = owner_team_id.filter(|team| !team.is_empty()).filter(|_| {
3177
- state
3178
- .get("teams")
3179
- .and_then(serde_json::Value::as_object)
3180
- .is_some_and(|teams| {
3181
- owner_team_id
3182
- .and_then(|team| {
3183
- crate::state::projection::resolve_owner_team_id(state, team)
3184
- .canonical_key()
3185
- .map(str::to_string)
3186
- })
3187
- .is_some_and(|team| teams.contains_key(&team))
3188
- })
3189
- });
3190
- crate::state::repository::StateRepository::new(workspace).save_reapplying(
3191
- crate::state::repository::StateWriteIntent::MessagingDeliveryState {
3192
- owner_team_id: scoped_owner_team_id,
3193
- },
3194
- state,
3195
- reapply,
3196
- )?;
3197
- Ok(())
3198
- }
3199
-
3200
- enum OwnerTeamProjection {
3201
- Projected {
3202
- state: serde_json::Value,
3203
- canonical_team: String,
3204
- },
3205
- Refused(DeliveryOutcome),
3206
- }
3207
-
3208
- fn project_state_for_owner_team(
3209
- workspace: &Path,
3210
- team: &str,
3211
- fallback: &serde_json::Value,
3212
- store: Option<&MessageStore>,
3213
- message_id: Option<&str>,
3214
- event_log: Option<&EventLog>,
3215
- ) -> Result<OwnerTeamProjection, MessagingError> {
3216
- #[cfg(test)]
3217
- preparation_probe::COUNTS.with(|counts| {
3218
- let (prepare, project, claim) = counts.get();
3219
- counts.set((prepare, project + 1, claim));
3220
- });
3221
- let raw = crate::state::persist::load_runtime_state(workspace)?;
3222
- let fallback_has_teams = fallback
3223
- .get("teams")
3224
- .and_then(serde_json::Value::as_object)
3225
- .is_some_and(|teams| !teams.is_empty());
3226
- let (mut projection_source, mut resolution) = if fallback_has_teams {
3227
- (
3228
- fallback,
3229
- crate::state::projection::resolve_owner_team_id(fallback, team),
3230
- )
3231
- } else {
3232
- (
3233
- &raw,
3234
- crate::state::projection::resolve_owner_team_id(&raw, team),
3235
- )
3236
- };
3237
- if !fallback_has_teams && matches!(resolution, OwnerTeamResolution::Unresolved { .. }) {
3238
- let fallback_resolution = crate::state::projection::resolve_owner_team_id(fallback, team);
3239
- if !matches!(fallback_resolution, OwnerTeamResolution::Unresolved { .. }) {
3240
- resolution = fallback_resolution;
3241
- projection_source = fallback;
3242
- }
3243
- }
3244
- let canonical_team = match resolution {
3245
- OwnerTeamResolution::Canonical(canonical) => canonical,
3246
- OwnerTeamResolution::LegacyAlias {
3247
- requested,
3248
- canonical,
3249
- } => {
3250
- normalize_owner_team_id_rows(workspace, &requested, &canonical, message_id, event_log)?;
3251
- canonical
3252
- }
3253
- OwnerTeamResolution::Unresolved { requested } => {
3254
- let outcome = refuse_owner_team_resolution(
3255
- store,
3256
- message_id,
3257
- event_log,
3258
- "owner_team_unresolved",
3259
- serde_json::json!({"owner_team_id": requested}),
3260
- DeliveryRefusal::UnknownRecipient,
3261
- )?;
3262
- return Ok(OwnerTeamProjection::Refused(outcome));
3263
- }
3264
- OwnerTeamResolution::Ambiguous { requested, matches } => {
3265
- let outcome = refuse_owner_team_resolution(
3266
- store,
3267
- message_id,
3268
- event_log,
3269
- "owner_team_ambiguous",
3270
- serde_json::json!({"owner_team_id": requested, "matches": matches}),
3271
- DeliveryRefusal::Ambiguous,
3272
- )?;
3273
- return Ok(OwnerTeamProjection::Refused(outcome));
3274
- }
3275
- };
3276
- if top_level_state_matches_owner_team(fallback, &canonical_team)
3277
- && state_has_no_team_entries(fallback)
3278
- {
3279
- let mut state = fallback.clone();
3280
- carry_top_level_leader_binding(&mut state, &raw);
3281
- return Ok(OwnerTeamProjection::Projected {
3282
- state,
3283
- canonical_team,
3284
- });
3285
- }
3286
- if top_level_state_matches_owner_team(&raw, &canonical_team) && state_has_no_team_entries(&raw)
3287
- {
3288
- return Ok(OwnerTeamProjection::Projected {
3289
- state: raw,
3290
- canonical_team,
3291
- });
3292
- }
3293
- if state_has_no_team_entries(projection_source) {
3294
- let mut state = projection_source.clone();
3295
- carry_top_level_leader_binding(&mut state, &raw);
3296
- return Ok(OwnerTeamProjection::Projected {
3297
- state,
3298
- canonical_team,
3299
- });
3300
- }
3301
- let mut state = project_state_for_owner_team_value(projection_source, &canonical_team)
3302
- .ok_or_else(|| {
3303
- MessagingError::Routing(format!("owner_team_unresolved: {canonical_team}"))
3304
- })?;
3305
- carry_top_level_leader_binding(&mut state, projection_source);
3306
- carry_top_level_leader_binding(&mut state, &raw);
3307
- Ok(OwnerTeamProjection::Projected {
3308
- state,
3309
- canonical_team,
3310
- })
3311
- }
3312
-
3313
- fn carry_top_level_leader_binding(projected: &mut serde_json::Value, raw: &serde_json::Value) {
3314
- let Some(projected_obj) = projected.as_object_mut() else {
3315
- return;
3316
- };
3317
- for key in ["leader_receiver", "team_owner", "owner_epoch"] {
3318
- if projected_obj.contains_key(key) {
3319
- continue;
3320
- }
3321
- if let Some(value) = raw.get(key) {
3322
- projected_obj.insert(key.to_string(), value.clone());
3323
- }
3324
- }
3325
- }
3326
-
3327
- fn state_has_no_team_entries(state: &serde_json::Value) -> bool {
3328
- state
3329
- .get("teams")
3330
- .and_then(serde_json::Value::as_object)
3331
- .is_none_or(serde_json::Map::is_empty)
3332
- }
3333
-
3334
- pub(crate) fn normalize_owner_team_id_rows(
3335
- workspace: &Path,
3336
- requested: &str,
3337
- canonical: &str,
3338
- message_id: Option<&str>,
3339
- event_log: Option<&EventLog>,
3340
- ) -> Result<(), MessagingError> {
3341
- if requested == canonical {
3342
- return Ok(());
3343
- }
3344
- if let Some(event_log) = event_log {
3345
- event_log.write(
3346
- "owner_team_id.compatibility_alias_detected",
3347
- serde_json::json!({
3348
- "requested_owner_team_id": requested,
3349
- "canonical_owner_team_id": canonical,
3350
- "message_id": message_id,
3351
- "action": "read_only_no_db_update",
3352
- "workspace": workspace.to_string_lossy().to_string(),
3353
- }),
3354
- )?;
3355
- }
3356
- Ok(())
3357
- }
3358
-
3359
- fn refuse_owner_team_resolution(
3360
- store: Option<&MessageStore>,
3361
- message_id: Option<&str>,
3362
- event_log: Option<&EventLog>,
3363
- error: &str,
3364
- details: serde_json::Value,
3365
- refusal: DeliveryRefusal,
3366
- ) -> Result<DeliveryOutcome, MessagingError> {
3367
- if let (Some(store), Some(message_id)) = (store, message_id) {
3368
- store.mark(message_id, "failed", Some(error))?;
3369
- }
3370
- if let Some(event_log) = event_log {
3371
- event_log.write(
3372
- "owner_team_id.resolution_failed",
3373
- serde_json::json!({
3374
- "message_id": message_id,
3375
- "error": error,
3376
- "details": details,
3377
- }),
3378
- )?;
3379
- }
3380
- Ok(DeliveryOutcome {
3381
- ok: false,
3382
- status: DeliveryStatus::Refused,
3383
- message_status: MessageStatusShadow("failed".to_string()),
3384
- message_id: message_id.map(str::to_string),
3385
- verification: Some(error.to_string()),
3386
- stage: None,
3387
- reason: Some(refusal),
3388
- channel: Some("owner_team_resolution".to_string()),
3389
- ack_forced_off: false,
3390
- turn_verification: None,
3391
- })
3392
- }
3393
-
3394
- fn project_state_for_owner_team_value(
3395
- raw: &serde_json::Value,
3396
- team: &str,
3397
- ) -> Option<serde_json::Value> {
3398
- if let Some(projected) = raw
3399
- .get("teams")
3400
- .and_then(serde_json::Value::as_object)
3401
- .is_some_and(|teams| teams.contains_key(team))
3402
- .then(|| crate::state::projection::project_top_level_view(raw, team))
3403
- {
3404
- return Some(projected);
3405
- }
3406
- if top_level_state_matches_owner_team(raw, team) {
3407
- return None;
3408
- }
3409
- None
3410
- }
3411
-
3412
- pub(crate) fn top_level_state_matches_owner_team(state: &serde_json::Value, team: &str) -> bool {
3413
- if !state.is_object() {
3414
- return false;
3415
- }
3416
- if state
3417
- .get("active_team_key")
3418
- .and_then(serde_json::Value::as_str)
3419
- .is_some_and(|value| value == team)
3420
- {
3421
- return true;
3422
- }
3423
- if state
3424
- .get("session_name")
3425
- .and_then(serde_json::Value::as_str)
3426
- .is_some_and(|session| session == team || session.strip_prefix("team-") == Some(team))
3427
- {
3428
- return true;
3429
- }
3430
- let has_explicit_key = ["team_key", "team_dir", "spec_path"].iter().any(|field| {
3431
- state
3432
- .get(*field)
3433
- .and_then(serde_json::Value::as_str)
3434
- .is_some_and(|value| !value.is_empty())
3435
- });
3436
- has_explicit_key && crate::state::projection::team_state_key(state) == team
3437
- }
3438
-
3439
- /// `retry_injection_after_trust_auto_answer` (`trust_auto_answer.py`):leader 路径 trust 应答
3440
- /// 后重注入 (查 pane_width fail-safe + attempt_trust_auto_answer + 等 dismissal + 重 inject)。
3441
- pub fn retry_injection_after_trust_auto_answer(
3442
- workspace: &Path,
3443
- state: &serde_json::Value,
3444
- transport: &dyn Transport,
3445
- target: &Target,
3446
- text: &str,
3447
- provider: Provider,
3448
- event_log: &EventLog,
3449
- ) -> Result<DeliveryOutcome, MessagingError> {
3450
- let _ = (
3451
- workspace, state, transport, target, text, provider, event_log,
3452
- );
3453
- Ok(DeliveryOutcome {
3454
- ok: false,
3455
- status: DeliveryStatus::RetryScheduled,
3456
- message_status: MessageStatusShadow("retry_scheduled".to_string()),
3457
- message_id: None,
3458
- verification: None,
3459
- stage: Some(DeliveryStage::TrustAutoAnswerDismissalWait),
3460
- reason: None,
3461
- channel: None,
3462
- ack_forced_off: false,
3463
- turn_verification: None,
3464
- })
3465
- }
3466
-
3467
- /// S1-CAPTURE-001 (0.4.8 phase-1): bounded tail read of the rollout file
3468
- /// searching for `needle`. Reads up to `tail_bytes` from the end of the file
3469
- /// (default 64KB budget). Returns true iff the needle appears in the tail.
3470
- /// Silent on read errors — callers treat missing/unreadable as "token not
3471
- /// present" which forces the unverified path.
3472
- fn rollout_tail_contains(path: &std::path::Path, needle: &str, tail_bytes: u64) -> bool {
3473
- rollout_tail_contains_result(path, needle, tail_bytes).unwrap_or(false)
3474
- }
3475
-
3476
- fn message_token_marker(message_id: &str) -> String {
3477
- format!("[team-agent-token:{message_id}]")
3478
- }
3479
-
3480
- fn text_contains_message_token(text: &str, message_id: &str) -> bool {
3481
- !message_id.is_empty() && text.contains(&message_token_marker(message_id))
3482
- }
3483
-
3484
- fn marker_occurrences(text: &str, message_id: &str) -> usize {
3485
- text.lines().map(str::trim).collect::<String>()
3486
- .matches(&message_token_marker(message_id)).count()
3487
- }
3488
-
3489
- /// Provider-specific parsing is behind an observation port, never a delivery branch.
3490
- /// None retains existing non-native transport receipts; unknown native frames veto success.
3491
- fn observed_token_consumed(
3492
- transport: &dyn Transport,
3493
- state: &serde_json::Value,
3494
- recipient: &str,
3495
- target: &Target,
3496
- message_id: &str,
3497
- ) -> Option<bool> {
3498
- let provider = recipient_provider(state, recipient)?;
3499
- match transport.observe_native_input(target, provider) {
3500
- Ok(Some(frame)) => Some(frame.composer.is_empty()
3501
- && marker_occurrences(&frame.transcript, message_id) == 1),
3502
- Ok(None) => None,
3503
- Err(_) => Some(false),
3504
- }
3505
- }
3506
-
3507
- fn existing_token_consumed(
3508
- transport: &dyn Transport,
3509
- state: &serde_json::Value,
3510
- recipient: &str,
3511
- target: &Target,
3512
- message_id: &str,
3513
- ) -> bool {
3514
- observed_token_consumed(transport, state, recipient, target, message_id)
3515
- .unwrap_or_else(|| recipient_transcript_contains(state, recipient, &message_token_marker(message_id)))
3516
- }
3517
-
3518
- #[allow(clippy::too_many_arguments)]
3519
- fn bind_enter_watchdog(
3520
- store: &MessageStore,
3521
- transport: &dyn Transport,
3522
- state: &serde_json::Value,
3523
- target: &Target,
3524
- message_id: &str,
3525
- message: &PendingMessage,
3526
- owner_team_id: Option<&str>,
3527
- event_log: &EventLog,
3528
- ) -> Result<(), MessagingError> {
3529
- use crate::transport::enter_rescue::{EnterRescueContext, EnterRescueTarget};
3530
- use sha2::{Digest, Sha256};
3531
- let rendered = render_message(&message.sender, message.task_id.as_deref(), &message.content, message_id);
3532
- let agent = state.get("agents").and_then(|agents| agents.get(&message.recipient));
3533
- let selected = (|| {
3534
- let agent = agent?;
3535
- Some(EnterRescueTarget::selected(
3536
- recipient_provider(state, &message.recipient)?,
3537
- agent.get("pane_id")?.as_str()?.to_string(),
3538
- u32::try_from(agent.get("pane_pid")?.as_u64()?).ok()?,
3539
- state.get("session_name")?.as_str()?.to_string(),
3540
- agent.get("window").and_then(serde_json::Value::as_str)
3541
- .unwrap_or(&message.recipient).to_string(),
3542
- ))
3543
- })();
3544
- let context = EnterRescueContext {
3545
- message_id: message_id.into(),
3546
- owner_team_id: owner_team_id.unwrap_or_default().into(),
3547
- recipient: message.recipient.clone(),
3548
- payload_sha256: format!("{:x}", Sha256::digest(rendered.as_bytes())),
3549
- target: selected,
3550
- proof: None,
3551
- };
3552
- match transport.snapshot_enter_rescue(target, &context, &rendered) {
3553
- Ok(snapshot) => { super::enter_rescue::bind_pending_context(store, &snapshot)?; }
3554
- Err(error) => {
3555
- event_log.write("enter_rescue.snapshot_unavailable", serde_json::json!({
3556
- "message_id": message_id, "reason": error.to_string(),
3557
- }))?;
3558
- }
3559
- }
3560
- Ok(())
3561
- }
3562
-
3563
- /// Visibility prevents a duplicate paste; only a separate consumption receipt permits success.
3564
- /// Read failures do not manufacture visibility. Capture stays bounded to Tail(80).
3565
- pub(crate) fn token_already_visible(
3566
- transport: &dyn Transport,
3567
- state: &serde_json::Value,
3568
- recipient: &str,
3569
- target: &Target,
3570
- message_id: &str,
3571
- ) -> bool {
3572
- if message_id.is_empty() {
3573
- return false;
3574
- }
3575
- let marker = message_token_marker(message_id);
3576
- match transport.capture(target, CaptureRange::Tail(80)) {
3577
- Ok(captured) if text_contains_message_token(&captured.text, message_id) => return true,
3578
- _ => {}
3579
- }
3580
- recipient_transcript_contains(state, recipient, &marker)
3581
- }
3582
-
3583
- fn recipient_transcript_contains(state: &serde_json::Value, recipient: &str, marker: &str) -> bool {
3584
- recipient_transcript_contains_within(state, recipient, marker, 64 * 1024)
3585
- }
3586
-
3587
- /// The receipt row can sit behind seconds of tool output by verdict time.
3588
- const TRANSCRIPT_RECEIPT_TAIL_BYTES: u64 = 1024 * 1024;
3589
-
3590
- fn recipient_transcript_contains_within(
3591
- state: &serde_json::Value,
3592
- recipient: &str,
3593
- marker: &str,
3594
- tail_bytes: u64,
3595
- ) -> bool {
3596
- recipient_transcript_paths(state, recipient)
3597
- .iter()
3598
- .any(|path| rollout_tail_contains(path, marker, tail_bytes))
3599
- }
3600
-
3601
- fn recipient_transcript_paths(
3602
- state: &serde_json::Value,
3603
- recipient: &str,
3604
- ) -> Vec<std::path::PathBuf> {
3605
- let mut paths = Vec::new();
3606
- let push = |paths: &mut Vec<std::path::PathBuf>, value: Option<&serde_json::Value>| {
3607
- if let Some(path) = value
3608
- .and_then(serde_json::Value::as_str)
3609
- .filter(|p| !p.is_empty())
3610
- {
3611
- paths.push(std::path::PathBuf::from(path));
3612
- }
3613
- };
3614
- if recipient == "leader" {
3615
- push(
3616
- &mut paths,
3617
- leader_receiver_record_path(state, "rollout_path"),
3618
- );
3619
- }
3620
- let agent = state.get("agents").and_then(|agents| agents.get(recipient));
3621
- push(
3622
- &mut paths,
3623
- agent.and_then(|agent| agent.get("rollout_path")),
3624
- );
3625
- paths
3626
- }
3627
-
3628
- fn leader_receiver_record_path<'a>(
3629
- state: &'a serde_json::Value,
3630
- field: &str,
3631
- ) -> Option<&'a serde_json::Value> {
3632
- state
3633
- .get("leader_receiver")
3634
- .and_then(|receiver| receiver.get(field))
3635
- .or_else(|| {
3636
- let active = state
3637
- .get("active_team_key")
3638
- .and_then(serde_json::Value::as_str)?;
3639
- state
3640
- .get("teams")
3641
- .and_then(serde_json::Value::as_object)
3642
- .and_then(|teams| teams.get(active))
3643
- .and_then(|team| team.get("leader_receiver"))
3644
- .and_then(|receiver| receiver.get(field))
3645
- })
3646
- }
3647
-
3648
- fn absorb_state_error_only_after_physical_submit(
3649
- transport: &dyn Transport,
3650
- state: &serde_json::Value,
3651
- recipient: &str,
3652
- target: &Target,
3653
- message_id: &str,
3654
- event_log: &EventLog,
3655
- stage: &str,
3656
- error: MessagingError,
3657
- ) -> Result<(), MessagingError> {
3658
- if token_already_visible(transport, state, recipient, target, message_id) {
3659
- log_post_physical_submit_state_error(event_log, message_id, stage, &error)
3660
- } else {
3661
- Err(error)
3662
- }
3663
- }
3664
-
3665
- fn log_post_physical_submit_state_error(
3666
- event_log: &EventLog,
3667
- message_id: &str,
3668
- stage: &str,
3669
- error: &MessagingError,
3670
- ) -> Result<(), MessagingError> {
3671
- event_log.write(
3672
- "delivery.post_submit_state_degraded",
3673
- serde_json::json!({
3674
- "message_id": message_id,
3675
- "stage": stage,
3676
- "error": error.to_string(),
3677
- "physical_submit": true,
3678
- }),
3679
- )?;
3680
- Ok(())
3681
- }
3682
-
3683
- fn rollout_tail_contains_result(
3684
- path: &std::path::Path,
3685
- needle: &str,
3686
- tail_bytes: u64,
3687
- ) -> std::io::Result<bool> {
3688
- use std::io::{Read, Seek, SeekFrom};
3689
- let mut file = std::fs::File::open(path)?;
3690
- let metadata = file.metadata()?;
3691
- let len = metadata.len();
3692
- let start = len.saturating_sub(tail_bytes);
3693
- file.seek(SeekFrom::Start(start))?;
3694
- let mut buf = Vec::with_capacity(tail_bytes.min(len) as usize);
3695
- file.take(tail_bytes).read_to_end(&mut buf)?;
3696
- let haystack = String::from_utf8_lossy(&buf);
3697
- Ok(haystack.contains(needle))
3698
- }
3699
-
3700
- #[cfg(test)]
3701
- #[path = "delivery_consumption_tests.rs"]
3702
- mod consumption_tests;
3703
-
3704
- #[cfg(test)]
3705
- mod paste_floor_tests {
3706
- use super::*;
3707
-
3708
- fn empty_report() -> InjectReport {
3709
- InjectReport {
3710
- stage_reached: crate::transport::InjectStage::Submit,
3711
- inject_verification: InjectVerification::CaptureMissingToken,
3712
- submit_verification: SubmitVerification::SubmitConsumptionUnverified,
3713
- turn_verification: crate::transport::TurnVerification::NotYetObserved,
3714
- attempts: 1,
3715
- submit_diagnostics: Some(crate::transport::SubmitDiagnostics {
3716
- consumption_reason: SubmitConsumptionReason::Unverified,
3717
- before_busy_signal_kind: Some(BusySignalKind::Working),
3718
- busy_signal_kind: Some(BusySignalKind::SpinnerGlyph),
3719
- busy_line_from_bottom: Some(2),
3720
- current_marker_in_bottom_15: Some(false),
3721
- paste_identity_in_composer: None,
3722
- consumption_from_capture_result: Some(false),
3723
- last_capture_outcome: CaptureSampleOutcome::Failed,
3724
- capture_err_count: 1,
3725
- capture_sample_count: 1,
3726
- pane_command_basename: Some("grok".to_string()),
3727
- pane_command_query: QueryOutcome::Observed,
3728
- input_surface: InputSurfaceProbe::Input,
3729
- target_pane_id: Some("%9".to_string()),
3730
- target_pane_query_matched: Some(true),
3731
- token_seen_after_paste: None,
3732
- ..crate::transport::SubmitDiagnostics::default()
3733
- }),
3734
- }
3735
- }
3736
-
3737
- #[test]
3738
- fn inject_readback_fields_are_safe_scalars_and_keep_attempts_array() {
3739
- let report = empty_report();
3740
- let mut event = serde_json::json!({
3741
- "message_id": "msg_x",
3742
- "submit_attempts_detail": [{"matched": false}],
3743
- });
3744
- merge_inject_readback_fields(
3745
- &mut event,
3746
- &report,
3747
- Some(&Target::Pane(PaneId::new("%9"))),
3748
- None,
3749
- );
3750
- assert_eq!(event["last_capture_outcome"], serde_json::json!("failed"));
3751
- assert_eq!(event["consumption_reason"], serde_json::json!("unverified"));
3752
- assert_eq!(
3753
- event["before_busy_signal_kind"],
3754
- serde_json::json!("working")
3755
- );
3756
- assert_eq!(event["busy_signal_kind"], serde_json::json!("spinner_glyph"));
3757
- assert_eq!(event["busy_line_from_bottom"], serde_json::json!(2));
3758
- assert_eq!(
3759
- event["current_marker_in_bottom_15"],
3760
- serde_json::json!(false)
3761
- );
3762
- assert_eq!(event["paste_identity_in_composer"], serde_json::Value::Null);
3763
- assert_eq!(
3764
- event["consumption_from_capture_result"],
3765
- serde_json::json!(false)
3766
- );
3767
- assert_eq!(event["token_seen_after_paste"], serde_json::Value::Null);
3768
- assert_eq!(event["pane_command_basename"], serde_json::json!("grok"));
3769
- assert_eq!(event["input_surface"], serde_json::json!("input"));
3770
- assert_eq!(event["inject_target_pane_id"], serde_json::json!("%9"));
3771
- assert!(event["submit_attempts_detail"].is_array());
3772
- assert!(event.get("pane_tail_excerpt").is_none());
3773
- let dump = event.to_string();
3774
- assert!(
3775
- !dump.contains("--help") && !dump.contains("argv"),
3776
- "readback fields must not leak argv: {dump}"
3777
- );
3778
- assert_eq!(
3779
- report.inject_verification,
3780
- InjectVerification::CaptureMissingToken
3781
- );
3782
- assert!(!inject_submit_verified(&report));
3783
- assert!(!pane_readback_verified(&report));
3784
- }
3785
- }